PLDWWW: DevelopingPLD/BuilderScript

[PatrykZawadzki]

Author: PatrykZawadzki   Date: Thu Dec 22 16:23:43 2005 GMT
Module: PLDWWW   URL: http://pld-linux.org/DevelopingPLD/BuilderScript
---- Log message:
Initial version

---- Page affected: DevelopingPLD/BuilderScript

---- Diffs:

================================================================
New page:
= The builder script =

== Using the script ==

As the script resides in the ''rpm/SPECS'' subdirectory of your home, first you need to change your current directory to that of the script:

{{{
$ cd
$ cd rpm/SPECS
}}}

Now you can invoke {{{./builder}}} (remember that the dot and slash at the beginning are crucial) to see the list of possible parameters:

{{{
$ ./builder
}}}

The general syntax is as follows:

{{{
$ ./builder [options] package[.spec]
}}}

The {{{.spec}}} file extension is optional, {{{builder}}} will append it for you if needed.

Most common options are:

  * {{{-bb}}} to build only binary packages (omits creating source RPM packages)
  * {{{-bc}}} to cleanup after successfully building a package (removes the packaging directory as it is no longer needed)
  * {{{-r BRANCH}}} to use a specific branch or revision of the given package (available branches are listed at the beginning of the building process)
  * {{{-U}}} to fetch all the sources and update their MD5 hashes in the {{{spec}}} file
  * {{{-5}}} to update MD5 hashes using locally fetched sources
  * {{{--with FEATURE}}} or {{{--without FEATURE}}} to do a non-standard build (available features are listed at the beginning of the building process)

{{{builder}}} automatically fetches all files needed to build the given package (if file license permits, otherwise you will need to manually download and save remaining files to your ''~/rpm/SOURCES'' directory).

After the build process is complete, all binary RPM files are immediately available in your ''~/rpm/RPMS'' directory and source RPM packages (if any) are saved to ''~/rpm/SRPMS''.

== Examples of common use ==

To do a normal (binary) build of ''foo'' package:

{{{
$ ./builder -bb -bc foo
}}}

To perform a full build of a package that is currently being developed on the ''DEVEL'' branch:

{{{
$ ./builder -bc -r DEVEL foo
}}}

To update MD5 hashes after making changes to the above {{{spec}}} file:

{{{
$ ./builder -r DEVEL -U foo
}}}