Factorise all repeated FILES sections in manpages in a new manpage,

urpmi.files(5). Fix several other things. Rewrite most of urpmi.addmedia(8)
and document --distrib better.

9 files changed, 98 insertions, 324 deletions

diff --git a/man/C/proxy.cfg.5 b/man/C/proxy.cfg.5
index daee4ff0..a35cbc50 100644
--- a/man/C/proxy.cfg.5
+++ b/man/C/proxy.cfg.5
@@ -28,4 +28,4 @@ Francois Pons, Mandrakesoft <fpons@mandrakesoft.com>
 Rafael Garcia-Suarez, Mandrakesoft <rgarciasuarez@mandrakesoft.com>
 (current maintainer)
 .SH SEE ALSO
-\fIurpmi\fP(8), \fIurpmi.cfg\fP(5).
+\fIurpmi\fP(8), \fIurpmi.cfg\fP(5), \fIurpmi.files\fP(5).
diff --git a/man/C/urpme.8 b/man/C/urpme.8
index a61709a0..e43b2747 100644
--- a/man/C/urpme.8
+++ b/man/C/urpme.8
@@ -30,49 +30,7 @@ Proposes a verbose mode with various messages.
 .IP "\fB\-a\fP"
 If multiple packages match the given substring, deinstall them all.
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/sbin/urpmi
-The \fBurpmi\fP executable (perl script)
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location. This file
-is only 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.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH EXIT CODES
 .IP 1
 Command line inconsistency.
@@ -92,3 +50,4 @@ Rafael Garcia-Suarez, Mandrakesoft <rgarciasuarez@mandrakesoft.com>
 \fIurpmf\fP(8),
 \fIurpmi\fP(8),
 \fIurpmq\fP(8),
+\fIurpmi.files\fP(5).
diff --git a/man/C/urpmf.8 b/man/C/urpmf.8
index 0ab5840e..84a66d3b 100644
--- a/man/C/urpmf.8
+++ b/man/C/urpmf.8
@@ -91,55 +91,14 @@ Left parenthesis to open group expression.
 .IP "\fB)\fP"
 Right parenthesis to close group expression.
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/bin/urpmf
-The \fBurpmf\fP executable (perl script).
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location. This file
-is only 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.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH "SEE ALSO"
 \fIurpmi.addmedia\fP(8),
 \fIurpmi.update\fP(8),
 \fIurpmi.removemedia\fP(8),
 \fIurpmi\fP(8),
 \fIurpmq\fP(8),
+\fIurpmi.files\fP(5).
 .SH AUTHOR
 Pascal Rigaux, Mandrakesoft <pixel@mandrakesoft.com> (original author)
 .PP
diff --git a/man/C/urpmi.8 b/man/C/urpmi.8
index a986cf8a..d41d5089 100644
--- a/man/C/urpmi.8
+++ b/man/C/urpmi.8
@@ -163,49 +163,7 @@ You can use a public key or enter your password.
 Fetch all the updates from media containing foo- in their name.
 
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/sbin/urpmi
-The \fBurpmi\fP executable (perl script)
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location. This file
-is only 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.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH EXIT CODES
 .IP 1
 Command line inconsistency.
@@ -279,4 +237,5 @@ Florent Villard.
 \fIurpmi.removemedia\fP(8),
 \fIurpmf\fP(8),
 \fIurpmq\fP(8),
-\fIurpmi.cfg\fP(5)
+\fIurpmi.cfg\fP(5),
+\fIurpmi.files\fP(5).
diff --git a/man/C/urpmi.addmedia.8 b/man/C/urpmi.addmedia.8
index d363574e..406bdaa8 100644
--- a/man/C/urpmi.addmedia.8
+++ b/man/C/urpmi.addmedia.8
@@ -66,10 +66,10 @@ removable device is mounted.
 .SH OPTIONS
 .IP "\fB\--wget\fP"
 Use wget only for downloading distant files. By default curl is used if
-available or wget instead.
+available, or wget instead.
 .IP "\fB\--curl\fP"
 Use curl only for downloading distant files. By default curl is used if
-available or wget instead.
+available, or wget instead.
 .IP "\fB\--limit-rate \fIrate\fP"
 Try to limit the download speed, \fIrate\fP is given in bytes/sec. This option is
 not active by default.
@@ -78,8 +78,8 @@ Use specified HTTP proxy.
 .IP "\fB\--proxy-user\fP \fIuser:password\fP"
 Use specified user and password to use for proxy authentication.
 .IP "\fB\--update\fP"
-Add a medium which will be taken into account when updating only update media by
-\fBurpmi\fP.
+Add a medium which will be taken into account by \fBMandrakeupdate\fP or
+by \fBurpmi --update\fP when looking for updates.
 .IP "\fB\--probe-synthesis\fP"
 Try to find and use synthesis file if \fBwith ...\fP is not given.
 .IP "\fB\--probe-hdlist\fP"
