[GRASS5] html to man conversion

GRASS GRASS developer
1

On Thu, Nov 30, 2000 at 03:30:32PM +0100, mlennert@club.worldonline.be wrote:
> > On Thu, Nov 30, 2000 at 03:05:43PM +0100, mlennert@club.worldonline.be wrote:
> > > Hello,
> > >
> > > During compilation of CVS-tree I get the following type of error message for
> > > every man page:
> > >
> > > [...]
> > > Converting: m.tiger.region.html to /usr/local/grass5/man/man1/m.tiger.region_.1
> > > man: can't create index cache /usr/local/grass5/man/index.bt: Permission denied
> > > Reformatting m.tiger.region_(1), please wait...
> > > m.tiger.region_.1 => m.tiger.region.1
> > > Converting: m.u2ll.html to /usr/local/grass5/man/man1/m.u2ll_.1
> > > man: can't create index cache /usr/local/grass5/man/index.bt: Permission denied
> > > Reformatting m.u2ll_(1), please wait...
> > > m.u2ll_.1 => m.u2ll.1
> > > [...]
> > >
> > > I left my compilation running, since I don't know if this is important, so
> > > I'll see what's going to happen, but I thought I'd already signal it.
> > >
> > Hi Moritz,
> >
> > this should be fixed since a few days. Please
> > cvs update html/Gmakefile
> >
> > cd html
> > gmake5
> >
> > and report, if this error is still there. Michel has added
> > "chown man"
> >
> > which should be helping.
> >
> > Markus
> >
> I just redownloaded the entire cvs tree and that is what I am compiling. But I
> can try to update again once the current compilation is done.

O.k., then it seems to be still a problem.
Michel, do you have an idea?

Well, I did the update of the Gmakefile after the compilation and now I didn't get any error messages anymore. I don't no, if for some reason I didn't get the latest version of the cvs tree (but I did erase the entire tree and reinstalled it, following the instructions) or wether something else later in the compilation process made the compilation the html directory possible... I can't check wether the manual pages work because Grass isn't running yet. In the grass5/man directory, only man1 has any content at all. The other ones (man2-5 and help) are empty and only man1 has 'man' as its owner.

Moritz

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

2

On Thu, Nov 30, 2000 at 04:29:57PM +0100, mlennert@club.worldonline.be wrote:

> On Thu, Nov 30, 2000 at 03:30:32PM +0100, mlennert@club.worldonline.be wrote:
> > > On Thu, Nov 30, 2000 at 03:05:43PM +0100, mlennert@club.worldonline.be wrote:
> > > > Hello,
> > > >
> > > > During compilation of CVS-tree I get the following type of error message for
> > > > every man page:
> > > >
> > > > [...]
> > > > Converting: m.tiger.region.html to /usr/local/grass5/man/man1/m.tiger.region_.1
> > > > man: can't create index cache /usr/local/grass5/man/index.bt: Permission denied
> > > > Reformatting m.tiger.region_(1), please wait...
> > > > m.tiger.region_.1 => m.tiger.region.1
> > > > Converting: m.u2ll.html to /usr/local/grass5/man/man1/m.u2ll_.1
> > > > man: can't create index cache /usr/local/grass5/man/index.bt: Permission denied
> > > > Reformatting m.u2ll_(1), please wait...
> > > > m.u2ll_.1 => m.u2ll.1
> > > > [...]
> > > >
> > > > I left my compilation running, since I don't know if this is important, so
> > > > I'll see what's going to happen, but I thought I'd already signal it.
> > > >
> > > Hi Moritz,
> > >
> > > this should be fixed since a few days. Please
> > > cvs update html/Gmakefile
> > >
> > > cd html
> > > gmake5
> > >
> > > and report, if this error is still there. Michel has added
> > > "chown man"
> > >
> > > which should be helping.
> > >
> > > Markus
> > >
> > I just redownloaded the entire cvs tree and that is what I am compiling. But I
> > can try to update again once the current compilation is done.
>
> O.k., then it seems to be still a problem.
> Michel, do you have an idea?

