grass icon indicating copy to clipboard operation
grass copied to clipboard

[Bug] Launching GRASS GIS database (projects) manual from the wxGUI Data catalog Info bar component is not working

Open tmszi opened this issue 2 months ago • 3 comments

Describe the bug

Launching GRASS GIS database manual from the wxGUI Data catalog Info bar component Learn more button widget is not working.

To reproduce

  1. Backup GRASS GIS settings directory if exists: mv .grass8 .grass8_bckp
  2. Launch GRASS GIS with GUI
  3. On the Data catalog Info bar component hit Learn more button widget
  4. See error
(Mon Nov 10 07:08:26 2025)                                                      
g.manual entry=grass_projects                                                   
ERROR: No HTML manual page entry for 'grass_projects'
(Mon Nov 10 07:08:26 2025) Command ended with non-zero return code 1 (0 sec)    

Expected behavior

Launching GRASS GIS database manual from the wxGUI Data catalog Info bar component Learn more button widget should work.

Screenshots

Image

System description

  • Operating System: all
  • GRASS version: 8.5.0dev

tmszi avatar Nov 10 '25 07:11 tmszi

During local GRASS GIS compilation process is still using HTML files for generating HTML man pages instead of MD files.

To solve the issue, it should be enough to rename the file grass_database.html to grass_projects.html

tomas@gentoo-gnu-linux:~/src/grass/doc$ ls -l grass_database.*
-rw-r--r-- 1 tomas tomas 11156 Nov 10 08:02 grass_database.html
-rw-r--r-- 1 tomas tomas  9455 Oct 23 22:04 grass_database.md
-rw-r--r-- 1 tomas tomas 50199 Nov  5  2024 grass_database.png
-rw-r--r-- 1 tomas tomas 26431 Nov  5  2024 grass_database.svg

But MD equivalent file grass_database.md is not possible rename to grass_projects.md file, because file exists.

tomas@gentoo-gnu-linux:~/src/grass/doc$ ls -l grass_projects.md 
-rw-r--r-- 1 tomas tomas 12553 Oct 23 22:04 grass_projects.md

tmszi avatar Nov 10 '25 08:11 tmszi

You need to build the documentation, then it will work.

cd man
make build-mkdocs

petrasovaa avatar Nov 10 '25 16:11 petrasovaa

You need to build the documentation, then it will work.

cd man
make build-mkdocs

Thanks. But I have the GRASS documentation (old way of creating HTML docs) created automatically during compilation process.

tmszi avatar Nov 11 '25 03:11 tmszi