Diff for /wikisrc/pkgsrc/targets.mdwn between versions 1.7 and 1.10

version 1.7, 2010/12/11 23:11:06 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>  """]]

Removed from v.1.7  
changed lines
  Added in v.1.10


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