                        SOME SCRIPTS WILL NOT RUN AS IS


Note that the source code for certain of the example shell scripts
have the "&lt;" and "&gt;" in place of angle brackets (< and >), or &amp; in
place of the ampersand (&). This is necessary for the Docbook SGML
conversion. If you plan to run these scripts from the enclosed source
files, then it will, of course, be necessary to restore the angle
brackets or ampersand.

                     &lt;           becomes  <
                     &gt;           becomes  >
                     &lt;&lt;       becomes  <<
                     &lt;&lt;&lt;   becomes  <<<
                     &gt;&gt;       becomes  >>
                     &amp;          becomes  &

In some of the below cases, only the comments are affected, and these scripts
require no fixups to execute as expected.


The following sed scriptlet will accomplish the fixup:

   sed -e 's/&lt;/</g' -e 's/&gt;/>/g' SCRIPT.sh > FIXED_SCRIPT.sh

A followup double-check is advisable, of course.

=======================================================================


Scripts needing to be altered:
-----------------------------

Du.sh (line 19)
encryptedpw.sh (lines 27 and 35)
ex57.sh (comment in line 8)
ex70.sh (line 3)
ex71.sh (line 7)
ex71a.sh (line 8)
ex71b.sh (line 22)
logevents.sh (lines 31, 39-42, 47-8, 54, 56, 58, 61, 63, 67)
m4.sh (line 8: "\&amp;" --> \&)
pw.sh (comment in line 4)
read-r.sh (lines 5, 6, 20, 27)
rnd.sh (comments in lines 38, 55, 64)
rot13.sh (comment, line 6)
rot13a.sh (comment, line 5)
here-function.sh (line 16)
avoid-subshell.sh (lines 24, 25, and 33)
usb.sh (line 28)
prepend.sh (lines 18 and 28)
array-assign.bash ( comments on lines 18-19)
cdll (lines 51-53, 59, 63-69, 82-83, 85, 463, 521, 567-568, 570,
            580-586, 637, 656-658)
directory-info.sh (lines 36, 166, 273 and 353)
is-spammer.sh (comments on lines 4, 35, and 51)
bashrc (comment on line 4)
commentblock.sh (lines 4 and 23)
self-document.sh (line 14)
self-document2.sh (line 8)
dev-tcp.sh (line 14)
archiveweblogs.sh (comment in line 4)
multiple-processes.sh (line 143)
catscripts.sh (lines 12 and 21)
is_spammer.bash (comments on various lines)
iscan.sh (comment in line 10)
Hash.lib, (comments in lines lines 103 and 116: & --> &amp;)
          (comment in line 3: < --> &lt;, > --> &gt;)
hash-example.sh (comment in line 3: < --> &lt;, > --> &gt;)
quote-fetch.sh (comment in line 26: &amp; --> &)
ftpget.sh (comment in line 28)
whx.sh (comment in line 259)
pad.sh, (comments in line 6, lines 26, 27, 28, 29, 30, 33, 34).
nightly-backup.sh (comment in line 4)
tohtml.sh: lines 22-33
           lines 35-36
           lines 38-41
           line 74
           line 83
           lines 100-101
In-line code block at beginning of "I/O Redirection" chapter, line 41.
In-line code block at "mkfifo" entro in "Miscellaneous Commands" section of
"External Filters, Programs and Commands" chapter.

insertion-sort.sh:
                  line 8 (comment)
                  line 44
                  line 45
                  line 57 (two instances)

tree2.sh:
         line 38 (comment)
         line 88

petals.sh
         line 56

realname.sh
         line 26

qky.sh
         line 7
	 line 63
	 line 87
	 line 113
