Menu

#100 doctools - generalize: doctool .GT. manpage tool

open
doctools (43)
7
2004-04-27
2003-03-15
Roy E Terry
No

I would like to see alternatives to manpage_*. Or at least
do not require all the arguments.

- "section" is a unixism that should not be required in a
general package. It just clutters and confuses those who
don't know what it means.

- "version" is nice but ought to be optional

- "command" is ok for manpage_begin but there should
be other ways of starting a page as it would make the
doctools package more generic which would be a good
thing.

Thanks for this very useful tool! - Roy Terry

Discussion

  • Andreas Kupries

    Andreas Kupries - 2003-03-24

    Logged In: YES
    user_id=75003

    I can agree with section. For version I am less sure, it will
    come in again in the [require] statements. ... It is correct that
    manpages not dealing directly with a package, overviews and
    the like, care less about a version.

    Instead of 'command' maybe call it 'title'. Have to think a bit
    more.

    What other ways of starting a page do you envision ?

    I wish a report could be assigned to more than one person.
    This is also something Joe English is interested in. guess I'll
    refer him to these items by mail.

     
  • Andreas Kupries

    Andreas Kupries - 2004-04-27
    • priority: 5 --> 7
     
  • Andreas Kupries

    Andreas Kupries - 2004-04-27
    • summary: generalize: doctool .GT. manpage tool --> doctools - generalize: doctool .GT. manpage tool