Node:Options,
Previous:Syntax,
Up:Starting
Command-line options
Command-line options may be put, one per line, into the initialization file
.fweb
(which is always in the user's home directory).
In that file, options beginning with a hyphen are processed before
the command-line options (so command-line options can override the
defaults). To force an option to be processed after the
command-line options, preface it with an ampersand
rather than a hyphen; this is rarely necessary.
To make sense of the plethora of options, it helps to know that options
beginning with n
are related to FORTRAN; those beginning
with r
are related to RATFOR. Some flags that can be set
separately for those two languages also have a global option that sets the
flags for both languages simultaneously; cf. -n/
, -r/
, and
-/
.
Some options take arguments. For example, an FWEB macro can be
defined from the command line by saying something like -mIBMPC=1
.
Unlike many UNIX utilities, no spaces are allowed between any
option and its argument. For example, if one says -m IBMPC
,
FWEB will think that IBMPC
is a file name.
- Negating options: How to invert the meaning of an option.
- -1: Brief debugging mode.
- -2: Verbose debugging mode.
- -@: Display information about control codes.
- -A: Turn on ASCII translations.
- -B: Turn off audible beeps.
- -b: Number blocks.
- -C: Set the color mode.
- -c: Set global language to C.
- -c++: Set global language to C++.
- -D: Display information about FWEB's reserved words.
- -d: Convert unnumbered `do...enddo's to Fortran--77.
- -E: Change the delimiter of a file-name extension.
- -e: Turn on automatic file-name completion.
- -F: Compare output files with old versions.
- -f: Turn off module references for identifiers.
- -H: Scan #include files to format typedef and/or class commands.
- -h: Where to get help.
- -I: Append a directory to search list for include files.
- -i: Don't print contents of @I include files.
- -i!: Don't even read @I include files.
- -j: Inhibit multiple includes of the same file.
- -k: Don't recognize lower-case forms of Fortran I/O keywords.
- -L: Select global language.
- -l: Echo the input line.
- -M: Set output message level.
- -m: Define an FWEB macro.
- -m4: Understand the m4 built-in commands.
- -m;: Append pseudo-semicolons to FWEB macro definitions.
- -n: Set global language to Fortran--77.
- -n9: Set global language to Fortran--90.
- -n@;: For Fortran, supply pseudo-semicolons automatically (default).
- -n;: For Fortran, supply actual semicolons automatically.
- -ncolon: In Fortran, place statement labels on separate lines.
- -nb: In Fortran, number the ifs and dos.
- -nC: In Fortran, ignore single-line comments ('C', 'c', or '*').
- -np: Print semicolons in woven Fortran output.
- -n\: In Fortran--90, free-form syntax continued with '\\'.
- -n&: In Fortran--90, free-form syntax continued with '&'.
- -n/: In Fortran, recognize '//' as the start of a short comment.
- -n!: In Fortran, make '!' denote the start of a short comment.
- -n): In Fortran, reverse array indices.
- -o: Turn off FWEAVE's mechanisms for overloading operators.
- -q: Don't translate Ratfor.
- -P: Select TeX processor.
- -p: Set style parameter.
- -r: Set the global language to Ratfor--77.
- -r9: Set the global language to Ratfor--90.
- -rb: In Ratfor, number the ifs and dos.
- -rg: Set |goto| parameters.
- -rk: Suppress comments about Ratfor statement translation.
- -rK: Write out comments about Ratfor statement translation.
- -r@;: Turn on Ratfor's auto-semi mode, using pseudo-semicolons.
- -r;: Turn on Ratfor's auto-semi mode, using actual semicolons.
- -r/: In Ratfor, recognize '//' as the start of a short comment.
- -r!: In Ratfor, make '!' denote the start of a short comment.
- -r): In Ratfor, reverse array indices.
- -s: Print statistics about memory usage.
- -T: Flag-setting commands for FTANGLE.
- -t: Truncate identifiers.
- -U: Convert reserved output tokens to lower case.
- -u: Undefined a predefined or command-line macro.
- -V: Print version number.
- -v: Make all comments verbatim.
- -W: Flag-setting commands for FWEAVE.
- -w: Change name of FWEB's macro package.
- -X: Print selected cross-reference information.
- -x: Reduce or eliminate cross-reference information.
- -y: Allocate dynamic memory.
- -Z: Display default values of style-file parameters.
- -z: Change name of style file.
- -.: Don't recognize dot constants.
- -\: Explicitly escape continued strings.
- -(: Continue parenthesized strings with backslashes.
- -colon: Set starting automatic statement number
- ->: Redirect tangled output.
- -=: Redirect tangled output.
- -#: Don't print comments about line numbers and module names
in tangled output.
- -+: Don't interpret compound assignment operators.
- -/: Recognize '//' as the start of a short comment.
- -!: Make '!' denoted the start of a short comment.
- Info options: Information options.