Mercurial > emacs
annotate src/s/template.h @ 95535:3a67eec377e0
(variable-pitch-mode): Reflow docstrings.
(text-scale-mode, adjust-buffer-face-height): Fix typos in docstrings.
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Wed, 04 Jun 2008 11:12:44 +0000 |
parents | 1f134b61867c |
children | ddedcecb18ef |
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. | |
94715
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
4 Copyright (C) 1985, 1986, 1992, 1999, 2001, 2002, 2003, 2004, 2005, |
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
5 2006, 2007, 2008 Free Software Foundation, Inc. |
456 | 6 |
7 This file is part of GNU Emacs. | |
8 | |
94715
1f134b61867c
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79756
diff
changeset
|
9 GNU Emacs is free software: you can redistribute it and/or modify |
456 | 10 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
|
11 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
|
12 (at your option) any later version. |
456 | 13 |
14 GNU Emacs is distributed in the hope that it will be useful, | |
15 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 GNU General Public License for more details. | |
18 | |
19 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
|
20 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */ |
456 | 21 |
22 | |
23 /* | |
24 * Define symbols to identify the version of Unix this is. | |
25 * Define all the symbols that apply correctly. | |
26 */ | |
27 | |
28 /* #define UNIPLUS */ | |
29 /* #define USG5 */ | |
30 /* #define USG */ | |
31 /* #define HPUX */ | |
32 /* #define UMAX */ | |
33 /* #define BSD4_1 */ | |
34 /* #define BSD4_2 */ | |
35 /* #define BSD4_3 */ | |
16221 | 36 /* #define BSD_SYSTEM */ |
456 | 37 /* #define VMS */ |
38 | |
39 /* SYSTEM_TYPE should indicate the kind of system you are using. | |
40 It sets the Lisp variable system-type. */ | |
41 | |
42 #define SYSTEM_TYPE "berkeley-unix" | |
43 | |
44 /* NOMULTIPLEJOBS should be defined if your system's shell | |
45 does not have "job control" (the ability to stop a program, | |
46 run some other program, then continue the first one). */ | |
47 | |
48 /* #define NOMULTIPLEJOBS */ | |
49 | |
50 /* Emacs can read input using SIGIO and buffering characters itself, | |
51 or using CBREAK mode and making C-g cause SIGINT. | |
52 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
|
53 |
456 | 54 Define INTERRUPT_INPUT to make interrupt_input = 1 the default (use SIGIO) |
55 | |
26090 | 56 Emacs uses the presence or absence of the SIGIO and BROKEN_SIGIO macros |
57 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
|
58 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
|
59 |
456 | 60 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
|
61 CBREAK mode has two disadvantages |
456 | 62 1) At least in 4.2, it is impossible to handle the Meta key properly. |
63 I hear that in system V this problem does not exist. | |
64 2) Control-G causes output to be discarded. | |
65 I do not know whether this can be fixed in system V. | |
66 | |
67 Another method of doing input is planned but not implemented. | |
68 It would have Emacs fork off a separate process | |
69 to read the input and send it to the true Emacs process | |
2734
a0f174dc6ac5
* s/template.h: Explain the relative significance of the SIGIO and
Jim Blandy <jimb@redhat.com>
parents:
2642
diff
changeset
|
70 through a pipe. */ |
456 | 71 |
72 #define INTERRUPT_INPUT | |
73 | |
74 /* Letter to use in finding device name of first pty, | |
75 if system supports pty's. 'a' means it is /dev/ptya0 */ | |
76 | |
77 #define FIRST_PTY_LETTER 'a' | |
78 | |
79 /* | |
620 | 80 * Define HAVE_TERMIOS if the system provides POSIX-style |
81 * functions and macros for terminal control. | |
2917
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
82 * |
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
83 * Define HAVE_TERMIO if the system provides sysV-style ioctls |
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
84 * for terminal control. |
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
85 * |
3591
507f64624555
Apply typo patches from Paul Eggert.
Jim Blandy <jimb@redhat.com>
parents:
3053
diff
changeset
|
86 * Do not define both. HAVE_TERMIOS is preferred, if it is |
2917
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
87 * supported on your system. |
620 | 88 */ |
89 | |
90 #define HAVE_TERMIOS | |
2917
725698689fbd
Some more changes from Michael K. Johnson for Linux.
Jim Blandy <jimb@redhat.com>
parents:
2734
diff
changeset
|
91 /* #define HAVE_TERMIO */ |
559 | 92 |
93 /* | |
456 | 94 * Define HAVE_PTYS if the system supports pty devices. |
95 */ | |
96 | |
97 #define HAVE_PTYS | |
98 | |
99 /* | |
100 * Define NONSYSTEM_DIR_LIBRARY to make Emacs emulate | |
101 * The 4.2 opendir, etc., library functions. | |
102 */ | |
103 | |
104 #define NONSYSTEM_DIR_LIBRARY | |
105 | |
106 /* Define this symbol if your system has the functions bcopy, etc. */ | |
107 | |
108 #define BSTRING | |
109 | |
110 /* subprocesses should be defined if you want to | |
111 have code for asynchronous subprocesses | |
112 (as used in M-x compile and M-x shell). | |
113 This is generally OS dependent, and not supported | |
114 under most USG systems. */ | |
115 | |
116 #define subprocesses | |
117 | |
118 /* If your system uses COFF (Common Object File Format) then define the | |
119 preprocessor symbol "COFF". */ | |
120 | |
121 /* #define COFF */ | |
122 | |
123 /* define MAIL_USE_FLOCK if the mailer uses flock | |
124 to interlock access to /usr/spool/mail/$USER. | |
125 The alternative is that a lock file named | |
126 /usr/spool/mail/$USER.lock. */ | |
127 | |
128 #define MAIL_USE_FLOCK | |
129 | |
130 /* Define CLASH_DETECTION if you want lock files to be written | |
131 so that Emacs can tell instantly when you try to modify | |
132 a file that someone else has modified in his Emacs. */ | |
133 | |
134 #define CLASH_DETECTION | |
135 | |
514 | 136 /* Define this if your operating system declares signal handlers to |
137 have a type other than the usual. `The usual' is `void' for ANSI C | |
138 systems (i.e. when the __STDC__ macro is defined), and `int' for | |
139 pre-ANSI systems. If you're using GCC on an older system, __STDC__ | |
140 will be defined, but the system's include files will still say that | |
141 signal returns int or whatever; in situations like that, define | |
142 this to be what the system's include files want. */ | |
143 /* #define SIGTYPE int */ | |
144 | |
2642
05d85e55a081
* emacs.c (SEPCHAR): Instead of defining this to be ',' on VMS and
Jim Blandy <jimb@redhat.com>
parents:
2114
diff
changeset
|
145 /* 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
|
146 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
|
147 /* #define SEPCHAR ':' */ |
05d85e55a081
* emacs.c (SEPCHAR): Instead of defining this to be ',' on VMS and
Jim Blandy <jimb@redhat.com>
parents:
2114
diff
changeset
|
148 |
31600
ac8c86ff7ee3
(USE_MMAP_FOR_BUFFERS): Define instead of REL_ALLOC_MMAP.
Gerd Moellmann <gerd@gnu.org>
parents:
31499
diff
changeset
|
149 /* Define this if the system can use mmap for buffer text allocation. */ |
ac8c86ff7ee3
(USE_MMAP_FOR_BUFFERS): Define instead of REL_ALLOC_MMAP.
Gerd Moellmann <gerd@gnu.org>
parents:
31499
diff
changeset
|
150 /* #define USE_MMAP_FOR_BUFFERS 1 */ |
31499 | 151 |
3053
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
152 /* ============================================================ */ |
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
153 |
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
154 /* Here, add any special hacks needed |
456 | 155 to make Emacs work on this system. For example, |
156 you might define certain system call names that don't | |
157 exist on your system, or that do different things on | |
158 your system and must be used only through an encapsulation | |
159 (Which 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
|
160 |
456 | 161 /* Some compilers tend to put everything declared static |
162 into the initialized data area, which becomes pure after dumping Emacs. | |
163 On these systems, you must #define static as nothing to foil this. | |
164 Note that emacs carefully avoids static vars inside functions. */ | |
165 | |
166 /* #define static */ | |
2114
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
167 |
25032 | 168 /* If the system's imake configuration file defines `NeedWidePrototypes' |
169 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
|
170 generated in the Makefile generated by `xmkmf'. If we don't |
25032 | 171 define NARROWPROTO, we will see the wrong function prototypes |
172 for X functions taking float or double parameters. */ | |
173 | |
174 /* #define NARROWPROTO 1 */ | |
175 | |
3053
7d0d877f8733
Some makes can't handle form feed characters in their makefiles.
Jim Blandy <jimb@redhat.com>
parents:
2917
diff
changeset
|
176 /* ============================================================ */ |
2114
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
177 |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
178 /* After adding support for a new system, modify the large case |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
179 statement in the `configure' script to recognize reasonable |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
180 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
|
181 `etc/MACHINES'. |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
182 |
d14a85e43f27
* m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents:
620
diff
changeset
|
183 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
|
184 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
|
185 of known problems in that configuration should be updated. */ |
52401 | 186 |
187 /* arch-tag: 4b426b11-cb2e-4c0e-a488-e663f76a0515 | |
188 (do not change this comment) */ |