Read Me

SIMPLE Tcl LINT FOR GLOBAL VARIABLES
====================================

(c) 2020 Lloyd Wood <lloydwood@users.sourceforge.net>

This simple script attempts to identify and report
unnecessary global variables that are declared,
but are not used, in Tcl procedures.


Use is:
	./lint-global-vars.tcl file.tcl
or
	./lint-global-vars.tcl <list of files>

Try:
	./lint-global-vars.tcl *.tcl | more
to report on an entire directory of Tcl
sourcefiles.


Sample test cases can be checked by running:
	./lint-global-vars.tcl global-var-test-cases.tcl


Some caveats:

- Seemingly unused global variables declared in
  a procedure that sources a script may be relied
  on and used by the sourced script.

- it is possible to have a global declaration
  of a variable called 'global', which makes
  checking slightly more difficult.


Lloyd wrote this to tidy up the Tcl/Tk-based SaVi
satellite constellation visualization software:
	http://savi.sourceforge.net/