BBC Micro User Guide [Remastered PDF]

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

BBC Micro User Guide [Remastered PDF]

Post by dv8 »

Here is a completely remastered PDF of the BBC Microcomputer System User Guide.

Two editions are included: the original guide from 1982 for the BBC Model A and B, and the updated version from 1984 that also covers the B+.

I know they have already been done before but they all seem to have various issues, so I wanted to create a definitive error free edition.
  • The look and layout of the original guides is preserved.
  • All errata corrections have been applied to the text.
  • Corrected all OCR errors, incorrect page number references and any factual errors found.
  • All diagrams redrawn in vectors.
  • Extensive use of hyperlinks - click on any 'see page', 'see chapter' or BASIC keyword text to jump straight to the relevant page.
Each guide also comes with a disc image containing all the listings. Enter the command *TYPE !INDEX to see the list of programs on the disc and which page number of the guide they correspond to.

BBC_User_Guide.pdf
Fourth revision (May 2020)
(1.5 MiB) Downloaded 1347 times
BBC_User_Guide.ssd
(30 KiB) Downloaded 467 times
BBC_B+_User_Guide.pdf
Third revision (May 2020)
(2.12 MiB) Downloaded 574 times
BBC_B+_User_Guide.ssd
(29 KiB) Downloaded 382 times

Other remastered user guides in this series:

Advanced User Guide
New Advanced User Guide
Master Reference Manual Parts 1 and 2
Advanced Master Reference Manual
Last edited by dv8 on Thu Feb 11, 2021 12:34 pm, edited 7 times in total.
User avatar
DutchAcorn
Posts: 2454
Joined: Fri Mar 21, 2014 9:56 am
Location: Maarn, Netherlands
Contact:

Re: Remastered BBC B and B+ User Guides

Post by DutchAcorn »

Very impressive work! (again!) =D> =D>
Paul
User avatar
danielj
Posts: 8815
Joined: Thu Oct 02, 2008 5:51 pm
Location: Manchester
Contact:

Re: Remastered BBC B and B+ User Guides

Post by danielj »

Awesome work!

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

Re: Remastered BBC B and B+ User Guides

Post by lurkio »

Flippin' 'eck!!!!

=D> =D> =D> =D>
User avatar
leenew
Posts: 4675
Joined: Wed Jul 04, 2012 4:27 pm
Location: Doncaster, Yorkshire
Contact:

Re: Remastered BBC B and B+ User Guides

Post by leenew »

Brilliant! =D>

Lee.
User avatar
jgharston
Posts: 4545
Joined: Thu Sep 24, 2009 12:22 pm
Location: Whitby/Sheffield
Contact:

Re: Remastered BBC B and B+ User Guides

Post by jgharston »

Wonderful work. I've spotted a couple of typos (eg OSBYTE 2, X=3 should be X=2). I'll go through it in more detail when I get around to i.

Code: Select all

$ bbcbasic
PDP11 BBC BASIC IV Version 0.36
(C) Copyright J.G.Harston 1989,2005-2020
>_
User avatar
jgharston
Posts: 4545
Joined: Thu Sep 24, 2009 12:22 pm
Location: Whitby/Sheffield
Contact:

Re: Remastered BBC B and B+ User Guides

Post by jgharston »

I notice the manual perpetuates the error with file access bits, which has propagated into a lot of other documentation, and even caused several people to write their own software incorrectly. So I'll post this here so it is in public.

The file access byte at XY+14 after calling OSFILE indicates whether the object *HAS* those access settings, ***NOT*** if those access settings are absent. That is:
b0: 'R' access present - user can read the file
b1: 'W' access present - user can write to the file
b2: 'E' access present - user can execute the file if 'R' absent
b3: 'L' access present - user cannot delete, overwrite or rename the file
b4: 'r' access present - public can read the file
b5: 'w' access present - public can write to the file
b6: 'e' access present - public can execute the file if 'e' absent
b7: implementation specific. Public can never delete or rename a file they do not own, so public L is always implicitly set.

The access byte setting for the standard "WR/wr" access setting is &33, ***NOT*** &00.

DFS implements a subset of this in that only b3 is ever returned.

See also the Wiki.

Code: Select all

