Delete the dead Ant builds and scansql, fix the inner docs that contradict the README

[sqlparser]

Finding P4 of the 2026-08-24 first-visit evaluation: the documents a visitor reaches after clone and look around, rather than by following the first code block. Two of the seven rows were already fixed (demos/readme.md in #54, the README version claim in #52); these are the rest.

Deleted — not fixable into anything worth having

what	why
build.xml	its default target compiled src/main/java/demos against lib/ for main class demos.listGSPInfo — three references to things deleted in July, in four lines. Typing ant in the repo root ran that.
gettablecolumns/build.xml	same lib/ classpath, and <property name="gsp.version" value="2.0.2.4"/> against 4.2.6 sources
demos/scansql/	a 141-byte readme, no Java source anywhere in the tree, and a download URL whose host does not resolve — a demo directory with no demo

No markdown file mentioned any of the three, and nothing ran them. Maven and the .bat scripts are the two supported routes and both are under CI; a third that nothing exercises is worth removing rather than repairing — the same call that deleted buildJar.sh, buildJar.bat and MANIFEST.MF on 2026-07-28.

Fixed

formatsql/readme.md said java formatsql sqlfile.sql. Now the real Maven invocation, plus what /tolerant does and which checked-in sample demonstrates it. Both commands were run before being written down — the plain form on the mixed sample stops at the bad statement, so the example uses your.sql and the /tolerant example uses the sample.

gettablecolumns/readme.md — I resolved all three of its links:

URL	result
http://support.sqlparser.com/tutorials/gsp-demo-get-table-column/	NXDOMAIN
https://www.gudusoft.com/gsp_java/gettablecolumn.zip	HTTP 404
http://ftp.gudusoft.com/dl/scansql/scanSQL_trial.zip (in scansql/)	NXDOMAIN

It also gave three java -cp .;lib/*;external_lib/* commands using /h /P /u /p flags removed from the demo on 2026-07-28, against a lib/ deleted the same day. The binary section now explains what happened and points at licensed-only/; the flags are documented as gone rather than as usage.

check-stale-docs.sh grows to cover the class

• four more dead strings: .;lib/*, build.xml, and the two non-resolving hosts
• every relative markdown link must resolve, across all files including the ALLOW-listed README.md — a file may have reason to name something removed, none has reason to link at a path that is not there

The link check earned itself immediately: it rejected this very commit. A licensed-only/README.md link I wrote six directories up needed seven:

src/main/java/gudusoft/gsqlparser/demos/gettablecolumns/readme.md -> ../../../../../../licensed-only/README.md
  ^ resolves to src/licensed-only/README.md, which does not exist

Nothing else in the repository would have noticed. Self-test is now 12 cases, including that a resolving link passes, a broken one fails, and an http:// link is not treated as a file path.

The -Dexec.classpathScope sweep (second commit)

Done as well — all 20 remaining demo readmes. The root README has said since the system-scope dependencies went that the flag is unnecessary; those readmes went on telling people to pass it. Inert rather than wrong, but the same contradiction as everything else here.

Two forms needed care: the flag riding on the end of an -Dexec.args line, and the flag as the last line of a continued command, where dropping it leaves a dangling \ on the line above. Nothing ends a fenced block with a stray continuation now, and three of the rewritten commands were run verbatim.

sqlrefactor's was =runtime, not =compile — worth mentioning only as evidence nobody was reading these.

check-stale-docs.sh now treats -Dexec.classpathScope as a dead string, so it cannot come back; README.md is the one file allowed to name it, since its job is to say you don't need it. Self-test is 13 cases.

Verified

156 tests · 79 demos start · 24/24 demo cases · dlineage jar JSON+XML and hr_mini under the trial cap · stale-docs self-test 12/12, clean scan over 62 files, 63 files link-checked · licensed-only guard 3/3 · parser version consistent at 4.2.6.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UK3dBXFXqiDRYJxz1YxWCr