@@ -87,23 +87,27 @@ Try to find and use hdlist file if \fBwith ...\fP is not given.
 .IP "\fB\--no-probe\fP"
 Do not try to find any synthesis or hdlist file.
 .IP "\fB\--distrib\fP"
-Add all media from an installation medium. <\fIname\fP> is used with
-medium name found to create newer medium name in urpmi database. The \fBwith
-[...]\fP is not used as hdlist found on installation medium are used
-automatically.
+Retrieve a set of media from a distribution. Typically, the URL provided to
+\fBurpmi.addmedia\fP will represent the parent directory of a directory
+\fBmedia\fP, which in turn will contain various subdirectories for each media
+of the distribution. <\fIname\fP> is combined with medium names found to create
+newer medium names in the urpmi database. The \fBwith ...\fP option, if
+provided, is ignored, as hdlists found on the installation medium are used
+instead automatically.
 .IP "\fB\--distrib-XXX\fP"
-Automatically create a medium for XXX part of a distribution, XXX may be main,
-contrib, updates or anything else that has been configured.
+Automatically create a medium for part "XXX" of a distribution. "XXX" may be
+typically "main", "contrib", "main_updates" or anything else that has been
+configured in that distribution.
 .IP "\fB\--from\fP \fIurl\fP"
-Use specified \fIurl\fP for list of mirrors, the default from Mandrakesoft is
-\fIhttp://www.linux-mandrake.com/mirrorsfull.list\fP unless \fBurpmi.setup\fP is
-installed which make \fBurpmi.addmedia\fP look at its mirror configuration file.
+Use specified URL for list of mirrors. The default from Mandrakesoft is
+\fIhttp://www.linux-mandrake.com/mirrorsfull.list\fP.
 .IP "\fB\--version\fP \fIversion\fP"
-Use specified version when using \fB--distrib-XXX\fP, the default is version of
-\fBmandrakelinux-release\fP package installed.
+Use specified version when using \fB--distrib-XXX\fP, the default is to use the
+version of the package \fBmandrakelinux-release\fP currently installed.
 .IP "\fB\--arch\fP \fIarch\fP"
-Use specified architecture when using \fB--distrib-XXX\fP, the default is
-architecture of \fBmandrakelinux-release\fP package installed.
+Use specified architecture when using \fB--distrib-XXX\fP, the default is to
+use the architecture of the package \fBmandrakelinux-release\fP currently
+installed.
 .IP "\fB\--virtual\fP"
 Create a virtual medium, this only works for file:// and removable:// protocol
 and no files will be created in /var/lib/urpmi. The medium is always up-to-date
@@ -115,55 +119,14 @@ Try to find and use synthesis or hdlist file.
 .IP "\fB\-f\fP"
 Force generation of hdlist files.
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/sbin/urpmi.addmedia
-The \fBurpmi.addmedia\fP executable (perl script)
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location only
-if a password is used to access distant location (using network protocol) or
-various directory are used to store packages.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH "SEE ALSO"
 \fIurpmi\fP(8),
 \fIurpmi.update\fP(8),
 \fIurpmi.removemedia\fP(8),
 \fIurpmf\fP(8),
 \fIurpmq\fP(8),
+\fIurpmi.files\fP(5).
 .SH AUTHOR
 Pascal Rigaux, Mandrakesoft <pixel@mandrakesoft.com> (original author)
 .PP
diff --git a/man/C/urpmi.files.5 b/man/C/urpmi.files.5
new file mode 100644
index 00000000..c37e60eb
--- /dev/null
+++ b/man/C/urpmi.files.5
@@ -0,0 +1,59 @@
+.TH urpmi.files 5 "07 Oct 2004" "Mandrakesoft" "Mandrakelinux"
+.IX urpmi.files
+.SH NAME
+urpmi.files \- files used by the urpmi tools
+.SH 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.
+.SH FILES
+.de FN
+\fI\|\\$1\|\fP
+..
+.TP
+.FN /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.
+.TP
+.FN /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, \fBurpmf\fP can operate completely
+without accessing this medium (this is almost always the case).
+.TP
+.FN /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).
+.TP
+.FN /etc/urpmi/urpmi.cfg
+Contains media descriptions. See \fIurpmi.cfg\fP(5).
+.TP
+.FN /etc/urpmi/proxy.cfg
+Contains proxy descriptions for http and ftp media. See \fIproxy.cfg\fP(5).
+.TP
+.FN /etc/urpmi/parallel.cfg
+Contains parallel alias description. Format is
+\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
+a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
+\fB<media>\fP is a media list (as \fB--media\fP parameter),
+\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
+-m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
+extension.
+.TP
+.FN /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 \fB/\fP) to match the
+name of packages against.
+.TP
+.FN /etc/urpmi/inst.list
+The list of packages that should be installed instead of updated. It has
+the same format as the skip.list.
+.TP
+.FN /var/log/urpmi.log
+The urpmi log file.
+.SH SEE ALSO
+\fIurpmi.cfg\fP(5), \fIproxy.cfg\fP(5).
diff --git a/man/C/urpmi.removemedia.8 b/man/C/urpmi.removemedia.8
index a01f877c..17c38bf4 100644
--- a/man/C/urpmi.removemedia.8
+++ b/man/C/urpmi.removemedia.8
@@ -1,7 +1,7 @@
 .TH urpmi.removemedia 8 "07 Jan 2003" "Mandrakesoft" "Mandrakelinux"
 .IX urpmi.removemedia
 .SH NAME
