I started playing with the full text search feature of SQLite and decided the
system help library would be good source material for a project. The
transformation uncovered a few glitches in whatever tool was used to
generate the help files from the original documentation:

- Some places that create bulleted list use an 8-bit hyphen variant for the
first item and a 7-bit hyphen for the rest.

- The CRTL documentation uses superscripts to describe number values
that are powers of 2. In the help file the attribute is discarded, so 32-bit
integers range from -231 to 231 (rather than -2^31 and 2^31).

- The CRTL documentation uses the 'greater than or equal' symbol to
describe some number ranges, which gets replaced in the help file with
a NUL.

- The description for "$ HELP RTL LIB$ LIB$RENAME_FILE arguments"
mentions a qualifier for the DCL RENAME command which got wrapped
to the beginning of the line. This causes help to falsely indicate that
arguments has a qualifier.

On 2022-04-01, David Jones <osuvman50@gmail.com> wrote:
> I started playing with the full text search feature of SQLite and decided the
> system help library would be good source material for a project. The
> transformation uncovered a few glitches in whatever tool was used to
> generate the help files from the original documentation:
>

[snip]

Interesting. Have you reported them to VSI ? They probably won't do
anything quickly with them, but at least the issues will be recorded.

Simon.

--
Simon Clubley, clubley@remove_me.eisner.decus.org-Earth.UFP
Walking destinations on a map are further away than they appear.