Add pod versions of the manpages, bound to replace the nroff ones

1 files changed, 257 insertions, 0 deletions

diff --git a/pod/urpmq.8.pod b/pod/urpmq.8.pod
new file mode 100644
index 00000000..6579bec5
--- /dev/null
+++ b/pod/urpmq.8.pod
@@ -0,0 +1,257 @@
+=head1 NAME
+
+urpmq - urpmi database query tool.
+
+=head1 SYNOPSIS
+
+    urpmq [options] [package_names | rpm_files...]
+
+=head1 DESCRIPTION
+
+urpmq is a tool to access and query the urpmi database. It can be used to
+list available packages in the various urpmi media, or to list the full
+dependencies of a package, or to list the packages that will be installed
+if you start urpmi. The output of urpmq has the following format, adjusted
+according to the command-line options that were used:
+
+    [group/]package_name[-version][-release][.arch]
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Prints a help message and exit (this is the same as B<-h> or B<-?>).
+
+=item B<--list>
+
+List available packages.
+
+=item B<--list-media> [I<type>]
+
+List available media. You can optionally add a type selector: B<all> to
+list all media (the default), B<update> to list the update media, or
+B<active> to list only active media.
+
+=item B<--list-url>
+
+List available media and their URLs.
+
+=item B<--list-nodes>
+
+List available nodes when using B<--parallel>.
+
+=item B<--list-aliases>
+
+List available parallel aliases.
+
+=item B<--update>
+
+Use only update
+media. This means that B<urpmq> will search and resolve dependencies only in
+media marked as containing updates.
+
+=item B<--media> I<media1,...,mediaN>
+
+Select specific
+media to be used, instead of all available media (or update media if B<--update>
+is used).
+
+=item B<--excludemedia> I<media1,...,mediaN>
+
+Do not use the specified media.
+
+=item B<--searchmedia> I<media>
+
+Use only the specified medium to search for packages when combined with
+B<--auto-select>.
+
+=item B<--sortmedia> I<media1,...,mediaN>
+
+Sort the specified media. Substrings may be used to simplify grouping.
+
+=item B<--synthesis> I<file>
+
+Use the specified synthesis file instead of the urpmi database for
+searching packages and resolving dependencies.
+
+=item B<--auto-select>
+
+Automatically select all packages that have to be
+upgraded, according to already installed packages and packages listed in
+various registered media.
+
+=item B<--keep>
+
+When some dependencies cannot be satisfied,
+change the selection of packages to try to keep existing packages instead
+of removing them. This behaviour generally rejects the upgrade of packages
+given on command line (or when using B<--auto-select>) when a dependency error
+occurs.
+
+=item B<--fuzzy>
+
+Disable fast search on exact package name; i.e. it will propose
+all packages matching the name partially, even if one of them matches exactly
+the specified name (this is the same as B<-y>).
+
+=item B<--src> I<name>
+
+Search a source package
+matching I<name> and it will select all dependencies by default.
+
+=item B<--headers>
+
+Extract
+and dump headers of selected packages to standard output. (Can be used by
+the superuser only.)
+
+=item B<--sources>
+
+Prints source URLs (or file names) of all selected
+packages. (Can be used by the superuser only.)
+
+=item B<--force>
+
+Continue when requesting
+packages that are not available.
+
+=item B<--parallel> I<alias>
+
+Activate distributed execution of urpmi to other machines (it is mandatory
+that urpmi is installed but it is not necessary to have media defined on
+any machines). I<alias> defines which extension module to use by urpmi
+(currently B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh>) and which
+machines should be updated, this alias is defined in the file
+F</etc/urpmi/parallel.cfg> as described below.
+
+=item B<--root> I<directory>
+
+Use the file system tree rooted for rpm install. All operations and
+scripts will run after chroot(2). The rpm database in the rooted tree
+will be used but urpmi configuration comes from normal system.
+
+=item B<--wget>
+
+Use wget for downloading distant files. By default curl
+is used if available, or wget instead.
+
+=item B<--curl>
+
+Use curl for downloading distant files. By default curl is used if
+available, or wget instead.
+
+=item B<--proxy> I<proxyhost[:port|1080]>
+
+Use specified HTTP proxy.
+
+=item B<--proxy-user> I<user:password>
+
+Use specified user and password to use for proxy authentication.
+Specifying B<--proxy-user=ask> will cause urpmq to prompt for a username
+and a password.
+
+=item B<--use-distrib> I<directory>
+
+Configure urpmq on the fly from a distrib tree. You must be root to use
+this option.
+
+=item B<--env> I<directory>
+
+Use a different environment directly from a bug report to replay a bug.
+The argument is the same argument given to B<--bug> option.
+
+=item B<--changelog>
+
+Prints the package changelog.
+
+=item B<--summary>
+
+Prints concise information about the package.
+
+=item B<-v>
+
+Activate verbose mode.
+
+=item B<-d>
+
+Select dependencies (maximal closure).
+
+=item B<-u>
+
+Deselect packages if a better version is already installed, this option
+can be used with B<-d> to simulate B<-M> mode of B<urpmi>.
+
+=item B<-a>
+
+Select all matches on command line, useful when using B<-f> or B<-r> with
+incomplete name given.
+
+=item B<-c>
+
+If maximal closure is used, assume that a package listed may have wrong or
+not up-to-date dependencies. This causes more packages to be upgraded and
+may correct unresolved dependencies on the rpm database.
+
+=item B<-p>
+
+Search in provides to find package (this is the opposite of B<-P>).
+
+=item B<-P>
+
+Do not search in provides to find package (this is the opposite
+of B<-p> and is the default).
+
+=item B<-R>
+
+Reverse search to what requires the package given. If you specify this
+option twice, looks also through virtual packages to find the
+dependencies.
+
+=item B<-S>
+
+Same as B<--summary>.
+
+=item B<-y>
+
+This is the same as B<--fuzzy>.
+
+=item B<-Y>
+
+Like B<-y>, but forces to match case-insensitively.
+
+=item B<-s>
+
+This is the same as B<--src>.
+=item B<-i>
+
+Prints useful information in human readable form, as for I<rpm -qi>.
+
+=item B<-g>
+
+Prints groups of each package listed.
+
+=item B<-r>
+
+Prints version and release of each package listed.
+
+=item B<-f>
+
+Prints version, release and arch of each package listed.
+
+=back
+
+=head1 FILES
+
+See urpmi.files(5).
+
+=head1 SEE ALSO
+
+urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
+urpmi(8), urpmi.files(5).
+
+=head1 AUTHOR
+
+Pascal Rigaux (original author), FranE<ccedil>ois Pons,
+Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer)