New Advanced User Guide (Remastered)

[dv8]

Here is a completely remastered PDF of the New Advanced User Guide.

A huge amount of effort has been put in to fix the errors in the original book.
This PDF should be the most accurate version of the NAUG available.

• The look and layout of the original guide has been preserved.
• A large number of error corrections have been applied to the text.
• All diagrams have been redrawn in vectors.
• There is extensive hyperlinking - click on any reference to a page, chapter or section number or on any OSBYTE/OSWORD reference to jump directly to the relevant page.
• Two new Appendices have been added at the end of the guide containing a hyperlinked list of OSBYTE and OSWORD calls in numerical order.

There is also a disc image containing all the listings. Enter the command *TYPE !INDEX to see a list of programs on the disc and which section of the guide they correspond to.

New_Advanced_User_Guide.pdf

Third revision (November 2019)

(1.39 MiB) Downloaded 50 times

New_Advanced_User_Guide.ssd

(69 KiB) Downloaded 84 times

Other remastered user guides in this series:

Advanced User Guide
BBC User Guide (Model B and B+ editions)

[lurkio]

How??!

[leenew]

no words

[MartinB]

Paul - Simply awesome! If we ran the Retro-Acorn hobby equivalent of the Oscars, you sir would sweep the opposition aside for the Lifetime Achievement & Contribution award.....

[DutchAcorn]

Very impressive! What a beautiful conversion!

[jms2]

You're the master at this - I wasn't even aware that there were any errors in the AUG!

The question now is - I was planning on bidding for a paper version, but now I'm not so sure that I want one...

[jms2]

...hang on, I've just noticed this isn't the same thread as the one I spotted earlier. You've done both books... how is that possible?!

Just incredible!

[mlouka]

Great job -- thank you so much for taking the time to do this!

[Elminster]

More. Downloaded as well...... Well done.

[FourthStone]

Simply amazing, thank you

[vanekp]

Thanks for that, greatly appreciated

[dv8]

Thanks everyone!

Paul - Simply awesome! If we ran the Retro-Acorn hobby equivalent of the Oscars, you sir would sweep the opposition aside for the Lifetime Achievement & Contribution award.....

I'm sure the same could be said about many people on here... We all contribute in our own little way and, collectively, it turns into something special.

I wasn't even aware that there were any errors in the AUG!

Really? I got the impression both books were well known for their less than stellar quality control, especially the NAUG.

The question now is - I was planning on bidding for a paper version, but now I'm not so sure that I want one...

You can't beat that musty smell of a 35 year old book... Mmmm

[jms2]

I was aware that the NAUG wasn't held in very high regard, but I assumed that this was because of its rather confusing layout rather than actual errors. The AUG on the other hand, whilst it has a lot of omissions, I hadn't heard of any specific errors in it.

I'm wondering how easy it would be to get these printed and ringbound.

[Elk2019]

@dv8 A stirling acomplishment. Thank you. This document is indispensable. I too, second the idea of a printed version but it depends on how many are interested and if it is feasible to produce a fixed number of copies at a reasonable cost.

[Elminster]

Retroclinic produced various bound manuals. Might be worth approaching Mark to see if he would carry these ones maybe.

[dv8]

Updated the PDF to fix a few issues. Download links in the opening post

Changes since revision 1 (June 2019)

• p102 (110) 6.1 OS Calls, OSASCI : '&D gives CR and LF' changed to '&D (13) gives LF,CR'
• p116 (124) 6.6.2 &200-&2FF workspace table : added hyperlinks to OSBYTE/OSWORD references
• p185 (193) 13.2.2 &356 : 2K=4 should be 1K=4
• p195 (203) 13.3.6 Cursor blanking delay : 'Cursor enable signal' should be 'Cursor blanking signal'
• p195 (203) 13.3.8 The cursor start register (R10) : '1/16th and 1/32nd of field rate' should be '16 and 32 times field rate', added text 'When bit 6=0 and bit 5=1, the cursor is disabled.', added blink bits table
• p260 (268) Hazel Allocations, *MOVE destination name pointer : &DFDB-&DFD9 should be &DFD8
• p317 (325) 17.5.6 *ROM data format, bottom paragraph : &43 ('#') should be &23 ('#')
• p428 (436) OSBYTE &81 - Read machine type : (INKEY &FF00) changed to (INKEY -256)

[dv8]

Updated the PDF with a bumper crop of corrections. It feels like this is never going to end!
As usual the download link is in the opening post

Changes since revision 2 (June 2019)

