version 1.2, 2010/12/11 18:31:53
|
version 1.10, 2011/02/07 19:44:14
|
Line 2
|
Line 2
|
|
|
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: |
|
|
* "extract" to look at unmodified source |
* **depends** to build and install dependencies |
* "patch" to look at initial source |
* **fetch** to fetch distribution file(s) |
* "configure" to stop after configure stage |
* **checksum** to fetch and check distribution file(s) |
* "all" or "build" to stop after build stage |
* **extract** to look at unmodified source |
* "stage-install" to install under stage directory |
* **patch** to look at initial source |
* "test" to run package's self-tests, if any exist and supported |
* **configure** to stop after configure stage |
* "package" to create binary package before installing it |
* **all** or **build** to stop after build stage |
* "replace" to change (upgrade, downgrade, or just replace) installed package in-place |
* **stage-install** to install under stage directory |
* "deinstall" to deinstall previous package |
* **test** to run package's self-tests, if any exist and supported |
* "package-install" to install package and build binary package |
* **package** to create binary package before installing it |
* "install" to install package |
* **replace** to change (upgrade, downgrade, or just replace) installed package in-place |
|
* **deinstall** to deinstall previous package |
|
* **package-install** to install package and build binary package |
|
* **install** to install package |
|
* **bin-install** to attempt to skip building from source and use pre-built binary package |
|
|
|
Cleanup targets (in separate section because of importance): |
|
|
|
* **clean-depends** to remove work directories for dependencies |
|
* **clean** to remove work directory |
|
* **distclean** to remove distribution file(s) |
|
* **package-clean** to remove binary package |
|
|
|
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) |
|
* **makepatchsum** to (re)generate checksum for patches |
|
* **makedistinfo** to (re)generate *distinfo* file (creating checksums for distributed file and patches) |
|
* **mps** short for **makepatchsum** |
|
* **mdi** short for **makedistinfo** |
|
* **print-PLIST** to _attempt_ to generate correct packaging list |
|
(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 |
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 |
# modify patches |
# modify patches |
Line 35 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> |
"""]] |