prefer nanosleep for sleep loadable builtin; changes for overflow in indexed array indices; make sure dynamic loading and unloading builtins updates programmable completion; document that assignment to PATH clears the command hash table; fix small memory leak from readline filename rewrite hook

doc/bashref.log

@@ -1,12 +1,12 @@
-This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_0) (preloaded format=etex 2021.8.30)  16 JUN 2023 12:11
+This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_0) (preloaded format=pdfetex 2021.8.30)  5 JUL 2023 11:27
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
  %&-line parsing enabled.
-**\nonstopmode \input /usr/local/src/bash/bash-20230616/doc/bashref.texi \input
- /usr/local/src/bash/bash-20230616/doc/bashref.texi
-(/usr/local/src/bash/bash-20230616/doc/bashref.texi
-(/usr/local/src/bash/bash-20230616/doc/texinfo.tex
+**\input /usr/local/src/bash/bash-20230703/doc/bashref.texi \input /usr/local/s
+rc/bash/bash-20230703/doc/bashref.texi
+(/usr/local/src/bash/bash-20230703/doc/bashref.texi
+(/usr/local/src/bash/bash-20230703/doc/texinfo.tex
 Loading texinfo [version 2015-11-22.14]:
 \outerhsize=\dimen16
 \outervsize=\dimen17
@@ -162,20 +162,23 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
 texinfo.tex: doing @include of version.texi
 
 
-(/usr/local/src/bash/bash-20230616/doc/version.texi) [1] [2]
-(/usr/local/build/bash/bash-20230616/doc/bashref.toc [-1] [-2] [-3]) [-4]
-Chapter 1
+(/usr/local/src/bash/bash-20230703/doc/version.texi) [1{/opt/local/var/db/texmf
+/fonts/map/pdftex/updmap/pdftex.map}] [2]
+(/usr/local/build/bash/bash-20230703/doc/bashref.toc [-1] [-2] [-3]) [-4]
+(/usr/local/build/bash/bash-20230703/doc/bashref.toc)
+(/usr/local/build/bash/bash-20230703/doc/bashref.toc) Chapter 1
 \openout0 = `bashref.toc'.
 
- (/usr/local/build/bash/bash-20230616/doc/bashref.aux)
+
+(/usr/local/build/bash/bash-20230703/doc/bashref.aux)
 \openout1 = `bashref.aux'.
 
- Chapter 2
-[1] [2]
+ Chapter 2 [1] [2]
 @cpindfile=@write2
 \openout2 = `bashref.cp'.
 
- [3] Chapter 3 [4] [5] [6] [7]
+
+[3] Chapter 3 [4] [5] [6] [7]
 @vrindfile=@write3
 \openout3 = `bashref.vr'.
 
@@ -227,7 +230,7 @@ Overfull \hbox (5.95723pt too wide) in paragraph at lines 724--725
  [49] [50] [51]
 [52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66]
 [67]
-Overfull \hbox (38.26585pt too wide) in paragraph at lines 5357--5357
+Overfull \hbox (38.26585pt too wide) in paragraph at lines 5355--5355
  []@texttt set [-abefhkmnptuvxBCEHPT] [-o @textttsl option-name@texttt ] [--] [
 -] [@textttsl ar-gu-ment []@texttt ][] 
 
@@ -240,7 +243,7 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5357--5357
 .etc.
 
 
-Overfull \hbox (38.26585pt too wide) in paragraph at lines 5358--5358
+Overfull \hbox (38.26585pt too wide) in paragraph at lines 5356--5356
  []@texttt set [+abefhkmnptuvxBCEHPT] [+o @textttsl option-name@texttt ] [--] [
 -] [@textttsl ar-gu-ment []@texttt ][] 
 
@@ -259,7 +262,7 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5358--5358
 [118] [119]
 texinfo.tex: doing @include of rluser.texi
 
- (/usr/local/src/bash/bash-20230616/lib/readline/doc/rluser.texi
+ (/usr/local/src/bash/bash-20230703/lib/readline/doc/rluser.texi
 Chapter 8 [120] [121] [122] [123] [124] [125] [126] [127] [128] [129] [130]
 [131]
 Underfull \hbox (badness 7540) in paragraph at lines 874--880
@@ -309,10 +312,10 @@ gnored[]
 texinfo.tex: doing @include of hsuser.texi
 
 
-(/usr/local/src/bash/bash-20230616/lib/readline/doc/hsuser.texi Chapter 9
+(/usr/local/src/bash/bash-20230703/lib/readline/doc/hsuser.texi Chapter 9
 [156] [157] [158] [159] [160] [161]) Chapter 10 [162] [163] [164] [165]
 [166]
-Underfull \hbox (badness 10000) in paragraph at lines 9656--9665
+Underfull \hbox (badness 10000) in paragraph at lines 9662--9671
 []@textrm All of the fol-low-ing op-tions ex-cept for `@texttt alt-array-implem
 entation[]@textrm '[],
 
@@ -325,7 +328,7 @@ entation[]@textrm '[],
 .etc.
 
 
-Underfull \hbox (badness 10000) in paragraph at lines 9656--9665
+Underfull \hbox (badness 10000) in paragraph at lines 9662--9671
 @textrm `@texttt disabled-builtins[]@textrm '[], `@texttt direxpand-default[]@t
 extrm '[], `@texttt strict-posix-default[]@textrm '[], and
 
@@ -341,16 +344,38 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
 [176] [177] Appendix C [178]
 texinfo.tex: doing @include of fdl.texi
 
- (/usr/local/src/bash/bash-20230616/doc/fdl.texi
+ (/usr/local/src/bash/bash-20230703/doc/fdl.texi
 [179] [180] [181] [182] [183] [184] [185]) Appendix D [186] [187] [188]
 [189] [190] [191] [192] [193] [194] [195] ) 
 Here is how much of TeX's memory you used:
- 3531 strings out of 497096
- 40273 string characters out of 6206923
- 87714 words of memory out of 5000000
- 4700 multiletter control sequences out of 15000+600000
+ 4102 strings out of 497086
+ 47608 string characters out of 6206517
+ 142074 words of memory out of 5000000
+ 4869 multiletter control sequences out of 15000+600000
  34315 words of font info for 116 fonts, out of 8000000 for 9000
  51 hyphenation exceptions out of 8191
- 16i,6n,16p,402b,942s stack positions out of 5000i,500n,10000p,200000b,80000s
+ 16i,6n,16p,389b,983s stack positions out of 5000i,500n,10000p,200000b,80000s
+{/opt/local/share/texmf-texlive/font
+s/enc/dvips/cm-super/cm-super-t1.enc}</opt/local/share/texmf-texlive/fonts/type
+1/public/amsfonts/cm/cmbx12.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
+lic/amsfonts/cm/cmcsc10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/
+amsfonts/cm/cmmi10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfo
+nts/cm/cmmi12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/c
+m/cmmi9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr1
+0.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr9.pfb><
+/opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsl10.pfb></opt/
+local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsltt10.pfb></opt/loc
+al/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb></opt/local/sh
+are/texmf-texlive/fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/share/t
+exmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/texmf-
+texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texli
+ve/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fon
+ts/type1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/typ
+e1/public/cm-super/sfrm1440.pfb>
+Output written on bashref.pdf (201 pages, 809290 bytes).
+PDF statistics:
+ 2808 PDF objects out of 2984 (max. 8388607)
+ 2560 compressed objects within 26 object streams
+ 329 named destinations out of 1000 (max. 500000)
+ 1157 words of extra memory for PDF output out of 10000 (max. 10000000)
 
-Output written on bashref.dvi (201 pages, 842012 bytes).