Exception.st
author Stefan Vogel <sv@exept.de>
Mon, 22 Jun 2015 11:33:37 +0200
branchexpecco_2_7_5_branch
changeset 18499 b132ac7c9d6a
parent 7630 fced37c5cccc
child 17711 39faaaf888b4
child 20093 169c6926169a
permissions -rw-r--r--
GLIBC 2.12 compatibility
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
"
a27a279701f8 Initial revision
claus
parents:
diff changeset
    12
6206
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 4501
diff changeset
    13
"{ Package: 'stx:libbasic' }"
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 4501
diff changeset
    14
4481
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    15
GenericException subclass:#Exception
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    16
	instanceVariableNames:''
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    17
	classVariableNames:''
1118
1037616d9add ignore unhandled querySignals
Claus Gittinger <cg@exept.de>
parents: 1038
diff changeset
    18
	poolDictionaries:''
1037616d9add ignore unhandled querySignals
Claus Gittinger <cg@exept.de>
parents: 1038
diff changeset
    19
	category:'Kernel-Exceptions'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    20
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    21
1953
c8a3af54acb3 unhandled querySignals should return nil
Claus Gittinger <cg@exept.de>
parents: 1710
diff changeset
    22
!Exception class methodsFor:'documentation'!
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    23
88
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    24
copyright
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    25
"
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    26
 COPYRIGHT (c) 1993 by Claus Gittinger
171
129f0e2e23df handling now in Exception
claus
parents: 142
diff changeset
    27
	      All Rights Reserved
88
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    28
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    29
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    30
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    32
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    33
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    34
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    35
"
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    36
!
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    37
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    38
documentation
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    39
"
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    40
    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
    41
    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
    42
    errors in the exception system itself.
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    43
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    44
    Think twice before subclassing directly from Exception. Consider to subclass
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    45
    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
    46
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    47
    You should also handle Error instead of Exception, since breakpoints,
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    48
    halts and user informational messages are processed as exceptions.
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    49
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    50
    The behavior is in GenericException, to allow for some exceptions 
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    51
    (UnhandledExceptionException and UserInterrupts) not to be a child of Exception.
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    52
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    53
    [see also:]
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    54
        Error
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    55
        Warning
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    56
        UserNotification
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    57
        Notifcation
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    58
        Signal
2174
3c6300f27f74 example section;
Claus Gittinger <cg@exept.de>
parents: 2081
diff changeset
    59
"
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    60
! !
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    61
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    62
!Exception class methodsFor:'documentation'!
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    63
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    64
version
7630
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    65
    ^ '$Header: /cvs/stx/stx/libbasic/Exception.st,v 1.82 2003-10-07 13:25:24 stefan Exp $'
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    66
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    67
! !