New Advanced User Guide (NAUG) [Remastered PDF]

avoid work duplication! collaborate on the archival of acorn literature!
Post Reply
User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

New Advanced User Guide (NAUG) [Remastered PDF]

Post by dv8 » Mon Jun 03, 2019 3: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.

New_Advanced_User_Guide.pdf
Fourth revision (April 2020)
(1.41 MiB) Downloaded 113 times
New_Advanced_User_Guide.ssd
(69 KiB) Downloaded 181 times

Other remastered user guides in this series:

Advanced User Guide
BBC User Guide (Model B and B+ editions)
Last edited by dv8 on Mon Apr 06, 2020 3:05 pm, edited 4 times in total.


User avatar
leenew
Posts: 4108
Joined: Wed Jul 04, 2012 4:27 pm
Location: Doncaster, Yorkshire
Contact:

Re: New Advanced User Guide (Remastered)

Post by leenew » Mon Jun 03, 2019 4:08 pm

:shock: no words

User avatar
MartinB
Posts: 5287
Joined: Mon Mar 31, 2008 10:04 pm
Location: Obscurity
Contact:

Re: New Advanced User Guide (Remastered)

Post by MartinB » Mon Jun 03, 2019 7: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..... =D> 8)

User avatar
DutchAcorn
Posts: 2217
Joined: Fri Mar 21, 2014 9:56 am
Location: Maarn, Netherlands
Contact:

Re: New Advanced User Guide (Remastered)

Post by DutchAcorn » Mon Jun 03, 2019 7:45 pm

Very impressive! What a beautiful conversion! =D> =D>
Paul

Image

User avatar
jms2
Posts: 2565
Joined: Mon Jan 08, 2007 6:38 am
Location: Derby, UK
Contact:

Re: New Advanced User Guide (Remastered)

Post by jms2 » Mon Jun 03, 2019 8:16 pm

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

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

User avatar
jms2
Posts: 2565
Joined: Mon Jan 08, 2007 6:38 am
Location: Derby, UK
Contact:

Re: New Advanced User Guide (Remastered)

Post by jms2 » Mon Jun 03, 2019 8: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!

User avatar
mlouka
Posts: 69
Joined: Wed Sep 27, 2017 4:57 pm
Location: Halden, Norway
Contact:

Re: New Advanced User Guide (Remastered)

Post by mlouka » Mon Jun 03, 2019 8: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, ...


User avatar
FourthStone
Posts: 892
Joined: Thu Nov 17, 2016 2:29 am
Location: Brisbane, Australia
Contact:

Re: New Advanced User Guide (Remastered)

Post by FourthStone » Mon Jun 03, 2019 8:53 pm

Simply amazing, thank you =D>

User avatar
vanekp
Posts: 822
Joined: Thu Nov 30, 2000 7:09 am
Location: The Netherlands
Contact:

Re: New Advanced User Guide (Remastered)

Post by vanekp » Mon Jun 03, 2019 9:27 pm

Thanks for that, greatly appreciated =D> =D> =D>
Peter.

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by dv8 » Mon Jun 03, 2019 11:24 pm

Thanks everyone!
MartinB wrote:
Mon Jun 03, 2019 7: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..... =D> 8)
:oops: 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 8:16 pm
I wasn't even aware that there were any errors in the AUG! =D>
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 8: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 :^o

User avatar
jms2
Posts: 2565
Joined: Mon Jan 08, 2007 6:38 am
Location: Derby, UK
Contact:

Re: New Advanced User Guide (Remastered)

Post by jms2 » Tue Jun 04, 2019 6: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.

User avatar
Elk2019
Posts: 63
Joined: Wed Apr 03, 2019 6:25 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by Elk2019 » Tue Jun 04, 2019 12:53 pm

@dv8 A stirling acomplishment. =D> 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.

User avatar
Elminster
Posts: 4112
Joined: Wed Jun 20, 2012 9:09 am
Location: Essex, UK
Contact:

Re: New Advanced User Guide (Remastered)

Post by Elminster » Tue Jun 04, 2019 1:04 pm

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

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by dv8 » Tue Jun 11, 2019 11: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)

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

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

User avatar
lurkio
Posts: 2678
Joined: Wed Apr 10, 2013 12:30 am
Location: Doomawangara
Contact:

