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"