[9fans] mm macro documentation

[9fans] mm macro documentation

[Benn Newman]

Plan 9 includes the ?roff mm macros (/sys/lib/tmac/tmac.m) but no
documentation. Anyone know what is up with that? I printed out a boot-leg
version of one of O'Reilly's books that has mm documenation but it is not
complete (doesn't document letters, for example, which Plan 9's troff has)
and its not in everyone's favourite man(6).

But as always, it beats groff! It's implementation and documentation of mm
are brain dead.
-- 
Benn Newman

Re: [9fans] mm macro documentation

[Vester Thacker]

The Troff's User Manual might be helpful to you, see
http://plan9.bell-labs.com/sys/doc/troff.pdf

Regards,
Vester


On 1/8/07, Benn Newman <newmanbe@sdf.lonestar.org> wrote:
> Plan 9 includes the ?roff mm macros (/sys/lib/tmac/tmac.m) but no
> documentation. Anyone know what is up with that? I printed out a boot-leg
> version of one of O'Reilly's books that has mm documenation but it is not
> complete (doesn't document letters, for example, which Plan 9's troff has)
> and its not in everyone's favourite man(6).
>
> But as always, it beats groff! It's implementation and documentation of mm
> are brain dead.
> --
> Benn Newman
>
>

Re: [9fans] mm macro documentation

[Steve Simon]

I believe Plan9's document formatting applications is pretty much a straight
port of those in V10 Research Unix.

"Typing Documents on the UNIX System: using -ms ..." , Lorinda Cherry and Mike Lesk

This paper is part of the 10th edition manual, though an online version
is linked from the Plan9 wiki or more directly,
http://plan9.bell-labs.com/10thEdMan/msdoc.pdf

The wiki also links to the tbl grap, pic and a few other
papers in the same area.

-Steve

Re: [9fans] mm macro documentation

[Benn Newman]

The Tenth Edition manual doesn't have mm (in the second volume at least)
and the troff manual only helps if one wants to make a new manual page (my
start at one is at contrib/btdn/man/6/mm)

To be more concrete, it would be nice to either have
"MM - Memorandum Macros. D. W. Smith, J. R. Mashey, E. C. Pariser, and N.
W. Smith, AT&T Bell Laboratories, June 1980." or mm(6). I suppose
<http://inetsd01.boulder.ibm.com/pseries/hu_HU/cmds/aixcmds5/troff.htm>
will do for now...

I have started an index file of the various things in /sys/lib/tmac at
contrib/btdn/doc/tmac -- if you have an account you can update it
yourself, or you can email me corrections. Some of the things can probably
be deleted, at least from the view of someone outside of Bell Labs. No
offence to Arun N. Netravali, but are (complet cover)^.1127 needed?
tmac.org is just a .so to /usr/lib/macros/org.

And in case no one has noticed, the sources website doesn't work.
-- 
Benn Newman

Re: [9fans] mm macro documentation

[geoff]

