From a44a093a5d6c6ae62fb42ec8c9692b67be4ead40 Mon Sep 17 00:00:00 2001 From: merakor Date: Wed, 24 Mar 2021 09:43:33 +0000 Subject: docs: update FossilOrigin-Name: cbeda1da4581248561719a30276465343e56a60362a212a02dcd01ad42a39b3f --- docs/cpt.org | 35 +++++++++++++++--------------- docs/cpt.texi | 70 +++++++++++++++++++++++++++++------------------------------ docs/cpt.txt | 47 ++++++++++++++++++++++++--------------- 3 files changed, 82 insertions(+), 70 deletions(-) (limited to 'docs') diff --git a/docs/cpt.org b/docs/cpt.org index 9ffa37a..0e59114 100644 --- a/docs/cpt.org +++ b/docs/cpt.org @@ -303,18 +303,18 @@ with the =*-mesa= suffix. Hooks can be used in order to change the runtime behaviour of the package manager. There are a variety of package hooks, mostly self explanatory: -- pre-build -- post-build -- build-fail -- pre-test -- test-fail -- pre-install -- post-install -- pre-remove -- post-remove -- pre-fetch -- post-fetch -- post-package +- pre-build :: Run just before the ~build~ script is run +- post-build :: Run after the ~build~ script is run successfully +- build-fail :: Run if the ~build~ script fails +- pre-test :: Run before the ~test~ script is run +- test-fail :: Run if the ~test~ script fails +- pre-install :: Run before a package is installed for each package +- post-install :: Run after a package is installed for each package +- pre-remove :: Run before a package is removed for each package +- post-remove :: Run after a package is removed for each package +- pre-fetch :: Run before all repositories are fetched +- post-fetch :: Run after all repositories are fetched +- post-package :: Run after a tarball for a package is created In order to use hooks, you will need to set the =CPT_HOOK= variable pointing to your hook file. Your hook file *MUST* be a POSIX shell script as its contents @@ -322,11 +322,12 @@ are sourced by the package manager. The hook is given 3 variables when it is executed. Those are: -| Variable | Explanation | -|----------+--------------------------------------------------------------| -| =$TYPE= | The type of the hook, (=pre-build=, =post-build=, etc.) | -| =$PKG= | The package that =cpt= is currently working on. Can be null. | -| =$DEST= | The destination of the operation. Can be null. | +- ~$TYPE~ :: + The type of the hook, (=pre-build=, =post-build=, etc.) +- ~$PKG~ :: + The package that =cpt= is currently working on. Can be null. +- ~$DEST~ :: + The destination of the operation. Can be null. ** Editing the build file during pre-build :PROPERTIES: diff --git a/docs/cpt.texi b/docs/cpt.texi index af0fe5a..71b4e69 100644 --- a/docs/cpt.texi +++ b/docs/cpt.texi @@ -422,32 +422,32 @@ with the @samp{*-mesa} suffix. Hooks can be used in order to change the runtime behaviour of the package manager. There are a variety of package hooks, mostly self explanatory: -@itemize -@item -pre-build -@item -post-build -@item -build-fail -@item -pre-test -@item -test-fail -@item -pre-install -@item -post-install -@item -pre-remove -@item -post-remove -@item -pre-fetch -@item -post-fetch -@item -post-package -@end itemize +@table @asis +@item pre-build +Run just before the @code{build} script is run +@item post-build +Run after the @code{build} script is run successfully +@item build-fail +Run if the @code{build} script fails +@item pre-test +Run before the @code{test} script is run +@item test-fail +Run if the @code{test} script fails +@item pre-install +Run before a package is installed for each package +@item post-install +Run after a package is installed for each package +@item pre-remove +Run before a package is removed for each package +@item post-remove +Run after a package is removed for each package +@item pre-fetch +Run before all repositories are fetched +@item post-fetch +Run after all repositories are fetched +@item post-package +Run after a tarball for a package is created +@end table In order to use hooks, you will need to set the @samp{CPT_HOOK} variable pointing to your hook file. Your hook file @strong{MUST} be a POSIX shell script as its contents @@ -455,16 +455,14 @@ are sourced by the package manager. The hook is given 3 variables when it is executed. Those are: -@multitable {aaaaaaaa} {aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa} -@headitem Variable -@tab Explanation -@item @samp{$TYPE} -@tab The type of the hook, (@samp{pre-build}, @samp{post-build}, etc.) -@item @samp{$PKG} -@tab The package that @samp{cpt} is currently working on. Can be null. -@item @samp{$DEST} -@tab The destination of the operation. Can be null. -@end multitable +@table @asis +@item @code{$TYPE} +The type of the hook, (@samp{pre-build}, @samp{post-build}, etc.) +@item @code{$PKG} +The package that @samp{cpt} is currently working on. Can be null. +@item @code{$DEST} +The destination of the operation. Can be null. +@end table @node Editing the build file during pre-build @section Editing the build file during pre-build diff --git a/docs/cpt.txt b/docs/cpt.txt index 201dfd4..f846f12 100644 --- a/docs/cpt.txt +++ b/docs/cpt.txt @@ -364,18 +364,30 @@ development manual for *Carbs Packaging Tools*. For development logs see package manager. There are a variety of package hooks, mostly self explanatory: - - pre-build - - post-build - - build-fail - - pre-test - - test-fail - - pre-install - - post-install - - pre-remove - - post-remove - - pre-fetch - - post-fetch - - post-package + pre-build + Run just before the `build' script is run + post-build + Run after the `build' script is run successfully + build-fail + Run if the `build' script fails + pre-test + Run before the `test' script is run + test-fail + Run if the `test' script fails + pre-install + Run before a package is installed for each package + post-install + Run after a package is installed for each package + pre-remove + Run before a package is removed for each package + post-remove + Run after a package is removed for each package + pre-fetch + Run before all repositories are fetched + post-fetch + Run after all repositories are fetched + post-package + Run after a tarball for a package is created In order to use hooks, you will need to set the `CPT_HOOK' variable pointing to your hook file. Your hook file *MUST* be a POSIX shell @@ -383,11 +395,12 @@ development manual for *Carbs Packaging Tools*. For development logs see The hook is given 3 variables when it is executed. Those are: - Variable Explanation - ------------------------------------------------------------------------ - `$TYPE' The type of the hook, (`pre-build', `post-build', etc.) - `$PKG' The package that `cpt' is currently working on. Can be null. - `$DEST' The destination of the operation. Can be null. + `$TYPE' + The type of the hook, (`pre-build', `post-build', etc.) + `$PKG' + The package that `cpt' is currently working on. Can be null. + `$DEST' + The destination of the operation. Can be null. 4.4 Editing the build file during pre-build -- cgit v1.2.3