include manpage in package

openpkg-tool/openpkg.1

@@ -1,8 +1,7 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Thu Dec 26 13:41:09 2002
+.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
 .\"
 .\" Standard preamble:
-.\" ======================================================================
+.\" ========================================================================
 .de Sh \" Subsection heading
 .br
 .if t .Sp
@@ -15,12 +14,6 @@
 .if t .sp .5v
 .if n .sp
 ..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
 .de Vb \" Begin verbatim text
 .ft CW
 .nf
@@ -28,15 +21,14 @@
 ..
 .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<>
+.\" 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 \{\
@@ -56,10 +48,10 @@
 .    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 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"
@@ -68,14 +60,13 @@
 .    rr F
 .\}
 .\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
+.\" 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.
-.bd B 3
 .    \" fudge factors for nroff and troff
 .if n \{\
 .    ds #H 0
@@ -135,16 +126,15 @@
 .    ds Ae AE
 .\}
 .rm #[ #] #H #V #F C
-.\" ======================================================================
+.\" ========================================================================
 .\"
 .IX Title "OPENPKG 1"
-.TH OPENPKG 1 "openpkg-tool" "2002-12-26" "OpenPKG Maintainance"
-.UC
+.TH OPENPKG 1 "2003-01-13" "openpkg-tool" "OpenPKG Maintainance"
 .SH "NAME"
 \&\fBopenpkg\fR \- \fBOpenPKG\fR maintainance utility
 .SH "VERSION"
 .IX Header "VERSION"
-openpkg-tool \s-1XX-VERSION-XX\s0
+openpkg-tool XX-VERSION-XX
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 \&\fBopenpkg\fR 
@@ -170,6 +160,8 @@ openpkg-tool \s-1XX-VERSION-XX\s0
 [\fB\-q\fR]
 [\fB\-s\fR]
 [\fB\-S\fR]
+[\fB\-M\fR]
+[\fB\-X\fR]
 [\fB\-P\fR \fIpriv-cmd\fR]
 [\fB\-N\fR \fInon-priv-cmd\fR]
 [\fB\-p\fR \fIplatform\fR]
@@ -192,11 +184,11 @@ index holds enough information to support an automated build process by
 \&\fBopenpkg build\fR.
 .PP
 The following command line options exist:
-.Ip "\fB\-r\fR \fIresource\fR" 4
+.IP "\fB\-r\fR \fIresource\fR" 4
 .IX Item "-r resource"
 The name of the resource stored in the index. The default is
 "\f(CW\*(C`OpenPKG\-CURRENT/Source/\*(C'\fR".
