\input texinfo   @c -*-texinfo-*-
@setfilename swbisparse.info

@comment ===============================================================
@comment WARNING: Do NOT edit this file.  It was produced automatically
@comment by man2info on Sun Jul 27 20:44:50 EDT 2014
@comment for jhl@
@comment from man/man1/swbisparse.1
@comment in /home/jhl/swbis-1.12x/doc
@comment ===============================================================

@comment @documentencoding ISO-8859-1

@comment troff -man typesetting style: headers, footers, no paragraph indentation

@paragraphindent none

@iftex
@parskip = 0.5@normalbaselineskip plus 3pt minus 1pt
@end iftex

@set lq ``
@set rq ''

@comment TROFF INPUT: ...\" $Header: /usr/src/docbook-to-man/cmd/RCS/docbook-to-man.sh,v 1.3 1996/06/17 03:36:49 fld Exp $
@comment ...\" $Header: /usr/src/docbook-to-man/cmd/RCS/docbook-to-man.sh,v 1.3 1996/06/17 03:36:49 fld Exp $
@comment TROFF INPUT: ...\"
@comment ...\"
@comment TROFF INPUT: ...\"	transcript compatibility for postscript use.
@comment ...\"	transcript compatibility for postscript use.
@comment TROFF INPUT: ...\"
@comment ...\"
@comment TROFF INPUT: ...\"	synopsis:  .P! <file.ps>
@comment ...\"	synopsis:  .P! <file.ps>
@comment TROFF INPUT: ...\"
@comment ...\"
@comment TROFF INPUT: .de P!
@comment .de P!
\.
@comment TROFF INPUT: .fl			\" force out current output buffer
@comment .fl			\" force out current output buffer
\\!%PB
\\!/showpage@{@}def
@comment TROFF INPUT: ...\" the following is from Ken Flowers -- it prevents dictionary overflows
@comment ...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
@comment TROFF INPUT: .fl			\" prolog
@comment .fl			\" prolog
@comment TROFF INPUT: .sy cat \\$1\" bring in postscript file
@comment .sy cat \\$1\" bring in postscript file
@comment TROFF INPUT: ...\" the following line matches the tempdict above
@comment ...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
@comment TROFF INPUT: .sp \\$2u	\" move below the image
@comment .sp \\$2u	\" move below the image
@comment TROFF INPUT: ..
@comment ..
@comment TROFF INPUT: .de pF
@comment .de pF
@comment TROFF INPUT: .ie     \\*(f1 .ds f1 \\n(.f
@comment .ie     \\*(f1 .ds f1 \\n(.f
@comment TROFF INPUT: .el .ie \\*(f2 .ds f2 \\n(.f
@comment .el .ie \\*(f2 .ds f2 \\n(.f
@comment TROFF INPUT: .el .ie \\*(f3 .ds f3 \\n(.f
@comment .el .ie \\*(f3 .ds f3 \\n(.f
@comment TROFF INPUT: .el .ie \\*(f4 .ds f4 \\n(.f
@comment .el .ie \\*(f4 .ds f4 \\n(.f
@comment TROFF INPUT: .el .tm ? font overflow
@comment .el .tm ? font overflow
@comment TROFF INPUT: .ft \\$1
@comment .ft \\$1
@comment TROFF INPUT: ..
@comment ..
@comment TROFF INPUT: .de fP
@comment .de fP
@comment TROFF INPUT: .ie     !\\*(f4 \{\
@comment .ie     !\\*(f4 \@{\
@comment TROFF INPUT: .	ft \\*(f4
@comment .	ft \\*(f4
@comment TROFF INPUT: .	ds f4\"
@comment .	ds f4\"
'	br \@}
@comment TROFF INPUT: .el .ie !\\*(f3 \{\
@comment .el .ie !\\*(f3 \@{\
@comment TROFF INPUT: .	ft \\*(f3
@comment .	ft \\*(f3
@comment TROFF INPUT: .	ds f3\"
@comment .	ds f3\"
'	br \@}
@comment TROFF INPUT: .el .ie !\\*(f2 \{\
@comment .el .ie !\\*(f2 \@{\
@comment TROFF INPUT: .	ft \\*(f2
@comment .	ft \\*(f2
@comment TROFF INPUT: .	ds f2\"
@comment .	ds f2\"
'	br \@}
@comment TROFF INPUT: .el .ie !\\*(f1 \{\
@comment .el .ie !\\*(f1 \@{\
@comment TROFF INPUT: .	ft \\*(f1
@comment .	ft \\*(f1
@comment TROFF INPUT: .	ds f1\"
@comment .	ds f1\"
'	br \@}
@comment TROFF INPUT: .el .tm ? font underflow
@comment .el .tm ? font underflow
@comment TROFF INPUT: ..
@comment ..
@comment TROFF INPUT: .ds f1\"

@comment WARNING: man/man1/swbisparse.1:49:%%unrecognized define-string command: [.ds f1\"]

@comment TROFF INPUT: .ds f2\"

@comment WARNING: man/man1/swbisparse.1:50:%%unrecognized define-string command: [.ds f2\"]

@comment TROFF INPUT: .ds f3\"

@comment WARNING: man/man1/swbisparse.1:51:%%unrecognized define-string command: [.ds f3\"]

@comment TROFF INPUT: .ds f4\"

@comment WARNING: man/man1/swbisparse.1:52:%%unrecognized define-string command: [.ds f4\"]

@comment TROFF INPUT: .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
@comment .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
@comment TROFF INPUT: .TH "swbisparse" "1"

@headings off
@everyheading SWBISPARSE(1) @| @| SWBISPARSE(1)
@everyfooting  @| @thispage @|

@node Top

@chapter swbisparse" "1


@comment TROFF INPUT: .hy 0
@comment .hy 0
@comment TROFF INPUT: .if n .na
@comment .if n .na
@comment TROFF INPUT: .SH "NAME"
@c DEBUG: print_menu("Top")

@ifnottex
@menu
* NAME::
* SYNOPSIS::
* DESCRIPTION::
* OPTIONS::
* APPLICABLE STANDARDS::
* SEE ALSO::
* IDENTIFICATION::
* BUGS::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node NAME

@section NAME

swbisparse @r{---} Read and parse POSIX.7.2 metadata.
@comment TROFF INPUT: .SH "SYNOPSIS"
@c DEBUG: print_menu("NAME")
@comment MAN2TEXI: EON

@node SYNOPSIS

@section SYNOPSIS

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
@b{swbisparse} @{--installed|-o,--info|-i,--index|-p,--psf@} [-b] [-n] [-l @i{level}] [@i{file}]
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
@b{swbisparse} @{-d,--decode@} [@i{package@t{_}file}]
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .SH "DESCRIPTION"
@c DEBUG: print_menu("SYNOPSIS")
@comment MAN2TEXI: EON

@node DESCRIPTION

@section DESCRIPTION

@comment TROFF INPUT: .PP

@b{swbisparse} reads and parses POSIX.7.2 metadata files: INDEX, INFO and psf files.
@comment TROFF INPUT: .PP

@b{swbisparse} writes an implementation defined format to stdout.
The format indicates the keyword type, (O)bject,
(A)ttribute, or, (E)xtended, and, containment level.  Newlines in multi-line values
are translated to '\\n' and output on a single line.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .br
@comment .br
@comment TROFF INPUT: .PP

When decoding a package file, @i{package@t{_}file},
@b{swbisparse} emits a format that includes the length (in
bytes) of the attribute value.  The format consists of ASCII data.
Binary data in the input will cause an error.
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .PP

@comment TROFF INPUT: .nf

@c ---------------------------------------------------------------------
@display
For Example, the following PSF file:

 distribution
 layout@t{_}version 1.0
 product
 description "This is a
 multi line value"
 tag p1
 fileset
 tag p2
 file
 path /etc/passwd

is translated to:

 F00 PSF:
 O01 distribution
 A02  layout@t{_}version 1.0
 O02  product
 A03   description "This is a\\nmulti line value"
 A03   tag p1
 O03   fileset
 A04    tag p2
 O04    file
 A05     path /etc/passwd@r{
@comment TROFF INPUT: .fi

@end display

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@comment TROFF INPUT: .SS "Hewlett-Packard SD-UX Compatibility"
@c DEBUG: print_menu("DESCRIPTION")

@ifnottex
@menu
* Hewlett-Packard SD-UX Compatibility::

@end menu
@end ifnottex

@comment MAN2TEXI: EON

@node Hewlett-Packard SD-UX Compatibility

@subsection Hewlett-Packard SD-UX Compatibility

@comment TROFF INPUT: .PP


@comment WARNING: man/man1/swbisparse.1:116:%%new font B started without closing previous font R

This parser does not use nor require the }@b{end} keyword to terminate objects as
is commonly the practice for PSF files written for Hewlett-Packard's SD-UX equipped systems.  The @b{end}
keyword can appear in PSF, INDEX and INFO files, however, it will merely be scanned and the
token discarded.  Another incompatibility is based on this parser's termination of an object definition
by the first extended keyword.  This restriction may not
exist in the SD-UX grammar because the object is bracketed by the nesting of @b{end} keywords and
not by the existence of the first object or extended keyword.
@comment TROFF INPUT: .SH "OPTIONS"
@comment MAN2TEXI: EON

@node OPTIONS

@section OPTIONS

@comment TROFF INPUT: .PP

@b{--info}@b{-o}     Parse an INFO file.
@comment TROFF INPUT: .PP

@b{--installed}     Parse the installed software catalog file INSTALLED.
@comment TROFF INPUT: .PP

@b{--psf}@b{-p}     Parse a PSF file.
@comment TROFF INPUT: .PP

@b{--index}@b{-i}     Parse an INDEX file.
@comment TROFF INPUT: .PP

@b{-b}     Beautify by indention and emit a file
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
semantically identical to
the input file.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-n}     Emit format that is marked up with the
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
value's lengths in bytes.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .PP

@b{-l} @i{level}     Set initial containment level
@comment TROFF INPUT: .RS

@c ---------------------------------------------------------------------
@quotation
to @i{level}.
@comment TROFF INPUT: .RE

@end quotation

@c ---------------------------------------------------------------------
@comment TROFF INPUT: .SH "APPLICABLE STANDARDS"
@c DEBUG: print_menu("OPTIONS")
@comment MAN2TEXI: EON

@node APPLICABLE STANDARDS

@section APPLICABLE STANDARDS

@comment TROFF INPUT: .PP

Conforming to POSIX.7.2, however, A stand-alone parser
utility by this (or any) name is not specified in ISO/IEC 15068-2:1999
@comment TROFF INPUT: .SH "SEE ALSO"
@c DEBUG: print_menu("APPLICABLE STANDARDS")
@comment MAN2TEXI: EON

@node SEE ALSO

@section SEE ALSO

@comment TROFF INPUT: .PP

sw(5)
@comment TROFF INPUT: .SH "IDENTIFICATION"
@c DEBUG: print_menu("SEE ALSO")
@comment MAN2TEXI: EON

@node IDENTIFICATION

@section IDENTIFICATION

@comment TROFF INPUT: .PP

 Author: Jim Lowe
 Version: 0.481
 Last Updated 2006-02-15
 Copying: GNU Free Documentation License v1.1
@comment TROFF INPUT: .SH "BUGS"
@c DEBUG: print_menu("IDENTIFICATION")
@comment MAN2TEXI: EON

@node BUGS

@section BUGS

@comment TROFF INPUT: .PP

This program is mainly a testing and development tool.
@comment TROFF INPUT: .PP

Requirements for inclusion (exclusion) of certain keywords in (from) the
parsed output is not enforced.  Quoted trailing whitespace in the attribute
value is discarded.
@comment  created by instant / docbook-to-man, Sun 27 Jul 2014, 20:44
@bye
