BBC Micro User Guide [Remastered PDF]

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

BBC Micro User Guide [Remastered PDF]

Post by dv8 » Thu Nov 09, 2017 1:25 pm

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 165 times
BBC_User_Guide.ssd
(30 KiB) Downloaded 205 times
BBC_B+_User_Guide.pdf
Third revision (May 2020)
(2.12 MiB) Downloaded 101 times
BBC_B+_User_Guide.ssd
(29 KiB) Downloaded 178 times

Other remastered user guides in this series:

Advanced User Guide
New Advanced User Guide
BBC Master Reference Manual Parts 1 and 2
Last edited by dv8 on Wed Sep 09, 2020 12:21 am, edited 6 times in total.

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

Re: Remastered BBC B and B+ User Guides

Post by DutchAcorn » Thu Nov 09, 2017 1:57 pm

Very impressive work! (again!) =D> =D>
Paul

Image

User avatar
danielj
Posts: 8432
Joined: Thu Oct 02, 2008 5:51 pm
Location: Manchester
Contact:

Re: Remastered BBC B and B+ User Guides

Post by danielj » Thu Nov 09, 2017 2:12 pm

Awesome work!

d.


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

Re: Remastered BBC B and B+ User Guides

Post by leenew » Thu Nov 09, 2017 3:17 pm

Brilliant! =D>

Lee.

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

Re: Remastered BBC B and B+ User Guides

Post by jgharston » Thu Nov 09, 2017 3:50 pm

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.32
(C) Copyright J.G.Harston 1989,2005-2020
>_

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

Re: Remastered BBC B and B+ User Guides

Post by jgharston » Thu Nov 09, 2017 4:10 pm

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.32
(C) Copyright J.G.Harston 1989,2005-2020
>_

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

Re: Remastered BBC B and B+ User Guides

Post by MartinB » Fri Nov 10, 2017 9:53 am

Nice one Paul, these are excellent.... =D> 8)


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

Re: BBC Micro User Guide (Remastered)

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

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: 333
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: BBC Micro User Guide (Remastered)

Post by dv8 » Thu Aug 29, 2019 3:11 pm

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: 2923
Joined: Wed Apr 10, 2013 12:30 am
Location: Doomawangara
Contact:

Re: BBC Micro User Guide (Remastered)

Post by lurkio » Thu Aug 29, 2019 4:08 pm

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: 73
Joined: Thu Jun 02, 2016 11:15 am
Contact:

Re: BBC Micro User Guide (Remastered)

Post by gob33 » Sat Oct 05, 2019 5:12 pm

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 » Sat Oct 05, 2019 6:05 pm

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: 421
Joined: Sat Jan 13, 2018 12:46 pm
Location: Dionysos, Greece
Contact:

Re: BBC Micro User Guide (Remastered)

Post by rmbrowngr » Sat Oct 05, 2019 8:20 pm

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: 333
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by dv8 » Sun Jun 07, 2020 4:01 pm

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: 46
Joined: Mon Feb 10, 2020 10:35 am
Location: The Colonies
Contact:

Re: BBC Micro User Guide [Remastered PDF]

Post by tone76 » Wed Sep 16, 2020 5:32 am

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

Post Reply

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