From: Michael Talbot-Wilson <mtw@calypso.view.net.au>
Date: Mon, 8 Jul 1996 11:46:42 +0930 (CST)
Subject: Re: [PG95]: reference manual source problems

On Sun, 7 Jul 1996, Bruce Momjian wrote:

> ============================================================================
>                         POSTGRES95 BUG REPORT TEMPLATE
> ============================================================================
> 
> 
> Your name		: Bruce Momjian
> Your email address	: root@candle.pha.pa.us
> 
> 
> System Configuration
> ---------------------
>   Architecture (example: Intel Pentium)  	: Intel 486
> 
>   Operating System (example: Linux 1.3.42 ELF) 	: BSD/OS(BSDI) 2.1
> 
>   Postgres95 version (example: Postgres95-1.01) : Postgres95-1.01
> 
>   Compiler used (example:  gcc 2.7.0)		: 2.7.2
> 
> 
> Please enter a FULL description of your problem:
> ------------------------------------------------
> I wish to generate unix-style manual pages for postgres95 and install
> them so 'man' can access each of them.
> 
> The source to the reference manual stored in postgres95/doc/man contains
> the reference manual in appropriate files.
> 
> Unfortunately, the files contain macros that my groff/nroff do not
> understand.
> 
> Current macro:		Macro I replaced it with:
> .(C			.nf
> .)C			.fi
> .i			.I
> .b			.B
> .ip			.IP
> \*(PG			Postgres95
> \*(LI			Libpq
> 
> If you know how this problem might be fixed, list the solution below:
> ---------------------------------------------------------------------
> Make the source changes described above, or supply an include file with
> the macro definitions.

The fix would be, as you say, to generate a new set of manpages for the
source.  But everyone has noticed and many people have remarked on this
situation over a number of months, and I think we have to accept what has
been clearly stated, that PG95 is absolutely unsupported. 

While we are waiting, here is a remedy that fixes the corrupt manpage
distribution after it has been downloaded.  It uses two scripts, fixman to
clean up the roff source and catme to format it.  I assume your man pager
supports catn preformatted pages.  The source documents should NOT be in
your MANPATH. 

catme
- -----
#!/bin/sh
cd /usr/local/postgres95/doc/man/man$1
for i in * ; do
	fixman $i | tbl | nroff -me -mandoc | cat -s - \
	>/var/man/cat$1/$i
done

fixman
- ------
#!/usr/bin/perl
#
# Fixes some problems with Postgres95 man pages
# on FreeBSD (groff -mandoc pager).
#
# If you find that more substitutions are needed, add as indicated and
# mail me.
#
while (<>) {
	s/\.\(C/\n.nf/;
	s/\.\)C/\n.fi/;
	if ($ARGV[0] == "built-in.3pq") {
		s/^\.ie t/.ie n/
	}
	s/\\\*\(LI/Libpq/g;
	s/\\\*\(PG/Postgres/g;
	s/\\\*\(PQ/SQL/g;
	s/\\\*\(UU/Unix/g;
	print;
}

If you (meaning anyone) use these with success I'd appreciate a brief 
note telling me that.

Mike