Hi Hong,

Hong Xu <h...@topbug.net> (Mo 14 Sep 2015 18:39:35 CEST):
…
> I'm the upstream author and thanks for your report. The man pages are
> generated from Doxygen. I believe this issue is actually a Doxygen
> issue: they should add some text like "foo(5)" when the @refer command
> is used for man pages. If I add the text manually, it would be a mess
> for html documentation generation.

Maybe there can be done something more for the manpage generation, to
generate manual pages that contain the usual man page structure:

    NAME

        editorconfig - editorconfig command line interface

    SYNOPSIS

        editorconfig [-f filename] [-b version] FILEPATH...
        editorconfig [-h|--help]
        editorconfig [-v|--version]

    DESCRIPTION

    editorconfig …

    OPTIONS

        -f specify an alternative config file path
        …

    SEE ALSO

    The format description for the .editorconfig file 
    can be found in editorconfig-format(5).


I'm not sure, if doxygen is the right tool to generate such
output directly from the source. But I'm not a doxygen expert at all.

    Best regards from Dresden/Germany
    Viele Grüße aus Dresden
    Heiko Schlittermann
-- 
 SCHLITTERMANN.de ---------------------------- internet & unix support -
 Heiko Schlittermann, Dipl.-Ing. (TU) - {fon,fax}: +49.351.802998{1,3} -
 gnupg encrypted messages are welcome --------------- key ID: F69376CE -
 ! key id 7CBF764A and 972EAC9F are revoked since 2015-01 ------------ -

Attachment: signature.asc
Description: Digital signature

Reply via email to