Converting Sixth Edition man pages

From owner-pups@minnie.cs.adfa.edu.au Tue Dec 29 13:11:33 1998
Received: (from major@localhost)
	by minnie.cs.adfa.edu.au (8.9.1/8.9.1) id NAA11519
	for pups-liszt; Tue, 29 Dec 1998 13:10:17 +1100 (EST)
Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134])
	by minnie.cs.adfa.edu.au (8.9.1/8.9.1) with ESMTP id NAA11514
	for < pups@minnie.cs.adfa.oz.au>; Tue, 29 Dec 1998 13:10:09 +1100 (EST)
Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137])
	by allegro.lemis.com (8.9.1/8.9.0) with ESMTP id MAA01349
	for < pups@minnie.cs.adfa.oz.au>; Tue, 29 Dec 1998 12:39:50 +1030 (CST)
Received: (from grog@localhost)
	by freebie.lemis.com (8.9.1/8.9.0) id MAA32614;
	Tue, 29 Dec 1998 12:39:53 +1030 (CST)
Message-ID: <19981229123952.B12346@freebie.lemis.com>
Date: Tue, 29 Dec 1998 12:39:52 +1030
From: Greg Lehey < grog@lemis.com>
To: UNIX Heritage Society < pups@minnie.cs.adfa.oz.au>
Subject: Converting Sixth Edition man pages
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.91.1i
WWW-Home-Page: http://www.lemis.com/~grog
Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia
Phone: +61-8-8388-8286
Fax: +61-8-8388-8725
Mobile: +61-41-739-7062
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

I have the Sixth Edition man pages on my machine, but I can't do much
with them, since they use obsolete macros.  Is there any way to
convert them to the Seventh Edition style?

Greg
--
See complete headers for address, home page and phone numbers
finger grog@lemis.com for PGP public key

From: Warren Toomey < wkt@henry.cs.adfa.oz.au>
Message-Id: <199812290814.TAA22809@henry.cs.adfa.oz.au>
Subject: Re: Converting Sixth Edition man pages
To: grog@lemis.com (Greg Lehey)
Date: Tue, 29 Dec 1998 19:14:38 +1100 (EST)
Cc: pups@minnie.cs.adfa.oz.au (Unix Heritage Society)
In-Reply-To: <19981229123952.B12346@freebie.lemis.com> from Greg Lehey at "Dec 29, 98 12:39:52 pm"
Reply-To: wkt@cs.adfa.oz.au
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

In article by Greg Lehey:
> I have the Sixth Edition man pages on my machine, but I can't do much
> with them, since they use obsolete macros.  Is there any way to
> convert them to the Seventh Edition style?
> 
> Greg

My off-the-cuff suggestion is to read the man(7) pages for both V6 and V7,
and write a Perl script to make the changes :-) That's probably the `best'
solution, but would take time.

Do you want to preserve the markup, or just want to view the manpages?
Just viewing them would be easier, of course!

Ciao,
	Warren

Message-ID: <19981229184909.O32696@freebie.lemis.com>
Date: Tue, 29 Dec 1998 18:49:09 +1030
From: Greg Lehey < grog@lemis.com>
To: wkt@cs.adfa.oz.au
Cc: Unix Heritage Society < pups@minnie.cs.adfa.oz.au>
Subject: Re: Converting Sixth Edition man pages
References: <19981229123952.B12346@freebie.lemis.com> <199812290814.TAA22809@henry.cs.adfa.oz.au>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
In-Reply-To: <199812290814.TAA22809@henry.cs.adfa.oz.au>; from Warren Toomey on Tue, Dec 29, 1998 at 07:14:38PM +1100
WWW-Home-Page: http://www.lemis.com/~grog
Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia
Phone: +61-8-8388-8286
Fax: +61-8-8388-8725
Mobile: +61-41-739-7062
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

On Tuesday, 29 December 1998 at 19:14:38 +1100, Warren Toomey wrote:
> In article by Greg Lehey:
>> I have the Sixth Edition man pages on my machine, but I can't do much
>> with them, since they use obsolete macros.  Is there any way to
>> convert them to the Seventh Edition style?
>
> My off-the-cuff suggestion is to read the man(7) pages for both V6 and V7,
> and write a Perl script to make the changes :-) That's probably the `best'
> solution, but would take time.

perl?  What's perl?  :-)  But yes, that was one alternative, one I
hadn't thought worth the trouble.

> Do you want to preserve the markup, or just want to view the manpages?
> Just viewing them would be easier, of course!

In fact, I'm not sure that just viewing them *would* be easier.  From
observation, the markup isn't too different from the -an macros.  A
lot of the macros seem to be the same, just in a different case.  But
there are enough differences that I wouldn't want to tackle it right
now.

Greg
--
See complete headers for address, home page and phone numbers
finger grog@lemis.com for PGP public key

