Add pdbar, an utility to create and manipulates PalmOS database (.pdb)

and resource (.prc) files.

It was renamed to pdbar to avoid confusion with textproc/par.

WWW: http://www.djw.org/product/palm/par/

PR:		ports/63088
Submitted by:	Eric P. Scott <eps+psub0401@ana.com>

7 files changed, 268 insertions, 0 deletions

diff --git a/palm/Makefile b/palm/Makefile
index df79b3486ae2..19a266841ee0 100644
--- a/palm/Makefile
+++ b/palm/Makefile
@@ -19,6 +19,7 @@
     SUBDIR += p5-Palm-PalmDoc
     SUBDIR += palmos-sdk
     SUBDIR += palmpower
+    SUBDIR += pdbar
     SUBDIR += pilot-link
     SUBDIR += pilot_makedoc
     SUBDIR += pilrc
diff --git a/palm/pdbar/Makefile b/palm/pdbar/Makefile
new file mode 100644
index 000000000000..5797b087c250
--- /dev/null
+++ b/palm/pdbar/Makefile
@@ -0,0 +1,25 @@
+# New ports collection makefile for:	pdbar
+# Date created:		5 January 2004
+# Whom:			Eric P. Scott <eps+pdbar@ana.com>
+#
+# $FreeBSD$
+#
+
+PORTNAME=	pdbar
+PORTVERSION=	00.05.01
+CATEGORIES=	palm
+MASTER_SITES=	http://www.djw.org/product/palm/par/
+DISTNAME=	prc
+EXTRACT_SUFX=	.tgz
+
+MAINTAINER=	ports@FreeBSD.org
+COMMENT=	Create and manipulate PalmOS database files
+
+MAN1=		pdbar.1
+PLIST_FILES=	bin/pdbar
+
+do-install:
+		${INSTALL_PROGRAM} ${WRKSRC}/pdbar ${PREFIX}/bin
+		${INSTALL_MAN} ${WRKSRC}/par.man ${MANPREFIX}/man/man1/pdbar.1
+
+.include <bsd.port.mk>
diff --git a/palm/pdbar/distinfo b/palm/pdbar/distinfo
new file mode 100644
index 000000000000..3edb51dcb2a2
--- /dev/null
+++ b/palm/pdbar/distinfo
@@ -0,0 +1,2 @@
+MD5 (prc.tgz) = c20a295b05c598322d037ecd36a28e38
+SIZE (prc.tgz) = 62143
diff --git a/palm/pdbar/files/patch-Makefile b/palm/pdbar/files/patch-Makefile
new file mode 100644
index 000000000000..2c65ab95a275
--- /dev/null
+++ b/palm/pdbar/files/patch-Makefile
@@ -0,0 +1,45 @@
+--- Makefile.orig	Fri Aug 17 12:11:42 2001
++++ Makefile	Mon Jan  5 12:58:05 2004
+@@ -25,12 +25,12 @@
+ INSTALL_LIBDIR = /usr/local/pilot/lib
+ INSTALL_BINDIR = /usr/local/bin
+ INSTALL_MANDIR = /usr/local/man/man1
+-CC =     gcc
+-CFLAGS = -g -I. -Wall
+-LD =     gcc
+-LDFLAGS = -g
+-AR      = ar
+-RANLIB  = ranlib
++#CC =     gcc
++#CFLAGS = -g -I. -Wall
++LD =     $(CC)
++#LDFLAGS = -g
++#AR      = ar
++#RANLIB  = ranlib
+ 
+ CFILES = \
+ 	create.c   \
+@@ -107,14 +107,14 @@
+ ALLFILES = $(ALLSRCS) $(ALLDOCS)
+ WINFILES = Release/par.exe $(ALLDOCS)
+ 
+-all:	libprc.a par
++all:	libprc.a pdbar
+ 
+ libprc.a: $(OFILES)
+ 	ar rc libprc.a $(OFILES)
+ 	ranlib libprc.a
+ 
+-par:	$(PAR_OFILES) libprc.a
+-	$(LD) $(LDFLAGS) -o par $(PAR_OFILES) -L. -lprc
++pdbar:	$(PAR_OFILES) libprc.a
++	$(LD) $(LDFLAGS) -o pdbar $(PAR_OFILES) -L. -lprc
+ 
+ par.html: par.man
+ 	rman --filter HTML --title 'Par(1) Manual Page' par.man > par.html
+@@ -158,4 +158,4 @@
+ 	etags -r '/^prc[^(]*(/' $(PAR_CFILES) $(CFILES) $(HFILES)
+ 
+ clean:
+-	rm -f *.o *.a par *~
++	rm -f *.o *.a pdbar *~
diff --git a/palm/pdbar/files/patch-par.c b/palm/pdbar/files/patch-par.c
new file mode 100644
index 000000000000..5fa305bcc922
--- /dev/null
+++ b/palm/pdbar/files/patch-par.c
@@ -0,0 +1,25 @@
+--- par.c.orig	Fri Aug 17 12:11:42 2001
++++ par.c	Mon Jan  5 13:01:20 2004
+@@ -1149,14 +1149,14 @@
+ {
+     fprintf(stderr,
+     "usage:\n"
+-    "par t dbfile                                                - list\n"
+-    "par h dbfile                                                - header\n"
+-    "par x dbfile [ioptions] [records ..]                        - extract\n"
+-    "par c [hoptions] dbfile name type cid [ioptions] [files ..] - create\n"
+-    "par u [hoptions] dbfile [ioptions] [updates ..]             - touch\n"
+-    "par a [hoptions] dbfile [ioptions] [files ..]               - append\n"
+-    "par d [hoptions] dbfile [doptions] [records ..]             - delete\n"
+-    "par version                                                 - version\n"
++    "pdbar t dbfile                                                - list\n"
++    "pdbar h dbfile                                                - header\n"
++    "pdbar x dbfile [ioptions] [records ..]                        - extract\n"
++    "pdbar c [hoptions] dbfile name type cid [ioptions] [files ..] - create\n"
++    "pdbar u [hoptions] dbfile [ioptions] [updates ..]             - touch\n"
++    "pdbar a [hoptions] dbfile [ioptions] [files ..]               - append\n"
++    "pdbar d [hoptions] dbfile [doptions] [records ..]             - delete\n"
++    "pdbar version                                                 - version\n"
+     "where dbfile is a pdb:\n"
+     "ioptions = [-A appinfo] [-S sortinfo]\n"
+     "doptions = [-A] [-S]\n"
diff --git a/palm/pdbar/files/patch-par.man b/palm/pdbar/files/patch-par.man
new file mode 100644
index 000000000000..2a6c8740ecc2
--- /dev/null
+++ b/palm/pdbar/files/patch-par.man
@@ -0,0 +1,163 @@
+--- par.man.orig	Fri Aug 17 12:11:42 2001
++++ par.man	Mon Jan  5 13:18:46 2004
+@@ -1,46 +1,46 @@
+-.TH PAR 1 "November 1999" "Version 0.5 (beta)" "Palm hacking commands"
++.TH PDBAR 1 "November 1999" "Version 0.5 (beta)" "Palm hacking commands"
+ .SH NAME
+-par \- Palm database archiver, version 0.5.
++pdbar \- Palm database archiver, version 0.5.
+ .SH SYNOPSIS
+-.B par t
++.B pdbar t
+ .I dbfile
+ .PP
+-.B par h
++.B pdbar h
+ .I dbfile
+ .PP
+-.B par x
++.B pdbar x
+ .I dbfile
+ .BI [ ioptions ]
+ .BI [ records.. ]
+ .PP
+-.B par\ c
++.B pdbar\ c
+ .BI [ hoptions ]
+ .I dbfile\ name\ type\ cid
+ .BI [ ioptions ]
+ .BI [ files.. ]
+ .PP
+-.B par u
++.B pdbar u
+ .BI [ hoptions ]
+ .I dbfile
+ .BI [ ioptions ]
+ .BI [ updates.. ]
+ .PP
+-.B par a
++.B pdbar a
+ .BI [ hoptions ]
+ .I dbfile
+ .BI [ ioptions ]
+ .BI [ files.. ]
+ .PP
+-.B par d
++.B pdbar d
+ .BI [ hoptions ]
+ .I dbfile
+ .BI [ doptions ]
+ .BI [ records.. ]
+ .PP
+-.B par V
++.B pdbar V
+ .SH DESCRIPTION
+ The
+-.B par
++.B pdbar
+ utility creates and manipulates PalmOS database
+ .B (.pdb)
+ and resource
+@@ -161,7 +161,7 @@
+ .B x
+ mode.
+ In addition to individual records and resources,
+-.B par
++.B pdbar
+ can append whole databases, in effect merging the records or resources
+ from one database into another. Databases may be specified as append
+ items explicitly using the
+@@ -330,23 +330,23 @@
+ .SH EXAMPLES
+ The following example prints the header information for the database 'foo.pdb'.
+ .PP
+-.B par h foo.pdb
++.B pdbar h foo.pdb
+ .PP
+ The following extracts all records from 'foo.pdb'.
+ .PP
+-.B par x foo.pdb
++.B pdbar x foo.pdb
+ .PP
+ The following extracts the application icon resource from 'app.prc' and saves
+ it in the file 'icon.Tbmp'. Note the use of decimal specification for the
+ resource id. The id may be specified in hex using by using the '0x' prefix.
+ .PP
+-.B par x app.prc -f icon.Tbmp tAIB 1000
++.B pdbar x app.prc -f icon.Tbmp tAIB 1000
+ .PP
+ The following creates a new application resource database from all the
+ the files with a '.bin' extension in the current directory. The database
+ will have creator id of 'djwP' and will have the backup bit set.
+ .PP
+-.B par c -a \&"resource|backup\&" app.prc myapp appl djwP *.bin
++.B pdbar c -a \&"resource|backup\&" app.prc myapp appl djwP *.bin
+ .PP
+ If you use the author's technique for creating multi-segment library
+ prcs with CodeWarrior, the following example will be useful. This
+@@ -355,7 +355,7 @@
+ type = 'code', id = '1' (as used in an application) to type = 'libr',
+  id = '0' (as used in a library).
+ .PP
+-.B par u -T libr mylib.prc -T libr 0 code 1
++.B pdbar u -T libr mylib.prc -T libr 0 code 1
+ .PP
+ The following example merges the resources from two different
+ resource databases,
+@@ -368,10 +368,10 @@
+ of an application, using the individual resource databases as
+ libraries.
+ .PP
+-.B par r myapp.prc myapp appl djwP code.prc resource.prc
++.B pdbar r myapp.prc myapp appl djwP code.prc resource.prc
+ .PP
+ By default,
+-.B par
++.B pdbar
+ saves extracted resources using the form
+ .IR <type><id>.bin ,
+ where
+@@ -380,31 +380,37 @@
+ <id>
+ is the resource id in 4 digit hexadecimal. When appending resources
+ to a new or existing resource database,
+-.B par
++.B pdbar
+ will attempt to decode the resource and id of the resource being appended
+ from the resource filename using this same naming scheme, or you can
+ explicitly specify the resource and id using the
+ .I -T
+ syntax. Here are two invocations of
+-.B par
++.B pdbar
+ that do exactly the same thing: create a new resource database with one
+ resource which has type = NFNT and id = 256 (0x0100 hexadecimal):
+ .PP
+-.B par c -a \&"resource\&" font.prc Font FONT djwF NFNT0100.bin
++.B pdbar c -a \&"resource\&" font.prc Font FONT djwF NFNT0100.bin
+ .P
+-.B par r font.prc Font FONT djwF -T NFNT 256 myfont
++.B pdbar r font.prc Font FONT djwF -T NFNT 256 myfont
+ .PP
+ The following example creates a stream database that can be accessed using
+ the PalmOS FileStream API. The stream will contain the contents of the
+ file 'WarAndPeace.txt':
+ .PP
+-.B par c -a \&"stream\&" book.pdb Book DATA djwS WarAndPeace.txt
++.B pdbar c -a \&"stream\&" book.pdb Book DATA djwS WarAndPeace.txt
+ .PP
+ In the following example, 'book.pdb' is a stream database. This
+ example extracts the stream from that database and stores the result
+ in the output file 'Book.txt':
+ .PP
+-.B par x book.pdb Book.txt
++.B pdbar x book.pdb Book.txt
+ .SH AUTHOR
+ .B par
+ was written by David Williams, djw@djw.org
++.SH "FreeBSD NOTES"
++.B par
++was renamed
++.B pdbar
++to avoid conflicting with the preexisting text processing tool of
++the same name.
diff --git a/palm/pdbar/pkg-descr b/palm/pdbar/pkg-descr
new file mode 100644
index 000000000000..694542e20d50
--- /dev/null
+++ b/palm/pdbar/pkg-descr
@@ -0,0 +1,7 @@
+The par utility creates and manipulates PalmOS database (.pdb)
+and resource (.prc) files.
+
+It's renamed pdbar for FreeBSD to avoid conflicting with
+textproc/par (which predates this "par" by about six years).
+
+WWW: http://www.djw.org/product/palm/par/