Re: [Pkg-grass-general] Re: GRASS 5.7 man pages
On Thu, Nov 25, 2004 at 04:30:14PM +0100, Francesco P. Lovergine wrote:
> On Thu, Nov 25, 2004 at 04:15:27PM +0100, Markus Neteler wrote:
> > On Thu, Nov 25, 2004 at 04:05:43PM +0100, Francesco P. Lovergine wrote:
> > > On Thu, Nov 25, 2004 at 12:28:22PM +0100, Markus Neteler wrote:
> > > > - after compilation MAN pages are rendered from the HTML pages
> > > >
> > >
> > > AFAIK they are rendered in formatted form, i.e. 'cat' format.
> > > That's ugly. Man pages must be unformatted, i.e. in source format.
> > Really?
> > I thought below *is* the desired source format (teach me if I am wrong,
> > I am MAN newbie):
> > cd grass57/
> > file dist.i686-pc-linux-gnu/man/man1/d.rast.1
> > dist.i686-pc-linux-gnu/man/man1/d.rast.1: ASCII troff or preprocessor input text
> > head -4 dist.i686-pc-linux-gnu/man/man1/d.rast.1
> > .TH d.rast 1 "" "GRASS 5.7.cvs" "Grass User's Manual"
> > .SH NAME
> > \fI\fBd.rast\fR\fR - Displays and overlays raster map layers in the active display frame on the graphics monitor.
> > .SH SYNOPSIS
> Uhm, if this is the current status in 5.7 it's a good thing. I had
> always problems with man pages in 5.0 and 5.3... I did not check current
> tree due to lack of time currently.
In both 5.3 and 5.4 it is not cat but source code:
.TH v.distance 1 "" "GRASS 5.4.0" "Grass User's Manual"
\fI\fBv.distance\fR\fR - Calculates distance from a point to nearest line or point in vector layer.
\fI(GRASS Vector Program)\fR
This was changed some years ago according to the Changelog:
2002-06-17 11:50 markus
* Gmakefile: commented section which generates MAN from top level
html pages to avoid name conflicts
[GRASS 5.0 beta9 released 6 December 2000]
2000-11-08 18:43 michel
* src/scripts/contrib/g.html2man/g.html2man: Michel Wurtz:
improving the output for the unix man program
I guess that I am missing something but for a long time the
MAN pages are generated from the HTML pages.