Switch to recommended form of GPLv3 permissions notice.
[bpt/emacs.git] / src / s / template.h
CommitLineData
20c428fd
JB
1/* Template for system description header files.
2 This file describes the parameters that system description files
3 should define or not.
429ab54e 4 Copyright (C) 1985, 1986, 1992, 1999, 2001, 2002, 2003, 2004,
01122546 5 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
20c428fd
JB
6
7This file is part of GNU Emacs.
8
9GNU Emacs is free software; you can redistribute it and/or modify
10it under the terms of the GNU General Public License as published by
4a9f99bd 11the Free Software Foundation; either version 3, or (at your option)
20c428fd
JB
12any later version.
13
14GNU Emacs is distributed in the hope that it will be useful,
15but WITHOUT ANY WARRANTY; without even the implied warranty of
16MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17GNU General Public License for more details.
18
19You should have received a copy of the GNU General Public License
20along with GNU Emacs; see the file COPYING. If not, write to
364c38d3
LK
21the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22Boston, MA 02110-1301, USA. */
20c428fd
JB
23
24
25/*
26 * Define symbols to identify the version of Unix this is.
27 * Define all the symbols that apply correctly.
28 */
29
30/* #define UNIPLUS */
31/* #define USG5 */
32/* #define USG */
33/* #define HPUX */
34/* #define UMAX */
35/* #define BSD4_1 */
36/* #define BSD4_2 */
37/* #define BSD4_3 */
8e4c450d 38/* #define BSD_SYSTEM */
20c428fd
JB
39/* #define VMS */
40
41/* SYSTEM_TYPE should indicate the kind of system you are using.
42 It sets the Lisp variable system-type. */
43
44#define SYSTEM_TYPE "berkeley-unix"
45
46/* NOMULTIPLEJOBS should be defined if your system's shell
47 does not have "job control" (the ability to stop a program,
48 run some other program, then continue the first one). */
49
50/* #define NOMULTIPLEJOBS */
51
52/* Emacs can read input using SIGIO and buffering characters itself,
53 or using CBREAK mode and making C-g cause SIGINT.
54 The choice is controlled by the variable interrupt_input.
32de6484 55
20c428fd
JB
56 Define INTERRUPT_INPUT to make interrupt_input = 1 the default (use SIGIO)
57
bb7b4368
PE
58 Emacs uses the presence or absence of the SIGIO and BROKEN_SIGIO macros
59 to indicate whether or not signal-driven I/O is possible. It uses
32de6484
JB
60 INTERRUPT_INPUT to decide whether to use it by default.
61
20c428fd 62 SIGIO can be used only on systems that implement it (4.2 and 4.3).
eb8c3be9 63 CBREAK mode has two disadvantages
20c428fd
JB
64 1) At least in 4.2, it is impossible to handle the Meta key properly.
65 I hear that in system V this problem does not exist.
66 2) Control-G causes output to be discarded.
67 I do not know whether this can be fixed in system V.
68
69 Another method of doing input is planned but not implemented.
70 It would have Emacs fork off a separate process
71 to read the input and send it to the true Emacs process
32de6484 72 through a pipe. */
20c428fd
JB
73
74#define INTERRUPT_INPUT
75
76/* Letter to use in finding device name of first pty,
77 if system supports pty's. 'a' means it is /dev/ptya0 */
78
79#define FIRST_PTY_LETTER 'a'
80
d4327fec
JB
81/*
82 * Define HAVE_TERMIOS if the system provides POSIX-style
83 * functions and macros for terminal control.
161aa2f8 84 *
b350a838
JB
85 * Define HAVE_TERMIO if the system provides sysV-style ioctls
86 * for terminal control.
161aa2f8 87 *
eb8c3be9 88 * Do not define both. HAVE_TERMIOS is preferred, if it is
161aa2f8 89 * supported on your system.
b350a838
JB
90 */
91
161aa2f8
JB
92#define HAVE_TERMIOS
93/* #define HAVE_TERMIO */
b350a838 94
20c428fd
JB
95/*
96 * Define HAVE_PTYS if the system supports pty devices.
97 */
98
99#define HAVE_PTYS
100
101/*
102 * Define NONSYSTEM_DIR_LIBRARY to make Emacs emulate
103 * The 4.2 opendir, etc., library functions.
104 */
105
106#define NONSYSTEM_DIR_LIBRARY
107
108/* Define this symbol if your system has the functions bcopy, etc. */
109
110#define BSTRING
111
112/* subprocesses should be defined if you want to
113 have code for asynchronous subprocesses
114 (as used in M-x compile and M-x shell).
115 This is generally OS dependent, and not supported
116 under most USG systems. */
117
118#define subprocesses
119
120/* If your system uses COFF (Common Object File Format) then define the
121 preprocessor symbol "COFF". */
122
123/* #define COFF */
124
125/* define MAIL_USE_FLOCK if the mailer uses flock
126 to interlock access to /usr/spool/mail/$USER.
127 The alternative is that a lock file named
128 /usr/spool/mail/$USER.lock. */
129
130#define MAIL_USE_FLOCK
131
132/* Define CLASH_DETECTION if you want lock files to be written
133 so that Emacs can tell instantly when you try to modify
134 a file that someone else has modified in his Emacs. */
135
136#define CLASH_DETECTION
137
14e76af9
JB
138/* Define this if your operating system declares signal handlers to
139 have a type other than the usual. `The usual' is `void' for ANSI C
140 systems (i.e. when the __STDC__ macro is defined), and `int' for
141 pre-ANSI systems. If you're using GCC on an older system, __STDC__
142 will be defined, but the system's include files will still say that
143 signal returns int or whatever; in situations like that, define
144 this to be what the system's include files want. */
145/* #define SIGTYPE int */
146
d4198db9
JB
147/* If the character used to separate elements of the executable path
148 is not ':', #define this to be the appropriate character constant. */
149/* #define SEPCHAR ':' */
150
67cdbf16
GM
151/* Define this if the system can use mmap for buffer text allocation. */
152/* #define USE_MMAP_FOR_BUFFERS 1 */
326cdd74 153
f5070950
JB
154/* ============================================================ */
155
156/* Here, add any special hacks needed
20c428fd
JB
157 to make Emacs work on this system. For example,
158 you might define certain system call names that don't
159 exist on your system, or that do different things on
160 your system and must be used only through an encapsulation
161 (Which you should place, by convention, in sysdep.c). */
f5070950 162
20c428fd
JB
163/* Some compilers tend to put everything declared static
164 into the initialized data area, which becomes pure after dumping Emacs.
165 On these systems, you must #define static as nothing to foil this.
166 Note that emacs carefully avoids static vars inside functions. */
167
168/* #define static */
00b1a5fb 169
2327e4a0
GM
170/* If the system's imake configuration file defines `NeedWidePrototypes'
171 as `NO', we must define NARROWPROTO manually. Such a define is
177c0ea7 172 generated in the Makefile generated by `xmkmf'. If we don't
2327e4a0
GM
173 define NARROWPROTO, we will see the wrong function prototypes
174 for X functions taking float or double parameters. */
175
176/* #define NARROWPROTO 1 */
177
f5070950 178/* ============================================================ */
00b1a5fb
JB
179
180/* After adding support for a new system, modify the large case
181 statement in the `configure' script to recognize reasonable
182 configuration names, and add a description of the system to
183 `etc/MACHINES'.
184
185 If you've just fixed a problem in an existing configuration file,
186 you should also check `etc/MACHINES' to make sure its descriptions
187 of known problems in that configuration should be updated. */
ab5796a9
MB
188
189/* arch-tag: 4b426b11-cb2e-4c0e-a488-e663f76a0515
190 (do not change this comment) */