[comp.mail.elm] Formatting the docs

mike@grainne.lbl.gov (Michael Helm) (12/13/88)

I'm in the process of putting up Elm 2.1P1 on a couple of systems.
I'd like to troff the docs, but I don't seem to have the rite macro
packages here.  The Elm Makefile wants to run *.guide documentation
thru the "mm" macro package -- what's that?  (Please excuse my ignorance.)
I did find a version of "mm" on an HP-9000, but it seems to be only
the nroff side of things.  I tried a few other macro pkgs I have on
a Sun, but the results didn't quite look rite (Dave Taylor sent me
a formatted set for an earlier version of Elm, so I know rufly what  
the *.fmtd guides should look like).

Does anybody have any good ideas on how to get a nice set of guides
troffed up?  I'd sure like to hear yours!

Thanks,
Michael Helm (Internet M_Helm@lbl.gov)
             (or maybe ...!ucbvax!lbl-csam!lbl.gov!M_Helm)

pae@cos.com (Paul A. Ebersman) (12/13/88)

From article <1457@helios.ee.lbl.gov>, by mike@grainne.lbl.gov (Michael Helm):
> I'm in the process of putting up Elm 2.1P1 on a couple of systems.
> I'd like to troff the docs, but I don't seem to have the rite macro
> packages here.  The Elm Makefile wants to run *.guide documentation
> thru the "mm" macro package -- what's that?  (Please excuse my ignorance.)
> I did find a version of "mm" on an HP-9000, but it seems to be only
> the nroff side of things.  I tried a few other macro pkgs I have on
> a Sun, but the results didn't quite look rite (Dave Taylor sent me
> a formatted set for an earlier version of Elm, so I know rufly what  
> the *.fmtd guides should look like).

I have elm on a Sun and Sun does not ship the "mm" macro set. It is
a strictly AT&T macro. 

There are 3 possibilities for you. 

1) get a troff guru to convert nroff format to troff.

2) "find" a troff version of the mm macro from someone with
	AT&T System V.

3) Have all docs put into Postscript form and shipped that way
	as well as in n/troff. The problem with this is that it
	takes up way too much space and not everyone's laser
	printer is postscript. If there are a lot of people
	who have postscript, but not "mm", maybe we can have
	a separate "hardcopy" file with the source and patches
	for those who want it. Archivers, any problems with this????
-- 
               Paul A. Ebersman @ Corporation for Open Systems
  pae@cos.COM or pae%cos.com@uunet.uu.net or {uunet, sundc, hadron}!cos!pae
     ( The difference between practice and theory in practice is always
      greater than the difference between practice and theory in theory. )