[pacman-dev] [PATCH] makepkg: Add docmunetation for separate pacakge function

[Allan McRae]

I'd like some comments here as I find it hard writing documentation when 
I know exactly what the code is doing.  Any suggestions for wording or 
parts which need clarification are appreciated.

Allan

Allan McRae wrote:
> Signed-off-by: Allan McRae <allan at archlinux.org>
> ---
>  doc/PKGBUILD.5.txt |    9 +++++++++
>  1 files changed, 9 insertions(+), 0 deletions(-)
>
> diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt
> index e42a8b8..5171798 100644
> --- a/doc/PKGBUILD.5.txt
> +++ b/doc/PKGBUILD.5.txt
> @@ -254,6 +254,15 @@ 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.
>  
> +package() Function
> +------------------
> +An optional package() function can be specified in addtion to the build() function.
> +This function is directly sourced by makepkg and run immediately after the build()
> +function. When specified in combination with the fakeroot BUILDENV option in
> +linkman:makepkg.conf[5], fakeroot usage will be limited to running the package()
> +function and the subsequent packing of the package. The build() function will be
> +run as the user calling makepkg.
> +
>  Install/Upgrade/Remove Scripting
>  --------------------------------
>  Pacman has the ability to store and execute a package-specific script when it
>