new readline command `export-completions'; update documentation; update translations with new strings; Makefile updates

doc/bash.1

@@ -5,14 +5,14 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Wed Oct 23 11:32:05 EDT 2024
+.\"	Last Change: Fri Nov 15 17:55:48 EST 2024
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .\" avoid a warning about an undefined register
 .\" .if !rzY .nr zY 0
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2024 October 23" "GNU Bash 5.3"
+.TH BASH 1 "2024 November 15" "GNU Bash 5.3"
 .\"
 .ie \n(.g \{\
 .ds ' \(aq
@@ -7703,6 +7703,39 @@ of possible completions, as if \fBmenu\-complete\fP had been given a
 negative argument.
 This command is unbound by default.
 .TP
+.B export\-completions
+Perform completion on the word before point as described above
+and write the list of possible completions to \fBreadline\fP's output
+stream using the following format, writing information on separate lines:
+.sp
+.IP
+.RS
+.nf
+The number of matches; 
+The word being completed;
+S:E, where S and E are the start and end offsets of the word
+in the readline line buffer; then
+Each match, one per line
+.fi
+.RE
+.sp
+.IP
+If there are no matches, the first line will be 0, and this command will
+not print any output after the S:E.
+If there is only a single match, this prints a single line containing it.
+If there is more than one match, this prints the common prefix of the
+matches, which may be empty, on the first line after the S:E,
+then the matches on subsequent lines.
+In this case, N will include the first line with the common prefix.
+.PD
+.IP
+.PD 0
+The user or application
+should be able to accommodate the possibility of a blank line.
+The intent is that the user or application reads N lines after the line
+containing S:E to obtain the match list.
+This command is unbound by default.
+.TP
 .B delete\-char\-or\-list
 Deletes the character under the cursor if not at the beginning or
 end of the line (like \fBdelete\-char\fP).