<section id="features"><title>Features</title><para>&aoc; features can be divided into two main categories. Basically, the <emphasis>Create</emphasis> category is used to create a CD/DVD repository with packages previously downloaded with apt-get tools while the <emphasis>Restore</emphasis> category has functions related to restoring packages using the previously created &aoc; media (as a local repository).</para><itemizedlist>	<listitem><para>Create</para>		<itemizedlist>		<listitem><para><link linkend="create">Create &aoc;</link></para></listitem>		<listitem><para><link linkend="download">Download repositories</link></para></listitem>		</itemizedlist>	</listitem>		<listitem><para>Restore</para>		<itemizedlist>		<listitem><para><link linkend="restore-aoc">Restore from APTonCD</link></para></listitem>		<listitem><para><link linkend="restore-iso">Restore .iso image</link></para></listitem>		<listitem><para><link linkend="restore-repo">Add CD/DVD</link></para></listitem>		</itemizedlist>	</listitem></itemizedlist><!-- -->	<section id="create">		<title>Create &aoc;</title>				<sec2>			<title>Action</title>			<para>Create a removable repository with all packages downloaded with Synaptic, apt-get or aptitude.</para>		</sec2>				<sec2>		<title>Features</title>		<para>						<varlistentry>				<term><guimenuitem>Select packages</guimenuitem></term>				<listitem><para>By default, all packages saved in the /var/cache/apt/archives/ directory are listed and the latest versions are checked. 				You can choose which packages won't be saved on the &aoc; media by just un-checking them from this list. 				When you remove a package the total file size is automatically updated.</para>								<para> When in the package list screen, a right mouse click will bring up options for quick manipulation of the selections.				All of the packages may be selected or deselected and the current selection list can be inverted.				'Remove package' tidies up the list by no longer displaying that package.				Control-click and shift click are not supported. </para>				<para>To find a package, to save having to scroll through a long list of packages, a search box is provided.  This will				pop-up when you start typing in the package list window and will show the first partial match.  To find				the next matching occurence press the down arrow.</para>				<para> </para>				</listitem>			</varlistentry>						<varlistentry>				<term><guimenuitem>Add packages</guimenuitem></term>				<listitem><para>It's possible to add other deb packages inside the &aoc; media, even those that weren't installed using 				the apt-get tools. There are two ways to do this: </para>				<para>You can use the <guibutton>Add Package...</guibutton> button,  				then find and open the deb package you want to add.  Within the 'Add package' window, you can use Ctrl-click and Shift-click				to select multiple packages.</para>				<para>The other way to add packages is to simply drag-and-drop the package from <application>Nautilus</application> to the &aoc; window.  		      It's possible to add multiple packages at same time using either method.				</para>				<para> </para>				</listitem>			</varlistentry>					<varlistentry>				<term><guimenuitem>Destination folder</guimenuitem></term>				<listitem><para>The image generated by &aoc; is saved in the /home/USER directory by default. You can change 				this using the 'destination folder' option to select another place to save the files. APTonCD doesn't allow you to select a directory where you have not permission to write.</para>				<para> </para>				</listitem>			</varlistentry>					<varlistentry>				<term><guimenuitem>Burn image</guimenuitem></term>				<listitem><para>When an &aoc; image is successfully created, an option is displayed to burn this image onto the previously 				selected media. If you prefer, you can burn it later using your favorite program.</para></listitem>			</varlistentry>						</para>		</sec2>					<sec2>		<title>Options</title>		<para>									<varlistentry>				<term><guimenuitem>Media Type</guimenuitem></term>				<listitem><para>You can choose what type of media is created. The options are CD (690 MB) and DVD (4500MB). 				If the total size of the packages is bigger than the media capacity, 				&aoc; will automatically split it up into the necessary number of files (you can see this number above 				the package box, along with the total number of files and total file size).</para>				<para>The required number of CDs (or DVDs) is shown below the package list screen. This switches between CD 				or DVD count based on the option selected.				</para>					   	<!-- Insert file  screenshot-create_APTonCD.png  here 		   		<mediaobject>					<imageobject>					<imagedata fileref="images/screenshot-create_APTonCD.png" format="PNG"/>					</imageobject>					<textobject>Creating package screen</textobject>					</mediaobject> -->					<para> </para>					</listitem>			</varlistentry>			 			<varlistentry>				<term><guimenuitem>Filename</guimenuitem></term>				<listitem><para>If the filename is left blank, by default &aoc; images are named using the the follow format: 'aptoncd-yyyymmdd-MMX.iso' where (yyyy)				is the year, (mm) the month and (dd) the day. (MM) denotes the chosen media, which can be 'CD' or 'DVD' and X stands for				the number of the image if more than one media is created. For example: aptoncd-20061030-CD1.				You can choose a different filename for the image(s) using the file box - this replaces the 				'aptoncd' part of the name.</para>				<para></para>				<para> </para>				</listitem>			</varlistentry>					<varlistentry>				<term><guimenuitem>Metapackage</guimenuitem></term>				<listitem><para>The Metapackage option creates a package named 'aptoncd-metapackage' that includes all of the other packages on 				the APTonCD media as dependencies. It's useful for easily restoring all packages along with their dependencies, 				so you can just install the metapackage instead of installing				each package by hand. The default is to have this selected.</para>			<para> </para>			</listitem>			</varlistentry>						<varlistentry id="autodependencies">				<term><guimenuitem>Auto-select dependencies</guimenuitem></term>				<listitem><para>This option guarantees that all dependencies of a package are selected. 				The default is selected.</para>				<para> </para>				</listitem>			</varlistentry>						<varlistentry id="oldversions">				<term><guimenuitem>Insert old versions of the same same package</guimenuitem></term>				<listitem><para>This option enables &aoc; to include several versions of same package on the media. 				If it is selected together with the 'Metapackage' option, just the newer version of each 				package is included in the metapackage.</para>				<para> </para>				</listitem>			</varlistentry>		</para>		</sec2>			<para>(<link linkend="features">back to top</link>)</para>	</section>		<!-- -->		<!-- -->	<section id="download">		<title>Download repositories (Unstable!)</title>		<emphasis>The Download Repository module is a little unstable in this release. It was disabled in the APTonCD GUI and only can be called by command line (--download). Use with your own risk.</emphasis>		<sec2>			<title>Action</title>			<para>This downloads complete Ubuntu repositories from the internet,			 creating locally stored versions on CD, DVD or iso image files.</para>			<para>Given the size of some of the repositories this may take 			a long time, even with a fast internet connection.  It is not recommended from a dial-up modem connection.</para>			<para>Any of the standard Ubuntu repositories may be downloaded - Main, Restricted, Universe or Multiverse. 			At the moment, &aoc; does not support downloading unofficial repositories</para>		</sec2>				<sec2 id="download-features">		<title>Features</title>		<para>							<varlistentry>				<term><guimenuitem>Autodetection</guimenuitem></term>				<listitem><para> &aoc; detects automatically the distribution and version of your operational system				and also the architecture of your computer. This information will be used as option defaults, 				but you can easily change them if you want to.</para><para> </para></listitem>			</varlistentry>							<varlistentry>				<term><guimenuitem>Download resume</guimenuitem></term>				<listitem><para> If the repository download is interrupted for whatever reason, 				if you run it again, the download will resume from where it left off.  				Packages that were successfully downloaded before the interruption won't be downloaded again.</para><para> </para></listitem>			</varlistentry>						<varlistentry>				<term><guimenuitem>Download progress</guimenuitem></term>				<listitem><para> During the download a progress window is displayed 				showing the total file size of the download, the number of files downloaded (including the file currently being				downloaded, total number of files in the download and the estimated time remaining.  The progress of individual 				files can also be shown.</para></listitem>			</varlistentry>								</para>		</sec2>					<sec2>		<title>Options</title>		<para>									<varlistentry>				<term><guimenuitem>Distribution</guimenuitem></term>				<listitem><para> &aoc; can download Ubuntu or Debian repositories 				(the default option is the system you're using).</para>				<para> </para>				</listitem>			</varlistentry>					<varlistentry>				<term><guimenuitem>Version</guimenuitem></term>				<listitem><para>You can select the Ubuntu (or Debian) version you want to download. 				All Ubuntu versions that are officially supported are listed.</para>				<para> </para>				</listitem>			</varlistentry>						<varlistentry>				<term><guimenuitem>Architecture</guimenuitem></term>				<listitem><para> &aoc; allows you to download repositories available for 				several architectures: i386, amd64, powerpc and sparc. 				You don't need to change any of the selections, unless you know exactly what you're doing :-).</para> 				<para> </para>				</listitem>			</varlistentry>						<varlistentry>				<term><guimenuitem>Sections</guimenuitem></term>