Re: [PATCH] intro.1: some improvements

["Stéphane Aulery" <saulery-GANU6spQydw@public.gmane.org>]

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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html