Re: Future tense considered ungood?

[Chet Ramey]

On 3/10/22 2:08 PM, Karl O. Pinc wrote:
> Hi,
>
> I hope this is helpful, and not just bikeshedding.
>
> As a rule, I don't like future tense in docs.  E.g. in doc/rluser.texi:
>
> @item enable-bracketed-paste
> @vindex enable-bracketed-paste
> When set to @samp{On}, Readline will configure the terminal in a way
> that will enable it to insert each paste into the editing buffer as a
> single string of characters, instead of treating each character as if
> it had been read from the keyboard.  This can prevent pasted characters
> from being interpreted as editing commands.  The default is @samp{On}.
>
>
> Thing is, when enable-bracketed-paste is `on', Readline _does_ configure
> the terminal and inserts pastes..., etc.  It does not do it eventually,
> it does it right then.

I mean, if you're going to split hairs like that, it does not "do it right
then," it enables bracketed paste mode on the next call to readline() and
on subsequent calls. But I like the use of active voice.

--
``The lyf so short, the craft so long to lerne.'' - Chaucer
                 ``Ars longa, vita brevis'' - Hippocrates
Chet Ramey, UTech, CWRU    chet@case.edu    http://tiswww.cwru.edu/~chet/