Package: bash Version: 4.4-5 Severity: minor Tags: patch Dear Maintainer (Debian and upstream),
The result of some tests. The patch is in the attachment. Test nr. 1: Remove space at end of lines. 413:does not attempt to read any other startup files. 1391:Expands to the current option flags as specified upon invocation, 2062:A filename whose suffix matches one of the entries in 4251:option to the 4946:signal by the kernel's terminal driver, #### Test nr. 2: Fix warning from man/groff <standard input>:2101 (macro IR): only 1 argument, but more are expected <standard input>:3400 (macro BR): only 1 argument, but more are expected <standard input>:6801 (macro BR): only 1 argument, but more are expected <standard input>:8627 (macro IR): only 1 argument, but more are expected #### Test nr. 18: Change - to \- if it means a minus. 2755:each term. The default increment is 1 or -1 as appropriate. 3000:positional parameter, so an offset of -1 evaluates to the last positional 5533:.B completion\-display\-width (-1) 5539:The default value is -1. 8774:Two special argument values may be used: -1 represents the current 8775:time, and -2 represents the time the shell was invoked. 8776:If no argument is specified, conversion behaves as if -1 had been given. #### Test nr. 22: Use (in)valid instead of "(il)legal" (GNU coding standards). 2633:Any reference to a variable using a valid subscript is legal, and #### Test nr. 25: Change a HYPHEN-MINUS (code 0x55, 2D) to a dash (minus, for options), if it matches " -[:alpha:]" or \(aq-[:alpha:] 4344:\fIinteger\fP attribute using \fBdeclare -i\fP is assigned a value. 6644:with \fBcomplete -D\fP. 6667:complete -D -F _completion_loader -o bashdefault -o default ##### -- System Information: Debian Release: buster/sid APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 4.9.65-3u2 (SMP w/2 CPU cores) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/dash Init: sysvinit (via /sbin/init) Versions of packages bash depends on: ii base-files 10.1 ii dash 0.5.8-2.10 ii debianutils 4.8.4 ii libc6 2.26-4 ii libtinfo5 6.0+20171125-1 Versions of packages bash recommends: ii bash-completion 1:2.1-4.3 Versions of packages bash suggests: pn bash-doc <none> -- no debconf information -- Bjarni I. Gislason
--- bash.1 2017-05-15 19:45:32.000000000 +0000 +++ bash.1.new 2018-02-08 00:50:03.000000000 +0000 @@ -410,7 +410,7 @@ files, the option has no effect. A non-interactive shell invoked with the name .B sh -does not attempt to read any other startup files. +does not attempt to read any other startup files. When invoked as .BR sh , .B bash @@ -1388,7 +1388,7 @@ Expands to the exit status of the most r pipeline. .TP .B \- -Expands to the current option flags as specified upon invocation, +Expands to the current option flags as specified upon invocation, by the .B set builtin command, or those set by the shell itself @@ -2059,7 +2059,7 @@ filename completion (see .SM .B READLINE below). -A filename whose suffix matches one of the entries in +A filename whose suffix matches one of the entries in .SM .B FIGNORE is excluded from the list of matched filenames. @@ -2098,7 +2098,7 @@ A value of .I ignoreboth is shorthand for \fIignorespace\fP and \fIignoredups\fP. A value of -.IR erasedups +.I erasedups causes all previous lines matching the current line to be removed from the history list before that line is saved. Any value not in the above list is ignored. @@ -2630,7 +2630,7 @@ array, and an index of \-1 references th .PP Referencing an array variable without a subscript is equivalent to referencing the array with a subscript of 0. -Any reference to a variable using a valid subscript is legal, and +Any reference to a variable using a valid subscript is valid, and .B bash will create an array if necessary. .PP @@ -2752,7 +2752,7 @@ lexicographically between \fIx\fP and \f using the default C locale. Note that both \fIx\fP and \fIy\fP must be of the same type. When the increment is supplied, it is used as the difference between -each term. The default increment is 1 or -1 as appropriate. +each term. The default increment is 1 or \-1 as appropriate. .PP Brace expansion is performed before any other expansions, and any characters special to other expansions are preserved @@ -2997,7 +2997,7 @@ one space to avoid being confused with t If \fIparameter\fP is \fB@\fP, the result is \fIlength\fP positional parameters beginning at \fIoffset\fP. A negative \fIoffset\fP is taken relative to one greater than the greatest -positional parameter, so an offset of -1 evaluates to the last positional +positional parameter, so an offset of \-1 evaluates to the last positional parameter. It is an expansion error if \fIlength\fP evaluates to a number less than zero. @@ -3397,7 +3397,7 @@ are ignored at the beginning and end of word, as long as the whitespace character is in the value of .SM -.BR IFS +.B IFS (an .SM .B IFS @@ -4248,7 +4248,7 @@ shell option is enabled). Functions may be exported so that subshells automatically have them defined with the .B \-f -option to the +option to the .B export builtin. A function definition may be deleted using the \fB\-f\fP option to @@ -4341,7 +4341,7 @@ A shell variable that is null or unset e by name without using the parameter expansion syntax. The value of a variable is evaluated as an arithmetic expression when it is referenced, or when a variable which has been given the -\fIinteger\fP attribute using \fBdeclare -i\fP is assigned a value. +\fIinteger\fP attribute using \fBdeclare \-i\fP is assigned a value. A null value evaluates to 0. A shell variable need not have its \fIinteger\fP attribute turned on to be used in an expression. @@ -4943,7 +4943,7 @@ Background processes which attempt to re terminal are sent a .SM .B SIGTTIN (SIGTTOU) -signal by the kernel's terminal driver, +signal by the kernel's terminal driver, which, unless caught, suspends the process. .PP If the operating system on which @@ -5530,13 +5530,13 @@ in emacs mode and to .B # in vi command mode. .TP -.B completion\-display\-width (-1) +.B completion\-display\-width (\-1) The number of screen columns used to display possible matches when performing completion. The value is ignored if it is less than 0 or greater than the terminal screen width. A value of 0 will cause matches to be displayed one per line. -The default value is -1. +The default value is \-1. .TP .B completion\-ignore\-case (Off) If set to \fBOn\fP, readline performs filename matching and completion @@ -6641,7 +6641,7 @@ of the setting of the \fBmark-symlinked\ .PP There is some support for dynamically modifying completions. This is most useful when used in combination with a default completion specified -with \fBcomplete -D\fP. +with \fBcomplete \-D\fP. It's possible for shell functions executed as completion handlers to indicate that completion should be retried by returning an exit status of 124. If a shell function returns 124, and changes @@ -6664,7 +6664,7 @@ completion function would load completio .br } .br -complete -D -F _completion_loader -o bashdefault -o default +complete \-D \-F _completion_loader \-o bashdefault \-o default .br \fP .SH HISTORY @@ -6798,7 +6798,7 @@ for information on setting and unsetting .PP The shell supports a history expansion feature that is similar to the history expansion in -.BR csh. +.BR csh . This section describes what syntax features are available. This feature is enabled by default for interactive shells, and can be disabled using the @@ -8167,7 +8167,7 @@ echoed and executed. .sp 1 In the second form, \fIcommand\fP is re-executed after each instance of \fIpat\fP is replaced by \fIrep\fP. -\fICommand\fP is intepreted the same as \fIfirst\fP above. +\fICommand\fP is interpreted the same as \fIfirst\fP above. A useful alias to use with this is .if n ``r="fc -s"'', .if t \f(CWr='fc \-s'\fP, @@ -8624,7 +8624,7 @@ Exit a login shell. Read lines from the standard input into the indexed array variable .IR array , or from file descriptor -.IR fd +.I fd if the .B \-u option is supplied. @@ -8771,9 +8771,9 @@ causes \fBprintf\fP to output the date-t \fIdatefmt\fP as a format string for \fIstrftime\fP(3). The corresponding \fIargument\fP is an integer representing the number of seconds since the epoch. -Two special argument values may be used: -1 represents the current -time, and -2 represents the time the shell was invoked. -If no argument is specified, conversion behaves as if -1 had been given. +Two special argument values may be used: \-1 represents the current +time, and \-2 represents the time the shell was invoked. +If no argument is specified, conversion behaves as if \-1 had been given. This is an exception to the usual \fBprintf\fP behavior. .PD .PP