This is SybaseDoc-1.0-printing-Sybase-docs in view mode; [Up]
Date: Sun 05-Dec-1989 16:13:28 From: Unknown Subject: SybaseDoc 1.0 - printing Sybase docs I've FTPed a file called SybaseDoc-1.0.tar.Z to the pub/next/submissions directory at cs.orst.edu. This file might be of interest if you are trying to print the Sybase User's or Administration Guide. Attached is the README file. I hope someone finds this of use. ========================================================================== README file for SybaseDoc-1.0 (December 3, 1989) I wanted to print the Sybase documentation, so I followed the suggestions in the document /NextLibrary/Documentation/Sybase/README.wn. The suggestions did not work completely due to the following problems: 1. Several figures are missing which causes troff to abort. These figures are included via the .so directive that's part of the .Sc macro (file name is /usr/lib/tmac/tmac.syb). Parts of the Administration Guide (SAG), User's Guide (SQLUG), and Command Reference (COMREF) have this problem. My solution: I changed the .Sc macro to generate a box giving the missing figure's name. 2. The table of contents macro file (/usr/lib/tmac/tmac.sybtoc) is missing. When you use the troff command line option -rT1, the table of contents is generated to the screen. If you redirect this output and try to format it with -msyb you'll see the problem. My solution: None. 3. The Sybase documentation is designed to be formated via ditroff (available from AT&T) using 9 different fonts. This makes the documentation difficult to read when formatted via troff because font/style changes above 4 are ignored. My solution: Use the more readable Times font with troff and let the fixed pitch examples by misaligned. (An alternative solution would be to use Courier for the entire document -- body and examples.) 4. The README.wn document neglects to tell you to use 'tbl' on the source files prior to using troff. My solution: Use 'tbl'! :-) Going with the overkill method, I've created two Makefiles that will correctly turn the SAG and SQLUG into PostScript files that can be printed or viewed. Included with these two makefiles are three Sybase files that needed changes and a third makefile to put things into place. The files included in SybaseDoc-1.0 are: README - this file disclaimer - Sybase document with .fp references removed Makefile - Makefile to put these files into place Makefile.SAG - Makefile for SAG (Administration Guide) Makefile.SQLUG - Makefile for SQLUG (User's Guide) titpage.sqlug - Sybase document with .fp references removed tmac.syb - Sybase macros with .Sc macro changed 1. After you have these files unpacked, edit Makefile's INSTALLDIR to indicate where you'd like things installed. (The default is the Next supplied Sybase documentation directory, which would require the proper access.) 2. If you change the default install directory, use 'make installdir' to copy the necessary Sybase documentation into place. 3. Use 'make install' to merge the new files into the install directory. With that done, you can use the Makefiles to create PostScript versions of the SAG and SQLUG. Just move into the install directory, change to either SAG or SQLUG, and type 'make'. ('make help' with give some additional usage in case you're interested.) I'm sorry if this is confusing. Best I could do on short notice. ;-) I suppose something similar could be done for the Command Reference (COMREF) and Database Library (DBLIB) documentation. Not me, not tonight. NeXT is aware of these problems. I understand they are working with Sybase and should have things resolved in the next release. No date given. ========================================================================== Doug Brenner, Weeg Computing Center, The University of Iowa, Iowa City, IA dbrenner@umaxc.weeg.uiowa.edu | dbrennpg@uiamvs.bitnet | 319-335-5444.at&t >From: sullivan@aqdata.uucp (Michael T. Sullivan)
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Marcel Waldvogel and Netfuture.ch.