Home » CEEFAX disks » telesoftware8.adl » 08-07-88/INSTRUC

08-07-88/INSTRUC

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 » CEEFAX disks » telesoftware8.adl
Filename: 08-07-88/INSTRUC
Read OK:
File size: 11B9 bytes
Load address: 0000
Exec address: FFFFFFFF
Duplicates

There is 1 duplicate copy of this file in the archive:

File contents
                  INDENTED LISTINGS

Those who program in PASCAL or other highly structured
languages know the benefits of indenting lines of program to
emphasise the presence of the various control structures.

There's nothing wrong with programming in BASIC if one
learns good work habits - unfortunately all too rare a
thing. This is an attempt to take a program in BBC BASIC
and produce neatly indented copy rather than the garbled
mess which listings more often resemble.

Anything which encourages the proper blocking of for .. next
loops must help, and proper indentation of IF statements
might clarify what exactly IS happening when further IFs
appear elsewhere on the same line.

The standards adopted for indenting are as follows:

Line number : 5 spaces
One space thereafter
Two spaces per REPEAT
Two spaces per FOR
The above applies globally, i.e. the affects last from one
line to another.

Two spaces per THEN or ELSE
This indent only applies to then line you are on at the
moment.

                OPERATING INSTRUCTIONS

This is how to get a neat listing of your program, with long
lines split up into separate instructions on separate lines,
and procedure names highlighted in red on the screen, and
double width on the printer.
1. CHAIN "Lister1" (or if using a Network, CHAIN "Lister2")
 
2. Wait while the program loads some data from a file
   called "FILE".
 
3. When the computer asks you for a directory, type in its
   name.
 
4. This will be repeated until you see the desired
   directory catalogued on the screen.
 
5. If you are in the desired directory, press return on
   its own.
 
6. The directory you have selected will be re-displayed.
   The computer asks you for the name of the program.
   Type it in.
 
7. The computer asks you for a starting line number. To
   list the whole program, type in 0, or simply press
   return.
 
8. The program asks you for the width you want the listing
   printed. If you're using the screen only, I suggest
   35 to 39. If you're using the printer, I suggest 60
   to 70. Type in the required width.
 
9. The computer asks you whether you want to use the
   printer. Answer YES or NO - you can shorten this to Y
   or N.
 
10. If you want to use the printer, the computer asks you
    if you want to print via econet - answer YES or NO.
 
11. The computer lists your program for you. This
    operates more slowly than a normal listing, because all
    the checking which is normally done very quickly in
    machine code, is now being done by LISTER.
 
12. Press ESCAPE if something goes wrong. The file you
    were using will be closed down, and you will skip to
    stage 13.
 
13. When the listing stops the computer asks you if you
    want another go. Answer YES or NO. If you answer
    YES or Y then you will return to the stage of selecting
    another directory and program. If you answer NO or N
    then the program stops.

             HOW TO CUSTOMISE THIS PROGRAM

As it stands, the programs Lister2 and Lister3 have been
designed to work via ECONET. They require a number of
alterations if they are to work with a standard DFS. The
version "Lister1" has already had these modifications
carried out, and is available for immediate use by
non-network DFS users.

Firstly, lines 190, 200 and 300 are net-specific. If you are
using the DFS or ADFS these should be deleted before the
program is run.

Secondly, with a DFS catalogue being confined to 31 files,
there's no point in selecting directories or subdirectories.
Therefore delete lines 390 to 450. DO NOT succumb to the
temptation to delete line 380 - it matches with the UNTIL at
line 770.

A third point for NET or ADFS users: when you download the
program LISTER and its associated file FILE, these may well
not end up in the main directory, as I have assumed. You
should alter line 240 to follow the path to the directory
where you have placed it. For example:

*DIR $.Fred.Personal.Listerprog

If you don't understand how pathnames work, then select the
root directory ( *DIR $ ) and download FILE from Teletext
again. 

Lastly for NFS users: If you are using a BBC model B, you
will already be aware that transmission rates round the
network can sometimes seem to be very slow. This is because
each byte of data is individually packaged prior to
transmission. Line 200 refers to a machine code utility
available from SJ Research or MUSE. If you don't have it,
you can delete this line, and 190, 300 as well.

