.\" Automatically generated by Pod::Man v1.3, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R

.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "MAN 1"
.TH MAN 1 "2003-11-16" "perl v5.6.1" "User Contributed Perl Documentation"
.UC
.SH "NAME"
.Vb 1
\&  LinPQA - compiler and decompiler for PalmVII Palm Query Apps
.Ve
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
LinPQA is known to run on a Linux/Intel box. It should have no problems on just
about anything. It should have no problems with endianity. You will need to
have libpisock (part of the pilot-link package. Also available from Debian
GNU/Linux) and development headers installed.
.SH "STATUS"
.IX Header "STATUS"
Useful, but not yet feature complete. Call it early alpha.
.SH "LICENSE"
.IX Header "LICENSE"
LinPQA is Free software released under the \s-1GNU\s0 General Public License, also known as Copyleft.
.SH "LIMITATIONS"
.IX Header "LIMITATIONS"
.IP "Does not support \s-1GIF\s0 due to the ongoing patent issues. Instead, it uses .pbm (Portable Bit Map) files, but calls them .gif for compatability." 4
.IX Item "Does not support GIF due to the ongoing patent issues. Instead, it uses .pbm (Portable Bit Map) files, but calls them .gif for compatability."
.PD 0
.IP "Only some tags are supported. This will change with time, it's just not complete yet." 4
.IX Item "Only some tags are supported. This will change with time, it's just not complete yet."
.IP "The PQAs are uncompressed. Once again, just a matter of time. Supporting all tags is a bigger priority. (But if you'd like to add it, be my guest)." 4
.IX Item "The PQAs are uncompressed. Once again, just a matter of time. Supporting all tags is a bigger priority. (But if you'd like to add it, be my guest)."
.IP "User interface. It's more functional than friendly at this time." 4
.IX Item "User interface. It's more functional than friendly at this time."
.PD
.SH "SUPPORTED FEATURES"
.IX Header "SUPPORTED FEATURES"
.IP "Bold" 4
.IX Item "Bold"
.PD 0
.IP "Form" 4
.IX Item "Form"
.IP "all input tags" 4
.IX Item "all input tags"
.IP "Select and option" 4
.IX Item "Select and option"
.IP "submit" 4
.IX Item "submit"
.IP "checkbox" 4
.IX Item "checkbox"
.IP "table" 4
.IX Item "table"
.IP "tr" 4
.IX Item "tr"
.IP "th" 4
.IX Item "th"
.IP "td" 4
.IX Item "td"
.IP "\s-1IMG\s0" 4
.IX Item "IMG"
.IP "&lt;" 4
.IX Item "&lt;"
.IP "&gt;" 4
.IX Item "&gt;"
.IP "&tm; (trademark symbol)" 4
.IX Item "&tm; (trademark symbol)"
.PD
.SH "USE"
.IX Header "USE"
The tools are set up to work with one \s-1PQA\s0 per directory. pqadecompile will place all files in it's pwd and pqAcompile expects all files to be in it's pwd. The files LgIcon.pnm and SmIcon.pnm are 32x32 and 15x9 pixel icon bitmaps (2 level lineart). Note that the bottom 10 pixels of the large icon will not be displayed by the Palm launcher (not my fault!).
.PP
All html should have a .html extension, and all images should have .gif. \s-1IMPORTANT:\s0 although the images have a .gif extension (for web compatability), they should be raw pnm files (The \s-1GIMP\s0 and Image Magick can handle them).
.PP
pqadecompile is invoked as pqadecompile <pqafile>
.PP
pqacompile is invoked as pqacompile <pqafile> <version> <title> <input file(s)>
.IP "pqafile is the file to be output" 4
.IX Item "pqafile is the file to be output"
.PD 0
.IP "version is the version of the \s-1PQA\s0 (this comes in handy when revisions are made)" 4
.IX Item "version is the version of the PQA (this comes in handy when revisions are made)"
.IP "title is the name displayed in the launcher on the PalmVII" 4
.IX Item "title is the name displayed in the launcher on the PalmVII"
.IP "input file(s) is a list of files to be encoded into the \s-1PQA\s0. Any file explicitly listed here \s-1WILL\s0 be encoded, even if it is not referenced. The first listed file will be the page initially displayed by the app. Any files referenced in the html files specified will also be included (hyperlinks with href or src =file:// hyperlinks with href or src =http:// will be accessed over the web at run time.)" 4
.IX Item "input file(s) is a list of files to be encoded into the PQA. Any file explicitly listed here WILL be encoded, even if it is not referenced. The first listed file will be the page initially displayed by the app. Any files referenced in the html files specified will also be included (hyperlinks with href or src =file:// hyperlinks with href or src =http:// will be accessed over the web at run time.)"