Advanced User Guide (Remastered)

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:

Advanced User Guide (Remastered)

Post by dv8 » Mon Jun 03, 2019 3:34 pm

Here is a completely remastered PDF of The Advanced User Guide For The BBC Micro.

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 AUG 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.
There is also a disc image containing all the listings from the guide. Boot the disc or enter the command *TYPE !INDEX to see a list of programs and which section of the guide they correspond to.

Advanced_User_Guide.pdf
Fourth revision (November 2019)
(1.34 MiB) Downloaded 564 times
Advanced_User_Guide.ssd
updated on 16 March 2020
(20.25 KiB) Downloaded 80 times

Other remastered user guides in this series:

New Advanced User Guide
BBC Micro User Guide (Model B and B+ editions)
Last edited by dv8 on Mon Mar 16, 2020 7:57 pm, edited 7 times in total.


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

Re: Advanced User Guide (Remastered)

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

:shock: Amazing 8)

Lee.

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

Re: Advanced User Guide (Remastered)

Post by MartinB » Mon Jun 03, 2019 7:02 pm

What I said in the Remastered NAUG thread... =D>


User avatar
0xC0DE
Posts: 577
Joined: Tue Mar 19, 2019 7:52 pm
Location: The Netherlands
Contact:

Re: Advanced User Guide (Remastered)

Post by 0xC0DE » Mon Jun 03, 2019 7:22 pm

Fantastic, thank you so much! :D
0xC0DE
:idea: Follow me on Twitter :idea: Visit my YouTube channel featuring my demos for Acorn Electron and BBC Micro

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

Re: Advanced User Guide (Remastered)

Post by Elminster » Mon Jun 03, 2019 8:49 pm

Yikes. Downloaded...... Last one. What tome of law is next?

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

Re: Advanced User Guide (Remastered)

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

Elminster wrote:
Mon Jun 03, 2019 8:49 pm
What tome of law is next?
Well, the Master Welcome Guide and Reference Manuals are on the 'to-do' list but I need a break before starting another big project like that :)

tom_seddon
Posts: 387
Joined: Tue Aug 30, 2005 12:42 am
Contact:

Re: Advanced User Guide (Remastered)

Post by tom_seddon » Wed Jun 05, 2019 12:56 am

Nice work! Great to see the key numbers fixed, and for OSFILE to finally have the right address :) - I suspect this PDF will have a permanent home in my Acrobat recent files list...

I have found one new issue - on page 257, 10.2 section c should real "Locations &FD and &FE".

--Tom

P.S. A remastered version of the Master Reference Manual (volume 1 in particular) would be amazing!
Last edited by tom_seddon on Wed Jun 05, 2019 12:59 am, edited 1 time in total.

User avatar
Rich Talbot-Watkins
Posts: 1593
Joined: Thu Jan 13, 2005 5:20 pm
Location: Palma, Mallorca
Contact:

Re: Advanced User Guide (Remastered)

Post by Rich Talbot-Watkins » Wed Jun 05, 2019 6:44 am

tom_seddon wrote:
Wed Jun 05, 2019 12:56 am
Nice work! Great to see the key numbers fixed
Yeah, I have enduring memories of 9 and I being the wrong way round in the AUG. (Were there other problems?)

Thanks a lot for doing this, it'll be my new indispensable Beeb reference!

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Wed Jun 05, 2019 9:58 am

tom_seddon wrote:
Wed Jun 05, 2019 12:56 am
I have found one new issue - on page 257, 10.2 section c should real "Locations &FD and &FE".
Thanks for this. I've corrected the PDF but I'll leave it a week or so before re-uploading to see if any other errors are discovered.
Rich Talbot-Watkins wrote:
Wed Jun 05, 2019 6:44 am
Yeah, I have enduring memories of 9 and I being the wrong way round in the AUG. (Were there other problems?)
I don't think there were any other mistakes in that table on p142.

