From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Michael Kerrisk (man-pages)" Subject: Re: [patch 0/7] Use "FILE * stream" everywhere. Date: Fri, 16 Jan 2015 07:12:15 +0100 Message-ID: <54B8ABBF.8000602@gmail.com> References: <54B882F4.1090203@redhat.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <54B882F4.1090203-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org> Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: Carlos O'Donell , "linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org" Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org List-Id: linux-man@vger.kernel.org Hello Carlos, On 01/16/2015 04:18 AM, Carlos O'Donell wrote: > Harmonize all the manual pages to use "stream" for FILE* > instead of randomly using "fp" or "stream." Choosing something > and being consistent helps users scan the man pages quickly > and understand what they are looking at. Agreed, and thanks for preparing the patches. > The next 7 patches convert all instances of "FILE *fp" to > "FILE *stream". The vast majority of man pages already use > the "FILE *stream" version which I also prefer. Yes, good. It's what POSIX uses too. I tweaked some wordings very slightly (adding or removing "the" in a couple of places), and gave the patches the title: Consistency fix: use "stream" as name for "FILE *" argument I also made related changes in fmemopen(3), fopencookie(3), and getline(3). Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- 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