Remastered BBC B and B+ User Guides

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

Remastered BBC B and B+ User Guides

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

Here we have completely remastered copies of the original User Guide for the BBC B and the updated version for 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 go 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.

AUG and NAUG coming soon!
BBC_User_Guide.zip
(1.09 MiB) Downloaded 71 times
BBC_B+_User_Guide.zip
(1.66 MiB) Downloaded 45 times

User avatar
DutchAcorn
Posts: 1946
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: 6692
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: 3747
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: 3295
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: 3295
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: 5025
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)

Post Reply