~jr/ubuntu/oneiric/apt/bzr-get-rename

« back to all changes in this revision

Viewing changes to doc/apt.ent

  • Committer: Bazaar Package Importer
  • Author(s): Matt Zimmerman
  • Date: 2005-03-07 20:08:33 UTC
  • Revision ID: james.westby@ubuntu.com-20050307200833-0lxdgg2cb4oculdv
Tags: 0.6.35
* Merge apt--mvo--0 (incorporates 0.6.34ubuntu1):
  - Implement MaxSize and MaxAge in apt.cron.daily, to prevent the cache
    from growing too large (Ubuntu #6761)
  - some comments about the pkgAcqMetaSig::Custom600Headers() added
  - use gpg --with-colons
  - commented the ftp no_proxy unseting in methods/ftp.cc
  - added support for "Acquire::gpgv::options" in methods/gpgv.cc
* Merge bubulle@debian.org--2005/apt--main--0
  - Make capitalization more consistent
  - Un-fuzzy translations resulting from capitalization changes
  - Italian translation update

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
 
3
3
<!-- Some common paths.. -->
4
4
<!ENTITY docdir "/usr/share/doc/apt/">
5
 
<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</>">
6
 
<!ENTITY aptconfdir "<filename>/etc/apt.conf</>">
 
5
<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>">
 
6
<!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>">
7
7
<!ENTITY statedir "/var/lib/apt">
8
8
<!ENTITY cachedir "/var/cache/apt">
9
9
 
10
10
<!-- Cross references to other man pages -->
11
 
<!ENTITY apt-conf "<CiteRefEntry>
12
 
    <RefEntryTitle><filename/apt.conf/</RefEntryTitle>
13
 
    <ManVolNum/5/
14
 
  </CiteRefEntry>">
15
 
 
16
 
<!ENTITY apt-get "<CiteRefEntry>
17
 
    <RefEntryTitle><command/apt-get/</RefEntryTitle>
18
 
    <ManVolNum/8/
19
 
  </CiteRefEntry>">
20
 
 
21
 
<!ENTITY apt-config "<CiteRefEntry>
22
 
    <RefEntryTitle><command/apt-config/</RefEntryTitle>
23
 
    <ManVolNum/8/
24
 
  </CiteRefEntry>">
25
 
 
26
 
<!ENTITY apt-cdrom "<CiteRefEntry>
27
 
    <RefEntryTitle><command/apt-cdrom/</RefEntryTitle>
28
 
    <ManVolNum/8/
29
 
  </CiteRefEntry>">
30
 
 
31
 
<!ENTITY apt-cache "<CiteRefEntry>
32
 
    <RefEntryTitle><command/apt-cache/</RefEntryTitle>
33
 
    <ManVolNum/8/
34
 
  </CiteRefEntry>">
35
 
 
36
 
<!ENTITY apt-preferences "<CiteRefEntry>
37
 
    <RefEntryTitle><command/apt_preferences/</RefEntryTitle>
38
 
    <ManVolNum/5/
39
 
  </CiteRefEntry>">
40
 
 
41
 
<!ENTITY sources-list "<CiteRefEntry>
42
 
    <RefEntryTitle><filename/sources.list/</RefEntryTitle>
43
 
    <ManVolNum/5/
44
 
  </CiteRefEntry>">
45
 
 
46
 
<!ENTITY bug "<CiteRefEntry>
47
 
    <RefEntryTitle><command/bug/</RefEntryTitle>
48
 
    <ManVolNum/1/
49
 
  </CiteRefEntry>">
50
 
 
51
 
<!ENTITY dpkg "<CiteRefEntry>
52
 
    <RefEntryTitle><command/dpkg/</RefEntryTitle>
53
 
    <ManVolNum/8/
54
 
  </CiteRefEntry>">
55
 
 
56
 
<!ENTITY dpkg-buildpackage "<CiteRefEntry>
57
 
    <RefEntryTitle><command/dpkg-buildpackage/</RefEntryTitle>
58
 
    <ManVolNum/1/
59
 
  </CiteRefEntry>">
60
 
 
61
 
<!ENTITY gzip "<CiteRefEntry>
62
 
    <RefEntryTitle><command/gzip/</RefEntryTitle>
63
 
    <ManVolNum/1/
64
 
  </CiteRefEntry>">
65
 
 
66
 
<!ENTITY dpkg-scanpackages "<CiteRefEntry>
67
 
    <RefEntryTitle><command/dpkg-scanpackages/</RefEntryTitle>
68
 
    <ManVolNum/8/
69
 
  </CiteRefEntry>">
70
 
 
71
 
<!ENTITY dpkg-scansources "<CiteRefEntry>
72
 
    <RefEntryTitle><command/dpkg-scansources/</RefEntryTitle>
73
 
    <ManVolNum/8/
74
 
  </CiteRefEntry>">
75
 
 
76
 
<!ENTITY dselect "<CiteRefEntry>
77
 
    <RefEntryTitle><command/dselect/</RefEntryTitle>
78
 
    <ManVolNum/8/
79
 
  </CiteRefEntry>">
 
11
<!ENTITY apt-conf "<citerefentry>
 
12
    <refentrytitle><filename>apt.conf</filename></refentrytitle>
 
13
    <manvolnum>5</manvolnum>
 
14
  </citerefentry>"
 
15
>
 
16
 
 
17
<!ENTITY apt-get "<citerefentry>
 
18
    <refentrytitle><command>apt-get</command></refentrytitle>
 
19
    <manvolnum>8</manvolnum>
 
20
  </citerefentry>"
 
21
>
 
22
 
 
23
<!ENTITY apt-config "<citerefentry>
 
24
    <refentrytitle><command>apt-config</command></refentrytitle>
 
25
    <manvolnum>8</manvolnum>
 
26
  </citerefentry>"
 
27
>
 
28
 
 
29
<!ENTITY apt-cdrom "<citerefentry>
 
30
    <refentrytitle><command>apt-cdrom</command></refentrytitle>
 
31
    <manvolnum>8</manvolnum>
 
32
  </citerefentry>"
 
33
>
 
34
 
 
35
<!ENTITY apt-cache "<citerefentry>
 
36
    <refentrytitle><command>apt-cache</command></refentrytitle>
 
37
    <manvolnum>8</manvolnum>
 
38
  </citerefentry>"
 
39
>
 
40
 
 
41
<!ENTITY apt-preferences "<citerefentry>
 
42
    <refentrytitle><command>apt_preferences</command></refentrytitle>
 
43
    <manvolnum>5</manvolnum>
 
44
  </citerefentry>"
 
45
>
 
46
 
 
47
<!ENTITY sources-list "<citerefentry>
 
48
    <refentrytitle><filename>sources.list</filename></refentrytitle>
 
49
    <manvolnum>5</manvolnum>
 
50
  </citerefentry>"
 
51
>
 
52
 
 
53
<!ENTITY reportbug "<citerefentry>
 
54
    <refentrytitle><command>reportbug</command></refentrytitle>
 
55
    <manvolnum>1</manvolnum>
 
56
  </citerefentry>"
 
57
>
 
58
 
 
59
<!ENTITY dpkg "<citerefentry>
 
60
    <refentrytitle><command>dpkg</command></refentrytitle>
 
61
    <manvolnum>8</manvolnum>
 
62
  </citerefentry>"
 
63
>
 
64
 
 
65
<!ENTITY dpkg-buildpackage "<citerefentry>
 
66
    <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
 
67
    <manvolnum>1</manvolnum>
 
68
  </citerefentry>"
 
69
>
 
70
 
 
71
<!ENTITY gzip "<citerefentry>
 
72
    <refentrytitle><command>gzip</command></refentrytitle>
 
73
    <manvolnum>1</manvolnum>
 
74
  </citerefentry>"
 
75
>
 
76
 
 
77
<!ENTITY dpkg-scanpackages "<citerefentry>
 
78
    <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
 
79
    <manvolnum>8</manvolnum>
 
80
  </citerefentry>"
 
81
>
 
82
 
 
83
<!ENTITY dpkg-scansources "<citerefentry>
 
84
    <refentrytitle><command>dpkg-scansources</command></refentrytitle>
 
85
    <manvolnum>8</manvolnum>
 
86
  </citerefentry>"
 
87
>
 
88
 
 
89
<!ENTITY dselect "<citerefentry>
 
90
    <refentrytitle><command>dselect</command></refentrytitle>
 
91
    <manvolnum>8</manvolnum>
 
92
  </citerefentry>"
 
93
>
80
94
    
81
95
<!-- Boiler plate docinfo section -->
82
96
<!ENTITY apt-docinfo "
83
 
 <docinfo>
84
 
   <address><email>apt@packages.debian.org</></address>
85
 
   <author><firstname>Jason</> <surname>Gunthorpe</></>
86
 
   <copyright><year>1998-2001</> <holder>Jason Gunthorpe</></>
87
 
   <date>12 March 2001</>
88
 
 </docinfo>
 
97
 <refentryinfo>
 
98
   <address><email>apt@packages.debian.org</email></address>
 
99
   <author><firstname>Jason</firstname> <surname>Gunthorpe</surname></author>
 
100
   <copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright>
 
101
   <date>14 December 2003</date>
 
102
   <productname>Linux</productname>
 
103
 
 
104
 </refentryinfo>
89
105
"> 
90
106
 
 
107
<!ENTITY apt-email "
 
108
   <address>
 
109
    <email>apt@packages.debian.org</email>
 
110
   </address>
 
111
">
 
112
 
 
113
<!ENTITY apt-author.jgunthorpe "
 
114
   <author>
 
115
    <firstname>Jason</firstname>
 
116
    <surname>Gunthorpe</surname>
 
117
   </author>
 
118
">
 
119
 
 
120
<!ENTITY apt-author.team "
 
121
   <author>
 
122
    <othername>APT team</othername>
 
123
   </author>
 
124
">
 
125
 
 
126
<!ENTITY apt-product "
 
127
   <productname>Linux</productname>
 
128
">
 
129
 
 
130
<!ENTITY apt-email "
 
131
   <address>
 
132
    <email>apt@packages.debian.org</email>
 
133
   </address>
 
134
">
 
135
 
 
136
<!ENTITY apt-author.jgunthorpe "
 
137
   <author>
 
138
    <firstname>Jason</firstname>
 
139
    <surname>Gunthorpe</surname>
 
140
   </author>
 
141
">
 
142
 
 
143
<!ENTITY apt-author.team "
 
144
   <author>
 
145
    <othername>APT team</othername>
 
146
   </author>
 
147
">
 
148
 
 
149
<!ENTITY apt-copyright "
 
150
    <copyright>
 
151
     <holder>Jason Gunthorpe</holder>
 
152
     <year>1998-2001</year>
 
153
    </copyright>
 
154
">
 
155
 
 
156
<!ENTITY apt-product "
 
157
   <productname>Linux</productname>
 
158
">
 
159
 
91
160
<!-- Boiler plate Bug reporting section -->
92
161
<!ENTITY manbugs "
93
 
 <RefSect1><Title>Bugs</>
94
 
   <para>
95
 
   See the <ulink url='http://bugs.debian.org/apt'>APT bug page</>.  
96
 
   If you wish to report a bug in APT, please see 
97
 
   <filename>/usr/share/doc/debian/bug-reporting.txt</> or the &bug; command.
98
 
 </RefSect1>
 
162
 <refsect1><title>Bugs</title>
 
163
   <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>. 
 
164
   If you wish to report a bug in APT, please see
 
165
   <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
 
166
   &reportbug; command.
 
167
   </para>
 
168
 </refsect1>
99
169
">
100
170
 
101
171
<!-- Boiler plate Author section -->
102
172
<!ENTITY manauthor "
103
 
 <RefSect1><Title>Author</>
104
 
   <para>
105
 
   APT was written by the APT team <email>apt@packages.debian.org</>.
106
 
 </RefSect1>
 
173
 <refsect1><title>Author</title>
 
174
   <para>APT was written by the APT team <email>apt@packages.debian.org</email>.
 
175
   </para>
 
176
 </refsect1>
107
177
">
108
178
 
109
179
<!-- Should be used within the option section of the text to
110
180
     put in the blurb about -h, -v, -c and -o -->
111
181
<!ENTITY apt-commonoptions "
112
 
     <VarListEntry><term><option/-h/</><term><option/--help/</>
113
 
     <ListItem><Para>
114
 
     Show a short usage summary.
115
 
     </VarListEntry>
 
182
     <varlistentry><term><option>-h</option></term>
 
183
     <term><option>--help</option></term>
 
184
     <listitem><para>Show a short usage summary.
 
185
     </para>
 
186
     </listitem>
 
187
     </varlistentry>
116
188
     
117
 
     <VarListEntry><term><option/-v/</><term><option/--version/</>
118
 
     <ListItem><Para>
119
 
     Show the program verison.
120
 
     </VarListEntry>
 
189
     <varlistentry>
 
190
      <term><option>-v</option></term>
 
191
      <term><option>--version</option></term>
 
192
      <listitem><para>Show the program version.
 
193
     </para>
 
194
     </listitem>
 
195
     </varlistentry>
121
196
 
122
 
     <VarListEntry><term><option/-c/</><term><option/--config-file/</>
123
 
     <ListItem><Para>
124
 
     Configuration File; Specify a configuration file to use. 
 
197
     <varlistentry>
 
198
      <term><option>-c</option></term>
 
199
      <term><option>--config-file</option></term>
 
200
     <listitem><para>Configuration File; Specify a configuration file to use. 
125
201
     The program will read the default configuration file and then this 
126
202
     configuration file. See &apt-conf; for syntax information.     
127
 
     </VarListEntry>
 
203
     </para>
 
204
     </listitem>
 
205
     </varlistentry>
128
206
     
129
 
     <VarListEntry><term><option/-o/</><term><option/--option/</>
130
 
     <ListItem><Para>
131
 
     Set a Configuration Option; This will set an arbitary configuration 
132
 
     option. The syntax is <option>-o Foo::Bar=bar</>.
133
 
     </VarListEntry>
 
207
     <varlistentry>
 
208
      <term><option>-o</option></term>
 
209
      <term><option>--option</option></term>
 
210
     <listitem><para>Set a Configuration Option; This will set an arbitary
 
211
      configuration option. The syntax is <option>-o Foo::Bar=bar</option>.
 
212
     </para>
 
213
     </listitem>
 
214
     </varlistentry>
134
215
">
135
216
 
136
217
<!-- Should be used within the option section of the text to
137
218
     put in the blurb about -h, -v, -c and -o -->
138
219
<!ENTITY apt-cmdblurb "
139
 
   <para>
140
 
   All command line options may be set using the configuration file, the
 
220
   <para>All command line options may be set using the configuration file, the
141
221
   descriptions indicate the configuration option to set. For boolean
142
222
   options you can override the config file by using something like 
143
 
   <option/-f-/,<option/--no-f/, <option/-f=no/ or several other variations.
 
223
   <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
 
224
   or several other variations.
144
225
   </para>
145
226
">
 
227