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

11 files changed, 1679 insertions, 0 deletions

diff --git a/pod/proxy.cfg.5.pod b/pod/proxy.cfg.5.pod
new file mode 100644
index 00000000..660c39d0
--- /dev/null
+++ b/pod/proxy.cfg.5.pod
@@ -0,0 +1,29 @@
+=head1 NAME
+
+proxy.cfg - urpmi proxy configuration file format.
+
+=head1 DESCRIPTION
+
+The proxy.cfg file contains lines of the form
+
+ [media:]http_proxy=[value]
+ [media:]ftp_proxy=[value]
+ [media:]proxy_user=[value]
+
+where the media part is optional (in this case, the line applies to all
+media). ftp_proxy and http_proxy values have the same syntax as the usual
+environment variables used by many programs such as curl(1):
+
+ [protocol://]<host>[:port]
+
+proxy_user values are simply a user name, or a user name and a password
+separated by a colon (C<:>).
+
+=head1 AUTHOR
+
+FranE<ccedil>ois Pons, Rafael Garcia-Suarez <rgarciasuarez@mandriva.com>
+(current maintainer)
+
+=head1 SEE ALSO
+
+urpmi(8), urpmi.cfg(5), urpmi.files(5).
diff --git a/pod/rurpmi.8.pod b/pod/rurpmi.8.pod
new file mode 100644
index 00000000..03957cda
--- /dev/null
+++ b/pod/rurpmi.8.pod
@@ -0,0 +1,35 @@
+=head1 NAME
+
+rurpmi - restricted urpmi
+
+=head1 SYNOPSIS
+
+ rurpmi [options] [package_names]
+
+=head1 DESCRIPTION
+
+rurpmi is similar to urpmi, but has a stripped-down set of features. It's
+intended to be used by users with sudo rights on it, preventing them to
+abuse it to compromise the system. With it, you can't install arbitrary
+rpm files, the B<--keep>, B<--verify-rpm>, and B<--norebuild> options are
+forced, and several dangerous options are forbidden (B<--root>,
+B<--use-distrib>, B<--env>, B<--nolock>, B<--allow-nodeps>,
+B<--allow-force>, B<--force>).
+
+=head1 CAVEAT
+
+This software is still experimental. While some operations are forbidden,
+there is no guarantee it is actually secure.
+
+=head1 OPTIONS
+
+The options are the same than urpmi ones.
+
+=head1 AUTHOR
+
+Maintained by Rafael Garcia-Suarez,
+<rgarciasuarez@mandriva.com>
+
+=head1 SEE ALSO
+
+L<I<urpmi>(8)>.
diff --git a/pod/urpme.8.pod b/pod/urpme.8.pod
new file mode 100644
index 00000000..4ce455a2
--- /dev/null
+++ b/pod/urpme.8.pod
@@ -0,0 +1,92 @@
+=head1 NAME
+
+urpme - rpm deinstaller
+
+=head1 SYNOPSIS
+
+    urpme [options] [package_names]
+
+=head1 DESCRIPTION
+
+urpme allow packages to be deinstalled,
+including all their dependencies. I<package_names> must have one of the forms
+I<name>, I<name-version>, I<name-version-release>, or I<name-version-release.architecture>.
+If you want to specify packages more broadly, use the B<-a> option.
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Prints a help message and exit (this is the same as B<-h> or B<-?>). 
+
+=item B<-a>
+
+If multiple packages match the given substring, deinstall them all. 
+
+=item B<-v>
+
+Proposes a verbose mode with various messages. 
+
+=item B<--auto>
+
+Removes packages non-interactively, without asking questions. 
+
+=item B<--test>
+
+Test deinstallation of packages but do not modify the system.
+
+=item B<--force>
+
+Force invocation even if some packages do not exist. 
+
+=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 is to be used by
+urpmi (currently, B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh> are
+available) 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 that lies in the
+rooted tree will be used, but the urpmi configuration comes from the
+normal system.
+
+=item B<--use-distrib> I<directory>
+
+Configure urpme on the fly from a distribution tree.
+
+=back
+
+=head1 FILES
+
+See urpmi.files(5).
+
+=head1 EXIT CODES
+
+=over
+
+=item 1
+
+Command line inconsistency. 
+
+=item 2
+
+Removal of packages failed.
+
+=back
+
+=head1 AUTHORS
+
+Pascal Rigaux, Francois Pons, Rafael Garcia-Suarez
+<rgarciasuarez@mandriva.com> (current maintainer)
+
+=head1 SEE ALSO
+
+urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
+urpmi(8), urpmq(8), urpmi.files(5). 
diff --git a/pod/urpmf.8.pod b/pod/urpmf.8.pod
new file mode 100644
index 00000000..5700d8dc
--- /dev/null
+++ b/pod/urpmf.8.pod
@@ -0,0 +1,255 @@
+=head1 NAME
+
+urpmf - Finds the packages matching some conditions
+
+=head1 SYNOPSIS
+
+    urpmf [options] <pattern-expression>
+
+=head1 DESCRIPTION
+
+By default, urpmf outputs the list of the known packages that contain a
+file whose name or path was specified as an argument on the command-line.
+<I<pattern-expression>> is the name or part of the name of the file you
+want to locate. Perl-style regular expressions are allowed. B<urpmf> will
+then print a list of matching files, with their corresponding packages. By
+using options, you may format output differently, and search through other
+rpm tags. Note that B<urpmf> searches through the urpmi media (B<not> in
+the system's rpm database -- for that you should use rpm(8) instead).
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Prints a help message and exits.
+
+=item B<--version>
+
+Prints the version number and exits.
+
+=item B<--env> I<directory>
+
+Use a different environment directly out of a bug report tarball.
+
+=item B<--excludemedia> I<medium1,...,mediumN>
+
+Do not use the given media.
+
+=item B<--literal>
+
+Match literally instead of interpreting the argument as a regular
+expression.
+
+=item B<-l>
+
+Equivalent to B<--literal>.
+
+=item B<--media> I<medium1,...,mediumN>
+
+Select specific media to be used, instead of defaulting to all available
+media (or all update media if B<--update> is used).
+
+=item B<--sortmedia> I<medium1,...,mediumN>
+
+Sort the given media, substrings may be used to simplify grouping.
+
+=item B<--synthesis> I<file>
+
+Use the given synthesis file instead of urpmi db for searching packages.
+
+=item B<--uniq>
+
+Do not print identical lines twice.
+
+=item B<--update>
+
+Use only update media. This means B<urpmf> will only search through media
+marked as update.
+
+=item B<--verbose>
+
+Verbose mode. B<urpmf> will emit various messages related to the parsing of
+hdlist files for your media.
+
+=item B<-i>
+
+Ignore case distinctions in any patterns.
+
+=item B<-F> I<string>
+
+Change field separator to I<string> for the rest of the output line (it
+defaults to ':')
+
+=item B<--qf> I<format-string>
+
+Specify a printf-like output format.
+
+=item B<--arch>
+
+Prints the architecture tag.
+
+=item B<--buildhost>
+
+Prints the BuildHost tag.
+
+=item B<--buildtime>
+
+Prints the
+BuildTime tag.
+
+=item B<--conffiles>
+
+Prints the list of configuration files contained
+in the package. (Might be empty.)
+
+=item B<--conflicts>
+
+Prints the Conflicts tags.
+
+=item B<--description>
+
+Prints the Description tag.
+
+=item B<--distribution>
+
+Prints the Distribution tag.
+
+=item B<--epoch>
+
+Prints the Epoch tag.
+
+=item B<--filename>
+
+Prints package file names.
+
+=item B<--files>
+
+Prints the list of files contained in the rpm (this is the default if you
+specify no field).
+
+=item B<--group>
+
+Prints the Group tag.
+
+=item B<--name>
+
+Prints package names.
+
+=item B<--obsoletes>
+
+Prints the Obsoletes tags.
+
+=item B<--packager>
+
+Prints the Packager tag.
+
+=item B<--provides>
+
+Prints the Provides tags.
+
+=item B<--requires>
+
+Prints the Requires tag.
+
+=item B<--size>
+
+Prints the Size tag.
+
+=item B<--sourcerpm>
+
+Prints the names of source rpms.
+
+=item B<--summary>
+
+Prints the Summary tag.
+
+=item B<--url>
+
+Prints the packages' URL.
+
+=item B<--vendor>
+
+Prints the Vendor tag.
+
+=item B<-m>
+
+Print the name of the media in which the
+package has been found.
+
+=item B<-f>
+
+Print version, release and arch along with name
+of package. This modifies the effect of the I<--name> option.
+
+=item B<-e>
+
+Include code directly
+in the perl search expression. Use it with B<--debug> to look at the generated
+perl code. In any cases, use it only if you know perl.
+
+=item B<-a>
+
+Binary AND operator, true if both expressions are true.
+
+=item B<-o>
+
+Binary OR operator, true if one expression is true.
+
+=item B<!>
+
+Unary NOT, true if expression is false.
+
+=item B<(>
+
+Left parenthesis to open a group expression.
+
+=item B<)>
+
+Right parenthesis to close a group expression.
+
+=item B<--debug>
+
+Includes debugging output.
+
+=back
+
+=head1 FORMAT
+
+The options to select tags (B<--arch>, B<--buildhost> and so on) control
+the output format of urpmf. If not explicitly specified somewhere else,
+the name of the rpm is printed first. Fields are separated by C<:> until
+specified otherwise.
+
+You can also use B<--qf> for that. It takes a format string, where tags to
+be replaced are specified as B<%>I<[-][number]>B<tagname>. The optional
+number indicates the length of the space-padding and the B<-> character
+its justification (like in printf(3)).
+
+=head1 EXPRESSIONS
+
+The boolean operator switches allow you to construct complex expressions
+from regexps. Those expressions are then matched against the whole output
+line.
+
+=head1 EXAMPLE
+
+This command will list all C<perl-Apache> modules, and list them along
+with the media in which they're been found, nicely indented :
+
+    urpmf --qf '%-30name is found in media %media' perl-Apache
+
+=head1 FILES
+
+See urpmi.files(5).
+
+=head1 SEE ALSO
+
+urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmi(8),
+urpmq(8), urpmi.files(5).
+
+=head1 AUTHOR
+
+Pascal Rigaux (original author), FranE<ccedil>ois Pons, Rafael
+Garcia-Suarez <rgarciasuarez@mandriva.com> (current maintainer)
diff --git a/pod/urpmi.8.pod b/pod/urpmi.8.pod
new file mode 100644
index 00000000..a253ce34
--- /dev/null
+++ b/pod/urpmi.8.pod
@@ -0,0 +1,422 @@
+=head1 NAME
+
+urpmi - rpm downloader, installer and dependency solver
+
+=head1 SYNOPSIS
+
+    urpmi [options] [package_names | rpm_files...]
+
+=head1 DESCRIPTION
+
+urpmi authorizes well-known rpms (or rpm files) to be installed including
+all their dependencies. You can use it to install the dependencies of a
+source package, or a source package itself.
+
+You can compare rpm vs. urpmi with insmod vs. modprobe or dpkg vs apt-get.
+Just launch urpmi followed by what you think is the name of the
+package(s), and urpmi will:
+
+- Propose different package names if the name was ambiguous, and quit.
+
+- If only one corresponding package is found, check whether its
+dependencies are already installed.
+
+- If not, propose to install the dependencies, and on a positive answer,
+proceed.
+
+Note that urpmi handles installations from various types of media (ftp,
+http, rsync, local and nfs volumes, and removable media such as CDROMs)
+and is able to install dependencies from a medium different from the
+original package's media. For removable media, urpmi may ask you to insert
+the appropriate disk, if necessary. To add a new medium containing rpms,
+run urpmi.addmedia. To remove an existing medium, use urpmi.removemedia.
+To update the package list (for example when the ftp archive changes) use
+urpmi.update.
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Print a help message and exit (this is the same as B<-h> or B<-?>).
+
+=item B<--update>
+
+Use only update media. This means that B<urpmi> will search
+packages and resolve dependencies only in media marked as containing updates.
+
+=item B<--media> I<media1,...,mediaN>
+
+Select specific media to be used, instead of defaulting
+to all available media (or all 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 media 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>
+
+Install all required dependencies without asking.
+
+=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<--no-install>
+
+Only download packages, don't install them. You'll find them in
+F</var/cache/urpmi/rpms>.
+
+=item B<--no-uninstall>
+
+Never ask to uninstall a package but prefer aborting instead.
+This can be safer in auto mode.
+
+=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<--split-level I<number>>
+
+Split urpmi's operation in small transactions when
+the total number of packages to upgrade is greater than the given I<number>.
+This option is activated by default, and the default value of I<number> is
+20.
+
+=item B<--split-length I<count>>
+
+Split urpmi's operation in small transactions of at
+least I<count> packages. The default is 1 and setting this value to 0 just
+disables splitting in small transactions.
+
+=item B<--fuzzy>
+
+Disable fast search on exact
+package name; that means that urpmi 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
+select all its dependencies by default, unless B<--install-src> is used in order
+to install the source package itself.
+
+=item B<--install-src>
+
+Install only the source
+package (no binary packages will be installed).
+
+=item B<--clean>
+
+Remove all packages from the cache in directory F</var/cache/urpmi/rpms>.
+
+=item B<--noclean>
+
+Do not remove any package from the cache in directory
+F</var/cache/urpmi/rpms>.
+
+=item B<--force>
+
+Assume yes on all questions.
+
+=item B<--allow-nodeps>
+
+With this option, urpmi will ask the user on error whether it should
+continue the installation without checking dependencies. By default, urpmi
+exits immediately in this case.
+
+=item B<--allow-force>
+
+With this option, urpmi will ask the user on error whether it should
+proceed to a forced installation. By default, urpmi exits immediately in
+this case.
+
+=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 is to be used by
+urpmi (currently, B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh> are
+available) 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 that lies in the rooted
+tree will be used, but the urpmi configuration comes from the normal
+system.
+
+=item B<--use-distrib> I<directory>
+
+Configure urpmi on the fly from a distrib tree, useful to install a chroot
+with the B<--root> option.
+
+=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<--limit-rate I<rate>>
+
+Try to limit the download speed, I<rate> is given in bytes/sec. This
+option is not active by default.
+
+=item B<--resume>
+
+Resume transfer of partially-downloaded files.
+
+=item B<--retry> I<times>
+
+Retries to download files over FTP or HTTP the specified number
+of times.
+
+=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 urpmi to prompt for a username and a password.
+
+=item B<--bug> I<directory>
+
+Create a bug report in I<directory>. You have to send a compressed
+archive of the directory to the urpmi maintainer for the bug being (probably)
+reproduced.
+
+=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<--verify-rpm>
+
+=item B<--no-verify-rpm>
+
+Activate or deactivate rpm signature checking. It's activated
+by default.
+
+=item B<--test>
+
+Test (same as B<rpm --test>) installation of packages but do
+not modify the system.
+
+=item B<--excludepath> I<string>
+
+Do not install files of which the
+names begin with the given I<string> (same as B<rpm --excludepath>).
+
+=item B<--excludedocs>
+
+Do not install documents files (same as B<rpm --excludedocs>).
+
+=item B<--ignoresize>
+
+Don't check
+file systems for sufficient disk space before installation. This is equivalent
+to B<rpm --ignoresize>.
+
+=item B<--skip> I<pattern,...>
+
+You can specify a list of packages which installation should be skipped.
+You can also include patterns between //, just like in
+F</etc/urpmi/skip.list> (see urpmi.files(5)).
+
+=item B<--more-choices>
+
+When several packages are found, propose more choices than the default.
+
+=item B<--norebuild>
+
+Don't try to rebuild the hdlist files from the RPMs if the original hdlist
+wasn't readable or was corrupted.
+
+=item B<--strict-arch>
+
+Upgrade only packages if the newer version has the same architecture as
+the one installed. Mostly useful on machines that support several
+architectures (32 and 64 bit).
+
+=item B<-a>
+
+If multiple packages match the given substring, install them all.
+
+=item B<-p>
+
+Allow search in provides to find package (default).
+
+=item B<-P>
+
+Do not search in provides to find package (this
+is the opposite of B<-p>).
+
+=item B<-y>
+
+This is the same as B<--fuzzy>.
+
+=item B<-s>
+
+This is the same as B<--src>.
+
+=item B<-q>
+
+Quiet mode: when calling rpm no upgrade status is printed.
+
+=item B<-v>
+
+Proposes a verbose mode with various messages.
+
+=back
+
+=head1 EXAMPLES
+
+=over
+
+=item urpmi ssh://foo@bar.net/home/foo/test.rpm
+
+Fetch F</home/foo/test.rpm> from server bar.net over ssh using user foo.
+You can use a public key or enter your password.
+
+=item urpmi --media foo- --auto-select
+
+Fetch all the updates from media containing C<foo-> in their name.
+
+=back
+
+=head1 FILES
+
+See urpmi.files(5).
+
+=head1 EXIT CODES
+
+=over
+
+=item 1
+
+Command line inconsistency.
+
+=item 2
+
+Problem registering local packages.
+
+=item 3
+
+Source packages not retrievable.
+
+=item 4
+
+Medium is not selected.
+
+=item 5
+
+Medium already
+exists.
+
+=item 6
+
+Unable to save configuration.
+
+=item 7
+
+Urpmi database locked.
+
+=item 8
+
+Unable to
+create bug report.
+
+=item 9
+
+Unable to open rpmdb.
+
+=item 10
+
+Some files are missing for installation.
+
+=item 11
+
+Some transactions failed but not all.
+
+=item 12
+
+All transactions failed.
+
+=item 13
+
+Some files are missing and some transactions failed but not all.
+
+=item 14
+
+Some files are missing and all transactions failed.
+
+=back
+
+=head1 BUG REPORTS
+
+If you find a bug in B<urpmi> please report it using the command :
+
+    urpmi --bug bug_name_as_directory ...
+
+This will automatically create a directory called F<bug_name_as_directory>
+containing necessary files to reproduce it if possible. Please test the
+report using
+
+    urpmi --env bug_name_as_directory ...
+
+to check that the bug is still here. Obviously, only reproducible bugs can
+be resolved. For sending the report, make a tarball of this directory and
+send it directly to the current maintainer with a description of what you
+think is wrong.
+
+=head1 BUGS
+
+When a package is removed, it may not be replaced
+with an older version.
+
+=head1 AUTHOR
+
+Pascal Rigaux (original author), Francois Pons,
+Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer)
+
+=head1 CONTRIBUTORS
+
+Please mail to authors if you are not belonging to this alphabetically
+sorted list after having contributed. Andrej Borsenkow, Guillaume
+Cottenceau, Philippe Libat, Bryan Paxton, Guillaume Rousse, Michael
+Scherer, Alexander Skwar, Olivier Thauvin, Erwan Velu, Florent Villard.
+
+=head1 SEE ALSO
+
+urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
+urpmq(8), urpmi.cfg(5), urpmi.files(5).
diff --git a/pod/urpmi.addmedia.8.pod b/pod/urpmi.addmedia.8.pod
new file mode 100644
index 00000000..e5e83493
--- /dev/null
+++ b/pod/urpmi.addmedia.8.pod
@@ -0,0 +1,206 @@
+=head1 NAME
+
+urpmi.addmedia - adds a new rpm medium to be used by urpmi
+
+=head1 SYNOPSIS
+
+    urpmi.addmedia [options] <name> <url> [with <hdlist>]
+
+=head1 DESCRIPTION
+
+urpmi.addmedia is used to add a new media to be used by urpmi, so it can
+find new rpms at the specified location. Currently supported media types
+are: local drives, removable drives (such as CDs), and networked media via
+different protocols (http, ftp, ssh and rsync). One of the following modes
+must be chosen:
+
+=over
+
+=item B<urpmi.addmedia [I<options>>] <I<name>> http://<I<login>>:<I<pass>>@<I<host>>/<I<path>> [with <I<relative path of synthesis|hdlist>>]
+
+where <I<name>> is your reference for the medium (e.g. "updates").
+<I<name>> is optional if B<--distrib> is given in the options list.
+<I<host>>/<I<path>> is the location of the media directory on the net
+(e.g. C<media/main>). <I<relative path of hdlist>> is the pathname where
+to find the hdlist of the rpms. The location is given relative to
+<I<path>>. B<curl> is used by default to download files, B<wget> may be
+used if B<curl> is not installed or if or B<--wget> is given in
+I<options>. Example:
+
+    urpmi.addmedia http http://jpackage.sf.net/rpm/free with hdlist.cz ftp:
+
+=item B<urpmi.addmedia [I<options>>] <I<name>> ftp://<I<login>>:<I<pass>>@<I<host>>/<I<path>> [with <I<relative path of synthesis|hdlist>>]
+
+The same as for http. Add your login and password if required (note that
+you don't need to specify B<anonymous> as login for anonymous access ftp
+servers). If B<wget> is used to download files with a firewall you may
+have to ensure that the B<passive_ftp> option is on in B</etc/wgetrc>
+(that's usually the default). Example:
+
+    urpmi.addmedia ftp ftp://a:a@leia//export/media/main with media_info/hdlist.cz
+
+=item B<urpmi.addmedia [I<options>>] <I<name>> ssh://<I<login>>@<I<host>>/<I<path>> [with <I<relative path of synthesis|hdlist>>]
+
+The same as for http and ftp; add your login and password if required. It
+is strongly recommended to export the public key in order not to have to
+type your password all the time. B<scp> and B<rsync> will be used to get
+files. Example:
+
+    urpmi.addmedia -h ssh ssh://fpons@bi/c/i586/media/main
+
+=item B<urpmi.addmedia [I<options>>] <I<name>> rsync://<I<login>>@<I<host>>:<I<port>>/<I<path>> [with <I<relative path of synthesis|hdlist>>]
+
+The same as for http; you can use the <I<host>>::<I<path>> syntax too. Example:
+
+    urpmi.addmedia rsync rsync://ftp.orst.edu::mandrake-devel/contrib/ppc with ../../cooker/ppc/media/media_info/hdlist2.cz
+
+=item B<urpmi.addmedia [I<options>>] <I<name>> file://<I<path>> [with <I<relative path of synthesis|hdlist>>]
+
+where <I<name>> is your reference for the medium (e.g. Myrpms). <I<path>>
+is the location of the media directory on your machine (e.g. C<media/main>).
+
+=item B<urpmi.addmedia [I<options>>] <I<name>> removable://<I<path>> [with <I<relative path of synthesis|hdlist>>]
+
+<I<path>> is the location of the media directory on your machine when the
+removable device is mounted. This works for removable drives, but also for
+ISO images mounted on a loop device. urpmi will then be able to re-mount
+the ISO image to the specified path (but the ISO image must be mounted
+when you run B<urpmi.addmedia>).
+
+=back
+
+=head1 OPTIONS
+
+=over
+
+=item B<--wget>
+
+Use wget only for downloading distant files. By default curl is used if
+available.
+
+=item B<--curl>
+
+Use curl only for downloading distant files. This is the default if curl
+is available.
+
+=item B<--limit-rate I<rate>>
+
+Try to limit the download speed, I<rate> is given in bytes/sec. This option
+is not active by default.
+
+=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 urpmi.addmedia to prompt for a
+username and a password.
+
+=item B<--update>
+
+Add a medium which will be taken into
+account by B<MandrivaUpdate> or by B<urpmi --update> when looking for updates.
+
+=item B<--probe-synthesis>
+
+Try to find and use synthesis file if B<with ...> is not given.
+
+=item B<--probe-hdlist>
+
+Try to find and use hdlist file if B<with ...> is not given.
+
+=item B<--no-probe>
+
+Do not try to find any synthesis or hdlist file.
+
+=item B<--distrib>
+
+Retrieve a set of media from a distribution. Typically, the URL provided
+to B<urpmi.addmedia> will represent the parent directory of a directory
+B<media>, which in turn will contain various subdirectories for each
+medium of the distribution. <I<name>> is combined with medium names found
+to create newer medium names in the urpmi database. The B<with ...>
+option, if provided, is ignored, as hdlists found on the installation
+medium are used instead automatically.
+
+=item B<--from> I<url>
+
+Use specified URL for list of mirrors. The default is taken from the file
+F</etc/urpmi/mirror.config>, or
+F<http://www.mandrivalinux.com/mirrorsfull.list> if this file doesn't
+exist.
+
+=item B<--version> I<version>
+
+Use specified distribution version. The default is taken from the version
+of the distribution told by the installed mandriva-release package.
+
+=item B<--virtual>
+
+Creates a virtual medium. This only works for C<file://> and
+C<removable://> protocols, and no files will be created in
+F</var/lib/urpmi>. The medium is always up-to-date and so it does not need
+to be updated by B<urpmi.update>.
+
+=item B<--norebuild>
+
+Don't try to rebuild the hdlist files from the RPMs
+if the original hdlist wasn't readable or was corrupted.
+
+=item B<--raw>
+
+Add the new media
+in the urpmi configuration file, but don't update it nor proceed to any
+download. The media, to be usable, will need to be updated with B<urpmi.update>.
+
+=item B<--nopubkey>
+
+Don't import pubkey of added media.
+
+=item B<-c>
+
+Clean headers cache directory in F</var/cache/urpmi/headers>.
+
+=item B<-h>
+
+Try to find and use synthesis or hdlist file.
+
+=item B<-f>
+
+Force rebuild of base files, or of hdlist files when specified twice.
+
+=back
+
+=head1 Variables
+
+Beginning with urpmi 4.6.16, you can use variables in media URLs (for
+example F</mnt/mirror/$RELEASE/$ARCH/media/main>). The variables supported
+so far are:
+
+=over
+
+=item B<$ARCH>
+
+The architecture (as given in F</etc/mandriva-release>)
+
+=item B<$RELEASE>
+
+The OS release (as given in F</etc/mandriva-release>; its value is
+B<cooker> on a cooker system.)
+
+=item B<$HOST>
+
+The canonical hostname of the machine urpmi runs on.
+
+=back
+
+=head1 SEE ALSO
+
+urpmi(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), urpmq(8), urpmi.files(5).
+
+=head1 Author
+
+Pascal Rigaux (original author), FranE<ccedil>ois Pons, Rafael
+Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer)
diff --git a/pod/urpmi.cfg.5.pod b/pod/urpmi.cfg.5.pod
new file mode 100644
index 00000000..3b820474
--- /dev/null
+++ b/pod/urpmi.cfg.5.pod
@@ -0,0 +1,169 @@
+=head1 NAME
+
+urpmi.cfg - urpmi option and media configuration file format
+
+=head1 DESCRIPTION
+
+The urpmi.cfg file is divided in multiple sections: one section to set
+global options, and one section per media.
+
+=head1 GLOBAL OPTIONS
+
+Some global options can be activated by default. The following sample
+shows how to disable signature checking and avoid transaction splits :
+
+    {
+	no-verify-rpm
+	split-length: 0
+    }
+
+The following options can be written in this section :
+
+=over
+
+=item B<allow-force>
+
+Same as specifying B<--allow-force> for B<urpmi>, disabled by default.
+
+=item B<allow-nodeps>
+
+Same as specifying B<--allow-nodeps> for B<urpmi>, disabled by default.
+
+=item B<downloader>
+
+Specify which download program to use: B<wget> or B<curl>.
+
+=item B<excludedocs>
+
+Same as specifying B<--excludedocs> for B<urpmi>, disabled by default.
+
+=item B<excludepath>
+
+Same as B<--excludepath> for B<urpmi>. This options allows to give a comma
+separated list of paths to be excluded on installation. There is no path
+exclusion by default.
+
+=item B<fuzzy>
+
+Same as B<--fuzzy> for B<urpmi> or B<urpmq>. Enable or disable fuzzy
+search, disabled by default. Enabling it can be written in various ways :
+C<fuzzy> or C<fuzzy: yes> or C<fuzzy: on> or C<fuzzy: 1>.
+
+=item B<key-ids>
+
+This option is not available on the command line. It allows to use a comma
+separated list of key ids to be globally accepted (keys still need to be
+authorized by B<rpm>) for any medium unless a specific B<key-ids> option
+for this medium is given. There is no default (even Mandriva public key id
+70771ff3 is not included by default).
+
+=item B<limit-rate>
+
+Same as B<--limit-rate> for all tools. This option allows to control
+download speed; there is no limitation by default. The number is given in
+kilo-bytes per second, unless a suffix C<K> or C<M> is added.
+
+=item B<nopubkey>
+
+Don't import pubkeys when updating media.
+
+=item B<noreconfigure>
+
+Specifies that the media should not be reconfigured (by a reconfiguration
+file present on the medium).
+
+=item B<norebuild>
+
+Same as B<--norebuild> for B<urpmi>, B<urpmi.update> and
+B<urpmi.addmedia>, disabled by default (meaning that B<urpmi> will try to
+rebuild hdlists by default).
+
+=item B<pre-clean, post-clean, clean>
+
+Control cache management for B<urpmi>, default is only activated as
+B<post-clean>.
+
+=item B<prohibit-remove>
+
+A comma-separated list of package names that must never be removed (just
+like B<basesystem> dependencies).
+
+=item B<retry>
+
+Specify how many times the downloader should retry in case of non-permanent
+errors.
+
+=item B<split-length>
+
+Same as B<--split-length> for B<urpmi>. This option allows to control the
+minimal length of splitted transactions. The default value is 1 (smallest
+possible transaction). Setting this value to 0 disables the splitting of
+transactions.
+
+=item B<split-level>
+
+Same as B<--split-level> for B<urpmi>. This option allows to control if
+transactions should be splitted depending of the number of packages to
+upgrade. The default value is 20.
+
+=item B<strict-arch>
+
+Same as B<--strict-arch> for B<urpmi>. Boolean option, disabled by
+default, meaning that packages can be upgraded with versions for another
+architecture.
+
+=item B<verify-rpm>
+
+Same as B<--verify-rpm> for B<urpmi>. Enable or disable signature checking
+(it's enabled by default). Disabling it can be written in various ways (as
+for all the other boolean options) : C<no-verify-rpm> or C<verify-rpm: no>
+or C<verify-rpm: off> or C<verify-rpm: 0>.
+
+=back
+
+=head1 MEDIUM DESCRIPTION
+
+A medium is described as follows :
+
+    name url {
+	hdlist: ...
+	... list of options, one per line ...
+    }
+
+where B<name> is the medium name (space characters must be prefixed by a
+backslash) and where the optional B<url> is the medium URL (if no B<url>
+is given, it will be guessed according to the mandatory list file).
+
+Most other options like B<list>, B<with_hdlist>, B<synthesis>,
+B<removable>, B<virtual> are for internal use and should be changed only
+by experienced users.
+
+Options like B<update>, B<ignore> or B<key-ids> can be modified by users
+to respectively mark mediums as update sources, to have them being
+ignored, or to specify the allowed GPG key ids for packages from the
+medium for verification (unless of course signature checking has been
+disabled globally). It's also possible to override B<verify-rpm> and
+B<downloader> in a medium description.
+
+Media can be marked as B<static>: this means that they won't be updated by
+B<urpmi.update> or other means. This is useful for read-only media such as
+CDs.
+
+Please note that B<key-ids> is automatically set by B<urpmi.update> or
+B<urpmi.addmedia> if a remote pubkey file is available on the mirror. This
+file contains all the GPG armor keys that may be used.
+
+=head1 BUGS
+
+A C<{> should finish a line, as well as a C<}> should start it when used.
+This means the construction C<{ no-verify-rpm }> on a single line is
+invalid.
+
+=head1 AUTHOR
+
+Pascal Rigaux (original author), Francois Pons, Rafael Garcia-Suarez,
+<rgarciasuarez@mandriva.com> (current maintainer)
+
+=head1 SEE ALSO
+
+urpmi(8), urpmi.files(5).
diff --git a/pod/urpmi.files.5.pod b/pod/urpmi.files.5.pod
new file mode 100644
index 00000000..d11385e9
--- /dev/null
+++ b/pod/urpmi.files.5.pod
@@ -0,0 +1,83 @@
+=head1 NAME
+
+urpmi.files - files used by the urpmi tools
+
+=head1 DESCRIPTION
+
+The urpmi tools (urpmi, urpme, urpmi.addmedia, urpmi.update, etc.) use
+several different files to store the state of the RPM repositories (or
+media). This manual page documents them.
+
+=head1 FILES
+
+=over
+
+=item I</var/lib/urpmi/list.<media_name>>
+
+Contains the list of all packages known by urpmi and their location. This
+file is used when a password is used to access a distant location (using
+a network protocol) or when various directories are used to store the
+packages. That's why it's not world-readable.
+
+=item I</var/lib/urpmi/hdlist.<media_name>.cz>
+
+Contains information about all known packages; it's a summary of rpm
+headers. If an hdlist file is used for a medium, B<urpmf> can operate
+completely without accessing this medium (this is almost always the case).
+
+=item I</var/lib/urpmi/synthesis.hdlist.<media_name>.cz>
+
+Contains synthesis information about all known packages built from hdlist
+files that can be used by minimal closure algorithm. If these files are
+not present, hdlist files will be used instead to resolve dependencies
+(but this is much slower).
+
+=item I</etc/urpmi/urpmi.cfg>
+
+Contains media descriptions.
+See urpmi.cfg(5).
+
+=item I</etc/urpmi/proxy.cfg>
+
+Contains proxy descriptions for http and ftp media. See proxy.cfg(5).
+
+=item I</etc/urpmi/parallel.cfg>
+
+Contains the descriptions of parallel aliases, one per line. Their general
+format is B<< <alias>:<interface[(media)]>:<interface_parameter> >> where
+B<< <alias> >> is a symbolic name to identify the parallel alias, B<<
+<interface> >> is one of the parallel install methods (can be B<ka-run> or
+B<ssh>), B<< <media> >> is a media list (as given to the B<--media>
+parameter), and finally B<< <interface_parameter> >> is a specific interface
+parameter list like C<-c ssh -m node1 -m node2> for B<ka-run> extension or
+C<node1:node2> (list of node hostnames) for B<ssh> extension.
+
+=item I</etc/urpmi/skip.list>
+
+The list of packages that should not be automatically
+updated when using --auto-select. It contains one package expression per line;
+either a package name, or a regular expression (if enclosed in slashes
+B</>) to match the name of packages against. (Actually, it's matched against
+the full name of the package, which has the form B<name-version-release.arch>.)
+
+=item I</etc/urpmi/inst.list>
+
+The list of packages that should be installed instead of updated. It has
+the same format as the skip.list.
+
+=item I</etc/urpmi/mirror.config>
+
+This file is optional. If present, it should contain a single line:
+B<url=http://....> which is the URL of a document that lists the available
+mirrors. The default is to use
+B<http://www.mandrivalinux.com/mirrorsfull.list>.
+
+=item I</var/log/urpmi.log>
+
+The urpmi log file.
+
+=back
+
+=head1 SEE ALSO
+
+urpmi.cfg(5), proxy.cfg(5).
diff --git a/pod/urpmi.removemedia.8.pod b/pod/urpmi.removemedia.8.pod
new file mode 100644
index 00000000..a0de5a6b
--- /dev/null
+++ b/pod/urpmi.removemedia.8.pod
@@ -0,0 +1,36 @@
+=head1 NAME
+
+urpmi.removemedia - remove a rpm media from the known media of urpmi
+
+=head1 SYNOPSIS
+
+    urpmi.removemedia [options] names
+
+=head1 DESCRIPTION
+
+urpmi.removemedia removes from all configuration files all references to
+the named media and to rpms from that media. <I<names>> is a list of names
+you first told to urpmi.addmedia.
+
+=head1 OPTIONS
+
+=over
+
+=item B<-a>
+
+Select and remove all media. 
+
+=item B<-c>
+
+Clean header cache directory (F</var/cache/urpmi/headers>).
+
+=back
+
+=head1 SEE ALSO
+
+urpmi(8), urpmi.addmedia(8), urpmi.update(8).
+
+=head1 AUTHOR
+
+Pascal Rigaux (original author), FranE<ccedil>ois Pons,
+Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer) 
diff --git a/pod/urpmi.update.8.pod b/pod/urpmi.update.8.pod
new file mode 100644
index 00000000..b3545fce
--- /dev/null
+++ b/pod/urpmi.update.8.pod
@@ -0,0 +1,95 @@
+=head1 NAME
+
+urpmi.update - Updates package lists for specified media
+
+=head1 SYNOPSIS
+
+    urpmi.update [options] [<names>]
+
+=head1 DESCRIPTION
+
+urpmi.update scans the specified urpmi media to update their package list.
+<I<names>> is a list of names you first told to urpmi.addmedia. 
+
+=head1 OPTIONS
+
+=over
+
+=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<--limit-rate I<rate>>
+
+Try to limit the download speed, I<rate> is given in bytes/sec. This
+option is not active by default.
+
+=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 urpmi.update to prompt for a
+username and a password. 
+
+=item B<--update>
+
+Use only update media. 
+
+=item B<--no-md5sum>
+
+Disable MD5SUM file checking. 
+
+=item B<--force-key>
+
+Force update of GPG key. 
+
+=item B<--norebuild>
+
+Don't try to rebuild the hdlist files from the RPMs if the original hdlist
+wasn't readable or was corrupted. 
+
+=item B<--ignore>, B<--no-ignore>
+
+Don't update media, but mark them
+as ignored (disables them). B<--no-ignore> has the reverse behaviour: it marks
+the media as enabled. 
+
+=item B<-a>
+
+Select all media that are not using a removable device to update them. 
+
+=item B<-c>
+
+Clean /var/cache/urpmi/headers directory on exit. 
+
+=item B<-f>
+
+Force rebuild of base files, or of hdlist files when specified twice. 
+
+=item B<-q>
+
+Quiet mode.
+
+=item B<-v>
+
+Verbose mode.
+
+=back
+
+=head1 SEE ALSO
+
+urpmi(8), urpmi.addmedia(8), urpmi.removemedia(8).
+
+=head1 AUTHOR
+
+Pascal Rigaux (original author), FranE<ccedil>ois Pons,
+Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer) 
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)