Lister3 is a fully documented version for those wishing to
study the routines.
00000000  0d 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000010  20 20 20 49 4e 44 45 4e  54 45 44 20 4c 49 53 54  |   INDENTED LIST|
00000020  49 4e 47 53 0d 0d 54 68  6f 73 65 20 77 68 6f 20  |INGS..Those who |
00000030  70 72 6f 67 72 61 6d 20  69 6e 20 50 41 53 43 41  |program in PASCA|
00000040  4c 20 6f 72 20 6f 74 68  65 72 20 68 69 67 68 6c  |L or other highl|
00000050  79 20 73 74 72 75 63 74  75 72 65 64 0d 6c 61 6e  |y structured.lan|
00000060  67 75 61 67 65 73 20 6b  6e 6f 77 20 74 68 65 20  |guages know the |
00000070  62 65 6e 65 66 69 74 73  20 6f 66 20 69 6e 64 65  |benefits of inde|
00000080  6e 74 69 6e 67 20 6c 69  6e 65 73 20 6f 66 20 70  |nting lines of p|
00000090  72 6f 67 72 61 6d 20 74  6f 0d 65 6d 70 68 61 73  |rogram to.emphas|
000000a0  69 73 65 20 74 68 65 20  70 72 65 73 65 6e 63 65  |ise the presence|
000000b0  20 6f 66 20 74 68 65 20  76 61 72 69 6f 75 73 20  | of the various |
000000c0  63 6f 6e 74 72 6f 6c 20  73 74 72 75 63 74 75 72  |control structur|
000000d0  65 73 2e 0d 0d 54 68 65  72 65 27 73 20 6e 6f 74  |es...There's not|
000000e0  68 69 6e 67 20 77 72 6f  6e 67 20 77 69 74 68 20  |hing wrong with |
000000f0  70 72 6f 67 72 61 6d 6d  69 6e 67 20 69 6e 20 42  |programming in B|
00000100  41 53 49 43 20 69 66 20  6f 6e 65 0d 6c 65 61 72  |ASIC if one.lear|
00000110  6e 73 20 67 6f 6f 64 20  77 6f 72 6b 20 68 61 62  |ns good work hab|
00000120  69 74 73 20 2d 20 75 6e  66 6f 72 74 75 6e 61 74  |its - unfortunat|
00000130  65 6c 79 20 61 6c 6c 20  74 6f 6f 20 72 61 72 65  |ely all too rare|
00000140  20 61 0d 74 68 69 6e 67  2e 20 54 68 69 73 20 69  | a.thing. This i|
00000150  73 20 61 6e 20 61 74 74  65 6d 70 74 20 74 6f 20  |s an attempt to |
00000160  74 61 6b 65 20 61 20 70  72 6f 67 72 61 6d 20 69  |take a program i|
00000170  6e 20 42 42 43 20 42 41  53 49 43 0d 61 6e 64 20  |n BBC BASIC.and |
00000180  70 72 6f 64 75 63 65 20  6e 65 61 74 6c 79 20 69  |produce neatly i|
00000190  6e 64 65 6e 74 65 64 20  63 6f 70 79 20 72 61 74  |ndented copy rat|
000001a0  68 65 72 20 74 68 61 6e  20 74 68 65 20 67 61 72  |her than the gar|
000001b0  62 6c 65 64 0d 6d 65 73  73 20 77 68 69 63 68 20  |bled.mess which |
000001c0  6c 69 73 74 69 6e 67 73  20 6d 6f 72 65 20 6f 66  |listings more of|
000001d0  74 65 6e 20 72 65 73 65  6d 62 6c 65 2e 0d 0d 41  |ten resemble...A|
000001e0  6e 79 74 68 69 6e 67 20  77 68 69 63 68 20 65 6e  |nything which en|
000001f0  63 6f 75 72 61 67 65 73  20 74 68 65 20 70 72 6f  |courages the pro|
00000200  70 65 72 20 62 6c 6f 63  6b 69 6e 67 20 6f 66 20  |per blocking of |
00000210  66 6f 72 20 2e 2e 20 6e  65 78 74 0d 6c 6f 6f 70  |for .. next.loop|
00000220  73 20 6d 75 73 74 20 68  65 6c 70 2c 20 61 6e 64  |s must help, and|
00000230  20 70 72 6f 70 65 72 20  69 6e 64 65 6e 74 61 74  | proper indentat|
00000240  69 6f 6e 20 6f 66 20 49  46 20 73 74 61 74 65 6d  |ion of IF statem|
00000250  65 6e 74 73 0d 6d 69 67  68 74 20 63 6c 61 72 69  |ents.might clari|
00000260  66 79 20 77 68 61 74 20  65 78 61 63 74 6c 79 20  |fy what exactly |
00000270  49 53 20 68 61 70 70 65  6e 69 6e 67 20 77 68 65  |IS happening whe|
00000280  6e 20 66 75 72 74 68 65  72 20 49 46 73 0d 61 70  |n further IFs.ap|
00000290  70 65 61 72 20 65 6c 73  65 77 68 65 72 65 20 6f  |pear elsewhere o|
000002a0  6e 20 74 68 65 20 73 61  6d 65 20 6c 69 6e 65 2e  |n the same line.|
000002b0  0d 0d 54 68 65 20 73 74  61 6e 64 61 72 64 73 20  |..The standards |
000002c0  61 64 6f 70 74 65 64 20  66 6f 72 20 69 6e 64 65  |adopted for inde|
000002d0  6e 74 69 6e 67 20 61 72  65 20 61 73 20 66 6f 6c  |nting are as fol|
000002e0  6c 6f 77 73 3a 0d 0d 4c  69 6e 65 20 6e 75 6d 62  |lows:..Line numb|
000002f0  65 72 20 3a 20 35 20 73  70 61 63 65 73 0d 4f 6e  |er : 5 spaces.On|
00000300  65 20 73 70 61 63 65 20  74 68 65 72 65 61 66 74  |e space thereaft|
00000310  65 72 0d 54 77 6f 20 73  70 61 63 65 73 20 70 65  |er.Two spaces pe|
00000320  72 20 52 45 50 45 41 54  0d 54 77 6f 20 73 70 61  |r REPEAT.Two spa|
00000330  63 65 73 20 70 65 72 20  46 4f 52 0d 54 68 65 20  |ces per FOR.The |
00000340  61 62 6f 76 65 20 61 70  70 6c 69 65 73 20 67 6c  |above applies gl|
00000350  6f 62 61 6c 6c 79 2c 20  69 2e 65 2e 20 74 68 65  |obally, i.e. the|
00000360  20 61 66 66 65 63 74 73  20 6c 61 73 74 20 66 72  | affects last fr|
00000370  6f 6d 20 6f 6e 65 0d 6c  69 6e 65 20 74 6f 20 61  |om one.line to a|
00000380  6e 6f 74 68 65 72 2e 0d  0d 54 77 6f 20 73 70 61  |nother...Two spa|
00000390  63 65 73 20 70 65 72 20  54 48 45 4e 20 6f 72 20  |ces per THEN or |
000003a0  45 4c 53 45 0d 54 68 69  73 20 69 6e 64 65 6e 74  |ELSE.This indent|
000003b0  20 6f 6e 6c 79 20 61 70  70 6c 69 65 73 20 74 6f  | only applies to|
000003c0  20 74 68 65 6e 20 6c 69  6e 65 20 79 6f 75 20 61  | then line you a|
000003d0  72 65 20 6f 6e 20 61 74  20 74 68 65 0d 6d 6f 6d  |re on at the.mom|
000003e0  65 6e 74 2e 0d 0d 20 20  20 20 20 20 20 20 20 20  |ent...          |
000003f0  20 20 20 20 20 20 4f 50  45 52 41 54 49 4e 47 20  |      OPERATING |
00000400  49 4e 53 54 52 55 43 54  49 4f 4e 53 0d 0d 54 68  |INSTRUCTIONS..Th|
00000410  69 73 20 69 73 20 68 6f  77 20 74 6f 20 67 65 74  |is is how to get|
00000420  20 61 20 6e 65 61 74 20  6c 69 73 74 69 6e 67 20  | a neat listing |
00000430  6f 66 20 79 6f 75 72 20  70 72 6f 67 72 61 6d 2c  |of your program,|
00000440  20 77 69 74 68 20 6c 6f  6e 67 0d 6c 69 6e 65 73  | with long.lines|
00000450  20 73 70 6c 69 74 20 75  70 20 69 6e 74 6f 20 73  | split up into s|
00000460  65 70 61 72 61 74 65 20  69 6e 73 74 72 75 63 74  |eparate instruct|
00000470  69 6f 6e 73 20 6f 6e 20  73 65 70 61 72 61 74 65  |ions on separate|
00000480  20 6c 69 6e 65 73 2c 0d  61 6e 64 20 70 72 6f 63  | lines,.and proc|
00000490  65 64 75 72 65 20 6e 61  6d 65 73 20 68 69 67 68  |edure names high|
000004a0  6c 69 67 68 74 65 64 20  69 6e 20 72 65 64 20 6f  |lighted in red o|
000004b0  6e 20 74 68 65 20 73 63  72 65 65 6e 2c 20 61 6e  |n the screen, an|
000004c0  64 0d 64 6f 75 62 6c 65  20 77 69 64 74 68 20 6f  |d.double width o|
000004d0  6e 20 74 68 65 20 70 72  69 6e 74 65 72 2e 0d 31  |n the printer..1|
000004e0  2e 20 43 48 41 49 4e 20  22 4c 69 73 74 65 72 31  |. CHAIN "Lister1|
000004f0  22 20 28 6f 72 20 69 66  20 75 73 69 6e 67 20 61  |" (or if using a|
00000500  20 4e 65 74 77 6f 72 6b  2c 20 43 48 41 49 4e 20  | Network, CHAIN |
00000510  22 4c 69 73 74 65 72 32  22 29 0d 20 0d 32 2e 20  |"Lister2"). .2. |
00000520  57 61 69 74 20 77 68 69  6c 65 20 74 68 65 20 70  |Wait while the p|
00000530  72 6f 67 72 61 6d 20 6c  6f 61 64 73 20 73 6f 6d  |rogram loads som|
00000540  65 20 64 61 74 61 20 66  72 6f 6d 20 61 20 66 69  |e data from a fi|
00000550  6c 65 0d 20 20 20 63 61  6c 6c 65 64 20 22 46 49  |le.   called "FI|
00000560  4c 45 22 2e 0d 20 0d 33  2e 20 57 68 65 6e 20 74  |LE".. .3. When t|
00000570  68 65 20 63 6f 6d 70 75  74 65 72 20 61 73 6b 73  |he computer asks|
00000580  20 79 6f 75 20 66 6f 72  20 61 20 64 69 72 65 63  | you for a direc|
00000590  74 6f 72 79 2c 20 74 79  70 65 20 69 6e 20 69 74  |tory, type in it|
000005a0  73 0d 20 20 20 6e 61 6d  65 2e 0d 20 0d 34 2e 20  |s.   name.. .4. |
000005b0  54 68 69 73 20 77 69 6c  6c 20 62 65 20 72 65 70  |This will be rep|
000005c0  65 61 74 65 64 20 75 6e  74 69 6c 20 79 6f 75 20  |eated until you |
000005d0  73 65 65 20 74 68 65 20  64 65 73 69 72 65 64 0d  |see the desired.|
000005e0  20 20 20 64 69 72 65 63  74 6f 72 79 20 63 61 74  |   directory cat|
000005f0  61 6c 6f 67 75 65 64 20  6f 6e 20 74 68 65 20 73  |alogued on the s|
00000600  63 72 65 65 6e 2e 0d 20  0d 35 2e 20 49 66 20 79  |creen.. .5. If y|
00000610  6f 75 20 61 72 65 20 69  6e 20 74 68 65 20 64 65  |ou are in the de|
00000620  73 69 72 65 64 20 64 69  72 65 63 74 6f 72 79 2c  |sired directory,|
00000630  20 70 72 65 73 73 20 72  65 74 75 72 6e 20 6f 6e  | press return on|
00000640  0d 20 20 20 69 74 73 20  6f 77 6e 2e 0d 20 0d 36  |.   its own.. .6|
00000650  2e 20 54 68 65 20 64 69  72 65 63 74 6f 72 79 20  |. The directory |
00000660  79 6f 75 20 68 61 76 65  20 73 65 6c 65 63 74 65  |you have selecte|
00000670  64 20 77 69 6c 6c 20 62  65 20 72 65 2d 64 69 73  |d will be re-dis|
00000680  70 6c 61 79 65 64 2e 0d  20 20 20 54 68 65 20 63  |played..   The c|
00000690  6f 6d 70 75 74 65 72 20  61 73 6b 73 20 79 6f 75  |omputer asks you|
000006a0  20 66 6f 72 20 74 68 65  20 6e 61 6d 65 20 6f 66  | for the name of|
000006b0  20 74 68 65 20 70 72 6f  67 72 61 6d 2e 0d 20 20  | the program..  |
000006c0  20 54 79 70 65 20 69 74  20 69 6e 2e 0d 20 0d 37  | Type it in.. .7|
000006d0  2e 20 54 68 65 20 63 6f  6d 70 75 74 65 72 20 61  |. The computer a|
000006e0  73 6b 73 20 79 6f 75 20  66 6f 72 20 61 20 73 74  |sks you for a st|
000006f0  61 72 74 69 6e 67 20 6c  69 6e 65 20 6e 75 6d 62  |arting line numb|
00000700  65 72 2e 20 54 6f 0d 20  20 20 6c 69 73 74 20 74  |er. To.   list t|
00000710  68 65 20 77 68 6f 6c 65  20 70 72 6f 67 72 61 6d  |he whole program|
00000720  2c 20 74 79 70 65 20 69  6e 20 30 2c 20 6f 72 20  |, type in 0, or |
00000730  73 69 6d 70 6c 79 20 70  72 65 73 73 0d 20 20 20  |simply press.   |
00000740  72 65 74 75 72 6e 2e 0d  20 0d 38 2e 20 54 68 65  |return.. .8. The|
00000750  20 70 72 6f 67 72 61 6d  20 61 73 6b 73 20 79 6f  | program asks yo|
00000760  75 20 66 6f 72 20 74 68  65 20 77 69 64 74 68 20  |u for the width |
00000770  79 6f 75 20 77 61 6e 74  20 74 68 65 20 6c 69 73  |you want the lis|
00000780  74 69 6e 67 0d 20 20 20  70 72 69 6e 74 65 64 2e  |ting.   printed.|
00000790  20 49 66 20 79 6f 75 27  72 65 20 75 73 69 6e 67  | If you're using|
000007a0  20 74 68 65 20 73 63 72  65 65 6e 20 6f 6e 6c 79  | the screen only|
000007b0  2c 20 49 20 73 75 67 67  65 73 74 0d 20 20 20 33  |, I suggest.   3|
000007c0  35 20 74 6f 20 33 39 2e  20 49 66 20 79 6f 75 27  |5 to 39. If you'|
000007d0  72 65 20 75 73 69 6e 67  20 74 68 65 20 70 72 69  |re using the pri|
000007e0  6e 74 65 72 2c 20 49 20  73 75 67 67 65 73 74 20  |nter, I suggest |
000007f0  36 30 0d 20 20 20 74 6f  20 37 30 2e 20 54 79 70  |60.   to 70. Typ|
00000800  65 20 69 6e 20 74 68 65  20 72 65 71 75 69 72 65  |e in the require|
00000810  64 20 77 69 64 74 68 2e  0d 20 0d 39 2e 20 54 68  |d width.. .9. Th|
00000820  65 20 63 6f 6d 70 75 74  65 72 20 61 73 6b 73 20  |e computer asks |
00000830  79 6f 75 20 77 68 65 74  68 65 72 20 79 6f 75 20  |you whether you |
00000840  77 61 6e 74 20 74 6f 20  75 73 65 20 74 68 65 0d  |want to use the.|
00000850  20 20 20 70 72 69 6e 74  65 72 2e 20 41 6e 73 77  |   printer. Answ|
00000860  65 72 20 59 45 53 20 6f  72 20 4e 4f 20 2d 20 79  |er YES or NO - y|
00000870  6f 75 20 63 61 6e 20 73  68 6f 72 74 65 6e 20 74  |ou can shorten t|
00000880  68 69 73 20 74 6f 20 59  0d 20 20 20 6f 72 20 4e  |his to Y.   or N|
00000890  2e 0d 20 0d 31 30 2e 20  49 66 20 79 6f 75 20 77  |.. .10. If you w|
000008a0  61 6e 74 20 74 6f 20 75  73 65 20 74 68 65 20 70  |ant to use the p|
000008b0  72 69 6e 74 65 72 2c 20  74 68 65 20 63 6f 6d 70  |rinter, the comp|
000008c0  75 74 65 72 20 61 73 6b  73 20 79 6f 75 0d 20 20  |uter asks you.  |
000008d0  20 20 69 66 20 79 6f 75  20 77 61 6e 74 20 74 6f  |  if you want to|
000008e0  20 70 72 69 6e 74 20 76  69 61 20 65 63 6f 6e 65  | print via econe|
000008f0  74 20 2d 20 61 6e 73 77  65 72 20 59 45 53 20 6f  |t - answer YES o|
00000900  72 20 4e 4f 2e 0d 20 0d  31 31 2e 20 54 68 65 20  |r NO.. .11. The |
00000910  63 6f 6d 70 75 74 65 72  20 6c 69 73 74 73 20 79  |computer lists y|
00000920  6f 75 72 20 70 72 6f 67  72 61 6d 20 66 6f 72 20  |our program for |
00000930  79 6f 75 2e 20 54 68 69  73 0d 20 20 20 20 6f 70  |you. This.    op|
00000940  65 72 61 74 65 73 20 6d  6f 72 65 20 73 6c 6f 77  |erates more slow|
00000950  6c 79 20 74 68 61 6e 20  61 20 6e 6f 72 6d 61 6c  |ly than a normal|
00000960  20 6c 69 73 74 69 6e 67  2c 20 62 65 63 61 75 73  | listing, becaus|
00000970  65 20 61 6c 6c 0d 20 20  20 20 74 68 65 20 63 68  |e all.    the ch|
00000980  65 63 6b 69 6e 67 20 77  68 69 63 68 20 69 73 20  |ecking which is |
00000990  6e 6f 72 6d 61 6c 6c 79  20 64 6f 6e 65 20 76 65  |normally done ve|
000009a0  72 79 20 71 75 69 63 6b  6c 79 20 69 6e 0d 20 20  |ry quickly in.  |
000009b0  20 20 6d 61 63 68 69 6e  65 20 63 6f 64 65 2c 20  |  machine code, |
000009c0  69 73 20 6e 6f 77 20 62  65 69 6e 67 20 64 6f 6e  |is now being don|
000009d0  65 20 62 79 20 4c 49 53  54 45 52 2e 0d 20 0d 31  |e by LISTER.. .1|
000009e0  32 2e 20 50 72 65 73 73  20 45 53 43 41 50 45 20  |2. Press ESCAPE |
000009f0  69 66 20 73 6f 6d 65 74  68 69 6e 67 20 67 6f 65  |if something goe|
00000a00  73 20 77 72 6f 6e 67 2e  20 54 68 65 20 66 69 6c  |s wrong. The fil|
00000a10  65 20 79 6f 75 0d 20 20  20 20 77 65 72 65 20 75  |e you.    were u|
00000a20  73 69 6e 67 20 77 69 6c  6c 20 62 65 20 63 6c 6f  |sing will be clo|
00000a30  73 65 64 20 64 6f 77 6e  2c 20 61 6e 64 20 79 6f  |sed down, and yo|
00000a40  75 20 77 69 6c 6c 20 73  6b 69 70 20 74 6f 0d 20  |u will skip to. |
00000a50  20 20 20 73 74 61 67 65  20 31 33 2e 0d 20 0d 31  |   stage 13.. .1|
00000a60  33 2e 20 57 68 65 6e 20  74 68 65 20 6c 69 73 74  |3. When the list|
00000a70  69 6e 67 20 73 74 6f 70  73 20 74 68 65 20 63 6f  |ing stops the co|
00000a80  6d 70 75 74 65 72 20 61  73 6b 73 20 79 6f 75 20  |mputer asks you |
00000a90  69 66 20 79 6f 75 0d 20  20 20 20 77 61 6e 74 20  |if you.    want |
00000aa0  61 6e 6f 74 68 65 72 20  67 6f 2e 20 41 6e 73 77  |another go. Answ|
00000ab0  65 72 20 59 45 53 20 6f  72 20 4e 4f 2e 20 49 66  |er YES or NO. If|
00000ac0  20 79 6f 75 20 61 6e 73  77 65 72 0d 20 20 20 20  | you answer.    |
00000ad0  59 45 53 20 6f 72 20 59  20 74 68 65 6e 20 79 6f  |YES or Y then yo|
00000ae0  75 20 77 69 6c 6c 20 72  65 74 75 72 6e 20 74 6f  |u will return to|
00000af0  20 74 68 65 20 73 74 61  67 65 20 6f 66 20 73 65  | the stage of se|
00000b00  6c 65 63 74 69 6e 67 0d  20 20 20 20 61 6e 6f 74  |lecting.    anot|
00000b10  68 65 72 20 64 69 72 65  63 74 6f 72 79 20 61 6e  |her directory an|
00000b20  64 20 70 72 6f 67 72 61  6d 2e 20 49 66 20 79 6f  |d program. If yo|
00000b30  75 20 61 6e 73 77 65 72  20 4e 4f 20 6f 72 20 4e  |u answer NO or N|
00000b40  0d 20 20 20 20 74 68 65  6e 20 74 68 65 20 70 72  |.    then the pr|
00000b50  6f 67 72 61 6d 20 73 74  6f 70 73 2e 0d 0d 20 20  |ogram stops...  |
00000b60  20 20 20 20 20 20 20 20  20 20 20 48 4f 57 20 54  |           HOW T|
00000b70  4f 20 43 55 53 54 4f 4d  49 53 45 20 54 48 49 53  |O CUSTOMISE THIS|
00000b80  20 50 52 4f 47 52 41 4d  0d 0d 41 73 20 69 74 20  | PROGRAM..As it |
00000b90  73 74 61 6e 64 73 2c 20  74 68 65 20 70 72 6f 67  |stands, the prog|
00000ba0  72 61 6d 73 20 4c 69 73  74 65 72 32 20 61 6e 64  |rams Lister2 and|
00000bb0  20 4c 69 73 74 65 72 33  20 68 61 76 65 20 62 65  | Lister3 have be|
00000bc0  65 6e 0d 64 65 73 69 67  6e 65 64 20 74 6f 20 77  |en.designed to w|
00000bd0  6f 72 6b 20 76 69 61 20  45 43 4f 4e 45 54 2e 20  |ork via ECONET. |
00000be0  54 68 65 79 20 72 65 71  75 69 72 65 20 61 20 6e  |They require a n|
00000bf0  75 6d 62 65 72 20 6f 66  0d 61 6c 74 65 72 61 74  |umber of.alterat|
00000c00  69 6f 6e 73 20 69 66 20  74 68 65 79 20 61 72 65  |ions if they are|
00000c10  20 74 6f 20 77 6f 72 6b  20 77 69 74 68 20 61 20  | to work with a |
00000c20  73 74 61 6e 64 61 72 64  20 44 46 53 2e 20 54 68  |standard DFS. Th|
00000c30  65 0d 76 65 72 73 69 6f  6e 20 22 4c 69 73 74 65  |e.version "Liste|
00000c40  72 31 22 20 68 61 73 20  61 6c 72 65 61 64 79 20  |r1" has already |
00000c50  68 61 64 20 74 68 65 73  65 20 6d 6f 64 69 66 69  |had these modifi|
00000c60  63 61 74 69 6f 6e 73 0d  63 61 72 72 69 65 64 20  |cations.carried |
00000c70  6f 75 74 2c 20 61 6e 64  20 69 73 20 61 76 61 69  |out, and is avai|
00000c80  6c 61 62 6c 65 20 66 6f  72 20 69 6d 6d 65 64 69  |lable for immedi|
00000c90  61 74 65 20 75 73 65 20  62 79 0d 6e 6f 6e 2d 6e  |ate use by.non-n|
00000ca0  65 74 77 6f 72 6b 20 44  46 53 20 75 73 65 72 73  |etwork DFS users|
00000cb0  2e 0d 0d 46 69 72 73 74  6c 79 2c 20 6c 69 6e 65  |...Firstly, line|
00000cc0  73 20 31 39 30 2c 20 32  30 30 20 61 6e 64 20 33  |s 190, 200 and 3|
00000cd0  30 30 20 61 72 65 20 6e  65 74 2d 73 70 65 63 69  |00 are net-speci|
00000ce0  66 69 63 2e 20 49 66 20  79 6f 75 20 61 72 65 0d  |fic. If you are.|
00000cf0  75 73 69 6e 67 20 74 68  65 20 44 46 53 20 6f 72  |using the DFS or|
00000d00  20 41 44 46 53 20 74 68  65 73 65 20 73 68 6f 75  | ADFS these shou|
00000d10  6c 64 20 62 65 20 64 65  6c 65 74 65 64 20 62 65  |ld be deleted be|
00000d20  66 6f 72 65 20 74 68 65  0d 70 72 6f 67 72 61 6d  |fore the.program|
00000d30  20 69 73 20 72 75 6e 2e  0d 0d 53 65 63 6f 6e 64  | is run...Second|
00000d40  6c 79 2c 20 77 69 74 68  20 61 20 44 46 53 20 63  |ly, with a DFS c|
00000d50  61 74 61 6c 6f 67 75 65  20 62 65 69 6e 67 20 63  |atalogue being c|
00000d60  6f 6e 66 69 6e 65 64 20  74 6f 20 33 31 20 66 69  |onfined to 31 fi|
00000d70  6c 65 73 2c 0d 74 68 65  72 65 27 73 20 6e 6f 20  |les,.there's no |
00000d80  70 6f 69 6e 74 20 69 6e  20 73 65 6c 65 63 74 69  |point in selecti|
00000d90  6e 67 20 64 69 72 65 63  74 6f 72 69 65 73 20 6f  |ng directories o|
00000da0  72 20 73 75 62 64 69 72  65 63 74 6f 72 69 65 73  |r subdirectories|
00000db0  2e 0d 54 68 65 72 65 66  6f 72 65 20 64 65 6c 65  |..Therefore dele|
00000dc0  74 65 20 6c 69 6e 65 73  20 33 39 30 20 74 6f 20  |te lines 390 to |
00000dd0  34 35 30 2e 20 44 4f 20  4e 4f 54 20 73 75 63 63  |450. DO NOT succ|
00000de0  75 6d 62 20 74 6f 20 74  68 65 0d 74 65 6d 70 74  |umb to the.tempt|
00000df0  61 74 69 6f 6e 20 74 6f  20 64 65 6c 65 74 65 20  |ation to delete |
00000e00  6c 69 6e 65 20 33 38 30  20 2d 20 69 74 20 6d 61  |line 380 - it ma|
00000e10  74 63 68 65 73 20 77 69  74 68 20 74 68 65 20 55  |tches with the U|
00000e20  4e 54 49 4c 20 61 74 0d  6c 69 6e 65 20 37 37 30  |NTIL at.line 770|
00000e30  2e 0d 0d 41 20 74 68 69  72 64 20 70 6f 69 6e 74  |...A third point|
00000e40  20 66 6f 72 20 4e 45 54  20 6f 72 20 41 44 46 53  | for NET or ADFS|
00000e50  20 75 73 65 72 73 3a 20  77 68 65 6e 20 79 6f 75  | users: when you|
00000e60  20 64 6f 77 6e 6c 6f 61  64 20 74 68 65 0d 70 72  | download the.pr|
00000e70  6f 67 72 61 6d 20 4c 49  53 54 45 52 20 61 6e 64  |ogram LISTER and|
00000e80  20 69 74 73 20 61 73 73  6f 63 69 61 74 65 64 20  | its associated |
00000e90  66 69 6c 65 20 46 49 4c  45 2c 20 74 68 65 73 65  |file FILE, these|
00000ea0  20 6d 61 79 20 77 65 6c  6c 0d 6e 6f 74 20 65 6e  | may well.not en|
00000eb0  64 20 75 70 20 69 6e 20  74 68 65 20 6d 61 69 6e  |d up in the main|
00000ec0  20 64 69 72 65 63 74 6f  72 79 2c 20 61 73 20 49  | directory, as I|
00000ed0  20 68 61 76 65 20 61 73  73 75 6d 65 64 2e 20 59  | have assumed. Y|
00000ee0  6f 75 0d 73 68 6f 75 6c  64 20 61 6c 74 65 72 20  |ou.should alter |
00000ef0  6c 69 6e 65 20 32 34 30  20 74 6f 20 66 6f 6c 6c  |line 240 to foll|
00000f00  6f 77 20 74 68 65 20 70  61 74 68 20 74 6f 20 74  |ow the path to t|
00000f10  68 65 20 64 69 72 65 63  74 6f 72 79 0d 77 68 65  |he directory.whe|
00000f20  72 65 20 79 6f 75 20 68  61 76 65 20 70 6c 61 63  |re you have plac|
00000f30  65 64 20 69 74 2e 20 46  6f 72 20 65 78 61 6d 70  |ed it. For examp|
00000f40  6c 65 3a 0d 0d 2a 44 49  52 20 24 2e 46 72 65 64  |le:..*DIR $.Fred|
00000f50  2e 50 65 72 73 6f 6e 61  6c 2e 4c 69 73 74 65 72  |.Personal.Lister|
00000f60  70 72 6f 67 0d 0d 49 66  20 79 6f 75 20 64 6f 6e  |prog..If you don|
00000f70  27 74 20 75 6e 64 65 72  73 74 61 6e 64 20 68 6f  |'t understand ho|
00000f80  77 20 70 61 74 68 6e 61  6d 65 73 20 77 6f 72 6b  |w pathnames work|
00000f90  2c 20 74 68 65 6e 20 73  65 6c 65 63 74 20 74 68  |, then select th|
00000fa0  65 0d 72 6f 6f 74 20 64  69 72 65 63 74 6f 72 79  |e.root directory|
00000fb0  20 28 20 2a 44 49 52 20  24 20 29 20 61 6e 64 20  | ( *DIR $ ) and |
00000fc0  64 6f 77 6e 6c 6f 61 64  20 46 49 4c 45 20 66 72  |download FILE fr|
00000fd0  6f 6d 20 54 65 6c 65 74  65 78 74 0d 61 67 61 69  |om Teletext.agai|
00000fe0  6e 2e 20 0d 0d 4c 61 73  74 6c 79 20 66 6f 72 20  |n. ..Lastly for |
00000ff0  4e 46 53 20 75 73 65 72  73 3a 20 49 66 20 79 6f  |NFS users: If yo|
00001000  75 20 61 72 65 20 75 73  69 6e 67 20 61 20 42 42  |u are using a BB|
00001010  43 20 6d 6f 64 65 6c 20  42 2c 20 79 6f 75 0d 77  |C model B, you.w|
00001020  69 6c 6c 20 61 6c 72 65  61 64 79 20 62 65 20 61  |ill already be a|
00001030  77 61 72 65 20 74 68 61  74 20 74 72 61 6e 73 6d  |ware that transm|
00001040  69 73 73 69 6f 6e 20 72  61 74 65 73 20 72 6f 75  |ission rates rou|
00001050  6e 64 20 74 68 65 0d 6e  65 74 77 6f 72 6b 20 63  |nd the.network c|
00001060  61 6e 20 73 6f 6d 65 74  69 6d 65 73 20 73 65 65  |an sometimes see|
00001070  6d 20 74 6f 20 62 65 20  76 65 72 79 20 73 6c 6f  |m to be very slo|
00001080  77 2e 20 54 68 69 73 20  69 73 20 62 65 63 61 75  |w. This is becau|
00001090  73 65 0d 65 61 63 68 20  62 79 74 65 20 6f 66 20  |se.each byte of |
000010a0  64 61 74 61 20 69 73 20  69 6e 64 69 76 69 64 75  |data is individu|
000010b0  61 6c 6c 79 20 70 61 63  6b 61 67 65 64 20 70 72  |ally packaged pr|
000010c0  69 6f 72 20 74 6f 0d 74  72 61 6e 73 6d 69 73 73  |ior to.transmiss|
000010d0  69 6f 6e 2e 20 4c 69 6e  65 20 32 30 30 20 72 65  |ion. Line 200 re|
000010e0  66 65 72 73 20 74 6f 20  61 20 6d 61 63 68 69 6e  |fers to a machin|
000010f0  65 20 63 6f 64 65 20 75  74 69 6c 69 74 79 0d 61  |e code utility.a|
00001100  76 61 69 6c 61 62 6c 65  20 66 72 6f 6d 20 53 4a  |vailable from SJ|
00001110  20 52 65 73 65 61 72 63  68 20 6f 72 20 4d 55 53  | Research or MUS|
00001120  45 2e 20 49 66 20 79 6f  75 20 64 6f 6e 27 74 20  |E. If you don't |
00001130  68 61 76 65 20 69 74 2c  0d 79 6f 75 20 63 61 6e  |have it,.you can|
00001140  20 64 65 6c 65 74 65 20  74 68 69 73 20 6c 69 6e  | delete this lin|
00001150  65 2c 20 61 6e 64 20 31  39 30 2c 20 33 30 30 20  |e, and 190, 300 |
00001160  61 73 20 77 65 6c 6c 2e  0d 0d 4c 69 73 74 65 72  |as well...Lister|
00001170  33 20 69 73 20 61 20 66  75 6c 6c 79 20 64 6f 63  |3 is a fully doc|
00001180  75 6d 65 6e 74 65 64 20  76 65 72 73 69 6f 6e 20  |umented version |
00001190  66 6f 72 20 74 68 6f 73  65 20 77 69 73 68 69 6e  |for those wishin|
000011a0  67 20 74 6f 0d 73 74 75  64 79 20 74 68 65 20 72  |g to.study the r|
000011b0  6f 75 74 69 6e 65 73 2e  0d                       |outines..|
000011b9
08-07-88/INSTRUC.m0
08-07-88/INSTRUC.m1
08-07-88/INSTRUC.m2
08-07-88/INSTRUC.m4
08-07-88/INSTRUC.m5