User Guide small corrections (Rev #47, changes)

Showing changes from revision #46 to #47: Added | Removed | Changed

User Guide small corrections

This page is for contributors to log small subediting errors (e.g. spelling and punctuation) that they have spotted in the current draft User Guide. Please report potential corrections under the date of the User Guide version you are reading, giving PPP/ppp where
PPP is the sequential page number of the PDF, and
ppp is the ‘printed’ page number in the document,
adding some immediate context (rather than a line number).

Page cross references are only periodically regenerated, so it is not necessary to point out apparently out-of-order page numbers.

User Guide draft 29-Jan-2017

One single opening quote and many single closing quotes or apostrophes are showing as ë and í respectively (but only in paragraph headings) on pages:
41/19, 200/168, 231/199, 322/290, 397/365, 402/370 (automatically repeated in some page-top headings).

Chapter 12 ‘Managing the desktop’ appears at 99/107 which is between chapter 9 (71/49) and chapter 10 (109/77).

User Guide draft 08-May-2017

Chapter 16 (179/161) appears before chapter 15 (203/155) and shares some of the same printed page numbers (for example, both chapters have a page 161). There is a reference to page 161 on the first page of chapter 15 (203/155); make sure that this points to the first page of chapter 16.

User Guide draft 20-May-2017

500/466: The first sentence states that HForm is in the Utilities directory; it’s actually in Utilities.Caution.

User Guide draft 26-Jun-2017

275/251: The list of fonts includes “Sydney”; it’s actually “Sidney”. Note that the rendered example is also wrong.

User Guide draft 10-Sep-2017

60/36 and 141/117 both refer to “harddisc” whereas all other references say “hard disc”.

User Guide draft 23-Nov-2017

45/21: The photos in the Draw example have gone “blocky”.

152/132: This chapter hasn’t yet been formally updated, but this page is missing two instances of “with” in the phrase “it is compatible with RISC OS”.

180/160: This page suggests running the Utilities.Access.!Access+ application, however this is not part of the standard HardDisc4 distribution. Do we need a note on how to get this app (or are the instructions out of date?) – apologies if this is not actually a “small correction” :)

203/183: The third paragraph of “Selecting OmniClient’s protocols” should say “to enable the LAN Manager change its selection line to say”.

261/241: The Apps icon is cropped and is only showing the top-left corner.

User Guide draft 02-Dec-17

37/13: “Using the keyboard”, “Moving around a document”, “End”, should be “moves the caret to the end of the document”, not “to the start”.

User Guide draft 30-Dec-17

There are a few references to the Welcome Guide; does this still exist (or is it intended to)? The references are on pages 19/xix, 86/64, 108/88 and 145/127. Ed: Yes, hardware manufacturers should provide a Welcome Guide, or similarly titled booklet, describing the equipment (not the OS)

37/13 refers to “writable menu boxes” – this should be “writable menu options” so that the terminology is consistent with that formally introduced on page 52/30.

40/18: Change “pinboard” to “Pinboard” as it appears to be a proper name. This also appears on 65/43 (second paragraph of step 2) and 126/106. Ed: Style Guide refers to “the pinboard” except where referring to the task name

105/83 also refers to “menu box” instead of “menu option”. Finally, the Index on 595/579’s very last entry also has “boxes”.

113/93 says “USB port” but this should be “USB socket” for consistency with other mentions.

User Guide draft 06-Jan-18

24/xxiv – States ‘Your supplier should have the following products available’. Perhaps this should explicitly refer to ROOL e.g. “RISC OS Open Limited also supplies the following documentation:” Ed: See Tech Pubs Style Guide, we use generic term “supplier”

453/437 “Points are awarded for each complete horizontal line” is incorrect and should read, “One point is awarded for each block put into place”

453/437 “The colours of the blocks correspond to their arrangement, so with practice you
will become familiar with the colours and how that shape might be useful to your
game.” That statement is spurious. The colour of the blocks gives you no more useful information than their shape does. It should be deleted. Ed: The hint is explaining that colours equate to shapes, which they do

