#197 man: Add profiling support

output: manpages
closed-fixed
XSL (399)
3
2007-06-29
2004-05-24
Jens Elkner
No

Actually, the mandoc/docbook.xsl is very useful for
"young" (i.e. none-roff
gurus) to create system conform man pages.

However, since man sections differ on several OS, it
would be very helpful
to have profiling support for manpages as well.

E.g. Sysadmin man pages on Solaris are in section 1m,
on BSD in section 8
or:

<citerefentry os="solaris">
<refentrytitle>regex</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>
<citerefentry os="linux">
<refentrytitle>regex</refentrytitle>
<manvolnum>7</manvolnum>
</citerefentry>
<citerefentry os="bsd">
<refentrytitle>re_format</refentrytitle>
<manvolnum>7</manvolnum>
</citerefentry>

Discussion

    • assigned_to: nobody --> xmldoc
    • labels: 321174 -->
     
    • labels: --> 637321
     
  • Logged In: YES
    user_id=118135

    would be good to have, but is low-priority relative to
    bug fixes (for now).

     
    • priority: 5 --> 3
     
    • status: open --> pending-fixed
     
  • Logged In: YES
    user_id=118135

    A change for this issue has been added to the current codebase.
    Please test the change with the latest snapshot from:

    http://docbook.sourceforge.net/snapshots/

     
  • Logged In: YES
    user_id=118135

    I know that it is pathetic that it took 1 year to get around
    to implementing this, but....

    The distro now includes a manpages/profile-docbook.xsl
    stylesheet. Does it work? I don't know, because I haven't
    even had time to test it yet. But I think it does, and will
    test when I find time. Meanwhile, please test it if you
    can and report back. If it seems to be working as expected,
    I will close out this issue

     
    • status: pending-fixed --> open-fixed
     
  • Logged In: YES
    user_id=118135

    I just tested and found that this is not fixed :(

    But you know you can still do two-pass profiling,
    right?

    Anyway, one big limitation in single-pass profiling is
    that you can't use it you have xref or link elements in
    your source. That prevents it from being useful for
    most documents.

    But I will still try again to see if I can get it
    working...

     
    • summary: RFE: mandoc profiling support --> man: Add profiling support
    • labels: 637321 -->
     
    • milestone: --> output: manpages
    • labels: --> XSL
     
  • Logged In: YES
    user_id=118135
    Originator: NO

    A change for this issue has been added to the current codebase.
    Please test the change with the latest snapshot from:

    http://docbook.sourceforge.net/snapshots/

     
  • Logged In: YES
    user_id=118135
    Originator: NO

    implemented for 1.73.0 release

     
    • status: open-fixed --> closed-fixed