ref: 39bf5b987e8ab53a74adec5a15b30f4eda85b357
dir: /sys/src/cmd/troff/FIXES/
March 11, 1994
If we are just plain old nroff (and not doing UNICODE) we should
only Lookup characters, not Install when we don't know them.
If we are troff, we Install them anyway
March 8, 1994
Nroff had problems with parsing quoted white space as options or
character code in some terminals tables. Changed by having scanf
include white space when necessary as suggested by Rich.
March 1, 1994
Made sanity check for terminal type depending on the trace level;
trace level set with -tn flag at start up
22 Feb, 1994
More pointer shuffling fixes.
18 Feb, 1994
More disabling of multibyte stuff. Fixed bug in n5.c: casetm didn'
know about the new format in the fontables.
Feb 17, 1994
Removed extra include <setlocale> from n1.c
Fixed dubious pointer shuffling in n7.c, t10.c & n8.c. Thanks Rich!
Feb 10, 1994
Disabled the multybyte stuff; only plan 9 will get it.
Jan 24, 1994
Fixed nasty bug discovered by td, which caused core dumps on
\D'l-0.002775i 0i' and apparently all numbers closer to 0
than -.002775. Fixed in storeline() and storeword() (n7.c).
Dec 16, 1993
nroff & troff -N were looking for the TYPESETTER variable, causing
troff: cannot open /sys/lib/troff/term/tab.202; line 1, file stdin
fixed my moving getenv("TYPESETTER") to t10.c in t_ptinit(void).
Dec 3, 1993:
The sequence \s+2\H'+10' came sometimes out in the wrong order
(x H before s), so there wasn't a difference bewteen \s+2\H'+10'
and \H'+10'\s+2. Now the fonts bits of the CHARHT are used to
register the current pontsize, so we can issue a s10 in t10.c
if needed. A bit sneaky.
Try to prevent double slashes in path names. Especially under
plan9 things started to look ugly.
Exception word list now grows dynamic.
Nov 30, 1993:
Allow multiple calls to .pi, requested by Rob.
.pi cat
.pi dogs
is now equivalent with
.pi cat | dogs
.ab now takes also optional error code:
.ab [n] [string]
If n and string, n is exit code, string is message
If n, n is exit code, ``User Abort, exit code n" is message
If !n and string, standard exit code, string is message
If !n and ! string, standard exit code, "User Abort" is message
Nov 24, 1993:
Reordered code to keep the UNASNI scripts happy.
Nroff dumped core reading terminal tables: apparenty under plan 9,
scanf includes the '\n'; added test for '\0' in parse in n10.c.
Relative tab settings (.ta +1C +2C) didn't work; anding the
previous value with TABMASK fixes this (caseta).
Nov 23, 1993:
Included code, originally done by bwk for plan 9, to handle
multi-byte characters.
Nov 3, 1993:
``pair internal'' two char names by shifting 16 bits. Will allow
the use of 16 bit characters sets (Unicode in plan9 etc.) for
macro's etc.
Oct 20, 1993:
Word & line buffers are now dynamic: No more word or line overflow
unless when we run out of memory.
Oct 11, 1993:
lost diversion warning pops up regularly with man macro's. Due
to a possible macro coding problem. Triggered by something like
troff -man:
.TP
.TP
foo
.ex
Minimal code:
.di aa
throw away this diversion (aa) while being defined.
.rm aa
.br
.di
Fixed by disallowing .rm to throw away current diversion. The
rn request will complain with:
cannot remove diversion aa during definition; etc.
Sep 29, 1993:
Some long standing fixes which never went back in the source.
Thanks to Janet & Rich.
Sep 28, 1993:
Changed getach() (n1.c), so it does't consider truncated
special characters as (8-bit) ascii. STX ETX ENQ ACK and BELL
are still allowed for the ultimate backwards compatibility.
Some code changes, so real ANSI compilers like the SGI version
(acc from Sun is a poor excuse for an ANSI compiler) don't
barf. Some compromises (static Tchar wbuf in n9.c) allowed so
the unansified stuff for non-ansi compilers (cc on Sun's) will
work as well.
Sep 9, 1993:
Be nice to Gerard. Now also word spaces in .tl and after
tabs/fleids etc.
Aug 12, 1993:
Tabs setting can now be humongous. We also allow 99 tabs to
accomodate tbl. As a side effect, NTM buffers are now 1K
Aug 11, 1993:
.R register, now contains maximum number of addessable
registers minus the number actually used.
Small esthetic changes in error messages; removed a statement
which wasn't reached anyway.
Aug 10, 1993:
Some more speed hacks: be smarter doing the linear table
lookups in alloc() and finds().
The real name of the det diversion size macro is now gd.
Aug 9, 1993:
A much faster way to find the end of a string/macro, by
remembering that when defined.
Aug 6, 1993:
Slightly more eficient way of skipping to the end of a
string/macro
Aug 5, 1993:
Prevent character sign extension for 8-bit charnames diversions
etc. by unpair
Aug 4, 1993:
Growing the dynamical macro/strings name space and registers
space (See the experiment of 21 July) now with bigger
increments. Casts added to satisfy non-ANSI compilers.
Aug 3, 1993:
Should check return value in alloc (n3.c), to prevent core dump
when memory gets tight.
July 28, 1993:
New request: .sg <div> sets the dn and dl registers to the size
of the diversion named in the argument. Doesn't do anything
when the named diversion doesn't exist. The name sg is
temporary until we find a better one.
July 21, 1993:
Experiment: Macro space & registers name allocated
dynamically. Note that current reallocation occurs in
increments of 1, to force the code to be executed a lot; a kind
of stress testing. Also, eight bit characters allowed in
macro/string names.
July 21, 1993:
Turn on the escape mode if the end macro is called.
July 20, 1993:
Tracing mode now default off
Don't print s stackdump either when a file specfied on the
command line argument cannot be opened
July 15, 1993:
Don't print useless line & current file informations when a
file specfied on the command line argument cannot be opened.
Sun ansi compiler doesn't default adhere to standards. Undid
the kludge in tdef.h
July 14, 1993:
Coding error made the tab type R not function properly
July 12, 1993:
Fixed a typo in the version stuff, noticed by Rich
July 9, 1993:
Added the dwb home configuration stuff, thanks RIch. Also,
NCHARS is big enough. Added a fflush to casetm, so .fm <file>
will be up to date.
June 25, 1993 (Rich):
-t option
reinstated for the sake of compatibility. Some old
shells scripts and man(1) from SunOs want this, sigh
Compiler and system dependencies
Some systems pull in sys/types.h via #include <time.h> and then
the compiler complains about two ushort typedefs. Therefore,
ushort is now Ushort (and uchar Uchar).
The SVID specifies a strdup, POSIX doesn't, anyway, troff
provides its own version, slightly different then the standard
one. A To prevent name clashes with that definion, renamed to
strdupl.
June 24, 1993 (Rich):
-V option added for DWB3.4 (rich)
May 18, 1993:
Trivial fix (.cf) request for troff -a
issuing
.cf /dev/null
with troff -a gives some spurious output:
H720
H720
s10
f1
fixed by checking for ascii mode it ptesc(), ptps() and
ptfont() in t10.c
Enhancement
Added a .tm request to roff. Works just like .tm, but now
it will do it to file. The name is coined by Carmela. Great
for creating indeces & toc's (we hope).
May 18 1993:
Compatibilty change
Somebody complained that his favorite macro didn't work:
it had a BELL (^G) in the name. This was a non-documented
feature of earlier versions of troff (although the
documentation actually doesn't say that you can. (They can
only be used for delimiters or with the tr request), so it
isn't that important).
But the sake of eternal backward compatibilaty I allowed
some control characters like, STX, ACK, etc. also be part
of a macro/string name.
While at it, I made it also possible to have eight bit
characters be part of the name. It might be that this screws
up the way users think about these things. For UNICODE
versions, they probably want to do that as well, and that
won't work as easy, (because these characters are 16-bits
wide), so it is dubious whether we actually want this.
BTW. Now
.de \(ts\ts
.tm terminal sigma macro
..
.\(ts\(ts
also works, as long the internal cookie for ts isn't more then
eight bits.
May 12, 1993:
Syntax change
Some requests accept tabs as a separator, some don't and
this can be a nuisance. Now a tab is also recognized as
an argument separator for requests, this makes
.so /dev/null
works.
To be more precise, any motion character is allowed, so
.so\h'5i'/dev/null
will work as well, if one really wants that.
It will be a problem for users who really relied on this as in
.ds x string
and expect the tab to become part of the string a, but I haven't
seen any use of that (obscure trick).
May 6, 1993:
Eileen count fixed
Troff sometimes went in a loop, and exited with: ``job
looping; check abuse of macros'' (also known as the Eileen's
loop). It can be forced with the next trivial programme:
.de ff
.di xx
..
.wh -1 ff
.bp
Basically what happens is that a page transition now will
happen in a diversion, which doesn't make sense. Wat really
happens is that eject() (in n7.c) doesn't eject the frame
because we are in a diversion. This cause the loop in n1.c
(because now always stack->pname <= ejl). Adding check on
whether we are not in a diversion takes care of the problem.
March 30, 1993:
Need request, .ne
When there is a begin of page trap set, and the first thing
in the file is a .ne request, the trap gets fired, but,
the x font R etc. cookies doen't come out, because the
troff thinks that the first page pseudo transition already
took place. Fixed by forcing the start of the first page
in the casene request with the same code as in casetl (which
caused a similar problem quite some time ago).
Change to .cf request ``Here document''
If the argument of .cf starts with a <<, the rest of it is taken
as an EOF token. It will reat the rest of the input until it hits
the EOF token and copies it to the output. This is similar as
the shell's ``here document'' mechanisme and put in place to
improve the kludgy way picasso, picpack etc. now include
postscript.
Using troff -TLatin1 (DWB version) and \N'...' caused core dump
In t11, in chadd, it should test on NCHARS - ALPHABET to see
whether we run out of table space (and we probably should beaf
up NCHARS for the DWB version).
March 16, 1993:
Diversion rename bug fix
It is possible to get troff in an infinite loop by renaming a
diversion in progress, and calling it later with the
new name (as in .di xx, .rn xx yy, .yy). The effect depends on
whether troff already put stuff in the diversion or not.
Fix by having .rn also rename the current diversion (if
there is any and when appropriate). If the diversion calls
itself by the new name and given the fix made on 11 nov
1992, this will now result in an error. (BTW, the fix from
11 nov is improved: diversions nest, so we have to account
for that).
December 18, 1992:
Some people have complete novels as comments, so we need
to skip comments while checking the legality of font files.
thaks Rixh
December 16, 1992
Some people rely on the order that -r arguments are given,
so that troff -rC1 -rC3 ends up setting register C to 3.
Because cpushback() pushes things in a LIFO order back, we
have to do the same to get -r args in a FIFO order.
Nov 17, 1992:
Giving a -rL8 option cuased the string .nr L 8 to be printed
on the output, using the wonderful 3b2. Some garbage was
left in buf[100] in main(). Fixed by setting buf[0] explicitly
to 0 (because some C-compilers complain about ``no automatic
aggregate initialization'').
Nov 11, 1992:
Diversion bug fix
If a diversion was being read and the input is faulty so
the diversion was reading in itself, it caused troff to
loop undefinitely. This was easily fixed by a test in
control(a,b) in n1.c.
Something similar things might happen with macros causing
the ``eileenct problem'', but I didn't look for that. We
have to wait until it happens.
Oct 26, 1992:
Numeric arguments:
Illegal argments are treated as missing arguments. This
changed the semantics of .ll, .ls, .in, .lg, .ul, .cu .lt
(which acted as if the argument was 0) and .ps which was
simply ignored with an illegal argument.
Tidied up number parsing in atoi1(). This prevents arguments
like .x or 1.2.3.4 being interpret as a legal number (nonumb = 0)
Numeric arguments error reporting:
Controlled by .pt, illegal numbers are now reported (default
trace mode is 1). This is also true for the escapes:
\h'..', \v'..' \H'..', \S'..', \N'..', \D'..', \l'.., \L'..
and \x'..'.
\D'c' is the only drawing request which doesn't take a pair
of numbers as arguments, so a special case is put here in
setdraw() (This code actually could use an overhaul to get
better parsing. As long as the \D'..' cookies are machine
generated it is low on the priority list).
Don't generate an error if the illegal argument to a request
is a \}. It is too painful to do right (although it can be
done, but it would clutter getch() and getcho() even more).
Input line numbers (.c register) bug fixes:
In not taken branches of .if or .ie, the input line #
(numtab[CD].val) should be raised when necessary (in eatblk()).
For concealed newlines, we still should count the line for input.
Setfield (n9.c) sometimes pushes the rest of the line back to
the input (including \n), without adjusting numtab[CD].val
Because .c (and so numtab[CD].val) is the number of lines read
and the error might actually happen in the current line
(before seeing the '\n), we need to apply correction in
errprint when nlflg set. (This correction needs to be undone
when inside a macro because the nlflg is set by reading the
args to the macro).
Line number setting (.lf) request bug fixes:
I interpret that the .c register will contain the number of
read lines, not including the current one.
Also, don't change the input line number when the first
argument of .lf is not a number.
As a net effect, the next input
.EQ
.EN
.ab
will generate the same output whether eqn has been used or not.
If request bug fix:
A ``.if page .tm foo'' caused the next line being ignored;
This bcause when the 2nd delimiter of a string couldn't be
found in cmpstr, the next line was always eaten. Solution:
in caseif1, if the condition is false, we should check
nlflg before eating a block. (Note: We might have eaten
\{\ as well. We could disallow the \{\ in a string to be
compared to prevent that but that might break other things).
Enhancement to .pt:
The .pt now pops the previous values when no argument is
specified. Turned out to be handy when chasing for problems.
Just ``bracked'' the code with .pt 7 and .pt and you get
a trace of only that block. The meaning of the arguments
is now:
01 trace numeric arguments (default on)
02 trace requests
04 trace macros
Abort request (.ab) beautification:
Don't print the extra carriage return when .ab is called
without an argument.
Oct 12, 1992:
(Comments & spelling errors from this day on by jaap)
replaced 32767 by INT_MAX in several places to allow for very
long pages (on 32-but machines).
The ``.fp 1 R \"COMMENT'' complains about ``./troff: Can't
open font file /usr/lib/font/devpost/h'' on some systems. It
sees the tab as part of the optional font file. Apparently it
is system dependent whether isgraph() includes the tab
character. Fixed by using getach() in getname() in n1.c
instead.
Aug 28, 1992:
removed call to popi from rdtty(); it was eating up the
rest of the macro if it was used from within one. (thanks, jaap)
Jul 21, 1992:
added extra test in nextfile() to pop current input file
only if not in .nx command. thanks to jaap.
added test in getword() to avoid hyphenating after \z character,
which prevents any hyphenation inside \X'...'. thanks to jaap.
added, then removed, code in getword() to prevent hyphenating
anything shorter than 6 characters. looks like it changed a
lot more than i thought.
Jul 12, 1992:
added .pt request to trace macros and requests (from jaap).
.pt N Print trace of macros (N=1), requests (N=2) or both (N=3)
Jun 5, 1992:
added tests to t.twrest and t.twinit to avoid 0 deref in
n2 and n10, for nroff -t xxxxx. thanks to Rich Drechsler.
May 22, 1992:
added extern decls to e.g., void Tchar (*hmot)(void) in tdef.h
and added definition to ni.c, so pointers are defined explicitly.
makes it work on turbo c++ and probably others.
changed a couple of isdigit's and isgraph(getch()) to avoid
multiple evaluation (even though it shouldn't happen).
Made /usr/bin/nroff a shell script.
May 12, 1992:
n1.c: need p++ after strrchr to skip / in program name.
thanks to Rich Drechsler.
Apr 17, 1992:
casefi(), n5.c: .u register should be 0 or 1, not incremented
with each .fi.
Apr 5, 1992:
fiddled n7.c and added _nmwid to the environment, to add a
5th argument to .nm: the maximum number of digits in any
line number. default is 3, which was previously hardwired in.
added jaap's code for yet another register which actually delivers
a string, called .S (so it can easily go in the switch in setn()
in n4.c); it delivers the current tabstop and alignment modes in
a format suitable for a subsequent .ta \n(.S command:
.ds T \n(.S
...
.ta \*T
Mar 30, 1992:
added test in getword to avoid hyphenating things with motions
(and avoid a core dump sometimes too).
Mar 13, 1992:
\n(sb initialized wrong in setwd().
TYPESETTER=foo troff -Tpost used foo instead of post.
Mar 12, 1992:
rearranged tests in popf so that .so is closed properly before
moving on to the next macro package.
Mar 1, 1992:
input mechanism rearranged to use getc() instead of stack of
explicit input buffers. 5-10% slowdown.
Jan 28, 1992:
fixed .tm \(mi to print something sensible. thanks to jaap.
Jan 2, 1992:
fiddle setfp so doesn't put out font stuff if -a turned on.
Dec 17, 1991:
copy 3rd argument in .fp commands to x font ... lines when it contains
a /, for testing fonts locally.
Dec 13, 1991:
parameterize the font directories, etc., so can be set in makefiles.
added -N argument to run as nroff.
Nov 8, 1991:
add a maplow(towlower...) in n8.c to handle brain-damaged libraries.
Nov 2, 1991:
merged nroff into troff, based on Ken's plan 9 version.
merged nii.c into ni.c, removed tw.h, etc. more work needed
to make this stuff cleaner.
July 27, 1991:
added test in setn in n4 to fix bug that permitted things like
\n (ab to work "properly". thanks to jaap for finding and fixing.
added paranoid testing in t11 to make sure font files look ok.
May 13, 1991:
moved evaluation of \(xx from copy mode to non-copy mode, so that
weird character names wouldn't get reevaluated in argument parsing.
installed july 27.
May 6, 1991:
increased size of hyphenation exception buffer to 512 from 128
Apr 14, 1991:
added an extra redundant call of ptfont in setfp, since it appears
that some versions of adobe transcript assume that an "x font" command
means to change the actual font as well. the fix preserves the current font.
thanks to david brailsford and friends for spotting the problem.
fixed up tests in alpha() in n8 to defend isalpha() against too-big inputs.
punct() argument had wrong type too. thanks to rich drexler and peter nelson.
Mar 19, 1991:
fixed bug that prevented .rd from working with new corebuf organization.
fixed bug that caused .ig inside diversions to give bad storage
allocation. thanks to arthur david olson, whose fix was on netnews
3 years earlier.
Mar 5, 1991:
huge table sizes for kanji.
Feb ??, 1991:
working on dealing with large alphabets, notably kanji.
added "defaultwidth" to font descriptions, for characters
not given an explicit width.
Jan, 1991:
added tex hyphenation, using standard tex data files, but not the
elaborate compressed trie, which is a lot of trouble to save maybe
40k bytes. this appears to run at exactly the same speed as before.
so far this stuff reads into a fixed size array; that should change.
it should also be possible to deal with multiple languages.
the command .ha sets the algorithm. .ha 1 => tex, with troff rules
if tex doesn't hyphenate; .ha 0 gives troff rules, and .ha resets
to the default, which is tex. the hyphenation algorithm is part of
the environment, a nod to a future in which i handle more than one
language.
replaced the fixed size corebuf array for string/macro storage by
a dynamic structure that can grow.
this appears to slow things down by maybe 3%. the code is about
the same complexity.
Dec 27, 1990:
converted to ansi c, based on some work by ken thompson, but not
as thoroughly as he did. there is a shell script unansi and an awk
program cvt that will help you step back in time if you do not have
an ansi c compiler.
moved the special-name characters up to 256 instead of 128, although
done in terms of ALPHABET, so one can pass 8 bit characters through.
removed lots of 0177's and similar numbers. input is now not filtered,
and if a character with the 8th bit on comes in, it will go out again.
fixed t11.c to read character names in hex or octal as well as
single-character ascii.
unknown characters are now carried through with width = spacewidth.
needs a way to set widths.
removed all signal handling from troff. you signal, you die.
added -d option to print version number.
Dec 7, 1990:
.fp 3 V VERYLONGNAME used to truncate the name to 10 chars; fixed.
increased the limit on FBUFSZ for tables with very long fields.
changed atoi1() to use double to avoid intermediate overflow.
moved filenames like /usr/lib/font into tdef.h for easy change.
removed some dreggish definitions.
cleaned up non-portable error printing stuff; fixed up some messages.
Dec 12, 1989:
Removed the .! command, an undocumented synonym for .sy.
Dec 4, 1989:
Another wart to the \X code, to try to preserve blanks in all situations.
Nov 17, 1989:
A number of small changes preparatory to getting rid of nroff.
The argument -Tnroff or -Tnroff-12 changes some internal values
so that the predicate .if n is true and certain arithmetic operations
are done as if nroff. This design is not yet final.
Nov 7, 1989:
Fixed hyphenation for nov-ice, ad-vice, de-vice, ser-vice, *-vice.
Oct 11, 1989:
It is now permitted to do an explicit change to font S.
It is not clear what will break (though nothing seems to have).
Oct 10, 1989:
Modified flush code to always put out \nH instead of sometimes h.
This makes it easier to parse the output for positioning.
Sep 9, 1989:
Fixed internal representation of \D'~...' so that it
is immune to .tr ~ and variations. No external change.
Aug 9, 1989:
Changed .tm so it outputs \e, \%, \-, \&, \(blank).
This might break indexing code.
Only in the new version, as are all subsequent fixes.
July, 1989:
A major internal change: font information is read in ascii
instead of the weird binary format of makedev (which is now dead).
character names need not all appear in DESC; new names that
appear when a font is used become part of the set of known names.
There are some flaky bits here (it's conceivable that some \N
number will collide with a real name), and it's probably 10-15%
slower. Tant pis.
As a by-product, nroff no longer compiles. I'll probably get
back to this, but an alternative is to bag it once and for all.
May 25, 1989:
Another bug in \l, this time when width is 0. Not installed,
since it's in the new font version.
Apr 23, 1989:
Fixed bug in n9 that caused core dump with unterminated
\l command, like \l'1.5i
ptflush no longer called when -a is on.
Apr 12, 1989:
fixed bug in n2 that failed to suppress printing of \!
output when a -o was in effect.
Apr 5, 1989:
.fl and \X now cause output of size, font, hpos and vpos.
this is necesary for postprocessors that intend to insert
independent material, such as postscript.
Feb 1, 1989:
wait for .pi pipe to empty before exiting
Oct 2, 1988:
default is now -Tpost
Sep 19, 1988:
added abortive code to handle built-up characters by
passing something through as \D'b...'. never used.
Jul 4, 1988:
replaced the sbrk nonsense in n3.c by calls to malloc.
\N now tests against proper font size.
installed Jaap Akkerhuis's code (mutatis mutandis) for
permitting up to 99 fonts, swapping them into font pos 0
as needed. fixes the long-standing problem of having
multiple font changes on a single output line.
Jul 2, 1988:
\X now preserves spaces even when contents are diverted.
\N code safer -- NTRTAB and NWIDCACHE enlarged.
Jul 14, 1987:
Fixed obscure bug causing incorrect indentation of .mc output.