Command Line Options

The only required argument for all commands using “undjava” is the project database file. The following table lists the command line options for “undjava”.

Option
Description
-a[dd] file [files]
-a[dd] @filelist.txt
Specify one or more files to add to the database. Files can be specified in two ways:
  • Individually: Separate filenames with spaces. For example -add *.java adds all *.java files in the current directory to the project. Absolute paths are used. For relative paths, use the -reladd option.
  • In a text file: Use -add @filelist.txt to add all files that are listed in that file to the project. The file must contain one file per line. Full or relative paths may be used. Relative paths are relative to the project file. A # sign in the first column of a line in the listfile indicates a comment. The file’s contents are evaluated one time only. If you want the file’s contents to be evaluated each time the project is analyzed, use @@filelist.txt.
This option may be used multiple times on the same command line.
-classpath jar_file [jarfile...]
-classpath @filelist.txt
Specify one or more .jar files to add to the class path. See Class Paths Tab.
-create [project file]
Create a new project. Creating a new database overwrites an existing database of the same name.
-db database
Specify the name of the database to create or open. An extension of .udj is provided if no extension is given.
-d[elete] file [files]
-d[elete] @filelist.txt
Specify one or more files to delete from the database. Wildcards are permitted. Files can be specified in two ways: individually (separated by spaces) or in a text file with one file per line.
For example -delete *.java removes all *.java files in the current directory from the project. Or use -delete @filelist.txt to delete all files that are listed in that file to the project. The file must contain one file per line. Full or relative paths may be used. Relative paths are relative to the project file. A # sign in the first column of a line in the listfile indicates a comment.
This option may be used multiple times on the same command line.
-error file
Specify a file to which error messages should be logged. If omitted then errors are sent to the standard error destination.
-h[elp]
Show the command line options.
-list [status]
Lists files in the project. Specify “status” to report the current status of each file: “Okay” if current or “Changed” if file has been modified since last parse.
-quiet
Use for quiet processing, i.e. status messages will not be written to the screen. This argument is optional. By default, some status messages are written to standard output.
-rebuild
Performs a full reparse of all project source files whether they have been modified or not.
-refresh
Performs an incremental reparse of the project source files. Only modified and dependent files are re-parsed. This is the default action when no other option is specified. If project parameters have changed since the last build, be sure to use -rebuild instead of -refresh.
-reladd
Add a relative source file reference to a project.
-rellist
List source files with relative references.
-terse
Report only errors and warnings. Do no list each file being parsed.
-v[erbose]
Use for verbose processing, i.e. status messages will be written to the screen. This argument is optional.

The following sections show example uses of undjava.


Scientific Toolworks, Inc.
http://www.scitools.com