version 1.6, 2010/12/11 22:46:02
|
version 1.10, 2011/02/07 19:44:14
|
Line 3
|
Line 3
|
It was proposed that we document _all_ pkgsrc targets, |
It was proposed that we document _all_ pkgsrc targets, |
but this is unreasonable and useless. |
but this is unreasonable and useless. |
Most targets are ancilliary ones; |
Most targets are ancilliary ones; |
they exist because that's how make(1) works; |
they exist because that's how [[!template id=man name=make section=1]] works. |
only few of them are useful for regular work. |
Only few of them are useful for regular work. |
|
|
The following targets may be useful to invoke from keyboard: |
The following targets may be useful to invoke from keyboard: |
|
|
* "depends" to build and install dependencies |
* **depends** to build and install dependencies |
* "fetch" to fetch distribution file(s) |
* **fetch** to fetch distribution file(s) |
* "checksum" to fetch and check distribution file(s) |
* **checksum** to fetch and check distribution file(s) |
* "extract" to look at unmodified source |
* **extract** to look at unmodified source |
* "patch" to look at initial source |
* **patch** to look at initial source |
* "configure" to stop after configure stage |
* **configure** to stop after configure stage |
* "all" or "build" to stop after build stage |
* **all** or **build** to stop after build stage |
* "stage-install" to install under stage directory |
* **stage-install** to install under stage directory |
* "test" to run package's self-tests, if any exist and supported |
* **test** to run package's self-tests, if any exist and supported |
* "package" to create binary package before installing it |
* **package** to create binary package before installing it |
* "replace" to change (upgrade, downgrade, or just replace) installed package in-place |
* **replace** to change (upgrade, downgrade, or just replace) installed package in-place |
* "deinstall" to deinstall previous package |
* **deinstall** to deinstall previous package |
* "package-install" to install package and build binary package |
* **package-install** to install package and build binary package |
* "install" to install package |
* **install** to install package |
* "bin-install" to attempt to skip building from source and use pre-built binary package |
* **bin-install** to attempt to skip building from source and use pre-built binary package |
|
|
Cleanup targets (in separate section because of importance): |
Cleanup targets (in separate section because of importance): |
|
|
* "clean-depends" to remove work directories for dependencies |
* **clean-depends** to remove work directories for dependencies |
* "clean" to remove work directory |
* **clean** to remove work directory |
* "distclean" to remove distribution file(s) |
* **distclean** to remove distribution file(s) |
* "package-clean" to remove binary package |
* **package-clean** to remove binary package |
|
|
The following targets are useful in development and thus may be useful for an advanced user: |
The following targets are useful in development and thus may be useful for an advanced user: |
|
|
* "makesum" to fetch and generate checksum for distributed file(s) |
* **makesum** to fetch and generate checksum for distributed file(s) |
* "makepatchsum" to (re)generate checksum for patches |
* **makepatchsum** to (re)generate checksum for patches |
* "makedistinfo" to (re)generate "distinfo" file (creating checksums for distributed file and patches) |
* **makedistinfo** to (re)generate *distinfo* file (creating checksums for distributed file and patches) |
* "mps" short for "makepatchsum" |
* **mps** short for **makepatchsum** |
* "mdi" short for "makedistinfo" |
* **mdi** short for **makedistinfo** |
* "print-PLIST" to _attempt_ to generate correct packaging list |
* **print-PLIST** to _attempt_ to generate correct packaging list |
(NB! It helps, but it _doesn't_ eliminate manual work.) |
(NB! It helps, but it _doesn't_ eliminate manual work.) |
|
|
For example, package updating looks like this: |
For example, package updating looks like this: |
<pre> |
|
|
[[!template id=programlisting text=""" |
su root -c "make depends clean-depends clean" # to catch new dependencies |
su root -c "make depends clean-depends clean" # to catch new dependencies |
rm -f distinfo && su root -c "make makesum clean" && make makepatchsum |
rm -f distinfo && su root -c "make makesum clean" && make makepatchsum |
make clean && make stage-install # build |
make clean && make stage-install # build |
Line 57 make stage-install
|
Line 58 make stage-install
|
make test # just to check for regressions |
make test # just to check for regressions |
su root -c "make package deinstall bin-install" # or |
su root -c "make package deinstall bin-install" # or |
su root -c "make package replace" |
su root -c "make package replace" |
</pre> |
"""]] |