Annotation of wikisrc/pkgsrc/targets.mdwn, revision 1.2

1.1       asau        1: # pkgsrc targets
                      2: 
                      3: It was proposed that we document _all_ pkgsrc targets,
                      4: but this is unreasonable and useless.
                      5: Most targets are ancilliary ones,
                      6: they exist because that's how make(1) works,
                      7: only few of them are useful for regular work.
                      8: 
                      9: The following targets may be useful to invoke from keyboard:
1.2     ! asau       10: 
1.1       asau       11: * "extract" to look at unmodified source
                     12: * "patch" to look at initial source
                     13: * "configure" to stop after configure stage
                     14: * "all" or "build" to stop after build stage
                     15: * "stage-install" to install under stage directory
                     16: * "test" to run package's self-tests, if any exist and supported
                     17: * "package" to create binary package before installing it
                     18: * "replace" to change (upgrade, downgrade, or just replace) installed package in-place
                     19: * "deinstall" to deinstall previous package
                     20: * "package-install" to install package and build binary package
                     21: * "install" to install package
                     22: 
                     23: For example, package updating looks like this:
                     24: <pre>
                     25: rm -f distinfo && su root -c "make makesum clean" && make makepatchsum
                     26: make clean && make stage-install # build
                     27: # modify patches
                     28: make makepatchsum # and build again, or
                     29: make makepatchsum && make clean && make patch # until all patches apply, if they failed at first
                     30: make print-PLIST | diff -u PLIST -
                     31: # modify PLIST
                     32: rm $(make show-var VARNAME=WRKDIR)/.PLIST* # this deserves to be another target
                     33: make stage-install
                     34: # modify PLIST again or build again
                     35: make test # just to check for regressions
                     36: su root -c "make package deinstall bin-install" # or
                     37: su root -c "make package replace"
                     38: </pre>

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb