Opened 12 years ago

Closed 12 years ago

Last modified 12 years ago

#1587 closed defect (fixed)

GRASS 7 manual: index.html not generated any more

Reported by: neteler Owned by: grass-dev@…
Priority: critical Milestone: 7.0.0
Component: Docs Version: svn-trunk
Keywords: Cc:
CPU: Unspecified Platform: Unspecified

Description

Due to some change the index.html is no longer generated. Hence also the online manual is no longer easily accessible.

Change History (4)

in reply to:  description comment:1 by glynn, 12 years ago

Replying to neteler:

Due to some change the index.html is no longer generated.

The change in question is r50817

comment:2 by neteler, 12 years ago

Apparently I have incorrectly interpreted your suggestion:

On Wed, Feb 15, 2012 at 5:08 AM, Glynn Clements <glynn@…> wrote:

Markus Neteler wrote:

  • man: Indeed, also in my local compilation I don't have a man/ directory, to be removed from the tar command?

The manual pagers were moved from $GISBASE/man to $GISBASE/docs/man in r49908.

I have reverted r50817 in r50925. Hence the implications of r49908 are unclear to me.

comment:3 by neteler, 12 years ago

Resolution: fixed
Status: newclosed

I triggered the GRASS 7 compilation, now the manual is back:

http://grass.osgeo.org/grass70/manuals/html70_user/index.html

in reply to:  2 comment:4 by glynn, 12 years ago

Replying to neteler:

Hence the implications of r49908 are unclear to me.

r49908 moved the destination directory for manual pages. It omitted a necessary change for "make bindist" (which was fixed in r50818), but appears to be otherwise complete. man/Makefile uses MANDIR which is derived from MANBASEDIR which was changed in r49908, so doesn't require any changes.

In spite of the name, the "man" directory in the GRASS source tree relates mainly to the HTML manual pages. It contains the GRASS logo images, the CSS stylesheet, and the Python scripts to build the various HTML indices.

Both the HTML-format and nroff-format manual pages are normally built from the module's Makefile, although man/Makefile will generate any nroff-format pages which are missing. Originally, the nroff-format manual pages were all generated by man/Makefile, but adding it to the standard "html" target ensures that any errors in the <module>.html file will show up if the developer runs "make" in the module directory.

Note: See TracTickets for help on using tickets.