Re: Improve brackted-paste docs

[Frederick Eaton]

Hi Karl,

The original "insert each paste into the editing buffer as a single string of characters" 
hints at the fact that you can "undo" a bracketed paste in one keystroke; but that point 
seems obscured in your version. Maybe we can make it more explicit?

Thanks,

Frederick

On Sat, Feb 26, 2022 at 02:55:09PM -0600, Karl O. Pinc wrote:
> Hello,
>
> Please consider this patch.  (I wasn't able to easily
> find any documentation on what files were the source,
> so I assumed the GNU conventions and did this from memory.)
>
> Also, the bash man page contains a sub-set of the readline
> docs.  Hopefully making changes here is sufficient to
> update the bash docs as well.
>
> ------------------------------
> diff --git a/doc/rluser.texi b/doc/rluser.texi
> index 63e2c75..74353a3 100644
> --- a/doc/rluser.texi
> +++ b/doc/rluser.texi
> @@ -588,11 +588,10 @@ The default is @samp{On}.
>
> @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}.
> +When set to @samp{On}, Readline configures the terminal in a way that
> +inserts each paste into the editing buffer exactly as-is, instead of
> +executing the editing commands bound to key sequences appearing in the
> +paste.  The default is @samp{On}.
>
> @item enable-keypad
> @vindex enable-keypad
> ------------------------------
>
> Regards,
>
> Karl <kop@karlpinc.com>
> Free Software:  "You don't pay back, you pay forward."
>                 -- Robert A. Heinlein