annotate admin/notes/exit-value @ 58914:f55019d052ed

* replace.el (query-replace-highlight): Add new value `isearch' that allows query replacement to use isearch highlighting. Change type from `boolean' to `choice'. Doc fix. (replace-highlight, replace-dehighlight, perform-replace): Use isearch highlighting if query-replace-highlight eq `isearch'.
author Juri Linkov <juri@jurta.org>
date Sun, 12 Dec 2004 22:30:41 +0000
parents dc9bd6dd0d8d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
55463
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
1 ttn 2004-05-09
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
2
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
3 The exit value of a program returning to the shell on unixoid systems is
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
4 typically 0 for success, and non-0 (such as 1) for failure. For vms it is
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
5 odd (1,3,5...) for success, even (0,2,4...) for failure.
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
6
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
7 This holds from the point of view of the "shell" (in quotes because vms has a
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
8 different dispatch model that is not explained further here).
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
9
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
10 From the point of view of the program, nowadays stdlib.h on both type of
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
11 systems provides macros `EXIT_SUCCESS' and `EXIT_FAILURE' that should DTRT.
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
12
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
13 NB: The numerical values of these macros DO NOT need to fulfill the the exit
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
14 value requirements outlined in the first paragraph! That is the job of the
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
15 `exit' function. Thus, this kind of construct shows misunderstanding:
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
16
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
17 #ifdef VMS
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
18 exit (1);
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
19 #else
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
20 exit (0);
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
21 #endif
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
22
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
23 Values aside from EXIT_SUCCESS and EXIT_FAILURE are tricky.
55552
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
24
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
25
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
26
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
27 ttn 2004-05-12
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
28
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
29 Values aside from EXIT_SUCCESS and EXIT_FAILURE can be used to indicate
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
30 finer gradations of failure. If this is the only information available
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
31 to the caller, clamping such values to EXIT_FAILURE loses information.
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
32 If there are other ways to indicate the problem to the caller (such as
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
33 a message to stderr) it may be ok to clamp. In all cases, it is the
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
34 relationship between the program and its caller that must be examined.
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
35 [Insert ZAMM quote here.]