-urpmi.removemedia \- remove a rpm media from the known medias of urpmi
+urpmi.removemedia \- remove a rpm media from the known media of urpmi
 .SH SYNOPSIS
 .B urpmi.removemedia [options] <\fInames\fP>
 .SH DESCRIPTION
@@ -12,53 +12,11 @@ the named media and to rpms from that media.
 
 .SH OPTIONS
 .IP "\fB\-a\fP"
-Selects and removes all medias.
+Select and remove all media.
 .IP "\fB\-c\fP"
 Clean header cache directory (/var/cache/urpmi/headers).
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/sbin/urpmi.removemedia
-The \fBurpmi.removemedia\fP executable (perl script)
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location only
-if a password is used to access distant location (using network protocol) or
-various directory are used to store packages.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH "SEE ALSO"
 \fIurpmi\fP(8),
 \fIurpmi.addmedia\fP(8),
diff --git a/man/C/urpmi.update.8 b/man/C/urpmi.update.8
index 79ad65de..b5522778 100644
--- a/man/C/urpmi.update.8
+++ b/man/C/urpmi.update.8
@@ -5,8 +5,7 @@ urpmi.update \- Updates package lists for specified media
 .SH SYNOPSIS
 .B urpmi.update [options] [<\fInames\fP>]
 .SH DESCRIPTION
-urpmi.update scans all the <\fInames\fP> media to update their package list.
-Useful for ftp location for example.
+urpmi.update scans the specified urpmi media to update their package list.
 .PP
 <\fInames\fP> is a list of names you first told to urpmi.addmedia.
 
@@ -41,55 +40,14 @@ Quiet mode.
 .IP "\fB\-v\fP"
 Verbose mode.
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/sbin/urpmi.update
-The \fBurpmi.update\fP executable (perl script)
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location only
-if a password is used to access distant location (using network protocol) or
-various directory are used to store packages.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH "SEE ALSO"
 \fIurpmi\fP(8),
 \fIurpmi.addmedia\fP(8),
 \fIurpmi.removemedia\fP(8),
 \fIurpmf\fP(8),
 \fIurpmq\fP(8),
+\fIurpmi.files\fP(5).
 .SH AUTHOR
 Pascal Rigaux, Mandrakesoft <pixel@mandrakesoft.com> (original author)
 .PP
diff --git a/man/C/urpmq.8 b/man/C/urpmq.8
index 87c62b7d..a4e563e0 100644
--- a/man/C/urpmq.8
+++ b/man/C/urpmq.8
@@ -119,55 +119,14 @@ Print version and release of each package listed.
 .IP "\fB\-f\fP"
 Print version, release and arch of each package listed.
 .SH FILES
-.de FN
-\fI\|\\$1\|\fP
-..
-.TP
-.FN /usr/bin/urpmq
-The \fBurpmq\fP executable (perl script)
-.TP
-.FN /var/lib/urpmi/list.*
-Contains the list of all packages known by urpmi and their location only
-if a password is used to access distant location (using network protocol) or
-various directory are used to store packages.
-.TP
-.FN /var/lib/urpmi/hdlist.*
-Contains information about all known packages; it's a summary of rpm headers.
-If an hdlist file is used for a medium, \fBurpmf\fP can operate completely
-without accessing this medium (this is almost always the case).
-.TP
-.FN /var/lib/urpmi/synthesis.hdlist.*
-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 but this is much slower.
-.TP
-.FN /etc/urpmi/urpmi.cfg
-Contains media description, previous format from older urpmi is still accepted.
-.TP
-.FN /etc/urpmi/parallel.cfg
-Contains parallel alias description, format is
-\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
-a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
-\fB<media>\fP is a media list (as \fB--media\fP parameter),
-\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
--m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
-extension.
-.TP
-.FN /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 \fB/\fP) to match the
-name of packages against.
-.TP
-.FN /etc/urpmi/inst.list
-The list of packages that should be installed instead of updated. It has
-the same format as the skip.list.
+See \fIurpmi.files\fP(5).
 .SH SEE ALSO
 \fIurpmi.addmedia\fP(8),
 \fIurpmi.update\fP(8),
 \fIurpmi.removemedia\fP(8),
 \fIurpmf\fP(8),
 \fIurpmi\fP(8),
+\fIurpmi.files\fP(5).
 .SH AUTHOR
 Pascal Rigaux, Mandrakesoft <pixel@mandrakesoft.com> (original author)
 .PP