X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/0205540433440a9ff4ad4ea4cce44c700a4b401c..b3c63712e4e54e3743c302416528423def4eefbb:/doc/apt-cdrom.8.xml?ds=sidebyside diff --git a/doc/apt-cdrom.8.xml b/doc/apt-cdrom.8.xml index 423569fc1..8f883c1a3 100644 --- a/doc/apt-cdrom.8.xml +++ b/doc/apt-cdrom.8.xml @@ -1,10 +1,9 @@ <?xml version="1.0" encoding="utf-8" standalone="no"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" - "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ - -<!ENTITY % aptent SYSTEM "apt.ent"> -%aptent; - +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % aptent SYSTEM "apt.ent"> %aptent; +<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> %aptverbatiment; +<!ENTITY % aptvendor SYSTEM "apt-vendor.ent"> %aptvendor; ]> <refentry> @@ -14,7 +13,7 @@ &apt-author.team; &apt-email; &apt-product; - <date>14 February 2004</date> + <date>2013-11-30T00:00:00Z</date> </refentryinfo> <refmeta> @@ -26,26 +25,13 @@ <!-- Man page title --> <refnamediv> <refname>apt-cdrom</refname> - <refpurpose>APT CDROM management utility</refpurpose> + <refpurpose>APT CD-ROM management utility</refpurpose> </refnamediv> - <!-- Arguments --> - <refsynopsisdiv> - <cmdsynopsis> - <command>apt-cdrom</command> - <arg><option>-hvrmfan</option></arg> - <arg><option>-d=<replaceable>cdrom mount point</replaceable></option></arg> - <arg><option>-o=<replaceable>config string</replaceable></option></arg> - <arg><option>-c=<replaceable>file</replaceable></option></arg> - <group> - <arg>add</arg> - <arg>ident</arg> - </group> - </cmdsynopsis> - </refsynopsisdiv> + &synopsis-command-apt-cdrom; <refsect1><title>Description</title> - <para><command>apt-cdrom</command> is used to add a new CDROM to APTs list + <para><command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of available sources. <command>apt-cdrom</command> takes care of determining the structure of the disc as well as correcting for several possible mis-burns and @@ -53,47 +39,54 @@ </para> <para>It is necessary to use <command>apt-cdrom</command> to add CDs to the - APT system, - it cannot be done by hand. Furthermore each disk in a multi-cd set must be + APT system; + it cannot be done by hand. Furthermore each disc in a multi-CD set must be inserted and scanned separately to account for possible mis-burns. </para> <para>Unless the <option>-h</option>, or <option>--help</option> option is - given one of the commands below must be present. - + given, one of the commands below must be present.</para> + <variablelist> - <varlistentry><term>add</term> + <varlistentry><term><option>add</option></term> <listitem><para><literal>add</literal> is used to add a new disc to the source list. It will unmount the - CDROM device, prompt for a disk to be inserted and then proceed to + CD-ROM device, prompt for a disc to be inserted and then proceed to scan it and copy the index files. If the disc does not have a proper - <filename>disk</filename> directory you will be prompted for a descriptive + <filename>.disk</filename> directory you will be prompted for a descriptive title. </para> - <para>APT uses a CDROM ID to track which disc is currently in the drive and + <para>APT uses a CD-ROM ID to track which disc is currently in the drive and maintains a database of these IDs in <filename>&statedir;/cdroms.list</filename> </para> </listitem> </varlistentry> - <varlistentry><term>ident</term> + <varlistentry><term><option>ident</option></term> <listitem><para>A debugging tool to report the identity of the current disc as well as the stored file name </para> </listitem> </varlistentry> </variablelist> - </para> </refsect1> <refsect1><title>Options</title> &apt-cmdblurb; <variablelist> + <varlistentry><term><option>--no-auto-detect</option></term><term><option>--cdrom</option></term> + <listitem><para>Do not try to auto-detect the CD-ROM path. Usually combined with the <option>--cdrom</option> option. + Configuration Item: <literal>Acquire::cdrom::AutoDetect</literal>. + </para> + </listitem> + </varlistentry> + + <varlistentry><term><option>-d</option></term><term><option>--cdrom</option></term> - <listitem><para>Mount point; specify the location to mount the cdrom. This + <listitem><para>Mount point; specify the location to mount the CD-ROM. This mount point must be listed in <filename>/etc/fstab</filename> and properly configured. Configuration Item: <literal>Acquire::cdrom::mount</literal>. @@ -102,8 +95,8 @@ </varlistentry> <varlistentry><term><option>-r</option></term><term><option>--rename</option></term> - <listitem><para>Rename a disc; change the label of a disk or override the - disks given label. This option will cause <command>apt-cdrom</command> to + <listitem><para>Rename a disc; change the label of a disc or override the + disc's given label. This option will cause <command>apt-cdrom</command> to prompt for a new label. Configuration Item: <literal>APT::CDROM::Rename</literal>. </para>