Path: utzoo!utgpu!news-server.csri.toronto.edu!bonnie.concordia.ca!uunet!conan!scott
From: scott@conan.UUCP (Scott Weitzenkamp)
Newsgroups: comp.sys.isis
Subject: printing ISIS 2.1 man pages
Keywords: ditroff man
Message-ID: <214@conan.UUCP>
Date: 13 Jun 91 06:42:28 GMT
Lines: 45


  We recently downloaded ISIS Version 2.1 from UUNET, and have
sucessfully compiled it (on a Sun 4 running SunOS 4.0.3c) and printed
the PostScript documentation.  I am now trying to print some of the
man pages.  We have Transcript, but do not appear to have ditroff.
Should we have ditroff?  Is ditroff a part of SunOS and/or Transcript?

  For the sake of simplicity, I will refer to the directory we have
ISIS in (/usr/local/isis/isisv2.1) as $ISIS.

  In $ISIS/man I see a script named "all" which runs "ditroff -man -P
gossip" on all the relevant man pages (why is CC.1 included, by the
way?).  I am able to print most of the files (such as man1/isis.1) by
using troff with a command like: "troff -t -man isis.1 | lpr -t".  I
am having problems with some files such as man3/ISIS.3.  When I try to
use troff on these files, I get semi-readable output with a lot of
garbled characters in it.  The problems lines in man3/ISIS.3 appear to
start with stuff like

	The following are the ISIS manual pages included in section 3:
	.nf
	\bu ISIS    -- general introduction to ISIS
	\bu address -- address manipulation routines
	\bu bcast   -- basic broadcast interface
	\bu bcast_l -- extended broadcast interface	
	\bu bypass  -- bypass broadcast interface
	\bu cl_dump -- making human-readible status dumps within ISIS

  When I set MANPATH to include $ISIS/man, I get garbled output when I
try "man 3 ISIS", too.  I'm no troff wizard, so I'd appreciate any
help or tips anyone can give me.  I apologize if this is an old
question, but we are ISIS novices (so far :-).

  While we are just getting around to installing ISIS, we've been
receiving the newsgroup comp.sys.isis for over a year.  I never seem
to see much traffic on comp.sys.isis, which make me very curious.  Is
ISIS really that bug-free and easy to use? :-) :-)



-- 
Thanks in advance...
Scott Weitzenkamp, Talarian Corporation, Mountain View, CA
uunet!talarian!scott             (415) 965-8050
"Welcome to the late show, starring NULL and void" -- Men At Work