From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?B?U3TDqXBoYW5l?= Aulery Subject: Re: [PATCH] intro.1: some improvements Date: Tue, 10 Mar 2015 23:30:05 +0100 Message-ID: <20150310223005.GA1559@free.fr> References: <54F6BBC0.4010401@gmail.com> <1425932797-16050-1-git-send-email-saulery@free.fr> <54FE8A86.9040405@gmail.com> <20150310074041.GA1627@free.fr> <54FEB103.6070200@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: Content-Disposition: inline In-Reply-To: <54FEB103.6070200-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: "Michael Kerrisk (man-pages)" Cc: linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org List-Id: linux-man@vger.kernel.org Hi Michael, Le mardi 10 mars 2015 =C3=A0 09:53:23, Michael Kerrisk (man-pages) a =C3= =A9crit : >=20 > Okay. So, some observations: >=20 > 1. I've never been a huge fan of the extended intro.1 page. I just th= ink > it's a little out of place as man page. For the most part, tutoria= ls > are best put somewhere else. That said, the intro(1) page was alre= ady > 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 no= t say his name in the introductory page. But why not ! Improve it then. I= t could either be deleted or moved to a new page. I wonder why there is n= ot historically a section for howtos. > So, you see pat of my problem was also that I think the text=20 > still needed much work. I should have explained that, but I=20 > left off to so, since I was not convinced we need this stuff=20 > in general. Thank you, I understand your point of view. In this case I totally incl= ined 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, --=20 St=C3=A9phane 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