454/438 “Pressing the Space bar causes the currently falling block to immediately drop into
place which may not seem useful, but the time saved gives you a little extra time to
think about the next block that you must place.” should simply read “Pressing the Space bar causes the currently falling block to immediately drop into
place.” as what follows is spurious advice. No extra time is gained by dropping blocks into place early by pressing the Space bar.

40/18 I’m continuing to review the benign areas of the user guide and I’m not finding many problems. But to demonstrate I am actually reading the chapters and not just putting my name against them I’ll make a pedantic observation here: where in the “Iconise icon” section it says “stuck on the pinboard”, that should really be “stuck to the pinboard”.

30/6 “In a foreign restaurant, if you can’t actually speak the language, you
can point at the menu with your finger to tell the waiter which dish you want
(assuming that you know what the menu means!). On the computer,” The age of the original text means some anachronisms will inevitably persist but this cringe-worthy material can safely be deleted without confusing anyone. The text that follows can complete the paragraph instead: “Move the
mouse to point at your choice from the menu.”

107/87 In the paragraph starting “To open the Configuration window” add “or double click on the !Boot appplication”. Ed: Double clicking Boot is deprecated due to being non discoverable

108/88 Add to the first paragraph something like, “On some machines without a physical CMOS RAM device the settings are stored as a file external to the RISC OS environment.” Ed: The text is vague about where CMOS is stored, so CMOS stored outside of RISC OS should be transparent in use

111/91 The “Warning” is perhaps misplaced here, or even redundant. It refers to CMOS preservation which will not help if a defective component has been added to !Boot.

113/93 In the first paragraph change the last sentence, “One such example is a drive connected to a USB socket.”, to include internal ADFS hard drives. Ed: ADFS isn’t SCSI

138/118 The System application, second paragraph change “When you buy” to “When you add”

161/143 Types of filing systems, fourth item, NFS and LanManFS, NFS?? Isn’t that Sunfish & Moonfish these days? Ed: an updated Acorn NFS is the works

User Guide draft 28-Jan-18

20/xx Mouse techniques uses terms ‘Adjust’ and ‘Menu’ before they have been explained as Right and Middle buttons on 32/8.

30/6 Task Manager. Perhaps should add: This icon is always at the very right of the iconbar, but may look very different depending which computer type is being used.

203/187 OmniClient. Should ‘click Adjust on (not Select) the OmniClient icon’ be ‘click Adjust (not Select) on the OmniClient icon’ ?

202/186 alternates between *Omnimount and *OmniMount (ie. capital M). According to *Help, the latter is correct.

205/189 says “Task manager” instead of “Task Manager”.

208/190 states that the Mounts file is in Choices under “OmniClient.Mounts” when it’s actually just “Omni.Mounts”.

User Guide draft 03-Feb-18

71/50 Close icon uses ‘iconise’ in notes. Iconise icon used ‘minimise’. Should be consistent. Also noticed that Shift-Select-click iconises to the pointer, but iconise icon uses pinboard placement options.

75/55 Select a group of icons. In Notes there is a mouse with Adjust highlit. There should also be one with Select highlit, and the Notes should say something like ‘You can also Select drag a box round a group of icons to select them, or Adjust drag to add them to a selection.’

73/53 Full Info. Could add to the list at the bottom: If an application directory contains a !RunImage file, the time and date shown for the application directory is that of the !RunImage file.

80/60 Access permissions. Although there is explanation that R&r mean read, and W&w mean write, I can find no explanation that W&R are Owner, and w&r are Public. Perhaps the Detailed Access Permissions list on the previous page should replace the bullets by LWRwr?

86/66 Are 1024×768 still regarded as ‘high resolution’ and 800×600 ‘normal’? Perhaps another image at 1920×1080 should be added? May also affect the Resoluition menu on the next page.

88/68 Perhaps ‘the amount of video memory it contains’ should be changed to ‘it can use’ to move away from implying that it is a separate hardware thing … which is now rarely the case.

92/72 Select group. See 75/55 comment – same text applies for pinboard as well.

