Tree [e95955] master /
History



File Date Author Commit
buildbot 2009-06-04 Frédéric Péters Frédéric Péters [b91854] Merge branch 'master' into new-gui
contrib 2008-07-01 Marc-Andre Lureau Marc-Andre Lureau [013889] Add an option to list all modules.
doc 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...
examples 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...
jhbuild 2011-05-24 Dirk Wallenstein Dirk Wallenstein [e95955] clang: Create the output root directory if nece...
modulesets 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...
patches 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...
po 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...
scripts 2011-05-19 Dirk Wallenstein Dirk Wallenstein [1850ba] Select JHBuild source to use by environment var...
tests 2011-01-05 Dirk Wallenstein Dirk Wallenstein [f0f527] Merge branch 'master' of git://git.gnome.org/jh...
.gitignore 2009-08-26 Daniel Elstner Daniel Elstner [da2e8f] Ignore all config*.lineno files
AUTHORS 2007-08-12 Frederic Peters Frederic Peters [426930] added minimal autotools infrastucture and moved...
COPYING 2002-07-05 James Henstridge James Henstridge [923809] add licensing information that was previously m...
ChangeLog.pre-git 2009-04-16 Frederic Peters Frederic Peters [024859] renamed ChangeLog to ChangeLog.pre-git
HACKING 2011-01-05 Dirk Wallenstein Dirk Wallenstein [f0f527] Merge branch 'master' of git://git.gnome.org/jh...
INSTALL 2007-08-25 Frederic Peters Frederic Peters [f75884] disable doc build/install by default, so make i...
MAINTAINERS 2007-09-21 Olav Vitters Olav Vitters [82ebb1] Make sure active maintainers can be parsed
Makefile.am 2009-07-15 Frédéric Péters Frédéric Péters [98b8a4] clean generated desktop file
Makefile.plain 2009-06-24 Dan Winship Dan Winship [4224c5] Fix Makefile syntax in sed command in Makefile....
NEWS 2011-01-05 Dirk Wallenstein Dirk Wallenstein [f0f527] Merge branch 'master' of git://git.gnome.org/jh...
README 2011-01-05 Dirk Wallenstein Dirk Wallenstein [f0f527] Merge branch 'master' of git://git.gnome.org/jh...
autogen.sh 2010-03-12 Marc-André Lureau Marc-André Lureau [09addd] autogen.sh: remove useless and outdated message
configure.ac 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...
install-check.c 2009-04-07 Owen Taylor Owen Taylor [12e799] Clean up my last commit by removing and unused ...
jhbuild.desktop.in.in 2009-06-17 Vincent Untz Vincent Untz [d4922b] [autotools] Make .desktop file translatable and...
jhbuild.doap 2011-04-30 Dirk Wallenstein Dirk Wallenstein [b589ad] Merge branch 'master' of git://git.gnome.org/jh...

Read Me

JHBuild README
================================

JHBuild is a tool designed to ease building collections of source
packages, called “modules”.

JHBuild was originally written for building GNOME, but has since been
extended to be usable with other projects.

JHBuild requires Python >= 2.3

Installing JHBuild
-----------

Refer to the 'Getting Started' section of the JHBuild manual:

  gnome-help ghelp:/jhbuild-source-dir/doc/C/jhbuild.xml

where 'jhbuild-source-dir' is the full path to the JHBuild source
directory.

Or refer to the on-line JHBuild manual at:

  http://library.gnome.org/devel/jhbuild/stable/getting-started.html.en

Using JHBuild
-------------

JHBuild uses a command line syntax similar to tools like CVS:

  jhbuild [global-options] command [command-arguments]

The global JHBuild options are:

  -f, --file config
  Use an alternative configuration file instead of the default ~/.jhbuildrc.

  -m, --moduleset moduleset
  Use a module set other than the module set listed in the
  configuration file. This option can be a relative path if the module
  set is located in the JHBuild moduleset folder, or an absolute path
  if located elsewhere.

  --no-interact
  Do not prompt the user for any input. This option is useful if
  leaving a build unattended, in order to ensure the build is not
  interrupted.

Refer to the JHBuild manual for a complete list of JHBuild commands
and options. The common ones are:

jhbuild bootstrap

  The bootstrap command installs a set of build utilities required to
  build most modules (e.g. autoconf, automake, etc).

jhbuild build [--autogen] [--clean] [--dist] [--distcheck]
  [--ignore-suggests] [--no-network] [--skip=module...]
  [--start-at=module] [--tags=tags] [-D date] [--no-xvfb]
  [--try-checkout] [--no-poison] [--force] [--build-optional-modules]
  [--min-age=time] [module...]

  The build command builds one or more packages, including their
  dependencies.

  If no module names are provided on the command line, the modules
  list from the configuration file will be used.

  -a, --autogen
  Always run autogen.sh before building modules. By default,
  autogen.sh will only be called if the top-level makefile is
  missing. Otherwise, JHBuild relies on the package's makefiles to
  detect if configure needs to be rebuilt or rerun.

  -c, --clean
  Run make clean before building modules.

  -d, --dist
  Run make dist after building modules.

  --distcheck
  Run make distcheck after building modules.

  --ignore-suggests
  Do not build soft dependencies.

  -n, --no-network
  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, the module build will fail.

  -s, --skip=module,...
  Do not build the listed modules. Used to skip the building of
  specified dependencies.

  --tags=tag,...
  Ignore modules that do not match tag. Modules are automatically
  attributed a tag matching the name of the module's module set.

  -t, --start-at=module
  Start at the named module rather than at the beginning of the
  list. This option is useful if the build was interrupted.

  -D date
  If supported by the underlying version control system, update the
  source tree to the specified date before building. An ISO date
  format is required, e.g. "2009-09-18 02:32Z".

  -x, --no-xvfb
  Run graphical tests on the actual X server rather than in a
  simulated Xvfb.

  -C, --try-checkout
  If the build fails, and if supported by the version control system,
  force a checkout and run autogen.sh before retrying the build.

  -N, --no-poison
  If one or more of a module's dependencies failed, this option forces
  JHBuild to try to build the module anyway.

  -f, --force
  Build the modules even if policy states it is not required.

  --build-optional-modules
  Modules listed as optional dependencies, may not be required to
  build the module. This option forces JHBuild to build optional
  dependencies.

  --min-age=time
  Skip modules installed more recently than the specified relative
  time. The time string format is a number followed by a unit. The
  following units are supported: seconds (s), minutes (m), hours (h)
  and days (d). For example, --min-age=2h will skip modules built
  less than two hours ago.

jhbuild buildone [--autogen] [--clean] [--distcheck] [--no-network]
  [-D date] [--no-xvfb] [--force] [--min-age=time] module...

  The buildone command is similar to build, but it does not build the
  dependent modules. It is useful for rebuilding one or more modules.

jhbuild sanitycheck

  The sanitycheck command performs a number of checks to verify the
  build environment is okay.

For details of all jbhuild's command line options:
  jhbuild --help

Reporting Bugs
--------------

If you find any bugs in JHBuild, or have feature requests (or
implementations :), please file them in bugzilla at:

  http://bugzilla.gnome.org/enter_bug.cgi?product=jhbuild

This will ensure your request is not lost.