Date: Wed, 30 Dec 1998 09:48:10 +1100 (EST)
From: Dave Horsfall < dave@fgh.geac.com.au>
To: Greg Lehey < grog@lemis.com>
cc: Unix Heritage Society < pups@minnie.cs.adfa.oz.au>
Subject: Re: Converting Sixth Edition man pages
In-Reply-To: <19981229184909.O32696@freebie.lemis.com>
Message-ID: < Pine.GSO.4.03.9812300947020.22664-100000@fgh>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

On Tue, 29 Dec 1998, Greg Lehey wrote:

> In fact, I'm not sure that just viewing them *would* be easier.  From
> observation, the markup isn't too different from the -an macros.  A
> lot of the macros seem to be the same, just in a different case.  But
> there are enough differences that I wouldn't want to tackle it right
> now.

Do you have thee 6th Edition documentation to tell you what the macros
do?  I have them somewhere...

-- 
Dave Horsfall VK2KFU  dave@geac.com.au  Ph: +61 2 9978-7493 Fx: +61 2 9978-7422
Geac Computers P/L (FGH Division) 2/57 Christie St, St Leonards 2065, Australia

From: norman@nose.cita.utoronto.ca
Message-Id: <199812290952.UAA13151@csadfa.cs.adfa.oz.au>
To: wkt@cs.adfa.oz.au
Date: Tue, 29 Dec 1998 04:51:20 -0500
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

Stuff this in the archives somewhere: V6 man macros.
I can't remember where I dug it up, unfortunately.

