moparisthebest
/
pacman
mirror of https://github.com/moparisthebest/pacman
1
0
Fork 0
Code Issues Releases Wiki Activity

doc/PKGBUILD: clarify scriptlet version arguments 

It was a bit unclear that both pkgver and pkgrel were included in the
passed version strings; clarify this fact in the manpage. Also include
epoch in the mix now that it exists.

Also make two other minor consistency touchups to code-print variables
in text.

Signed-off-by: Dan McGee <dan@archlinux.org>
This commit is contained in:
Dan McGee 2011-07-05 22:48:50 -05:00
parent 8f72ffbc45
commit e209955606
1 changed files with 20 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/PKGBUILD.5.txt
View File

@ -266,7 +266,7 @@ use here. The function is run in `bash -e` mode, meaning any command that exits
with a non-zero status will cause the function to exit. Be sure any exotic with a non-zero status will cause the function to exit. Be sure any exotic
commands used are covered by `makedepends`. commands used are covered by `makedepends`.
All of the above variables such as `pkgname` and `pkgver` are available for use All of the above variables such as `$pkgname` and `$pkgver` are available for use
in the build function. In addition, makepkg defines the following three in the build function. In addition, makepkg defines the following three
variables for use during the build and install process: variables for use during the build and install process:
@ -332,31 +332,37 @@ Pacman has the ability to store and execute a package-specific script when it
installs, removes, or upgrades a package. This allows a package to configure installs, removes, or upgrades a package. This allows a package to configure
itself after installation and perform an opposite action upon removal. itself after installation and perform an opposite action upon removal.
The exact time the script is run varies with each operation: The exact time the script is run varies with each operation, and should be
self-explanatory. Note that during an upgrade operation, none of the install
or remove scripts will be called.
Scripts are passed either one or two ``full version strings'', where a full
version string is either 'pkgver-pkgrel' or 'epoch:pkgver-pkgrel' if epoch is
non-zero.
*pre_install*:: *pre_install*::
script is run right before files are extracted. One argument is passed: Run right before files are extracted. One argument is passed:
new package version. new package full version string.
*post_install*:: *post_install*::
script is run right after files are extracted. One argument is passed: Run right after files are extracted. One argument is passed:
new package version. new package full version string.
*pre_upgrade*:: *pre_upgrade*::
script is run right before files are extracted. Two arguments are passed Run right before files are extracted. Two arguments are passed in this
in the following order: new package version, old package version. order: new package full version string, old package full version string.
*post_upgrade*:: *post_upgrade*::
script is run after files are extracted. Two arguments are passed Run after files are extracted. Two arguments are passed in this order:
in the following order: new package version, old package version. new package full version string, old package full version string.
*pre_remove*:: *pre_remove*::
script is run right before files are removed. One argument is passed: Run right before files are removed. One argument is passed:
old package version. old package full version string.
*post_remove*:: *post_remove*::
script is run right after files are removed. One argument is passed: Run right after files are removed. One argument is passed:
old package version. old package full version string.
To use this feature, create a file such as 'pkgname.install' and put it in the To use this feature, create a file such as 'pkgname.install' and put it in the
same directory as the PKGBUILD script. Then use the install directive: same directory as the PKGBUILD script. Then use the install directive: