[GRASS-dev] [GRASS GIS] #503: wx-GUI: html-manual

GRASS GRASS developer
1

#503: wx-GUI: html-manual
-------------------------+--------------------------------------------------
Reporter: hellik | Owner: grass-dev@lists.osgeo.org
     Type: defect | Status: new
Priority: major | Milestone: 6.4.0
Component: wxGUI | Version: 6.4.0 RCs
Keywords: | Platform: Unspecified
      Cpu: Unspecified |
-------------------------+--------------------------------------------------
hi,

if you go to

http://grass.osgeo.org/grass64/manuals/html64_user/wxGUI.html

and scroll down, you see that the manual is three or four times in one
html. the same is in the grass64rc3 (at least in the osgeo4w-grass64rc-2).

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/503&gt;
GRASS GIS <http://grass.osgeo.org>

2

#503: wx-GUI: html-manual
--------------------------+-------------------------------------------------
  Reporter: hellik | Owner: grass-dev@lists.osgeo.org
      Type: defect | Status: new
  Priority: major | Milestone: 6.4.0
Component: Docs | Version: 6.4.0 RCs
Resolution: | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by hellik):

  * component: wxGUI => Docs

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/503#comment:1&gt;
GRASS GIS <http://grass.osgeo.org>

3

#503: wx-GUI: html-manual
--------------------------+-------------------------------------------------
  Reporter: hellik | Owner: grass-dev@lists.osgeo.org
      Type: defect | Status: new
  Priority: minor | Milestone: 6.4.0
Component: Docs | Version: 6.4.0 RCs
Resolution: | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by hamish):

  * priority: major => minor

Comment:

same for wxGUI.Nviz.html and others in gui/wxpython/docs/.

apparently the 'make htmldir' command there just appends the man pages to
wxGUI.tmp.html instead of overwriting them so each time the dir is rebuilt
the man page grows... I notice that 'make distclean' does not remove the
*.tmp.html files in that dir.

Hamish

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/503#comment:2&gt;
GRASS GIS <http://grass.osgeo.org>

4

#503: wx-GUI: html-manual
--------------------------+-------------------------------------------------
  Reporter: hellik | Owner: grass-dev@lists.osgeo.org
      Type: defect | Status: closed
  Priority: minor | Milestone: 6.4.0
Component: Docs | Version: 6.4.0 RCs
Resolution: fixed | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by neteler):

  * status: new => closed
  * resolution: => fixed

Comment:

Fix (hack) submitted for devel_branch6 and 6.4.0svn: r36045 and
r36046. GRASS 7 doesn't have this problem.

It will show up next by Saturday in the online manual.
Closing ticket.

Markus

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/503#comment:3&gt;
GRASS GIS <http://grass.osgeo.org>

5

#503: wx-GUI: html-manual
--------------------------+-------------------------------------------------
  Reporter: hellik | Owner: grass-dev@lists.osgeo.org
      Type: defect | Status: reopened
  Priority: minor | Milestone: 6.4.0
Component: Docs | Version: 6.4.0 RCs
Resolution: | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by hamish):

  * status: closed => reopened
  * resolution: fixed =>

Comment:

reopening ticket, as the problem still happens and the fix actually does
nothing.

'make distclean' does not remove gui/wxpython/docs/*.tmp.html. i.e. it's
not about $(GISBASE)/docs/html/$$file.html, it's about the .tmp.html file
in the source dir.

run "make" in gui/wxpython/docs/ a few times and watch them grow.

Two problems to fix as I see it:
   - 'make clean' does not clean up the .tmp.html files in docs/

and

   - 'make htmldir' is appending to instead of replacing the .tmp.html
file.

not really sure about how to fix Makefile stuff,
Hamish

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/503#comment:4&gt;
GRASS GIS <http://grass.osgeo.org>

6

#503: wx-GUI: html-manual
--------------------------+-------------------------------------------------
  Reporter: hellik | Owner: grass-dev@lists.osgeo.org
      Type: defect | Status: reopened
  Priority: minor | Milestone: 6.4.0
Component: Docs | Version: 6.4.0 RCs
Resolution: | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Comment (by hamish):

this version of the hack better addresses the symptom, but not the cause:

{{{
Index: gui/wxpython/docs/Makefile

--- gui/wxpython/docs/Makefile (revision 36060)
+++ gui/wxpython/docs/Makefile (working copy)
@@ -10,4 +10,4 @@
  include $(MODULE_TOPDIR)/include/Make/Rules.make

  default:
- for file in $(FILES) ; do rm -f $(GISBASE)/docs/html/$$file.html;
$(MAKE) htmldir PGM=$$file; done
+ for file in $(FILES) ; do rm -f $$file.tmp.html; $(MAKE) htmldir
PGM=$$file; done
}}}

H

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/503#comment:5&gt;
GRASS GIS <http://grass.osgeo.org>

7

#503: wx-GUI: html-manual
--------------------------+-------------------------------------------------
  Reporter: hellik | Owner: grass-dev@lists.osgeo.org
      Type: defect | Status: closed
  Priority: minor | Milestone: 6.4.0
Component: Docs | Version: 6.4.0 RCs
Resolution: fixed | Keywords:
  Platform: Unspecified | Cpu: Unspecified
--------------------------+-------------------------------------------------
Changes (by neteler):

  * status: reopened => closed
  * resolution: => fixed

Comment:

Local tmp file removal submitted in changeset r36318 and r36319. Manual
regenerated, seems ok now:
  http://grass.osgeo.org/grass64/manuals/html64_user/wxGUI.html

Markus

--
Ticket URL: <http://trac.osgeo.org/grass/ticket/503#comment:6&gt;
GRASS GIS <http://grass.osgeo.org>