Well, I did the update of the Gmakefile after the compilation and now I
didn't get any error messages anymore. I don't no, if for some reason I
didn't get the latest version of the cvs tree (but I did erase the entire
tree and reinstalled it, following the instructions) or wether something
else later in the compilation process made the compilation the html
directory possible...

Strange.

I can't check wether the manual pages work because
Grass isn't running yet. In the grass5/man directory, only man1 has any
content at all. The other ones (man2-5 and help) are empty and only man1
has 'man' as its owner.

Yes, only man1 will contain *all* files as no "classification" is done (due
to the fact that html files are the source). We *may* add a keyword to each
page to allow separations and storage into different man? directories. But
personally I don't think that this extra works makes much sense.

So, if g.manual doesn't work: cvs update it as well and run the gmake5.
Perhaps you have left the old g.manual *module* (now it is a script).
Check if g.manual still exists in $GISBASE/bin and $GISBASE/etc/bin/...).
Yes, this might be the reason for your problem.

The current module offer these parameters:
g.manual help

Usage:
g.manual [-1] [-a] [-d] [-m] [-s] [-q] [browser=name]
[entries=name[,name,...]]
   name name ...
[...]

Hope this helps

Markus

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

3

Markus Neteler wrote:

On Thu, Nov 30, 2000 at 04:29:57PM +0100, mlennert@club.worldonline.be wrote:

> > Michel, do you have an idea?
>
> Well, I did the update of the Gmakefile after the compilation and now I
> didn't get any error messages anymore. I don't no, if for some reason I
> didn't get the latest version of the cvs tree (but I did erase the entire
> tree and reinstalled it, following the instructions) or wether something
> else later in the compilation process made the compilation the html
> directory possible...
Strange.

> I can't check wether the manual pages work because
> Grass isn't running yet. In the grass5/man directory, only man1 has any
> content at all. The other ones (man2-5 and help) are empty and only man1
> has 'man' as its owner.
Yes, only man1 will contain *all* files as no "classification" is done (due
to the fact that html files are the source). We *may* add a keyword to each
page to allow separations and storage into different man? directories. But
personally I don't think that this extra works makes much sense.

Well, sorry for not being very reactive, but I'm a little overloaded,
and worse, the network here is in maintenance : I won't have any access
until next week !

The `chown' line works only if root runs make. The problem is
that the index is made by a program suid man, so if the user "man"
cannot write in the man directory, you get an error message each
time g.html2man runs ! On the other hand a "normal" user cannot
give the directory to man (or cannot write man pages after that)

A better idea is to say "chmod a+w $(MANDIR)", and to restore
the read-only flag after all pages are created (for security
reasons). Sorry, I have no time (and no network) until next week
to do that ! but it's straightforward :wink:

--
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'

4

On Thu, Nov 30, 2000 at 06:39:02PM +0000, Michel Wurtz wrote:

The `chown' line works only if root runs make. The problem is
that the index is made by a program suid man, so if the user "man"
cannot write in the man directory, you get an error message each
time g.html2man runs ! On the other hand a "normal" user cannot
give the directory to man (or cannot write man pages after that)

Unset that suid bit instead. Is there some reason the man
command is suid?

A better idea is to say "chmod a+w $(MANDIR)", and to restore
the read-only flag after all pages are created (for security
reasons). Sorry, I have no time (and no network) until next week
to do that ! but it's straightforward :wink:

If there's a way to generate the man pages inside of the source tree,
including the index, and then "install" them into the man/man1
destination, I think that would be better/safer. Don't know if index.bt
needs the full path or just relative would do? I looked around at my
system man dirs, and other than this new grass one, there doesn't seem
to be any kind of index for man pages (there is a cache in
/var/cache/man). So, is the index really necessary? I have close to no
clue about the variants of man programs...

--
Eric G. Miller <egm2@jps.net>

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

5

On Thu, Nov 30, 2000 at 06:39:02PM +0000, Michel Wurtz wrote:

Markus Neteler wrote:
>
> On Thu, Nov 30, 2000 at 04:29:57PM +0100, mlennert@club.worldonline.be wrote:

