Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.debian.user > #180270

Re: Debian man pages - mechanics of creation/publication?

Show all headers | View raw

On 04/19/2017 06:59 AM, Peter Ludikovsky wrote:
> On 04/19/2017 01:40 PM, Richard Owlett wrote:
>> I've an idea for something to be added to some man pages.
>> It has not risen even the "wishlist bug" stage yet.
>> To rise that far I have to convince myself that the modification of so
>> many existing man pages could be automated.
>>
>> A web search turned up very low level details but not the need overview.
>> Suggestions?
>> TIA
>
> 1) What do you want to do? I'm asking this because it decides whether
> this change could be interesting for others or not.

I debated mentioning the items that triggered my question. I'm not 
personally convinced that a man page would be the optimal place for the 
specific items. I phrased the subject line as I did because I have a 
long term felling that man pages aren't perfect ;/ But maybe the 
imperfection is more in me for not seeing that information really does 
not belong in a man page.

I think it 'should' be of interest to others. But considering answers 
I've gotten on other topics, I may be representative of a small minority.

> 2) Does it affect only Debian-specific man pages, or man pages in
> general? This answer decides if the change is a relatively small
> one (1 or 2 packages), or if you'll have to contact every upstream
> project to get the changes included.

For want of a better term, they might be considered to be "Debian 
specific footnotes

> 3) For any change you want to do & submit an patch for you should read
> up on groff/troff, as that syntax is the base for man.

That was one of the specifics that triggered mention of "very low level 
details".

>
> Regards
> /peter
>

Back to linux.debian.user | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

Debian man pages - mechanics of creation/publication? Richard Owlett <rowlett@cloud85.net> - 2017-04-19 13:50 +0200
  Re: Debian man pages - mechanics of creation/publication? Peter Ludikovsky <peter@ludikovsky.name> - 2017-04-19 14:10 +0200
    Re: Debian man pages - mechanics of creation/publication? Richard Owlett <rowlett@cloud85.net> - 2017-04-19 15:30 +0200
      Re: Debian man pages - mechanics of creation/publication? David Wright <deblis@lionunicorn.co.uk> - 2017-04-19 15:50 +0200
      Re: Debian man pages - mechanics of creation/publication? rhkramer@gmail.com - 2017-04-20 14:50 +0200
  Re: Debian man pages - mechanics of creation/publication? songbird <songbird@anthive.com> - 2017-04-19 15:50 +0200
  Re: Debian man pages - mechanics of creation/publication? songbird <songbird@anthive.com> - 2017-04-19 17:10 +0200
  Re: Debian man pages - mechanics of creation/publication? Ben Finney <bignose@debian.org> - 2017-04-20 01:10 +0200

csiph-web