-.Ip "\fB\-p\fR \fIplatform\fR" 4
+.IP "\fB\-p\fR \fIplatform\fR" 4
 .IX Item "-p platform"
 \&\fBopenpkg index\fR adds a platform attribute for binary RPMs. The
 attribute is built as \fI%{arch}\fR\f(CW\*(C`\-\*(C'\fR\fIplatform\fR\f(CW\*(C`\-\*(C'\fR\fI%{os}\fR where
@@ -204,19 +196,19 @@ attribute is built as \fI%{arch}\fR\f(CW\*(C`\-\*(C'\fR\fIplatform\fR\f(CW\*(C`\
 the value of the \fB\-p\fR option. The default value is "\f(CW\*(C`unknown\*(C'\fR". This
 must be used to distinguish between platforms that support the same
 Architecture and \s-1OS\s0 name like various Linux distributions.
-.Ip "\fB\-C\fR \fIcache.db\fR" 4
+.IP "\fB\-C\fR \fIcache.db\fR" 4
 .IX Item "-C cache.db"
 Cache all \fI.spec\fR files into this Berkeley-DB file when indexing source
 RPMs. The cache is refreshed automatically when the source RPMs are more
 recent than the cache entry.
-.Ip "\fB\-o\fR \fIindex.rdf\fR" 4
+.IP "\fB\-o\fR \fIindex.rdf\fR" 4
 .IX Item "-o index.rdf"
 Name of the output \s-1XML/RDF\s0 file, default is to write to \fIstdout\fR.
-.Ip "\fB\-c\fR" 4
+.IP "\fB\-c\fR" 4
 .IX Item "-c"
 Compress output with \f(CW\*(C`bzip2\*(C'\fR. Use the \fB\-o\fR option to specify a \fI.bz2\fR
 suffix.
-.Ip "\fB\-i\fR" 4
+.IP "\fB\-i\fR" 4
 .IX Item "-i"
 The specified directories are \s-1RPM\s0 repositories. Build index over
 all \fI.rpm\fR files in these directories and all subdirectories.
@@ -235,50 +227,50 @@ on the upgraded package (\*(L"reverse dependencies\*(R"). The dependency
 information is read from an index generated by \fBopenpkg index\fR.
 .PP
 The following command line options exist:
-.Ip "\fB\-R\fR \fIrpm\fR" 4
+.IP "\fB\-R\fR \fIrpm\fR" 4
 .IX Item "-R rpm"
 Specify a path to the installed \fBOpenPKG\fR \f(CW\*(C`rpm\*(C'\fR executable. Several
 other internal paths are deduced from the \fIrpm\fR path, so this should be
 something like \fI%{l_prefix}\fR\f(CW\*(C`/bin/rpm\*(C'\fR.
-.Ip "\fB\-r\fR \fIrepository\fR" 4
+.IP "\fB\-r\fR \fIrepository\fR" 4
 .IX Item "-r repository"
 Specify a path to an \s-1RPM\s0 repository, this can be a \s-1URL\s0 or a directory
 path. The name of the package file is appended to this path.
 The default is to use a \s-1URL\s0 pointing to the \fBOpenPKG\fR \s-1FTP\s0 server.
-.Ip "\fB\-f\fR \fIindex.rdf\fR" 4
+.IP "\fB\-f\fR \fIindex.rdf\fR" 4
 .IX Item "-f index.rdf"
 Specify a path to the primary \s-1XML/RDF\s0 index, this can be a \s-1URL\s0 or a
 file path. If the index contains references to aother indexes these are
 included automatically. The default is to use a \s-1URL\s0 pointing to the
 \&\fBOpenPKG\fR \s-1FTP\s0 server for the \fBOpenPKG\fR release you are using.
-.Ip "\fB\-u\fR" 4
+.IP "\fB\-u\fR" 4
 .IX Item "-u"
 The generated script will ignore binary RPMs that are stored on
 your system. Instead it will either fetch binary RPMs or rebuild
 from source RPMs fetched from the repository.
-.Ip "\fB\-U\fR" 4
+.IP "\fB\-U\fR" 4
 .IX Item "-U"
 The generated script will try to upgrade all selected packages
 including their dependencies to the most recent version.
-.Ip "\fB\-z\fR" 4
+.IP "\fB\-z\fR" 4
 .IX Item "-z"
 The generated script will rebuild all selected packages
 including their dependencies even when the most recent version
 is already installed.
-.Ip "\fB\-Z\fR" 4
+.IP "\fB\-Z\fR" 4
 .IX Item "-Z"
 \&\fBopenpkg build\fR ignores all installed packages, the
 script will rebuild all selected packages from scratch. 
 Note that this doesn't work together with the \fB\-a\fR option.
-.Ip "\fB\-i\fR" 4
+.IP "\fB\-i\fR" 4
 .IX Item "-i"
 The generated script will ignore errors. However, if a build
 phase fails the install phase is still skipped.
-.Ip "\fB\-q\fR" 4
+.IP "\fB\-q\fR" 4
 .IX Item "-q"
 Ignore all reverse dependencies.
 \&\fI\s-1ATTENTION:\s0 this might break already installed packages!\fR
-.Ip "\fB\-s\fR" 4
+.IP "\fB\-s\fR" 4
 .IX Item "-s"
 Print a status map instead of the install script. The map consists
 of 3 columns: \*(L"old\*(R", \*(L"tag\*(R" and \*(L"new\*(R". \*(L"old\*(R" shows the installed
@@ -287,57 +279,64 @@ that name is installed and \*(L"new\*(R" shows the repository version
 of a package if it is considered for installation. \*(L"tag\*(R" has the
 following possible values:
 .RS 4
-.Ip "\s-1OK\s0" 4
+.IP "\s-1OK\s0" 4
 .IX Item "OK"
 The installed package is suitable and will not be touched.
-.Ip "\s-1ADD\s0" 4
+.IP "\s-1ADD\s0" 4
 .IX Item "ADD"
 There is no installed package yet.
-.Ip "\s-1UPGRADE\s0" 4
+.IP "\s-1UPGRADE\s0" 4
 .IX Item "UPGRADE"
 The installed package is outdated and requires an update.
-.Ip "\s-1DEPEND\s0" 4
+.IP "\s-1DEPEND\s0" 4
 .IX Item "DEPEND"
 The installed package needs rebuilding because one of its
 dependencies is rebuilt.
-.Ip "\s-1MISMATCH\s0" 4
+.IP "\s-1MISMATCH\s0" 4
 .IX Item "MISMATCH"
 The installed package needs rebuilding because it was build
 with different parameters.
-.Ip "\s-1CONFLICT\s0" 4
+.IP "\s-1CONFLICT\s0" 4
 .IX Item "CONFLICT"
 The required new package cannot be installed because it
 conflicts with some already installed package.
-.Ip "\s-1UNDEF\s0" 4
+.IP "\s-1UNDEF\s0" 4
 .IX Item "UNDEF"
 The package has an invalid or ambigous dependency.
 .RE
 .RS 4
 .RE
-.Ip "\fB\-S\fR" 4
+.IP "\fB\-S\fR" 4
 .IX Item "-S"
 Similar to \fB\-s\fR but also lists the newest versions in the
 repository. The following tag might appear in the map.
 .RS 4
-.Ip "\s-1NEW\s0" 4
+.IP "\s-1NEW\s0" 4
 .IX Item "NEW"
 The package exists in the repository but isn't required yet.
 .RE
 .RS 4
 .RE
-.Ip "\fB\-P\fR \fIpriv-cmd\fR" 4
+.IP "\fB\-M\fR" 4
+.IX Item "-M"
+Similar to \fB\-s\fR but print a short dependency map.
+.IP "\fB\-X\fR" 4
+.IX Item "-X"
+Ignore an installed \s-1XML\s0 parser module but use the internal
+simple text parser instead.
+.IP "\fB\-P\fR \fIpriv-cmd\fR" 4
 .IX Item "-P priv-cmd"
 Command prefix to use for install commands that require elevated
 privileges. The most common tool for this is \fIsudo\fR\|(8).
-.Ip "\fB\-N\fR \fInon-priv-cmd\fR" 4
+.IP "\fB\-N\fR \fInon-priv-cmd\fR" 4
 .IX Item "-N non-priv-cmd"
 Command prefix to use for install commands that do not require elevated
 privileges. The most common tool for this is \fIsudo\fR\|(8).
-.Ip "\fB\-p\fR \fIplatform\fR" 4
+.IP "\fB\-p\fR \fIplatform\fR" 4
 .IX Item "-p platform"
 The platform string that is matched against the index for binary
 packages. Default is to use the \fI%{_target_platform}\fR variable.
-.Ip "\fB\-D\fR\fIvar\fR=\fIval\fR" 4
+.IP "\fB\-D\fR\fIvar\fR=\fIval\fR" 4
 .IX Item "-Dvar=val"
 Specify configuration options for all selected packages. This can be
 either \fB\-D\fR\f(CW\*(C`with_\*(C'\fR\fIxxx\fR\f(CW\*(C`=\*(C'\fR\fIyyy\fR or just \fB\-D\fR\f(CW\*(C`with_\*(C'\fR\fIxxx\fR, the
@@ -345,16 +344,16 @@ latter is equivalent to a \fB\-D\fR\f(CW\*(C`with_\*(C'\fR\fIxxx\fR\f(CW\*(C`=\*
 are matched against selected packages that are already installed. If
 they do indicate a change the package is rebuild. There can be multiple
 \&\fB\-D\fR options.
-.Ip "\fB\-E\fR \fIname\fR" 4
+.IP "\fB\-E\fR \fIname\fR" 4
 .IX Item "-E name"
 Ignore a package with the specified \fIname\fR. This can be used to avoid
 upgrading to a broken package in the repository. There can be multiple
 \&\fB\-E\fR options.
-.Ip "\fB\-a\fR" 4
+.IP "\fB\-a\fR" 4
 .IX Item "-a"
 Select all installed packages. Do not specify a pattern list together
 with the \fB\-a\fR option.
-.Ip "\fB\-A\fR" 4
+.IP "\fB\-A\fR" 4
 .IX Item "-A"
 Select all packages in the repository. Do not specify a pattern list together
 with the \fB\-a\fR option.