The Sinclair QL Forum

Thanks Norm. for keeping it alive.

I replaced the copy in QL/E with the latest release.

Two inputs for improvement:
1. Please increase the Release Version (for ages it is 4.0.1), at least when there's more changes than just typos corrected.
2. When generating the PDF, why not just generate it with a more handy filename such as "sbasic-reference-manual.pdf" and omit the "-readthedocs-io-en-latest".

I will update the version, when changes are made in future, thanks for the prompt.

I'm afraid that I have no control over the download file names, that's "Read The Docs" , not me. They generate the downloads. Sorry.


Cheers,
Norm.

Thanks, Norman.

While re-reading some chapters today (looking for SELect ON and also for DO) I have spotted some places where writing is flp1\_. Also found a place where writing is TK2\_EXT. I assume those are typos.

QLvsJAGUAR wrote: ↑Thu Jan 04, 2024 10:18 am ...I assume those are typos.

Technically, no!

They are escape characters to prevent the underscore from beginning italic text, but they shouldn't have been in the output. I shall have a look and see if I can find these, and more, and fix them all.

Cheers,
Norm.

Ok, I've submitted a build of the updated docs as version 4.0.2 which has completed successfully.

The following commands have been fixed and the escape characters before underscores in code blocks have been removed:

DIR, DO.
ENV_DEL, EW.
FTEST.
GT$.
KEY_ADD.
PARHASH, PTH_ADD.
SET_LANGUAGE.
Appendix 3.1.

I have noticed in the various code blocks that anything after a hash/pound/number character, '#', gets formatted in light blue italics. This is a problem with the code formatter and I'm not able to fix this --- at least, at present.

Enjoy.


Cheers,
Norm.