$ bbcbasic
PDP11 BBC BASIC IV Version 0.36
(C) Copyright J.G.Harston 1989,2005-2020
>_
User avatar
MartinB
Posts: 5456
Joined: Mon Mar 31, 2008 10:04 pm
Location: Obscurity
Contact:

Re: Remastered BBC B and B+ User Guides

Post by MartinB »

Nice one Paul, these are excellent.... =D> 8)
User avatar
rmbrowngr
Posts: 502
Joined: Sat Jan 13, 2018 12:46 pm
Location: Dionysos, Greece
Contact:

Re: BBC Micro User Guide (Remastered)

Post by rmbrowngr »

Thanks! Nice job :D
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
dv8
Posts: 358
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: BBC Micro User Guide (Remastered)

Post by dv8 »

Just posted an update to the BBC B User Guide. The new PDF is in the opening post

Changes since revision 1 (August 2017)
  • p181 (183) corrected treble and bass cleffs
  • p419 (421) Cancel VDU queue : OSBYTE &E0 (224) should be OSBYTE &DA (218)
  • p421 (423) *FX2,1 : added text 'and disables the keyboard'
  • p438 (440) Cancel VDU queue : OSBYTE &E0 (224) should be &DA (218)
  • p456 (458) corrected file attribute bit meanings
  • p511 (513) Cancel VDU queue : OSBYTE &E0 (224) should be OSBYTE &DA (218)
Changes since revision 2 (June 2019)
  • p77 (79) Cursor on/off : Re-ordered this section to make it clearer
  • p275 (277) INKEY key numbers : -103 should be , not '
  • p320 (322) PLOT numbers : added descriptions for 72-79 (horizontal filling) and 88-95 (horizontal blanking)
User avatar
lurkio
Posts: 3784
Joined: Wed Apr 10, 2013 12:30 am
Location: Doomawangara
Contact:

Re: BBC Micro User Guide (Remastered)

Post by lurkio »

dv8 wrote:
Thu Aug 29, 2019 3:11 pm
Just posted an update to the BBC B User Guide.
Many thanks! Much appreciated.

=D> =D> =D>
gob33
Posts: 93
Joined: Thu Jun 02, 2016 11:15 am
Contact:

Re: BBC Micro User Guide (Remastered)

Post by gob33 »

Some critics:
- The font size is generally too big and produces line breaks in many listings
- The alternate margin for binding has disappeared, which was convenient for those wishing to have a paper version of the manuals.
User avatar
pau1ie
Posts: 720
Joined: Thu May 10, 2012 10:48 pm
Location: Bedford
Contact:

Re: BBC Micro User Guide (Remastered)

Post by pau1ie »

gob33 wrote:
Sat Oct 05, 2019 5:12 pm
The font size is generally too big
I think the idea is to reproduce the original which this does. For exmaple, page 111 has a number of listing lines which wrap, but the page is identical to the original. These books are clearly a labour of love, and the results are excellent.
User avatar
rmbrowngr
Posts: 502
Joined: Sat Jan 13, 2018 12:46 pm
Location: Dionysos, Greece
Contact:

Re: BBC Micro User Guide (Remastered)

Post by rmbrowngr »

Just download them. Fantastic piece of work. =D>
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
dv8
Posts: 358
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by dv8 »

Updated versions of both user guides have been added to the top post.

