Home » Archimedes archive » Acorn User » AU 1998-02 B.adf » JFShared » !JFShared/!ShowError/!Help

!JFShared/!ShowError/!Help

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-02 B.adf » JFShared
Filename: !JFShared/!ShowError/!Help
Read OK:
File size: 0ABC bytes
Load address: 0000
Exec address: 0000
File contents
                                Show Error
                                ==========
     
Introduction
------------
This program simply opens a window showing the latest error as held in the
system variable Error$.

Usage
-----
Run the program. When an error (usually in WimpLib) occurs it will open a
window showing the error message, and line number.

Closing the window will not affect the program. It does not display an icon
on the icon bar unless -Icon is placed in the command string.

    
How it works
------------
Every 50cs the program checks the Error$ variable and if it has changed since
last time it was checked.


Help and message files
----------------------
This application is fully !Help compliant and it is recommended that when
getting to grips with it the help should be used if only to give it some
purpose! It also supports the use of MessageTrans and therefore translation
to another language or changing the messages for the fun of it is much easier
than it might have been.


<BasicLibrary$File>
-------------------
This application requires Justin Fletcher's JFShared library to function.
This can be obtained from Arcade and possibly other bulletin boards. A
version is currently being carried by Hensa, but for the latest version you
would be best off looking at Justin's web page (see below), or contacting him
by one of the other means below.


Compatibility
-------------
This application has been tested on the author's A5000, but due to the lack
of friends with Acorns has not been tested on other systems. Therefore, it
ought to work on any RO3.1 machine, and with a RO2 machine if it is
recognised in JFShared and uses no specific RO3 features.


Disclaimer
----------
The author accepts no responsibility for any problems which this application
may cause or loss of data resulting in its use. This application is Public
Domain Freeware. This means that it may be distributed, so long as no charge
other than copying costs are charged for it.


Contact
-------
Any comments, queries, donations or bug reports can be sent to Justin
Fletcher at :

E-Mail : Gerph@essex.ac.uk
URL    : http://users.essex.ac.uk/users/gerph
IRC    : On #Acorn as Gerph
Finger : finger jrflet@sunlab1.essex.ac.uk
Tel    : (01842) 813979

Snail Mail :
    Justin Fletcher
    �Galadriel�
    17b Cromwell Road,
    Weeting,
    Brandon,
    Suffolk.
    IP27 0QT


History
-------
Version 1.00 : 21 Aug 1995
               First version written
Version 1.01 : 29 Dec 1995
               Minor bug in template fixed
