As I don't now when the new groff version is going to be released, this can be easily patched.
Just apply the attached changes to this file:
/usr/share/groff/1.22.4/tmac/an-old.tmac

Hans

On 18/04/21 08.34, Hans Unzner wrote:
It will be version 3 because the man pages will be automatically formatted like this with the next groff release. (without any changes of the man pages)
My suggestion to the groff community was directly implemented.
Furthermore the subsection headings will also appear in the TOC.

In groff 1.22.5 or 1.23.0 (not sure how they will name it) it will look like this:
https://hansu.github.io/linuxcnc-doc/man-new-ss/man1/halui.1.html

Hans

On 16/04/21 19:17, Hans Unzner wrote:
Unfortunately the subsections (.SS) of the man pages are not treated as such when convertet to HTML. Just bold text.
Especially the halui man page lacks clarity because of that.

I created a little macro that handles the subsections.
What version would you prefer?

1. Indent the text of the subsection:
https://hansu.github.io/linuxcnc-doc/man/man1/halui_subsection1.1.html
2. Indent the subsection heading somewhere between the section heading and the text like the view in the terminal:
https://hansu.github.io/linuxcnc-doc/man/man1/halui_subsection2.1.html
3. Use <h3></h3> HTML tags and let the indentation be controlled by the stylesheet:
https://hansu.github.io/linuxcnc-doc/man/man1/halui_subsection3.1.html

Hans


diff --git a/tmac/an-old.tmac b/tmac/an-old.tmac
index ba1ad64f..ad131471 100644
--- a/tmac/an-old.tmac
+++ b/tmac/an-old.tmac
@@ -317,7 +317,7 @@
 .  in \\n[an-margin]u
 .  ti 0
 .  nr need_eo_h 1
-.  DEVTAG-NH \\n[an-level]
+.  DEVTAG-SH 1
 .  itc 1 an-trap
 .  nr an-no-space-flag 1
 .  nr an-break-flag 1
@@ -337,6 +337,8 @@
 .  fi
 .  in \\n[IN]u
 .  ti \\n[SN]u
+.  nr need_eo_h 1
+.  DEVTAG-SH 2
 .  itc 1 an-trap
 .  nr an-no-space-flag 1
 .  nr an-break-flag 1
_______________________________________________
Emc-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/emc-developers

Reply via email to