These forums are for community collaboration on archiving, magazine scanning etc. to avoid work duplication and agree conventions / define standards
-
dv8
- Posts: 256
- Joined: Mon Jun 22, 2009 9:07 pm
-
Contact:
Post
by dv8 » Mon Jun 03, 2019 2:41 pm
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.
Other remastered user guides in this series:
Advanced User Guide
BBC User Guide (Model B and B+ editions)
Last edited by
dv8 on Fri Nov 22, 2019 8:18 pm, edited 3 times in total.
-
lurkio
- Posts: 2212
- Joined: Tue Apr 09, 2013 11:30 pm
- Location: Doomawangara
-
Contact:
Post
by lurkio » Mon Jun 03, 2019 2:59 pm
-
leenew
- Posts: 3993
- Joined: Wed Jul 04, 2012 3:27 pm
- Location: Doncaster, Yorkshire
-
Contact:
Post
by leenew » Mon Jun 03, 2019 3:08 pm

no words
-
MartinB
- Posts: 5252
- Joined: Mon Mar 31, 2008 9:04 pm
- Location: Obscurity
-
Contact:
Post
by MartinB » Mon Jun 03, 2019 6:00 pm
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
- Posts: 2140
- Joined: Fri Mar 21, 2014 9:56 am
- Location: Maarn, Netherlands
-
Contact:
Post
by DutchAcorn » Mon Jun 03, 2019 6:45 pm
Very impressive! What a beautiful conversion!

Paul

-
jms2
- Posts: 2313
- Joined: Mon Jan 08, 2007 6:38 am
- Location: Derby, UK
-
Contact:
Post
by jms2 » Mon Jun 03, 2019 7:16 pm
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
- Posts: 2313
- Joined: Mon Jan 08, 2007 6:38 am
- Location: Derby, UK
-
Contact:
Post
by jms2 » Mon Jun 03, 2019 7:17 pm
...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
- Posts: 63
- Joined: Wed Sep 27, 2017 3:57 pm
- Location: Halden, Norway
-
Contact:
Post
by mlouka » Mon Jun 03, 2019 7:37 pm
Great job -- thank you so much for taking the time to do this!
BBC Master 128, BBC Model B i7, Watford Electronics Solderless Sideways ROM board, PMS B2P-6502 2nd proc., PiTubeDirect (both internal and external), RetroClinic Multi-OS Selector, Sundby 256k RAM/ROM card, MMFS, Gotek, Music 500, ...
-
Elminster
- Posts: 3978
- Joined: Wed Jun 20, 2012 8:09 am
- Location: Essex, UK
-
Contact:
Post
by Elminster » Mon Jun 03, 2019 7:48 pm
More. Downloaded as well...... Well done.
-
FourthStone
- Posts: 819
- Joined: Thu Nov 17, 2016 2:29 am
- Location: Brisbane, Australia
-
Contact:
Post
by FourthStone » Mon Jun 03, 2019 7:53 pm
Simply amazing, thank you

-
vanekp
- Posts: 667
- Joined: Thu Nov 30, 2000 7:09 am
- Location: The Netherlands
-
Contact:
Post
by vanekp » Mon Jun 03, 2019 8:27 pm
Peter.
-
dv8
- Posts: 256
- Joined: Mon Jun 22, 2009 9:07 pm
-
Contact:
Post
by dv8 » Mon Jun 03, 2019 10:24 pm
Thanks everyone!
MartinB wrote: ↑Mon Jun 03, 2019 6:00 pm
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.
jms2 wrote: ↑Mon Jun 03, 2019 7:16 pm
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.
jms2 wrote: ↑Mon Jun 03, 2019 7:16 pm
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
- Posts: 2313
- Joined: Mon Jan 08, 2007 6:38 am
- Location: Derby, UK
-
Contact:
Post
by jms2 » Tue Jun 04, 2019 5:55 am
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
- Posts: 56
- Joined: Wed Apr 03, 2019 5:25 pm
-
Contact:
Post
by Elk2019 » Tue Jun 04, 2019 11:53 am
@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
- Posts: 3978
- Joined: Wed Jun 20, 2012 8:09 am
- Location: Essex, UK
-
Contact:
Post
by Elminster » Tue Jun 04, 2019 12:04 pm
Retroclinic produced various bound manuals. Might be worth approaching Mark to see if he would carry these ones maybe.
-
dv8
- Posts: 256
- Joined: Mon Jun 22, 2009 9:07 pm
-
Contact:
Post
by dv8 » Tue Jun 11, 2019 10:34 am
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
- Posts: 256
- Joined: Mon Jun 22, 2009 9:07 pm
-
Contact:
Post
by dv8 » Fri Nov 22, 2019 8:49 pm
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
- Posts: 2212
- Joined: Tue Apr 09, 2013 11:30 pm
- Location: Doomawangara
-
Contact:
Post
by lurkio » Fri Nov 22, 2019 9:46 pm
dv8 wrote: ↑Fri Nov 22, 2019 8:49 pm
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
- Posts: 256
- Joined: Mon Jun 22, 2009 9:07 pm
-
Contact:
Post
by dv8 » Fri Nov 22, 2019 10:57 pm
lurkio wrote: ↑Fri Nov 22, 2019 9:46 pm
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
- Posts: 5
- Joined: Tue Mar 13, 2018 2:12 pm
-
Contact:
Post
by Rocketeer » Fri Dec 06, 2019 5:35 pm
Superb piece of work. Many thanks for this!
-
billcarr2005
- Posts: 1417
- Joined: Fri Sep 09, 2005 3:01 pm
- Location: UK
-
Contact:
Post
by billcarr2005 » Sat Dec 07, 2019 2:40 pm
Seems like I missed this the first time around, great work!
