New Advanced User Guide (NAUG) [Remastered PDF]

[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

Seventh revision (April 2023)

(1.44 MiB) Downloaded 677 times

New_Advanced_User_Guide.ssd

Updated on 28 April 2023

(69.25 KiB) Downloaded 190 times

Other remastered user guides in this series:

Advanced User Guide
BBC User Guide (Model B and B+ editions)
Master Reference Manual Parts 1 and 2
Advanced Master Reference Manual

[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!

[TobyLobster]

Excellent work, a superb remastering. I found one minor issue: Top of page 186 - "&366 Teletext output cursor character (&FF - default)" I think the default value is actually &7F (as set at &CB2E in the OS 1.2 ROM)

[dv8]

Excellent work, a superb remastering. I found one minor issue: Top of page 186 - "&366 Teletext output cursor character (&FF - default)" I think the default value is actually &7F (as set at &CB2E in the OS 1.2 ROM)

Thanks. You're right, the default value is &7F (although &FF would still represent the same block character).

I'll get it changed for the next release of the PDF.

[daveejhitchins]

Absolutely brilliant There's nothing better than being able to navigate through a book than clicking on contents entries

It's been said that there are things missing (?). How about a new thread (or this one) so people can suggest what might be added?

Dave H

[dv8]

Just uploaded another update to the PDF with more corrections.
Download link is in the opening post

Changes since revision 3 (November 2019)

• p31 (39) mnemonic summary : added effect comment to TRB and TSB
• p94 (102) TRB : added effect comment M = M AND NOT A
• p95 (103) TSB : added effect comment M = M OR A
• p102 (110) 6.1 OS calls : added hyperlinks to calls and vectors
• p103 (111) 6.2.2 Non-vectored OSWRCH : call address should be &FFCB
• p112 (120) 6.4 Filing system calls : added hyperlinks to calls and vectors
• p113 (121) 6.5.1 - 6.5.3 : renumbered sections to 6.5.2 - 6.5.4
• p116 (124) 6.6.2 OS workspace &200-&2FF : added table for Electron differences
• p138 (146) 9.4 3rd para : standard printer buffer is &40 (64) bytes long
• p144 (152) 9.7 top line : (see chapter 7) should be (see section 20.1.1)
• p154 (162) SHEILA table : added hyperlinks to relevant hardware sections
• p186 (194) 13.2.2 &366 teletext output cursor character : default &FF should be &7F
• p369 (377) 20.2.1 : Master ADC latch is at &FE18
• p370 (378) 20.2.1 : Master ADC status is at &FE18, converted value is at &FE19/A

__________

Absolutely brilliant There's nothing better than being able to navigate through a book than clicking on contents entries

Thanks Dave. I totally agree and that's why I've always put in the effort to create a bookmark panel and comprehensive hyperlinking in all my remastered PDFs.

It's been said that there are things missing (?). How about a new thread (or this one) so people can suggest what might be added?

There are undoubtedly many things missing from the NAUG but I've always felt that the gap is filled by online resources like MDFS/BeebWiki.

The remastered guides are intended to be an accurate digital copy of the original books, albeit with many error corrections, which limits the scope for adding new material. Any significant additions would need to be in a separate appendix to preserve the original page layout.

[daveejhitchins]

The remastered guides are intended to be an accurate digital copy of the original books, albeit with many error corrections, which limits the scope for adding new material. Any significant additions would need to be in a separate appendix to preserve the original page layout.

Not to worry, just a thought as recently I've been having a devils job to find out some information I needed - spread across several books and JGH's MDFS.NET.

Thanks - Dave H

[dv8]

Not to worry, just a thought as recently I've been having a devils job to find out some information I needed - spread across several books and JGH's MDFS.NET.

Out of interest, what sort of information were you trying to find?

[tricky]

I'm not always sure whether something will be in the (n)Aug or the basic user guide.
I have recently found http://www.bbcbasic.co.uk/bbcbasic.html very useful for BASIC info.

[daveejhitchins]

Out of interest, what sort of information were you trying to find?

I'm 'trying' to convert the MGC MKII !BOOT sequence from BASIC into m/c - in an attempt to reduce the start-up time. This is the biggest m/c endeavor I've undertaken and I'm very grateful for the patience of David Boddie and JGH answering a lot of questions for me (they always seem obvious, when I get the answer!). I've working across several books: User Guides and AUGs for both the Electron, Master and DFS as well as dipping into JGH's MDFS.NET. I seem to have found all the errors there ever was and sometimes just get confused! And then there's the different layouts e.g. the Master two volume Reference Guide which I find . . . Hmmm! I'll settle for 'annoying'! The other issue I have is finding all my stupid typos

I'm converting the !BOOT using ABE on BeebEm on my MacBook - Which is OK as I can stay out of the workshop so I'm on hand in case Mrs. H needs assistance (recent hip replacement). I'm now working (debugging) on an Electron with: Plus 1, AP6, AP5, BeebSCSI, ABE and MRB. Again meeting a lot hurdles - due to lack of knowledge/experience. But . . . Getting there

Dave H

[AJW]

Did you track down any of the authors ?