- FWEB supports color modes in which messages to the terminal can appear in colors chosen by the user; see Color. The color mode is set by the new command-line option
-C
(see -C_).- A previously undocumented feature is that for the C-like and Fortran-like languages, FTANGLE expands the binary notation
0b...
to an unsigned decimal number. See Phases.
A few obscure commands have been slightly redefined. Sorry about that, but it makes for more symmetry and ease of recall, and/or solves some technical problems.
- Although it was never documented, previous versions permitted either lower or upper case for the
@
commands that set the language--e.g., both@c
and@C
worked. Now only the lower-case forms work. (The upper-case forms may have other meanings.)- The style-file parameter
Ext_delimiter
now begins with an upper-caseE
; formerly it was lower-case.- The behavior of the optional argument of the
\Title
macro has been slightly redefined. The new, more symmetrical form is\Title[Short title]{Long title}where
Long title
is printed on the title page andShort title
is used for the running header within the document. See Table of Contents.- The line-break commands
@/
and@\
(formerly identical) now behave slightly differently.@/
breaks the line just as it would if the line had been too long and been spontaneously broken. See AT/.@\
backspaces one unit of indentation after breaking the line. See ATbs. Usually, one should use@/
(sorry; I was previously recommending@\
. For an example in which it is natural to use@\
, see ATbs.- The names of some of the code-typesetting macros in
fwebmac.sty
have been changed to conform to the convention that they should all start withW
. This change will be invisible to you unless you happen to have user macros of your own that start that way or (perish the thought) you have redefined low-level and obscure code infwebmac.sty
.
This release adds some features for managing large projects, including
(i) the idxmerge
utility that merges indexes produced by several
FWEB files, (ii) a mechanism for accessing RCS-like information in
the ignorable commentary at the beginning of the file, and (iii) the
ability to include FWEAVE-formatted code into a standard LaTeX
document. It also fixes a variety of miscellaneous bugs.
- A stand-alone index file suitable for processing by
makeindex
can be produced by the-XI
option. See Using makeindex.- Stand-alone indexes produced by
-XI
can be merged with theidxmerge
utility. See Merging indexes.- FWEAVE-formatted code can be included in a standard LaTeX2e document by means of the
fwebinsert
package. See Inserting woven code.- Revision-control-system (RCS) information that appears in the ignorable commentary between the optional
@z
and@x
that begin an FWEB file (see ATz) is accessible in the body of the file through the built-in function$KEYWORD
(see $KEYWORD) and the new commands@K
(see ATK_) and@k
(see ATk). These features can access RCS-like keywords that are not known to RCS itself, as long as they fit the proper syntax (see ATz).- The
-h
option now permits easy access to the GNUinfo
browser if it is installed. See -h.- Underscored versions of built-in functions have been removed!!! E.g., use
$IF
, not_IF
. This change was warned about in the last release.- Single-character identifiers can now be completely cross-referenced via the
-W1
option. See -W1.- Some module warning messages can be eliminated with the
-W@
option. See -WAT.- The
@q
command (still experimental) has been added to locally turn on or off the the line and module comments in the tangled output. See ATq.- The level of verbosity of FWEB's informational messages can be controlled with the
-M
option. See -M_.- C/C++ programmers may find the command
@{
useful. See ATlb.- The
-nC
option has been added for FORTRAN users; it kills commented lines at a very early stage in the processing. This can be useful when converting existing codes to FWEB. See -nC- FORTRAN-90 (see -n9) now defaults to free-form syntax.
- As of the non-beta Version 1.61, free-form FORTRAN-90 now inserts semicolons automatically in the code part. Thus, textbook FORTRAN-90 examples will weave correctly without the annoyance of explicitly terminating each statement with a semicolon. (If you prefer to put in the semicolons explicitly, use
--n;
to turn off the auto-insertion.) See -n;- The default meaning of the
-k
option was changed; now both lower- and upper-case forms of FORTRAN I/O keywords are recognized. See -k.- Various changes were made to internal code in
fwebmac.sty
. This should not affect anyone unless you have redefinedfwebmac
macros. If so, you'll have to compare your versions with the present ones. For example, colons as argument delimiters in\def
s have been removed.- It is now (barely) possible to use
\documentstyle{revtex}
instead of the default\documentclass{article}
. See REVTeX.
- Perhaps the most significant bug is that some high-order (>= 128) characters in strings may not typeset or be processed correctly. This may be an issue for some users of foreign-language packages. The difficulty arises from a design decision made by a previous author. This has at least partly been fixed, but I eschewed a substantial overhaul for fear of breaking other things.