[comp.unix.wizards] Documentation on -man macro and changing pagelength in -man

larry@kitty.UUCP (Larry Lippman) (07/19/90)

	I have been writing manual pages in *roff using the -man macro
for years without any difficulty.  For the first time I have had the
occasion to want to change the pagelength from something other than
the default 66 lines.  This seemed like a simple enough matter, so I
figured I would try to set a command line register in the form of
-rLk as used by the -mm macros.  No joy.  So I take a look at the
macro code in /usr/lib/macros/an and it *seems* to me that .pl is
being set to the value in the L register.  I am rather rusty in reading
and comprehending *roff macro code, so I an not 100% certain of what
is happening here.  So, I figure I'll edit the man file that I am
writing and just set .pl manually.  Still no joy.

	This is getting frustrating, so I figure I try to find the
documentation on the -man macros.  Actually, I don't ever remember
seeing any, but I figure it has to be there somewhere.  Well, we
have *roff documentation from AT&T, NCR Towers, UniSoft Uniplus+,
and Intel XENIX.  So I laboriously look through it all, and can find
nothing.

	So, here are my questions which I hope some kind soul more
knowledgable than I can answer:

1.	Is there documentation on the -man macros, and if so, where
	is it?

2.	How do I set the page length using -man to something other
	than 66 lines?

Larry Lippman @ Recognition Research Corp.  "Have you hugged your cat today?"
     {boulder||decvax||rutgers||watmath}!acsu.buffalo.edu!kitty!larry
VOICE: 716/688-1231 || FAX: 716/741-9635  {utzoo||uunet}!/      \aerion!larry

jac@paul.rutgers.edu (Jonathan A. Chandross) (07/19/90)

larry@kitty.UUCP (Larry Lippman)
> For the first time I have had the
> occasion to want to change the pagelength from something other than
> the default 66 lines. [...]
> So, I figure I'll edit the man file that I am
> writing and just set .pl manually.  Still no joy. [...]
> How do I set the page length using -man to something other than 66 lines?

Ummmm, I just tried inserting ".pl 3.0i" at the beginning of the
adb man page (first one I found).  Sure enough, nroff produced
output for a page 3.0 inches long.

> Is there documentation on the -man macros, and if so, where is it?

"man 7 man" should give you what you want.


Jonathan A. Chandross
Internet: jac@paul.rutgers.edu
UUCP: rutgers!paul.rutgers.edu!jac

ptb@ittc.wec.com (Pat Broderick) (07/20/90)

In article <3865@kitty.UUCP>, larry@kitty.UUCP (Larry Lippman) writes:
> 
> 	I have been writing manual pages in *roff using the -man macro
> ....
> writing and just set .pl manually.  Still no joy.
> 

I had the same problem a long time ago and solved it by putting a .pl in
the *roff file AFTER the .TH which defines title, etc.  From what I
remember I believe .TH arbitrarily set page length to 66.  BTW if you
ever find useful documentation I'd like to know.

Patrick T. Broderick           |ptb@ittc.wec.com |
                               |uunet!ittc!ptb   |
                               |(412)733-6265    |
-- 
Patrick T. Broderick           |ptb@ittc.wec.com |
                               |uunet!ittc!ptb   |
                               |(412)733-6265    |

chad@anasaz.UUCP (Chad R. Larson) (07/20/90)

In article <3865@kitty.UUCP> larry@kitty.UUCP (Larry Lippman) writes:
+---------------
| Is there documentation on the -man macros, and if so, where is it?
+---------------
Well, on our Pyramids there is an on-line manual page for the "man"
macro set, under section 5.  That is: "man 5 man" tells you all you'd
want to know.  That also works on our NCR tower 32/600 that is running
the NCR supplied SysVr3.  Did you miss something, or am I just lucky?

-- 
Chad R. Larson          ...{mcdphx,asuvax}!anasaz!chad or chad@anasaz.UUCP
Anasazi, Inc. - 7500 North Dreamy Draw Drive, Suite 120, Phoenix, Az 85020
(602) 870-3330            "I read the news today, oh boy!"  -- John Lennon