2
<title>Introduction</title>
3
<para> Welcome to the <application>APTonCD</application> Manual!</para>
5
<para>&aoc; is a simple yet powerful GUI-based tool which allows you to create CD/DVD repositories containing all of the packages that have been previously downloaded via apt-get, aptitude, synaptic and even those that were downloaded manually.</para>
10
<listitem><para>Create a CD/DVD with all downloaded packages</para></listitem>
11
<listitem><para>Backup/restore all packages installed with APT</para></listitem>
12
<listitem><para>Install the same packages on other machines without downloading them again</para></listitem>
13
<listitem><para>Use the same &aoc; CD/DVD to upgrade many computers</para></listitem>
14
<listitem><para>And more to come...</para></listitem>
16
See <link linkend="about-examples">examples</link> on how &aoc; can typically be used.
19
<para>In the "Create APTonCD" feature you can make a CD/DVD with all packages previously downloaded with apt-get, aptitude or synaptic. It uses apt-cache (/var/cache/apt/archives) to scan for packages and makes a repository on one or more CD/DVDs or .iso files. It also allows for complete on-line repositories to be downloaded and create local repositories that can be used on any PC.</para>
20
<para>The "Restore APTonCD" functions allow the repository to be used without downloading any of the files again.</para>
23
<sec2><title>Installation and Usage</title>
24
<para>&aoc; is available in the Ubuntu Universe repository. It can be installed on a Ubuntu PC with internet access from <strong>Applications>Add/Remove</strong> OR from <strong>System>Administration->Synaptic Package Manager'</strong> OR from the command line - open a terminal and type:
25
<programlisting>sudo aptitude install aptoncd</programlisting>
26
***How to use on a PC without internet access?***</para>
31
<title>Running &aoc;</title>
32
<para>The &aoc; installation will create a menu shortcut in <menuchoice><guimenu>System</guimenu><guimenuitem>Administration</guimenuitem></menuchoice>. &aoc; will be the first item or will be near the top of the list. Depending on your Ubuntu version. &aoc; may be found on Gnome Control Panel too, at System section.</para>
36
<title>Command line options</title>
37
<para>&aoc; supports pseudo-command line operation. It can be launched from the command line and can be passed command line parameters, but it always runs with a GUI.
40
<para>The following commands are supported:</para>
43
<para> -c, --create starts aptoncd on create media-repository mode </para>
46
<para> -r, --restore starts aptoncd on restore media mode </para>
49
<para> -i, --restore-iso starts aptoncd on restore .iso image mode</para>
52
<para>-l, --create-from input an file list to create an aptoncd media mode</para>
55
<para> --help display this help and exit </para>
58
<para> --version output version information and exit" </para>
63
<sec2><title>Compatibility</title>
64
<para>&aoc; aims to be compatible with debian-based distributions. The focus is Ubuntu, and this version fully support on Dapper, Edgy and Feisty. But also should works fine on Debian Etch and Lenny.</para>