From: "Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: Carlos O'Donell <carlos-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
"linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org"
<linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org>
Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
Subject: Re: [patch 0/7] Use "FILE * stream" everywhere.
Date: Fri, 16 Jan 2015 07:12:15 +0100 [thread overview]
Message-ID: <54B8ABBF.8000602@gmail.com> (raw)
In-Reply-To: <54B882F4.1090203-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.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
next prev parent reply other threads:[~2015-01-16 6:12 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-01-16 3:18 [patch 0/7] Use "FILE * stream" everywhere Carlos O'Donell
[not found] ` <54B882F4.1090203-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
2015-01-16 6:12 ` Michael Kerrisk (man-pages) [this message]
[not found] ` <54B8ABBF.8000602-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2015-01-16 21:04 ` Carlos O'Donell
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=54B8ABBF.8000602@gmail.com \
--to=mtk.manpages-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
--cc=carlos-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
--cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.