1KDESVN-BUILD(1) User Contributed Perl Documentation KDESVN-BUILD(1)
2
6 kdesvn-build - automate the kde svn build process
7
9 kdesvn-build [options]... [modules]...
10
12 The kdesvn-build script is used to automate the download, build, and
13 install process for KDE (using Subversion).
14 It is recommended that you first setup a .kdesvn-buildrc file in your
16 home directory. Please refer to kdesvn-build help file in KDE help for
17 information on how to write .kdesvn-buildrc, or consult the sample file
18 which should have been included with this program. If you don't setup
19 a .kdesvn-buildrc, a default set of options will be used, and a few
20 modules will be built by default.
21 After setting up .kdesvn-buildrc, you can run this program from either
23 the command-line or from cron. It will automatically download the mod‐
24 ules from Subversion, create the build system, and configure and make
25 the modules you tell it to. You can use this program to install KDE as
26 well, if you are building KDE for a single user. Note that kdesvn-build
27 will try to install the modules by default.
28 If you DO specify a package name, then your settings will still be
30 read, but the script will try to build / install the package regardless
31 of .kdesvn-buildrc
32 kdesvn-build reads options in the following order:
34 1. From the command line.
36 2. From the file kdesvn-buildrc in the current directory. Note that
37 the file is not a hidden file.
38 3. From the file ~/.kdesvn-buildrc.
39 4. From a set of internal options.
40 This utility is part of the KDE Software Development Kit.
42
44 --quiet, -q
45 With this switch kdesvn-build will only output a general overview
46 of the build process. Progress output is still displayed if avail‐
47 able.
48 --really-quiet
50 With this switch only warnings and errors will be output.
51 --verbose, -v
53 Be very detailed in what is going on, and what actions kdesvn-build
54 is taking. Only --debug is more detailed.
55 --no-svn
57 Skip contacting the Subversion server.
58 --no-build
60 Skip the build process.
61 --no-install
63 Don't automatically install after build.
64 --svn-only
66 Update from Subversion only (Identical to --no-build at this
67 point).
68 --build-only
70 Build only, do not perform updates or install.
71 --rc-file=<filename>
73 Read configuration from filename instead of default.
74 --debug
76 Activates debug mode.
77 --pretend, -p
79 Do not contact the Subversion server, run make, or create / delete
80 files and directories. Instead, output what the script would have
81 done.
82 --nice=<value>
84 Allow you to run the script with a lower priority. The default
85 value is 10 (lower priority by 10 steps).
86 --prefix=/kde/path
88 This option is a shortcut to change the setting for kdedir from the
89 command line. It implies --reconfigure.
90 --color
92 Add color to the output.
93 --no-color
95 Remove color from the output.
96 --resume
98 Tries to resume the make process from the last time the script was
99 run, without performing the Subversion update.
100 --resume-from=<pkg>
102 Starts building from the given package, without performing the Sub‐
103 version update.
104 --revision=<rev>, -r=<rev>
106 Forces update to revision <rev> from Subversion.
107 --refresh-build
109 Start the build from scratch. This means that the build directory
110 for the module will be deleted before make -f Makefile.cvs is run
111 again. You can use --recreate-configure to do the same thing with‐
112 out deleting the module build directory.
113 --reconfigure
115 Run configure again, but don't clean the build directory or re-run
116 make -f Makefile.cvs.
117 --recreate-configure
119 Run make -f Makefile.cvs again to redo the configure script. The
120 build directory is not deleted.
121 --no-rebuild-on-fail
123 Do not try to rebuild a module from scratch if it failed building.
124 Normally kdesvn-build will try progressively harder to build the
125 module before giving up.
126 --build-system-only
128 Create the build infrastructure, but don't actually perform the
129 build.
130 --install
132 Try to install the packages passed on the command line, or all
133 packages in ~/.kdesvn-buildrc that don't have manual-build set.
134 Building and Subversion updates are not performed.
135 --<option>=
137 Any unrecognized options are added to the global configuration,
138 overriding any value that may exist.
139 For example, --svn-server=http://path.to.svn.server/ would change
141 the setting of the global svn-server option for this instance of
142 kdesvn-build.
143 --<module>,<option>=
145 Likewise, allow you to override any module specific option from the
146 command line.
147 Example: --kdelibs,use-unsermake=false would disable unsermake for
149 the kdelibs module.
150 --help
152 Display the help and exit.
153 --author
155 Output the author(s)'s name.
156 --version
158 Output the program version.
159
161 kdesvn-build
162 kdesvn-build --no-svn kdelibs
163 kdesvn-bulid --refresh-build kdebase
164
166 Since kdesvn-build doesn't generally save information related to the
167 build and prior settings, you may need to manually re-run kdesvn-build
168 with a flag like --recreate-configure if you change some options,
169 including use-unsermake.
170 Please use KDE bugzilla at http://bugs.kde.org for information and
172 reporting bugs.
173
175 You can find additional information at kdesvn-build home page,
176 http://kdesvn-build.kde.org/, or using kdesvn-build docbook documenta‐
177 tion, using the help kioslave, help:/kdesvn-build.
178
180 Michael Pyne <michael.pyne@kdemail.net>
181 Man page written by: Carlos Leonhard Woelz <carlos.woelz@kdemail.net>
183perl v5.8.8 2007-05-14 KDESVN-BUILD(1)