There were quite a few problems with the larger keycode table in the NAUG (section 14.1), mostly internal key numbers and INKEY numbers not corresponding or decimal/hex numbers not matching. Can't remember if these errors were also present in the equivalent AUG table (appendix C).

User avatar
rmbrowngr
Posts: 388
Joined: Sat Jan 13, 2018 12:46 pm
Location: Dionysos, Greece
Contact:

Re: Advanced User Guide (Remastered)

Post by rmbrowngr » Wed Jun 05, 2019 2:10 pm

Great stuff. Any thoughts on the Electron User Guide? :-k The only copies I have are of a poor scan in pdf and a tatty copy bought from eBay.
Acorn_ElectronUG.zip
(4.73 MiB) Downloaded 34 times
Richard B
Acorn Electrons issue 4 and 6, MRB, Plus 1, AP6, AP5, Pegasus 400, BeebSCSI, Gotek, Raspberry Pi, GoSDC MBE.
BBC B+ 64K (128K upgraded) with Duel OS, Raspberry Pi and Gotek.

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

Re: Advanced User Guide (Remastered)

Post by vanekp » Wed Jun 05, 2019 2:32 pm

Electron User guide https://www.retro-kit.co.uk/user/custom ... tronUG.pdf
you can download Electron advanced uses guide here http://stardot.org.uk/mirrors/www.bbcdo ... Issue2.pdf
Peter.

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Tue Jun 11, 2019 11:29 am

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

Changes since revision 1 (June 2019)
  • p54 (56) BRK instruction, B flag : added text (set in P pushed on stack)
  • p152 (154) OSBYTE &81 Read machine type : (INKEY &FF00) changed to (INKEY -256)
  • p153 (155) OSBYTE &81 Read key : added link to 'Read machine type' entry on p152
  • p257 (259) 10.2 BRK vector (c) : 'Locations &ED and &FE' should be &FD and &FE
  • p272 (274) 11.3 Page two : &297-&27B should be &297-&29B
  • p349 (351) 16.11 ROM Filing System, 3rd para from bottom : (&43 '#') should be (&23 '#')
  • p366 (368) 18.8.1 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.'

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Jul 01, 2019 9:20 am

Another update with more corrections. The new PDF is in the opening post

Changes since revision 2 (June 2019):
  • p127 (129) OSBYTE &0B / *FX 11 : default setting n=32 should be n=50
  • p215 (217) OSBYTE &D4 / *FX 212 : default value 144 (&90) addded text 'amplitude -13'
  • p216 (218) OSBYTE &D5 / *FX 213 : default value 101 (&65) should be 100 (&64)
  • p217 (219) OSBYTE &D6 / *FX 214 : default value 7 should be 6
  • p226 (228) OSBYTE &E4 / *FX 228 : default value for fn+SHIFT+CTRL, &A0 should be 0 - key has no effect
  • p246 (248) OSBYTE &FF / *FX 255 : added link to Appendix J, added description for bit 7, added timing table for 1770/1772 FDC
  • p366 (368) 18.6.3 Cursor blanking delay : 'Cursor enable signal' should be 'Cursor blanking signal'
  • p483 (485) Appx.I - link options : added * to default setting for each option
  • p484 (486) Appx.I - link options, S14 : descriptions wrong way round, should be OPEN=disable JIM, CLOSED=enable JIM; in the note 'link 16 must be CLOSED' should be 'link 15 must be CLOSED and R72 fitted'
  • p485 (487) Appx.I - link options, S15 note : 'link 15 must be CLOSED when link 17 is OPEN' should be 'link 15 must be CLOSED and R72 fitted when link 14 is OPEN'
  • p485 (487) Appx.I - link options, S16 note : 'link 16 must be CLOSED if link 14 is OPEN' should be 'link 16 must be CLOSED and R73 fitted when link 17 is OPEN'
  • p485 (487) Appx.I - link options, S17 note : 'link 15 must be CLOSED' should be 'link 16 must be CLOSED and R73 fitted'
  • p489 (491) Appx.J - keyboard links : added switch orientation diagram for type 2 keyboards

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Jul 01, 2019 9:23 am

