SBASIC / SuperBASIC Reference Manual Online

A collection of QL services and websites.
User avatar
QLvsJAGUAR
Gold Card
Posts: 473
Joined: Tue Feb 15, 2011 8:42 am
Location: Lucerne, Switzerland
Contact:

Re: SBASIC / SuperBASIC Reference Manual Online

Post by QLvsJAGUAR »

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".


QL forever!
https://www.sinclairql.net/ - Go and get THE DISTRIBUTION & QL/E!
https://www.youtube.com/QLvsJAGUAR/community - Blog
https://www.youtube.com/QLvsJAGUAR - Dedicated QL videos
Sinclair, QL, ATARI, JAGUAR, NUON, APPLE, NeXT, MiST & much more...
Videos, pictures & information
User avatar
NormanDunbar
Forum Moderator
Posts: 2304
Joined: Tue Dec 14, 2010 9:04 am
Location: Leeds, West Yorkshire, UK
Contact:

Re: SBASIC / SuperBASIC Reference Manual Online

Post by NormanDunbar »

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.


Why do they put lightning conductors on churches?
Author of Arduino Software Internals
Author of Arduino Interrupts

No longer on Twitter, find me on https://mastodon.scot/@NormanDunbar.
User avatar
QLvsJAGUAR
Gold Card
Posts: 473
Joined: Tue Feb 15, 2011 8:42 am
Location: Lucerne, Switzerland
Contact:

Re: SBASIC / SuperBASIC Reference Manual Online

Post by QLvsJAGUAR »

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.


QL forever!
https://www.sinclairql.net/ - Go and get THE DISTRIBUTION & QL/E!
https://www.youtube.com/QLvsJAGUAR/community - Blog
https://www.youtube.com/QLvsJAGUAR - Dedicated QL videos
Sinclair, QL, ATARI, JAGUAR, NUON, APPLE, NeXT, MiST & much more...
Videos, pictures & information
User avatar
NormanDunbar
Forum Moderator
Posts: 2304
Joined: Tue Dec 14, 2010 9:04 am
Location: Leeds, West Yorkshire, UK
Contact:

Re: SBASIC / SuperBASIC Reference Manual Online

Post by NormanDunbar »

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.


Why do they put lightning conductors on churches?
Author of Arduino Software Internals
Author of Arduino Interrupts

No longer on Twitter, find me on https://mastodon.scot/@NormanDunbar.
User avatar
NormanDunbar
Forum Moderator
Posts: 2304
Joined: Tue Dec 14, 2010 9:04 am
Location: Leeds, West Yorkshire, UK
Contact:

Re: SBASIC / SuperBASIC Reference Manual Online

Post by NormanDunbar »

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.


Why do they put lightning conductors on churches?
Author of Arduino Software Internals
Author of Arduino Interrupts

No longer on Twitter, find me on https://mastodon.scot/@NormanDunbar.
Post Reply