BBC Micro 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: 243
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

BBC Micro User Guide (Remastered)

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
Third revision (August 2019)
(1.5 MiB) Downloaded 22 times
BBC_User_Guide.ssd
(30 KiB) Downloaded 45 times
BBC_B+_User_Guide.pdf
Second revision (June 2019)
(2.12 MiB) Downloaded 67 times
BBC_B+_User_Guide.ssd
(29 KiB) Downloaded 36 times

Other remastered user guides in this series:

Advanced User Guide
New Advanced User Guide
Last edited by dv8 on Thu Aug 29, 2019 2:02 pm, edited 4 times in total.

User avatar
DutchAcorn
Posts: 2121
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: 7446
Joined: Thu Oct 02, 2008 4: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: 3936
Joined: Wed Jul 04, 2012 3: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: 3641
Joined: Thu Sep 24, 2009 11:22 am
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.25
(C) Copyright J.G.Harston 1989,2005-2015
>_

User avatar
jgharston
Posts: 3641
Joined: Thu Sep 24, 2009 11:22 am
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.25
(C) Copyright J.G.Harston 1989,2005-2015
>_

User avatar
MartinB
Posts: 5234
Joined: Mon Mar 31, 2008 9: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: 306
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 1:03 pm

Thanks! Nice job :D
Richard B
Acorn Electrons issue 4 and issue 6 with Master RAM Board, Acorn Plus 1, AP6, AP5, Pegasus 400, BeebSCSI, Gotek, Raspberry Pi 2nd Processor, GoSDC MBE with Elk2GoSDC and Cart2GoSDC.
BBC B+ 64K (128K upgraded) with Duel OS

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

Re: BBC Micro User Guide (Remastered)

Post by dv8 » Thu Aug 29, 2019 2: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: 2169
Joined: Tue Apr 09, 2013 11:30 pm
Location: Doomawangara
Contact:

Re: BBC Micro User Guide (Remastered)

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

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

=D> =D> =D>

Post Reply