Q: It seems that the troff macros for Sybase aren't working correctly.\
\
A: The correct troff macro file does ship with 1.0. There are a couple of likely possibilities for the confusion.\
\
Possibility #1:\
--------------\
Symptom: You got the message "Cannot open /usr/lib/tmac/tmac.syb"\
\
Problem: You either never installed or have deleted the file '/usr/lib/tmac/tmac.syb'.\
\
Solution: Copy it from the 1.0 release optical.\
\
Possibility #2:\
--------------\
Symptom: You get many lines of "error" messages like the following:\
\f1\fs24 .hT "DB\\(hyLibrary Reference Manual"\
.H0 "Introduction" 1 Section\
.H1 "Overview of DB\\(hyLibrary" 1-1\
.I DB\\(hyLibrary, overview of:1:1\
.I DB\\(hyLibrary, contents of:1:1\
.H2 "Transact\\(hySQL" 1-1\
.I Transact\\(hySQL:1:1\
.I SQL database language:1:1\
.I stored procedures, Transact\\(hySQL:1:1\
.I procedures, stored, Transact\\(hySQL:1:1\
...\
\f0\fs28 \
Problem: None actually. This is a designed feature of the Sybase troff macros. The macros are producing a stream that is intended to serve as an input file for automatically producing a table of contents. This raw table of contents is sent to stderr. Unfortunately the Sybase docs and NeXT's release notes don't mention this--so it's easy to see how a you would be alarmed if you follow the Sybase directions.\
\
Solution: Just ignore the Table of Contents gibberish--the PostScript files produced are perfectly fine for printing or viewing. Unfortunately we do not ship the Table of Contents macros, so the raw T of C stream is completely useless.\
\
\
Possibility #3:\
---------------\
Symptom: In Digital Librarian, only part of the .nroff file is displayed, even though you can see with Edit or cat that it's much longer. Or the file prints incompletely.\
\
Problem: Some files contain ".Sc" directives. These reference illustration files that aren't provided with the NeXT release (because they were in an incompatible format). Nroff chokes when it reaches these directives.\
\
Solution: Simply delete all the lines consisting of ".Sc". These are found, for example, in the files sag2 and sag3.\
\
Many problems such as this are fixed in the 2.0 release of the Sybase Client Libraries.\