Re: Minor grammar tweak to tmux.1

2015-02-05 Thread Jason McIntyre
On Wed, Feb 04, 2015 at 04:22:55PM -0800, Iain Morgan wrote:
 Adjust the description of find-window to avoid a contraction, and adjust
 the word order.
 
 Index: tmux.1
 ===
 RCS file: /cvs/src/usr.bin/tmux/tmux.1,v
 retrieving revision 1.412
 diff -u -r1.412 tmux.1
 --- tmux.16 Jan 2015 09:12:02 -   1.412
 +++ tmux.15 Feb 2015 00:15:33 -
 @@ -1337,7 +1337,7 @@
  matches only the window title.
  The default is
  .Fl CNT .
 -If only one window is matched, it'll be automatically selected,
 +If only one window is matched, it will automatically be selected,
  otherwise a choice list is shown.
  For the meaning of the
  .Fl F
 
 -- 
 Iain Morgan
 

i know there is a general acceptance that formal documentation shall
have no contractions. i don;t think it applies to the man pages.

firstly, it's hard to ask authors to write in a style that is unnatural
to them.

secondly, we would want to apply stuff like this consistently. that
would mean thousands of changes. for no gain, in my opinion.

projects like freebsd have been making such changes and i think it's a
big mistake. in many cases, the non-contracted form sounds awful. you
should watch a few episodes of peppa pig if you want to feel the effect
in full.

of course, if a writer chooses to write a page avoiding contractions,
that would be their prerogative, but i absolutely don;t want us to start
making changes like this.

jmc



Minor grammar tweak to tmux.1

2015-02-04 Thread Iain Morgan
Adjust the description of find-window to avoid a contraction, and adjust
the word order.

Index: tmux.1
===
RCS file: /cvs/src/usr.bin/tmux/tmux.1,v
retrieving revision 1.412
diff -u -r1.412 tmux.1
--- tmux.1  6 Jan 2015 09:12:02 -   1.412
+++ tmux.1  5 Feb 2015 00:15:33 -
@@ -1337,7 +1337,7 @@
 matches only the window title.
 The default is
 .Fl CNT .
-If only one window is matched, it'll be automatically selected,
+If only one window is matched, it will automatically be selected,
 otherwise a choice list is shown.
 For the meaning of the
 .Fl F

-- 
Iain Morgan