3 "Project-Id-Version: jhbuild doc\n"
4 "POT-Creation-Date: 2008-07-26 14:28+0000\n"
5 "PO-Revision-Date: 2008-07-27 01:09+0100\n"
6 "Last-Translator: Daniel Nylander <po@danielnylander.se>\n"
7 "Language-Team: Swedish <tp-sv@listor.tp-sv.se>\n"
9 "Content-Type: text/plain; charset=UTF-8\n"
10 "Content-Transfer-Encoding: 8bit\n"
12 #. When image changes, this message will be marked fuzzy or untranslated for you.
13 #. It doesn't matter what you translate it to: it's not used at all.
14 #: C/jhbuild.xml:806(None)
15 msgid "@@image: 'figures/jhbuild_sample_dot_output.png'; md5=af9fe7edb29fcaefeadfb2f5987aa6e4"
18 #: C/jhbuild.xml:7(title)
19 msgid "JHBuild Manual"
20 msgstr "Handbok för JHBuild"
22 #: C/jhbuild.xml:10(firstname)
26 #: C/jhbuild.xml:11(surname)
30 #: C/jhbuild.xml:14(firstname)
34 #: C/jhbuild.xml:15(surname)
36 msgstr "Adams-Collier"
38 #: C/jhbuild.xml:18(firstname)
42 #: C/jhbuild.xml:19(surname)
46 #: C/jhbuild.xml:22(firstname)
50 #: C/jhbuild.xml:23(surname)
54 #: C/jhbuild.xml:27(year)
58 #: C/jhbuild.xml:28(holder)
59 msgid "James Henstridge"
60 msgstr "James Henstridge"
62 #: C/jhbuild.xml:33(revnumber)
63 msgid "JHBuild Manual v0.5"
64 msgstr "Handbok för JHBuild v0.5"
66 #: C/jhbuild.xml:34(date)
70 #: C/jhbuild.xml:37(revnumber)
71 msgid "JHBuild Manual v0.1"
72 msgstr "Handbok för JHBuild v0.1"
74 #: C/jhbuild.xml:38(date)
78 #: C/jhbuild.xml:43(para)
79 msgid "JHBuild is a tool used to build the whole GNOME desktop from the SVN source, however, it can be used to build other projects by creating a moduleset for it."
82 #: C/jhbuild.xml:50(title)
86 #: C/jhbuild.xml:52(para)
87 msgid "JHBuild is a tool designed to ease building collections of source packages (also known as modules). It uses <quote>module set</quote> files to describe the modules available to build. These files include dependency information that allows JHBuild to work out what modules need to be built and in what order to build what the user requested."
90 #: C/jhbuild.xml:59(para)
91 msgid "JHBuild was originally written for building <ulink url=\"http://www.gnome.org\">GNOME</ulink>, but has since been extended to make it usable with other projects. A <quote>module set</quote> file can be hosted on a web server, allowing people to provide build rules independent of JHBuild."
94 #: C/jhbuild.xml:65(para)
95 msgid "JHBuild can build modules from a variety of sources, including <ulink url=\"http://www.cvshome.org/\">CVS</ulink>, <ulink url=\"http://subversion.tigris.org/\">Subversion</ulink><ulink url=\"http://wiki.gnuarch.org/\">Arch</ulink>, <ulink url=\"http://www.bazaar-vcs.org/\">Bazaar</ulink>, <ulink url=\"http://darcs.net/\">Darcs</ulink>, <ulink url=\"http://git.or.cz/\">Git</ulink> and <ulink url=\"http://www.selenic.com/mercurial/\">Mercurial</ulink> repositories, as well as Tar archives hosted on web or FTP sites; and using a variety of build systems, including Autotools, CMake, WAF, Ant, Python Distutils and Perl Makefiles."
98 #: C/jhbuild.xml:79(para)
99 msgid "JHBuild is not intended as a replacement for the distribution's package management system. Instead, it makes it easy to build everything into a separate install prefix so that it doesn't interfere with the rest of the system."
102 #: C/jhbuild.xml:87(title)
103 msgid "Getting Started"
106 #: C/jhbuild.xml:89(para)
107 msgid "JHBuild takes a bit of work to set up on a system. As well as installing JHBuild's prerequisites, it is necessary to install the prerequisite tools needed to obtain and build the software sources."
110 #: C/jhbuild.xml:95(title)
111 msgid "Installing JHBuild"
112 msgstr "Installera JHBuild"
114 #: C/jhbuild.xml:97(para)
115 msgid "Before downloading JHBuild, you should make sure you have a copy of Python >= 2.0 installed on your system. It is also essential that the Expat XML parser extension is installed. This will be the case if you are using Python >= 2.3, or had expat installed when building Python. You can check whether this is the case by running the following simple command from the Python interpreter:"
118 #: C/jhbuild.xml:105(prompt)
119 #: C/jhbuild.xml:106(prompt)
121 msgstr ">>>"
123 #: C/jhbuild.xml:105(userinput)
125 msgid "import xml.parsers.expat"
126 msgstr "import xml.parsers.expat"
128 #: C/jhbuild.xml:108(para)
129 msgid "If this completes without an exception, then it is installed correctly."
132 #: C/jhbuild.xml:111(para)
133 msgid "At the moment, the only way to download JHBuild is via Subversion. This can be achieved with the following commands. They should be run in the directory where JHBuild will be installed (for example, <filename>~/checkout/gnome2</filename>)."
136 #: C/jhbuild.xml:116(prompt)
137 #: C/jhbuild.xml:118(prompt)
138 #: C/jhbuild.xml:124(prompt)
139 #: C/jhbuild.xml:125(prompt)
140 #: C/jhbuild.xml:127(prompt)
141 #: C/jhbuild.xml:129(prompt)
142 #: C/jhbuild.xml:131(prompt)
143 #: C/jhbuild.xml:137(prompt)
144 #: C/jhbuild.xml:138(prompt)
145 #: C/jhbuild.xml:140(prompt)
146 #: C/jhbuild.xml:142(prompt)
147 #: C/jhbuild.xml:149(prompt)
148 #: C/jhbuild.xml:150(prompt)
149 #: C/jhbuild.xml:158(prompt)
150 #: C/jhbuild.xml:159(prompt)
151 #: C/jhbuild.xml:299(prompt)
152 #: C/jhbuild.xml:323(prompt)
153 #: C/jhbuild.xml:349(prompt)
154 #: C/jhbuild.xml:363(prompt)
155 #: C/jhbuild.xml:369(prompt)
156 #: C/jhbuild.xml:376(prompt)
157 #: C/jhbuild.xml:382(prompt)
158 #: C/jhbuild.xml:387(prompt)
159 #: C/jhbuild.xml:393(prompt)
160 #: C/jhbuild.xml:398(prompt)
161 #: C/jhbuild.xml:404(prompt)
162 #: C/jhbuild.xml:409(prompt)
163 #: C/jhbuild.xml:760(prompt)
164 #: C/jhbuild.xml:762(prompt)
165 #: C/jhbuild.xml:795(prompt)
166 #: C/jhbuild.xml:799(prompt)
167 #: C/jhbuild.xml:1035(prompt)
171 #: C/jhbuild.xml:116(userinput)
173 msgid "svn co http://svn.gnome.org/svn/jhbuild/trunk jhbuild"
174 msgstr "svn co http://svn.gnome.org/svn/jhbuild/trunk jhbuild"
176 #: C/jhbuild.xml:117(computeroutput)
177 #: C/jhbuild.xml:126(computeroutput)
178 #: C/jhbuild.xml:128(computeroutput)
179 #: C/jhbuild.xml:130(computeroutput)
180 #: C/jhbuild.xml:139(computeroutput)
181 #: C/jhbuild.xml:141(computeroutput)
186 #: C/jhbuild.xml:120(para)
187 msgid "This will download JHBuild into a new folder named <filename>jhbuild</filename> under the current directory. Now to build and install it:"
190 #: C/jhbuild.xml:124(userinput)
191 #: C/jhbuild.xml:137(userinput)
196 #: C/jhbuild.xml:125(userinput)
199 msgstr "./autogen.sh"
201 #: C/jhbuild.xml:127(userinput)
206 #: C/jhbuild.xml:129(userinput)
209 msgstr "make install"
211 #: C/jhbuild.xml:133(para)
212 msgid "Alternatively, if your work environment doesn't have autotools or gnome-doc-utils installed you can also build and install JHBuild that way:"
215 #: C/jhbuild.xml:138(userinput)
217 msgid "make -f Makefile.plain"
218 msgstr "make -f Makefile.plain"
220 #: C/jhbuild.xml:140(userinput)
222 msgid "make -f Makefile.plain install"
223 msgstr "make -f Makefile.plain install"
225 #: C/jhbuild.xml:144(para)
226 msgid "If these steps complete successfully, a small shell script should be installed in <filename>~/bin</filename> to start JHBuild. If this directory is not in the <envar>PATH</envar>, it will need to be added. This can be done with the command:"
229 #: C/jhbuild.xml:149(userinput)
231 msgid "PATH=$PATH:~/bin"
232 msgstr "PATH=$PATH:~/bin"
234 #: C/jhbuild.xml:152(para)
235 msgid "This command will need to be run every time you login and want to use JHBuild. In order to permanently add <filename>~/bin</filename> to your <envar>PATH</envar> variable, run the following command:"
238 #: C/jhbuild.xml:158(userinput)
240 msgid "echo PATH=$PATH:~/bin >> ~/.bashrc"
241 msgstr "echo PATH=$PATH:~/bin >> ~/.bashrc"
243 #: C/jhbuild.xml:161(para)
244 msgid "Before JHBuild can be run, it is necessary to set up a configuration file, located at <filename>~/.jhbuildrc</filename>. This file specifies JHBuild will behave."
247 #: C/jhbuild.xml:168(title)
248 msgid "Configuring JHBuild"
249 msgstr "Konfigurera JHBuild"
251 #: C/jhbuild.xml:170(para)
252 msgid "The <filename>~/.jhbuildrc</filename> file uses Python syntax to set a number of configuration variables for JHBuild. A minimal configuration file might look something like this:"
255 #: C/jhbuild.xml:175(programlisting)
259 "moduleset = 'gnome-2.22'\n"
260 "modules = [ 'meta-gnome-desktop' ]\n"
261 "checkoutroot = os.path.join(os.environ['HOME'], 'checkout', 'gnome2')\n"
262 "prefix = os.path.join(os.environ['HOME'], 'prefix')\n"
263 "os.environ['INSTALL'] = os.path.join(os.environ['HOME'],\n"
264 " 'bin', 'install-check')\n"
267 #: C/jhbuild.xml:184(para)
268 msgid "This will make JHBuild build the <application>meta-gnome-desktop</application> module and its dependencies from the <systemitem>gnome-2.22</systemitem> module set. It will unpack source trees to <filename>~/checkout/gnome2</filename> and install all files to subdirectories of <filename>~/prefix</filename>. It also sets the <envar>INSTALL</envar> environment variable, so modules use a different install program which handles installation of headers differently, in order to reduce the time taken for rebuilds."
271 #: C/jhbuild.xml:194(para)
272 msgid "Some of configuration variables available include:"
275 #: C/jhbuild.xml:199(varname)
276 #: C/jhbuild.xml:1372(varname)
280 #: C/jhbuild.xml:201(simpara)
281 msgid "A string or list of strings specifying the name(s) of the module set(s) to use. If a module set name is a fully qualified URL, then the module set will be cached locally and regularly updated. If a module with the same name is present in more than one module set, the last set listed takes priority."
284 #: C/jhbuild.xml:210(varname)
285 #: C/jhbuild.xml:795(replaceable)
286 #: C/jhbuild.xml:799(replaceable)
287 #: C/jhbuild.xml:1363(varname)
291 #: C/jhbuild.xml:212(simpara)
292 msgid "A list of strings giving the modules you want to build. The list of modules actually built will be recursively expanded to include all the dependencies unless the <command>buildone</command> is used."
295 #: C/jhbuild.xml:219(varname)
296 #: C/jhbuild.xml:1212(varname)
300 #: C/jhbuild.xml:221(simpara)
301 msgid "The base directory where all source modules are unpacked or checked out of revision control."
304 #: C/jhbuild.xml:226(varname)
305 #: C/jhbuild.xml:1436(varname)
309 #: C/jhbuild.xml:228(simpara)
310 msgid "The directory prefix to install modules to. You must have write permissions to this directory, or JHBuild will be unable to install files."
313 #: C/jhbuild.xml:234(varname)
314 #: C/jhbuild.xml:1584(varname)
318 #: C/jhbuild.xml:236(simpara)
319 msgid "A dictionary representing the environment. This can be used to set or get environment variable values as shown in the example configuration above."
322 #: C/jhbuild.xml:242(varname)
323 #: C/jhbuild.xml:1483(varname)
327 #: C/jhbuild.xml:244(simpara)
328 msgid "A list of module names that to not include when deciding what to build. One use of this variable is to use the version of a package included with the distribution instead of building it."
331 #: C/jhbuild.xml:251(varname)
332 #: C/jhbuild.xml:1151(varname)
336 #: C/jhbuild.xml:253(simpara)
337 msgid "A string listing additional arguments to pass to the <command>autogen.sh</command> or <command>configure</command> scripts for modules."
340 #: C/jhbuild.xml:259(varname)
341 #: C/jhbuild.xml:1267(varname)
345 #: C/jhbuild.xml:261(simpara)
346 msgid "A string listing arguments to be pass to the <command>make</command> command."
349 #: C/jhbuild.xml:266(varname)
350 #: C/jhbuild.xml:1469(varname)
354 #: C/jhbuild.xml:268(simpara)
355 #: C/jhbuild.xml:1471(simpara)
356 msgid "By default, JHBuild will check out code from repositories using an anonymous repository location. This dictionary is used to tell JHBuild to use an alternative repository location for a particular repository (a developer would probably want to do this). This variable is a dictionary where the keys are short repository names (for example, <systemitem class=\"systemname\">svn.gnome.org</systemitem> is used for the GNOME SVN repository), and the values are the alternative repository location strings."
359 #: C/jhbuild.xml:283(title)
360 msgid "Build Prerequisites"
363 #: C/jhbuild.xml:285(para)
364 msgid "Before any modules can be built, it is necessary to have certain build tools installed. These can include the GNU Autotools (<application>autoconf</application>, <application>automake</application>, <application>libtool</application> and <application>gettext</application>), The GNU Toolchain (<application>binutils</application>, <application>gcc</application>, <application>g++</application>), pkg-config and Python, depending on which modules will be built."
367 #: C/jhbuild.xml:296(para)
368 msgid "JHBuild can check if your system has these tools installed using the <command>sanitycheck</command> command:"
371 #: C/jhbuild.xml:299(userinput)
372 #: C/jhbuild.xml:993(command)
374 msgid "jhbuild sanitycheck"
377 #: C/jhbuild.xml:301(para)
378 msgid "If this command prints any messages, these can be fixed in one of two ways:"
381 #: C/jhbuild.xml:306(simpara)
382 msgid "Install the required package from your distribution's repository. A list of <ulink url=\"http://live.gnome.org/JhbuildDependencies\">package names</ulink> for different distributions is maintained on the GNOME wiki. The <command>sanitycheck</command> command should be run again afterwards to make sure required tools are present."
385 #: C/jhbuild.xml:315(simpara)
386 msgid "Run the <command>bootstrap</command> command to install the build prerequsites."
389 #: C/jhbuild.xml:320(para)
390 msgid "The <command>bootstrap</command> command can be invoked like so:"
393 #: C/jhbuild.xml:323(userinput)
394 #: C/jhbuild.xml:512(command)
396 msgid "jhbuild bootstrap"
399 #: C/jhbuild.xml:325(para)
400 msgid "This will download and install all the build prerequisites. Once it is finished, the <command>sanitycheck</command> command should be rerun to verify that everything is in place."
403 #: C/jhbuild.xml:331(para)
404 msgid "The <command>bootstrap</command> command does not build all the packages required by these tools. If your distribution does not provide those packages, then they will need to be built separately."
407 #: C/jhbuild.xml:336(para)
408 msgid "Some packages to check for include <application>m4</application>, <application>perl</application> and a C compiler (For example, <application>gcc</application>)."
411 #: C/jhbuild.xml:343(title)
412 msgid "Using JHBuild"
415 #: C/jhbuild.xml:345(para)
416 msgid "Now that everything is set up, JHBuild can be used to build some software. To build all the modules selected in the <filename>~/.jhbuildrc</filename> file, run the following command:"
419 #: C/jhbuild.xml:349(userinput)
420 #: C/jhbuild.xml:531(command)
422 msgid "jhbuild build"
425 #: C/jhbuild.xml:351(para)
426 msgid "This will download, configure, compile and install each of the modules. If an error occurs at any stage, JHBuild will present a menu asking what to do. These choices include dropping to a shell to fix the error, rerunning the build from various stages, giving up on the module (which will also cause any modules depending on it to fail), or ignore the error and continue."
429 #: C/jhbuild.xml:359(para)
430 msgid "It is also possible to build a different set of modules (and their dependencies) by passing their names as arguments to the <command>build</command> command, for example, to build gtk+:"
433 #: C/jhbuild.xml:363(userinput)
435 msgid "jhbuild build gtk+"
438 #: C/jhbuild.xml:365(para)
439 msgid "If you exit JHBuild part way through a build for some reason, it is possible to pick up a build at a particular module using the <option>--start-at</option> option:"
442 #: C/jhbuild.xml:369(userinput)
444 msgid "jhbuild build --start-at=pango"
447 #: C/jhbuild.xml:371(para)
448 msgid "To build one or more modules, ignoring their dependencies, the <command>buildone</command> command can be used. This command should only be used if you have manually installed all dependencies, else the build will fail."
451 #: C/jhbuild.xml:376(userinput)
453 msgid "jhbuild buildone gtk+"
456 #: C/jhbuild.xml:378(para)
457 msgid "To get a list of the modules and dependencies jhbuild will build, and the order in which they will be built, use the <command>list</command> command:"
460 #: C/jhbuild.xml:382(userinput)
461 #: C/jhbuild.xml:863(command)
466 #: C/jhbuild.xml:384(para)
467 msgid "To get information about a particular module, the <command>info</command> command can be used:"
470 #: C/jhbuild.xml:387(userinput)
472 msgid "jhbuild info gtk+"
475 #: C/jhbuild.xml:389(para)
476 msgid "If your internet bandwidth varies, or you wish to modify the sources before building them, you can download or update all the software sources without actually building them:"
479 #: C/jhbuild.xml:393(userinput)
480 #: C/jhbuild.xml:1088(command)
482 msgid "jhbuild update"
485 #: C/jhbuild.xml:395(para)
486 msgid "Later on, you can tell JHBuild to build everything without downloading or updating the sources:"
489 #: C/jhbuild.xml:398(userinput)
491 msgid "jhbuild build --no-network"
494 #: C/jhbuild.xml:400(para)
495 msgid "If you want to run a particular command with the same environment variables set that JHBuild uses, use the <command>run</command> command:"
498 #: C/jhbuild.xml:404(replaceable)
499 #: C/jhbuild.xml:966(replaceable)
503 #: C/jhbuild.xml:404(userinput)
505 msgid "jhbuild run <placeholder-1/>"
508 #: C/jhbuild.xml:406(para)
509 msgid "To start a shell with the environment used by JHBuild, use the <command>shell</command> command:"
512 #: C/jhbuild.xml:409(userinput)
513 #: C/jhbuild.xml:1029(command)
515 msgid "jhbuild shell"
518 #: C/jhbuild.xml:415(title)
519 msgid "Command Reference"
520 msgstr "Kommandoreferens"
522 #: C/jhbuild.xml:417(para)
523 msgid "JHBuild uses a command line syntax similar to tools like CVS:"
526 #: C/jhbuild.xml:420(command)
530 #: C/jhbuild.xml:421(replaceable)
531 msgid "global-options"
534 #: C/jhbuild.xml:422(replaceable)
538 #: C/jhbuild.xml:423(replaceable)
539 msgid "command-arguments"
542 #: C/jhbuild.xml:426(para)
543 msgid "The global JHBuild options are:"
546 #: C/jhbuild.xml:430(term)
547 msgid "<option>-f</option>, <option>--file</option><replaceable>config</replaceable>"
550 #: C/jhbuild.xml:433(simpara)
551 msgid "Use an alternative configuration file, instead of the default, <filename>~/.jhbuildrc</filename>."
554 #: C/jhbuild.xml:439(term)
555 msgid "<option>-m</option>, <option>--moduleset</option><replaceable>moduleset</replaceable>"
558 #: C/jhbuild.xml:442(simpara)
559 msgid "Use a module set other than the one listed in the configuration file. This should be a relative path if the module set is located in the JHBuild moduleset folder, or an absolute path if it is located elsewhere."
562 #: C/jhbuild.xml:450(option)
563 msgid "--no-interact"
566 #: C/jhbuild.xml:452(simpara)
567 msgid "Do not prompt the user for any input. This is useful when leaving a build unattended, in order to ensure it is not interrupted."
570 #: C/jhbuild.xml:459(para)
571 msgid "Command specific options are listed below."
574 #: C/jhbuild.xml:462(title)
578 #: C/jhbuild.xml:464(para)
579 msgid "The <command>autobuild</command> command is used to automatically build the modules specified in the configuration file, and then upload the results to JhAutobuild."
582 #: C/jhbuild.xml:469(command)
583 msgid "jhbuild autobuild"
586 #: C/jhbuild.xml:470(arg)
587 #: C/jhbuild.xml:532(arg)
588 #: C/jhbuild.xml:716(arg)
589 #: C/jhbuild.xml:1049(arg)
593 #: C/jhbuild.xml:471(arg)
594 #: C/jhbuild.xml:533(arg)
595 #: C/jhbuild.xml:717(arg)
596 #: C/jhbuild.xml:1050(arg)
600 #: C/jhbuild.xml:472(replaceable)
601 #: C/jhbuild.xml:473(replaceable)
602 #: C/jhbuild.xml:537(replaceable)
603 #: C/jhbuild.xml:538(replaceable)
604 #: C/jhbuild.xml:547(arg)
605 #: C/jhbuild.xml:724(arg)
606 #: C/jhbuild.xml:779(arg)
607 #: C/jhbuild.xml:838(arg)
608 #: C/jhbuild.xml:869(arg)
609 #: C/jhbuild.xml:935(arg)
610 #: C/jhbuild.xml:1053(replaceable)
611 #: C/jhbuild.xml:1054(replaceable)
612 #: C/jhbuild.xml:1058(arg)
613 #: C/jhbuild.xml:1089(replaceable)
614 #: C/jhbuild.xml:1090(replaceable)
615 #: C/jhbuild.xml:1093(arg)
616 #: C/jhbuild.xml:1113(arg)
620 #: C/jhbuild.xml:472(arg)
621 #: C/jhbuild.xml:537(arg)
622 #: C/jhbuild.xml:1053(arg)
623 #: C/jhbuild.xml:1089(arg)
624 msgid "--skip=<placeholder-1/>"
625 msgstr "--skip=<placeholder-1/>"
627 #: C/jhbuild.xml:473(arg)
628 #: C/jhbuild.xml:538(arg)
629 #: C/jhbuild.xml:1054(arg)
630 #: C/jhbuild.xml:1090(arg)
631 msgid "--start-at=<placeholder-1/>"
632 msgstr "--start-at=<placeholder-1/>"
634 #: C/jhbuild.xml:474(replaceable)
638 #: C/jhbuild.xml:474(arg)
639 msgid "--report-url=<placeholder-1/>"
640 msgstr "--report-url=<placeholder-1/>"
642 #: C/jhbuild.xml:475(arg)
646 #: C/jhbuild.xml:478(para)
647 msgid "The <option>--autogen</option>, <option>--clean</option>, <option>--skip</option> and <option>--start-at</option> options are processed in the same way as for the <command>build</command> command."
650 #: C/jhbuild.xml:485(term)
651 msgid "<option>--report-url=<replaceable>reporturl</replaceable></option>, <option>-r <replaceable>reporturl</replaceable></option>"
654 #: C/jhbuild.xml:488(simpara)
655 msgid "This option specifies the JhAutobuild URL which JHBuild should report to"
658 #: C/jhbuild.xml:494(term)
659 msgid "<option>--verbose</option>, <option>-v</option>"
662 #: C/jhbuild.xml:496(simpara)
663 msgid "This option causes JHBuild's output to be more verbose"
666 #: C/jhbuild.xml:505(title)
670 #: C/jhbuild.xml:507(para)
671 msgid "The <command>bootstrap</command> command is used to install a set of build utilities required to build most modules (eg. autoconf, automake, etc)."
674 #: C/jhbuild.xml:515(para)
675 msgid "Internally, <command>bootstrap</command> is implemented using the same code as <command>build</command>, using the <filename>bootstrap.modules</filename> moduleset."
678 #: C/jhbuild.xml:519(para)
679 msgid "Look at the <link linkend=\"command-reference-build\">build</link> command documentation for available options."
682 #: C/jhbuild.xml:525(title)
686 #: C/jhbuild.xml:527(para)
687 msgid "The <command>build</command> command is used to build one or more packages, including their dependencies."
690 #: C/jhbuild.xml:534(arg)
694 #: C/jhbuild.xml:535(arg)
695 #: C/jhbuild.xml:583(option)
696 #: C/jhbuild.xml:718(arg)
700 #: C/jhbuild.xml:536(arg)
701 #: C/jhbuild.xml:719(arg)
702 #: C/jhbuild.xml:1051(arg)
706 #: C/jhbuild.xml:539(replaceable)
707 #: C/jhbuild.xml:867(replaceable)
708 #: C/jhbuild.xml:1091(replaceable)
712 #: C/jhbuild.xml:539(arg)
713 #: C/jhbuild.xml:867(arg)
714 #: C/jhbuild.xml:1091(arg)
715 msgid "--tags=<placeholder-1/>"
718 #: C/jhbuild.xml:540(replaceable)
719 #: C/jhbuild.xml:635(replaceable)
720 #: C/jhbuild.xml:720(replaceable)
721 #: C/jhbuild.xml:1055(replaceable)
722 #: C/jhbuild.xml:1092(replaceable)
723 #: C/jhbuild.xml:1112(replaceable)
727 #: C/jhbuild.xml:540(arg)
728 #: C/jhbuild.xml:720(arg)
729 #: C/jhbuild.xml:1055(arg)
730 #: C/jhbuild.xml:1092(arg)
731 #: C/jhbuild.xml:1112(arg)
732 msgid "-D <placeholder-1/>"
735 #: C/jhbuild.xml:541(arg)
736 #: C/jhbuild.xml:721(arg)
740 #: C/jhbuild.xml:542(arg)
741 msgid "--try-checkout"
744 #: C/jhbuild.xml:543(arg)
748 #: C/jhbuild.xml:544(arg)
749 #: C/jhbuild.xml:722(arg)
753 #: C/jhbuild.xml:545(arg)
754 #: C/jhbuild.xml:681(option)
755 msgid "--build-optional-modules"
758 #: C/jhbuild.xml:546(replaceable)
759 #: C/jhbuild.xml:723(replaceable)
763 #: C/jhbuild.xml:546(arg)
764 #: C/jhbuild.xml:723(arg)
765 msgid "--min-age=<placeholder-1/>"
768 #: C/jhbuild.xml:550(para)
769 #: C/jhbuild.xml:782(para)
770 #: C/jhbuild.xml:872(para)
771 msgid "If no module names are given on the command line, then the module list found in the configuration file will be used."
774 #: C/jhbuild.xml:555(term)
775 msgid "<option>-a</option>, <option>--autogen</option>"
778 #: C/jhbuild.xml:557(simpara)
779 msgid "Always run <command>autogen.sh</command> before building modules. By default, <command>autogen.sh</command> will only be called if the toplevel makefile is missing. Otherwise, it relies on the package's makefiles to detect if configure needs to be rebuilt or rerun."
782 #: C/jhbuild.xml:567(term)
783 msgid "<option>-c</option>, <option>--clean</option>"
786 #: C/jhbuild.xml:569(simpara)
787 msgid "Run <command>make clean</command> before building modules."
790 #: C/jhbuild.xml:575(term)
791 msgid "<option>-d</option>, <option>--dist</option>"
794 #: C/jhbuild.xml:577(simpara)
795 msgid "Run <command>make dist</command> after building modules."
798 #: C/jhbuild.xml:585(simpara)
799 msgid "Run <command>make distcheck</command> after building modules."
802 #: C/jhbuild.xml:591(term)
803 msgid "<option>-n</option>, <option>--no-network</option>"
806 #: C/jhbuild.xml:593(simpara)
807 msgid "Do not access the network when building modules. This will skip download or update stages in a build. If a module can't be built without network access, it will fail."
810 #: C/jhbuild.xml:601(term)
811 msgid "<option>-s</option>, <option>--skip</option>=<replaceable>module,...</replaceable>"
814 #: C/jhbuild.xml:604(simpara)
815 msgid "Ignore the named modules when following dependencies to expand the list of modules to be built."
818 #: C/jhbuild.xml:611(term)
819 #: C/jhbuild.xml:905(term)
820 msgid "<option>--tags</option>=<replaceable>tag,...</replaceable>"
823 #: C/jhbuild.xml:614(simpara)
824 msgid "Ignore modules that do not match any of <replaceable>tag</replaceable> when following dependencies to expand the list of modules to be built."
827 #: C/jhbuild.xml:617(simpara)
828 msgid "At the moment modules are automatically attributed a tag with the name of the module set they sit in."
831 #: C/jhbuild.xml:623(term)
832 msgid "<option>-t</option>, <option>--start-at</option>=<replaceable>module</replaceable>"
835 #: C/jhbuild.xml:626(simpara)
836 msgid "After expanding the list of modules to build, start at the named module rather than at the beginning of the list. This is useful if the build was interrupted for some reason."
839 #: C/jhbuild.xml:634(option)
843 #: C/jhbuild.xml:637(simpara)
844 msgid "If the underlying version control system supports it, try to update the source tree to its state at the given date before building. The date string should be in ISO format."
847 #: C/jhbuild.xml:645(term)
848 msgid "<option>-x</option>, <option>--no-xvfb</option>"
851 #: C/jhbuild.xml:647(simpara)
852 msgid "Run graphical tests on the actual X server rather than in a simulated Xvfb"
855 #: C/jhbuild.xml:653(term)
856 msgid "<option>-C</option>, <option>--try-checkout</option>"
859 #: C/jhbuild.xml:656(simpara)
860 msgid "If the build fails, and the version control system supports it, force a checkout and run <command>autogen.sh</command> before retrying the build."
863 #: C/jhbuild.xml:664(term)
864 msgid "<option>-N</option>, <option>--no-poison</option>"
867 #: C/jhbuild.xml:666(simpara)
868 msgid "If one or more of a module's dependencies failed, this option forces JHBuild to try to build the module anyway."
871 #: C/jhbuild.xml:673(term)
872 msgid "<option>-f</option>, <option>--force</option>"
875 #: C/jhbuild.xml:675(simpara)
876 msgid "Build the modules even if policy tells it is not required."
879 #: C/jhbuild.xml:683(simpara)
880 msgid "Some modules, listed as optional dependencies, may not be required to build the target module, this option inncludes them nevertheless."
883 #: C/jhbuild.xml:690(term)
884 msgid "<option>--min-time</option>=<replaceable>time</replaceable>"
887 #: C/jhbuild.xml:692(simpara)
888 msgid "Skip modules installed more recently than the given relative time; the <replaceable>time</replaceable> string format is a number followed by a unit, with the following units being supported: seconds (s), minutes (m), hours (h) and days (d)."
891 #: C/jhbuild.xml:697(simpara)
892 msgid "Example: <option>--min-time=2h</option> will skip modules that have been built less than two hours ago."
895 #: C/jhbuild.xml:707(title)
899 #: C/jhbuild.xml:709(para)
900 msgid "The <command>buildone</command> command is similar to <command>build</command>, but it does not use dependency information to expand the module list. It is useful for quickly rebuilding one or more modules."
903 #: C/jhbuild.xml:715(command)
904 msgid "jhbuild buildone"
907 #: C/jhbuild.xml:727(para)
908 msgid "The <option>--autogen</option>, <option>--clean</option>, <option>-d</option>, <option>--distcheck</option>, <option>--no-network</option>, <option>-D</option> and <option>-x</option> options are processed in the same way as for the <command>build</command> command."
911 #: C/jhbuild.xml:733(para)
912 msgid "Unlike the <command>build</command> command, at least one module must be listed on the command line."
915 #: C/jhbuild.xml:739(title)
916 msgid "checkbranches"
919 #: C/jhbuild.xml:741(para)
920 msgid "The <command>checkbranches</command> checks the modules in GNOME Subversion have the correct branch definition. For example, if modules are marked as not having branched, JHBuild checks this is true."
923 #: C/jhbuild.xml:747(command)
924 msgid "jhbuild checkbranches"
927 #: C/jhbuild.xml:748(replaceable)
931 #: C/jhbuild.xml:748(arg)
932 msgid "--branch=<placeholder-1/>"
935 #: C/jhbuild.xml:753(term)
936 msgid "<option>--branch</option>=<replaceable>branch</replaceable>, <option>-b</option><replaceable>branch</replaceable>"
939 #: C/jhbuild.xml:755(simpara)
940 msgid "Specify the branch to check"
943 #: C/jhbuild.xml:760(userinput)
945 msgid "jhbuild -m gnome-2.20 checkbranches"
948 #: C/jhbuild.xml:760(screen)
951 "<placeholder-1/> <placeholder-2/>\n"
952 "libgnomecanvas is missing branch definition for gnome-2-20\n"
956 #: C/jhbuild.xml:767(title)
960 #: C/jhbuild.xml:769(para)
961 msgid "The <command>dot</command> command generates a file describing the directed graph formed by the dependencies between a set of modules. This file can then be processed using the <ulink url=\"http://www.graphviz.org/\">GraphViz</ulink> software to produce a nice diagram."
964 #: C/jhbuild.xml:776(command)
968 #: C/jhbuild.xml:777(arg)
972 #: C/jhbuild.xml:778(arg)
976 #: C/jhbuild.xml:785(para)
977 msgid "The <option>--soft-deps</option> option will add dotted lines from the modules to their soft dependencies. The <option>--clusters</option> option will group modules from <link linkend=\"moduleset-syntax-defs-metamodule\">metamodules</link> together."
980 #: C/jhbuild.xml:791(para)
981 msgid "The output of this command can easily be piped to the <command>dot</command> utility to generate a PostScript file:"
984 #: C/jhbuild.xml:795(userinput)
986 msgid "jhbuild dot <placeholder-1/> | dot -Tps > dependencies.ps"
989 #: C/jhbuild.xml:797(para)
990 msgid "Or a PNG image:"
993 #: C/jhbuild.xml:799(userinput)
995 msgid "jhbuild dot <placeholder-1/> | dot -Tpng > dependencies.png"
998 #: C/jhbuild.xml:802(title)
999 msgid "Sample JHBuild dot output"
1002 #: C/jhbuild.xml:815(title)
1006 #: C/jhbuild.xml:817(para)
1007 msgid "The <command>gui</command> command starts a graphical interface to JHBuild which can be used to select modules to build and change some options."
1010 #: C/jhbuild.xml:822(command)
1014 #: C/jhbuild.xml:825(para)
1015 msgid "The <command>gui</command> graphical interface is rendered using GTK, so some extra support libraries will be required"
1018 #: C/jhbuild.xml:831(title)
1022 #: C/jhbuild.xml:833(para)
1023 msgid "The <command>info</command> command is used to display information about one or more modules."
1026 #: C/jhbuild.xml:837(command)
1027 msgid "jhbuild info"
1030 #: C/jhbuild.xml:841(para)
1031 msgid "The command prints the module name, type, dependencies, dependent packages, and the time it was last installed with JHBuild. It may also print some information specific to the module type, such as the CVS repository or download URL."
1034 #: C/jhbuild.xml:846(para)
1035 msgid "If there is no module specified the command will print information about all the modules defined in the module set."
1038 #: C/jhbuild.xml:852(title)
1042 #: C/jhbuild.xml:854(para)
1043 msgid "The <command>list</command> command is used to show the expanded list of modules the <command>build</command> command would build."
1046 #: C/jhbuild.xml:858(para)
1047 msgid "Run with the <option>-a</option> option, this command will list all the modules known from your moduleset configuration regardless of the build dependency."
1050 #: C/jhbuild.xml:864(arg)
1054 #: C/jhbuild.xml:865(arg)
1058 #: C/jhbuild.xml:866(arg)
1062 #: C/jhbuild.xml:868(arg)
1063 #: C/jhbuild.xml:915(option)
1064 msgid "--list-optional-modules"
1067 #: C/jhbuild.xml:877(term)
1068 msgid "<option>-a</option>, <option>--all-modules</option>"
1071 #: C/jhbuild.xml:880(simpara)
1072 msgid "List all the modules"
1075 #: C/jhbuild.xml:885(term)
1076 msgid "<option>-r</option>, <option>--show-revision</option>"
1079 #: C/jhbuild.xml:888(simpara)
1080 msgid "If a particular module is being checked out on a branch, show the branch tag name with the module name."
1083 #: C/jhbuild.xml:895(term)
1084 msgid "<option>s</option>, <option>--skip</option>=<replaceable>module,...</replaceable>"
1087 #: C/jhbuild.xml:899(simpara)
1088 msgid "Ignore the named modules when following dependencies to expand the list of modules."
1091 #: C/jhbuild.xml:908(simpara)
1092 msgid "Ignore modules that do not match any of <replaceable>tag</replaceable> when following dependencies to expand the list of modules to be displayed."
1095 #: C/jhbuild.xml:917(simpara)
1096 msgid "Some modules, listed as optional dependencies, may not be required to get to the target module, this option inncludes them nevertheless."
1099 #: C/jhbuild.xml:928(title)
1103 #: C/jhbuild.xml:930(para)
1104 msgid "The <command>rdepends</command> command is used to show the reverse-dependencies of a module."
1107 #: C/jhbuild.xml:934(command)
1108 msgid "jhbuild rdepends"
1111 #: C/jhbuild.xml:940(option)
1112 msgid "--dependencies"
1115 #: C/jhbuild.xml:942(simpara)
1116 msgid "Show dependency path next to modules."
1119 #: C/jhbuild.xml:947(option)
1123 #: C/jhbuild.xml:949(simpara)
1124 msgid "Limit display to modules directly depending on given module."
1127 #: C/jhbuild.xml:957(title)
1131 #: C/jhbuild.xml:959(para)
1132 msgid "The <command>run</command> command is used to run an arbitrary command using the same environment that JHBuild uses when building modules."
1135 #: C/jhbuild.xml:964(command)
1139 #: C/jhbuild.xml:965(arg)
1140 msgid "--in-builddir"
1143 #: C/jhbuild.xml:967(replaceable)
1147 #: C/jhbuild.xml:970(para)
1148 msgid "If using JHBuild to build GNOME, this command can be useful in X startup scripts."
1151 #: C/jhbuild.xml:975(term)
1152 msgid "<option>--in-builddir</option>=<replaceable>module</replaceable>"
1155 #: C/jhbuild.xml:977(simpara)
1156 msgid "Run the command in the build directory of the specified module."
1159 #: C/jhbuild.xml:986(title)
1163 #: C/jhbuild.xml:988(para)
1164 msgid "The <command>sanitycheck</command> command performs a number of checks to see whether the build environment is okay."
1167 #: C/jhbuild.xml:996(para)
1168 msgid "Some of the checks include:"
1171 #: C/jhbuild.xml:1000(simpara)
1172 msgid "That the checkout and install prefixes are writable."
1175 #: C/jhbuild.xml:1004(simpara)
1176 msgid "That some of the required build tools are installed."
1179 #: C/jhbuild.xml:1008(simpara)
1180 msgid "That some commonly used macros are available in the search paths of the <command>aclocal</command> commands associated with the various versions of <command>automake</command>."
1183 #: C/jhbuild.xml:1014(simpara)
1184 msgid "That the XML catalog contains the DocBook DTD and stylesheets."
1187 #: C/jhbuild.xml:1022(title)
1191 #: C/jhbuild.xml:1024(para)
1192 msgid "The <command>shell</command> command starts the user's shell with the same environment as JHBuild uses when building modules."
1195 #: C/jhbuild.xml:1032(para)
1196 msgid "This command is roughly equivalent to the following:"
1199 #: C/jhbuild.xml:1035(userinput)
1201 msgid "jhbuild run $SHELL"
1204 #: C/jhbuild.xml:1039(title)
1208 #: C/jhbuild.xml:1041(para)
1209 msgid "The <command>tinderbox</command> command is similar to <command>build</command>, but writes all terminal output to HTML files suitable for publishing on a website. It can be used to set up systems similar to Mozilla's Tinderbox, or Debian's Buildd."
1212 #: C/jhbuild.xml:1048(command)
1213 msgid "jhbuild tinderbox"
1216 #: C/jhbuild.xml:1052(replaceable)
1220 #: C/jhbuild.xml:1052(arg)
1221 msgid "--output=<placeholder-1/>"
1224 #: C/jhbuild.xml:1056(arg)
1228 #: C/jhbuild.xml:1057(arg)
1232 #: C/jhbuild.xml:1061(para)
1233 msgid "The <option>--autogen</option>, <option>--clean</option>, <option>--no-network</option>, <option>--skip</option>, <option>--start-at</option>, <option>-D</option>, <option>-C</option> and <option>-N</option> options are processed the same as for <command>build</command>."
1236 #: C/jhbuild.xml:1069(term)
1237 msgid "<option>-o</option>, <option>--output</option>=<replaceable>directory</replaceable>"
1240 #: C/jhbuild.xml:1072(simpara)
1241 msgid "The directory to write the HTML build logs."
1244 #: C/jhbuild.xml:1081(title)
1248 #: C/jhbuild.xml:1083(para)
1249 msgid "The <command>update</command> command is similar to <command>build</command>, but only performs the download or update stage for modules without building them."
1252 #: C/jhbuild.xml:1096(para)
1253 msgid "The <option>--skip</option>, <option>--start-at</option>, <option>--tags</option> and <option>-D</option> options are processed the same as for <command>build</command>."
1256 #: C/jhbuild.xml:1103(title)
1260 #: C/jhbuild.xml:1105(para)
1261 msgid "The <command>updateone</command> command is similar to <command>update</command>, but it does not use dependency information to expand the module list. It is useful for quickly updating one or more modules."
1264 #: C/jhbuild.xml:1111(command)
1265 msgid "jhbuild updateone"
1268 #: C/jhbuild.xml:1116(para)
1269 msgid "The <option>-D</option> option is processed the same as for <command>update</command>."
1272 #: C/jhbuild.xml:1119(para)
1273 msgid "Unlike the <command>update</command> command, at least one module must be listed on the command line."
1276 #: C/jhbuild.xml:1126(title)
1277 msgid "Configuration File Reference"
1280 #: C/jhbuild.xml:1128(para)
1281 msgid "The <filename>~/.jhbuildrc</filename> file uses standard Python syntax. The file is run, and the resulting variables defined in the namespace are used to control how JHBuild acts. A set of default values are inserted into the namespace before running the user's configuration file."
1284 #: C/jhbuild.xml:1135(title)
1285 msgid "Configuration Variables"
1288 #: C/jhbuild.xml:1140(varname)
1289 msgid "alwaysautogen"
1292 #: C/jhbuild.xml:1142(simpara)
1293 msgid "If set to <constant>True</constant>, then always run <command>autogen.sh</command> before <command>make</command>, even if a makefile exists. This is equivalent to passing <option>--always-autogen</option> option to JHBuild. Defaults to <constant>False</constant>."
1296 #: C/jhbuild.xml:1153(simpara)
1297 msgid "A string containing arguments passed to the <command>autogen.sh</command> script of all modules. Can be overriden for particular modules using the <varname>module_autogenargs</varname> dictionary."
1300 #: C/jhbuild.xml:1161(varname)
1304 #: C/jhbuild.xml:1163(simpara)
1305 msgid "A dictionary that can be used to override the branch used for a particular module. This is useful if you are making some changes on a branch of a module and want JHBuild to build that branch instead of the one listed in the module set."
1308 #: C/jhbuild.xml:1171(varname)
1309 msgid "builddir_pattern"
1312 #: C/jhbuild.xml:1173(simpara)
1313 msgid "A <function>printf</function> style formatting pattern used to generate build directory names. This is only used when using separate source and build trees. The <literal>%s</literal> in the format string will be replaced with the source directory name. Defaults to <literal>'%s'</literal>."
1316 #: C/jhbuild.xml:1182(varname)
1320 #: C/jhbuild.xml:1184(simpara)
1321 msgid "A string giving the parent directory to place build trees. Defaults to <constant>None</constant>, which causes builds to be performed within the source trees."
1324 #: C/jhbuild.xml:1191(varname)
1328 #: C/jhbuild.xml:1193(simpara)
1329 msgid "A string specifying which buildscript to use. This should probably be left as the default, <literal>terminal</literal>. In particular, do not set to <literal>gtk</literal>."
1332 #: C/jhbuild.xml:1200(varname)
1333 msgid "build_policy"
1336 #: C/jhbuild.xml:1202(simpara)
1337 msgid "A string specifying which modules to build. The three possible options are <literal>all</literal>, to build all modules requested, <literal>updated</literal> to build only modules which have changed, or <literal>updated-deps</literal> to build modules which have changed or which have dependencies which have changed. Defaults to <literal>all</literal>."
1340 #: C/jhbuild.xml:1214(simpara)
1341 msgid "A string giving the directory to unpack source trees to. Unless <varname>buildroot</varname> is set, builds will occur in this directory too. Defaults to <filename>~/cvs/gnome2</filename>."
1344 #: C/jhbuild.xml:1221(varname)
1345 msgid "checkout_mode"
1348 #: C/jhbuild.xml:1223(simpara)
1349 msgid "A string specifying how the checkout is done for directories in version control. Defaults to <literal>update</literal>. This can be set per module using <varname>module_checkout_mode</varname>."
1352 #: C/jhbuild.xml:1230(varname)
1356 #: C/jhbuild.xml:1232(simpara)
1357 msgid "A string specifying the directory to copy to, if the copy checkout mode is in use. Defaults to the checkout directory."
1360 #: C/jhbuild.xml:1238(varname)
1364 #: C/jhbuild.xml:1240(simpara)
1365 msgid "A dictionary that can be used to change the CVS roots used to check out source code. If you have a CVS account for a particular project, you can set the associated key to use that account rather than the anonymous account. For example, you might want to set <literal>'gnome.org'</literal> to <literal>':ext:<replaceable>username</replaceable>@cvs.gnome.org:/cvs/gnome'</literal>."
1368 #: C/jhbuild.xml:1250(varname)
1372 #: C/jhbuild.xml:1252(simpara)
1373 msgid "A string specifying which program to use for CVS support. Defaults to <literal>cvs</literal>."
1376 #: C/jhbuild.xml:1257(varname)
1380 #: C/jhbuild.xml:1259(simpara)
1381 msgid "A boolean value specifying whether to interact with the user. Setting this value to <constant>False</constant> is equivalent to passing the <option>--no-interact</option> option. Defaults to <constant>True</constant>"
1384 #: C/jhbuild.xml:1269(simpara)
1385 msgid "A string listing additional arguments to be passed to <command>make</command>. Defaults to <literal>''</literal>."
1388 #: C/jhbuild.xml:1275(varname)
1392 #: C/jhbuild.xml:1277(simpara)
1393 msgid "A boolean value specifying whether to run <command>make check</command> after <command>make</command>. Defaults to <constant>False</constant>."
1396 #: C/jhbuild.xml:1284(varname)
1397 msgid "makecheck_advisory"
1400 #: C/jhbuild.xml:1286(simpara)
1401 msgid "A boolean value specifying whether failures when running <command>make check</command> should be advisory only and not cause a build failure. Defaults to <constant>False</constant>."
1404 #: C/jhbuild.xml:1292(varname)
1408 #: C/jhbuild.xml:1294(simpara)
1409 msgid "A boolean value specifying whether to run <command>make clean</command> before <command>make</command>. Defaults to <constant>False</constant>."
1412 #: C/jhbuild.xml:1301(varname)
1416 #: C/jhbuild.xml:1303(simpara)
1417 msgid "A boolean value specifying whether to run <command>make dist</command> after <command>make</command>. Defaults to <constant>False</constant>. This setting is equivalent to passing the <option>--dist</option> option."
1420 #: C/jhbuild.xml:1311(varname)
1421 msgid "makedistcheck"
1424 #: C/jhbuild.xml:1313(simpara)
1425 msgid "A boolean value specifying whether to run <command>make distcheck</command> after <command>make</command>. Defaults to <constant>False</constant>. This setting is equivalent to passing the <option>--distcheck</option> option."
1428 #: C/jhbuild.xml:1321(varname)
1429 msgid "module_autogenargs"
1432 #: C/jhbuild.xml:1323(simpara)
1433 msgid "A dictionary mapping module names to strings giving arguments to be passed to <command>autogen.sh</command>. The setting in <varname>module_autogenargs</varname> is used instead of the global <varname>autogenargs</varname> setting. If a particular module isn't listed in the dictionary, the global <varname>autogenargs</varname> will be used instead."
1436 #: C/jhbuild.xml:1334(varname)
1437 msgid "module_checkout_mode"
1440 #: C/jhbuild.xml:1336(simpara)
1441 msgid "A dictionary specifying which checkout mode to use for modules. This overrides the global <varname>checkout_mode</varname> setting."
1444 #: C/jhbuild.xml:1342(varname)
1445 msgid "module_makeargs"
1448 #: C/jhbuild.xml:1344(simpara)
1449 msgid "A dictionary mapping module names to strings giving arguments to be passed to <command>make</command>. The setting in <varname>module_makeargs</varname> replaces the value of <varname>makeargs</varname>. If a particular module isn't listed in the dictionary, the global <varname>makeargs</varname> will be used instead."
1452 #: C/jhbuild.xml:1354(varname)
1453 msgid "module_extra_env"
1456 #: C/jhbuild.xml:1356(simpara)
1457 msgid "A dictionary mapping module names to dictionaries with extra environment variables to pass when executing commands for the module."
1460 #: C/jhbuild.xml:1365(simpara)
1461 msgid "A list of module names to build. This list will be expanded using the dependency information found in the module set. Defaults to <literal>[ 'meta-gnome-desktop' ]</literal>."
1464 #: C/jhbuild.xml:1374(simpara)
1465 msgid "A string giving the name of the module set to use. This can either be the filename of a moduleset included with JHBuild (excluding the path and extension), or a full HTTP URL to refer to an externally managed module set. Currently defaults to <literal>'gnome-2.22'</literal>, but is usually updated as GNOME development progresses."
1468 #: C/jhbuild.xml:1384(varname)
1472 #: C/jhbuild.xml:1386(simpara)
1473 msgid "A boolean value which, if set to <constant>True</constant> causes JHBuild to not actually modules, but just download and unpack the sources. The default vale is <constant>False</constant>."
1476 #: C/jhbuild.xml:1393(varname)
1480 #: C/jhbuild.xml:1395(simpara)
1481 msgid "A boolean value specifying whether to access the network or not. This affects checking out or updating CVS modules, downloading tarballs and updating module sets. Setting this to <constant>True</constant> is equivalent to passing the <option>--no-network</option> option to JHBuild. Defaults to <constant>False</constant>."
1484 #: C/jhbuild.xml:1405(varname)
1488 #: C/jhbuild.xml:1407(simpara)
1489 msgid "A boolean value specifying whether to emit notifications using the notification daemon. If set to <constant>True</constant>, notifications are not emitted. Defaults to <constant>False</constant>."
1492 #: C/jhbuild.xml:1414(varname)
1496 #: C/jhbuild.xml:1416(simpara)
1497 msgid "A boolean value which, if set to <constant>True</constant> causes JHBuild to try to build modules even if one or more of the module's dependancies failed to build. This option is equivalent to the <option>--no-poison</option> argument. The default value is <constant>False</constant>."
1500 #: C/jhbuild.xml:1425(varname)
1504 #: C/jhbuild.xml:1427(simpara)
1505 msgid "A boolean value which, if set to <constant>True</constant> causes JHBuild to run any graphical tests on the real X server, rather than using <command>Xvfb</command>. This option is equivalent to passing <option>--no-xvfb</option>. The default value is <constant>False</constant>"
1508 #: C/jhbuild.xml:1438(simpara)
1509 msgid "A string giving the prefix to install modules to. Defaults to <literal>'/opt/gnome2'</literal>."
1512 #: C/jhbuild.xml:1443(varname)
1513 msgid "pretty_print"
1516 #: C/jhbuild.xml:1445(simpara)
1517 msgid "A boolean value that can be used to disable pretty formatting of subprocess output. Currently there is only support for pretty printing CVS output. You probably only want to disable this if the pretty printing causes problems. Defaults to <literal>True</literal>."
1520 #: C/jhbuild.xml:1453(varname)
1521 msgid "progress_bar"
1524 #: C/jhbuild.xml:1455(simpara)
1525 msgid "A boolean value that can be used to display a progress bar when running in quiet mode (see below). Defaults to <literal>True</literal>."
1528 #: C/jhbuild.xml:1461(varname)
1532 #: C/jhbuild.xml:1463(simpara)
1533 msgid "A boolean value that can be used to disable output of running commands. Defaults to <literal>False</literal>."
1536 #: C/jhbuild.xml:1485(simpara)
1537 msgid "A list of modules to skip when expanding the list of modules to build. This is similar to the <option>--skip</option> option (in fact, the <option>--skip</option> option extends this list). This list is empty by default."
1540 #: C/jhbuild.xml:1493(varname)
1544 #: C/jhbuild.xml:1495(simpara)
1545 msgid "If set, JHBuild will attempt to check out modules as they existed at the given date. The date should be given in the form <literal>'<replaceable>yyyy</replaceable>-<replaceable>mm</replaceable>-<replaceable>dd</replaceable>'</literal>. Defaults to <constant>None</constant>."
1548 #: C/jhbuild.xml:1503(varname)
1552 #: C/jhbuild.xml:1505(simpara)
1553 msgid "Similar to <varname>cvsroots</varname> but for Subversion repositories."
1556 #: C/jhbuild.xml:1510(varname)
1560 #: C/jhbuild.xml:1512(simpara)
1561 msgid "A string specifying which program to use for subversion support. This can be <literal>svn</literal> or <literal>bzr</literal>. Defaults to <literal>svn</literal>."
1564 #: C/jhbuild.xml:1519(varname)
1568 #: C/jhbuild.xml:1521(simpara)
1569 msgid "If set, tarballs will be downloaded to this directory instead of <varname>checkoutroot</varname>. This is useful if you have multiple JHBuild environments or regularly clear out your <varname>checkoutroot</varname> and want to reduce bandwidth usage."
1572 #: C/jhbuild.xml:1530(varname)
1573 msgid "tinderbox_outputdir"
1576 #: C/jhbuild.xml:1532(simpara)
1577 msgid "A string giving the directory to store <command>jhbuild tinderbox</command> output. This string can be overridden by the <option>--output</option> option. Defaults to <constant>None</constant>, so either the command line option must be used or this variable must be set in the configuration file."
1580 #: C/jhbuild.xml:1541(varname)
1584 #: C/jhbuild.xml:1543(simpara)
1585 msgid "A boolean option which if set to <constant>True</constant>, causes JHBuild to try checking out a newer version of a module from version control and running <command>autogen.sh</command>, if the module fails to build. This option is equivalent to passing <option>--try-checkout</option>."
1588 #: C/jhbuild.xml:1552(varname)
1592 #: C/jhbuild.xml:1554(simpara)
1593 msgid "A boolean value that specifies whether to install libraries to <filename>lib64</filename> directories. If this is set, <literal>--libdir=\\${exec_prefix}/lib64</literal> will be passed to configure. Defaults to <constant>True</constant> if running on <literal>x86_64</literal>, <literal>ppc64</literal> or <literal>s390x</literal> Linux, and <constant>False</constant> on other systems."
1596 #: C/jhbuild.xml:1566(varname)
1600 #: C/jhbuild.xml:1568(simpara)
1601 msgid "A string listing arguments to pass to <command>Xvfb</command> if running graphical tests using it."
1604 #: C/jhbuild.xml:1577(title)
1605 msgid "Other Configuration File Structures"
1608 #: C/jhbuild.xml:1579(para)
1609 msgid "In addition to the above variables, there are some other things that can be set in the configuration file:"
1612 #: C/jhbuild.xml:1586(para)
1613 msgid "This is dictionary represents the environment of the process (which also gets passed on to processes that JHBuild spawns)."
1616 #: C/jhbuild.xml:1589(para)
1617 msgid "Some environment variables you may want to set include <envar>CFLAGS</envar>, <envar>INSTALL</envar> (to use the more efficient <command>install-check</command> program included with JHBuild) and <envar>LDFLAGS</envar>."
1620 #: C/jhbuild.xml:1597(term)
1621 msgid "<function>addpath</function>(<parameter>envvar</parameter>, <parameter>pathname</parameter>)"
1624 #: C/jhbuild.xml:1600(para)
1625 msgid "This will add a directory to a <envar>PATH</envar>-style environment variable. It will correctly handle the case when the environment variable is initially empty (having a stray colon at the beginning or end of an environment variable can have unexpected consequences)."
1628 #: C/jhbuild.xml:1606(para)
1629 msgid "This function has special handling for the <envar>ACLOCAL_FLAGS</envar> environment variable, which expects paths to be listed in the form <literal>-I <replaceable>pathname</replaceable></literal>."
1632 #: C/jhbuild.xml:1613(term)
1633 msgid "<function>prependpath</function>(<parameter>envvar</parameter>, <parameter>pathname</parameter>)"
1636 #: C/jhbuild.xml:1616(para)
1637 msgid "After processing the configuration file, JHBuild will alter some paths based on variables such as <varname>prefix</varname> (eg. adding <literal>$prefix/bin</literal> to the start of <envar>PATH</envar>)."
1640 #: C/jhbuild.xml:1621(para)
1641 msgid "The <function>prependpath</function> function works like <function>addpath</function>, except that the environment variable is modified after JHBuild has made its changes to the environment."
1644 #: C/jhbuild.xml:1632(title)
1645 msgid "Module Set File Syntax"
1648 #: C/jhbuild.xml:1634(para)
1649 msgid "JHBuild uses XML files to describe the dependencies between modules. A RELAX-NG schema and Document Type Definition are included with JHBuild in the <filename>modulesets/</filename> directory. The RELAX-NG schema can be used to edit module set files using <literal>nxml-mode</literal> in Emacs."
1652 #: C/jhbuild.xml:1640(para)
1653 msgid "The toplevel element in a module set file is <sgmltag class=\"element\">moduleset</sgmltag> element. Currently no XML namespace is used, but in the future this might change. The elements below the toplevel come in three types: module sources, include statements and module definitions."
1656 #: C/jhbuild.xml:1647(title)
1657 #: C/jhbuild.xml:2262(title)
1658 msgid "Module Sources"
1661 #: C/jhbuild.xml:1649(para)
1662 msgid "Rather than listing the full location of every module, a number of \"module sources\" are listed in the module set, and then referenced by name in the module definitions. As well as reducing the amount of redundant information in the module set, it makes it easy for a user to specify an alternative source for those modules (for CVS and Subversion, it is common for developers and users to use different repository access methods)."
1665 #: C/jhbuild.xml:1658(para)
1666 msgid "The <sgmltag class=\"element\">repository</sgmltag> element is used to describe all types of repository."
1669 #: C/jhbuild.xml:1661(programlisting)
1673 "<repository name=\"<replaceable>name</replaceable>\"\n"
1674 " type=\"<replaceable>type</replaceable>\"\n"
1675 " [ default=\"<replaceable>default</replaceable>\" ]\n"
1676 " [ password=\"<replaceable>password</replaceable>\" ]\n"
1677 " [ cvsroot=\"<replaceable>cvsroot</replaceable>\" ]\n"
1678 " [ archive=\"<replaceable>archive</replaceable>\" ]\n"
1679 " [ href=\"<replaceable>href</replaceable>\" ]\n"
1680 " [ server=\"<replaceable>server</replaceable>\" ]\n"
1681 " [ database=\"<replaceable>database</replaceable>\" ]\n"
1682 " [ defbranch=\"<replaceable>defbranch</replaceable>\" ]\n"
1683 " [ developer-href-example=\"<replaceable>developer-href-example</replaceable>\" ] />\n"
1686 #: C/jhbuild.xml:1675(para)
1687 msgid "The <sgmltag class=\"attribute\">name</sgmltag> attribute is a unique identifier for the repository."
1690 #: C/jhbuild.xml:1678(para)
1691 msgid "The <sgmltag class=\"attribute\">default</sgmltag> attribute specifies whether this repository is the default source for this module set."
1694 #: C/jhbuild.xml:1682(para)
1695 msgid "The <sgmltag class=\"attribute\">type</sgmltag> attribute specifies the type of repository. It can be one of: <literal>arch</literal>, <literal>bzr</literal>, <literal>cvs</literal>, <literal>darcs</literal>, <literal>git</literal>, <literal>hg</literal>, <literal>mtr</literal>, <literal>svn</literal>, <literal>tarball</literal>. Other attributes depends on the <sgmltag class=\"attribute\">type</sgmltag>, as well as the <sgmltag class=\"element\">branch</sgmltag> used inside module definitions. Those are described below."
1698 #: C/jhbuild.xml:1693(para)
1699 msgid "The <sgmltag class=\"attribute\">developer-href-example</sgmltag> attribute is used to specify the format of the URL for the repository used by developers. This is informational only."
1702 #: C/jhbuild.xml:1698(title)
1706 #: C/jhbuild.xml:1700(para)
1707 msgid "This repository type is used to define a Arch repository."
1710 #: C/jhbuild.xml:1702(para)
1711 msgid "The <sgmltag class=\"attribute\">archive</sgmltag> attribute is used to specify the archive to use."
1714 #: C/jhbuild.xml:1705(para)
1715 msgid "The <sgmltag class=\"attribute\">href</sgmltag> attribute is used to specify the URL of the repository."
1718 #: C/jhbuild.xml:1708(programlisting)
1722 "<repository type=\"arch\" name=\"rhythmbox\"\n"
1723 " archive=\"rhythmbox-devel@gnome.org--2004\"\n"
1724 " href=\"http://web.rhythmbox.org/arch/2004\"/>\n"
1727 #: C/jhbuild.xml:1717(title)
1731 #: C/jhbuild.xml:1718(para)
1732 msgid "This repository type is used to define a Bazaar repository."
1735 #: C/jhbuild.xml:1720(programlisting)
1739 "<repository type=\"bzr\" name=\"launchpad.net\"\n"
1740 " href=\"http://bazaar.launchpad.net/\"/>\n"
1743 #: C/jhbuild.xml:1727(title)
1747 #: C/jhbuild.xml:1728(para)
1748 msgid "This repository type is used to define a CVS repository."
1751 #: C/jhbuild.xml:1730(para)
1752 msgid "The <sgmltag class=\"attribute\">password</sgmltag> attribute is used to specify the password to the repository."
1755 #: C/jhbuild.xml:1734(para)
1756 msgid "The <sgmltag class=\"attribute\">cvsroot</sgmltag> attribute is used to specify the root of the repository."
1759 #: C/jhbuild.xml:1738(programlisting)
1763 "<repository type=\"cvs\" name=\"tango.freedesktop.org\"\n"
1764 " cvsroot=\":pserver:anoncvs@anoncvs.freedesktop.org:/cvs/tango\"\n"
1765 " password=\"\"/>\n"
1768 #: C/jhbuild.xml:1747(title)
1772 #: C/jhbuild.xml:1748(para)
1773 msgid "This repository type is used to define a Darcs repository."
1776 #: C/jhbuild.xml:1750(programlisting)
1780 "<repository type=\"darcs\" name=\"telepathy.freedesktop.org\"\n"
1781 " href=\"http://projects.collabora.co.uk/darcs/telepathy/\"/>\n"
1784 #: C/jhbuild.xml:1757(title)
1788 #: C/jhbuild.xml:1758(para)
1789 msgid "This repository type is used to define a Git repository."
1792 #: C/jhbuild.xml:1760(programlisting)
1796 "<repository type=\"git\" name=\"git.freedesktop.org\"\n"
1797 " href=\"git://anongit.freedesktop.org/git/\"/>\n"
1800 #: C/jhbuild.xml:1765(programlisting)
1804 "<branch repo=\"git.freedesktop.org\" module=\"swfdec/swfdec\"\n"
1805 " checkoutdir=\"swfdec\"/>\n"
1808 #: C/jhbuild.xml:1774(title)
1812 #: C/jhbuild.xml:1775(para)
1813 msgid "This repository type is used to define a Mercurial repository."
1816 #: C/jhbuild.xml:1777(programlisting)
1820 "<repository type=\"hg\" name=\"hg.gtk-vnc\"\n"
1821 " href=\"http://gtk-vnc.codemonkey.ws/hg/\" />\n"
1824 #: C/jhbuild.xml:1782(programlisting)
1828 "<branch repo=\"hg.gtk-vnc\" module=\"outgoing.hg\" checkoutdir=\"gtk-vnc\"/>\n"
1831 #: C/jhbuild.xml:1789(title)
1835 #: C/jhbuild.xml:1790(para)
1836 msgid "This repository type is used to define a Monotone repository."
1839 #: C/jhbuild.xml:1792(para)
1840 msgid "The <sgmltag class=\"attribute\">server</sgmltag> attribute is used to specify the repository server."
1843 #: C/jhbuild.xml:1795(para)
1844 msgid "The <sgmltag class=\"attribute\">database</sgmltag> attribute is used to specify the database to use for the repository."
1847 #: C/jhbuild.xml:1799(para)
1848 msgid "The <sgmltag class=\"attribute\">defbranch</sgmltag> attribute is used specify the branch of the repository to use."
1851 #: C/jhbuild.xml:1803(programlisting)
1855 "<repository type=\"mtn\" name=\"pidgin.im\"\n"
1856 " server=\"pidgin.im\" database=\"pidgin.im.mtn\"\n"
1857 " defbranch=\"im.pidgin.pidgin\"/>\n"
1860 #: C/jhbuild.xml:1812(title)
1864 #: C/jhbuild.xml:1813(para)
1865 msgid "This repository type is used to define a Subversion repository."
1868 #: C/jhbuild.xml:1815(programlisting)
1872 "<repository type=\"svn\" name=\"svn.gnome.org\" default=\"yes\"\n"
1873 " href=\"http://svn.gnome.org/svn/\"/>\n"
1876 #: C/jhbuild.xml:1820(para)
1877 msgid "It allows a <sgmltag class=\"attribute\">revision</sgmltag> on the <sgmltag class=\"element\">branch</sgmltag> element. This attribute defines the branch to checkout or, if it is a number, a specific revision to checkout."
1880 #: C/jhbuild.xml:1825(programlisting)
1884 "<branch revision=\"gnome-2-20\"/>\n"
1887 #: C/jhbuild.xml:1832(title)
1891 #: C/jhbuild.xml:1833(para)
1892 msgid "This repository type is used to define a tarball repository."
1895 #: C/jhbuild.xml:1835(programlisting)
1899 "<repository type=\"tarball\" name=\"dbus/dbus-python\"\n"
1900 " href=\"http://dbus.freedesktop.org/releases/dbus-python/\"/>\n"
1903 #: C/jhbuild.xml:1840(para)
1904 msgid "It allows the following attributes on the <sgmltag class=\"element\">branch</sgmltag> element:"
1907 #: C/jhbuild.xml:1843(para)
1908 msgid "The <sgmltag class=\"attribute\">module</sgmltag> attribute specifies the file to download and compile, the <sgmltag class=\"attribute\">version</sgmltag> attribute specifies the module version."
1911 #: C/jhbuild.xml:1848(para)
1912 msgid "The <sgmltag class=\"attribute\">size</sgmltag> and <sgmltag class=\"attribute\">md5sum</sgmltag> attributes are optional. If these two attributes are present, they are used to check that the source package was downloaded correctly."
1915 #: C/jhbuild.xml:1853(para)
1916 #: C/jhbuild.xml:2565(para)
1917 msgid "The <sgmltag class=\"element\">patches</sgmltag> element is used to specify one or more patches to apply to the source tree after unpacking, the <sgmltag class=\"attribute\">file</sgmltag> attribute gives the patch filename, and the <sgmltag class=\"attribute\">strip</sgmltag> attribute says how many levels of directories to prune when applying the patch."
1920 #: C/jhbuild.xml:1861(para)
1921 #: C/jhbuild.xml:2573(para)
1922 msgid "For module sets shipped with JHbuild, the patch files are looked up in the <filename>jhbuild/patches/</filename> directory; for module sets referred by URI, the patch files are looked for in the same directory as the moduleset file, or in its <filename>patches/</filename> subdirectory. It is also possible for the <sgmltag class=\"attribute\">file</sgmltag> attribute to specify a URI, in which case it will be downloaded from that location."
1925 #: C/jhbuild.xml:1870(programlisting)
1929 "<branch module=\"dbus-python-0.80.2.tar.gz\" version=\"0.80.2\"\n"
1930 " repo=\"dbus/dbus-python\"\n"
1931 " md5sum=\"2807bc85215c995bd595e01edd9d2077\" size=\"453499\">\n"
1932 " <patches>\n"
1933 " <patch file=\"dbus-glib-build.patch\" strip=\"1\" />\n"
1934 " </patches>\n"
1938 #: C/jhbuild.xml:1885(title)
1939 msgid "Including Other Module Sets"
1942 #: C/jhbuild.xml:1887(para)
1943 msgid "JHBuild allows one module set to include the contents of another by reference using the <sgmltag class=\"element\">include</sgmltag> element."
1946 #: C/jhbuild.xml:1891(programlisting)
1950 "<include href=\"<replaceable>uri</replaceable>\"/>\n"
1953 #: C/jhbuild.xml:1895(para)
1954 msgid "The <sgmltag class=\"attribute\">href</sgmltag> is a URI reference to the module set to be included, relative to the file containing the <sgmltag class=\"element\">include</sgmltag> element."
1957 #: C/jhbuild.xml:1900(para)
1958 msgid "Only module definitions are imported from the referenced module set - module sources are not. Multiple levels of includes are allowed, but include loops are not (there isn't any code to handle loops at the moment)."
1961 #: C/jhbuild.xml:1907(title)
1962 msgid "Module Definitions"
1965 #: C/jhbuild.xml:1909(para)
1966 msgid "There are various types of module definitions that can be used in a module set file, and the list can easily be extended. Only the most common ones will be mentioned here."
1969 #: C/jhbuild.xml:1913(para)
1970 msgid "They are all basically composed of a <sgmltag class=\"element\">branch</sgmltag> element describing how to get the module and <sgmltag class=\"element\">dependencies</sgmltag>, <sgmltag class=\"element\">suggests</sgmltag> and <sgmltag class=\"element\">after</sgmltag> elements to declare the dependencies of the module."
1973 #: C/jhbuild.xml:1920(para)
1974 msgid "Any modules listed in the <sgmltag class=\"element\">dependencies</sgmltag> element will be added to the module list for <command>jhbuild build</command> if it isn't already included, and make sure the dependent modules are built first."
1977 #: C/jhbuild.xml:1926(para)
1978 msgid "After generating the modules list, the modules listed in the <sgmltag class=\"element\">suggests</sgmltag> element will be used to further sort the modules list (although it will not pull any additional modules). This is intended for cases where a module has an optional dependency on another module."
1981 #: C/jhbuild.xml:1934(title)
1985 #: C/jhbuild.xml:1936(para)
1986 msgid "The <sgmltag class=\"element\">autotools</sgmltag> element is used to define a module which is compiled using the GNU Autotools build system."
1989 #: C/jhbuild.xml:1940(programlisting)
1993 "<autotools id=\"<replaceable>id</replaceable>\"\n"
1994 "\t [ autogenargs=\"<replaceable>autogenargs</replaceable>\" ]\n"
1995 "\t [ makeargs=\"<replaceable>makeargs</replaceable>\" ]\n"
1996 "\t [ makeinstallargs=\"<replaceable>makeinstallargs</replaceable>\" ]\n"
1997 "\t [ autogen-sh=\"<replaceable>autogen-sh</replaceable>\" ]\n"
1998 "\t [ makefile=\"<replaceable>makefile</replaceable>\" ]\n"
1999 "\t [ skip-autogen=\"<replaceable>skip-autogen</replaceable>\" ]\n"
2000 "\t [ autogen-template=\"<replaceable>autogen-template</replaceable>\" ]\n"
2001 "\t [ supports-non-srcdir-builds=\"<replaceable>supports-non-srcdir-builds</replaceable>\" ]>\n"
2003 " <branch [ ... ] >\n"
2005 " </branch>\n"
2007 " <dependencies>\n"
2008 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2010 " </dependencies>\n"
2012 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2016 "</autotools>\n"
2019 #: C/jhbuild.xml:1967(para)
2020 msgid "The <sgmltag class=\"attribute\">autogenargs</sgmltag> and <sgmltag class=\"attribute\">makeargs</sgmltag> and <sgmltag class=\"attribute\">makeinstallargs</sgmltag> attributes are used to specify additional arguments to pass to <command>autogen.sh</command>, <command>make</command> and <command>make install</command> respectively."
2023 #: C/jhbuild.xml:1974(para)
2024 msgid "The <sgmltag class=\"attribute\">autogen-sh</sgmltag> attribute specifies the name of the autogen.sh script to run. The value <literal>autoreconf</literal> can be used if your module has no <command>autogen.sh</command> script equivalent. In that case, JHBuild will run <command>autoreconf -i</command>, followed by the proper <command>configure</command>. <sgmltag class=\"attribute\">skip-autogen</sgmltag> chooses whether or not to run autogen.sh. <sgmltag class=\"attribute\">makefile</sgmltag> specifies the filename of the makefile to use."
2027 #: C/jhbuild.xml:1987(para)
2028 msgid "The <sgmltag class=\"attribute\">supports-non-srcdir-builds</sgmltag> attribute is used to mark modules that can't be cleanly built using a separate source directory."
2031 #: C/jhbuild.xml:1992(para)
2032 msgid "The <sgmltag class=\"attribute\">autogen-template</sgmltag> attribute can be used if you need finer control over the autogen command line. It is a python format string, which will be substituted with the following variables: <varname>srcdir</varname>, <varname>autogen-sh</varname>, <varname>prefix</varname>, <varname>libdir</varname>, and <varname>autogenargs</varname>. For example, here is the default autogen-template:"
2035 #: C/jhbuild.xml:2001(programlisting)
2039 "%(srcdir)s/%(autogen-sh)s --prefix %(prefix)s --libdir %(libdir)s %(autogenargs)s\n"
2042 #: C/jhbuild.xml:2008(title)
2046 #: C/jhbuild.xml:2010(para)
2047 msgid "The <sgmltag class=\"element\">cmake</sgmltag> element is used to define a module which is built using the CMake build system."
2050 #: C/jhbuild.xml:2013(programlisting)
2054 "<cmake id=\"<replaceable>modulename</replaceable>\">\n"
2055 " <branch [ ... ] >\n"
2057 " </branch>\n"
2059 " <dependencies>\n"
2060 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2062 " </dependencies>\n"
2064 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2070 #: C/jhbuild.xml:2033(title)
2074 #: C/jhbuild.xml:2035(para)
2075 msgid "The <sgmltag class=\"element\">distutils</sgmltag> element is used to define a module which is built using python's distutils"
2078 #: C/jhbuild.xml:2039(programlisting)
2082 "<distutils id=\"<replaceable>modulename</replaceable>\"\n"
2083 " [ supports-non-srcdir-builds=\"<replaceable>yes|no</replaceable>\" ]>\n"
2084 " <branch [ ... ] >\n"
2086 " </branch>\n"
2088 " <dependencies>\n"
2089 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2091 " </dependencies>\n"
2093 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2096 "</distutils>\n"
2099 #: C/jhbuild.xml:2060(title)
2103 #: C/jhbuild.xml:2062(para)
2104 msgid "The <sgmltag class=\"element\">linux</sgmltag> element defines a module used to build a linux kernel. In addition, a separate kernel configuration can be chosen using the <sgmltag class=\"element\">kconfig</sgmltag> subelement."
2107 #: C/jhbuild.xml:2068(programlisting)
2111 "<linux id=\"<replaceable>id</replaceable>\"\n"
2112 "\t [ makeargs=\"<replaceable>makeargs</replaceable>\" ]>\n"
2114 " <branch [ ... ] >\n"
2116 " </branch>\n"
2118 " <dependencies>\n"
2119 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2121 " </dependencies>\n"
2123 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2127 " <kconfig [ repo=\"<replaceable>repo</replaceable>\" ]\n"
2128 "\t version=\"<replaceable>version</replaceable>\"\n"
2129 "\t [ module=\"<replaceable>module</replaceable>\" ]\n"
2130 "\t [ config=\"<replaceable>config</replaceable>\" ] />\n"
2135 #: C/jhbuild.xml:2096(title)
2139 #: C/jhbuild.xml:2098(para)
2140 msgid "The <sgmltag class=\"element\">perl</sgmltag> element is used to build perl modules."
2143 #: C/jhbuild.xml:2101(para)
2144 msgid "The <sgmltag class=\"attribute\">makeargs</sgmltag> attribute is used to specify additional arguments to pass to <command>make</command>."
2147 #: C/jhbuild.xml:2105(programlisting)
2151 "<perl id=\"<replaceable>modulename</replaceable>\"\n"
2152 "\t [ makeargs=\"<replaceable>makeargs</replaceable>\" ]>\n"
2154 " <branch [ ... ] >\n"
2156 " </branch>\n"
2158 " <dependencies>\n"
2159 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2161 " </dependencies>\n"
2163 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2170 #: C/jhbuild.xml:2127(title)
2174 #: C/jhbuild.xml:2129(para)
2175 msgid "The <sgmltag class=\"element\">waf</sgmltag> element is used to define a module which is built using the Waf build system."
2178 #: C/jhbuild.xml:2132(para)
2179 msgid "The <sgmltag class=\"attribute\">waf-command</sgmltag> attribute is used to specify the waf command script to use; it defaults to <command>waf</command>."
2182 #: C/jhbuild.xml:2136(programlisting)
2186 "<waf id=\"<replaceable>modulename</replaceable>\">\n"
2187 "\t [ waf-command=\"<replaceable>waf-command</replaceable>\" ]>\n"
2188 " <branch [ ... ] >\n"
2190 " </branch>\n"
2192 " <dependencies>\n"
2193 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2195 " </dependencies>\n"
2197 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2203 #: C/jhbuild.xml:2157(title)
2207 #: C/jhbuild.xml:2159(para)
2208 msgid "The <sgmltag class=\"element\">ant</sgmltag> element is used to define a module which is built using Ant, the Java based build tool."
2211 #: C/jhbuild.xml:2162(programlisting)
2215 "<ant id=\"<replaceable>modulename</replaceable>\">\n"
2216 " <branch [ ... ] >\n"
2218 " </branch>\n"
2220 " <dependencies>\n"
2221 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2223 " </dependencies>\n"
2225 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2231 #: C/jhbuild.xml:2180(title)
2232 msgid "Example of a module built with ant"
2235 #: C/jhbuild.xml:2194(title)
2239 #: C/jhbuild.xml:2196(para)
2240 msgid "The <sgmltag class=\"element\">testmodule</sgmltag> element is used to create a module which runs a suite of tests using LDTP or Dogtail."
2243 #: C/jhbuild.xml:2200(programlisting)
2247 "<testmodule id=\"<replaceable>id</replaceable>\"\n"
2248 "\t type=\"<replaceable>type</replaceable>\">\n"
2250 " <branch [ ... ] >\n"
2252 " </branch>\n"
2254 " <dependencies>\n"
2255 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2257 " </dependencies>\n"
2259 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2263 " <testedmodules>\n"
2264 " <tested package=\"<replaceable>package</replaceable>\" />\n"
2265 " </testedmodules>\n"
2267 "</testmodule>\n"
2270 #: C/jhbuild.xml:2227(title)
2274 #: C/jhbuild.xml:2229(para)
2275 msgid "The <sgmltag class=\"element\">metamodule</sgmltag> element defines a module that doesn't actually do anything. The only purpose of a module of this type is its dependencies."
2278 #: C/jhbuild.xml:2234(para)
2279 msgid "For example, meta-gnome-desktop depends on all the key components of the GNOME desktop, therefore telling JHBuild to install it actually installs the full desktop."
2282 #: C/jhbuild.xml:2238(programlisting)
2286 "<metamodule id=\"<replaceable>modulename</replaceable>\">\n"
2287 " <dependencies>\n"
2288 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2290 " </dependencies>\n"
2291 " <suggests>\n"
2292 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2294 " </suggests>\n"
2295 "</metamodule>\n"
2298 #: C/jhbuild.xml:2250(para)
2299 msgid "The <sgmltag class=\"attribute\">id</sgmltag> attribute gives the name of the module. The child elements are handled as for <link linkend=\"moduleset-syntax-defs-cvsmodule\"><sgmltag class=\"element\">cvsmodule</sgmltag></link>."
2302 #: C/jhbuild.xml:2259(title)
2303 msgid "Deprecated Elements"
2306 #: C/jhbuild.xml:2265(title)
2310 #: C/jhbuild.xml:2267(para)
2311 msgid "The <sgmltag class=\"element\">cvsroot</sgmltag> element is now deprecated - the <sgmltag class=\"element\">repository</sgmltag> element should be used instead."
2314 #: C/jhbuild.xml:2272(para)
2315 msgid "The <sgmltag class=\"element\">cvsroot</sgmltag> element is used to describe a CVS repository."
2318 #: C/jhbuild.xml:2275(programlisting)
2322 " <cvsroot name=\"<replaceable>rootname</replaceable>\"\n"
2323 " [ default=\"<replaceable>yes|no</replaceable>\" ]\n"
2324 " root=\"<replaceable>anon-cvsroot</replaceable>\"\n"
2325 " password=\"<replaceable>anon-password</replaceable>\"/>\n"
2328 #: C/jhbuild.xml:2282(para)
2329 msgid "The <sgmltag class=\"attribute\">name</sgmltag> attribute should be a unique identifier for the CVS repository."
2332 #: C/jhbuild.xml:2285(para)
2333 msgid "The <sgmltag class=\"attribute\">default</sgmltag> attribute says whether this is the default module source for this module set file."
2336 #: C/jhbuild.xml:2289(para)
2337 msgid "The <sgmltag class=\"attribute\">root</sgmltag> attribute lists the CVS root used for anonymous access to this repository, and the <sgmltag class=\"attribute\">password</sgmltag> attribute gives the password used for anonymous access."
2340 #: C/jhbuild.xml:2297(title)
2344 #: C/jhbuild.xml:2299(para)
2345 msgid "The <sgmltag class=\"element\">svnroot</sgmltag> element is now deprecated - the <sgmltag class=\"element\">repository</sgmltag> element should be used instead."
2348 #: C/jhbuild.xml:2304(para)
2349 msgid "The <sgmltag class=\"element\">svnroot</sgmltag> element is used to describe a Subversion repository."
2352 #: C/jhbuild.xml:2307(programlisting)
2356 " <svnroot name=\"<replaceable>rootname</replaceable>\"\n"
2357 " [ default=\"<replaceable>yes|no</replaceable>\" ]\n"
2358 " href=\"<replaceable>anon-svnroot</replaceable>\"/>\n"
2361 #: C/jhbuild.xml:2313(para)
2362 msgid "The <sgmltag class=\"attribute\">name</sgmltag> attribute should be a unique identifier for the Subversion repository."
2365 #: C/jhbuild.xml:2317(para)
2366 #: C/jhbuild.xml:2347(para)
2367 msgid "If <sgmltag class=\"attribute\">default</sgmltag> attribute says whether this is the default module source for this module set file."
2370 #: C/jhbuild.xml:2321(para)
2371 msgid "The <sgmltag class=\"attribute\">href</sgmltag> attribute lists the base URL for the repository. This will probably be either a <literal>http</literal>, <literal>https</literal> or <literal>svn</literal> URL."
2374 #: C/jhbuild.xml:2328(title)
2375 msgid "arch-archive"
2378 #: C/jhbuild.xml:2330(para)
2379 msgid "The <sgmltag class=\"element\">arch-archive</sgmltag> element is now deprecated - the <sgmltag class=\"element\">repository</sgmltag> element should be used instead."
2382 #: C/jhbuild.xml:2335(para)
2383 msgid "The <sgmltag class=\"element\">arch-archive</sgmltag> element is used to describe a GNU Arch archive."
2386 #: C/jhbuild.xml:2338(programlisting)
2390 " <arch-archive name=\"<replaceable>archivename</replaceable>\"\n"
2391 " [ default=\"<replaceable>yes|no</replaceable>\" ]\n"
2392 " href=\"<replaceable>mirror-url</replaceable>\"/>\n"
2395 #: C/jhbuild.xml:2344(para)
2396 msgid "The <sgmltag class=\"attribute\">name</sgmltag> attribute should be the Arch archive name."
2399 #: C/jhbuild.xml:2351(para)
2400 msgid "The <sgmltag class=\"attribute\">href</sgmltag> attribute lists a public mirror URL for the archive."
2403 #: C/jhbuild.xml:2357(title)
2404 msgid "Deprecated Module Types"
2407 #: C/jhbuild.xml:2360(para)
2408 msgid "This section describes deprecated elements, they may still be used in existing module sets but it is advised not to use them anymore."
2411 #: C/jhbuild.xml:2366(title)
2415 #: C/jhbuild.xml:2368(para)
2416 msgid "The <sgmltag class=\"element\">cvsmodule</sgmltag> element is now deprecated. The appropriate build system's module should be used instead."
2419 #: C/jhbuild.xml:2372(para)
2420 msgid "The <sgmltag class=\"element\">cvsmodule</sgmltag> element is used to define a module that is to be built from CVS."
2423 #: C/jhbuild.xml:2376(programlisting)
2427 " <cvsmodule module=\"<replaceable>modulename</replaceable>\"\n"
2428 " [ revision=\"<replaceable>branch-or-tag</replaceable>\" ]\n"
2429 " [ checkoutdir=\"<replaceable>directory</replaceable>\" ]\n"
2430 " [ root=\"<replaceable>rootname</replaceable>\" ]\n"
2431 " [ autogenargs=\"<replaceable>autogenargs</replaceable>\" ]\n"
2432 " [ makeargs=\"<replaceable>makeargs</replaceable>\" ]\n"
2433 " [ supports-non-srcdir-builds=\"<replaceable>yes|no</replaceable>\" ]>\n"
2434 " <dependencies>\n"
2435 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2437 " </dependencies>\n"
2438 " <suggests>\n"
2439 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2441 " </suggests>\n"
2443 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2446 " </cvsmodule>\n"
2449 #: C/jhbuild.xml:2399(para)
2450 msgid "The <sgmltag class=\"attribute\">module</sgmltag>, <sgmltag class=\"attribute\">revision</sgmltag> and <sgmltag class=\"attribute\">root</sgmltag> attributes identify the module to check out from CVS. The <sgmltag class=\"attribute\">checkoutdir</sgmltag> attribute can be used to specify an alternative directory to check out to (by default, the value of <sgmltag class=\"attribute\">module</sgmltag> is used)."
2453 #: C/jhbuild.xml:2408(para)
2454 msgid "The <sgmltag class=\"attribute\">autogenargs</sgmltag>, <sgmltag class=\"attribute\">makeargs</sgmltag> and <sgmltag class=\"attribute\">supports-non-srcdir-builds</sgmltag> attributes are common to many different module types. The <sgmltag class=\"attribute\">autogenargs</sgmltag> attribute lists additional arguments to be passed to <command>autogen.sh</command>, and <sgmltag class=\"attribute\">makeargs</sgmltag> lists additional arguments to be passed to <command>make</command>. The <sgmltag class=\"attribute\">supports-non-srcdir-builds</sgmltag> attribute is used to mark modules that can't be cleanly built using a separate source directory."
2457 #: C/jhbuild.xml:2422(para)
2458 msgid "The <sgmltag class=\"element\">dependencies</sgmltag>, <sgmltag class=\"element\">suggests</sgmltag> and <sgmltag class=\"element\">after</sgmltag> elements are processed as for <link linkend=\"moduleset-syntax-defs-autotools\">autotools</link>."
2461 #: C/jhbuild.xml:2432(title)
2465 #: C/jhbuild.xml:2434(para)
2466 msgid "The <sgmltag class=\"element\">svnmodule</sgmltag> element is now deprecated. The appropriate build system's module should be used instead."
2469 #: C/jhbuild.xml:2438(para)
2470 msgid "The <sgmltag class=\"element\">svnmodule</sgmltag> element is used to define a module that is to be built from Subversion."
2473 #: C/jhbuild.xml:2442(programlisting)
2477 " <svnmodule module=\"<replaceable>modulename</replaceable>\"\n"
2478 " [ checkoutdir=\"<replaceable>directory</replaceable>\" ]\n"
2479 " [ root=\"<replaceable>rootname</replaceable>\" ]\n"
2480 " [ autogenargs=\"<replaceable>autogenargs</replaceable>\" ]\n"
2481 " [ makeargs=\"<replaceable>makeargs</replaceable>\" ]\n"
2482 " [ supports-non-srcdir-builds=\"<replaceable>yes|no</replaceable>\" ]>\n"
2483 " <dependencies>\n"
2484 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2486 " </dependencies>\n"
2487 " <suggests>\n"
2488 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2490 " </suggests>\n"
2492 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2495 " </svnmodule>\n"
2498 #: C/jhbuild.xml:2463(para)
2499 msgid "The <sgmltag class=\"attribute\">module</sgmltag> attribute gives the path of the module relative to the repository URI. All other options for this element are processed as for <link linkend=\"moduleset-syntax-defs-cvsmodule\"><sgmltag class=\"element\">cvsmodule</sgmltag></link>."
2502 #: C/jhbuild.xml:2472(title)
2506 #: C/jhbuild.xml:2474(para)
2507 msgid "The <sgmltag class=\"element\">archmodule</sgmltag> element is now deprecated. The appropriate build system's module should be used instead."
2510 #: C/jhbuild.xml:2478(para)
2511 msgid "The <sgmltag class=\"element\">archmodule</sgmltag> element is used to define a module that is to be built from a GNU Arch archive."
2514 #: C/jhbuild.xml:2482(programlisting)
2518 " <archmodule version=\"<replaceable>modulename</replaceable>\"\n"
2519 " [ checkoutdir=\"<replaceable>directory</replaceable>\" ]\n"
2520 " [ root=\"<replaceable>rootname</replaceable>\" ]\n"
2521 " [ autogenargs=\"<replaceable>autogenargs</replaceable>\" ]\n"
2522 " [ makeargs=\"<replaceable>makeargs</replaceable>\" ]\n"
2523 " [ supports-non-srcdir-builds=\"<replaceable>yes|no</replaceable>\" ]>\n"
2524 " <dependencies>\n"
2525 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2527 " </dependencies>\n"
2528 " <suggests>\n"
2529 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2531 " </suggests>\n"
2533 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2536 " </archmodule>\n"
2539 #: C/jhbuild.xml:2503(para)
2540 msgid "The <sgmltag class=\"attribute\">version</sgmltag> attribute gives the version to be checked out from the archive specified by <sgmltag class=\"attribute\">root</sgmltag>. All other options for this element are processed as for <link linkend=\"moduleset-syntax-defs-cvsmodule\"><sgmltag class=\"element\">cvsmodule</sgmltag></link>."
2543 #: C/jhbuild.xml:2512(title)
2547 #: C/jhbuild.xml:2515(para)
2548 msgid "The <sgmltag class=\"element\">tarball</sgmltag> element is now deprecated. The appropriate build type module should be used instead. As a transitive measure this element has however been reimplemented as a thin wrapper around both <sgmltag class=\"element\">autotools</sgmltag> module type and <sgmltag class=\"element\">tarball</sgmltag> repository type."
2551 #: C/jhbuild.xml:2524(para)
2552 msgid "The <sgmltag class=\"element\">tarball</sgmltag> element is used to define a module that is to be built from a tarball."
2555 #: C/jhbuild.xml:2528(programlisting)
2559 " <tarball id=\"<replaceable>modulename</replaceable>\"\n"
2560 " [ version=\"<replaceable>version</replaceable>\" ]\n"
2561 " [ checkourdir=\"<replaceable>checkoutdir</replaceable>\" ]\n"
2562 " [ autogenargs=\"<replaceable>autogenargs</replaceable>\" ]\n"
2563 " [ makeargs=\"<replaceable>makeargs</replaceable>\" ]\n"
2564 " [ autogen-sh=\"<replaceable>autogen-sh</replaceable>\" ]\n"
2565 " [ supports-non-srcdir-builds=\"<replaceable>yes|no</replaceable>\" ]>\n"
2566 " <source href=\"<replaceable>source-url</replaceable>\"\n"
2567 " [ size=\"<replaceable>source-size</replaceable>\" ]\n"
2568 " [ md5sum=\"<replaceable>source-md5sum</replaceable>\" ]/>\n"
2569 " <patches>\n"
2570 " <patch file=\"<replaceable>filename</replaceable>\" strip=\"<replaceable>level</replaceable>\"/>\n"
2572 " </patches>\n"
2573 " <dependencies>\n"
2574 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2576 " </dependencies>\n"
2577 " <suggests>\n"
2578 " <dep package=\"<replaceable>modulename</replaceable>\"/>\n"
2580 " </suggests>\n"
2581 " </tarball>\n"
2584 #: C/jhbuild.xml:2553(para)
2585 msgid "The <sgmltag class=\"attribute\">id</sgmltag> and <sgmltag class=\"attribute\">version</sgmltag> attributes are used to identify the module."
2588 #: C/jhbuild.xml:2557(para)
2589 msgid "The <sgmltag class=\"element\">source</sgmltag> element specifies the file to download and compile. The <sgmltag class=\"attribute\">href</sgmltag> attribute is mandatory, while the <sgmltag class=\"attribute\">size</sgmltag> and <sgmltag class=\"attribute\">md5sum</sgmltag> attributes are optional. If these last two attributes are present, they are used to check that the source package was downloaded correctly."
2592 #: C/jhbuild.xml:2582(para)
2593 msgid "The other attributes and the <sgmltag class=\"element\">dependencies</sgmltag> and <sgmltag class=\"element\">suggests</sgmltag> sub-elements are processed as for <link linkend=\"moduleset-syntax-defs-cvsmodule\"><sgmltag class=\"element\">cvsmodule</sgmltag></link>."
2596 #: C/jhbuild.xml:2594(title)
2597 msgid "Frequently Asked Questions"
2600 #: C/jhbuild.xml:2598(title)
2601 msgid "General JHBuild Questions"
2604 #: C/jhbuild.xml:2601(simpara)
2605 msgid "The <command>wget</command> command can't download any tarballs. How do I get it to work with my firewall?"
2608 #: C/jhbuild.xml:2606(para)
2609 msgid "This can be fixed by creating or editing a <filename>~/.wgetrc</filename> file. If you need to go through an HTTP proxy to access FTP sites, add a line like the following to the file:"
2612 #: C/jhbuild.xml:2610(programlisting)
2614 msgid "ftp_proxy = http://<replaceable>hostname</replaceable>:<replaceable>port</replaceable>/"
2617 #: C/jhbuild.xml:2611(para)
2618 msgid "If you just need to use passive FTP connections (sometimes needed with NAT firewalls), add the following line:"
2621 #: C/jhbuild.xml:2614(programlisting)
2623 msgid "passive_ftp = on"
2626 #: C/jhbuild.xml:2615(para)
2627 msgid "This will fix all uses of the <command>wget</command> command."
2630 #: C/jhbuild.xml:2621(simpara)
2631 msgid "Building stuff is slow. Is there any way I can speed it up?"
2634 #: C/jhbuild.xml:2625(para)
2635 msgid "Other than buying a faster CPU, hard disk or getting more memory, you might want to install <ulink url=\"http://ccache.samba.org/\">CCache</ulink>, which can cache compilation results for you. It is available with most distributions."
2638 #: C/jhbuild.xml:2630(para)
2639 msgid "After installing CCache, set the cache size with the following command:"
2642 #: C/jhbuild.xml:2632(programlisting)
2644 msgid "ccache -M 2G"
2647 #: C/jhbuild.xml:2633(para)
2648 msgid "(replace <literal>2G</literal> with the size you want for your cache). Then create symlinks to CCache for your compiler in <filename>~/bin</filename>:"
2651 #: C/jhbuild.xml:2636(programlisting)
2655 "for cmd in cc gcc c++ g++; do\n"
2656 " ln -s /usr/bin/ccache $cmd\n"
2660 #: C/jhbuild.xml:2640(para)
2661 msgid "You can check the status of your cache (such as cache hit rates) with the following command:"
2664 #: C/jhbuild.xml:2642(programlisting)
2669 #: C/jhbuild.xml:2647(simpara)
2670 msgid "Is there a better way to monitor the status of the build than looking at terminal window?"
2673 #: C/jhbuild.xml:2651(para)
2674 msgid "If you have Zenity >= 2.9 installed on your system, JHBuild will display an icon in the system tray. The icon will display the current build stage, and the tooltip will show the last message from JHBuild."
2677 #: C/jhbuild.xml:2655(para)
2678 msgid "The icon will also pop up a balloon on error."
2681 #: C/jhbuild.xml:2660(title)
2682 msgid "Building GNOME"
2685 #: C/jhbuild.xml:2663(simpara)
2686 msgid "What other prerequisites are needed to build GNOME with JHBuild?"
2689 #: C/jhbuild.xml:2667(para)
2690 msgid "Some of the packages you will need on your system include:"
2693 #: C/jhbuild.xml:2671(simpara)
2694 msgid "DocBook XML DTD and XSLT stylesheets. These need to be registered in the XML catalog (<filename>/etc/xml/catalog</filename>)."
2697 #: C/jhbuild.xml:2676(simpara)
2701 #: C/jhbuild.xml:2679(simpara)
2702 msgid "fam or gamin (used by gnome-vfs for file monitoring)."
2705 #: C/jhbuild.xml:2683(simpara)
2706 msgid "<filename>libsmbclient</filename> from Samba (used for browsing Windows networks)."
2709 #: C/jhbuild.xml:2687(simpara)
2710 msgid "<filename>libbz2</filename> from bzip2."
2713 #: C/jhbuild.xml:2691(simpara)
2714 msgid "<filename>libpng</filename>, <filename>libjpeg</filename> and <filename>libtiff</filename> (used for image loading)."
2717 #: C/jhbuild.xml:2697(para)
2718 msgid "If you are installing distro packages, you may need to install corresponding \"dev\" or \"devel\" packages. Note that this list is just a starting point - not a comprehensive list."
2721 #: C/jhbuild.xml:2705(simpara)
2722 msgid "I've built GNOME with JHBuild. How do I run it?"
2725 #: C/jhbuild.xml:2709(para)
2726 msgid "(a) You will want to create a <filename>~/.xsession</filename> file, which is run by the display manager when you log in. This file should look something like this:"
2729 #: C/jhbuild.xml:2713(programlisting)
2733 "exec jhbuild run gnome-session"
2736 #: C/jhbuild.xml:2715(para)
2737 msgid "Finally, you should make sure that the <filename>~/.xsession</filename> file is executable."
2740 #: C/jhbuild.xml:2717(para)
2741 msgid "(b) Use a more sophisticated session script that is run when you log in using a graphical login manager (gdm /kdm/xdm). The problem with D-Bus and HAL is that these daemons come with your distribution and are most likely already running, but may be unusable by the Gnome development version (i.e. they are too old or incompatible). The session script just starts hal and d-bus from the jhbuild installation in addition to the system-wide versions. Put the following script as e.g. <filename>/usr/bin/gnomesvn-session</filename> and make sure you adjust <userinput>GNOME</userinput> to your local settings:"
2744 #: C/jhbuild.xml:2730(programlisting)
2748 "GNOME=/opt/gnome2\n"
2751 "#XDG_DATA_DIRS=$XDG_DATA_DIRS:$GNOME/share\n"
2752 "#XDG_CONFIG_DIRS=$XDG_CONFIG_DIRS:$GNOME/etc/xdg\n"
2754 "DBUS_LAUNCH=\"$GNOME/bin/dbus-launch --exit-with-session\"\n"
2756 "sudo su -c \"$GNOME/bin/dbus-daemon --system; \\\n"
2757 " $GNOME/sbin/hald\"\n"
2759 "jhbuild run $DBUS_LAUNCH gnome-session"
2762 #: C/jhbuild.xml:2743(para)
2763 msgid "Uncomment the XDG_ lines if you want the system-wide program menus from your distribution in addition to the entries from the jhbuild GNOME. Make sure the file is executable:"
2766 #: C/jhbuild.xml:2748(programlisting)
2768 msgid "chmod a+x /usr/bin/gnomesvn-session"
2769 msgstr "chmod a+x /usr/bin/gnomesvn-session"
2771 #: C/jhbuild.xml:2749(para)
2772 msgid "Because you need to start system daemons, you will need root privileges which are obtained by sudo. Note that you need to configure sudo so that it won't ask for a password! Run <userinput>visudo</userinput> as root and enter (don't forget to change your username and the paths):"
2775 #: C/jhbuild.xml:2757(programlisting)
2779 "# Cmnd alias specification\n"
2780 "Cmnd_Alias GNOME = /opt/gnome2/bin/dbus-daemon, \\\n"
2781 " /opt/gnome2/sbin/hald\n"
2783 "# User privilege specification\n"
2784 "gnometester ALL = NOPASSWD: GNOME"
2787 #: C/jhbuild.xml:2764(para)
2788 msgid "In order to get a new session entry in the login manager, create <filename>/usr/share/xsessions/gnomesvn.desktop</filename> and put this or something similar:"
2791 #: C/jhbuild.xml:2768(programlisting)
2797 "Name=Gnome svn (jhbuild)\n"
2798 "Comment=This session logs you into Gnome testing session\n"
2799 "Exec=/usr/bin/gnomesvn-session\n"
2804 #: C/jhbuild.xml:2776(para)
2805 msgid "Now you can restart gdm and log into your jhbuild GNOME. Make sure you select the jhbuild session before entering the login credentials. Advice: Use a seperate user account for testing!"
2808 #: C/jhbuild.xml:2785(simpara)
2809 msgid "I built GNOME using JHBuild with <varname>prefix</varname> set to <filename>/usr</filename>, and now my system is broken. What should I do?"
2812 #: C/jhbuild.xml:2790(para)
2813 msgid "Don't set <varname>prefix</varname> to <filename>/usr</filename>."
2816 #: C/jhbuild.xml:2796(simpara)
2817 msgid "How do I get <command>gnome-volume-manager</command> to work when running in a prefix?"
2820 #: C/jhbuild.xml:2801(para)
2821 msgid "The <command>gnome-volume-manager</command> program reacts to messages from <command>hald</command> over the system message bus, which must be running as root. Assuming that your distribution comes with <acronym>HAL</acronym>, the main problem is getting <command>gnome-volume-manager</command> to talk to the system message bus."
2824 #: C/jhbuild.xml:2808(para)
2825 msgid "Since communication is done over a UNIX domain socket, the easiest way to do this is to create a symlink from <filename>/var/run/dbus</filename> to <filename>$prefix/var/run/dbus</filename>:"
2828 #: C/jhbuild.xml:2812(programlisting)
2831 "mkdir -p $prefix/var/run\n"
2832 "cd $prefix/var/run\n"
2833 "ln -s /var/run/dbus dbus"
2835 "mkdir -p $prefix/var/run\n"
2836 "cd $prefix/var/run\n"
2837 "ln -s /var/run/dbus dbus"
2839 #: C/jhbuild.xml:2815(para)
2840 msgid "You may also have trouble building HAL with JHBuild, since it tries to install some things outside of its build root. Running <userinput>make -k install</userinput> in the hal directory might help here."
2843 #. Put one translator per line, in the form of NAME <EMAIL>, YEAR1, YEAR2.
2844 #: C/jhbuild.xml:0(None)
2845 msgid "translator-credits"
2846 msgstr "Daniel Nylander <po@danielnylander.se>, 2008"