|
|
Documentation of the package description tags format. This tags are used in
|
|
the *.desc files. If you want to add additional tags, their names have to start
|
|
with 'X-' (like [X-FOOBAR]).
|
|
|
|
Please use the tags in the same order as they are listed in this file. Add
|
|
a blank line wherever a '--' is found here and use the X-* flags after all
|
|
the other tags. "./scripts/Create-DescPatch" can help you here.
|
|
|
|
All tags marked with (*) are required. And should be present in every .desc
|
|
file.
|
|
|
|
- Clifford and Rene
|
|
|
|
----
|
|
|
|
[COPY]
|
|
|
|
The ROCK Linux Copyright text (and maybe additional copyright information
|
|
regarding the ROCK Linux package sources).
|
|
|
|
--
|
|
|
|
[I] [TITLE] (*)
|
|
|
|
A short description of the package. Can be given only once.
|
|
|
|
--
|
|
|
|
[T] [TEXT] (*)
|
|
|
|
A detailed package description.
|
|
|
|
--
|
|
|
|
[U] [URL]
|
|
|
|
A URL related to the package.
|
|
Format: [U] http://foo.bar/ Description of foo bar
|
|
can be used more than once.
|
|
|
|
--
|
|
|
|
[A] [AUTHOR] (*)
|
|
|
|
Format: # [A] Clifford Wolf <clifford@clifford.at> {Core Maintainer}
|
|
The <e-mail> and the {description} are both optional. Can be user more
|
|
than once.
|
|
|
|
[M] [MAINTAINER] (*)
|
|
|
|
Same format as [A] but contains the maintainer of the ROCK package.
|
|
|
|
--
|
|
|
|
[C] [CATEGORY] (*)
|
|
|
|
Format: [C] console/administration x11/administration
|
|
A list of possible categories can be found in etc/categories.
|
|
|
|
[F] [FLAG]
|
|
|
|
Format: [F] DIETLIBC
|
|
A list of possible flags can be found in etc/flags.
|
|
|
|
[R] [ARCH] [ARCHITECTURE]
|
|
|
|
Format: [R] + intel
|
|
Format: [R] - sparc powerpc
|
|
Usually a packge is built on all architectures. If you are using [R]
|
|
with '+' the package will only be built for the given architectures.
|
|
If you use it with '-' it will be built for all except the given
|
|
architectures.
|
|
|
|
--
|
|
|
|
[E] [DEP] [DEPENDENCY]
|
|
|
|
Format: [E] group compiler
|
|
All dependencies to a package in this group (compiler) will get expanded to
|
|
dependencies to all packages in this group.
|
|
|
|
--
|
|
|
|
[L] [LICENSE] (*)
|
|
|
|
Format: [L] GPL
|
|
I will add a list of possible values to etc/register
|
|
|
|
[S] [STATUS] (*)
|
|
|
|
Format: [S] Stable
|
|
where 'Stable' also can be 'Gamma' (very close to stable), 'Beta' or
|
|
'Alpha' (far away from stable).
|
|
|
|
[V] [VER] [VERSION] (*)
|
|
|
|
Package version and revision (example: '[V] 2.3 19991204').
|
|
|
|
[P] [PRI] [PRIORITY] (*)
|
|
|
|
Format: [P] X --3-----9 010.066
|
|
The first field specifies if the package should be built on default or
|
|
not (X=on, O=off). The second and third field specify the stages and
|
|
build-order for that package.
|
|
|
|
--
|
|
|
|
[CV-URL]
|
|
|
|
Format: [CV-URL] http://www.research.avayalabs.com/project/libsafe/
|
|
The URL used by ./scripts/Check-PkgVersion.
|
|
|
|
[CV-PAT]
|
|
|
|
Format: [CV-PAT] ^libsafe-[0-9]
|
|
The search pattern for ./scripts/Check-PkgVersion.
|
|
|
|
[CV-DEL]
|
|
|
|
Format: [CV-DEL] \.(tgz|tar.gz)$
|
|
The delete pattern for ./scripts/Check-PkgVersion.
|
|
|
|
--
|
|
|
|
[O] [CONF]
|
|
|
|
Format: [O] srcdir="$pkg-src-$ver"
|
|
The given text will be evaluated as if it would be at the top of the
|
|
package *.conf file.
|
|
|
|
--
|
|
|
|
[D] [DOWN] [DOWNLOAD]
|
|
|
|
Download a file. (example: '[D] cksum foo.tar.bz2 http://the-size.org/')
|
|
The cksum can be initially 0.
|
|
|
|
--
|
|
|
|
[SRC] [SOURCEPACKAGE]
|
|
|
|
Format: [SRC] tarball1 tarball2
|
|
This will enable build_this_package to build the content of more than
|
|
one tarball.
|
|
NOTE: do not put the extension of the tarballs (e.g. tar.gz) into this
|
|
tag, as it will be autodetected.
|
|
NOTE2: a pattern to match the needed tarball should be enough.
|
|
(example:
|
|
> [D] cksum mypkg-version1.tar.gz http://some.url.tld
|
|
> [D] cksum mypkg-gfx-version2.tbz2 http://some.url.tld
|
|
> [D] cksum mypkg-data-version3.tar.bz2 http://some.url.tld
|
|
> [SRC] mypkg-version1 gfx
|
|
This would run the whole build cycle with mypkg-version1.tar.bz2 and
|
|
mypkg-gfx-version2.tbz2 but not with mypkg-data-version3.tar.bz2.
|
|
|