Return to targets.mdwn CVS log

Up to [NetBSD Developer Wiki] / wikisrc / pkgsrc

Explain "print-PLIST".

    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:
   10: 
   11: * "depends" to build and install dependencies
   12: * "fetch" to fetch distribution file(s)
   13: * "checksum" to fetch and check distribution file(s)
   14: * "extract" to look at unmodified source
   15: * "patch" to look at initial source
   16: * "configure" to stop after configure stage
   17: * "all" or "build" to stop after build stage
   18: * "stage-install" to install under stage directory
   19: * "test" to run package's self-tests, if any exist and supported
   20: * "package" to create binary package before installing it
   21: * "replace" to change (upgrade, downgrade, or just replace) installed package in-place
   22: * "deinstall" to deinstall previous package
   23: * "package-install" to install package and build binary package
   24: * "install" to install package
   25: * "bin-install" to attempt to skip building from source and use pre-built binary package
   26: 
   27: Cleanup targets (in separate section because of importance):
   28: 
   29: * "clean-depends" to remove work directories for dependencies
   30: * "clean" to remove work directory
   31: * "distclean" to remove distribution file(s)
   32: 
   33: The following targets are useful in development and thus may be useful for an advanced user:
   34: 
   35: * "makesum" to fetch and generate checksum for distributed file(s)
   36: * "makepatchsum" to (re)generate checksum for patches
   37: * "makedistinfo" to (re)generate "distinfo" file (creating checksums for distributed file and patches)
   38: * "mps" short for "makepatchsum"
   39: * "mdi" short for "makedistinfo"
   40: * "print-PLIST" to _attempt_ to generate correct packaging list
   41: (NB! It helps, but it _doesn't_ eliminate manual work.)
   42: 
   43: For example, package updating looks like this:
   44: <pre>
   45: su root -c "make depends clean-depends clean" # to catch new dependencies
   46: rm -f distinfo && su root -c "make makesum clean" && make makepatchsum
   47: make clean && make stage-install # build
   48: # modify patches
   49: make makepatchsum # and build again, or
   50: make makepatchsum && make clean && make patch # until all patches apply, if they failed at first
   51: make print-PLIST | diff -u PLIST -
   52: # modify PLIST
   53: rm $(make show-var VARNAME=WRKDIR)/.PLIST* # this deserves to be another target
   54: make stage-install
   55: # modify PLIST again or build again
   56: make test # just to check for regressions
   57: su root -c "make package deinstall bin-install" # or
   58: su root -c "make package replace"
   59: </pre>