Home » Archimedes archive » Acorn User » AU 1998-08.adf » Regulars » StarInfo/Mellor/!BBC1/!Help/ProgHelp
StarInfo/Mellor/!BBC1/!Help/ProgHelp
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
Tape/disk: | Home » Archimedes archive » Acorn User » AU 1998-08.adf » Regulars |
Filename: | StarInfo/Mellor/!BBC1/!Help/ProgHelp |
Read OK: | ✔ |
File size: | 0717 bytes |
Load address: | 0000 |
Exec address: | 0000 |
Duplicates
There are 3 duplicate copies of this file in the archive:
- Archimedes archive » Acorn User » AU 1998-04 A.adf » Regulars » StarInfo/Mellor/!SpotOn/!Help/ProgHelp
- Archimedes archive » Acorn User » AU 1997-12.adf » Regulars » StarInfo/Mellor/!HTML>Imp/!Help/ProgHelp
- Archimedes archive » Acorn User » AU 1998-02 B.adf » Regulars » StarInfo/Mellor/!Sharks/!Help/ProgHelp
- Archimedes archive » Acorn User » AU 1998-08.adf » Regulars » StarInfo/Mellor/!BBC1/!Help/ProgHelp
File contents
HelpReader This is a small utility designed to display nice-looking Help files, not just normal boring textfiles. Using it in your own programs Simply copy the !Help application inside your own application and replace the HelpText file with the !Help file for your application. Please leave the ProgHelp file intact. Any textfile can be loaded by dragging it into the HelpReader window. You can also make HelpReader load any file if you provide it with a filename. If no filename is provided, then HelpReader will load "!Help.helptext" by default. Syntax: Run !Help -load <filename> File format The files are stored with the filetype plain text (&FFF), but contain several control codes which alter the appearance of the document. The control codes must be placed at the start of the line or paragraph you wish to apply the effect to. Note that to enter a code in Edit you must press the key-combination, not simply type the square brackets and number. [14] (Ctrl-T) - Title / Sub-heading [02] (Ctrl-B) - Bold [09] (Ctrl-I) - Italic [0b] (Ctrl-K) - Program coding (think 'Kode'!) Only press Return to force a linebreak - eg. at the end of a paragraph. The program will automatically wordwrap all the text. A limitation to the program is that currently it only handles up to 255 lines of formatted text. If this is a problem to you, contact me and I'll see if I can sort out an upgrade. Boring legal gubbins You are free to use and distribute HelpReader with your own programs, provided that no file (other than the 'Helptext' file) is modified, and that no charge is made for it (other than for media and distribution costs). If you are planning to use HelpReader in a commercial product then I would appreciate being informed about this. � Philip Mellor 1997 mailto: yr92pm4@hors4th.demon.co.uk
00000000 14 48 65 6c 70 52 65 61 64 65 72 0a 54 68 69 73 |.HelpReader.This| 00000010 20 69 73 20 61 20 73 6d 61 6c 6c 20 75 74 69 6c | is a small util| 00000020 69 74 79 20 64 65 73 69 67 6e 65 64 20 74 6f 20 |ity designed to | 00000030 64 69 73 70 6c 61 79 20 6e 69 63 65 2d 6c 6f 6f |display nice-loo| 00000040 6b 69 6e 67 20 48 65 6c 70 20 66 69 6c 65 73 2c |king Help files,| 00000050 20 6e 6f 74 20 6a 75 73 74 20 6e 6f 72 6d 61 6c | not just normal| 00000060 20 62 6f 72 69 6e 67 20 74 65 78 74 66 69 6c 65 | boring textfile| 00000070 73 2e 0a 0a 14 55 73 69 6e 67 20 69 74 20 69 6e |s....Using it in| 00000080 20 79 6f 75 72 20 6f 77 6e 20 70 72 6f 67 72 61 | your own progra| 00000090 6d 73 0a 53 69 6d 70 6c 79 20 63 6f 70 79 20 74 |ms.Simply copy t| 000000a0 68 65 20 21 48 65 6c 70 20 61 70 70 6c 69 63 61 |he !Help applica| 000000b0 74 69 6f 6e 20 69 6e 73 69 64 65 20 79 6f 75 72 |tion inside your| 000000c0 20 6f 77 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e | own application| 000000d0 20 61 6e 64 20 72 65 70 6c 61 63 65 20 74 68 65 | and replace the| 000000e0 20 48 65 6c 70 54 65 78 74 20 66 69 6c 65 20 77 | HelpText file w| 000000f0 69 74 68 20 74 68 65 20 21 48 65 6c 70 20 66 69 |ith the !Help fi| 00000100 6c 65 20 66 6f 72 20 79 6f 75 72 20 61 70 70 6c |le for your appl| 00000110 69 63 61 74 69 6f 6e 2e 20 50 6c 65 61 73 65 20 |ication. Please | 00000120 6c 65 61 76 65 20 74 68 65 20 50 72 6f 67 48 65 |leave the ProgHe| 00000130 6c 70 20 66 69 6c 65 20 69 6e 74 61 63 74 2e 20 |lp file intact. | 00000140 41 6e 79 20 74 65 78 74 66 69 6c 65 20 63 61 6e |Any textfile can| 00000150 20 62 65 20 6c 6f 61 64 65 64 20 62 79 20 64 72 | be loaded by dr| 00000160 61 67 67 69 6e 67 20 69 74 20 69 6e 74 6f 20 74 |agging it into t| 00000170 68 65 20 48 65 6c 70 52 65 61 64 65 72 20 77 69 |he HelpReader wi| 00000180 6e 64 6f 77 2e 20 59 6f 75 20 63 61 6e 20 61 6c |ndow. You can al| 00000190 73 6f 20 6d 61 6b 65 20 48 65 6c 70 52 65 61 64 |so make HelpRead| 000001a0 65 72 20 6c 6f 61 64 20 61 6e 79 20 66 69 6c 65 |er load any file| 000001b0 20 69 66 20 79 6f 75 20 70 72 6f 76 69 64 65 20 | if you provide | 000001c0 69 74 20 77 69 74 68 20 61 20 66 69 6c 65 6e 61 |it with a filena| 000001d0 6d 65 2e 20 49 66 20 6e 6f 20 66 69 6c 65 6e 61 |me. If no filena| 000001e0 6d 65 20 69 73 20 70 72 6f 76 69 64 65 64 2c 20 |me is provided, | 000001f0 74 68 65 6e 20 48 65 6c 70 52 65 61 64 65 72 20 |then HelpReader | 00000200 77 69 6c 6c 20 6c 6f 61 64 20 22 21 48 65 6c 70 |will load "!Help| 00000210 2e 68 65 6c 70 74 65 78 74 22 20 62 79 20 64 65 |.helptext" by de| 00000220 66 61 75 6c 74 2e 0a 0a 02 53 79 6e 74 61 78 3a |fault....Syntax:| 00000230 0a 0b 52 75 6e 20 21 48 65 6c 70 20 2d 6c 6f 61 |..Run !Help -loa| 00000240 64 20 3c 66 69 6c 65 6e 61 6d 65 3e 0a 0a 14 46 |d <filename>...F| 00000250 69 6c 65 20 66 6f 72 6d 61 74 0a 54 68 65 20 66 |ile format.The f| 00000260 69 6c 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 |iles are stored | 00000270 77 69 74 68 20 74 68 65 20 66 69 6c 65 74 79 70 |with the filetyp| 00000280 65 20 70 6c 61 69 6e 20 74 65 78 74 20 28 26 46 |e plain text (&F| 00000290 46 46 29 2c 20 62 75 74 20 63 6f 6e 74 61 69 6e |FF), but contain| 000002a0 20 73 65 76 65 72 61 6c 20 63 6f 6e 74 72 6f 6c | several control| 000002b0 20 63 6f 64 65 73 20 77 68 69 63 68 20 61 6c 74 | codes which alt| 000002c0 65 72 20 74 68 65 20 61 70 70 65 61 72 61 6e 63 |er the appearanc| 000002d0 65 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e |e of the documen| 000002e0 74 2e 20 54 68 65 20 63 6f 6e 74 72 6f 6c 20 63 |t. The control c| 000002f0 6f 64 65 73 20 6d 75 73 74 20 62 65 20 70 6c 61 |odes must be pla| 00000300 63 65 64 20 61 74 20 74 68 65 20 73 74 61 72 74 |ced at the start| 00000310 20 6f 66 20 74 68 65 20 6c 69 6e 65 20 6f 72 20 | of the line or | 00000320 70 61 72 61 67 72 61 70 68 20 79 6f 75 20 77 69 |paragraph you wi| 00000330 73 68 20 74 6f 20 61 70 70 6c 79 20 74 68 65 20 |sh to apply the | 00000340 65 66 66 65 63 74 20 74 6f 2e 20 4e 6f 74 65 20 |effect to. Note | 00000350 74 68 61 74 20 74 6f 20 65 6e 74 65 72 20 61 20 |that to enter a | 00000360 63 6f 64 65 20 69 6e 20 45 64 69 74 20 79 6f 75 |code in Edit you| 00000370 20 6d 75 73 74 20 70 72 65 73 73 20 74 68 65 20 | must press the | 00000380 6b 65 79 2d 63 6f 6d 62 69 6e 61 74 69 6f 6e 2c |key-combination,| 00000390 20 6e 6f 74 20 73 69 6d 70 6c 79 20 74 79 70 65 | not simply type| 000003a0 20 74 68 65 20 73 71 75 61 72 65 20 62 72 61 63 | the square brac| 000003b0 6b 65 74 73 20 61 6e 64 20 6e 75 6d 62 65 72 2e |kets and number.| 000003c0 0a 0a 02 5b 31 34 5d 20 28 43 74 72 6c 2d 54 29 |...[14] (Ctrl-T)| 000003d0 20 2d 20 54 69 74 6c 65 20 2f 20 53 75 62 2d 68 | - Title / Sub-h| 000003e0 65 61 64 69 6e 67 0a 02 5b 30 32 5d 20 28 43 74 |eading..[02] (Ct| 000003f0 72 6c 2d 42 29 20 2d 20 42 6f 6c 64 0a 02 5b 30 |rl-B) - Bold..[0| 00000400 39 5d 20 28 43 74 72 6c 2d 49 29 20 2d 20 49 74 |9] (Ctrl-I) - It| 00000410 61 6c 69 63 0a 02 5b 30 62 5d 20 28 43 74 72 6c |alic..[0b] (Ctrl| 00000420 2d 4b 29 20 2d 20 50 72 6f 67 72 61 6d 20 63 6f |-K) - Program co| 00000430 64 69 6e 67 20 28 74 68 69 6e 6b 20 27 4b 6f 64 |ding (think 'Kod| 00000440 65 27 21 29 0a 0a 4f 6e 6c 79 20 70 72 65 73 73 |e'!)..Only press| 00000450 20 52 65 74 75 72 6e 20 74 6f 20 66 6f 72 63 65 | Return to force| 00000460 20 61 20 6c 69 6e 65 62 72 65 61 6b 20 2d 20 65 | a linebreak - e| 00000470 67 2e 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 |g. at the end of| 00000480 20 61 20 70 61 72 61 67 72 61 70 68 2e 20 54 68 | a paragraph. Th| 00000490 65 20 70 72 6f 67 72 61 6d 20 77 69 6c 6c 20 61 |e program will a| 000004a0 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 6f 72 |utomatically wor| 000004b0 64 77 72 61 70 20 61 6c 6c 20 74 68 65 20 74 65 |dwrap all the te| 000004c0 78 74 2e 0a 0a 41 20 6c 69 6d 69 74 61 74 69 6f |xt...A limitatio| 000004d0 6e 20 74 6f 20 74 68 65 20 70 72 6f 67 72 61 6d |n to the program| 000004e0 20 69 73 20 74 68 61 74 20 63 75 72 72 65 6e 74 | is that current| 000004f0 6c 79 20 69 74 20 6f 6e 6c 79 20 68 61 6e 64 6c |ly it only handl| 00000500 65 73 20 75 70 20 74 6f 20 32 35 35 20 6c 69 6e |es up to 255 lin| 00000510 65 73 20 6f 66 20 66 6f 72 6d 61 74 74 65 64 20 |es of formatted | 00000520 74 65 78 74 2e 20 49 66 20 74 68 69 73 20 69 73 |text. If this is| 00000530 20 61 20 70 72 6f 62 6c 65 6d 20 74 6f 20 79 6f | a problem to yo| 00000540 75 2c 20 63 6f 6e 74 61 63 74 20 6d 65 20 61 6e |u, contact me an| 00000550 64 20 49 27 6c 6c 20 73 65 65 20 69 66 20 49 20 |d I'll see if I | 00000560 63 61 6e 20 73 6f 72 74 20 6f 75 74 20 61 6e 20 |can sort out an | 00000570 75 70 67 72 61 64 65 2e 0a 0a 14 42 6f 72 69 6e |upgrade....Borin| 00000580 67 20 6c 65 67 61 6c 20 67 75 62 62 69 6e 73 0a |g legal gubbins.| 00000590 59 6f 75 20 61 72 65 20 66 72 65 65 20 74 6f 20 |You are free to | 000005a0 75 73 65 20 61 6e 64 20 64 69 73 74 72 69 62 75 |use and distribu| 000005b0 74 65 20 48 65 6c 70 52 65 61 64 65 72 20 77 69 |te HelpReader wi| 000005c0 74 68 20 79 6f 75 72 20 6f 77 6e 20 70 72 6f 67 |th your own prog| 000005d0 72 61 6d 73 2c 20 70 72 6f 76 69 64 65 64 20 74 |rams, provided t| 000005e0 68 61 74 20 6e 6f 20 66 69 6c 65 20 28 6f 74 68 |hat no file (oth| 000005f0 65 72 20 74 68 61 6e 20 74 68 65 20 27 48 65 6c |er than the 'Hel| 00000600 70 74 65 78 74 27 20 66 69 6c 65 29 20 69 73 20 |ptext' file) is | 00000610 6d 6f 64 69 66 69 65 64 2c 20 61 6e 64 20 74 68 |modified, and th| 00000620 61 74 20 6e 6f 20 63 68 61 72 67 65 20 69 73 20 |at no charge is | 00000630 6d 61 64 65 20 66 6f 72 20 69 74 20 28 6f 74 68 |made for it (oth| 00000640 65 72 20 74 68 61 6e 20 66 6f 72 20 6d 65 64 69 |er than for medi| 00000650 61 20 61 6e 64 20 64 69 73 74 72 69 62 75 74 69 |a and distributi| 00000660 6f 6e 20 63 6f 73 74 73 29 2e 20 49 66 20 79 6f |on costs). If yo| 00000670 75 20 61 72 65 20 70 6c 61 6e 6e 69 6e 67 20 74 |u are planning t| 00000680 6f 20 75 73 65 20 48 65 6c 70 52 65 61 64 65 72 |o use HelpReader| 00000690 20 69 6e 20 61 20 63 6f 6d 6d 65 72 63 69 61 6c | in a commercial| 000006a0 20 70 72 6f 64 75 63 74 20 74 68 65 6e 20 49 20 | product then I | 000006b0 77 6f 75 6c 64 20 61 70 70 72 65 63 69 61 74 65 |would appreciate| 000006c0 20 62 65 69 6e 67 20 69 6e 66 6f 72 6d 65 64 20 | being informed | 000006d0 61 62 6f 75 74 20 74 68 69 73 2e 0a 0a 02 a9 20 |about this..... | 000006e0 50 68 69 6c 69 70 20 4d 65 6c 6c 6f 72 20 31 39 |Philip Mellor 19| 000006f0 39 37 0a 09 6d 61 69 6c 74 6f 3a 20 79 72 39 32 |97..mailto: yr92| 00000700 70 6d 34 40 68 6f 72 73 34 74 68 2e 64 65 6d 6f |pm4@hors4th.demo| 00000710 6e 2e 63 6f 2e 75 6b |n.co.uk| 00000717