document KojiReleaser and do not mark it as experimental any more

This commit is contained in:
Miroslav Suchý 2013-04-24 22:03:18 +02:00
parent 9bcee4f80c
commit 23faae8487
3 changed files with 24 additions and 12 deletions

View file

@ -55,8 +55,21 @@ Releaser which will submit builds through CVS build systems. (no longer useful f
branches = BRANCH1 BRANCH2 branches = BRANCH1 BRANCH2
tito.release.KojiReleaser:: tito.release.KojiReleaser::
Highly experimental, ignore for now. Releaser which create src.rpm and submit them into Koji. Can submit more then one build at once.
+
NOTE: This is targeted for private instances of Koji. You can not submit regular build into Fedora Koji using this releaser, because Fedora Koji do not allow builds from src.rpm - for building into Fedora see FedoraGitReleaser above.
+
[koji]
releaser = tito.release.KojiReleaser
autobuild_tags = my-koji-tag-rhel6 my-koji-tag-fedora18
+
In this example, releaser will create src.rpm according the definition of [my-koji-tag-rhel6] in tito.props. You usually want to set up there at least disttag. See KOJI section in tito.props(5).
+
If --scratch option or SCRATCH environment variable is set, package is build as scratch in Koji.
+
You can specify KOJI_OPTIONS in titorc(5) and it is passed to koji command as option. Usually you want to specify at least --config option.
+
Variable autobuild_tags is required for KojiReleaser.
EXAMPLE EXAMPLE

View file

@ -74,21 +74,19 @@ An optional specification of a suffix to append to all tags created by tito for
KOJI KOJI
---- ----
WARNING: very experimental, and not tested against Fedora's Koji.
autobuild_tags::
If you use --koji-relase it will try to build src.rpm package in specified tags
in koji.
Also see KOJI_OPTIONS in titorc(5).
You can specify section which is named as the tag and put there following
options:
disttag:: disttag::
Dist tag variable, which is passed to rpmbuild for packages build in this tag. Dist tag variable, which is passed to rpmbuild for packages build in this tag.
blacklist:: blacklist::
Space separated list of packages, which should not be built in this tag. Space separated list of packages, which should not be built in this tag.
whitelist::
If whitelist is present, only packages listed here can be built in this tag.
This also override blacklist.
scl::
Specify name of Software Collection into which package should be build.
CVS CVS
--- ---
cvsroot:: cvsroot::

View file

@ -24,8 +24,9 @@ OPTIONS
------- -------
KOJI_OPTIONS:: KOJI_OPTIONS::
Specify strings of options, which is passed to koji on commandline when you Specify strings of options, which is passed to koji on commandline when you
execute --koji-release. For example: use KojiReleaser. For example:
KOJI_OPTIONS=-c ~/.koji/katello-config --nowait
NO_AUTO_INSTALL:: NO_AUTO_INSTALL::
Specify list of packages (separated by space), which should NOT be installed, Specify list of packages (separated by space), which should NOT be installed,