[systemd-devel] [PATCH] man: improve grammar and word formatting in numerous man pages
zbyszek at in.waw.pl
Tue Jul 2 19:19:07 PDT 2013
On Tue, Jul 02, 2013 at 12:16:09PM +0200, Jason St. John wrote:
> On Sat, Jun 29, 2013 at 5:38 PM, Zbigniew Jędrzejewski-Szmek
> <zbyszek at in.waw.pl> wrote:
> > On Thu, Jun 27, 2013 at 09:51:44PM +0200, Jason St. John wrote:
> > Hi David,
> > you changed the spellings of 'file system' and 'namespace'.
> > Here is a proposal to use 'hostname' and 'file name' (instead
> > of 'host name' and 'filename'). Consistency might be more
> > important than pure grammatical considerations, so ... what
> > do you think?
> > Zbyszek
> I agree that consistency is more important than being grammatically
> "pure"; however, Red Hat seems to use "file system" in all of their
> documentation. I don't see an obvious pattern for "hostname" vs. "host
> name" though, but it's difficult to get good numbers on that.
> My patch makes "host name" and "file name" a consistent standard for
> systemd man pages. I can't find anything missed in the man pages when
> I grep for their variations except for 3 examples in systemctl(1) and
so I have 0 'file names?' in man-pages, and lots of 'filenames?'.
'hostnames?' is almost much more popular than 'host names?'.
Michael Kerrisk shall be our guide here, thus 'filename' and
'hostname' win. The same is true for 'timezone' vs. 'time zone',
even though 'timezone' is not even a real word.
> Do you want me to resubmit the patch to fix those? Or should I
> resubmit this patch in two parts, one for the "host name", "file
> name", etc. changes and a second patch for the non-contentious
It's fine, applied with the modifications described above.
> P.S. I changed your reply to a bottom post. Hopefully that isn't a problem.
More information about the systemd-devel