x16community/x16-user-guide

Commander X16 User Guide

x16-user-guide's Issues

New BASIC functions PRed

https://github.com/X16Community/x16-docs/pull/33/files

New BASIC keywords 2023-05-11

https://github.com/X16Community/x16-docs/pull/36/files

APPENDIX : Statements - TO & STEP (suggestion to remove individual heading and merge with *FOR*...TO...

The current pending TO section heading as a statement/command would be best removed and placed with FOR, by expanding FOR to the historic FOR...TO... heading.

Reason being TO is not an isolated statement, and must be tied to FOR (unless something has changed in X16?).
STEP does not need to be presented as part of the FOR heading, as it is an optional feature and will be covered in the description.

If this is agreed, I can update the basic_command.tex file.

Replace the cover image

The current cover image is simply a placeholder. It doesn't even show a Commander X16, but rather a TheC64Maxi emulating a VIC-20. Ideally, I'd like a photo similar to the VIC-20's User Guide cover, since that has been so heavily used for inspiration. Now that there is an official case for the X16, I think it would be appropriate to include that in the shot.

Remove any 8-Bit Productions Trademarks and IP

While this is a still an unofficial User's Guide for the Commander X16, it should not use any of the official trademarks nor intellectual property. I believe the only place this might exist is the logo and font on the cover page, but it would be good to check everywhere else as well.

Alternatively, we could instead gain permission to use these trademarks...or better yet, become the official User's Guide of the Commander X16 project.

APPENDIX : Statements - ON (suggestion to adjust example code as it's not clear if it's meant to be as is?)

Currently, code example is outputting "YUP! NOPE!" in succession (not sure if intended) -
10 INPUT X
20 ON X GOTO 10,50,50,50
30 PRINT "NOPE!"
40 GOTO 10
50 PRINT "YUP!"
60 ON X GOTO 10,30,30

I think it could be more complex (non-logical) as we pose it as a challenge to work out, with the highlighted box [\NOTE] -
10 INPUT X
20 ON X GOTO 10,30,50,80
30 PRINT "NOPE!"
40 GOTO 10
50 ON X GOTO 80,10,30,70
60 PRINT "YUP!"
70 END
80 ON X GOTO 30,10,50,60

If this is agreed, I can update the basic_command.tex file.

laundry issue

A small typo is in getting_to_know_commanderx16.tex and readme.md and the image on the project's page; it spells "SHIRT" instead of "SHIFT"

APPENDIX : Statements - THEN (suggestion to remove individual heading and merge with *IF*...THEN...

The current pending THEN section heading as a statement/command would be best removed and placed with IF, by expanding IF to the historic IF...THEN... heading.

Reason being THEN is not an isolated statement, and must be tied to IF (unless something has changed in X16?).
GOTO does not need to be presented as part of the IF heading, as it is a statement in it's own right and also an optional use within IF.

If this is agreed, I can update the basic_command.tex file.

can't build: "Metric (TFM) file or in stalled font not found."

according to instruction, installed:
texlive, texlive-collection-xetex, texlive, texlive-collection-bibtexextra, biber.
cloned the repository.
attempted to make.
Failed with this:

$ make
xelatex -halt-on-error -file-line-error -shell-escape manual.tex
This is XeTeX, Version 3.141592653-2.6-0.999993 (TeX Live 2021/Cygwin) (preloaded format=xelatex)
 \write18 enabled.
entering extended mode
(./manual.tex
LaTeX2e <2021-11-15> patch level 1
L3 programming layer <2022-02-24> (./CommodoreBlueBook.cls
Document Class: CommodoreBlueBook 2022/01/26 The Commodore Blue Book Class v1.0

(/usr/share/texmf-dist/tex/latex/base/book.cls
Document Class: book 2021/10/04 v1.4n Standard LaTeX document class
(/usr/share/texmf-dist/tex/latex/base/fleqn.clo)
(/usr/share/texmf-dist/tex/latex/base/bk11.clo
/usr/share/texmf-dist/tex/latex/base/bk11.clo:54: Font TU/lmr/m/n/10.95=[lmroma
n10-regular]:mapping=tex-text; at 10.95pt not loadable: Metric (TFM) file or in
stalled font not found.
<to be read again>
                   relax
l.54 \normalsize

No pages of output.
Transcript written on manual.log.
make: *** [Makefile:62: manual.aux] Error 1

If I understand it correctly, some font is missing,
but no font was listed in the dependencies to install.

Also, since this is hosted on the github anyway, why not publish github releases with the already generated document instead of everyone having to redundantly generate it on their own?

APPENDIX : Functions - RND (description of operation in Appendix)

I am working on the RND function section in basic_commands.tex.

It's an interesting experience (reliving the past and working out how this function actually works)... I hope it's the same on the X16, so I expect some debate about my wording. I ask that you be gentle 😅 with my first actual write up.

It does make me wonder if we have access to all the BASIC V2 "descriptions" to be able to modify and rework for all items needed? Not sure what the process is so far with other existing keywords? I guess I mean specific to X16 modifications if any?

I will try pull-request shortly on the changes after posting this.