Exception.st
author Jan Vrany <jan.vrany@fit.cvut.cz>
Mon, 31 Oct 2011 22:19:21 +0000
branchjv
changeset 17892 d86c8bd5ece3
parent 17869 9610c6c94e71
child 17910 8d796ca8bd1d
permissions -rw-r--r--
Merged with CVS
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     1
"
a27a279701f8 Initial revision
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1993 by Claus Gittinger
171
129f0e2e23df handling now in Exception
claus
parents: 142
diff changeset
     3
	      All Rights Reserved
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     4
a27a279701f8 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
a27a279701f8 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
a27a279701f8 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
a27a279701f8 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
a27a279701f8 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
a27a279701f8 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    11
"
6206
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 4501
diff changeset
    12
"{ Package: 'stx:libbasic' }"
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 4501
diff changeset
    13
4481
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    14
GenericException subclass:#Exception
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    15
	instanceVariableNames:''
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    16
	classVariableNames:''
1118
1037616d9add ignore unhandled querySignals
Claus Gittinger <cg@exept.de>
parents: 1038
diff changeset
    17
	poolDictionaries:''
1037616d9add ignore unhandled querySignals
Claus Gittinger <cg@exept.de>
parents: 1038
diff changeset
    18
	category:'Kernel-Exceptions'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    19
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    20
1953
c8a3af54acb3 unhandled querySignals should return nil
Claus Gittinger <cg@exept.de>
parents: 1710
diff changeset
    21
!Exception class methodsFor:'documentation'!
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    22
88
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    23
copyright
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    24
"
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    25
 COPYRIGHT (c) 1993 by Claus Gittinger
171
129f0e2e23df handling now in Exception
claus
parents: 142
diff changeset
    26
	      All Rights Reserved
88
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    27
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    28
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    29
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    30
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    31
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    32
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    33
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    34
"
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    35
!
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    36
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    37
documentation
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    38
"
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    39
    Exception is an abstract superclass of all exceptions in the system,
7630
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    40
    which are not generated by user actions (e.g. keyboard interrupts) nor by
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    41
    errors in the exception system itself.
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    42
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    43
    Think twice before subclassing directly from Exception. Consider to subclass
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    44
    from one of Exceptions subclasses Error, Warning, UserNotification...
7630
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    45
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    46
    You should also handle Error instead of Exception, since breakpoints,
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    47
    halts and user informational messages are processed as exceptions.
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    48
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    49
    The behavior is in GenericException, to allow for some exceptions 
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    50
    (UnhandledExceptionException and UserInterrupts) not to be a child of Exception.
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    51
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    52
    [see also:]
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    53
        Error
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    54
        Warning
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    55
        UserNotification
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    56
        Notifcation
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    57
        Signal
2174
3c6300f27f74 example section;
Claus Gittinger <cg@exept.de>
parents: 2081
diff changeset
    58
"
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    59
! !
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    60
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    61
!Exception class methodsFor:'documentation'!
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    62
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    63
version
17892
d86c8bd5ece3 Merged with CVS
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17869
diff changeset
    64
    ^ '$Header: /cvs/stx/stx/libbasic/Exception.st,v 1.82 2003/10/07 13:25:24 stefan Exp $'
17865
598963c6ff8e Recommited from itself
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17846
diff changeset
    65
598963c6ff8e Recommited from itself
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17846
diff changeset
    66
!
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    67
17865
598963c6ff8e Recommited from itself
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17846
diff changeset
    68
version_SVN
17892
d86c8bd5ece3 Merged with CVS
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17869
diff changeset
    69
    ^ '$Id: Exception.st 10729 2011-10-31 22:19:21Z vranyj1 $'
17846
24edc476ac18 Merged with /trunk
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17845
diff changeset
    70
! !
17892
d86c8bd5ece3 Merged with CVS
Jan Vrany <jan.vrany@fit.cvut.cz>
parents: 17869
diff changeset
    71