rmbrowngr wrote:
Wed Jun 05, 2019 2:10 pm
Any thoughts on the Electron User Guide?
Coming soon... :)

soviet
Posts: 106
Joined: Tue Dec 04, 2018 10:05 pm
Location: Montevideo, Uruguay
Contact:

Re: Advanced User Guide (Remastered)

Post by soviet » Mon Jul 01, 2019 9:25 pm

Awesome work, it's gonna be very useful to my have a lot lo learn.
=D>

User avatar
AndyF
Posts: 1276
Joined: Sat Feb 23, 2008 10:16 pm
Location: Derby
Contact:

Re: Advanced User Guide (Remastered)

Post by AndyF » Mon Jul 22, 2019 8:40 pm

I concur, excellent work. :) :) :)

Thank you!
Andy

* NEW * The Jetset Willy and Manic Miner community :)

Adventure games ported across to the BBC (in progress) as soon as I can find some time!

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Fri Nov 22, 2019 8:32 pm

The PDF has been updated with some more corrections. Download link is in the opening post

Changes since revision 3 (July 2019):
  • p77 (79) LSR absolute,X : always takes 7 cycles on 6502A
  • p113 (115) OSBYTE 190 &BE : should be Read/write ADC conversion type
  • p121 (123) OSBYTE &05 (5) *FX5,2 : added hyperlink to 'OSBYTE A=3'
  • p123 (125) OSBYTE &07 (7) : added X=0 9600 baud
  • p124 (126) OSBYTE &08 (8) : added X=0 9600 baud
  • p125 (127) OSBYTE &09 (9) : duration is in vsync units not centiseconds
  • p126 (128) OSBYTE &0A (10) : duration is in vsync units not centiseconds
  • p136 (138) OSBYTE &14 (20) 3rd para from bottom : 128 (&7F) should be 127 (&7F)
  • p149 (151) OSBYTE &7E (126) : added text 'the VDU paging counter will be reset, the VDU queue will be reset, any soft key expansion will be cancelled and any sound will be terminated'
  • p153 (155) OSBYTE &81 (129) : moved Y=&FF,X=0 paragraph to bottom
  • p163 (165) OSBYTE &8B (139) entry parameters : improved formatting
  • p179 (181) OSBYTE &A0 (160) entry parameters: X contains the number of the VDU variable ; on exit: X/Y = low/high byte of variable value ; after call: removed X and Y, only C is undefined
  • p198 (200) OSBYTE &BE (190) : should be Read/write ADC conversion type
  • p228 (230) OSBYTE &E6 (230) action list : removed 'Escape cleared' ; added 'Reset VDU queue, Any current soft key expansion is cleared, Any sound being produced is terminated'
  • p249 (251) 9.5 OSWORD &3 : changed 'chapter 12' hyperlink to sec 12.10 on p291 (293)
  • p252 (254) 9.14 OSWORD &C : added hyperlink to OSWORD &B
  • p278 (280) 11.4 &364 and &365 : 'input cursor' should be 'output cursor'
  • p490 (492) Fig J.2 Keyboard Circuit Diagram : corrected keyboard rows, corrected 'I' and '9' positions

chrisn
Posts: 589
Joined: Sat Apr 19, 2014 12:31 pm
Location: UK
Contact:

Re: Advanced User Guide (Remastered)

Post by chrisn » Sun Mar 15, 2020 3:26 pm

I just found a couple of errors:

Page 400, paragraph 3: "reading" should have a capital R
Page 308, line 270: LDX &16 should be LDX #16 (to read the lightpen register)

Brilliant work, btw .. this and all the other remastered books you've done!