272/256 Font cache: re 4MB machine with 256kB cache. Should this reflect more modern machines? eg 512MB machine could use 4MB cache?

171/155 Types of network
“A local area network (LAN) joins computers in the same building”
“A wide area network (WAN) joins multiple local area networks”

171/155 Topology
No errors, but seems outdated. hub could be merged with switch. (telephone) modems are also practically non-existent today. Instead we have (Wifi) routers, cable and dsl modems, etc.
I think the hub/switch distinction is good. Perhaps just extend the sentence ending ‘..as the gateway too, and is often called a router.’

172/156 Protocols
optional: some info that Econet and Access is RISC OS only and that you have to use TCP/IP if you want to connect to Mac, Windows, Linux, your NAS, Router, etc.

173/157 Sharing your hard disc
“1 Switch on your computer” → is that really necessary?

174/158 Sharing a CD-ROM
“Type in the new name in the Share as box and click on OK to start sharing it.” → On the picture there is a Share button, not an OK button.

180/164 Printing over an Access network
“Choose Save choices to remember this printer set up in future.”→ not clear if I have to do this for the computer connected to the printer or the other computer (or both).

181/165 Logging on
“Before you can use a file server, you need to log on to it using the Net Logon dialogue box.”→ What or where is the Net Logon dialogue box? I figured that out, but found it confusing on the first read. Maybe just omit the “using the Net Logon dialogue box”?

103/82 Controlling tasks. In ‘… two ways to access to the command line …’ perhaps the second ‘to’ should be removed?

103/83 Choice of screen display – surely the example resolutions should be increased rather than leaving in the 1980’s?

106/88 ‘When the CMOS RAM reset…’ should be ‘When the CMOS RAM is reset…’

114/96 ‘If this is not selection then…’ should be ‘If this is not selected then…’

116/98 The values need modernising – 256kB is no longer large, and 64k/megabyte gives 32MB for a 512MB machine – which seems high! Should agree with page 272/256

124/106 Screen Setup. Should there be some mention of EDID ? Sample resolutions very 20’th century.

144/128 Naming Discs. ‘… displays; because …’ might better as ‘… displays; but because …’

163/147 Transfer of text files. ‘Most other characters displayed using the Alt key modifier may be display as a different characters when opened.’ => … displayed as different …’ ?

171/155 ‘maybe it is part of your school or office network’ These days, I suggest a home network is more common, and should be added to the list? Especially because many home users do not realise their computers can use it to communicate with each other rather than just ‘the internet’!

172/156 Addressing. Add after station number ‘, and on Ethernet networks it is called the IP address.’

196/180 Is it wise to include a list of alternative Resolver modules … when none seem to be available and even if they could be found it seems unlikely that they would run with 5.24?

207/191 Mount Flag O. Wording is very confusing. The default, without any flags set, is to automatically open when mounted. It reads as if O is the default, with no obvious way to automatically open!

231/215 ‘… you can press Print on the keyboard.’ Should common variations be included eg PrintScreen, PrtScrn & PrtSc ? I have not seen Print for decades!

233/217 Text printing. ‘uses the standard font built into the printer’ I thought many modern printers do not have a ‘text’ print ability, and all printing to them now has to be graphical?
Is a font cache of 128k still large?

User Guide draft 04-Feb-18

69/49 ‘The following table repeats those techniques and expands
on your skills with other more advanced ways to manipulate windows.’ ‘expands on your skills’ doesn’t seem right. The table expands on the aforementioned ‘techniques’ so it could be ‘expands on them’ or ‘builds on them’ etc. Or, if the reader’s skills are important, it could say ‘and enables you to expand your skills’. Also, there should be a comma between ‘other’ and ‘more advanced’.

86/66. Another picky point but you can’t really call 1024×768 ‘high resolution’ anymore.

202/186 ‘If the mount requires a password a Mount dialogue box is displayed
for you to fill in.’ A comma between ‘a password’ and ‘a Mount’ seems reasonable.

207/191 ‘The third column in the mounts file set the flags field’ Shouldn’t that be ‘sets’?