> > > Michel, do you have an idea?
> >
> > Well, I did the update of the Gmakefile after the compilation and now I
> > didn't get any error messages anymore. I don't no, if for some reason I
> > didn't get the latest version of the cvs tree (but I did erase the entire
> > tree and reinstalled it, following the instructions) or wether something
> > else later in the compilation process made the compilation the html
> > directory possible...
> Strange.
>
> > I can't check wether the manual pages work because
> > Grass isn't running yet. In the grass5/man directory, only man1 has any
> > content at all. The other ones (man2-5 and help) are empty and only man1
> > has 'man' as its owner.
> Yes, only man1 will contain *all* files as no "classification" is done (due
> to the fact that html files are the source). We *may* add a keyword to each
> page to allow separations and storage into different man? directories. But
> personally I don't think that this extra works makes much sense.

Well, sorry for not being very reactive, but I'm a little overloaded,
and worse, the network here is in maintenance : I won't have any access
until next week !

The `chown' line works only if root runs make. The problem is
that the index is made by a program suid man, so if the user "man"
cannot write in the man directory, you get an error message each
time g.html2man runs ! On the other hand a "normal" user cannot
give the directory to man (or cannot write man pages after that)

A better idea is to say "chmod a+w $(MANDIR)", and to restore
the read-only flag after all pages are created (for security
reasons). Sorry, I have no time (and no network) until next week
to do that ! but it's straightforward :wink:

Hi Michel,

perhaps for you list:

if I run this on CRAY, I get:
Make: "chown man /home/t3e/fsn/nhdc/nhdcmark/grass5bin/man/man1 2> /dev/null
;true": Error code 4

t3e:grass/html:585$ man chown
[...]
IMPLEMENTATION
     CRAY T3E systems

STANDARDS
     POSIX, XPG4
     AT&T extensions (-h option)

The reason is:
chown man /home/t3e/fsn/nhdc/nhdcmark/grass5bin/man/man1
cmd-1362 chown: Unknown user id 'man'.

At least on CRAY it is:
ls -la /usr/man
total 1248
drwxr-xr-x 10 bin bin 4096 Jun 1 1999 .

I am installing as user, not as root here.

We need a more portable implementation...

Regards

Markus

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

6

Hi again,

unfortunately another bug found on SUN in
html/Gmakefile

Copying html pages
/bin/sh: test: unknown operator -ot

I don't know the meaning of -ot, but it's not portable
(Huidae, Michel?).

Markus

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

7

Markus Neteler wrote:

Hi again,

unfortunately another bug found on SUN in
html/Gmakefile

Copying html pages
/bin/sh: test: unknown operator -ot

I don't know the meaning of -ot, but it's not portable
(Huidae, Michel?).

Uh ? excerpt from SunOS 5.7 man page of test

     file1 -ot file2
               True, if file1 exists and is older than file2.
                                                                
BUT... [ or test are in /usr/ucb or /usr/bin for sun =>

$ if /usr/bin/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
ok
$ if /usr/ucb/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
test: unknown operator -ot
$

Conclusion :
if test file1 -ot file2 ; then echo ok ; fi # doesn't work
if /bin/test file1 -ot file2 ; then echo ok ; fi # works !

Silly mixing of old SunOS and new Solaris versions... !

--
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'

8

Hi Michel,

some times ago reported, again investigated...

On Tue, Dec 05, 2000 at 06:35:43PM +0000, Michel Wurtz wrote:

Markus Neteler wrote:
>
> Hi again,
>
> unfortunately another bug found on SUN in
> html/Gmakefile
>
> Copying html pages
> /bin/sh: test: unknown operator -ot
>
> I don't know the meaning of -ot, but it's not portable
> (Huidae, Michel?).

Uh ? excerpt from SunOS 5.7 man page of test

     file1 -ot file2
               True, if file1 exists and is older than file2.
                                                                
BUT... [ or test are in /usr/ucb or /usr/bin for sun =>

$ if /usr/bin/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
ok
$ if /usr/ucb/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
test: unknown operator -ot
$

Conclusion :
if test file1 -ot file2 ; then echo ok ; fi # doesn't work
if /bin/test file1 -ot file2 ; then echo ok ; fi # works !

Silly mixing of old SunOS and new Solaris versions... !

I have checked that. And I have renamed
/usr/ucb/test
to
/usr/ucb/test_old

.. but above problem is still there.

The "-ot" test occurs from
html/Gmakefile:

if [ ! -f $$f -o $$f -ot $$h ]

So "test" is not called directly. How can we fix this?

My path settings are on Solaris:
PATH=.:/usr/sbin:/usr/bin:/usr/openwin/bin:/opt/SUNWspro/bin:/opt/SUNWspro/SC3.0.1/bin:/usr/ucb:/export/home/gnu/bin:/data/sara-neu:/export/home/OPT/comm/bin:/usr/local/bin:/usr/ccs/bin:/usr/local/netpbm

Regards

Markus

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

9

Hi Markus

Markus Neteler wrote:

On Tue, Dec 05, 2000 at 06:35:43PM +0000, Michel Wurtz wrote:
> Markus Neteler wrote:
> >
> > Hi again,
> >
> > unfortunately another bug found on SUN in
> > html/Gmakefile
> >
> > Copying html pages
> > /bin/sh: test: unknown operator -ot
> >
> > I don't know the meaning of -ot, but it's not portable
> > (Huidae, Michel?).
>
> Uh ? excerpt from SunOS 5.7 man page of test
>
> file1 -ot file2
> True, if file1 exists and is older than file2.
>
> BUT... [ or test are in /usr/ucb or /usr/bin for sun =>
>
> $ if /usr/bin/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
> ok
> $ if /usr/ucb/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
> test: unknown operator -ot
> $
>
> Conclusion :
> if test file1 -ot file2 ; then echo ok ; fi # doesn't work
> if /bin/test file1 -ot file2 ; then echo ok ; fi # works !
>
> Silly mixing of old SunOS and new Solaris versions... !
I have checked that. And I have renamed
/usr/ucb/test
to
/usr/ucb/test_old

.. but above problem is still there.

The "-ot" test occurs from
html/Gmakefile:

if [ ! -f $$f -o $$f -ot $$h ]

So "test" is not called directly. How can we fix this?

It has to be changed since the -ot option is not supported on SGI
machines. Perhaps we could use the getModTime function I added to
src/general/init but then it would need to be compiled before the html
conversion.

--
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'

10

On Mon, Jan 15, 2001 at 07:24:36PM +0700, Justin Hickey wrote:

Hi Markus

Markus Neteler wrote:
> On Tue, Dec 05, 2000 at 06:35:43PM +0000, Michel Wurtz wrote:
> > Markus Neteler wrote:
> > >
> > > Hi again,
> > >
> > > unfortunately another bug found on SUN in
> > > html/Gmakefile
> > >
> > > Copying html pages
> > > /bin/sh: test: unknown operator -ot
> > >
> > > I don't know the meaning of -ot, but it's not portable
> > > (Huidae, Michel?).
> >
> > Uh ? excerpt from SunOS 5.7 man page of test
> >
> > file1 -ot file2
> > True, if file1 exists and is older than file2.
> >
> > BUT... [ or test are in /usr/ucb or /usr/bin for sun =>
> >
> > $ if /usr/bin/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
> > ok
> > $ if /usr/ucb/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
> > test: unknown operator -ot
> > $
> >
> > Conclusion :
> > if test file1 -ot file2 ; then echo ok ; fi # doesn't work
> > if /bin/test file1 -ot file2 ; then echo ok ; fi # works !
> >
> > Silly mixing of old SunOS and new Solaris versions... !
> I have checked that. And I have renamed
> /usr/ucb/test
> to
> /usr/ucb/test_old
>
> .. but above problem is still there.
>
> The "-ot" test occurs from
> html/Gmakefile:
>
> if [ ! -f $$f -o $$f -ot $$h ]
>
> So "test" is not called directly. How can we fix this?

It has to be changed since the -ot option is not supported on SGI
machines. Perhaps we could use the getModTime function I added to
src/general/init but then it would need to be compiled before the html
conversion.

Hi Justin,

generally I don't see a problem to compile such tools. DO you
see a change to implement that?

Yours

Markus

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

11

Hello GRASS list:

I am a new user hoping to learn the hydro simulation modeling capabilities of
GRASS as well as its spatial stat components. I am attempting to install GRASS
5.0 beta10 to a RedHat7.0 linux box. I have gunzipped and tared the files and am
ready to install, except I don't know where to run the ./configure and make
install commands. I cannot find the grass5.0beta directory as documented. Where
would this directory be? I assume in the same one as the other stuff. Anyways I
would appreciate your help.

Justin A Saarinen
MS Candidate
University of Florida Geography
Gainesville, Florida USA

Markus Neteler wrote:

On Mon, Jan 15, 2001 at 07:24:36PM +0700, Justin Hickey wrote:
> Hi Markus
>
> Markus Neteler wrote:
> > On Tue, Dec 05, 2000 at 06:35:43PM +0000, Michel Wurtz wrote:
> > > Markus Neteler wrote:
> > > >
> > > > Hi again,
> > > >
> > > > unfortunately another bug found on SUN in
> > > > html/Gmakefile
> > > >
> > > > Copying html pages
> > > > /bin/sh: test: unknown operator -ot
> > > >
> > > > I don't know the meaning of -ot, but it's not portable
> > > > (Huidae, Michel?).
> > >
> > > Uh ? excerpt from SunOS 5.7 man page of test
> > >
> > > file1 -ot file2
> > > True, if file1 exists and is older than file2.
> > >
> > > BUT... [ or test are in /usr/ucb or /usr/bin for sun =>
> > >
> > > $ if /usr/bin/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
> > > ok
> > > $ if /usr/ucb/test Lespinard.zip -ot Duclaux.zip ; then echo ok ; fi
> > > test: unknown operator -ot
> > > $
> > >
> > > Conclusion :
> > > if test file1 -ot file2 ; then echo ok ; fi # doesn't work
> > > if /bin/test file1 -ot file2 ; then echo ok ; fi # works !
> > >
> > > Silly mixing of old SunOS and new Solaris versions... !
> > I have checked that. And I have renamed
> > /usr/ucb/test
> > to
> > /usr/ucb/test_old
> >
> > .. but above problem is still there.
> >
> > The "-ot" test occurs from
> > html/Gmakefile:
> >
> > if [ ! -f $$f -o $$f -ot $$h ]
> >
> > So "test" is not called directly. How can we fix this?
>
> It has to be changed since the -ot option is not supported on SGI
> machines. Perhaps we could use the getModTime function I added to
> src/general/init but then it would need to be compiled before the html
> conversion.
Hi Justin,

generally I don't see a problem to compile such tools. DO you
see a change to implement that?

Yours

Markus

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

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

12

Hi Markus

Markus Neteler wrote:

> It has to be changed since the -ot option is not supported on SGI
> machines. Perhaps we could use the getModTime function I added to
> src/general/init but then it would need to be compiled before the
> html conversion.
Hi Justin,

generally I don't see a problem to compile such tools. DO you
see a change to implement that?

Are there other "tools" like this (ie separate programs or scripts that
do not need to link to Grass)? If so we could group them together in a
directory and compile them first. If not, we could move the getModTime.c
file to the html directory and compile it there.

--
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'

13

On Wed, Jan 17, 2001 at 01:33:10PM +0700, Justin Hickey wrote:

Hi Markus

Markus Neteler wrote:
> > It has to be changed since the -ot option is not supported on SGI
> > machines. Perhaps we could use the getModTime function I added to
> > src/general/init but then it would need to be compiled before the
> > html conversion.
> Hi Justin,
>
> generally I don't see a problem to compile such tools. DO you
> see a change to implement that?

Are there other "tools" like this (ie separate programs or scripts that
do not need to link to Grass)? If so we could group them together in a
directory and compile them first. If not, we could move the getModTime.c
file to the html directory and compile it there.

Hi Justin,

let's add
src/libes/tools

as later other tools might be added. It's better than mixing .c code
and .html.

Yours

Markus

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

14

Hi Markus

Markus Neteler wrote:

let's add
src/libes/tools

as later other tools might be added. It's better than mixing .c code
and .html.

Done. Now we just need to rewrite that -ot code.

--
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'