# To unbundle, sh this file
echo tmac.an6 1>&2
sed 's/.//' >tmac.an6 <<'//GO.SYSIN DD tmac.an6'
-'''\"	Pwb Manual Entry Macros - Version 6 (@(#)an6.src	1.6)
-'''\"	Nroff/Troff Version	@(#)1.6
-.deTH
-.tmwrong version of man entry macros - use -man
-.ab 
-..
-.rnbd Bd
-.rndt Dt
-.rnit il
-.nr}I 5n
-.nr}P 0 1
-.de}C
-.ev1
-.po0
-.lt7.5i
-.tl \-  \- 
-.lt
-.po
-.ev
-..
-.de}E
-.wh-1p }C
-..
-.ift .em }E
-.dei0
-.in\\n(}Iu
-.dt
-..
-.delp
-.tc
-.i0
-.ta\\$2n
-.in\\$1n
-.ti-\\$2n
-..
-.des1
-.sp1v
-.ne2
-..
-.des2
-.ift .sp .5v
-.ifn .sp 1v
-..
-.des3
-.ift .sp .5v
-.ifn .sp 1v
-.ne2
-..
-.de}F
-.ev1
-'ft1
-'ps10
-'sp.5i
-.tl  - % -  
-'ft
-'ps
-.ev
-'bp
-..
-.deth
-.de}X
-.ev1
-.ift .}C
-'ft1
-'ps10
-'sp.5i
-.tl''THIS MANUAL ENTRY NEEDS TO BE CONVERTED - SEE mancvt(1) and man(7)''
-.tl \\$1\|(\|\\$2\|) PWB/UNIX\| \\$3 \\$1\|(\|\\$2\|) 
-'ps
-'ft
-'sp.5i
-.ev
-\\..
-.wh-1i }F
-.wh0 }X
-.if\\n+(}P>1 .bp1
-.ft1
-.ft1
-.ps10
-.vs12p
-.ift .po .5i
-.in\\n(}Iu
-.fi
-.dt
-.mc
-.ad
-.ifn .na
-..
-.desh
-.s1
-.ift .ft 3
-.ps8
-.ti0
-\&\\$1
-.ift .ft
-.ps
-.br
-..
-.deit
-.ul
-.ie\\nV>1 _\\$1_
-.el\&\\$1
-..
-.debd
-.ift .ft 3
-.ifn .ul
-.ie\\nV>1 _\\$1_
-.el\&\\$1
-.ift .ft 
-..
-.debn
-.ift .ft 3
-.ifn .ul
-.ie\\nV>1 _\\$1_\t\&\c
-.el\&\\$1\t\&\c
-.ift .ft 
-..
-.dedt
-.ifn .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 80n
-.ift .ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
-..
-'dsv \(bv
-'ds' \(aa
-'ds> \(->
-'dsX \(mu
-'ds_ _
-'ds- \-
-'dsG \(*G
-'dsg \(ga
-'dsp \(*p
-'dsa \(aa
-'dsb \(*b
-'dsr \(rg
-'ds| \|
-'dsu \(*m
-.if\nV=1 \{\
-.po4
-.ll80
-.lt80
-.ev1
-.ll80
-.lt80
-.ev\}
-.if\nV>1 \{\
-.ll82
-.lt82
-.ev1
-.ll82
-.lt82
-.ev
-.pl84
-.rmul\}
-.hy14
-.uf2
//GO.SYSIN DD tmac.an6

From: Warren Toomey < wkt@henry.cs.adfa.oz.au>
Message-Id: <199812292343.KAA23709@henry.cs.adfa.oz.au>
Subject: Re: Converting Sixth Edition man pages
To: grog@lemis.com (Greg Lehey)
Date: Wed, 30 Dec 1998 10:43:56 +1100 (EST)
Cc: pups@minnie.cs.adfa.oz.au
In-Reply-To: <19981229123952.B12346@freebie.lemis.com> from Greg Lehey at "Dec 29, 98 12:39:52 pm"
Reply-To: wkt@cs.adfa.oz.au
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

In article by Greg Lehey:
> I have the Sixth Edition man pages on my machine, but I can't do much
> with them, since they use obsolete macros.  Is there any way to
> convert them to the Seventh Edition style?
> 
> Greg

Here's a quick hack which is a start. It's a Perl script called fix:

#!/usr/bin/perl
while (<>) {
        s/^\.br/.BR/;
        if (/^\.bd/) {
            if (/\"/) {
                s/^\.bd/.B/; print; $_=".br\n";
            } else {
                s/^\.bd/.B/;
            }
        }
        s/^\.bl/.BL/;
        s/^\.it/.I/;
        s/^\.sh/.SH/;
        s/^\.th/.TH/;
        s/^\.s3/.PP/;
        s/\\\*/\\/g;
        print;
}

I've run the V6 section 1 manuals through it, then nroffed them using
GNU nroff under FreeBSD 2.2.x, and I get only the following error messages:

# for i in *.1
> do  perl /tmp/fix $i | nroff -man > /dev/null
> done
< standard input>:428: can't set diversion trap when no current diversion
< standard input>:95: can't set diversion trap when no current diversion
< standard input>:77: can't set diversion trap when no current diversion
< standard input>:40: can't set diversion trap when no current diversion
< standard input>:119: can't set diversion trap when no current diversion
< standard input>:132: normal or special character expected (got a node)
< standard input>:137: a tab character  is not allowed in an escape name
< standard input>:83: cannot use a space as a starting delimiter
< standard input>:127: can't set diversion trap when no current diversion
< standard input>:93: can't set diversion trap when no current diversion
< standard input>:75: can't set diversion trap when no current diversion
< standard input>:64: can't set diversion trap when no current diversion
< standard input>:36: can't set diversion trap when no current diversion
< standard input>:154: a tab character is not allowed before an argument
< standard input>:182: a tab character is not allowed before an argument
< standard input>:182: error: end of file while ignoring input lines
< standard input>:95: can't set diversion trap when no current diversion
< standard input>:95: can't set diversion trap when no current diversion

I haven't eyeballed the output from them all, but ls(1), sh(1), db(1)
and roff(1) look ok.

Send in any improvements!!

	Warren

Date: Tue, 29 Dec 1998 15:58:25 -0800 (PST)
From: Carl Lowenstein < cdl@mpl.ucsd.edu>
Message-Id: <199812292358.PAA16791@mpl.ucsd.edu>
To: dave@fgh.geac.com.au, grog@lemis.com
Subject: Re: Converting Sixth Edition man pages
Cc: pups@minnie.cs.adfa.oz.au
Sender: owner-pups@minnie.cs.adfa.edu.au
Precedence: bulk

> From owner-pups@minnie.cs.adfa.edu.au Tue Dec 29 15:07 PST 1998
> Date: Wed, 30 Dec 1998 09:48:10 +1100 (EST)
> From: Dave Horsfall < dave@fgh.geac.com.au>
> X-Sender: dave@fgh
> To: Greg Lehey < grog@lemis.com>
> cc: Unix Heritage Society < pups@minnie.cs.adfa.oz.au>
> 
> On Tue, 29 Dec 1998, Greg Lehey wrote:
> 
> > In fact, I'm not sure that just viewing them *would* be easier.  From
> > observation, the markup isn't too different from the -an macros.  A
> > lot of the macros seem to be the same, just in a different case.  But
> > there are enough differences that I wouldn't want to tackle it right
> > now.
> 
> Do you have thee 6th Edition documentation to tell you what the macros
> do?  I have them somewhere...
> 
> -- 

A quick check around some computers that I have on-line shows two sets
of v6 man macros, one for nroff and one for troff.  This is on a NeXT
running NeXTstep 3.3.  But I suspect that these same macros are
available on anything with a BSD 4.3 flavor.

/usr/lib/tmac/tmac.an6n
/usr/lib/tmac/tmac.an6t

About 200 lines total between them.

With the right macros, [ntg]roff should be able to do everything else.

    carl

        carl lowenstein         marine physical lab     u.c. san diego
                                                  clowenstein@ucsd.edu