New Advanced User Guide (Remastered)

These forums are for community collaboration on archiving, magazine scanning etc. to avoid work duplication and agree conventions / define standards
Post Reply
User avatar
dv8
Posts: 256
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

New Advanced User Guide (Remastered)

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.

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)
Last edited by dv8 on Fri Nov 22, 2019 8:18 pm, edited 3 times in total.


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

Re: New Advanced User Guide (Remastered)

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

:shock: no words

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

Re: New Advanced User Guide (Remastered)

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..... =D> 8)

User avatar
DutchAcorn
Posts: 2140
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 6:45 pm

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

Image

User avatar
jms2
Posts: 2313
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 7: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: 2313
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 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!

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

Re: New Advanced User Guide (Remastered)

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, ...


User avatar
FourthStone
Posts: 819
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 7:53 pm

Simply amazing, thank you =D>

User avatar
vanekp
Posts: 667
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 8:27 pm

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

User avatar
dv8
Posts: 256
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

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..... =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 7: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 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 :^o

User avatar
jms2
Posts: 2313
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 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.

User avatar
Elk2019
Posts: 56
Joined: Wed Apr 03, 2019 5:25 pm
Contact:

Re: New Advanced User Guide (Remastered)

Post by Elk2019 » Tue Jun 04, 2019 11:53 am

@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: 3978
Joined: Wed Jun 20, 2012 8:09 am
Location: Essex, UK
Contact:

Re: New Advanced User Guide (Remastered)

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.

User avatar
dv8
Posts: 256
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: New Advanced User Guide (Remastered)

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)

User avatar
dv8
Posts: 256
Joined: Mon Jun 22, 2009 9: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: 2212
Joined: Tue Apr 09, 2013 11:30 pm
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: 256
Joined: Mon Jun 22, 2009 9: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: 5
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: 1417
Joined: Fri Sep 09, 2005 3: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>

Post Reply