From fff746052cd224bd8c6db44c8fdc8ff7f4d08510 Mon Sep 17 00:00:00 2001 From: Dan McGee Date: Fri, 13 Jun 2008 20:22:08 -0500 Subject: Document pacman -q/--quiet operation Fixes FS#10644. Signed-off-by: Dan McGee --- doc/pacman.8.txt | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'doc') diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt index f6eb69c3..8c37e387 100644 --- a/doc/pacman.8.txt +++ b/doc/pacman.8.txt @@ -193,6 +193,11 @@ Query Options[[QO]] not an entry in the database. The file will be decompressed and queried. This is useful in combination with '\--info' and '\--list'. +*-q, \--quiet*:: + Show less information for certain query operations. Search will only show + package names and not version, group, and description information; a bare + query will only show package names rather than names and versions. + *-s, \--search* <'regexp'>:: This will search each locally-installed package for names or descriptions that match `regexp`. @@ -264,6 +269,11 @@ Sync Options[[SO]] dependencies yet to be installed. These can be piped to a file and downloaded at a later time, using a program like wget. +*-q, \--quiet*:: + Show less information for certain sync operations. Search will only show + package names and not version, group, and description information; list + will only show package names and omit databases and versions. + *-s, \--search* <'regexp'>:: This will search each package in the sync databases for names or descriptions that match `regexp`. -- cgit v1.2.3-70-g09d2 From 2158b8e29839e99b4f5a3420d9896dd9da223b0b Mon Sep 17 00:00:00 2001 From: Dan McGee Date: Sat, 14 Jun 2008 11:57:10 -0500 Subject: Expand PKGBUILD documentation Add documentation for $startdir, $srcdir, and $pkgdir variables, as well as general information about the build() function and about custom variables in PKGBUILDs. This addresses FS#10634. Signed-off-by: Dan McGee --- doc/PKGBUILD.5.txt | 44 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 43 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt index ac394729..f4ddc839 100644 --- a/doc/PKGBUILD.5.txt +++ b/doc/PKGBUILD.5.txt @@ -30,12 +30,22 @@ distribution of this package. Options and Directives ---------------------- +The following is a list of standard options and directives available for use +in a PKGBUILD. These are all understood and interpreted by makepkg, and most +will be directly transferred to the built package. + +If you need to create any custom variables for use in your build process, it is +recommended to name your custom variables with an '_' (underscore) prefix. +This will prevent any possible name clashes with internal makepkg variables. +For example, to store the base kernel version in a variable, use something +similar to `$_basekernver`. + *pkgname*:: The name of the package. This has be a unix-friendly name as it will be used in the package filename. *pkgver*:: - The version of the software as released from the author (e.g. \'2.7.1'). + The version of the software as released from the author (e.g. '2.7.1'). *pkgrel*:: This is the release number specific to the Arch Linux release. This @@ -205,6 +215,38 @@ Options and Directives of a package changes (or is alphanumeric). +build() Function +---------------- +In addition to the above directives, the build() bash function comprises the +remainder of the PKGBUILD. This is directly sourced and executed by makepkg, so +anything that bash or the system has available is available for use here. Be +sure any exotic commands used are covered by `makedepends`. + +All of the above variables such as `pkgname` and `pkgver` are available for use +in the build function. In addition, makepkg defines three variables for your +use during the build and install process. These three variables are as follows: + +*startdir*:: + This contains the absolute path to the directory where the PKGBUILD was + located, which is usually the output of `$(pwd)` when makepkg is started. + $$startdir$$ was most often used in combination with `/src` or `/pkg` + postfixes, but use of the `srcdir` and `pkgdir` variables is preferred. + +*srcdir*:: + This points to the directory where makepkg extracts or copies all source + files. Although it currently is an alias for `$startdir/src`, this + assumption should not be assumed true for all future revisions of makepkg. + +*pkgdir*:: + This points to the directory where makepkg bundles the installed package + (this directory will become the root directory of your built package). + Although it currently is an alias for `$startdir/pkg`, this assumption + should not be assumed true for all future revisions of makepkg. + +If you create any variables of your own in the build function, it is +recommended to use the bash `local` keyword to scope the variable to inside +the build function. + Install/Upgrade/Remove Scripting -------------------------------- Pacman has the ability to store and execute a package-specific script when it -- cgit v1.2.3-70-g09d2