• p31 (39) 5.2 Assembler Mnemonics Summary : added hyperlinks to mnemonics
• p34 (42) 5.2 ASL absolute,X : should take 6 cycles (+1 if page crossed) on 65C02
• p35 (43) 5.2 BBR : should take 5 cycles +1 if to new page (regardless of whether branch taken)
• p36 (44) 5.2 BBS : should take 5 cycles +1 if to new page (regardless of whether branch taken) ; in the example EQUB &03 should be EQUB &FA (for branch of -6)
• p40 (48) 5.2 BIT absolute,X : should take 4 cycles (+1 if page crossed)
• p64 (72) 5.2 JMP (indirect) : should take 6 cycles on 65C02
• p69 (77) 5.2 LSR absolute,X : should take 6 cycles (+1 if page crossed) on 65C02
• p74 (82) 5.2 PHX : should take 3 cycles
• p75 (83) 5.2 PHY : should take 3 cycles
• p78 (86) 5.2 PLX : should take 4 cycles
• p79 (87) 5.2 PLY : should take 4 cycles
• p80 (88) 5.2 ROL absolute,X : should take 6 cycles (+1 if page crossed) on 65C02
• p81 (89) 5.2 ROR absolute,X : should take 6 cycles (+1 if page crossed) on 65C02
• p88 (96) 5.2 STA (zp indirect) : should take 5 cycles
• p95 (103) 5.2 TSB : Z flag set if 'A OR mem = 0' should be 'A AND mem = 0'
• p104 (112) 6.2.3 OSNEWL and 6.2.4 OSASCI : writes LF followed by CR
• p105 (113) 6.2.5 OSBYTE &02 (2) X=1 : added text 'keyboard disabled'
• p107 (115) 6.2.9 GSINIT entry parameters : moved carry flag descriptions from sec 6.2.10 GSREAD on following page
• p113 (121) 6.5.3 OSEVEN : added hyperlink to OSBYTE &0E (14)
• p114 (122) 6.6 envelope 1-4 : &800-&8FF should be &8C0-&8FF
• p114 (122) 6.6 speech buffer : &900-&9FF should be &9C0-&9FF
• p147 (155) 10.3 OSBYTE &7E (126) : added text 'any soft key expansion will be cancelled and any sound will be terminated'
• p148 (156) 10.4 OSBYTE &C8 (200) : added hyperlink to OSBYTE &7D/125
• p149 (157) 10.7 OSBYTE &E6 (230) : added hyperlink to OSBYTE &7E/*FX 126 ; added action 'Any sound being produced is terminated'
• p157 (165) 12.2 OSBYTE &6C (108) : 'accessable' should be 'accessible'
• p162 (170) 12.4 ACCCON (&FE34) X (bit 2) : changed description to 'main memory/shadow RAM at &3000-&7FFF'
• p162 (170) 12.4 ACCCON (&FE34) ITU (bit 4) : descriptions wrong way round, should be 0=external, 1=internal
• p164 (172) 12.4.3 last paragraph : ITU set=internal, clear=external
• p170 (178) 13.1.4 : added PLOT codes 0-7 to table
• p173 (181) 13.1.6 OSBYTE &B6 (182) : added hyperlink to OSBYTE &14/*FX 20
• p178 (186) 13.1.8 OSBYTE &09 (9) : duration is in vsync units not centiseconds
• p179 (187) 13.1.8 OSBYTE &0A (10) : duration is in vsync units not centiseconds
• p183 (191) 13.1.11 OSBYTE &A0 (160) entry parameters: X contains the number of the VDU variable ; on exit: X/Y = low/high byte of variable value
• p185 (193) 13.2.2 : &362=left pixel mask, &363=right pixel mask, &364/5=output cursor x/y
• p220 (228) 14.1 Master keypad table : added entry for '.' key
• p220 (228) 14.1 Start up options table : added columns for bit and switch number
• p221 (229) 14.2 OSBYTE &81 (129) : 'section 24.4.1' text now links to OSBYTE &81 (INKEY -256)
• p222 (230) 14.4 OSBYTE &7A : added hyperlink to OSBYTE &79
• p224 (232) 14.7 OSBYTE &0B (11) : default setting 32 should be 50
• p225 (233) 14.9.1 OSBYTE &04 (4) entry parameters X=1 : added ASCII codes (135 to 139)
• p242 (250) 15.3.3 OSBYTE &07 (7) : added X=0 9600 baud
• p243 (251) 15.3.4 OSBYTE &08 (8) : added X=0 9600 baud
• p244 (252) 15.3.7 OSBYTE &9C (156) : reversed bit order in table to improve clarity ; moved 'This counter' paragraph from top of following page
• p245 (253) 15.3.7 OSBYTE &9C (156) : reversed bit order in tables to improve clarity
• p246 (254) 15.3.8 OSBYTE &CB (203) : 'chapter 8' now links to OSBYTE &CB on page 132 (140)
• p246 (254) 15.3.9 OSBYTE &CC (204) : 'chapter 14' now links to OSBYTE &CC on page 231 (239)
• p247 (255) 15.3.10 OSBYTE &CD (205) : added text 'see keyboard calls, chapter 14' and hyperlink to OSBYTE &CD on page 231 (239)
• p248 (256) 15.3.12 OSBYTE &F2 (242) baud rate table : bits 0-2=transmit, bits 3-5=receive ; entry for 2400 baud was missing, values for 1200 and 300 baud were wrong
• p301 (309) 17.4.1 Reason code &12 : Y contains the filing system id not the ROM number
• p302 (310) 17.4.1 reason code &21 : &C000-&DCFF should be &C000-&DBFF
• p323 (331) 17.6.5 OSBYTE &AA/AB (170/171) : removed 'This call is implemented...' line
• p374 (382) 21.1.7 OSBYTE &D4 (212) : default value 144 added text 'amplitude -13', added explanation of value calculation
• p413 (421) 23.7 OSBYTE &6B (107) : should be X=0 external 1MHz, X=1 internal 2MHz
• p420 (428) 24.1.2 OSBYTE &D7 (215) : added hyperlink to OSBYTE &F7-F9

[lurkio]

Updated the PDF with a bumper crop of corrections. It feels like this is never going to end!

Wow! This goes above and beyond the call of duty!

Are these errors "new" or were they in the original book?

[dv8]

Are these errors "new" or were they in the original book?

There were a couple of OCR errors and a few missing hyperlinks but the majority are in the original book.

[Rocketeer]

Superb piece of work. Many thanks for this!

[billcarr2005]

Seems like I missed this the first time around, great work!