Page 1 of 1

BBC Micro User Guide [Remastered PDF]

Posted: Thu Nov 09, 2017 1:25 pm
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 161 times
BBC_User_Guide.ssd
(30 KiB) Downloaded 205 times
BBC_B+_User_Guide.pdf
Third revision (May 2020)
(2.12 MiB) Downloaded 99 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

Re: Remastered BBC B and B+ User Guides

Posted: Thu Nov 09, 2017 1:57 pm
by DutchAcorn
Very impressive work! (again!) =D> =D>

Re: Remastered BBC B and B+ User Guides

Posted: Thu Nov 09, 2017 2:12 pm
by danielj
Awesome work!

d.

Re: Remastered BBC B and B+ User Guides

Posted: Thu Nov 09, 2017 2:19 pm
by lurkio
Flippin' 'eck!!!!

=D> =D> =D> =D>

Re: Remastered BBC B and B+ User Guides

Posted: Thu Nov 09, 2017 3:17 pm
by leenew
Brilliant! =D>

Lee.

Re: Remastered BBC B and B+ User Guides

Posted: Thu Nov 09, 2017 3:50 pm
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.

Re: Remastered BBC B and B+ User Guides

Posted: Thu Nov 09, 2017 4:10 pm
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.

Re: Remastered BBC B and B+ User Guides

Posted: Fri Nov 10, 2017 9:53 am
by MartinB
Nice one Paul, these are excellent.... =D> 8)

Re: BBC Micro User Guide (Remastered)

Posted: Mon Jun 03, 2019 8:48 pm
by Elminster
Ohh. Downloaded...... Well done.

Re: BBC Micro User Guide (Remastered)

Posted: Wed Jun 05, 2019 2:03 pm
by rmbrowngr
Thanks! Nice job :D

Re: BBC Micro User Guide (Remastered)

Posted: Thu Aug 29, 2019 3:11 pm
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)

Re: BBC Micro User Guide (Remastered)

Posted: Thu Aug 29, 2019 4:08 pm
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>

Re: BBC Micro User Guide (Remastered)

Posted: Sat Oct 05, 2019 5:12 pm
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.

Re: BBC Micro User Guide (Remastered)

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

Re: BBC Micro User Guide (Remastered)

Posted: Sat Oct 05, 2019 8:20 pm
by rmbrowngr
Just download them. Fantastic piece of work. =D>

Re: BBC Micro User Guide [Remastered PDF]

Posted: Sun Jun 07, 2020 4:01 pm
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

Re: BBC Micro User Guide [Remastered PDF]

Posted: Wed Sep 16, 2020 5:32 am
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