List Jobs from Project Having a Given Directory

The CLI Program vst - Vov Show Jobs (aka Show Tools)

The command line program vst lists the jobs from the project that were executed within the indicated working directory, with a default of also having the current environment.

A job in a project might be referred to as Running a Tool, so the name for this program was created to be an acronym for "Vov Show Tool."

vst: Usage Message
  
  DESCRIPTION:
      Show the jobs that have been executed 
      in one or more directories.  By default:
      - look at the current directory.
      - show only the jobs with same environment as the current one.
  
  USAGE:
      vst [OPTIONS] [dir1] ...
  
  OPTIONS:
      -help           -- Show this help
      -quiet          -- Be quiet, no explanations
      -fast           -- (Obsolete option: Maps to -all)
      -all            -- Show all jobs, regardless of the environment.
                         Also show system jobs and subjobs.
      -long           -- Show more information (LEVEL and ENV)
      -LONG           -- Show even more information
      -Output 'format'-- Choose output format
      -systemjobs     -- Show also the system jobs
      -subjobs        -- Show also subjobs (components of a bigger job)
      -regexp <expr>  -- Filter lines with a regular expression
      -sort           -- Sort lines
  
      Options can be truncated to 1 or 2 characters.
      Option -regexp can also be abbreviated to -rx.
  
  EXAMPLES:
      %  vst
      %  vst -all
      %  vst -a
      %  vst -long ..
      %  vst -O '@LEVEL@ @COMMAND@' 
      %  vst -re 'ab[cC]+'
  

Show Jobs for Current Directory and Environment (BASE)

By default, the jobs in the current directory and with the current environment are listed:
% vst
vst: rule   is 'ISJOB==1 ENV==BASE CWD==${SEV_PROJECT_DIR}/common/src/doc_html'
vst: format is '@ID@ @STATUS:10@ @COMMAND@'
00387448 VALID      vov ./build.tcl index.tcl
00392249 VALID      vov ./makeindex.tcl
00425481 VALID      clevercopy work/index.html ../../doc/html/index.html

Show Jobs for Current Directory and ANY Environment

Use option -all or -a to list all jobs regardless of the environment.

You can change the output format using either the option -l, -L or -O.
% vst -a
vst: rule   is 'ISJOB==1  CWD==${SEV_PROJECT_DIR}/common/src/doc_html'
vst: format is '@LEVEL:3@ @ID@ @STATUS:10@ @ENV:8@ @COMMAND@'
  2 00587448 VALID      GNU      vw gcc -c -g strtr.cc
  2 00587448 VALID      GNU      vw gcc -c -g amos.cc
  2 00387448 VALID      BASE     vov ./build.tcl index.tcl
  4 00392249 VALID      BASE     vov ./makeindex.tcl
  6 00425481 VALID      BASE     clevercopy work/index.html ../../doc/html/index.html