← Back to branch summary

~ubuntu-branches/ubuntu/precise/upgrade-system/precise

« back to all changes in this revision

Viewing changes to upgrade-system.conf.5

  • Committer: Bazaar Package Importer
  • Author(s): Martin-Éric Racine
  • Date: 2009-08-08 15:04:19 UTC
  • mfrom: (4.2.2 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090808150419-tsuw1kwikcrlxlms
* Brushed up man page wording and added author Christoph Schindler.
* Added a loop that implements a purge for obsolete configurations.
  Thanks to Tollef Fog Heen for tips on implementing this feature!
* Moved the purge for uninstalled packages to the FLAUSCH loop.
  + This pedantic purge is only ever needed after a dist-upgrade and
    moving it to the FLAUSCH loop makes daily operation much faster.
  + The FLAUSCH option is thereby required to enable these purges:
    - Uninstalled packages.
    - Orphan configurations.
    - Obsolete configurations.
* Added BOLD ALL-CAPS emphasis to some warnings in the FLAUSCH loop.

Show diffs side-by-side

added added

removed removed

Lines of Context:
upgrade-system.conf.5
16
16
Lines starting with a hash mark ("#") and empty lines are ignored.
17
17
 
18
18
.SH "EXAMPLE"
19
 
The configuration file contains three variables:
 
19
The configuration file contains four variables:
20
20
 
21
21
.SS CLEANOPTS
22
22
This variable is used to pass the command line option to 
27
27
.BR clean
28
28
action will be performed. For example:
29
29
.PP
30
 
        CLEANOPTS="clean"
 
30
CLEANOPTS="clean"
31
31
.PP
32
32
Consult the
33
33
.BR apt\-get (8) 
43
43
.BR upgrade
44
44
action will be performed. For example:
45
45
.PP
46
 
        UPGRADEOPTS="dist-upgrade"
 
46
UPGRADEOPTS="\-f \-u dist-upgrade"
47
47
.PP
48
48
Consult the
49
49
.BR apt\-get (8) 
55
55
.BR deborphan (1),
56
56
for selecting the orphaning operations. For example:
57
57
.PP
58
 
        ORPHANOPTS="\-\-guess\-all \-\-libdevel \-\-priority=3"
 
58
ORPHANOPTS="\-\-guess\-all \-\-libdevel \-\-priority=2"
59
59
.PP
60
60
One should
61
61
read the 
62
 
.BR deborphan (1),
 
62
.BR deborphan (1)
63
63
manual page to check which options are available for
64
64
any particular version, before setting this variable.
 
65
.SS FLAUSCH
 
66
Setting this variable enables various extremely pedantic purge options.
 
67
This feature is totally experimental; usage is strongly discouraged and
 
68
should only be attempted by truly experienced Debian administrators.
65
69
 
66
70
.SH "SECURITY" 
67
71
Because 
106
110
.SH "AUTHORS"
107
111
Martin Zdrahal <martin.zdrahal@konflux.at> made the original in 2003.
108
112
.PP
 
113
Christoph Schindler <hop@30hopsmax.at> added recursive purge in 2004.
 
114
.PP
109
115
Martin\-Eric Racine <q\-funk@iki.fi> wrote this manual page, packaged
110
 
the Debian archive and added various enhancements in 2004.
 
116
the Debian archive and added various enhancements since 2004.
111
117
 
112
118
.SH "SEE ALSO"
113
119
.BR apt\-get (8),