annotate src/m/template.h @ 108375:973b5bc5fcfe

Merge from emacs-23
author Stefan Monnier <monnier@iro.umontreal.ca>
date Sat, 08 May 2010 14:47:07 -0400
parents 641672d44942
children 6fcaca6266ae
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1 /* machine description file template.
94714
7e5b32f86a4c Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79755
diff changeset
2 Copyright (C) 1985, 1986, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 100951
diff changeset
3 2008, 2009, 2010 Free Software Foundation, Inc.
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
4
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
5 This file is part of GNU Emacs.
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
6
94714
7e5b32f86a4c Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79755
diff changeset
7 GNU Emacs is free software: you can redistribute it and/or modify
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
8 it under the terms of the GNU General Public License as published by
94714
7e5b32f86a4c Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79755
diff changeset
9 the Free Software Foundation, either version 3 of the License, or
7e5b32f86a4c Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79755
diff changeset
10 (at your option) any later version.
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
11
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
12 GNU Emacs is distributed in the hope that it will be useful,
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
15 GNU General Public License for more details.
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
16
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
94714
7e5b32f86a4c Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79755
diff changeset
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
19
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
20
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 44601
diff changeset
21 /* The following line tells the configuration script what sort of
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
22 operating system this machine is likely to run.
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
23 USUAL-OPSYS="<name of system .h file here, without the s- or .h>" */
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
24
78499
49b363c28dce Replace `iff' in comments.
Glenn Morris <rgm@gnu.org>
parents: 78258
diff changeset
25 /* Define WORDS_BIG_ENDIAN if lowest-numbered byte in a word
9095
23f72b18b420 (WORDS_BIG_ENDIAN): define or undef appropriately, superseding BIG_ENDIAN.
Karl Heuer <kwzh@gnu.org>
parents: 8892
diff changeset
26 is the most significant byte. */
23f72b18b420 (WORDS_BIG_ENDIAN): define or undef appropriately, superseding BIG_ENDIAN.
Karl Heuer <kwzh@gnu.org>
parents: 8892
diff changeset
27
23f72b18b420 (WORDS_BIG_ENDIAN): define or undef appropriately, superseding BIG_ENDIAN.
Karl Heuer <kwzh@gnu.org>
parents: 8892
diff changeset
28 #define WORDS_BIG_ENDIAN
23f72b18b420 (WORDS_BIG_ENDIAN): define or undef appropriately, superseding BIG_ENDIAN.
Karl Heuer <kwzh@gnu.org>
parents: 8892
diff changeset
29
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
30 /* Now define a symbol for the cpu type, if your compiler
96581
e1043d6b0d2b * m/template.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 94714
diff changeset
31 does not define it automatically.
e1043d6b0d2b * m/template.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 94714
diff changeset
32 Ones defined so far include m68k and many others */
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
33
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
34 /* Define EXPLICIT_SIGN_EXTEND if XINT must explicitly sign-extend
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
35 the 24-bit bit field into an int. In other words, if bit fields
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
36 are always unsigned.
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
37
96602
0e3e875ffade * lisp.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 96581
diff changeset
38 This flag only matters if you use USE_LISP_UNION_TYPE. */
456
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
39
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
40 #define EXPLICIT_SIGN_EXTEND
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
41
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
42 /* Data type of load average, as read out of kmem. */
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
43
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
44 #define LOAD_AVE_TYPE long
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
45
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
46 /* Convert that into an integer that is 100 for a load average of 1.0 */
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
47
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
48 #define LOAD_AVE_CVT(x) (int) (((double) (x)) * 100.0 / FSCALE)
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
49
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
50 /* Define CANNOT_DUMP on machines where unexec does not work.
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
51 Then the function dump-emacs will not be defined
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
52 and temacs will do (load "loadup") automatically unless told otherwise. */
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
53
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
54 #define CANNOT_DUMP
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
55
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
56 /* Define VIRT_ADDR_VARIES if the virtual addresses of
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
57 pure and impure space as loaded can vary, and even their
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
58 relative order cannot be relied on.
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
59
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
60 Otherwise Emacs assumes that text space precedes data space,
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
61 numerically. */
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
62
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
63 #define VIRT_ADDR_VARIES
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
64
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
65 /* Define NO_REMAP if memory segmentation makes it not work well
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
66 to change the boundary between the text section and data section
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
67 when Emacs is dumped. If you define this, the preloaded Lisp
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
68 code will not be sharable; but that's better than failing completely. */
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
69
c0335c02f1d7 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
70 #define NO_REMAP
553
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
71
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
72 /* Some really obscure 4.2-based systems (like Sequent DYNIX)
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
73 * do not support asynchronous I/O (using SIGIO) on sockets,
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
74 * even though it works fine on tty's. If you have one of
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
75 * these systems, define the following, and then use it in
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
76 * config.h (or elsewhere) to decide when (not) to use SIGIO.
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
77 *
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
78 * You'd think this would go in an operating-system description file,
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
79 * but since it only occurs on some, but not all, BSD systems, the
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
80 * reasonable place to select for it is in the machine description
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
81 * file.
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
82 */
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
83
e16b0df74717 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 456
diff changeset
84 #define NO_SOCK_SIGIO
2114
d14a85e43f27 * m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents: 750
diff changeset
85
3052
Jim Blandy <jimb@redhat.com>
parents: 2114
diff changeset
86
2114
d14a85e43f27 * m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents: 750
diff changeset
87 /* 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: 750
diff changeset
88 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: 750
diff changeset
89 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: 750
diff changeset
90 `etc/MACHINES'.
d14a85e43f27 * m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents: 750
diff changeset
91
d14a85e43f27 * m/template.h, s/template.h: Mention that `etc/MACHINES' and
Jim Blandy <jimb@redhat.com>
parents: 750
diff changeset
92 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: 750
diff changeset
93 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: 750
diff changeset
94 of known problems in that configuration should be updated. */
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
95
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
96 /* arch-tag: d7dae0a9-4f99-4939-bef9-5738e1f33955
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
97 (do not change this comment) */