Re: Small grammar issue in 'langmap'/'langremap' help

On 2020-03-02 20:55, Bram Moolenaar wrote:
> Tim Chase wrote:
>
> > Reading the help on 'langmap' today, I encountered this
> >
> > Also consider resetting 'langremap' to avoid 'langmap'
> > applies to characters resulting from a mapping.
> >
> > Despite reading this multiple times, I'm not quite sure what this
> > is trying to say. Confusion includes
> >
> > - what does it mean to "reset"? (usually "reset" for a setting
> > means `set langmap&`, but in this case it defaults to *on*, so
> > resetting would do the opposite of what is intended). This also
> > applies in the help for 'langremap' where it says "reset in
> > defaults.vim")
>
> Resetting means setting it off.

From `:help set-&`

:se[t] {option}& Reset option to its default value.

which makes much more sense for "reset", not setting a value to off.

> How about:
> Also consider setting 'langremap' to off, to avoid that
> 'langmap' applies to characters resulting from a mapping.

the "avoid…applies" might be better written as

to prevent 'langmap' from applying to characters

> > boolean (default on, turned off in defaults.vim)
>
> I like to keep "set" in there, since that's the command that is
> used. "set to off" is less ambiguous, but it doesn't sound very
> nice.

I agree that "set" is clearer. Perhaps rephrasing it like

boolean (default on, defaults.vim sets to off)

would help, or explicitly say what defaults.vim does:

boolean (default on; defaults.vim sets 'nolrm')

Thoughts?

-tim



--
--
You received this message from the "vim_use" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php

---
You received this message because you are subscribed to the Google Groups "vim_use" group.
To unsubscribe from this group and stop receiving emails from it, send an email to vim_use+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/vim_use/20200302145321.788754df%40bigbox.attlocal.net.