|
version 1.6, 2010/12/11 22:46:02
|
version 1.9, 2011/02/07 04:23:09
|
|
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> |
|
| su root -c "make depends clean-depends clean" # to catch new dependencies |
[[!template id=programlisting text=""" |
| rm -f distinfo && su root -c "make makesum clean" && make makepatchsum |
$ su root -c "make depends clean-depends clean" # to catch new dependencies |
| make clean && make stage-install # build |
$ rm -f distinfo && su root -c "make makesum clean" && make makepatchsum |
| |
$ make clean && make stage-install # build |
| # modify patches |
# modify patches |
| make makepatchsum # and build again, or |
$ make makepatchsum # and build again, or |
| make makepatchsum && make clean && make patch # until all patches apply, if they failed at first |
$ make makepatchsum && make clean && make patch # until all patches apply, if they failed at first |
| make print-PLIST | diff -u PLIST - |
$ make print-PLIST | diff -u PLIST - |
| # modify PLIST |
# modify PLIST |
| rm $(make show-var VARNAME=WRKDIR)/.PLIST* # this deserves to be another target |
$ rm $(make show-var VARNAME=WRKDIR)/.PLIST* # this deserves to be another target |
| make stage-install |
$ make stage-install |
| # modify PLIST again or build again |
# modify PLIST again or build again |
| 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> |
"""]] |
![[BACK]](/icons/back.gif){kind=icon}
Return to targets.mdwn CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [NetBSD Developer Wiki] / wikisrc / pkgsrc