(What Is a Function): Fix xref.
[emacs.git] / nt / gmake.defs
blob56799f783e15101800fb7e95f47bfb644e81ccad
1 #  -*- Makefile -*- definition file for building GNU Emacs on Windows NT.
2 #  Copyright (C) 2000, 2001, 2002, 2003, 2004,
3 #    2005, 2006 Free Software Foundation, Inc.
5 #  GNU Emacs is free software; you can redistribute it and/or modify
6 #  it under the terms of the GNU General Public License as published by
7 #  the Free Software Foundation; either version 2, or (at your option)
8 #  any later version.
10 #  GNU Emacs is distributed in the hope that it will be useful,
11 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
12 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 #  GNU General Public License for more details.
15 #  You should have received a copy of the GNU General Public License
16 #  along with GNU Emacs; see the file COPYING.  If not, write to
17 #  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 #  Boston, MA 02110-1301, USA.
20 # Ensure 'all' is the default target
21 all:
23 # NOTES
25 # I tried to force gmake to use the native shell for simplicity, by
26 # setting SHELL as below, but this didn't work reliably because of
27 # various case sensitivity niggles.  Specifically, COMSPEC (which is in
28 # fact usually spelled ComSpec on NT, to make life difficult) typically
29 # references "cmd.exe" (on NT) when the file is actually called
30 # "CMD.EXE" on disk for hysterical raisons.  As a result, GNU make
31 # thinks it doesn't exist (unless compiled with a switch to ignore
32 # case), and so doesn't change which shell it will invoke to execute
33 # commands.
35 # It would be possible, though very tedious using just gmake facilities,
36 # to convert the COMSPEC value to uppercase to solve this problem, but
37 # it isn't worth it.  That is partly because, even when using the native
38 # shell, gmake tends to not be happy with backslashes in command
39 # strings.  The obvious solution is to use forward slashes as much as
40 # possible, which can be made to work most of the time (putting
41 # filenames in quotes often helps), but there are still some internal
42 # cmd.exe commands like `del' and `copy' that won't work with them.
43 # Although it is possible to convert slashes to backslashes when
44 # necessary, gmake requires explicitly calling its subst function, which
45 # nmake does not understand).  For this reason, it is simplest to
46 # mandate that rm and cp be available, so we can use Unix-format file
47 # names everywhere.  (Fortunately both MS and GNU make, and the
48 # respective compilers, are happy with Unix-format names.)
50 # Since we cannot easily force the choice of a particular shell, we must
51 # make the effort to cope with whichever shell is being used.
52 # Fortunately, the only command we need to use that is shell specific is
53 # the testing of a file's existence for the purpose of working out when
54 # we are copying files to their original location.  That particular
55 # requirement is abstracted easily enough.
57 # The only other problem area was the change of directory when running
58 # temacs to dump emacs.exe (where gmake doesn't support cd foo in any
59 # useful way), but that has been resolved by modifying the Windows
60 # unexec function slightly to not require the directory change while
61 # still allowing objects and binaries to be in subdirectories.
63 # This doesn't work.
64 #SHELL:=$(COMSPEC)
66 # Determine whether make is using sh or cmd/command as shell; cmd.exe
67 # will output "ECHO is on" when echo is given by itself, while sh will
68 # not produce any output.
69 sh_output := $(shell echo)
70 ifeq "$(findstring ECHO, $(sh_output))" "ECHO"
71 THE_SHELL = $(COMSPEC)$(ComSpec)
72 SHELLTYPE=CMD
73 else
74 USING_SH = 1
75 THE_SHELL = $(SHELL)
76 SHELLTYPE=SH
77 endif
79 MAKETYPE=gmake
81 # The following "ifeq" does not appear to DTRT, and therefore breaks
82 # the build on mingw32. Also the -m option does not exist in many
83 # (reasonably recent even) versions of Cygwin. These issues need to be
84 # remedied before putting this cygpath kludge back in.
86 # Convert CURDIR to native file name, if in Cygwin format
87 #ifeq "$(shell cygpath $(CURDIR))" "$(CURDIR)"
88 #CURDIR         := $(shell cygpath -m $(CURDIR))
89 #endif
91 THISDIR         = .
93 # Cygwin has changed quoting rules somewhat since b20, in a way that
94 # affects makefiles using sh as the command processor, so we need to
95 # detect which rules to use.
96 ifdef USING_SH
97 sh_output := $(shell echo [Please ignore a syntax error on the next line - it is intentional] 1>&2)
98 sh_output := $(shell echo foo")
99 ifeq "$(sh_output)" ""
100 NEW_CYGWIN = 1
101 endif
102 endif
104 ALL_DEPS        = $^
105 EMPTY =
106 SPACE = $(EMPTY) $(EMPTY)
108 SUBSYSTEM_WINDOWS=-Wl,-subsystem,windows
109 SUBSYSTEM_CONSOLE=-Wl,-subsystem,console
111 # INSTALL_DIR is the directory into which emacs will be installed.
113 ifndef INSTALL_DIR
114 INSTALL_DIR     = $(CURDIR)/..
115 endif
117 export EMACSLOADPATH
119 # Determine the architecture we're running on.
120 # Define ARCH for our purposes;
121 # Define CPU for use by ntwin32.mak;
122 # Define CONFIG_H to the appropriate config.h for the system;
124 ifdef PROCESSOR_ARCHITECTURE
125 # We're on Windows NT
126 CPU             = $(PROCESSOR_ARCHITECTURE)
127 CONFIG_H        = config.nt
128 OS_TYPE         = windowsnt
129  ifeq "$(PROCESSOR_ARCHITECTURE)" "x86"
130 ARCH            = i386
131 CPU             = i386
132  else
133   ifeq "$(PROCESSOR_ARCHITECTURE)" "MIPS"
134 ARCH            = mips
135   else
136    ifeq "$(PROCESSOR_ARCHITECTURE)" "ALPHA"
137 ARCH            = alpha
138    else
139     ifeq "$(PROCESSOR_ARCHITECTURE)" "PPC"
140 ARCH            = ppc
141     else
142 error Unknown architecture type "$(PROCESSOR_ARCHITECTURE)"
143     endif
144    endif
145   endif
146  endif
147 else
148 # We're on Windows 95
149 ARCH            = i386
150 CPU             = i386
151 CONFIG_H        = config.nt
152 OS_TYPE         = windows95
153 endif
155 AR              = ar -rsc
156 AR_OUT          =
157 CC              = gcc
158 CC_OUT          = -o$(SPACE)
159 LINK            = gcc
160 LINK_OUT        = -o$(SPACE)
161 RC              = windres -O coff
162 RC_OUT          = -o$(SPACE)
163 RC_INCLUDE      = --include-dir$(SPACE)
165 libc            =
166 baselibs        =
167 O               = o
168 A               = a
170 BASE_LIBS       = $(libc) $(baselibs)
172 ADVAPI32        = -ladvapi32
173 COMDLG32        = -lcomdlg32
174 GDI32           = -lgdi32
175 MPR             = -lmpr
176 SHELL32         = -lshell32
177 USER32          = -luser32
178 WSOCK32         = -lwsock32
179 WINMM     = -lwinmm
180 WINSPOOL        = -lwinspool
182 ifdef NOOPT
183 DEBUG_CFLAGS    = -DEMACSDEBUG
184 else
185 DEBUG_CFLAGS    =
186 endif
187 CFLAGS          = -I. -DWIN32_LEAN_AND_MEAN -D_WIN32_WINNT=0x0400 $(ARCH_CFLAGS) -D$(ARCH) \
188                   -D_CRTAPI1=_cdecl \
189                   $(DEBUG_CFLAGS) $(USER_CFLAGS) $(LOCAL_FLAGS)
190 EMACS_EXTRA_C_FLAGS = -DUSE_CRT_DLL=1
192 # see comments in allocate_heap in w32heap.c before changing any of the
193 # -stack, -heap, or -image-base settings.
194 TEMACS_EXTRA_LINK = -Wl,-stack,0x00800000 -Wl,-heap,0x00100000 -Wl,-image-base,0x01000000 $(SUBSYSTEM_CONSOLE) -Wl,-entry,__start -Wl,-Map,$(BLD)/temacs.map
196 ifdef NOOPT
197 OBJDIR          = oo
198 else
199 OBJDIR          = oo-spd
200 endif
201 $(OBJDIR):;     -mkdir "$(OBJDIR)"
202 BLD             = $(OBJDIR)/$(ARCH)
203 $(BLD):         $(OBJDIR)
204                 -mkdir "$(BLD)"
206 COMPILER_TEMP_FILES =
208 CP              = cp -f
209 CP_DIR          = cp -rf
210 DEL             = rm
211 DEL_TREE        = rm -r
213 ifdef USING_SH
215 IFNOTSAMEDIR    = if [ ! -s ../same-dir.tst ] ; then
216 FOREACH         = for f in
217 FORVAR          = $${f}
218 FORDO           = ; do
219 ENDFOR          = ; done
220 ENDIF           = ; fi
221 ARGQUOTE        = '
222 ifdef NEW_CYGWIN
223 DQUOTE          = "
224 else
225 DQUOTE          = ""
226 endif
228 else
230 IFNOTSAMEDIR    = if not exist ../same-dir.tst
231 FOREACH         = for %%f in (
232 FORVAR          = %%f
233 FORDO           = ) do
234 ENDFOR          =
235 ENDIF           =
236 ARGQUOTE        = "
237 DQUOTE          = \"
239 endif
241 ifdef NODEBUG
242 DEBUG_FLAG =
243 DEBUG_LINK =
244 else
245 DEBUG_FLAG = -gstabs+ -g3
246 DEBUG_LINK = -gstabs+ -g3
247 endif
249 ifdef NOCYGWIN
250 NOCYGWIN = -mno-cygwin
251 endif
253 ifeq "$(ARCH)" "i386"
254 ifdef NOOPT
255 ARCH_CFLAGS     = -D_X86_=1 -c $(DEBUG_FLAG) $(NOCYGWIN)
256 else
257 ARCH_CFLAGS     = -D_X86_=1 -c $(DEBUG_FLAG) $(NOCYGWIN) $(MCPU_FLAG) -O2 \
258                   # -fbuiltin \
259                   # -finline-functions \
260                   # -fomit-frame-pointer
261 endif
262 ARCH_LDFLAGS    = $(SYS_LDFLAGS)
263 else
264 ERROR Unknown architecture type "$(ARCH)".
265 endif
267 LINK_FLAGS      = $(ARCH_LDFLAGS) $(DEBUG_LINK) $(NOCYGWIN) $(USER_LDFLAGS)
269 .DEFAULT:
271 $(BLD)/%.o: %.c
272                 $(CC) $(CFLAGS) $(CC_OUT)$@ $<
274 # arch-tag: 35eb9662-8534-4bcf-b891-0730a09d657f