(The unaltered, executable script can be downloaded.
 See:  http://bash.deta.in/qky.README.html)

maned.sh
         line 6 (comment)

progress-bar.sh
         line 26
	 line 30
nim.sh
         line 27

paragraph-spac3.sh
         line 6

sw.sh
         line 5 (comment)

here-commsub.sh
         line 5

UseGetOpt.sh: line 4 (comment)
UseGetOpt-2.sh: line 11 (comment)

bash64.sh: line 4 (comment)

speech.sh: line 14


Convertion Docbook/SGML V3 -> Docbook/XML V4.5 also required lots more
renaming due to more strict xml syntax check:

allprofs.sh            (line 13)
alt-bc.sh              (lines 19, 29, 42, 6)
and-list2.sh           (lines 6, 8)
and-or.sh              (lines 6, 13, 17, 20, 55)
arith-tests.sh         (lines 30)
array-append.bash      (lines 102, 28, 52, 67, 80)
ascii2.sh              (lines 18, 37, 38, 19, 35)
ascii.sh               (lines 36, 37)
assoc-arr-test.sh      (lines 19, 26, 33, 40, 47, 54, 61, 68, 75, 89, 25, 33)
background-loop.sh     (lines 7)
bad-op.sh              (lines 10, 17, 22, 35)
base64.sh              (lines 13, 15, 40, 56, 60, 61, 62, 80, 92, 96, 97, 98, 99)
base.sh                (lines 32, 38, 71)
bashpodder.sh          (lines 62)
bashrc                 (lots of replaces)
basics-reviewed.bash   (lines 43, 685)
bingo.sh               (lines 64)
broken-link.sh         (lines 27, 38, 39)
bubble.sh              (lines 77, 80)
cannon.sh              (lines 64)
case4.sh               (lines 10, 11, 12, 39, 40, 6, 7, 8, 9)
cdll                   (lines 143, 145, 173, 247, 279, 469, 742, 744, 746)
collatz.sh             (lines 35)
commentblock.sh        (lines 52, 9)
continue-n.example     (lines 15, 17, 18, 24, 39, 12)
CopyArray.sh           (lines 7)
c-vars.sh              (lines 31, 32, 39, 41)
days-between.sh        (lines 50)
de-rpm.sh              (lines 11)
directory-info.sh      (lines 511, 540, 541)
Draw-box.sh            (lines 103, 109, 116, 21, 23, 62, 96)
encryptedpw.sh         (lines 24)
ex2.sh                 (lines 64)
ex8.sh                 (lines 9)
ex14.sh                (lines 13, 23)
ex30a.sh               (lines 45, 60)
ex30.sh                (lines 31, 47, 23)
ex43.sh                (lines 21)
ex45.sh                (lines 51, 52, 57, 58, 86, 10, 42, 46)
ex49.sh                (lines 12, 15)
ex55.sh                (lines 18)
ex57.sh                (lines 26, 7, 8, 9)
ex59.sh                (lines 26, 27)
ex64.sh                (lines 4)
ex65.sh                (lines 17)
ex68a.sh               (lines 13)
ex71a.sh               (lines 19, 4)
factr.sh               (lines 25)
fc4upd.sh              (lines 167, 81)
fifo.sh                (lines 18)
fifteen.sh             (lots of replaces)
file-comparison.sh     (lines 20, 26)
file-integrity.sh      (lines 78)
find-splitpara.sh      (lines 27, 44)
for-loopc.sh           (lines 41, 52)
ftpget.sh              (lines 108, 98)
generate-script.sh     (lines 11)
gronsfeld.bash         (lines 117, 53, 65)
hanoi2a.bash           (lines 104, 46, 61, 78, 80)
hanoi2.bash            (lines 105, 16, 48, 63, 80, 82)
ha.sh                  (lines 99)
Hash.lib               (lines 156)
horserace.sh           (lines 200, 287, 297, 298, 34, 39)
insertion-sort.bash    (lines 28, 49, 51)
iscan.sh               (lines 42)
is_spammer.bash        (lots of reaplaces)
kill-byname.sh         (lines 25, 32)
ktour.sh               (lines 177, 359, 378, 386, 407, 440, 479)
letter-count2.sh       (lines 20, 26, 31)
life.sh                (lines 106, 215, 347)
logevents.sh           (lines 31, 39, 40, 41, 61, 63, 67)
lookup.sh              (lines 25, 37, 42)
mailbox_grep.sh        (lines 25, 42, 46, 48, 51, 58, 67)
manview.sh             (lines 25)
monthlypmt.sh          (lines 54, 65)
msquare.sh             (lines 49, 51)
multiple-processes.sh  (lines 131, 19)
music.sh               (lines 21)
nightly-backup.sh      (lots of replaces)
online.sh              (lines 65)
pad.sh                 (lots of replaces)
paragraph-space.sh     (lines 17, 18)
petals.sh              (lines 160)
pid-identifier.sh      (lines 14, 33, 50, 53)
pr-asc.sh              (lines 10)
primes.sh              (lines 25, 26)
progress-bar2.sh       (lines 18)
progress-bar.sh        (lines 41)
protect_literal.sh     (lines 110, 6, 64, 92)
psub.bash              (lines 10)
q-function.sh          (lines 28)
random-between.sh      (lines 104, 157, 166, 175, 177, 187, 189, 49)
read-novar.sh          (lines 42)
read-N.sh              (lines 6)
reassign-stdout.sh     (lines 29, 6)
redir1.sh              (lines 21, 23, 25, 5, 8)
redir2a.sh             (lines 19, 20, 35, 40, 41)
redir2.sh              (lines 22)
redir3.sh              (lines 16)
redir4a.sh             (lines 24)
redir4.sh              (lines 17, 29)
redir5.sh              (lines 16)
ref-params.sh          (lines 20)
restricted.sh          (lines 20)
sam.sh                 (lines 100, 101)
soundcard-on.sh        (lines 29, 30, 77, 97)
stack.sh               (lines 19, 23)
string.sh              (lines 180, 88, 90)
strip-comments.sh      (lines 10, 56)
sw.sh                  (lots of replaces)
test-cgi.sh            (lines 60)
test-execution-time.sh (lines 10, 16, 22, 31, 40, 50, 60)
timed-input.sh         (lines 27)
tohtml.sh              (lines 7)
t-out.sh               (lines 10, 8)
tree2.sh               (lines 48, 57, 72, 76, 88, 28)
twodim.sh              (lines 72, 93)
unprotect_literal.sh   (lines 45, 6)
upperconv.sh           (lines 24, 25, 27, 39, 40)
usb.sh                 (lines 57)
userlist.sh            (lines 7)
wgetter2.bash          (lines 141, 251, 348, 376, 438)
wh-loopc.sh            (lines 22)
whx.sh                 (lines 233, 239, 240, 241, 242, 31)
wr-ps.bash             (lines 25, 61)