Sources was down earlier today but it's up now and `pull -n' and
`9fs sources' from outside work for me.  If you're still having
trouble, mail me the details.

Re: [9fans] sources website down? (Was mm macro documentation)

[Benn Newman]

geoff@plan9.bell-labs.com said:
> Sources was down earlier today but it's up now and `pull -n' and
> `9fs sources' from outside work for me.  If you're still having
> trouble, mail me the details.
>

http://plan9.bell-labs.com/sources/ has not been working the last few days
for  me.
-- 
Benn Newman

Re: [9fans] sources website down? (Was mm macro documentation)

[Steve Simon]

> geoff@plan9.bell-labs.com said:
> > Sources was down earlier today but it's up now and `pull -n' and
> > `9fs sources' from outside work for me.  If you're still having
> > trouble, mail me the details.
> >
>
> http://plan9.bell-labs.com/sources/ has not been working the last few days
> for  me.

As a counter example, it works fine for me, both authenticated and
with noauth and the username ``fred''

(thanks geoff).

-Steve

Re: [9fans] sources website down? (Was mm macro documentation)

[Russ Cox]

> > > Sources was down earlier today but it's up now and `pull -n' and
> > > `9fs sources' from outside work for me.  If you're still having
> > > trouble, mail me the details.
> > >
> >
> > http://plan9.bell-labs.com/sources/ has not been working the last few days
> > for  me.
>
> As a counter example, it works fine for me, both authenticated and
> with noauth and the username ``fred''
>
> (thanks geoff).

There is a difference between "9fs sources", which is what works for Steve,
and http://plan9.bell-labs.com/sources/, which was not working (but now is).

Russ

Re: [9fans] mm macro documentation

[Benn Newman]

The Tenth Edition manual doesn't have mm (in the second volume at least)
and the troff manual only helps if one wants to make a new manual page (my
start at one is at contrib/btdn/man/6/mm)

To be more concrete, it would be nice to either have
"MM - Memorandum Macros. D. W. Smith, J. R. Mashey, E. C. Pariser, and N.
W. Smith, AT&T Bell Laboratories, June 1980."/"Addendum to the Memorandum
Macros User's Manual.
December, 1986." or mm(6). I suppose
<http://inetsd01.boulder.ibm.com/pseries/hu_HU/cmds/aixcmds5/troff.htm>
will do for now...

I have started an index file of the various things in /sys/lib/tmac at
contrib/btdn/doc/tmac -- if you have an account you can update it
yourself, or you can email me corrections. Some of the things can probably
be deleted, at least from the view of someone outside of Bell Labs. No
offence to Arun N. Netravali, but are (complet cover)^.1127 needed?
tmac.org is just a .so to /usr/lib/macros/org.

And in case no one has noticed, the sources website doesn't work.
-- 
Benn Newman



-- 
Benn Newman

Re: [9fans] mm macro documentation

[Joel Salomon]

On 1/7/07, Benn Newman <newmanbe@sdf.lonestar.org> wrote:
> I printed out a boot-leg version of one of O'Reilly's books that has mm
> documenation but it is not complete

Do you mean <http://www.oreilly.com/openbook/utp/>?  That's not
samizdat; it's been officially released.

Is there any chance of the 10th (or earlier) Edition manual sources
being made available to be brought up-to-date and added to /sys/doc?

--Joel

Re: [9fans] mm macro documentation

[Russ Cox]

> Is there any chance of the 10th (or earlier) Edition manual sources
> being made available to be brought up-to-date and added to /sys/doc?

As Arnold pointed out, the 10th Edition Unix manuals
do not cover -mm, neither in Volume 1 (man pages) nor in
Volume 2 (papers).

Russ

Re: [9fans] mm macro documentation

[Joel Salomon]

> > Is there any chance of the 10th (or earlier) Edition manual sources
> > being made available to be brought up-to-date and added to /sys/doc?
>
> As Arnold pointed out, the 10th Edition Unix manuals
> do not cover -mm, neither in Volume 1 (man pages) nor in
> Volume 2 (papers).

9th Ed., then?  8th?

--Joel

Re: [9fans] mm macro documentation

[Brantley Coile]

> 9th Ed., then?  8th?

My 8th edition manual only had man, mcs and ms macros.
Same for the 9th edition.  These are all Vol 1 since I don't think
there was a vol 2 for these editions.

Re: [9fans] mm macro documentation

[Benn Newman]

Joel Salomon said:
> On 1/7/07, Benn Newman <newmanbe@sdf.lonestar.org> wrote:
>> I printed out a boot-leg version of one of O'Reilly's books that has mm
>> documenation but it is not complete
>
> Do you mean <http://www.oreilly.com/openbook/utp/>?  That's not
> samizdat; it's been officially released.

No, that is not what I mean. Something along the lines of "UNIX in a
Nutshell."

> Is there any chance of the 10th (or earlier) Edition manual sources
> being made available to be brought up-to-date and added to /sys/doc?

I don't know. The papers have people's names on them, I'm not sure how
they would like us changing things (it's not exactly like source code).
Would it be appropriate, for example, for the community to send patches
for /sys/doc/9.ms?

> --Joel
>
-- 
Benn Newman

Fwd: Fwd: [9fans] mm macro documentation

[Joel Salomon]

One more blind alley...

--Joel

---------- Forwarded message ----------
From: Gunnar Ritter <gunnarr@acm.org>
Date: Jan 12, 2007 12:08 PM
Subject: Re: Fwd: [9fans] mm macro documentation
To: Joel Salomon <joelcsalomon@gmail.com>

> This thread has just started on the Plan 9 mailing list.

You may forward this response there if you like.

> Does the Heirloom Documentation Tools project have documentation
> for the -mm macros?

No. To my knowledge, nobody has yet released the -mm paper
under an open source license. It had been available until
a few years ago under a closed-source-but-no-cost license
from SCO as part of the System III sources.

        Gunnar