User avatar
RetroBob
Posts: 49
Joined: Mon Jun 26, 2017 1:00 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by RetroBob » Sun Mar 15, 2020 9:32 pm

Wow, this is incredible work, bravo.

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Mar 16, 2020 8:16 pm

chrisn wrote:
Sun Mar 15, 2020 3:26 pm
I just found a couple of errors:
Page 400, paragraph 3: "reading" should have a capital R
Page 308, line 270: LDX &16 should be LDX #16 (to read the lightpen register)
Thanks for the corrections.

I've gone through all the listings again and fixed this along with several other problems. An updated SSD image has been added to the top post.

On page 400 the lower case 'reading' is correct but the full-stop after 'high' should be a comma.

I'll get all these errors fixed in the next release of the PDF.

Thanks again.

tom_seddon
Posts: 387
Joined: Tue Aug 30, 2005 12:42 am
Contact:

Re: Advanced User Guide (Remastered)

Post by tom_seddon » Sun Jun 07, 2020 12:49 am

It's not exactly a huge problem, but the table in section 19.1.7 has a column marked "Bjt5" rather than "Bit5".

--Tom

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Sun Jun 07, 2020 12:26 pm

tom_seddon wrote:
Sun Jun 07, 2020 12:49 am
It's not exactly a huge problem, but the table in section 19.1.7 has a column marked "Bjt5" rather than "Bit5".
Thanks, this will be fixed in the next release.

All corrections are welcome, no matter how small, including OCR errors like this.

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

Re: Advanced User Guide (Remastered)

Post by tricky » Thu Jul 09, 2020 7:14 am

I love these remastered book, but my Kindle says no :(
It says that they use features that are too new.
If you have the masters in non-PDF format, would there be a chance you could export them for kindle/ebook?
If not, I haven't tried the Amazon conversion yet, not trying to upgrade my ancient Kindle.

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

Re: Advanced User Guide (Remastered)

Post by dv8 » Thu Jul 09, 2020 4:25 pm

tricky wrote:
Thu Jul 09, 2020 7:14 am
If you have the masters in non-PDF format, would there be a chance you could export them for kindle/ebook?
If not, I haven't tried the Amazon conversion yet, not trying to upgrade my ancient Kindle.
Unfortunately, it's not possible to export these guides in ebook formats.

It could be worth trying the Amazon converter, although in my experience the results are often disappointing.

While I don't fancy re-doing the whole AUG/NAUG in ebook format, I might be up for putting together a concise edition with content from selected chapters.

So, an open question to anyone reading: If I were to create a Kindle edition, what content would you find most useful?

* assembly language instruction reference
* operating system calls
* OSBYTE and OSWORD call reference
* memory map
* ROM service calls
* video CRTC / ULA registers
* VDU / PLOT code table
* keyboard ASCII / INKEY / internal code table
* anything else ?

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

Re: Advanced User Guide (Remastered)

Post by tricky » Sat Jul 11, 2020 11:51 am

I don't need it on Kindle, I just wanted to read it in the bath and my original is in the bottom of a box somewhere!

I tried Calibre, Amazon and a few others, others were poor, Calibre was a little better with Amazon the best, but still not usable where tables or diagrams were concerned.

As it is A5, the PDF would have been fine if the kindle would accept it.
Is there an option to export for earlier versions of PDF?
Is it authored in PDF, or is there another format that I could try through Amazon?

I did write a pdf2html converter, which worked quite well for RPG books (A4 mostly 2 columns), that did a pretty good job on tables, images and working out where an text wrapped around an image, but I don't fancy creating ebook files - it might be fun though and I might be able to use Amazon's author's page tool. Your manual looks easier, as there are groups of words. In the one I was converting, every character was separate so I had to workout where spaces were supposed to be and whether something was text spanning multiple columns or just columns that got close together. Unfortunately, this was while I was working away and I lost all the Java.

Post Reply

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