BBC B User Guide - Changes since revision 3 (August 2019)
  • p181 (183) : renumbered octaves so the five complete octaves are numbered 1-5
  • p181 (183) : extended note names into treble stave
  • p187 (189) H parameter : only amplitude and pitch have no effect
  • p350 (352) H parameter : only amplitude and pitch are ignored
  • p427 (429) *FX20,0 imploded state : "An attempt to re-define codes between &20 and &7F will be ignored" changed to "Codes between &20 and &7F can be re-defined but will map to memory at &C00, thus overwriting what is already there"
  • p483 (485) : left/right wrong way round for HIMEM
  • p484 (486) : left/right wrong way round for LOMEM, PAGE, PTR, TIME; missing BASIC2 keywords: OPENIN(8E), OPENUP(AD), OSCLI(FF); LEFT$ should be LEFT$( and MID$ should be MID$(
BBC B+ User Guide - Changes since revision 2 (June 2019)
  • p161 (175) H parameter : only amplitude and pitch have no effect
  • p245 (259) INKEY key numbers : -103 should be , not '
  • p320 (334) H parameter : only amplitude and pitch are ignored
  • p473 (487) Minimum abbreviations : should be a page break at LEN / PTR line
  • p474 (488) : OSCLI minimum abbreviation is OS.
  • p486 (500) Graphics planning sheet 1 : corrected position of graph axis labels
User avatar
tone76
Posts: 53
Joined: Mon Feb 10, 2020 10:35 am
Location: The Colonies
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by tone76 »

Many thanks for the hours of work everyone has put into this remaster. I just had to get my own hard copy made up.. I hope nobody minds! The spiral binding seems a bit large (and possibly incorrect), but that's on me. It's nice to have a proper manual to thumb through.

IMG_20200916_134336.jpg
Acorn Electron
BBC Model B (either too many or not enough)
BBC Model B+ 128K
BBC Master 128 x 2
User avatar
lurkio
Posts: 3784
Joined: Wed Apr 10, 2013 12:30 am
Location: Doomawangara
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by lurkio »

tone76 wrote:
Wed Sep 16, 2020 5:32 am
I just had to get my own hard copy made up.. I hope nobody minds! The spiral binding seems a bit large (and possibly incorrect), but that's on me.
Could you provide some more details, please? E.g. what printer or printing service did you use? What's the correct size of spiral binding that should be used?

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

Re: BBC Micro User Guide [Remastered PDF]

Post by lurkio »

In the remastered Model B user guide, section F (“Saving a section of memory”) of chapter 35 seems to be missing the information about the “reload address” parameter (“RRRR”) of the *SAVE command, which is present in the scan of an original print edition on Archive.org.

:!:
JackB
Posts: 3
Joined: Thu Aug 19, 2021 2:01 pm
Location: Netherlands
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by JackB »

Just discovered this. Fantastic. Great work!
Acorn Atom / BBC Model B working / BBC Model B German working / BBC Model B issue 7 board without case but working.
User avatar
lovebug
Posts: 807
Joined: Sun Jan 31, 2021 5:07 pm
Location: Magrathea
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by lovebug »

great, thank you
Image Image Image
User avatar
DutchAcorn
Posts: 2454
Joined: Fri Mar 21, 2014 9:56 am
Location: Maarn, Netherlands
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by DutchAcorn »

lurkio wrote:
Mon Jun 07, 2021 11:00 am
In the remastered Model B user guide, section F (“Saving a section of memory”) of chapter 35 seems to be missing the information about the “reload address” parameter (“RRRR”) of the *SAVE command, which is present in the scan of an original print edition on Archive.org.

:!:
The version on archive.org seems to be a different (later?) version, (issue 1, published in 1984). I checked my own printed user guide, it’s identical to the remastered version for this section.

Edit: the one on archive.org is the later B+ version. It has the older cover design though. You can find the RRRR reload address in the remastered version of the B+ (1984) guide.
Paul
nicolagiacobbe
Posts: 76
Joined: Tue Jul 03, 2007 10:40 am
Location: italy
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by nicolagiacobbe »

Thanks, I really love the new schematics. Wonderful.
- Edit - I have read it in more detail now, following the need to check something on the cassette interface and the schematics are a joy to read and follow, really well done. Now I am just wondering which tool has been used to draw them and if the whole BBC model B schematic has been layout the same way.
Coeus
Posts: 2357
Joined: Mon Jul 25, 2016 12:05 pm
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by Coeus »

nicolagiacobbe wrote:
Mon Sep 20, 2021 7:23 pm
Thanks, I really love the new schematics. Wonderful.
- Edit - I have read it in more detail now, following the need to check something on the cassette interface and the schematics are a joy to read and follow, really well done. Now I am just wondering which tool has been used to draw them and if the whole BBC model B schematic has been layout the same way.
I believe the schematics in the Appendix here are as they were in the original user guide where their inclusion was to provide enough information for anyone making hardware to connect to the various interfaces.

The full circuit diagram was published, though, on a separate piece of paper included with one of the various guides, possibly the Advanced User Guide. As well as high resolution scans there are at least two re-drawn versions available. There is the Tribbeck version and a set of corrections on this forum. Then there is the Searchable BBC Micro Mainboard Schematic on this forum.
Post Reply

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