doc: massive revision of capitalization in headings.

In this patch we change the convention of uncapitalized words
occurring in headings such as "Special variable *foo*".

* checkman.txr (check-var, check-func): Consolidated into
a single pattern function called check-coNP. This now
enforces capitalization, and also has a giant fall-back
clause which explicitly recognizes .coNP headings that
are not specially checked by the previous rules, after
which there is an error case, so that unclassified .coNP
headings are diagnosed.  A bug is fixed here in the handling
of Special Variable and Variable headings. The pattern
match was wrong, so these were not being properly recognized.
Without the error case at the end, a number of errors
occur in the document where the .desc is missing after a
Variable or Special Variable.

* txr.1: (.dir, .dirs): Fix capitalization of Directive
and Directives in headings generated by this macro.
Fix capitalization in numerous .coNP headings.

* stdlib/doc-syms.tl: Updated. Unfortunately, many symbols
change their hash value because it's based on the entire
heading.

1 files changed, 89 insertions, 89 deletions

diff --git a/stdlib/doc-syms.tl b/stdlib/doc-syms.tl
index a48a691a..f3d793d2 100644
--- a/stdlib/doc-syms.tl
+++ b/stdlib/doc-syms.tl
@@ -2,58 +2,58 @@
   (hash-from-pairs
     '(("!>" "N-02B10DF9")
       ("%e%" "N-03F0FA9E")
-      ("%fun%" "N-00719365")
+      ("%fun%" "N-0071935D")
       ("%pi%" "N-03F0FA9E")
       ("*" "D-0089")
-      ("*args*" "N-03DEE18A")
-      ("*args-eff*" "N-03DEE18A")
-      ("*args-full*" "N-03DEE18A")
-      ("*child-env*" "N-01BB2097")
-      ("*compile-opts*" "N-03E15FAA")
-      ("*doc-url*" "N-0003D10B")
-      ("*filters*" "N-00E6A902")
-      ("*gensym-counter*" "N-0387B1B1")
-      ("*hash-seed*" "N-0041D85A")
-      ("*listener-auto-compound-p*" "N-03717672")
-      ("*listener-greedy-eval-p*" "N-002B819C")
-      ("*listener-hist-len*" "N-007B676F")
-      ("*listener-multi-line-p*" "N-02C5CACF")
-      ("*listener-pprint-p*" "N-01E7ACFE")
-      ("*listener-sel-inclusive-p*" "N-02E4924F")
-      ("*load-hooks*" "N-02D09712")
-      ("*load-path*" "N-01D1DB58")
-      ("*load-search-dirs*" "N-004CCBF6")
-      ("*match-macro*" "N-012A473F")
-      ("*opt-level*" "N-03FDEBBC")
-      ("*package*" "N-000CBBA0")
-      ("*package-alist*" "N-00E20381")
-      ("*param-macro*" "N-03B67ED8")
-      ("*place-clobber-expander*" "N-01A2C58A")
-      ("*place-delete-expander*" "N-01A2C58A")
-      ("*place-macro*" "N-01B680E6")
-      ("*place-update-expander*" "N-01A2C58A")
-      ("*pprint-flo-format*" "N-02B252AA")
-      ("*print-base*" "N-01DD07CC")
-      ("*print-circle*" "N-01FC9977")
-      ("*print-flo-digits*" "N-00F41F6C")
-      ("*print-flo-format*" "N-02B252AA")
-      ("*print-flo-precision*" "N-02E97D03")
+      ("*args*" "N-01DEE0D6")
+      ("*args-eff*" "N-01DEE0D6")
+      ("*args-full*" "N-01DEE0D6")
+      ("*child-env*" "N-01BF8097")
+      ("*compile-opts*" "N-01E15FA2")
+      ("*doc-url*" "N-0003D5EB")
+      ("*filters*" "N-00E6ADE2")
+      ("*gensym-counter*" "N-03879831")
+      ("*hash-seed*" "N-003A785A")
+      ("*listener-auto-compound-p*" "N-03117670")
+      ("*listener-greedy-eval-p*" "N-002F619C")
+      ("*listener-hist-len*" "N-00A3676F")
+      ("*listener-multi-line-p*" "N-031F44CF")
+      ("*listener-pprint-p*" "N-006FACFE")
+      ("*listener-sel-inclusive-p*" "N-00C4924D")
+      ("*load-hooks*" "N-03129712")
+      ("*load-path*" "N-01CA7B58")
+      ("*load-search-dirs*" "N-00494BF6")
+      ("*match-macro*" "N-038A473E")
+      ("*opt-level*" "N-03F68BBC")
+      ("*package*" "N-000CD100")
+      ("*package-alist*" "N-00E1FE79")
+      ("*param-macro*" "N-02967ED8")
+      ("*place-clobber-expander*" "N-036A636C")
+      ("*place-delete-expander*" "N-036A636C")
+      ("*place-macro*" "N-009680EF")
+      ("*place-update-expander*" "N-036A636C")
+      ("*pprint-flo-format*" "N-019252AC")
+      ("*print-base*" "N-027F07CF")
+      ("*print-circle*" "N-03FC999F")
+      ("*print-flo-digits*" "N-01A19F6C")
+      ("*print-flo-format*" "N-019252AC")
+      ("*print-flo-precision*" "N-02E97F21")
       ("*print-json-format*" "N-02338B4D")
-      ("*random-state*" "N-033875AD")
-      ("*random-warmup*" "N-010348CD")
+      ("*random-state*" "N-01387580")
+      ("*random-warmup*" "N-01034EE5")
       ("*read-bad-json*" "N-01C77B65")
-      ("*read-unknown-structs*" "N-0174F337")
-      ("*rec-source-loc*" "N-014AFEA9")
-      ("*stddebug*" "N-006566FB")
-      ("*stderr*" "N-006566FB")
-      ("*stdin*" "N-006566FB")
-      ("*stdlog*" "N-00854995")
-      ("*stdnull*" "N-006566FB")
-      ("*stdout*" "N-006566FB")
-      ("*struct-clause-expander*" "N-0141A208")
-      ("*trace-output*" "N-0067A6AC")
-      ("*tree-fun-whitelist*" "N-025AB9C9")
-      ("*unhandled-hook*" "N-02B4A4FB")
+      ("*read-unknown-structs*" "N-0174EA57")
+      ("*rec-source-loc*" "N-014AFB29")
+      ("*stddebug*" "N-037B6088")
+      ("*stderr*" "N-037B6088")
+      ("*stdin*" "N-037B6088")
+      ("*stdlog*" "N-0085494F")
+      ("*stdnull*" "N-037B6088")
+      ("*stdout*" "N-037B6088")
+      ("*struct-clause-expander*" "N-013B4208")
+      ("*trace-output*" "N-0267A5E0")
+      ("*tree-fun-whitelist*" "N-00DAB9B6")
+      ("*unhandled-hook*" "N-02B4CB7B")
       ("+" "D-005A")
       ("-" "D-008C")
       ("--" "N-0234C408")
@@ -68,10 +68,10 @@
       ("/" "D-005D")
       ("//" "N-0054C409")
       ("/=" "N-003BE40C")
-      (":delegate" "N-037F664C")
-      (":key" "N-01697547")
-      (":mass-delegate" "N-000BBDEA")
-      (":match" "N-03B92C0D")
+      (":delegate" "N-0337664C")
+      (":key" "N-03517549")
+      (":mass-delegate" "N-00109DEA")
+      (":match" "N-03B92C77")
       ("<" "D-0090")
       ("<!" "N-02B10DF9")
       ("<-" "N-02B10DF9")
@@ -109,7 +109,7 @@
       ("alist-nremove" "N-000CD07F")
       ("alist-remove" "N-001A53C4")
       ("all" "D-0032")
-      ("all*" "N-00F6E2A2")
+      ("all*" "N-00FC7D82")
       ("allocate-struct" "N-03168BF2")
       ("and" "D-0094")
       ("andf" "N-01E7D2AD")
@@ -129,7 +129,7 @@
       ("arithp" "N-03DAA473")
       ("array" "N-0117BE95")
       ("arraysize" "N-002129D6")
-      ("as" "N-028B26DD")
+      ("as" "N-028B2465")
       ("ash" "D-0067")
       ("asin" "D-0058")
       ("asinh" "D-001E")
@@ -276,8 +276,8 @@
       ("caseql*" "N-02FB71A2")
       ("casequal" "N-017EB9A1")
       ("casequal*" "N-02FB71A2")
-      ("cases" "N-039458F2")
-      ("cat" "N-03336E1B")
+      ("cases" "N-0392D8F2")
+      ("cat" "N-0333761B")
       ("cat-files" "N-01249D65")
       ("cat-str" "N-00B6ACE3")
       ("cat-streams" "N-020BF082")
@@ -304,10 +304,10 @@
       ("chdir" "N-03D941C3")
       ("chmod" "N-00F941E5")
       ("chmod-rec" "N-02D8298E")
-      ("choose" "N-039458F2")
+      ("choose" "N-0392D8F2")
       ("chown" "N-003B491C")
       ("chown-rec" "N-02D8298E")
-      ("chr" "N-02D5D09D")
+      ("chr" "N-02D6509D")
       ("chr-digit" "N-01ED5020")
       ("chr-int" "N-000AEC8B")
       ("chr-isalnum" "N-01B18DF0")
@@ -459,7 +459,7 @@
       ("cxr" "N-01DA4F04")
       ("cyr" "N-01DA4F04")
       ("daemon" "N-017C3515")
-      ("data" "N-03B6EA7D")
+      ("data" "N-03B6F27D")
       ("dec" "N-03A0AABD")
       ("defer-warning" "N-001106AB")
       ("defex" "D-0015")
@@ -470,7 +470,7 @@
       ("deffi-sym" "N-02B237BB")
       ("deffi-union" "N-0040FFE6")
       ("deffi-var" "N-03C237C9")
-      ("deffilter" "N-00BDE41F")
+      ("deffilter" "N-00BDCC1F")
       ("define-accessor" "N-03C5F850")
       ("define-modify-macro" "N-006E03C4")
       ("define-option-struct" "N-0126C738")
@@ -482,7 +482,7 @@
       ("defmatch" "N-0049315A")
       ("defmeth" "N-0047C7E8")
       ("defpackage" "N-033951A2")
-      ("defparm" "N-039DD0E7")
+      ("defparm" "N-039DC8E7")
       ("defparml" "N-03F36A75")
       ("defplace" "N-00F92066")
       ("defset" "N-0157E559")
@@ -490,7 +490,7 @@
       ("defsymacro" "N-0080256D")
       ("defun" "N-00B44934")
       ("defun-match" "N-02BF0F8C")
-      ("defvar" "N-039DD0E7")
+      ("defvar" "N-039DC8E7")
       ("defvarl" "N-03F36A75")
       ("del" "D-004C")
       ("del*" "N-0166445C")
@@ -601,7 +601,7 @@
       ("emsgsize" "N-036B1BDB")
       ("emultihop" "N-036B1BDB")
       ("enametoolong" "N-036B1BDB")
-      ("end" "N-037C6608")
+      ("end" "N-031C6608")
       ("endgrent" "N-02CAC7FB")
       ("endp" "N-00C6C858")
       ("endpwent" "N-0377C43A")
@@ -642,7 +642,7 @@
       ("env-vbind" "N-03389BE3")
       ("env-vbindings" "N-0018DCDC")
       ("enxio" "N-036B1BDB")
-      ("eof" "N-0336501B")
+      ("eof" "N-0336381B")
       ("eopnotsupp" "N-036B1BDB")
       ("eoverflow" "N-036B1BDB")
       ("eownerdead" "N-036B1BDB")
@@ -759,7 +759,7 @@
       ("fill-carray" "N-00737951")
       ("fill-obj" "N-0039A1D1")
       ("fill-vec" "N-03C9A237")
-      ("filter" "N-00B50006")
+      ("filter" "N-00B4E806")
       ("filter-equal" "N-03136087")
       ("filter-string-tree" "N-00C9EEB0")
       ("finalize" "N-01230613")
@@ -828,7 +828,7 @@
       ("for*" "N-01F3471B")
       ("force" "N-0307223D")
       ("force-break" "N-03B5FB1D")
-      ("forget" "N-02A1EE04")
+      ("forget" "N-02A1F604")
       ("fork" "N-0365C3E1")
       ("format" "N-011ACA52")
       ("fourth" "N-01B0FA33")
@@ -836,7 +836,7 @@
       ("fr^" "N-031971BD")
       ("fr^$" "N-031971BD")
       ("frame" "N-0233BAE3")
-      ("freeform" "N-00334C65")
+      ("freeform" "N-00335465")
       ("from" "N-00AED1A7")
       ("from-list" "N-01FFD230")
       ("frr" "N-031971BD")
@@ -870,7 +870,7 @@
       ("func-get-form" "N-00722170")
       ("func-get-name" "N-03F222DA")
       ("functionp" "N-00F6F5F8")
-      ("fuzz" "N-03CAE17D")
+      ("fuzz" "N-03CAC97D")
       ("fw" "N-0357AE6F")
       ("gamma" "D-001A")
       ("gather" "D-0050")
@@ -1029,7 +1029,7 @@
       ("inc" "N-03A0AABD")
       ("inc-indent" "N-00F72290")
       ("inc-indent-abs" "N-00F72290")
-      ("include" "N-01A2ECA0")
+      ("include" "N-01A36CA0")
       ("indent-code" "N-00512FDD")
       ("indent-data" "N-00512FDD")
       ("indent-foff" "N-00512FDD")
@@ -1161,7 +1161,7 @@
       ("lflow" "N-0178C76B")
       ("lgamma" "D-0088")
       ("lib-version" "N-032F57D4")
-      ("line" "N-02D5D09D")
+      ("line" "N-02D6509D")
       ("link" "N-009EF0C8")
       ("list" "N-0206CE91")
       ("list*" "N-03593DE9")
@@ -1182,11 +1182,11 @@
       ("loff-t" "N-01153D9E")
       ("log" "D-005B")
       ("log-alert" "N-035D75EC")
-      ("log-auth" "N-0116F48F")
-      ("log-authpriv" "N-0116F48F")
+      ("log-auth" "N-00A40E8F")
+      ("log-authpriv" "N-00A40E8F")
       ("log-cons" "N-02371913")
       ("log-crit" "N-035D75EC")
-      ("log-daemon" "N-0116F48F")
+      ("log-daemon" "N-00A40E8F")
       ("log-debug" "N-035D75EC")
       ("log-emerg" "N-035D75EC")
       ("log-err" "N-035D75EC")
@@ -1197,7 +1197,7 @@
       ("log-odelay" "N-02371913")
       ("log-perror" "N-02371913")
       ("log-pid" "N-02371913")
-      ("log-user" "N-0116F48F")
+      ("log-user" "N-00A40E8F")
       ("log-warning" "N-035D75EC")
       ("log10" "D-0061")
       ("log1p" "D-001F")
@@ -1301,14 +1301,14 @@
       ("match-str" "N-03FF771E")
       ("match-str-tree" "N-01859E7F")
       ("max" "N-023C3643")
-      ("maybe" "N-039458F2")
+      ("maybe" "N-0392D8F2")
       ("mboundp" "N-01FBF828")
       ("md5" "N-022383E9")
       ("md5-begin" "N-025F32FD")
       ("md5-end" "N-025F32FD")
       ("md5-hash" "N-025F32FD")
       ("md5-stream" "N-02ADA1EB")
-      ("mdo" "N-028DBD1B")
+      ("mdo" "N-028DC51B")
       ("member" "N-0176FBE7")
       ("member-if" "N-0176FBE7")
       ("memp" "N-03C6CE65")
@@ -1352,8 +1352,8 @@
       ("munmap" "N-00E1BF52")
       ("n-choose-k" "N-02ACFDE6")
       ("n-perm-k" "N-02ACFDE6")
-      ("name" "N-01557906")
-      ("nand" "N-01EB4CCB")
+      ("name" "N-01558106")
+      ("nand" "N-01EB64CB")
       ("nandf" "N-00C18907")
       ("ncon" "N-022F6E60")
       ("ncon*" "N-022F6E60")
@@ -1379,7 +1379,7 @@
       ("nlink-t" "N-01153D9E")
       ("noflsh" "N-0072FF5E")
       ("none" "D-006B")
-      ("nor" "N-03662D87")
+      ("nor" "N-03662D07")
       ("norf" "N-00C18907")
       ("not" "D-0039")
       ("notf" "N-0026CE18")
@@ -1457,7 +1457,7 @@
       ("orf" "N-01E7D2AD")
       ("ors" "N-02D33A3D")
       ("oust" "N-0126D3FF")
-      ("output" "N-0159EBE7")
+      ("output" "N-0159F3E7")
       ("pack" "N-00093D01")
       ("package-alist" "N-017F684C")
       ("package-fallback-list" "N-027A535C")
@@ -1543,9 +1543,9 @@
       ("prof" "N-004C9B10")
       ("prog" "N-018A4BA9")
       ("prog*" "N-018A4BA9")
-      ("prog1" "N-03F7A8B8")
-      ("prog2" "N-03A0E48C")
-      ("progn" "N-03F7A8B8")
+      ("prog1" "N-0001A8B9")
+      ("prog2" "N-03A1648C")
+      ("progn" "N-0001A8B9")
       ("progv" "N-033405DF")
       ("promisep" "N-00C7553F")
       ("prop" "N-01C6D406")
@@ -1637,7 +1637,7 @@
       ("readlink" "N-0338B219")
       ("real-time-stream-p" "N-0121FDEB")
       ("realpath" "N-0168BEB4")
-      ("rebind" "N-019F9FB7")
+      ("rebind" "N-019F87B7")
       ("rec" "N-0003ED2C")
       ("recip" "N-01B8BAB0")
       ("record-adapter" "N-009C0AC4")
@@ -1752,7 +1752,7 @@
       ("sbit" "N-011F2878")
       ("scalb" "N-035C06D4")
       ("scalbln" "N-035C06D4")
-      ("scan" "N-03E989D0")
+      ("scan" "N-03E801D0")
       ("scan-until-match" "N-00EFD668")
       ("search" "N-015D8676")
       ("search-all" "N-01F7174D")
@@ -1870,13 +1870,13 @@
       ("size-t" "N-01B6F219")
       ("size-vec" "N-01000634")
       ("sizeof" "N-0235DCAE")
-      ("skip" "N-021FCB7C")
+      ("skip" "N-021FD37C")
       ("slet" "N-00821260")
       ("slot" "N-0326F62D")
       ("slotp" "N-00B90177")
       ("slots" "N-00E90177")
       ("slotset" "N-02657437")
-      ("sme" "N-008C6621")
+      ("sme" "N-022C6621")
       ("snsort" "N-03923640")
       ("so-acceptconn" "N-02FFF4E8")
       ("so-broadcast" "N-02FFF4E8")
@@ -2151,7 +2151,7 @@
       ("trunc1" "N-02E91F51")
       ("truncate" "N-0032FBF3")
       ("truncate-stream" "N-009F5B3F")
-      ("try" "N-0328371B")
+      ("try" "N-03279F1B")
       ("tuples" "N-00C801EF")
       ("tuples*" "N-036D928C")
       ("txr-case" "N-03813122")
@@ -2278,7 +2278,7 @@
       ("window-mapdo" "N-015AFD48")
       ("window-mappend" "N-015AFD48")
       ("wint-t" "N-01B6F219")
-      ("with" "N-03098987")
+      ("with" "N-03080187")
       ("with-clobber-expander" "N-0181ED4C")
       ("with-compilation-unit" "N-013AAB51")
       ("with-compile-opts" "N-019524EE")