OpenPKG CVS Repository
http://cvs.openpkg.org/
____________________________________________________________________________
Server: cvs.openpkg.org Name: Michael van Elst
Root: /e/openpkg/cvs Email: [EMAIL PROTECTED]
Module: openpkg-re Date: 26-Nov-2002 11:29:38
Branch: HEAD Handle: 2002112610293800
Modified files:
openpkg-re openpkg-build
Log:
added POD
Summary:
Revision Changes Path
1.51 +151 -1 openpkg-re/openpkg-build
____________________________________________________________________________
Index: openpkg-re/openpkg-build
============================================================
$ cvs diff -u -r1.50 -r1.51 openpkg-build
--- openpkg-re/openpkg-build 25 Nov 2002 16:49:45 -0000 1.50
+++ openpkg-re/openpkg-build 26 Nov 2002 10:29:38 -0000 1.51
@@ -102,7 +102,7 @@
close(FH);
}
-die "usage: $0 [-R rpm] [-r repository] [-f index.rdf] [-uUzZEiq] [-P priv-cmd] [-N
non-priv-cmd] [-p platform] [-Dwith ...] [-Ename ...] ( [-aA] | patternlist )\n"
+die "usage: $0 [-R rpm] [-r repository] [-f index.rdf] [-uUzZiq] [-P priv-cmd] [-N
non-priv-cmd] [-p platform] [-Dwith ...] [-Ename ...] ( [-aA] | patternlist )\n"
unless $#ARGV >= 0 || ($#ARGV == -1 && ($opt_a || $opt_A));
##########################################################################
@@ -1290,3 +1290,153 @@
print_list1($list,$config,$opt_a || $opt_u || $opt_U,\%with,$opt_i);
print_list2($bonly,$config);
+
+=pod
+
+=head1 NAME
+
+ openpkg-build
+
+=head1 VERSION
+
+$Id: openpkg-build,v 1.51 2002/11/26 10:29:38 mlelstv Exp $
+
+=head1 SYNOPSIS
+
+openpkg-build [-R rpm] [-r repository] [-f index.rdf] [-uUzZiq] [-P priv-cmd] [-N
non-priv-cmd] [-p platform] [-Dwith ...] [-Ename ...] ( [-aA] | patternlist )
+
+=head1 DESCRIPTION
+
+B<openpkg-build> writes a shell script to standard output that installs
+or upgrades software packages including all dependencies. Packages that
+are upgraded automatically trigger rebuilds of all packages that depend
+on the upgraded package ("reverse dependencies").
+
+The dependency information is read from an index generated by B<openpkg-index>.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-R rpm>
+
+Specify a path to the installed B<OpenPKG> rpm binary. Several other
+internal paths are deduced from the rpm path, so this should be
+something like I<%{l_prefix}/bin/rpm>.
+
+=item B<-r repository>
+
+Specify a path to an RPM repository, this can be a URL or a directory
+path. The name of the package file is appended to this path.
+The default is to use a URL pointing to the B<OpenPKG> ftp server.
+
+=item B<-f index.rdf>
+
+Specify a path to the primary index, this can be a URL or a file
+path. If the index contains references to aother indexes these
+are included automatically.
+The default is to use a URL pointing to the B<OpenPKG> ftp server
+for the B<OpenPKG> release you are using.
+
+=item B<-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.
+
+=item B<-U>
+
+The generated script will try to upgrade all selected packages
+including their dependencies to the most recent version.
+
+=item B<-z>
+
+The generated script will rebuild all selected packages
+including their dependencies even when the most recent version
+is already installed.
+
+=item B<-Z>
+
+B<openpkg-build> ignores a installed packages, the
+script will rebuild all selected packages from scratch.
+Note that this doesn't work together with the B<-a> option.
+
+=item B<-i>
+
+The generated script will ignore errors. However, if a build
+phase fails the install phase is still skipped.
+
+=item B<-q>
+
+Ignore all reverse dependencies. B<ATTENTION: this might break
+already installed packages.>
+
+=item B<-P priv-cmd>
+
+Prefix to use for install commands that require elevated privileges.
+The most common tool for this is sudo(1).
+
+=item B<-N non-priv-cmd>
+
+Prefix to use for install commands that do not require elevated privileges.
+
+=item B<-p platform>
+
+The platform string that is matched against the index for binary
+packages. Default is to use the I<%{_target_platform}> variable.
+
+=item B<-Dwith>
+
+Specify configuration options for all selected packages. This can
+be either B<-Dwith_xxx=yyy> or B<-Dwith_xxx>, the latter is equivalent
+to a B<-Dwith_xxx=yes>.
+The parameters are matched against selected packages that are already
+installed. If they do indicate a change the package is rebuild.
+There can be multiple B<-D> options.
+
+=item B<-Ename>
+
+Ignore a package with the specified name. This can be used to
+avoid upgrading to a broken package in the repository.
+There can be multiple B<-E> options.
+
+=item B<-a>
+
+Select all installed packages. Do not specify a pattern list together
+with the B<-a> option.
+
+=item B<-A>
+
+Select all packages in the repository. Do not specify a pattern list together
+with the B<-a> option.
+
+=back
+
+=head1 CONFIGURATION
+
+B<openpkg-build> reads the configuration file I<$HOME/.openpkg-build.rc>.
+The file lists default options, one option per line and section tags
+of the form I<[prefix]>. Options following such a tag are only evaluated
+if the selected RPM path matches the prefix so that you can define
+default options for multiple B<OpenPKG> hierarchies.
+
+=head1 CAVEATS
+
+Parallel execution of B<openpkg-build> causes undefined effects.
+
+=head1 BUGS
+
+Plenty. No ?
+
+=head1 SEE ALSO
+
+openpkg-index, rpm(1), sudo(1)
+
+=head1 HISTORY
+
+=head1 AUTHORS
+
+ Michael van Elst
+ [EMAIL PROTECTED]
+
+=cut
______________________________________________________________________
The OpenPKG Project www.openpkg.org
CVS Repository Commit List [EMAIL PROTECTED]
