Project

General

Profile

« Previous | Next » 

Revision 9450

Added by Aaron Marcuse-Kubitza almost 12 years ago

lib/sh/util.sh: logging: documented `make` equivalents of the various verbosities, where available. (many of the verbosities, such as level 1, are sorely needed in make to avoid excessive output.)

  1. verbosities (and `make` equivalents):
  2. 0: just print errors. useful for cron jobs.
  3. vs. make: equivalent to --silent
  4. 1: also external commands run. useful for running at the command line.
  5. vs. make: not provided (but sorely needed to avoid excessive output)
  6. 2: full graphical call tree. useful for determining where error occurred.
  7. vs. make: equivalent to default verbosity, but with much-needed indents
  8. 3: also values of kw params and variables. useful for low-level debugging.
  9. vs. make: not provided; need to manually use $(error $(var))
  10. 4: also variables in util.sh commands. useful for debugging util.sh.
  11. vs. make: somewhat similar to --print-data-base
  12. 5: also variables in logging commands themselves. useful for debugging echo_*.
  13. vs. make: not provided; need to search Makefile for @ at beginning of cmd
  14. 6+: not currently used (i.e. same as 5)

View differences:

util.sh
213 213 

  		




  214
  214
  
    
verbosity_int() { round_down "$verbosity"; }


  		




  215
  215
  
    

  		




  216
  
  
    
# verbosities:


  		




  
  216
  
    
# verbosities (and `make` equivalents):


  		




  217
  217
  
    
# 0: just print errors. useful for cron jobs.


  		




  
  218
  
    
#    vs. make: equivalent to --silent


  		




  218
  219
  
    
# 1: also external commands run. useful for running at the command line.


  		




  
  220
  
    
#    vs. make: not provided (but sorely needed to avoid excessive output)


  		




  219
  221
  
    
# 2: full graphical call tree. useful for determining where error occurred.


  		




  
  222
  
    
#    vs. make: equivalent to default verbosity, but with much-needed indents


  		




  220
  223
  
    
# 3: also values of kw params and variables. useful for low-level debugging.


  		




  
  224
  
    
#    vs. make: not provided; need to manually use $(error $(var))


  		




  221
  225
  
    
# 4: also variables in util.sh commands. useful for debugging util.sh.


  		




  
  226
  
    
#    vs. make: somewhat similar to --print-data-base


  		




  222
  227
  
    
# 5: also variables in logging commands themselves. useful for debugging echo_*.


  		




  
  228
  
    
#    vs. make: not provided; need to search Makefile for @ at beginning of cmd


  		




  223
  229
  
    
# 6+: not currently used (i.e. same as 5)


  		




  224
  230
  
    

  		




  225
  231
  
    
# definition: the log_level is the minimum verbosity needed to display a message


  		












Also available in:  Unified diff