Mercurial > emacs
annotate src/s/template.h @ 110361:4d54e23aa31e
Fix typos in comments and ChangeLogs.
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Tue, 14 Sep 2010 22:32:35 +0200 |
parents | 88810df348ab |
children | a8b56c7dbb62 |
rev | line source |
---|---|
456 | 1 /* Template for system description header files. |
2 This file describes the parameters that system description files | |
3 should define or not. | |
108379
203aa49071bf
Move MAIL_USE_FLOCK, MAIL_USE_LOCKF, BLESSMAIL_TARGET from cpp to configure.
Glenn Morris <rgm@gnu.org>
parents:
108018
diff
changeset
|
4 |
203aa49071bf
Move MAIL_USE_FLOCK, MAIL_USE_LOCKF, BLESSMAIL_TARGET from cpp to configure.
Glenn Morris <rgm@gnu.org>
parents:
108018
diff
changeset
|
5 Copyright (C) 1985, 1986, 1992, 1999, 2001, 2002, 2003, 2004, 2005, |
203aa49071bf
Move MAIL_USE_FLOCK, MAIL_USE_LOCKF, BLESSMAIL_TARGET from cpp to configure.
Glenn Morris <rgm@gnu.org>
parents:
108018
diff
changeset
|
6 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. |
456 | 7 |
8 This file is part of GNU Emacs. | |
9 | |
94715
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
10 GNU Emacs is free software: you can redistribute it and/or modify |
456 | 11 it under the terms of the GNU General Public License as published by |
94715
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
12 the Free Software Foundation, either version 3 of the License, or |
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
13 (at your option) any later version. |
456 | 14 |
15 GNU Emacs is distributed in the hope that it will be useful, | |
16 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 GNU General Public License for more details. | |
19 | |
20 You should have received a copy of the GNU General Public License | |
94715
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
21 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */ |
456 | 22 |
23 | |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
24 /* Define symbols to identify the version of Unix this is. |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
25 Define all the symbols that apply correctly. */ |
456 | 26 |
27 /* #define USG5 */ | |
28 /* #define USG */ | |
29 /* #define HPUX */ | |
30 /* #define BSD4_2 */ | |
31 /* #define BSD4_3 */ | |
16221 | 32 /* #define BSD_SYSTEM */ |
456 | 33 |
34 /* SYSTEM_TYPE should indicate the kind of system you are using. | |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
35 It sets the Lisp variable system-type. */ |
456 | 36 |
37 #define SYSTEM_TYPE "berkeley-unix" | |
38 | |
39 /* Emacs can read input using SIGIO and buffering characters itself, | |
40 or using CBREAK mode and making C-g cause SIGINT. | |
41 The choice is controlled by the variable interrupt_input. | |
2734
a0f174dc6ac5
* s/template.h: Explain the relative significance of the SIGIO and
Jim Blandy <jimb@redhat.com>
parents:
2642
diff
changeset
|
42 |
456 | 43 Define INTERRUPT_INPUT to make interrupt_input = 1 the default (use SIGIO) |
44 | |
26090 | 45 Emacs uses the presence or absence of the SIGIO and BROKEN_SIGIO macros |
46 to indicate whether or not signal-driven I/O is possible. It uses | |
2734
a0f174dc6ac5
* s/template.h: Explain the relative significance of the SIGIO and
Jim Blandy <jimb@redhat.com>
parents:
2642
diff
changeset
|
47 INTERRUPT_INPUT to decide whether to use it by default. |
a0f174dc6ac5
* s/template.h: Explain the relative significance of the SIGIO and
Jim Blandy <jimb@redhat.com>
parents:
2642
diff
changeset
|
48 |
456 | 49 SIGIO can be used only on systems that implement it (4.2 and 4.3). |
3591
507f64624555
Apply typo patches from Paul Eggert.
Jim Blandy <jimb@redhat.com>
parents:
3053
diff
changeset
|
50 CBREAK mode has two disadvantages |
456 | 51 1) At least in 4.2, it is impossible to handle the Meta key properly. |
52 I hear that in system V this problem does not exist. | |
53 2) Control-G causes output to be discarded. | |
54 I do not know whether this can be fixed in system V. | |
55 | |
56 Another method of doing input is planned but not implemented. | |
57 It would have Emacs fork off a separate process | |
58 to read the input and send it to the true Emacs process | |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
59 through a pipe. */ |
456 | 60 #define INTERRUPT_INPUT |
61 | |
62 /* Letter to use in finding device name of first pty, | |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
63 if system supports pty's. 'a' means it is /dev/ptya0. */ |
456 | 64 #define FIRST_PTY_LETTER 'a' |
65 | |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
66 /* Define HAVE_TERMIOS if the system provides POSIX-style |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
67 functions and macros for terminal control. |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
68 |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
69 Define HAVE_TERMIO if the system provides sysV-style ioctls |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
70 for terminal control. |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
71 |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
72 Do not define both. HAVE_TERMIOS is preferred, if it is |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
73 supported on your system. */ |
620 | 74 |
75 #define HAVE_TERMIOS | |
2917
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
76 /* #define HAVE_TERMIO */ |
559 | 77 |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
78 /* Define HAVE_PTYS if the system supports pty devices. */ |
456 | 79 #define HAVE_PTYS |
80 | |
96923
d89afa2b4c2f
* config.in: Regenerate.
Dan Nicolaescu <dann@ics.uci.edu>
parents:
96729
diff
changeset
|
81 /* subprocesses should be undefined if you do NOT want to |
456 | 82 have code for asynchronous subprocesses |
83 (as used in M-x compile and M-x shell). | |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
84 Currently only MSDOS does not support this. */ |
456 | 85 |
96923
d89afa2b4c2f
* config.in: Regenerate.
Dan Nicolaescu <dann@ics.uci.edu>
parents:
96729
diff
changeset
|
86 /* #undef subprocesses */ |
456 | 87 |
88 /* Define CLASH_DETECTION if you want lock files to be written | |
89 so that Emacs can tell instantly when you try to modify | |
90 a file that someone else has modified in his Emacs. */ | |
91 #define CLASH_DETECTION | |
92 | |
514 | 93 /* Define this if your operating system declares signal handlers to |
94 have a type other than the usual. `The usual' is `void' for ANSI C | |
95 systems (i.e. when the __STDC__ macro is defined), and `int' for | |
96 pre-ANSI systems. If you're using GCC on an older system, __STDC__ | |
97 will be defined, but the system's include files will still say that | |
98 signal returns int or whatever; in situations like that, define | |
99 this to be what the system's include files want. */ | |
100 /* #define SIGTYPE int */ | |
101 | |
2642
05d85e55a081
* emacs.c (SEPCHAR): Instead of defining this to be ',' on VMS and
Jim Blandy <jimb@redhat.com>
parents:
2114
diff
changeset
|
102 /* If the character used to separate elements of the executable path |
05d85e55a081
* emacs.c (SEPCHAR): Instead of defining this to be ',' on VMS and
Jim Blandy <jimb@redhat.com>
parents:
2114
diff
changeset
|
103 is not ':', #define this to be the appropriate character constant. */ |
05d85e55a081
* emacs.c (SEPCHAR): Instead of defining this to be ',' on VMS and
Jim Blandy <jimb@redhat.com>
parents:
2114
diff
changeset
|
104 /* #define SEPCHAR ':' */ |
05d85e55a081
* emacs.c (SEPCHAR): Instead of defining this to be ',' on VMS and
Jim Blandy <jimb@redhat.com>
parents:
2114
diff
changeset
|
105 |
3053
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
106 /* ============================================================ */ |
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
107 |
108511
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
108 /* Here, add any special hacks needed to make Emacs work on this |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
109 system. For example, you might define certain system call names |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
110 that don't exist on your system, or that do different things on |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
111 your system and must be used only through an encapsulation (which |
f8e62c2bf3e9
Reformat some comments in src/s/*.h.
Glenn Morris <rgm@gnu.org>
parents:
108379
diff
changeset
|
112 you should place, by convention, in sysdep.c). */ |
3053
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
113 |
25032 | 114 /* If the system's imake configuration file defines `NeedWidePrototypes' |
115 as `NO', we must define NARROWPROTO manually. Such a define is | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
31600
diff
changeset
|
116 generated in the Makefile generated by `xmkmf'. If we don't |
25032 | 117 define NARROWPROTO, we will see the wrong function prototypes |
118 for X functions taking float or double parameters. */ | |
119 | |
120 /* #define NARROWPROTO 1 */ | |
121 | |
3053
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
122 /* ============================================================ */ |
2114
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
123 |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
124 /* After adding support for a new system, modify the large case |
108639
cfaca963d899
* src/[ms]/template.h: Comments.
Glenn Morris <rgm@gnu.org>
parents:
108511
diff
changeset
|
125 statement in configure.in to recognize reasonable |
2114
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
126 configuration names, and add a description of the system to |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
127 `etc/MACHINES'. |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
128 |
108639
cfaca963d899
* src/[ms]/template.h: Comments.
Glenn Morris <rgm@gnu.org>
parents:
108511
diff
changeset
|
129 Check for any tests of $opsys in configure.in, and add an entry |
cfaca963d899
* src/[ms]/template.h: Comments.
Glenn Morris <rgm@gnu.org>
parents:
108511
diff
changeset
|
130 for the new system if needed. |
cfaca963d899
* src/[ms]/template.h: Comments.
Glenn Morris <rgm@gnu.org>
parents:
108511
diff
changeset
|
131 |
2114
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
132 If you've just fixed a problem in an existing configuration file, |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
133 you should also check `etc/MACHINES' to make sure its descriptions |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
134 of known problems in that configuration should be updated. */ |
52401 | 135 |
136 /* arch-tag: 4b426b11-cb2e-4c0e-a488-e663f76a0515 | |
137 (do not change this comment) */ |