[comp.text] 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

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

In article <Jul.18.23.13.17.1990.13323@paul.rutgers.edu>, jac@paul.rutgers.edu (Jonathan A. Chandross) writes:
> 
> 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.

	I tried it again.  Independently.  This does NOT work, and I
simply do not know why.  I used nroff, but this does not work with
troff, either.

	I took a look at the /usr/lib/macros/an file header, and it says
version 1.37, 12/19/80.  The particular machine I want to run this on
is a 3B2/400 running SVR3.2.  The DWB we are using is from 1986, but
everything else works *fine*, so there has never been a need to install
any newer version.  We use newer troff postprocessors, but the problem
is obviously not there since this won't work on simple nroff output
directed to a file for examination.

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

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

kevin@cbmvax.commodore.com (Kevin Klop) (07/22/90)

In article <2734@anasaz.UUCP> chad@anasaz.UUCP (Chad R. Larson) writes:
>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

On the DEC ULTRIX, and the SUNs here at work, it's:
		man 7 man

				-- Kevin --

shwake@raysnec.UUCP (Ray Shwake) (07/23/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?
+---------------

	Kernigan and Pike's _The_UNIX_Programming_Environment_ contains
	a nice section (9.4) on -man macros. It's a lot more usable than
	the man page (itself, not available on all systems).