Version 1.02 : 23 May 1996
               If you click on the line number and you have Zap and ZapDecimal
               loaded (and ZapDWExt in !Zap) then it will move you to the line
               the error was on.
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000020  53 68 6f 77 20 45 72 72  6f 72 0a 20 20 20 20 20  |Show Error.     |
00000030  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000040  20 20 20 20 20 20 20 20  20 20 20 3d 3d 3d 3d 3d  |           =====|
00000050  3d 3d 3d 3d 3d 0a 20 20  20 20 20 0a 49 6e 74 72  |=====.     .Intr|
00000060  6f 64 75 63 74 69 6f 6e  0a 2d 2d 2d 2d 2d 2d 2d  |oduction.-------|
00000070  2d 2d 2d 2d 2d 0a 54 68  69 73 20 70 72 6f 67 72  |-----.This progr|
00000080  61 6d 20 73 69 6d 70 6c  79 20 6f 70 65 6e 73 20  |am simply opens |
00000090  61 20 77 69 6e 64 6f 77  20 73 68 6f 77 69 6e 67  |a window showing|
000000a0  20 74 68 65 20 6c 61 74  65 73 74 20 65 72 72 6f  | the latest erro|
000000b0  72 20 61 73 20 68 65 6c  64 20 69 6e 20 74 68 65  |r as held in the|
000000c0  0a 73 79 73 74 65 6d 20  76 61 72 69 61 62 6c 65  |.system variable|
000000d0  20 45 72 72 6f 72 24 2e  0a 0a 55 73 61 67 65 0a  | Error$...Usage.|
000000e0  2d 2d 2d 2d 2d 0a 52 75  6e 20 74 68 65 20 70 72  |-----.Run the pr|
000000f0  6f 67 72 61 6d 2e 20 57  68 65 6e 20 61 6e 20 65  |ogram. When an e|
00000100  72 72 6f 72 20 28 75 73  75 61 6c 6c 79 20 69 6e  |rror (usually in|
00000110  20 57 69 6d 70 4c 69 62  29 20 6f 63 63 75 72 73  | WimpLib) occurs|
00000120  20 69 74 20 77 69 6c 6c  20 6f 70 65 6e 20 61 0a  | it will open a.|
00000130  77 69 6e 64 6f 77 20 73  68 6f 77 69 6e 67 20 74  |window showing t|
00000140  68 65 20 65 72 72 6f 72  20 6d 65 73 73 61 67 65  |he error message|
00000150  2c 20 61 6e 64 20 6c 69  6e 65 20 6e 75 6d 62 65  |, and line numbe|
00000160  72 2e 0a 0a 43 6c 6f 73  69 6e 67 20 74 68 65 20  |r...Closing the |
00000170  77 69 6e 64 6f 77 20 77  69 6c 6c 20 6e 6f 74 20  |window will not |
00000180  61 66 66 65 63 74 20 74  68 65 20 70 72 6f 67 72  |affect the progr|
00000190  61 6d 2e 20 49 74 20 64  6f 65 73 20 6e 6f 74 20  |am. It does not |
000001a0  64 69 73 70 6c 61 79 20  61 6e 20 69 63 6f 6e 0a  |display an icon.|
000001b0  6f 6e 20 74 68 65 20 69  63 6f 6e 20 62 61 72 20  |on the icon bar |
000001c0  75 6e 6c 65 73 73 20 2d  49 63 6f 6e 20 69 73 20  |unless -Icon is |
000001d0  70 6c 61 63 65 64 20 69  6e 20 74 68 65 20 63 6f  |placed in the co|
000001e0  6d 6d 61 6e 64 20 73 74  72 69 6e 67 2e 0a 0a 20  |mmand string... |
000001f0  20 20 20 0a 48 6f 77 20  69 74 20 77 6f 72 6b 73  |   .How it works|
00000200  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 45 76  |.------------.Ev|
00000210  65 72 79 20 35 30 63 73  20 74 68 65 20 70 72 6f  |ery 50cs the pro|
00000220  67 72 61 6d 20 63 68 65  63 6b 73 20 74 68 65 20  |gram checks the |
00000230  45 72 72 6f 72 24 20 76  61 72 69 61 62 6c 65 20  |Error$ variable |
00000240  61 6e 64 20 69 66 20 69  74 20 68 61 73 20 63 68  |and if it has ch|
00000250  61 6e 67 65 64 20 73 69  6e 63 65 0a 6c 61 73 74  |anged since.last|
00000260  20 74 69 6d 65 20 69 74  20 77 61 73 20 63 68 65  | time it was che|
00000270  63 6b 65 64 2e 0a 0a 0a  48 65 6c 70 20 61 6e 64  |cked....Help and|
00000280  20 6d 65 73 73 61 67 65  20 66 69 6c 65 73 0a 2d  | message files.-|
00000290  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000002a0  2d 2d 2d 2d 2d 0a 54 68  69 73 20 61 70 70 6c 69  |-----.This appli|
000002b0  63 61 74 69 6f 6e 20 69  73 20 66 75 6c 6c 79 20  |cation is fully |
000002c0  21 48 65 6c 70 20 63 6f  6d 70 6c 69 61 6e 74 20  |!Help compliant |
000002d0  61 6e 64 20 69 74 20 69  73 20 72 65 63 6f 6d 6d  |and it is recomm|
000002e0  65 6e 64 65 64 20 74 68  61 74 20 77 68 65 6e 0a  |ended that when.|
000002f0  67 65 74 74 69 6e 67 20  74 6f 20 67 72 69 70 73  |getting to grips|
00000300  20 77 69 74 68 20 69 74  20 74 68 65 20 68 65 6c  | with it the hel|
00000310  70 20 73 68 6f 75 6c 64  20 62 65 20 75 73 65 64  |p should be used|
00000320  20 69 66 20 6f 6e 6c 79  20 74 6f 20 67 69 76 65  | if only to give|
00000330  20 69 74 20 73 6f 6d 65  0a 70 75 72 70 6f 73 65  | it some.purpose|
00000340  21 20 49 74 20 61 6c 73  6f 20 73 75 70 70 6f 72  |! It also suppor|
00000350  74 73 20 74 68 65 20 75  73 65 20 6f 66 20 4d 65  |ts the use of Me|
00000360  73 73 61 67 65 54 72 61  6e 73 20 61 6e 64 20 74  |ssageTrans and t|
00000370  68 65 72 65 66 6f 72 65  20 74 72 61 6e 73 6c 61  |herefore transla|
00000380  74 69 6f 6e 0a 74 6f 20  61 6e 6f 74 68 65 72 20  |tion.to another |
00000390  6c 61 6e 67 75 61 67 65  20 6f 72 20 63 68 61 6e  |language or chan|
000003a0  67 69 6e 67 20 74 68 65  20 6d 65 73 73 61 67 65  |ging the message|
000003b0  73 20 66 6f 72 20 74 68  65 20 66 75 6e 20 6f 66  |s for the fun of|
000003c0  20 69 74 20 69 73 20 6d  75 63 68 20 65 61 73 69  | it is much easi|
000003d0  65 72 0a 74 68 61 6e 20  69 74 20 6d 69 67 68 74  |er.than it might|
000003e0  20 68 61 76 65 20 62 65  65 6e 2e 0a 0a 0a 3c 42  | have been....<B|
000003f0  61 73 69 63 4c 69 62 72  61 72 79 24 46 69 6c 65  |asicLibrary$File|
00000400  3e 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |>.--------------|
00000410  2d 2d 2d 2d 2d 0a 54 68  69 73 20 61 70 70 6c 69  |-----.This appli|
00000420  63 61 74 69 6f 6e 20 72  65 71 75 69 72 65 73 20  |cation requires |
00000430  4a 75 73 74 69 6e 20 46  6c 65 74 63 68 65 72 27  |Justin Fletcher'|
00000440  73 20 4a 46 53 68 61 72  65 64 20 6c 69 62 72 61  |s JFShared libra|
00000450  72 79 20 74 6f 20 66 75  6e 63 74 69 6f 6e 2e 0a  |ry to function..|
00000460  54 68 69 73 20 63 61 6e  20 62 65 20 6f 62 74 61  |This can be obta|
00000470  69 6e 65 64 20 66 72 6f  6d 20 41 72 63 61 64 65  |ined from Arcade|
00000480  20 61 6e 64 20 70 6f 73  73 69 62 6c 79 20 6f 74  | and possibly ot|
00000490  68 65 72 20 62 75 6c 6c  65 74 69 6e 20 62 6f 61  |her bulletin boa|
000004a0  72 64 73 2e 20 41 0a 76  65 72 73 69 6f 6e 20 69  |rds. A.version i|
000004b0  73 20 63 75 72 72 65 6e  74 6c 79 20 62 65 69 6e  |s currently bein|
000004c0  67 20 63 61 72 72 69 65  64 20 62 79 20 48 65 6e  |g carried by Hen|
000004d0  73 61 2c 20 62 75 74 20  66 6f 72 20 74 68 65 20  |sa, but for the |
000004e0  6c 61 74 65 73 74 20 76  65 72 73 69 6f 6e 20 79  |latest version y|
000004f0  6f 75 0a 77 6f 75 6c 64  20 62 65 20 62 65 73 74  |ou.would be best|
00000500  20 6f 66 66 20 6c 6f 6f  6b 69 6e 67 20 61 74 20  | off looking at |
00000510  4a 75 73 74 69 6e 27 73  20 77 65 62 20 70 61 67  |Justin's web pag|
00000520  65 20 28 73 65 65 20 62  65 6c 6f 77 29 2c 20 6f  |e (see below), o|
00000530  72 20 63 6f 6e 74 61 63  74 69 6e 67 20 68 69 6d  |r contacting him|
00000540  0a 62 79 20 6f 6e 65 20  6f 66 20 74 68 65 20 6f  |.by one of the o|
00000550  74 68 65 72 20 6d 65 61  6e 73 20 62 65 6c 6f 77  |ther means below|
00000560  2e 0a 0a 0a 43 6f 6d 70  61 74 69 62 69 6c 69 74  |....Compatibilit|
00000570  79 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |y.-------------.|
00000580  54 68 69 73 20 61 70 70  6c 69 63 61 74 69 6f 6e  |This application|
00000590  20 68 61 73 20 62 65 65  6e 20 74 65 73 74 65 64  | has been tested|
000005a0  20 6f 6e 20 74 68 65 20  61 75 74 68 6f 72 27 73  | on the author's|
000005b0  20 41 35 30 30 30 2c 20  62 75 74 20 64 75 65 20  | A5000, but due |
000005c0  74 6f 20 74 68 65 20 6c  61 63 6b 0a 6f 66 20 66  |to the lack.of f|
000005d0  72 69 65 6e 64 73 20 77  69 74 68 20 41 63 6f 72  |riends with Acor|
000005e0  6e 73 20 68 61 73 20 6e  6f 74 20 62 65 65 6e 20  |ns has not been |
000005f0  74 65 73 74 65 64 20 6f  6e 20 6f 74 68 65 72 20  |tested on other |
00000600  73 79 73 74 65 6d 73 2e  20 54 68 65 72 65 66 6f  |systems. Therefo|
00000610  72 65 2c 20 69 74 0a 6f  75 67 68 74 20 74 6f 20  |re, it.ought to |
00000620  77 6f 72 6b 20 6f 6e 20  61 6e 79 20 52 4f 33 2e  |work on any RO3.|
00000630  31 20 6d 61 63 68 69 6e  65 2c 20 61 6e 64 20 77  |1 machine, and w|
00000640  69 74 68 20 61 20 52 4f  32 20 6d 61 63 68 69 6e  |ith a RO2 machin|
00000650  65 20 69 66 20 69 74 20  69 73 0a 72 65 63 6f 67  |e if it is.recog|
00000660  6e 69 73 65 64 20 69 6e  20 4a 46 53 68 61 72 65  |nised in JFShare|
00000670  64 20 61 6e 64 20 75 73  65 73 20 6e 6f 20 73 70  |d and uses no sp|
00000680  65 63 69 66 69 63 20 52  4f 33 20 66 65 61 74 75  |ecific RO3 featu|
00000690  72 65 73 2e 0a 0a 0a 44  69 73 63 6c 61 69 6d 65  |res....Disclaime|
000006a0  72 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 54 68 65  |r.----------.The|
000006b0  20 61 75 74 68 6f 72 20  61 63 63 65 70 74 73 20  | author accepts |
000006c0  6e 6f 20 72 65 73 70 6f  6e 73 69 62 69 6c 69 74  |no responsibilit|
000006d0  79 20 66 6f 72 20 61 6e  79 20 70 72 6f 62 6c 65  |y for any proble|
000006e0  6d 73 20 77 68 69 63 68  20 74 68 69 73 20 61 70  |ms which this ap|
000006f0  70 6c 69 63 61 74 69 6f  6e 0a 6d 61 79 20 63 61  |plication.may ca|
00000700  75 73 65 20 6f 72 20 6c  6f 73 73 20 6f 66 20 64  |use or loss of d|
00000710  61 74 61 20 72 65 73 75  6c 74 69 6e 67 20 69 6e  |ata resulting in|
00000720  20 69 74 73 20 75 73 65  2e 20 54 68 69 73 20 61  | its use. This a|
00000730  70 70 6c 69 63 61 74 69  6f 6e 20 69 73 20 50 75  |pplication is Pu|
00000740  62 6c 69 63 0a 44 6f 6d  61 69 6e 20 46 72 65 65  |blic.Domain Free|
00000750  77 61 72 65 2e 20 54 68  69 73 20 6d 65 61 6e 73  |ware. This means|
00000760  20 74 68 61 74 20 69 74  20 6d 61 79 20 62 65 20  | that it may be |
00000770  64 69 73 74 72 69 62 75  74 65 64 2c 20 73 6f 20  |distributed, so |
00000780  6c 6f 6e 67 20 61 73 20  6e 6f 20 63 68 61 72 67  |long as no charg|
00000790  65 0a 6f 74 68 65 72 20  74 68 61 6e 20 63 6f 70  |e.other than cop|
000007a0  79 69 6e 67 20 63 6f 73  74 73 20 61 72 65 20 63  |ying costs are c|
000007b0  68 61 72 67 65 64 20 66  6f 72 20 69 74 2e 0a 0a  |harged for it...|
000007c0  0a 43 6f 6e 74 61 63 74  0a 2d 2d 2d 2d 2d 2d 2d  |.Contact.-------|
000007d0  0a 41 6e 79 20 63 6f 6d  6d 65 6e 74 73 2c 20 71  |.Any comments, q|
000007e0  75 65 72 69 65 73 2c 20  64 6f 6e 61 74 69 6f 6e  |ueries, donation|
000007f0  73 20 6f 72 20 62 75 67  20 72 65 70 6f 72 74 73  |s or bug reports|
00000800  20 63 61 6e 20 62 65 20  73 65 6e 74 20 74 6f 20  | can be sent to |
00000810  4a 75 73 74 69 6e 0a 46  6c 65 74 63 68 65 72 20  |Justin.Fletcher |
00000820  61 74 20 3a 0a 0a 45 2d  4d 61 69 6c 20 3a 20 47  |at :..E-Mail : G|
00000830  65 72 70 68 40 65 73 73  65 78 2e 61 63 2e 75 6b  |erph@essex.ac.uk|
00000840  0a 55 52 4c 20 20 20 20  3a 20 68 74 74 70 3a 2f  |.URL    : http:/|
00000850  2f 75 73 65 72 73 2e 65  73 73 65 78 2e 61 63 2e  |/users.essex.ac.|
00000860  75 6b 2f 75 73 65 72 73  2f 67 65 72 70 68 0a 49  |uk/users/gerph.I|
00000870  52 43 20 20 20 20 3a 20  4f 6e 20 23 41 63 6f 72  |RC    : On #Acor|
00000880  6e 20 61 73 20 47 65 72  70 68 0a 46 69 6e 67 65  |n as Gerph.Finge|
00000890  72 20 3a 20 66 69 6e 67  65 72 20 6a 72 66 6c 65  |r : finger jrfle|
000008a0  74 40 73 75 6e 6c 61 62  31 2e 65 73 73 65 78 2e  |t@sunlab1.essex.|
000008b0  61 63 2e 75 6b 0a 54 65  6c 20 20 20 20 3a 20 28  |ac.uk.Tel    : (|
000008c0  30 31 38 34 32 29 20 38  31 33 39 37 39 0a 0a 53  |01842) 813979..S|
000008d0  6e 61 69 6c 20 4d 61 69  6c 20 3a 0a 20 20 20 20  |nail Mail :.    |
000008e0  4a 75 73 74 69 6e 20 46  6c 65 74 63 68 65 72 0a  |Justin Fletcher.|
000008f0  20 20 20 20 94 47 61 6c  61 64 72 69 65 6c 95 0a  |    .Galadriel..|
00000900  20 20 20 20 31 37 62 20  43 72 6f 6d 77 65 6c 6c  |    17b Cromwell|
00000910  20 52 6f 61 64 2c 0a 20  20 20 20 57 65 65 74 69  | Road,.    Weeti|
00000920  6e 67 2c 0a 20 20 20 20  42 72 61 6e 64 6f 6e 2c  |ng,.    Brandon,|
00000930  0a 20 20 20 20 53 75 66  66 6f 6c 6b 2e 0a 20 20  |.    Suffolk..  |
00000940  20 20 49 50 32 37 20 30  51 54 0a 0a 0a 48 69 73  |  IP27 0QT...His|
00000950  74 6f 72 79 0a 2d 2d 2d  2d 2d 2d 2d 0a 56 65 72  |tory.-------.Ver|
00000960  73 69 6f 6e 20 31 2e 30  30 20 3a 20 32 31 20 41  |sion 1.00 : 21 A|
00000970  75 67 20 31 39 39 35 0a  20 20 20 20 20 20 20 20  |ug 1995.        |
00000980  20 20 20 20 20 20 20 46  69 72 73 74 20 76 65 72  |       First ver|
00000990  73 69 6f 6e 20 77 72 69  74 74 65 6e 0a 56 65 72  |sion written.Ver|
000009a0  73 69 6f 6e 20 31 2e 30  31 20 3a 20 32 39 20 44  |sion 1.01 : 29 D|
000009b0  65 63 20 31 39 39 35 0a  20 20 20 20 20 20 20 20  |ec 1995.        |
000009c0  20 20 20 20 20 20 20 4d  69 6e 6f 72 20 62 75 67  |       Minor bug|
000009d0  20 69 6e 20 74 65 6d 70  6c 61 74 65 20 66 69 78  | in template fix|
000009e0  65 64 0a 56 65 72 73 69  6f 6e 20 31 2e 30 32 20  |ed.Version 1.02 |
000009f0  3a 20 32 33 20 4d 61 79  20 31 39 39 36 0a 20 20  |: 23 May 1996.  |
00000a00  20 20 20 20 20 20 20 20  20 20 20 20 20 49 66 20  |             If |
00000a10  79 6f 75 20 63 6c 69 63  6b 20 6f 6e 20 74 68 65  |you click on the|
00000a20  20 6c 69 6e 65 20 6e 75  6d 62 65 72 20 61 6e 64  | line number and|
00000a30  20 79 6f 75 20 68 61 76  65 20 5a 61 70 20 61 6e  | you have Zap an|
00000a40  64 20 5a 61 70 44 65 63  69 6d 61 6c 0a 20 20 20  |d ZapDecimal.   |
00000a50  20 20 20 20 20 20 20 20  20 20 20 20 6c 6f 61 64  |            load|
00000a60  65 64 20 28 61 6e 64 20  5a 61 70 44 57 45 78 74  |ed (and ZapDWExt|
00000a70  20 69 6e 20 21 5a 61 70  29 20 74 68 65 6e 20 69  | in !Zap) then i|
00000a80  74 20 77 69 6c 6c 20 6d  6f 76 65 20 79 6f 75 20  |t will move you |
00000a90  74 6f 20 74 68 65 20 6c  69 6e 65 0a 20 20 20 20  |to the line.    |
00000aa0  20 20 20 20 20 20 20 20  20 20 20 74 68 65 20 65  |           the e|
00000ab0  72 72 6f 72 20 77 61 73  20 6f 6e 2e              |rror was on.|
00000abc