[GRASS5] Grass manual from html, online.

GRASS GRASS developer
1

I have uploaded a new Gmakefile for converting all .html files
(in grass/html) and upgraded g.html2man in the CVS tree.

The manual pages are now in $GISBASE/man/1, and end with .1,
so if you want to use g.manual, you should say, for exemple
"g.manual d.mon.1" instead of "g.manual d.mon".

I propose to replace g.manual by the following script, which
has the advantage of using man, giving the man a much better look.

It lacks the -f -e and -s flags, but they are not really usefull...

If you want to test it, just remove $GISBASE/bin/g.manual
$GISBASE/etc/bin/main/inter/g.manual and
$GISBASE/etc/bin/main/cmd/g.manual

then put the following file in $GISBASE/scripts/g.manual,
run grass, and even the man in tcltkgrass should work

-------------- $GISBASE/scripts/g.manual -----------------
#!/bin/sh
if [ $# -lt 1 ]
  then
    echo Usage: `basename $0` [-1] [-a] entries=command,command,...
    exit -1
fi
case $1 in
-1) /bin/ls $GISBASE/man/1 | more ;;
-a) /bin/ls -C $GISBASE/man/1 | more ;;
-f|-e|-s) echo Usage: `basename $0` [-1] [-a] entries=command,command,...; exit
-1 ;;
entries=*) man $GISBASE/man/1/`echo $1 | sed -e 's!entries=!!' \
           -e "s!, *!.1 $GISBASE/man/1/!g"`.1;;
*) man $GISBASE/man/1/$1.1;;
esac
------------end of file -----------------

I'm waiting for your comments (but won't do anything, reply or
even read my mail until next monday : I will not be at my office)

--
Michel WURTZ - DIG - Maison de la télédétection
               500, rue J.F. Breton
               34093 MONTPELLIER Cedex 5

----------------------------------------
If you want to unsubscribe from GRASS Development Team mailing list write to:
minordomo@geog.uni-hannover.de with
subject 'unsubscribe grass5'

2

Michel Wurtz wrote:

-------------- $GISBASE/scripts/g.manual -----------------

[...]

-f|-e|-s) echo Usage: `basename $0` [-1] [-a]
entries=command,command,...; exit -1 ;;

Uuuh! some mailer will cut long lines : the two lines above sould be
on ONE line : look twice at the resulting file...

here is the file as an attachement (should work better)

--
Michel WURTZ - DIG - Maison de la télédétection
               500, rue J.F. Breton
               34093 MONTPELLIER Cedex 5

(attachments)

g.manual (437 Bytes)

3

Hi again,

may I encourage you to test the updated
html/Gmakefile
(from Michel, thanks to you!).
Along with is g.manual script I consider this being
a good environment. The MAN pages are build now only
in case a HTML page was updated.

If there are no objections, I would replace the old
g.manual by Michel's script and remove the entire
MAN/CAT stuff from CVS.

Regards

Markus

----------------------------------------
If you want to unsubscribe from GRASS Development Team mailing list write to:
minordomo@geog.uni-hannover.de with
subject 'unsubscribe grass5'

4

Hi all,

thanks to Michel for writing the html/Gmakefile and a new
g.manual script. As announced, I have moved the old g.manual
module to /unused/general/ and added the new script in
src/shells/contrib/g.manual/

The html/ is added to src/CMD/lists/GRASS and man removed there.
The MAN pages are generated from HTML now, the html pages stored
in $GISBASE/documents/html
(hi Andreas, this might become the default path for tcltkgrass/
netscape support now).

It seems to be a stable environment.

Shall we keep the original man/ cat/ tree for a while or
remove it now as being unused and outdated?

Thanks to all contributors (Eric Mitchell and others)

  Markus

----------------------------------------
If you want to unsubscribe from GRASS Development Team mailing list write to:
minordomo@geog.uni-hannover.de with
subject 'unsubscribe grass5'

5

Hi Markus

Markus Neteler wrote:

Shall we keep the original man/ cat/ tree for a while or
remove it now as being unused and outdated?

Well, if all the man pages and cat pages are being generated from HTML
during compilation, then I see no reason to keep them. Besides, since we
are using CVS, we can always get them back if necessary.

--
Sincerely,

Jazzman (a.k.a. Justin Hickey) e-mail: jhickey@hpcc.nectec.or.th
High Performance Computing Center
National Electronics and Computer Technology Center (NECTEC)
Bangkok, Thailand

People who think they know everything are very irritating to those
of us who do. ---Anonymous

Jazz and Trek Rule!!!

----------------------------------------
If you want to unsubscribe from GRASS Development Team mailing list write to:
minordomo@geog.uni-hannover.de with
subject 'unsubscribe grass5'