interim fix for generic list functions to avoid pointer aliasing issues; documentation updates

doc/bashref.log

@@ -1,12 +1,12 @@
-This is pdfTeX, Version 3.141592653-2.6-1.40.27 (TeX Live 2025/MacPorts 2025.74524_1) (preloaded format=etex 2025.9.16)  2 FEB 2026 15:27
+This is pdfTeX, Version 3.141592653-2.6-1.40.27 (TeX Live 2025/MacPorts 2025.74524_1) (preloaded format=pdfetex 2025.9.16)  29 APR 2026 10:19
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
  %&-line parsing enabled.
-**\nonstopmode \input /usr/local/src/bash/bash-20260130/doc/bashref.texi \input
- /usr/local/src/bash/bash-20260130/doc/bashref.texi
-(/usr/local/src/bash/bash-20260130/doc/bashref.texi
-(/usr/local/src/bash/bash-20260130/doc/texinfo.tex
+**\input /usr/local/src/bash/bash-20260428/doc/bashref.texi \input /usr/local/s
+rc/bash/bash-20260428/doc/bashref.texi
+(/usr/local/src/bash/bash-20260428/doc/bashref.texi
+(/usr/local/src/bash/bash-20260428/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-20260130/doc/version.texi) [1] [2]
-(/usr/local/build/bash/bash-20260130/doc/bashref.toc [-1] [-2] [-3]) [-4]
-Chapter 1
+(/usr/local/src/bash/bash-20260428/doc/version.texi) [1{/opt/local/var/db/texmf
+/fonts/map/pdftex/updmap/pdftex.map}] [2]
+(/usr/local/build/bash/bash-20260428/doc/bashref.toc [-1] [-2] [-3]) [-4]
+(/usr/local/build/bash/bash-20260428/doc/bashref.toc)
+(/usr/local/build/bash/bash-20260428/doc/bashref.toc) Chapter 1
 \openout0 = `bashref.toc'.
 
- (/usr/local/build/bash/bash-20260130/doc/bashref.aux)
+
+(/usr/local/build/bash/bash-20260428/doc/bashref.aux)
 \openout1 = `bashref.aux'.
 
- [1] Chapter 2
-[2]
+ [1] Chapter 2 [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'.
 
@@ -219,16 +222,17 @@ Overfull \hbox (5.95723pt too wide) in paragraph at lines 765--766
 @rwindfile=@write4
 \openout4 = `bashref.rw'.
 
- [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23]
-[24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38]
-[39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50] Chapter 4 [51]
+ [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20{/opt/local/share/texmf-t
+exlive/fonts/enc/dvips/cm-super/cm-super-t1.enc}] [21] [22] [23] [24]
+[25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38] [39]
+[40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50] Chapter 4 [51]
 @btindfile=@write5
 \openout5 = `bashref.bt'.
 
-
-[52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66]
-[67] [68] [69] [70] [71] [72] [73]
-Overfull \hbox (38.26585pt too wide) in paragraph at lines 5964--5964
+ [52]
+[53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67]
+[68] [69] [70] [71] [72] [73]
+Overfull \hbox (38.26585pt too wide) in paragraph at lines 5981--5981
  []@texttt set [-abefhkmnptuvxBCEHPT] [-o @textttsl option-name@texttt ] [--] [
 -] [@textttsl ar-gu-ment []@texttt ][] 
 
@@ -241,7 +245,7 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5964--5964
 .etc.
 
 
-Overfull \hbox (38.26585pt too wide) in paragraph at lines 5965--5965
+Overfull \hbox (38.26585pt too wide) in paragraph at lines 5982--5982
  []@texttt set [+abefhkmnptuvxBCEHPT] [+o @textttsl option-name@texttt ] [--] [
 -] [@textttsl ar-gu-ment []@texttt ][] 
 
@@ -257,12 +261,12 @@ Overfull \hbox (38.26585pt too wide) in paragraph at lines 5965--5965
 [87] [88] [89] [90] [91] [92] [93] [94] [95] [96] [97] [98] Chapter 6 [99]
 [100] [101] [102] [103] [104] [105] [106] [107] [108] [109] [110] [111]
 [112] [113] [114] [115] [116] [117] [118] [119] [120] [121] [122] [123]
-Chapter 7 [124] [125] [126] [127] [128]
+[124] Chapter 7 [125] [126] [127] [128] [129]
 texinfo.tex: doing @include of rluser.texi
 
 
-(/usr/local/src/bash/bash-20260130/lib/readline/doc/rluser.texi Chapter 8
-[129] [130] [131] [132] [133] [134] [135] [136] [137] [138] [139] [140]
+(/usr/local/src/bash/bash-20260428/lib/readline/doc/rluser.texi Chapter 8
+[130] [131] [132] [133] [134] [135] [136] [137] [138] [139] [140] [141]
 Underfull \hbox (badness 7540) in paragraph at lines 969--975
  []@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
 -tion
@@ -288,7 +292,7 @@ e func-tion
 .@texttt v
 .etc.
 
-[141] [142] [143] [144]
+[142] [143] [144] [145]
 Overfull \hbox (26.43913pt too wide) in paragraph at lines 1215--1215
  []@texttt Meta-Control-h: backward-kill-word Text after the function name is i
 gnored[] 
@@ -301,19 +305,19 @@ gnored[]
 .@texttt t
 .etc.
 
-[145] [146]
+[146] [147]
 @fnindfile=@write6
 \openout6 = `bashref.fn'.
 
- [147] [148] [149] [150] [151] [152] [153] [154] [155] [156]
-[157] [158] [159] [160] [161] [162] [163] [164] [165] [166])
+ [148] [149] [150] [151] [152] [153] [154] [155] [156] [157]
+[158] [159] [160] [161] [162] [163] [164] [165] [166] [167])
 texinfo.tex: doing @include of hsuser.texi
 
 
-(/usr/local/src/bash/bash-20260130/lib/readline/doc/hsuser.texi Chapter 9
-[167] [168] [169] [170] [171] [172] [173]) Chapter 10 [174] [175] [176]
-[177] [178]
-Underfull \hbox (badness 10000) in paragraph at lines 10793--10802
+(/usr/local/src/bash/bash-20260428/lib/readline/doc/hsuser.texi Chapter 9
+[168] [169] [170] [171] [172] [173] [174]) Chapter 10 [175] [176] [177]
+[178] [179]
+Underfull \hbox (badness 10000) in paragraph at lines 10855--10864
 []@textrm All of the fol-low-ing op-tions ex-cept for `@texttt alt-array-implem
 entation[]@textrm '[],
 
@@ -326,7 +330,7 @@ entation[]@textrm '[],
 .etc.
 
 
-Underfull \hbox (badness 10000) in paragraph at lines 10793--10802
+Underfull \hbox (badness 10000) in paragraph at lines 10855--10864
 @textrm `@texttt disabled-builtins[]@textrm '[], `@texttt direxpand-default[]@t
 extrm '[], `@texttt strict-posix-default[]@textrm '[], and
 
@@ -338,21 +342,42 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
 .@texttt a
 .etc.
 
-[179] [180] [181] [182] Appendix A [183] Appendix B [184] [185] [186] [187]
-[188] [189] [190] Appendix C [191]
+[180] [181] [182] [183] Appendix A [184] Appendix B [185] [186] [187] [188]
+[189] [190] [191] Appendix C [192]
 texinfo.tex: doing @include of fdl.texi
 
 
-(/usr/local/src/bash/bash-20260130/doc/fdl.texi [192] [193] [194] [195]
-[196] [197] [198]) Appendix D [199] [200] [201] [202] [203] [204] [205]
-[206] [207] [208] ) 
+(/usr/local/src/bash/bash-20260428/doc/fdl.texi [193] [194] [195] [196]
+[197] [198] [199]) Appendix D [200] [201] [202] [203] [204] [205] [206]
+[207] [208] [209] ) 
 Here is how much of TeX's memory you used:
- 3531 strings out of 495830
- 40273 string characters out of 6171293
- 88550 words of memory out of 5000000
- 4884 multiletter control sequences out of 15000+600000
+ 4117 strings out of 495820
+ 47665 string characters out of 6170887
+ 145121 words of memory out of 5000000
+ 5053 multiletter control sequences out of 15000+600000
  34315 words of font info for 116 fonts, out of 8000000 for 9000
  701 hyphenation exceptions out of 8191
- 16i,6n,16p,402b,942s stack positions out of 10000i,1000n,20000p,200000b,200000s
+ 16i,6n,16p,389b,983s stack positions out of 10000i,1000n,20000p,200000b,200000s
+</opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/
+cm/cmbx12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cm
+csc10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi10
+.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi12.pfb>
+</opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi9.pfb></opt/
+local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr10.pfb></opt/local/
+share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmr9.pfb></opt/local/share/t
+exmf-texlive/fonts/type1/public/amsfonts/cm/cmsl10.pfb></opt/local/share/texmf-
+texlive/fonts/type1/public/amsfonts/cm/cmsltt10.pfb></opt/local/share/texmf-tex
+live/fonts/type1/public/amsfonts/cm/cmsy10.pfb></opt/local/share/texmf-texlive/
+fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/share/texmf-texlive/fonts
+/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/texmf-texlive/fonts/type
+1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
+lic/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm
+-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm-super
+/sfrm1440.pfb>
+Output written on bashref.pdf (215 pages, 814924 bytes).
+PDF statistics:
+ 2954 PDF objects out of 2984 (max. 8388607)
+ 2691 compressed objects within 27 object streams
+ 343 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 (214 pages, 903700 bytes).