home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / apps / text_ed / scribe12 / scribe.man < prev    next >
Text File  |  1993-02-09  |  57KB  |  1,211 lines

  1.                                   SCRIBE
  2.                                   ======
  3.  
  4. A versatile text editor for the Atari ST/TT series of computers.
  5.  
  6. INTRODUCTION
  7. ------------
  8.  
  9. SCRIBE is a fast and easy-to-use text editor. It can be used for any text 
  10. editing purpose, such as preparing text for use in a word processor or 
  11. desktop publishing program, creating program source code, or modifying 
  12. auxiliary files such as DESKTOP.INF (or high score tables for games!).
  13.  
  14. Although designed to be very easy to learn, it also provides a 
  15. comprehensive set of facilities:-
  16.  
  17. * Friendly GEM window environment
  18. * Works in any screen resolution, including Overscan modes
  19. * Up to ten documents in memory at one time
  20. * Single key switching between documents
  21. * Ten separate clipboards, with editable descriptions
  22. * Extended set of block functions
  23. * Copy and move blocks between documents
  24. * Word wrapping with continuous text reflow during editing
  25. * Search and replace
  26. * 'Undo' facility
  27. * Keyboard alternatives for all menu commands
  28. * Auto recognition of documents having line-feed-only paragraph endings
  29. * Resetting of paragraphs in documents having CR/LF after every line
  30. * Document printing with headers and footers
  31. * On-line help
  32. * Optional expert mode
  33. * User defined defaults
  34. * Memory management facility for multi-tasking environment
  35. * Floppy disk formatting
  36.  
  37. ** Note: Although SCRIBE should work in any screen mode, there are 
  38. functional limitations in low resolution modes. See 'TECHNICAL NOTES' at 
  39. the end of this manual for more information.
  40.  
  41. CONVENTIONS
  42. -----------
  43.  
  44. In this manual the following conventions are used:-
  45.  
  46. Keyboard keys are described in the same way as they are labelled on the 
  47. keyboard, e.g. Return, Undo, etc.
  48.  
  49. When a key combination is required, it is given in the following form:
  50. '<Control> left-arrow' (means hold down the Control key while pressing the 
  51. left arrow key).
  52.  
  53. When a particular command can be issued by different means, such as a key 
  54. press or a drop-down menu selection, the keyboard version is given in the 
  55. main description and any alternatives are given at the end of the 
  56. description.
  57.  
  58. In the drop-down menus, the keyboard alternatives are displayed after the 
  59. command; most of these are <Control> or <Alternate> key combinations, and 
  60. these are indicated by the symbol '^' (for <Control>) or '@' (for 
  61. <Alternate>) followed by a letter or name of a key. For example, '^K' means 
  62. <Control> K.
  63.  
  64. To help you remember when to use <Control> and when to use <Alternate>, the 
  65. 'Edit', 'Block' and 'Search' drop-down menus are duplicated by <Control> 
  66. combinations, and the 'Desk', 'File', 'Print' and 'Utilities' menus by 
  67. <Alternate> combinations.
  68.  
  69. GETTING STARTED
  70. ---------------
  71.  
  72. SCRIBE can be run from any disk drive, and within any folder. The following 
  73. files should all be together, either in the same folder, or in the root 
  74. directory of the disk (i.e. not in any folder):-
  75.  
  76. SCRIBE.PRG - The SCRIBE program
  77. SCRIBE.RSC - The resource file
  78. SCRIBE.HLP - The on-line help file
  79. SCRIBE.DEF - The file of default settings for SCRIBE
  80.  
  81. The last two files are not essential; if they are absent, SCRIBE will use 
  82. its own programmed default settings, and on-line help will not be 
  83. available. There may be other files on the distribution disk, but these are 
  84. not part of SCRIBE. In particular, there is a file named README.1ST; you 
  85. should read or print this file before running SCRIBE, because it may 
  86. contain some late amendments to this instruction manual. It will also 
  87. contain details of any supplementary files which are supplied with the 
  88. program.
  89.  
  90. To run SCRIBE, double-click on the SCRIBE.PRG icon. The program will load, 
  91. and after a short time the text entry screen will be displayed. This screen 
  92. consists of a conventional GEM window, with a drop-down menu line at the 
  93. top. If you are not familiar with these features, they are explained in 
  94. your computer's instruction manual.
  95.  
  96. If you move the mouse pointer up to the menu line, you will see that 
  97. several of the menu items are displayed in a faint grey colour. This is 
  98. because the functions which they represent are not available at present, 
  99. and these items cannot be selected. For example, you cannot use any of the 
  100. block functions until a block has first been defined. As you work with 
  101. SCRIBE these functions will automatically become available as appropriate.
  102.  
  103. Under the drop-down menu is the title line of the window. At first this 
  104. contains only the name of the program, but when you save or load a 
  105. document, its name will appear in the title line.
  106.  
  107. Under the title line is the information line; this contains information on 
  108. the current state of several of the user adjustable settings of the 
  109. program, and when you change these settings the new situation will be shown 
  110. in the information line. During certain operations, other details will be 
  111. displayed in the information line, to let you know what is happening or to 
  112. tell you what to do next.
  113.  
  114. At the right hand side of the window is a scroll bar; if your text occupies 
  115. more than a full screen, the scroll bar can be used to move to a different 
  116. part of the text. You can click on the grey parts to move up or down one 
  117. screen at a time, or drag the white slider to move a greater distance. Use 
  118. of the scroll bar is described more fully later in this manual.
  119.  
  120. At the top left hand corner of the window is the 'close box'. Clicking on 
  121. this will erase the current document from memory. If there is no text in 
  122. memory, clicking on the close box will exit from SCRIBE.
  123.  
  124. There is no horizontal scroll bar on the window because SCRIBE uses 
  125. word-wrap instead.
  126.  
  127. USING SCRIBE
  128. ------------
  129.  
  130. SCRIBE is used in much the same way as a word processor - you type on the 
  131. keyboard, and the text which you type is displayed on the screen, and 
  132. simultaneously stored in the computer's memory. When you reach the end of a 
  133. screen line, any uncompleted word is automatically transferred to the start 
  134. of the next line, so ensuring that no words are split between lines. This 
  135. 'word wrapping' is automatically maintained during all editing operations.
  136.  
  137. In the following description, it is assumed that the text cursor is in its 
  138. default state, i.e. a solid block. However, as we will see later, it is 
  139. possible to change it to a vertical line; if you choose to do this, then 
  140. where the manual refers to 'under the cursor' you should take this to mean 
  141. 'to the right of the cursor'.
  142.  
  143. The editing commands of SCRIBE are as follows:-
  144.  
  145. Typing and erasing text
  146. -----------------------
  147.  
  148. Insert - pressing this key toggles the typing mode between 'Insert' and 
  149. 'Overstrike'. In 'Insert' mode, anything which you type is inserted into 
  150. the text at the cursor position, and all succeeding text moves to the right 
  151. to make room. In 'Overstrike' mode, a typed character normally just 
  152. replaces the character under the cursor; however, if the cursor is on a 
  153. paragraph end marker, the typed character will be inserted in front of the 
  154. marker. In both cases the cursor moves one place to the right after typing 
  155. the character.
  156. The current mode is displayed in the information line at the top of the 
  157. window.
  158.  
  159. Caps Lock - pressing this key toggles between 'Caps Lock on' and 'Caps Lock 
  160. off'. When Caps Lock is on, all alphabetic characters which you type are 
  161. output as capitals. Non-alphabetic characters are not affected.
  162.  
  163. Alternate - if you hold down this key while typing ON THE NUMERIC KEYPAD a 
  164. number between 1 and 255, the character whose ASCII value you typed will be 
  165. added to the text as if you typed it directly. This feature enables you to 
  166. enter characters which are not available directly from the keyboard, such 
  167. as various foreign language characters.
  168. (Note) Because the Line Feed, Form Feed and Carriage Return characters 
  169. (ASCII 10, 12 and 13) are used for special purposes in SCRIBE, you cannot 
  170. insert them using the above method. All other values can be entered and 
  171. edited.
  172.  
  173. Delete - deletes the character under the cursor; succeeding characters move 
  174. left one space. If the cursor is on a paragraph end marker, the marker is 
  175. deleted and the following paragraph is joined on the end of the current 
  176. one; however, you cannot delete the final paragraph end marker at the end 
  177. of the document. If the cursor is on a tab marker, the marker is deleted 
  178. and the text is redisplayed.
  179.  
  180. Backspace - deletes the character to the left of the cursor; succeeding 
  181. characters move left one space. If the cursor is at the start of a 
  182. paragraph, it moves back to the marker at the end of the previous 
  183. paragraph, and joins the two paragraphs together as described for 'Delete', 
  184. above.
  185.  
  186. Undo - if the 'Undo' facility is enabled, pressing the Undo key will 
  187. restore the current paragraph to the state it was in before you started to 
  188. edit it. The cursor is placed on the first character of the paragraph.
  189. This feature applies only so long as the cursor remains within the same 
  190. paragraph; each time the cursor moves to a new paragraph, any changes made 
  191. to the previous paragraph are 'fixed', and the contents of the new 
  192. paragraph are transferred to the special 'Undo' memory buffer.
  193. (Use of the Block functions 'Paste', 'Duplicate' and 'Move', and the file 
  194. 'Merge' function, will also reset the Undo buffer.)
  195. Alternative: select 'Restore paragraph' from the 'Edit' drop-down menu.
  196.  
  197. <Control> W - this deletes the current word, including any following spaces 
  198. or punctuation marks. If the cursor is on a paragraph end marker, there is 
  199. no action.
  200. Alternative: select 'Delete word' from the 'Edit' drop-down menu.
  201.  
  202. <Control> S - this deletes the current word and up to the end of the 
  203. sentence. If the cursor is on a paragraph end marker, there is no action.
  204. Alternative: select 'Delete end of sentence' from the 'Edit' drop-down 
  205. menu.
  206.  
  207. <Control> Delete - this deletes the entire screen line on which the cursor 
  208. is placed.
  209. Alternative: type <Control> Y, or select 'Delete line' from the 'Edit' 
  210. drop-down menu.
  211.  
  212. <Control> Undo - this restores a line deleted as above. If the cursor has 
  213. been moved in the meantime, the line will be restored in front of the line 
  214. on which the cursor is placed. This can be carried out repeatedly, to 
  215. duplicate a line many times.
  216. Alternative: select 'Restore line' from the 'Edit' drop-down menu.
  217.  
  218. <Control> K - this erases the current document completely from memory. If 
  219. you have not disabled warnings, a warning message is displayed before the 
  220. command is implemented.
  221. Alternative: select 'Clear current document' from the 'Edit' drop-down 
  222. menu, or click in the 'Close' box in the top left hand corner of the 
  223. window.
  224.  
  225. <Control> Q - this erases ALL documents from memory. If you have not 
  226. disabled warnings, a warning message is displayed before the command is 
  227. implemented.
  228. Alternative: select 'Clear all documents' from the 'Edit' drop-down menu.
  229.  
  230. Cursor movements
  231. ----------------
  232.  
  233. (Note concerning tabs) - Where a document includes the tab character (ASCII 
  234. value 9), SCRIBE displays this on screen as a number of spaces.  Although 
  235. these appear as ordinary spaces, you will not be able to place the cursor 
  236. on them, apart from the first one (corresponding with the position of the 
  237. tab character).
  238.  
  239. F1 to F10 - these function keys are used to jump between documents (e.g. F3 
  240. takes you directly to document number 3). Your current position in the 
  241. previous document is stored, and when you return to that document you will 
  242. be at the same position.
  243. The information line at the top of the window displays the number of the 
  244. current document.
  245. Alternative: Select 'Change document' from the 'Search' drop-down menu.
  246.  
  247. Left-arrow - moves the cursor one space left. If it is at the start of a 
  248. line, it moves to the end of the previous line.
  249.  
  250. Right-arrow - moves the cursor one place right. If it is at the end of a 
  251. line, it moves to the start of the next line.
  252.  
  253. Up-arrow - moves the cursor up one line; if it is on the top line, the text 
  254. scrolls down. If the movement would leave the cursor placed beyond the end 
  255. of the new line, it is moved back to the end of the line.
  256.  
  257. Down-arrow - moves the cursor down one line; if it is on the bottom line, 
  258. the text scrolls up. If the movement would leave the cursor placed beyond 
  259. the end of the new line, it is moved back to the end of the line.
  260.  
  261. Tab - in 'Insert' mode, a tab character (ASCII value 9) is inserted in the 
  262. text, and the text is redisplayed. Where the tab character occurs, a number 
  263. of spaces are displayed, so that the following character is on the next tab 
  264. position.
  265. In 'Overstrike' mode, the cursor moves to the next tab position, but no 
  266. characters are inserted.
  267. Tab positions are at 8-character intervals, starting with positions 1,9,17, 
  268. etc. These are the same as the tab positions used by the Desktop (and also 
  269. Neodesk) when viewing text files.
  270.  
  271. <Control> left-arrow - moves the cursor to the start of the current line.
  272.  
  273. <Control> right-arrow - moves the cursor to the end of the current line.
  274.  
  275. <Control> up-arrow - the window moves up one screen in the text (i.e. the 
  276. text scrolls down one screen), and the cursor moves to the top of the 
  277. screen.
  278. Alternative: Click on the upper grey part of the scroll bar.
  279.  
  280. <Control> down-arrow - the window moves down one screen in the text (i.e. 
  281. the text scrolls up one screen), and the cursor moves to the top of the 
  282. screen.
  283. Alternative: Click on the lower grey part of the scroll bar.
  284.  
  285. Clr/Home - the cursor moves to the top of the current screen.
  286.  
  287. <Control> Clr/Home - the cursor moves to the top of the text (i.e. the 
  288. start of the current document).
  289. Alternative: Select 'Top of text' under the 'Search' drop-down menu.
  290.  
  291. <Control> O - the cursor moves to the bottom of the current screen.
  292.  
  293. <Control> Z - the cursor moves to the bottom of the text (i.e. the end of 
  294. the current document).
  295. Alternative: Select 'Bottom of text' under the 'Search' drop-down menu.
  296.  
  297. Return - the action of this key varies according to the mode of operation:
  298. - If you are in 'Insert' mode, the action of the Return key is to split the 
  299. paragraph at the cursor position; the character under the cursor will be 
  300. the first character of a new paragraph.
  301. - In overstrike mode, the Return key merely moves the cursor to the start 
  302. of the next line. If the cursor is on the last line of the document, a new 
  303. blank paragraph is added at the end.
  304.  
  305. Click mouse in the text area - this moves the cursor directly to the 
  306. character nearest to the mouse pointer position.
  307.  
  308. In addition to the above, the other normal functions of the scroll bar are 
  309. available, as follows:
  310.  
  311. Click on the upwards-pointing arrow - the window moves up one line (i.e. 
  312. the text scrolls down one line in the window). The cursor remains in the 
  313. same position in the text, unless it was on the bottom line.
  314.  
  315. Click on the downwards-pointing arrow - the window moves down one line 
  316. (i.e. the text scrolls up one line in the window). The cursor remains in 
  317. the same position in the text, unless it was on the top line.
  318.  
  319. Drag the white bar up or down - the position of the white bar relative to 
  320. the total scroll bar indicates the position of the window within the 
  321. document (e.g. the white bar is at the top when you are at the start of the 
  322. document). Dragging the white bar to a different position moves the window 
  323. to that relative position within the document.
  324.  
  325. If you hold the left mouse button down while the pointer is on one of the 
  326. grey parts of the scroll bar, the text will repeatedly scroll in the 
  327. appropriate direction until the button is released.
  328.  
  329.  
  330. DOCUMENT PRINTING
  331. -----------------
  332.  
  333. SCRIBE is NOT a word processor, but it does provide some facilities for 
  334. printing your document. No special printer control codes are used, so it 
  335. should work with any conventional printer. Printing is fast, so this 
  336. facility could be useful for producing quick draft documents.
  337. The printing functions are found under the 'Print' drop-down menu.
  338.  
  339. Printed page layout
  340. -------------------
  341.  
  342. This procedure will probably need to be carried out only once, unless you 
  343. change the size of your printing paper or install a new printer. It should 
  344. be done first, before any other printing functions. Type <Alternate> T, or 
  345. select 'Printed page layout'.
  346.  
  347. After selecting this item a dialog box is displayed, in which you can set 
  348. the page size, margins, etc. for hardcopy printing. The values can be 
  349. changed by clicking on the up or down arrow symbols, or by typing numbers 
  350. directly into the boxes. The meanings of the items are:-
  351.  
  352. Paper length - the total length of the sheet in lines. Most printers print 
  353. 6 lines per inch, so this figure is normally the length of the sheet in 
  354. inches, multiplied by 6. Note however that some single sheet printers 
  355. cannot print right to the top or bottom of the sheet, so this figure should 
  356. represent the actual number of lines which the printer is capable of 
  357. printing. For example, the Hewlett-Packard Deskjet series of printers 
  358. normally omit the top and bottom half-inch of the sheet, so 1 inch should 
  359. be deducted from the sheet length to calculate the total number of lines.
  360.  
  361. Top margin - the number of blank lines at the top of the sheet, not 
  362. including any area which the printer cannot print on (see above). Must be 
  363. at least 3 if you want to have a header.
  364.  
  365. Bottom margin - the number of blank lines at the bottom of the sheet, not 
  366. including any area which the printer cannot print on (see above). Must be 
  367. at least 3 if you want to have a footer.
  368.  
  369. Lines per page - the number of actual lines of text per page (automatically 
  370. calculated from the above 3 values).
  371.  
  372. Left margin - the number of character spaces from the left of the sheet to 
  373. the left edge of the text.
  374.  
  375. Right margin - the number of character spaces from the left of the sheet to 
  376. the right edge of the text
  377.  
  378. Pause after page - Click on 'Yes' if your printer requires single sheets of 
  379. paper to be fed in one at a time, otherwise click on 'No'.
  380.  
  381. Make your choices as above, then click on one of the last three buttons:-
  382.  
  383. 'Save & Use' implements your choices, and also saves them to the SCRIBE.DEF 
  384. file, so that they become the defaults when you next run SCRIBE. This also 
  385. saves the items in the 'User preferences' dialog (described under 
  386. 'MISCELLANEOUS FUNCTIONS').
  387.  
  388. 'Use' implements your choices for the current session only.
  389.  
  390. 'Cancel' restores the previous settings.
  391.  
  392. Headers and footers
  393. -------------------
  394. Select this item if you want each printed page to carry a header and/or a 
  395. footer. Type <Alternate> H, or select 'Headers and footers'. A dialog box 
  396. is displayed; fill it in as follows:
  397.  
  398. Header - type a line of text of up to 40 characters, which you want to be 
  399. printed at the top of each page.
  400.  
  401. Footer - type a line of text of up to 40 characters, which you want to be 
  402. printed at the bottom of each page.
  403.  
  404. Header/Footer on first page - click on 'Yes' if you want the header and 
  405. footer to be printed on the first page, or 'No' if not.
  406.  
  407. Finally click on 'OK' to accept your choices, or 'Cancel' to restore the 
  408. previous contents of the dialog box. The information is saved with the 
  409. document when you save it in SCRIBE format.
  410.  
  411. If you type a '#' character in either the header or the footer line, this 
  412. will be interpreted at printing time as the current page number. Thus,  
  413. 'Page #' will be successively printed as 'Page 1', Page 2', etc.
  414.  
  415. Headers and footers are centred on the line, and are separated from the top 
  416. and bottom of the main text by two blank lines. Therefore the top and 
  417. bottom margins must have values of at least 3, otherwise the headers and 
  418. footers will not be printed.
  419.  
  420. Insert page breaks
  421. ------------------
  422.  
  423. This function enables you to select the points in the text at which page 
  424. breaks will occur. It is not essential to do this; if you do not do so, 
  425. SCRIBE will print the maximum number of lines on each page, so that page 
  426. breaks may occur at inconvenient points in the text. Type <Alternate> I, or 
  427. select 'Insert page breaks'.
  428.  
  429. After selecting this item, you are first presented with an alert box which 
  430. asks if you want already installed page breaks to be deleted first. If you 
  431. click on 'Yes' all page breaks will be removed. If you click on 'No', the 
  432. procedure will take account of any page breaks which it finds, and only add 
  433. such others as are required for correct pagination.
  434.  
  435. The procedure now scans the text, counting the lines according to the 
  436. values set in the 'Printed page layout' dialog. It stops at each point 
  437. where a page break is required, and displays a screen of text with one line 
  438. inverted (i.e. white characters on a black background). The inverted line 
  439. is the last position at which a new page must start.
  440.  
  441. You can now use the up and down cursor keys to select an earlier line for 
  442. the page break to be set at. You will not be able to move below the line 
  443. which was originally inverted, because this would result in a page which is 
  444. too long. When you have chosen the line at which you want the page break, 
  445. press Return to set it, and the procedure moves on to the next break 
  446. position. The information line at the top of the window gives a brief 
  447. reminder of what you have to do.
  448.  
  449. Page breaks can be set on any line during this procedure. If your chosen 
  450. line is not the first line of a paragraph, SCRIBE will break the paragraph 
  451. at the start of the line before setting the page break. When all the 
  452. required page breaks have been set, the start of the document is 
  453. redisplayed. You can abort the process before it is completed by pressing 
  454. Esc.
  455.  
  456. Page breaks are displayed in the text as a row of '=' signs. A page break 
  457. can be manually deleted by placing the cursor on it and pressing Delete. 
  458. The cursor can only be placed on the first character of a page break line.
  459.  
  460. When the document is saved in SCRIBE format, the page break positions are 
  461. also saved.
  462.  
  463. (Note) If the page layout settings are such that the printed lines would be 
  464. longer than the lines on screen, the displayed lines will be cropped to fit 
  465. within the window during the above procedure. The beginnings of lines will 
  466. be correctly displayed as they would be printed, but the ends of long lines 
  467. will be hidden.
  468.  
  469. Single page break
  470. -----------------
  471.  
  472. In addition to the automated procedure described above, individual page 
  473. breaks can be set manually. You may want to do this first of all, to define 
  474. points at which you particularly want page breaks to occur, such as main 
  475. headings.
  476.  
  477. Type <Alternate> G, or select 'Single page break'. A page break will be set 
  478. at the start of the current paragraph. If for some reason you particularly 
  479. want a page break in the middle of a paragraph (?) you must break the 
  480. paragraph at this point first: place the cursor where you want the page 
  481. break to occur, then press Return (make sure that you are in 'Insert' mode 
  482. first). Then type <Alternate> G to set the page break.
  483.  
  484. Printing a document
  485. -------------------
  486.  
  487. Type <Alternate> P, or select 'Print document'. After a short reminder to 
  488. make sure that the printer is ready, the entire document is printed. 
  489. Printing can be aborted by pressing any key; there may be a short delay 
  490. before this takes effect. If your printer has a large buffer, or you are 
  491. using a print spooler, it will be some time before printing ceases. However 
  492. you can immediately continue editing the document.
  493.  
  494. Printing a block
  495. ----------------
  496.  
  497. This function will print a marked block of text. Type <Alternate> B, or 
  498. select 'Print block'. Any page breaks inside the block will be used 
  499. normally, so you may need to consider if these are in appropriate positions 
  500. in the block. If you need to set the page breaks at particular points, it 
  501. is probably easiest to copy the block to an empty document slot and work 
  502. with this. In this way, the pagination of the main document does not have 
  503. to be changed.
  504.  
  505. WORKING WITH BLOCKS
  506. -------------------
  507.  
  508. Blocks are marked sections of text which can be copied and moved around in 
  509. various ways. Only one block can be marked at any one time. When a block is 
  510. marked it is displayed in inverted form (i.e. white letters on a black 
  511. background). There is no limit to the size of a block - it can be the 
  512. entire document if you wish.
  513.  
  514. The commands for manipulating blocks are all to be found under the 'Block' 
  515. drop-down menu. Some of these commands make use of a reserved area of 
  516. memory called the Clipboard Area. This area contains ten independent 
  517. clipboards, which can be copied anywhere in the text, saved to disk, or 
  518. carried over to a different document. Marked blocks can be freely copied or 
  519. moved between different documents in memory.
  520.  
  521. There are two different modes of operation for using the clipboards, called 
  522. 'Auto' and 'Manual' modes: if you copy a block of text to the clipboard in 
  523. 'Auto' mode, SCRIBE searches for the first unused clipboard, and copies the 
  524. text to this; if all ten clipboards are in use, an error message is 
  525. displayed. If on the other hand you are using 'Manual' mode, the text is 
  526. copied to whichever clipboard is currently active, replacing any text which 
  527. is already there. If warnings are enabled, a warning will be displayed 
  528. before any clipboard text is overwritten.
  529.  
  530. The setting of 'Auto' or 'Manual' mode is described later, under 
  531. 'MISCELLANEOUS FUNCTIONS'.
  532.  
  533. A block can be marked in two ways, as follows. When a new block is marked, 
  534. any previously marked block is unmarked:
  535.  
  536. (a) Position the cursor where you want the block to start, and type 
  537. <Control> B or select 'Mark block start/end'. Now position the cursor where 
  538. you want the block to end, and type <Control> B or select 'Mark block 
  539. start/end' again. The block is now marked.
  540.  
  541. (b) Position the mouse pointer where you want the block to start, and press 
  542. the left mouse button. While holding down the left button, drag the mouse 
  543. pointer downwards to where you want the block to end, and release the 
  544. button. The block is now marked. If the mouse pointer is dragged to the top 
  545. or bottom of the window during this operation, the text will scroll in the 
  546. appropriate direction. As the pointer is dragged, the area of text which 
  547. has been selected is progressively displayed inverted.
  548.  
  549. The commands to manipulate blocks are as follows:-
  550.  
  551. Copy to clipboard (<Control> C) - the block is copied to one of the 
  552. clipboards, depending on the mode ('Auto' or 'Manual'). If in 'Auto' mode, 
  553. the new clipboard becomes the currently active one, and this is indicated 
  554. in the information line at the top of the window. The block is not deleted 
  555. from the main text.
  556.  
  557. Cut to clipboard (<Control> T) - the block is copied to one of the 
  558. clipboards as above, and the block is deleted from the main text.
  559.  
  560. Add to clipboard (<Control> A) - the block is copied to the currently 
  561. active clipboard, appending it to any text which is already there. The 
  562. block is not deleted from the main text.
  563.  
  564. Paste from clipboard (<Control> P) - the total contents of the currently 
  565. active clipboard are inserted into the main text at the cursor position; 
  566. the succeeding text is moved up to make room for it.
  567.  
  568. Duplicate block (<Control> D) - the block is copied to the current cursor 
  569. position without deleting the original. The block does not have to be in 
  570. the same document as the cursor. This operation does not affect the 
  571. contents of any of the clipboards.
  572.  
  573. Move block (<Control> M) - the block is copied to the current cursor 
  574. position, then the original is deleted. The block does not have to be in 
  575. the same document as the cursor. This operation does not affect the 
  576. contents of any of the clipboards.
  577.  
  578. Erase block (<Control> R) - the block is deleted from the main text.
  579.  
  580. Unmark block (<Control> U) - the block marking is removed.
  581.  
  582. Select clipboard (<Control> L) - a dialog box is displayed, in which you 
  583. can make any one of the ten clipboards current by clicking on the 
  584. appropriate button. When a block of text is copied to a clipboard, the 
  585. first 30 characters are also copied to this dialog box, alongside the 
  586. corresponding button. If you wish, you can erase this text and type in your 
  587. own description of the contents of the clipboard. When you save all 
  588. clipboards, the text descriptions are also saved.
  589. You can also select a different clipboard directly without using the dialog 
  590. box, by typing <Control> with a function key (e.g. <Control> F5 makes 
  591. clipboard number 5 the currently active one). This is indicated in the 
  592. information line at the top of the window.
  593.  
  594. Empty clipboard (<Control> E) - the contents of the currently active 
  595. clipboard are totally deleted.
  596.  
  597. Empty all clipboards (<Control> X) - The contents of all ten clipboards are 
  598. totally deleted.
  599.  
  600. Save clipboard and Save all clipboards - the contents of the currently 
  601. active clipboard or all clipboards can be saved to disk. The procedures are 
  602. described in the next section 'DISK OPERATIONS'.
  603.  
  604. DISK OPERATIONS
  605. ---------------
  606.  
  607. All of the following disk operations are accessed from the 'File' drop-down 
  608. menu.
  609.  
  610. Saving text to disk
  611. -------------------
  612.  
  613. While you are creating and editing a document, the information is held in 
  614. the computer's memory. Before exiting from SCRIBE you need to save it to 
  615. disk, otherwise it will be lost for ever.
  616.  
  617. Text can be saved in the special SCRIBE format, or as an ASCII file. The 
  618. SCRIBE format preserves page break markers, headers and footers, so you 
  619. should use this format if you intend later on to load the text back into 
  620. SCRIBE for printing. For all other purposes you should normally use ASCII.
  621.  
  622. (a) SCRIBE file
  623. ---------------
  624.  
  625. To save the text in this form, select 'Save Scribe file', or type 
  626. <Alternate> S. A file selector will be displayed. Select a different 
  627. directory if you so wish, and choose or type a file name, then click on 
  628. 'OK' or press Return. If your chosen file name does not have the extension 
  629. .SCB, SCRIBE will automatically add this extension, or replace a different 
  630. extension with this one. If a file already exists in this directory with 
  631. the same name, this file will be renamed with a .DUP extension before the 
  632. text is saved.
  633.  
  634. When you have selected your file name as above, the data is saved to disk, 
  635. after which you are returned to the position you were in before saving the 
  636. data. You can now exit from SCRIBE or continue to work with it.
  637.  
  638. (b) ASCII file
  639. --------------
  640.  
  641. As an alternative to the above, you can also save a text file in ASCII 
  642. format. This means that the text is saved without any extra control 
  643. characters, just pure text. You might want to do this if you are creating a 
  644. document which is intended for printing from the Desktop or reading 
  645. on-screen, or if you want to import the text into a word processor.
  646.  
  647. To do this, select 'ASCII save' or type <Alternate> A. A dialog box is 
  648. displayed, asking you to choose whether you want paragraph markers after 
  649. every line.
  650.  
  651. If you click on 'Yes', the text will be formatted into lines of up to 77 
  652. characters, each line being terminated with the type of paragraph ending 
  653. used in the current document (i.e. either a Carriage Return and Line Feed 
  654. combination or a Line Feed only).
  655. Line Feed on its own is not normally very useful as a line terminator, so 
  656. if your document is in this format you should probably add Carriage Returns 
  657. to the document before saving it, as described under 'MISCELLANEOUS 
  658. FUNCTIONS'. This subject is discussed more fully in the section 'TECHNICAL 
  659. NOTES' at the end of this manual.
  660. Use CR+LF after every line if the file is intended for printing from the 
  661. Desktop or reading on-screen, or for any other purpose in which each line 
  662. of text has to be preserved as a separate item.
  663.  
  664. If you click on 'No', the text will not be formatted, and paragraph markers 
  665. will be retained only at the ends of paragraphs (i.e. where the paragraph 
  666. end symbol can be seen on the display). Use this style if the file is 
  667. intended for importation into a word processor or another SCRIBE document.
  668.  
  669. Having made this choice, a file selector is displayed, in which you choose 
  670. a directory and file name in the usual way. The file name can have any 
  671. extension you like, and if a file already exists in this directory with the 
  672. same name, this file will be renamed with a .BAK extension before the text 
  673. is saved.
  674.  
  675. After making your selection the text will be saved to disk.
  676.  
  677. Note: ASCII save does not save page break markers, headers or footers, so 
  678. if you want to preserve these you should also save the text in SCRIBE 
  679. format.
  680.  
  681. (c) Clipboard
  682. -------------
  683.  
  684. The contents of the current clipboard can be saved to disk as an ASCII 
  685. file. After selecting 'Save clipboard', or typing <Alternate> C, the 
  686. procedure is the same as for ASCII save.
  687.  
  688. (d) Save all clipboards
  689. -----------------------
  690.  
  691. The contents of all ten clipboards, together with their text descriptions, 
  692. can be saved to disk in a special format used for this purpose. Type 
  693. <Alternate> K, or select 'Save all clipboards'.
  694.  
  695. A file selector is displayed, in which you can enter a filename, which must 
  696. have a .CLP extension. If you use a different extension, or no extension at 
  697. all, SCRIBE will change it to .CLP. After clicking on OK, the text is saved 
  698. to disk. If a file already exists with the same name, it will be 
  699. overwritten.
  700.  
  701.  
  702. Loading data from disk
  703. ----------------------
  704.  
  705. Both SCRIBE files and ASCII files can be loaded into SCRIBE for further 
  706. processing. SCRIBE files are recognised automatically.
  707.  
  708. Select 'Load text' or type <Alternate> L. A file selector is displayed, in 
  709. which you choose the file to be loaded in the usual way. If your chosen 
  710. file is found to be in SCRIBE format it will be treated appropriately; all 
  711. other files are treated as pure ASCII. In principle these can be files of 
  712. any sort; in practice, anything other than a text file will be largely 
  713. unintelligible.
  714.  
  715. When you have selected the file to be loaded, SCRIBE loads it into the 
  716. first available empty document slot; if all ten of the available document 
  717. slots are already occupied, the text cannot be loaded, and an error message 
  718. will be displayed. You will have to clear one of the slots before another 
  719. document can be loaded.
  720.  
  721. Merging data from disk
  722. ----------------------
  723.  
  724. With this procedure, a disk file can be inserted into the document on which 
  725. you are working. It is inserted in the text at the cursor position, and the 
  726. succeeding text is moved up to make room.
  727.  
  728. Select 'Merge text' or type <Alternate> M. A file selector is displayed, in 
  729. which you choose the file to be merged in the usual way. Either SCRIBE or 
  730. ASCII files can be merged; if the former, any included page break markers 
  731. will not be removed, so you will probably need to delete them if you intend 
  732. to paginate the document for printing.
  733.  
  734. If the merged file has a different paragraph end format to the main 
  735. document, its format will be automatically converted to that of the main 
  736. document. See 'TECHNICAL NOTES' at the end of this manual for more 
  737. information.
  738.  
  739. Loading clipboards
  740. ------------------
  741.  
  742. If you have previously used 'Save all clipboards' (see above), you can 
  743. recover the information with this command. Type <Alternate> O, or select 
  744. 'Load clipboards'.
  745.  
  746. A file selector is displayed, in which you can select the appropriate .CLP 
  747. file. If an incorrect type of file is selected, an error message will be 
  748. displayed.
  749.  
  750. After selecting the file, it is loaded into the computer memory and made 
  751. available for normal clipboard operations. The descriptive text can be 
  752. viewed in the 'Select clipboard' dialog box (see under 'Block 
  753. Operations').
  754.  
  755. Formatting floppy disks
  756. -----------------------
  757.  
  758. Type <Alternate> F, or select 'Format floppy disk'. A dialog box is 
  759. displayed, in which you select drive A or B, and whether you want single or 
  760. double sided formatting. Click on 'Format' to format the disk, or 'Cancel' 
  761. to abort the process.
  762.  
  763. Formatting proceeds 'backwards', i.e. from track 79 down to track zero. If 
  764. you realise quickly that you are formatting the wrong disk, you can press 
  765. any key to stop the process, and there is a good chance that the data on 
  766. the disk will not be destroyed.
  767.  
  768. SEARCH AND REPLACE
  769. ------------------
  770.  
  771. SCRIBE provides facilities for finding a specified text string, and 
  772. optionally replacing it with another text string. There are many uses for 
  773. these facilities, such as:-
  774.  
  775. - finding a particular item of text in the document
  776. - correcting repeated spelling mistakes
  777. - speeding up typing by using abbreviations for common words or phrases, 
  778. then later replacing the abbreviations by the full text
  779.  
  780. Select 'Search/replace' from the 'Search' menu, or type <Control> H. How 
  781. you proceed depends on whether you are just searching or searching and 
  782. replacing.
  783.  
  784. (a) Searching
  785. -------------
  786.  
  787. Type into the top line of the dialog box the text which you want to look 
  788. for. This can be any word or phrase of up to 50 characters.
  789.  
  790. In the middle of the dialog box are three buttons labelled 'Find', 
  791. 'Replace?' and 'Replace all'. Click on 'Find' to highlight it.
  792.  
  793. Now decide if the search is to be case sensitive or not. 'Case sensitive' 
  794. means that an exact match of capitals and lower case letters will be made; 
  795. 'Case insensitive' means that capitals and lower case letters are treated 
  796. as the same (AbCdEf, abcdef and ABCDEF are all considered equal). Click on 
  797. the appropriate button, which will then be highlighted.
  798.  
  799. Finally you must choose whether the search is to start from the beginning 
  800. of the document or from the current cursor position. Click on the 
  801. appropriate button, which will then be highlighted.
  802.  
  803. Click on 'OK' to start the search. SCRIBE will now search from the selected 
  804. starting point for your chosen text, and if it exists will display the 
  805. relevant portion.
  806.  
  807. Your chosen text may occur several times. Having found the first example as 
  808. described above, you can select 'Find next' under the 'Search' drop-down 
  809. menu, or type <Control> F, to find the next example. This can be done 
  810. repeatedly until there are no more to be found.
  811.  
  812. 'Find next' always starts its search at the current cursor position; you 
  813. can reposition the cursor anywhere in the document before selecting it. If 
  814. you select 'Find next' before entering a search phrase, nothing will 
  815. happen.
  816.  
  817.  
  818. (b) Searching and replacing
  819. ---------------------------
  820.  
  821. With the dialog box displayed as described above, type the word or phrase 
  822. for which you want to search, then press the down-arrow key or click the 
  823. mouse in the area labelled 'Replacement text'. Type the text which you want 
  824. to replace the search text.
  825.  
  826. Decide whether the search is to be case sensitive or not, and click on the 
  827. appropriate button. (Note that this choice applies only to the search text; 
  828. the replacement text will be inserted exactly as you typed it.)
  829.  
  830. From the row of three buttons, select 'Replace?' or 'Replace all'. If you 
  831. choose 'Replace?', every replacement will be queried before being actioned. 
  832. The relevant part of the text will be displayed, with the search text 
  833. highlighted, and a message at the bottom of the screen asks you if you want 
  834. it to be replaced or not. Type 'Y' to replace the text, or 'N' to leave it 
  835. unchanged (you do not have to press Return after the Y or N). Having made 
  836. your choice, the next occurrence of the search text will be displayed, and 
  837. so on until the end of the document is reached. You can press Esc at any 
  838. time if you want to abort the process.
  839.  
  840. If you choose 'Replace all', every occurrence of the search text will be 
  841. replaced automatically without further prompting. When it is finished, the 
  842. start of the document is redisplayed.
  843.  
  844. Choose whether the search is to start from the start of the document or 
  845. from the current cursor position, then click on 'OK' to start the search 
  846. and replace operation. It proceeds as described in the above two 
  847. paragraphs.
  848.  
  849. Searching and replacing control characters
  850. ------------------------------------------
  851.  
  852. The search and replace facility can be used for non-printing (control) 
  853. characters as well as for normal text. Hold down the Alternate key while 
  854. typing the desired ASCII code on the numeric keypad. Release the Alternate 
  855. key and the character appears. This method works in the search/replace 
  856. dialog box, as well as in the body text.
  857. You should use this capability with care, particularly with the line feed, 
  858. form feed and carriage return characters (ASCII 10, 12 and 13), because 
  859. these have special uses in SCRIBE documents.
  860.  
  861.  
  862. MISCELLANEOUS FUNCTIONS
  863. -----------------------
  864.  
  865. The following functions are all available from the 'Utilities' drop-down 
  866. menu:-
  867.  
  868. (a) User preferences
  869. --------------------
  870.  
  871. Type <Alternate> U, or select 'User preferences'. A dialog box is 
  872. displayed, offering the following choices:
  873.  
  874. - Undo changes: The normal default is 'Yes', in which state the Undo 
  875. facility is enabled. However, if memory is short, an extra 10,000 bytes can 
  876. be made available for text by choosing 'No'. If you do this, the Undo 
  877. facility will not be available.
  878. The current status is shown in the information line at the top of the 
  879. window.
  880.  
  881. - Online help: The normal default is 'Yes', which enables the on-line help 
  882. facility. If you choose 'No', an extra 10,000 bytes of memory is made 
  883. available for text, but the on-line help facility is disabled. If after 
  884. disabling the help facility you subsequently want to reenable it, the file 
  885. SCRIBE.HLP has to be loaded again from disk. If you are using floppy disks, 
  886. you should make sure that the program disk is in the same drive as it was 
  887. in when the program was first run. If SCRIBE cannot find the file, an error 
  888. message will be displayed, and on-line help will not be available.
  889. The current status is shown in the information line at the top of the 
  890. window.
  891.  
  892. - Warnings: The normal default is 'Yes'. In this state, whenever any 
  893. substantially destructive command is issued, a warning is displayed before 
  894. the command is activated, and you are given the option to cancel it. If you 
  895. find these warnings tedious, they can be disabled by choosing 'No'.
  896.  
  897. - Paragraph mark: Normally, paragraph endings are displayed on screen using 
  898. the paragraph end symbol (a left-pointing arrow). If you prefer not to have 
  899. these symbols displayed, select 'No'.
  900.  
  901. - Cursor: The normal cursor is a solid block. However, you can choose 
  902. either a solid block or a vertical line by clicking on the appropriate 
  903. button.
  904.  
  905. - Clipboard: Click on 'Auto' or 'Manual' to select the desired clipboard 
  906. mode (see under 'BLOCK OPERATIONS'). The default mode is 'Auto'.
  907. The current status is shown in the information line at the top of the 
  908. window.
  909.  
  910. - Release memory: In its default state, SCRIBE takes control of all the 
  911. available memory in the computer. In most circumstances this is not a 
  912. problem, but if you want to release some memory for other purposes you can 
  913. enter a suitable value here. This subject is discussed more fully in the 
  914. appendix, under 'TECHNICAL NOTES'.
  915.  
  916. When you have made your choices as above, you have three options:-
  917.  
  918. - 'Save & Use' implements your choices and also saves them in the 
  919. SCRIBE.DEF file, so that they become the new defaults when you next run 
  920. SCRIBE. This function also saves the printed page layout settings (see 
  921. under DOCUMENT PRINTING).
  922.  
  923. - 'Use' implements your choices for the current session only.
  924.  
  925. - 'Cancel' restores the choices to their previous settings.
  926.  
  927.  
  928. (b) Reset paragraphs
  929. --------------------
  930.  
  931. You may want to edit a document which has previously been saved in ASCII 
  932. format and with paragraph markers at the end of every line (for example, 
  933. README files supplied with programs are usually in this format). Editing 
  934. such a document is rather tedious, because every line is in effect a 
  935. separate paragraph. It is much easier if you first delete the unwanted 
  936. paragraph markers, leaving only those which are actually wanted, and SCRIBE 
  937. can give you some help with this:-
  938.  
  939. Type <Alternate> R, or select 'Reset paragraphs'. SCRIBE searches through 
  940. the document for each paragraph marker, and uses an intelligent algorithm 
  941. to decide if the marker should be retained or deleted. You can follow its 
  942. progress as the slider on the vertical scroll bar moves down the screen.
  943.  
  944. When it has finished, you may have to do a little manual tidying-up to 
  945. complete the process.
  946.  
  947.  
  948. (c) Add carriage returns
  949. ------------------------
  950.  
  951. There are some documents to be found which use line feed as a paragraph 
  952. terminator, instead of the far more common carriage return plus line feed 
  953. combination. If such a document is loaded into SCRIBE, this utility can 
  954. convert it to the normal CR/LF format.
  955. Type <Alternate> N, or select 'Add carriage returns'. The document is 
  956. converted, and you can follow its progress as the slider on the vertical 
  957. scroll bar moves down the screen.
  958.  
  959.  
  960. (d) Remove carriage returns
  961. ---------------------------
  962.  
  963. This utility does the opposite of (c) above. Type <Alternate> E, or select 
  964. 'Remove carriage returns'. The document is converted, and you can follow 
  965. its progress as the slider on the vertical scroll bar moves down the 
  966. screen.
  967.  
  968.  
  969. (e) Show ASCII value
  970. --------------------
  971.  
  972. This small utility returns the ASCII value of the character under the 
  973. cursor. Type <Alternate> V, or select 'Show ASCII value'. Press Return or 
  974. click on the button to return to the document. If the cursor is on the 
  975. paragraph end marker, the value returned is the value of the paragraph end 
  976. character (13 or 10), NOT the value of the left-pointing arrow.
  977.  
  978.  
  979. (f) List documents
  980. ------------------
  981.  
  982. This item provides a list of all the documents currently in memory, with 
  983. their sizes in bytes. It also indicates how much free memory remains 
  984. available. Type <Alternate> D, or select 'List documents'.
  985. Click the left mouse button or press any key to return to the document.
  986.  
  987.  
  988. (g) On-line help
  989. ----------------
  990.  
  991. Provided that this facility has not been disabled, a shortened version of 
  992. this instruction manual is available by selecting this item, or pressing 
  993. the Help key. The first screen of the help text gives instructions for 
  994. using it.
  995. Select 'On-line help' or press the Help key again to return to the 
  996. document.
  997.  
  998. Note that the on-line help file is a normal ASCII text file, so you can 
  999. load it into SCRIBE and modify it if you wish. You may like to do this if 
  1000. there is some function in SCRIBE for which you need more explanation than 
  1001. is given in the help text. The only proviso is that the file must not 
  1002. exceed 10,000 bytes in length, otherwise SCRIBE will refuse to accept it as 
  1003. an on-line help file.
  1004.  
  1005. APPENDICES
  1006. ==========
  1007.  
  1008. 1. ERROR MESSAGES AND WARNINGS
  1009. ------------------------------
  1010.  
  1011. Two types of error message may be displayed, those generated by the 
  1012. operating system, and those produced by SCRIBE:-
  1013.  
  1014. Operating system messages
  1015. -------------------------
  1016.  
  1017. These should occur only in the course of disk reading or writing 
  1018. operations. Some common messages, in abbreviated form, are:
  1019.  
  1020. "The disk... is physically write-protected..." - this will be displayed if 
  1021. the write protect tab in the corner of a floppy disk is in the open 
  1022. position when you try to save a file or format the disk. Push the tab into 
  1023. the closed position and try again.
  1024.  
  1025. "Drive A (or B) is not responding..." - this can occur in several 
  1026. circumstances:
  1027.  
  1028. - The disk is corrupted
  1029. - The disk is not formatted
  1030. - There is no disk in the drive
  1031. - You are using a double sided disk in a single sided drive
  1032. - You are using a high density disk in a normal density drive
  1033. - The drive is faulty
  1034.  
  1035. If there is a formatted disk of the correct type in the drive, you may 
  1036. still experience this message as a result of slight maladjustment of the 
  1037. disk drive heads. In this circumstance it is often worth trying again; a 
  1038. second or third attempt will often be successful. If you experience this 
  1039. message frequently, your disk drive is probably in need of repair, or you 
  1040. are using very unreliable disks.
  1041.  
  1042. "Disk full" - Use a fresh disk.
  1043.  
  1044.  
  1045. SCRIBE error messages and warnings
  1046. ----------------------------------
  1047.  
  1048. These can occur in a variety of circumstances, usually as a result of 
  1049. attempting an operation which is impossible or inappropriate in the current 
  1050. conditions. If warnings are enabled, warning messages will be displayed if 
  1051. you initiate a procedure which will erase substantial amounts of text. Most 
  1052. of these messages are quite self-explanatory, but those relating to memory 
  1053. limitation deserve some explanation. These messages are:-
  1054.  
  1055. "There is not enough free memory for this operation" - This can occur in 
  1056. several circumstances, when loading or merging a file, or during block 
  1057. operations.
  1058.  
  1059. Possible solutions are:-
  1060. - erase unwanted documents, after saving them if necessary
  1061. - empty unwanted clipboards
  1062. - save your documents, then re-boot the computer without desk accessories
  1063.  
  1064. If you have a minimum-memory (512K) machine, it will be worth conserving 
  1065. your memory by not loading too many documents simultaneously. It may also 
  1066. be worth switching the clipboard mode to 'Manual' and only using clipboard 
  1067. number 1, to avoid filling the clipboard area with text which is no longer 
  1068. wanted there.
  1069.  
  1070. "Less than 10,000 bytes of memory remaining" - This warns you that memory 
  1071. is beginning to become short. You should consider the memory saving options 
  1072. given above if you want to add much more text to your document(s).
  1073.  
  1074. "Less than 5,000 bytes of memory remaining..." - Memory is now becoming 
  1075. quite short. You must consider the memory saving options, or finish adding 
  1076. text to your document(s).
  1077.  
  1078. "Nearly out of memory!" - Memory is now getting critical. Do NOT add any 
  1079. significant quantity of text before freeing some memory elsewhere.
  1080.  
  1081. "*** Out of memory ***" - If, despite the earlier warnings, you arrive at 
  1082. this stage, all is not lost, but you MUST stop editing your documents. All 
  1083. the functions of SCRIBE will still work, but the message will be repeatedly 
  1084. displayed until you erase some material to free up some additional memory. 
  1085. You are recommended to save all documents in memory before doing anything 
  1086. else.
  1087.  
  1088. 2. INSTALLING SCRIBE AS AN APPLICATION
  1089. --------------------------------------
  1090.  
  1091. SCRIBE can be installed as an application. When this is done, 
  1092. double-clicking on a suitable text file will automatically run SCRIBE, then 
  1093. load the text file into it, in a single operation. This has more usefulness 
  1094. in a hard disk system, but is also possible with floppies. Note that this 
  1095. is only an option; it is NOT an essential part of using SCRIBE.
  1096.  
  1097. To install SCRIBE as an application, first find the SCRIBE.PRG icon from 
  1098. the Desktop, then click once on it so that it is highlighted. Now select 
  1099. 'Install Application' from the 'Options' menu. This displays a small dialog 
  1100. box, in which you will see that SCRIBE.PRG has been entered as the 
  1101. application name. You have to enter a document type into the space 
  1102. indicated; this is the extension of the type of text file which you want to 
  1103. enable - it could be SCB for an SCRIBE file, or (for example) DOC or TXT 
  1104. for ASCII files, depending on your preference.
  1105.  
  1106. Finally, under 'Application type', click on 'GEM', then click on 'OK' to 
  1107. complete the installation. You can now run SCRIBE by double-clicking on any 
  1108. file which has the extension which you installed. To make your installation 
  1109. permanent, select 'Save Desktop' from the 'Options' menu (on the Desktop, 
  1110. not in SCRIBE). For this function to work in subsequent sessions, 
  1111. SCRIBE.PRG must be in the same folder, and in the same disk drive, as when 
  1112. you installed it.
  1113.  
  1114. Alternative desktops such as Neodesk provide similar functions. The exact 
  1115. procedure will be described in the manual supplied with the program. Some 
  1116. of these alternative desktops allow more than one document type to be 
  1117. installed for the same application.
  1118.  
  1119.  
  1120. 3. TECHNICAL NOTES
  1121. ------------------
  1122.  
  1123. Paragraph endings
  1124. -----------------
  1125.  
  1126. In its default state, SCRIBE conforms to the normal convention of ending 
  1127. paragraphs with a carriage return and line feed combination. However there 
  1128. are some documents in circulation which do not conform to this convention, 
  1129. using line feed alone as the paragraph terminator.
  1130. When SCRIBE loads a document, it checks to see which type of paragraph 
  1131. ending is used, and adapts its characteristics accordingly. Therefore, you 
  1132. do not normally need to be aware of which type of document is in memory, as 
  1133. the change in function is automatic, and transparent to the user.
  1134. If you do want to know which type of document you have loaded, the second 
  1135. item in the information line at the top of the window ('PARA') indicates 
  1136. the format of the current document.
  1137. SCRIBE includes routines for converting between the two formats as 
  1138. described  under 'MISCELLANEOUS FUNCTIONS'.
  1139. If you merge a document which has a different paragraph end format to the 
  1140. document into which it is being merged, the merged document will be 
  1141. automatically converted to the format of the main document.
  1142.  
  1143. Memory management
  1144. -----------------
  1145.  
  1146. By default, SCRIBE takes control of all the available memory in the 
  1147. computer for its own use. In most circumstances this is perfectly 
  1148. acceptable, but there can be situations in which some free memory is 
  1149. required for other purposes, e.g.:-
  1150.  
  1151. - you may need to call a desk accessory which requires extra memory, for 
  1152. example to set up a ramdisk or a print spooler.
  1153. - you may be using a multi-tasking operating system, and need to leave some 
  1154. free memory in which to load other programs.
  1155.  
  1156. The 'Release memory' facility in the 'User preferences' dialog box enables 
  1157. you to free some of the memory for such purposes. The figure which is 
  1158. entered in the dialog box is the total amount of memory which is to be 
  1159. untouched by SCRIBE (i.e. free for other purposes). This amount can be 
  1160. changed at any time; error messages will be displayed if unreasonable 
  1161. values are entered. SCRIBE will refuse to release more memory if the result 
  1162. would be to reduce its own free workspace to less than 32 kilobytes.
  1163.  
  1164. If you release some memory, then use some of it for another purpose, you 
  1165. will not be able to reset the released memory to zero until it is freed up 
  1166. by the other application or desk accessory which used it. Some public 
  1167. domain desk accessories have defective memory management and may cause some 
  1168. problems with this facility; therefore it is generally safer to set up 
  1169. ramdisks, print spoolers, etc. before running SCRIBE.
  1170.  
  1171. Using SCRIBE in low resolution
  1172. ------------------------------
  1173.  
  1174. In principle, SCRIBE will work in any screen resolution. However, in the 
  1175. low resolution modes (less than 640 pixels horizontally) full functioning 
  1176. will not be available - part of the drop-down menu will be missing, and 
  1177. some dialog boxes will overflow the screen, leading to some corruption of 
  1178. the display. It is not therefore recommended to use SCRIBE in low 
  1179. resolution, but it can nevertheless be used in these modes for simple 
  1180. editing of small text files.
  1181.  
  1182. Note concerning TOS V1.04
  1183. -------------------------
  1184.  
  1185. There is a bug in the operating system version 1.04 ('Rainbow TOS') and 
  1186. some subsequent versions, which may affect users of SCRIBE. The effect of 
  1187. this bug is that single mouse clicks are sometimes interpreted as two 
  1188. clicks. If, for example, you click in the grey area of the scroll bar to 
  1189. scroll the text, it may scroll twice.
  1190.  
  1191. SCRIBE contains code which should avoid any occurrence of this bug. However 
  1192. if it does occur, proceed as follows: There is a public domain desk 
  1193. accessory called SCROLFIX.ACC supplied with SCRIBE. Copy this file to the 
  1194. root directory of your boot disk (i.e. not inside any folder) and reboot 
  1195. the computer by pressing the reset button. The system should now respond 
  1196. normally to mouse clicks.
  1197.  
  1198. SCROLFIX.ACC is a desk accessory, and it will unfortunately occupy one of 
  1199. the available six desk accessory slots, so you should install it only if it 
  1200. proves necessary.
  1201.  
  1202. Speed-up utilities
  1203. ------------------
  1204.  
  1205. SCRIBE uses 'legal' operating system calls, so it should be compatible with 
  1206. speed-up utilities such as QuickST and WARP 9. The author uses QuickST 3, 
  1207. and this gives a dramatic increase in the speed of text output, drawing 
  1208. dialog boxes, etc. If you want to obtain maximum speed with SCRIBE, these 
  1209. utilities can be recommended.
  1210.  
  1211.