Re: New Advanced User Guide (Remastered)

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!
:shock: Wow! This goes above and beyond the call of duty! =D> =D> =D>

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

:?:

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

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: 14
Joined: Tue Mar 13, 2018 2:12 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by Rocketeer » Fri Dec 06, 2019 5:35 pm

Superb piece of work. Many thanks for this!

User avatar
billcarr2005
Posts: 1516
Joined: Fri Sep 09, 2005 4:01 pm
Location: UK
Contact:

Re: New Advanced User Guide (Remastered)

Post by billcarr2005 » Sat Dec 07, 2019 2:40 pm

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

TobyLobster
Posts: 2
Joined: Sat Aug 31, 2019 7:58 am
Contact:

Re: New Advanced User Guide (Remastered)

Post by TobyLobster » Tue Mar 31, 2020 8:12 pm

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)

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by dv8 » Thu Apr 02, 2020 10:31 pm

TobyLobster wrote:
Tue Mar 31, 2020 8:12 pm
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.

User avatar
daveejhitchins
Posts: 5659
Joined: Wed Jun 13, 2012 6:23 pm
Location: Newton Aycliffe, County Durham
Contact:

Re: New Advanced User Guide (Remastered)

Post by daveejhitchins » Fri Apr 03, 2020 10:05 am

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

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 :D
Parts: UM6502CE, GAL22V10D, GAL16V8D, AS6C62256A, TC514400AZ, WD1772, R6522, TMS27C512, AT28C256
Products: ARA II, ARA III, ABR, ATI, AP6, MGC, AP5 . . .
For a price list, contact me at: Retro Hardware AT dave ej hitchins DOT plus DOT com

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by dv8 » Mon Apr 06, 2020 3:58 pm

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
__________
daveejhitchins wrote:
Fri Apr 03, 2020 10:05 am
Absolutely brilliant =D> There's nothing better than being able to navigate through a book than clicking on contents entries =D>
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.
daveejhitchins wrote:
Fri Apr 03, 2020 10:05 am
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.

User avatar
daveejhitchins
Posts: 5659
Joined: Wed Jun 13, 2012 6:23 pm
Location: Newton Aycliffe, County Durham
Contact:

Re: New Advanced User Guide (Remastered)

Post by daveejhitchins » Mon Apr 06, 2020 6:20 pm

dv8 wrote:
Mon Apr 06, 2020 3:58 pm
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 :D
Parts: UM6502CE, GAL22V10D, GAL16V8D, AS6C62256A, TC514400AZ, WD1772, R6522, TMS27C512, AT28C256
Products: ARA II, ARA III, ABR, ATI, AP6, MGC, AP5 . . .
For a price list, contact me at: Retro Hardware AT dave ej hitchins DOT plus DOT com

User avatar
dv8
Posts: 309
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by dv8 » Mon Apr 06, 2020 7:52 pm

daveejhitchins wrote:
Mon Apr 06, 2020 6:20 pm
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?

User avatar
tricky
Posts: 4359
Joined: Tue Jun 21, 2011 9:25 am
Contact:

Re: New Advanced User Guide (NAUG) [Remastered PDF]

Post by tricky » Mon Apr 06, 2020 10:44 pm

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.

User avatar
daveejhitchins
Posts: 5659
Joined: Wed Jun 13, 2012 6:23 pm
Location: Newton Aycliffe, County Durham
Contact:

Re: New Advanced User Guide (Remastered)

Post by daveejhitchins » Tue Apr 07, 2020 7:57 am

dv8 wrote:
Mon Apr 06, 2020 7:52 pm
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 :oops:

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 :mrgreen:

Dave H :D
Parts: UM6502CE, GAL22V10D, GAL16V8D, AS6C62256A, TC514400AZ, WD1772, R6522, TMS27C512, AT28C256
Products: ARA II, ARA III, ABR, ATI, AP6, MGC, AP5 . . .
For a price list, contact me at: Retro Hardware AT dave ej hitchins DOT plus DOT com

AJW
Posts: 798
Joined: Sun Feb 15, 2004 2:01 pm
Contact:

Re: New Advanced User Guide (NAUG) [Remastered PDF]

Post by AJW » Wed May 13, 2020 8:36 am

Did you track down any of the authors ?

Post Reply

Return to “scanning of books, magazines, ads and letters”