Re: [PATCH] intro.1: some improvements

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Michael,

Le mardi 10 mars 2015 à 09:53:23, Michael Kerrisk (man-pages) a écrit :
> 
> Okay. So, some observations:
> 
> 1. I've never been a huge fan of the extended intro.1 page. I just think
>    it's a little out of place as man page. For the most part, tutorials
>    are best put somewhere else. That said, the intro(1) page was already
>    there when I arrived as maintainer, and I'm not so disturbed by
>    the tutorial content that I want to eliminate it. I will even take
>    reasonable additions to it.

To be honest, I was a bit stunned when I saw this tutorial that will not
say his name in the introductory page. But why not ! Improve it then. It
could either be deleted or moved to a new page. I wonder why there is not
historically a section for howtos.


> So, you see pat of my problem was also that I think the text 
> still needed much work. I should have explained that, but I 
> left off to so, since I was not convinced we need this stuff 
> in general.

Thank you, I understand your point of view. In this case I totally inclined
to simply delete the tutorial, and replace it with, perhaps, a subject
index of user commands (most used). It would be much more useful.

Meanwhile, I sent a patch to correct inconsistencies.

Regards,

-- 
Stéphane Aulery
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux