python-updater.1


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PYTHON-UPDATER "1" "August 2008" "python-updater 0.6" "User Commands"
.SH NAME
python-updater \- manual page for python-updater 0.6
.SH SYNOPSIS
.B python-updater
[\fIOPTION\fR]
.SH DESCRIPTION
python\-updater \fB\-\-\fR Find & rebuild packages broken due to a python upgrade
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print usage
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.TP
\fB\-p\fR, \fB\-\-pretend\fR
Pretend (don't do anything)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Increase verbosity (may be specified multiple times)
.TP
\fB\-o\fR PYVER, \fB\-\-old\-version\fR PYVER
Set old python version to upgrade from to PYVER
.TP
\fB\-i\fR, \fB\-\-ignore\-versions\fR
Ignore versions when remerging packages
(still respects SLOTs)
.TP
\fB\-P\fR PM, \fB\-\-package\-manager\fR PM
Use package manager PM, where PM can be one of:
portage 
pkgcore 
paludis 
.TP
\fB\-c\fR CMD, \fB\-\-command\fR CMD
Pipe found packages to command CMD instead of invoking package
manager. Only for debug and script use.
.TP
\fB\-eCHECK\fR \fB\-\-enable\-CHECK\fR
Enable CHECK where CHECK can be one of:
eclass 
pylibdir 
soname 
manual 
.TP
\fB\-dCHECK\fR \fB\-\-disable\-CHECK\fR
Disable CHECK. See \fB\-\-enable\fR option for a list of checks
.PP
See CHECKS section for explanations about checks and
EXAMPLES section to learn how to use them.
.SH EXAMPLES

\(bu Rebuild packages after a python upgrade. Default options are just fine ;)

    $> python-updater

\(bu Rebuild packages omitting manually added ones:

    $> python-updater -dmanual
    $> python-updater -disable-manual

\(bu You can use unique substrings instead of names for checks:

    $> python-updater -dm -ep
    $> python-updater --disable-m --enable-pylib
.SH CHECKS
pylibdir
    Find packages that installed files under old python library dir,
    /usr/lib/python$old/site-packages where $old is old python version
    Enabled by default.

soname
    Find packages that have files linked to old libpython (requires pax-utils)
    Enabled by default.

eclass
    Find packages that inherited python.eclass and set PYVER to old
    python version. The packages found by this check may not be
    broken.
    Disabled by default.

manual
    python-updater has a list of packages that are known to break
    by python upgrades but can't be determined by methods specified
    above. This check can be disabled if you're sure you've rebuilt
    the package once and it's OK now.
    Enabled by default.

Checks can be enabled/disabled on command line with -e/--enable and -d/--disable
switches.

See EXAMPLES for a list examples.

See ENVIRONMENT on how to set default options to override
.SH AUTHORS
Bryan Østergaard "kloeri" <bryan.ostergaard@gmail.com>
    Wrote main code

Ali Polatel "hawking" <hawking@gentoo.org>
    Current maintainer
.SH ENVIRONMENT

PYUPDATER_OPTIONS
    Default command line options
.SH "REPORTING BUGS"
Submit bug reports to https://bugs.gentoo.org/
.SH COPYRIGHT
Copyright \(co 2007-2008 Gentoo Foundation,
distributed under the terms of the GNU General Public License v2