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. |