ole32: Add documentation for CreateBindCtx, BindMoniker, GetRunningObjectTable and...
[wine] / Make.rules.in
1 # Global rules shared by all makefiles     -*-Makefile-*-
2 #
3 # Each individual makefile must define the following variables:
4 # TOPSRCDIR    : top-level source directory
5 # TOPOBJDIR    : top-level object directory
6 # SRCDIR       : source directory for this module
7 # MODULE       : name of the module being built
8 #
9 # Each individual makefile may define the following additional variables:
10 # C_SRCS       : C sources for the module
11 # C_SRCS16     : 16-bit C sources for the module
12 # RC_SRCS      : resource source files
13 # EXTRA_SRCS   : extra source files for make depend
14 # EXTRA_OBJS   : extra object files
15 # IMPORTS      : dlls to import
16 # DELAYIMPORTS : dlls to import in delayed mode
17 # SUBDIRS      : subdirectories that contain a Makefile
18 # EXTRASUBDIRS : subdirectories that do not contain a Makefile
19 # INSTALLSUBDIRS : subdirectories to run make install/uninstall into
20 # MODCFLAGS    : extra CFLAGS for this module
21
22 # First some useful definitions
23
24 SHELL     = /bin/sh
25 CC        = @CC@
26 CFLAGS    = @CFLAGS@
27 CPPFLAGS  = @CPPFLAGS@
28 LIBS      = @LIBS@
29 BISON     = @BISON@
30 FLEX      = @FLEX@
31 EXEEXT    = @EXEEXT@
32 OBJEXT    = @OBJEXT@
33 LIBEXT    = @LIBEXT@
34 DLLEXT    = @DLLEXT@
35 IMPLIBEXT = @IMPLIBEXT@
36 LDSHARED  = @LDSHARED@
37 DLLTOOL   = @DLLTOOL@
38 DLLWRAP   = @DLLWRAP@
39 AR        = @AR@ rc
40 RANLIB    = @RANLIB@
41 STRIP     = @STRIP@
42 WINDRES   = @WINDRES@
43 LN        = @LN@
44 LN_S      = @LN_S@
45 TOOLSDIR  = @TOOLSDIR@
46 AS        = @AS@
47 LD        = @LD@
48 LDFLAGS   = @LDFLAGS@
49 PRELINK   = @PRELINK@
50 RM        = rm -f
51 MV        = mv
52 LINT      = @LINT@
53 LINTFLAGS = @LINTFLAGS@
54 FONTFORGE = @FONTFORGE@
55 INCLUDES     = -I$(SRCDIR) -I. -I$(TOPSRCDIR)/include -I$(TOPOBJDIR)/include $(EXTRAINCL)
56 EXTRACFLAGS  = @EXTRACFLAGS@
57 ALLCFLAGS    = $(INCLUDES) $(DEFS) $(DLLFLAGS) $(EXTRACFLAGS) $(CPPFLAGS) $(CFLAGS) $(MODCFLAGS)
58 ALLLINTFLAGS = $(INCLUDES) $(DEFS) $(LINTFLAGS)
59 IDLFLAGS     = $(INCLUDES) $(DEFS) $(EXTRAIDLFLAGS)
60 WINEBUILDFLAGS = $(DLLFLAGS) --as-cmd "$(AS)"
61 MKINSTALLDIRS= $(TOPSRCDIR)/tools/mkinstalldirs -m 755
62 WINAPI_CHECK = $(TOPSRCDIR)/tools/winapi/winapi_check
63 WINEWRAPPER  = $(TOPSRCDIR)/tools/winewrapper
64 C2MAN        = $(TOPSRCDIR)/tools/c2man.pl
65 RUNTEST      = $(TOPSRCDIR)/tools/runtest
66 WINEBUILD    = $(TOOLSDIR)/tools/winebuild/winebuild
67 MAKEDEP      = $(TOOLSDIR)/tools/makedep
68 MAKECTESTS   = $(TOOLSDIR)/tools/make_ctests
69 WRC          = $(TOOLSDIR)/tools/wrc/wrc
70 BIN2RES      = $(TOOLSDIR)/tools/bin2res
71 WMC          = $(TOOLSDIR)/tools/wmc/wmc
72 WIDL         = $(TOOLSDIR)/tools/widl/widl
73 WINEGCC      = $(TOOLSDIR)/tools/winegcc/winegcc
74 RELPATH      = $(TOOLSDIR)/tools/relpath
75 SFNT2FNT     = $(TOOLSDIR)/tools/sfnt2fnt
76 FNT2FON      = $(TOOLSDIR)/tools/fnt2fon
77 RC           = $(WRC)
78 RC16         = $(WRC)
79 RCFLAGS      = --nostdinc $(INCLUDES) $(DEFS) $(EXTRARCFLAGS)
80 RC16FLAGS    = -O res16 $(RCFLAGS)
81 LDPATH       = @LDPATH@
82 DLLDIR       = $(TOPOBJDIR)/dlls
83 LIBPORT      = $(TOPOBJDIR)/libs/port/libwine_port.a
84 LIBWPP       = $(TOPOBJDIR)/libs/wpp/libwpp.a
85 LIBWINE      = -L$(TOPOBJDIR)/libs/wine -lwine
86 LIBWINE_LDFLAGS = @LIBWINE_LDFLAGS@ $(LIBWINE)
87
88 @SET_MAKE@
89
90 # Installation infos
91
92 INSTALL         = @INSTALL@ $(INSTALL_FLAGS)
93 INSTALL_PROGRAM = @INSTALL_PROGRAM@ $(INSTALL_PROGRAM_FLAGS)
94 INSTALL_SCRIPT  = @INSTALL_SCRIPT@ $(INSTALL_SCRIPT_FLAGS)
95 INSTALL_DATA    = @INSTALL_DATA@ $(INSTALL_DATA_FLAGS)
96 prefix          = @prefix@
97 exec_prefix     = @exec_prefix@
98 bindir          = @bindir@
99 libdir          = @libdir@
100 datarootdir     = @datarootdir@
101 datadir         = @datadir@
102 infodir         = @infodir@
103 mandir          = @mandir@
104 sysconfdir      = @sysconfdir@
105 includedir      = @includedir@/wine
106 dlldir          = @libdir@/wine
107 prog_manext     = 1
108 api_manext      = 3w
109 conf_manext     = 5
110 CLEAN_FILES     = *.o *.a *.so *.ln *.$(LIBEXT) \\\#*\\\# *~ *% .\\\#* *.bak *.orig *.rej *.flc core
111
112 IDL_GEN_C_SRCS  = $(IDL_C_SRCS:.idl=_c.c) $(IDL_I_SRCS:.idl=_i.c) \
113                   $(IDL_P_SRCS:.idl=_p.c) $(IDL_S_SRCS:.idl=_s.c)
114 IDL_GEN_HEADERS = $(IDL_H_SRCS:.idl=.h) $(IDL_C_SRCS:.idl=.h) $(IDL_I_SRCS:.idl=.h) \
115                   $(IDL_P_SRCS:.idl=.h) $(IDL_S_SRCS:.idl=.h)
116
117 CLEAN_TARGETS = $(IDL_GEN_C_SRCS) $(IDL_GEN_HEADERS) $(IDL_TLB_SRCS:.idl=.tlb) \
118                 $(BISON_SRCS:.y=.tab.c) $(BISON_SRCS:.y=.tab.h) $(LEX_SRCS:.l=.yy.c) \
119                 $(MC_SRCS:.mc=.mc.rc) $(RC_SRCS:.rc=.res) $(RC_SRCS16:.rc=.res)
120
121 OBJS = $(C_SRCS:.c=.o) $(BISON_SRCS:.y=.tab.o) $(LEX_SRCS:.l=.yy.o) $(IDL_GEN_C_SRCS:.c=.o) $(EXTRA_OBJS)
122
123 RCOBJS = $(RC_SRCS:.rc=.res.o)
124 LINTS  = $(C_SRCS:.c=.ln)
125
126 # Implicit rules
127
128 .SUFFIXES: .mc .rc .mc.rc .res .res.o .spec .spec.o .idl .tlb .h .y .l .tab.c .tab.h .yy.c .ok .sfd .ttf .man.in .man _c.c _i.c _p.c _s.c
129
130 .c.o:
131         $(CC) -c $(ALLCFLAGS) -o $@ $<
132
133 .s.o:
134         $(AS) -o $@ $<
135
136 .y.tab.c:
137         $(BISON) $(BISONFLAGS) -p $*_ -o $@ $<
138
139 .y.tab.h:
140         $(BISON) $(BISONFLAGS) -p $*_ -o $*.tab.c -d $<
141
142 .l.yy.c:
143         $(FLEX) $(LEXFLAGS) -o$@ $<
144
145 .mc.mc.rc:
146         $(LDPATH) $(WMC) -i -U -H /dev/null -o $@ $<
147
148 .rc.res:
149         $(LDPATH) $(RC) $(RCFLAGS) -fo$@ $<
150
151 .res.res.o:
152         $(WINDRES) -i $< -o $@
153
154 .spec.spec.o:
155         $(WINEBUILD) $(WINEBUILDFLAGS) --dll -o $@ --main-module $(MODULE) --export $<
156
157 .idl.h:
158         $(WIDL) $(IDLFLAGS) -h -H $@ $<
159
160 .idl_c.c:
161         $(WIDL) $(IDLFLAGS) -c -C $@ $<
162
163 .idl_i.c:
164         $(WIDL) $(IDLFLAGS) -u -U $@ $<
165
166 .idl_p.c:
167         $(WIDL) $(IDLFLAGS) -p -P $@ $<
168
169 .idl_s.c:
170         $(WIDL) $(IDLFLAGS) -s -S $@ $<
171
172 .idl.tlb:
173         $(WIDL) $(IDLFLAGS) -t -T $@ $<
174
175 .c.ln:
176         $(LINT) -c $(ALLLINTFLAGS) $< || ( $(RM) $@ && exit 1 )
177
178 .c.ok:
179         $(RUNTEST) $(RUNTESTFLAGS) $< && touch $@
180
181 .sfd.ttf:
182         $(FONTFORGE) -script $(TOPSRCDIR)/fonts/genttf.ff $< $@
183
184 .man.in.man:
185         sed -e 's,@bindir\@,$(bindir),g' -e 's,@dlldir\@,$(dlldir),g' -e 's,@PACKAGE_STRING\@,@PACKAGE_STRING@,g' $< >$@ || ($(RM) $@ && false)
186
187 # 'all' target first in case the enclosing Makefile didn't define any target
188
189 all:
190
191 filter: dummy
192         @$(TOPSRCDIR)/tools/winapi/make_filter --make $(MAKE) all
193
194 .PHONY: all filter
195
196 # Rules for resources
197
198 $(RC_BINARIES): $(BIN2RES) $(RC_BINSRC)
199         $(BIN2RES) -f -o $@ $(SRCDIR)/$(RC_BINSRC)
200
201 $(RC_SRCS:.rc=.res) $(RC_SRCS16:.rc=.res): $(WRC) $(RC_BINARIES) $(IDL_TLB_SRCS:.idl=.tlb)
202
203 # Rule for linting
204
205 $(MODULE).ln : $(LINTS)
206         if test "$(LINTS)" ; \
207         then \
208                 $(LINT) $(ALLLINTFLAGS) -o$(MODULE) $(LINTS) ; \
209                 $(MV) llib-l$(MODULE).ln $(MODULE).ln ; \
210         else \
211                 $(LINT) $(ALLLINTFLAGS) -C$(MODULE) /dev/null ; \
212         fi
213
214 lint:: $(MODULE).ln
215
216 # Rules for Windows API checking
217
218 winapi_check:: dummy
219         $(WINAPI_CHECK) $(WINAPI_CHECK_FLAGS) $(WINAPI_CHECK_EXTRA_FLAGS) .
220
221 .PHONY: winapi_check
222
223 # Rules for dependencies
224
225 DEPEND_SRCS = $(C_SRCS) $(C_SRCS16) $(RC_SRCS) $(RC_SRCS16) $(MC_SRCS) $(IDL_H_SRCS) $(IDL_C_SRCS) $(IDL_I_SRCS) $(IDL_P_SRCS) $(IDL_S_SRCS) $(IDL_GEN_C_SRCS) $(BISON_SRCS) $(LEX_SRCS) $(EXTRA_SRCS)
226
227 $(SUBDIRS:%=%/__depend__): dummy
228         @cd `dirname $@` && $(MAKE) depend
229
230 depend: $(SUBDIRS:%=%/__depend__) dummy
231         $(MAKEDEP) -C$(SRCDIR) -S$(TOPSRCDIR) -T$(TOPOBJDIR) $(EXTRAINCL) $(DEPEND_SRCS)
232
233 .PHONY: depend $(SUBDIRS:%=%/__depend__)
234
235 # Rules for cleaning
236
237 $(SUBDIRS:%=%/__clean__): dummy
238         @cd `dirname $@` && $(MAKE) clean
239
240 $(EXTRASUBDIRS:%=%/__clean__): dummy
241         -cd `dirname $@` && $(RM) $(CLEAN_FILES)
242
243 clean:: $(SUBDIRS:%=%/__clean__) $(EXTRASUBDIRS:%=%/__clean__)
244         $(RM) $(CLEAN_FILES) $(CLEAN_TARGETS) $(PROGRAMS) $(RC_BINARIES) $(MANPAGES)
245
246 .PHONY: clean $(SUBDIRS:%=%/__clean__) $(EXTRASUBDIRS:%=%/__clean__)
247
248 # Rules for installing
249
250 $(SUBDIRS:%=%/__install__): dummy
251         @cd `dirname $@` && $(MAKE) install
252
253 $(SUBDIRS:%=%/__install-lib__): dummy
254         @cd `dirname $@` && $(MAKE) install-lib
255
256 $(SUBDIRS:%=%/__install-dev__): dummy
257         @cd `dirname $@` && $(MAKE) install-dev
258
259 $(SUBDIRS:%=%/__uninstall__): dummy
260         @cd `dirname $@` && $(MAKE) uninstall
261
262 install:: $(INSTALLSUBDIRS:%=%/__install__)
263
264 uninstall:: $(INSTALLSUBDIRS:%=%/__uninstall__)
265
266 $(INSTALLDIRS):
267         $(MKINSTALLDIRS) $@
268
269 .PHONY: install install-lib install-dev uninstall \
270         $(SUBDIRS:%=%/__install__) $(SUBDIRS:%=%/__uninstall__) \
271         $(SUBDIRS:%=%/__install-lib__) $(SUBDIRS:%=%/__install-dev__)
272
273 # Rules for testing
274
275 $(TESTSUBDIRS:%=%/__test__): dummy
276         @cd `dirname $@` && $(MAKE) test
277
278 $(TESTSUBDIRS:%=%/__crosstest__): dummy
279         @cd `dirname $@` && $(MAKE) crosstest
280
281 $(TESTSUBDIRS:%=%/__testclean__): dummy
282         @cd `dirname $@` && $(MAKE) testclean
283
284 check test:: $(TESTSUBDIRS:%=%/__test__)
285
286 crosstest:: $(TESTSUBDIRS:%=%/__crosstest__)
287
288 testclean:: $(TESTSUBDIRS:%=%/__testclean__)
289
290 .PHONY: check test testclean crosstest $(TESTSUBDIRS:%=%/__test__) $(TESTSUBDIRS:%=%/__crosstest__) $(TESTSUBDIRS:%=%/__testclean__) 
291
292 # Rules for auto documentation
293
294 $(DOCSUBDIRS:%=%/__man__): dummy
295         @cd `dirname $@` && $(MAKE) man
296
297 $(DOCSUBDIRS:%=%/__doc_html__): dummy
298         @cd `dirname $@` && $(MAKE) doc-html
299
300 $(DOCSUBDIRS:%=%/__doc_sgml__): dummy
301         @cd `dirname $@` && $(MAKE) doc-sgml
302
303 man: $(DOCSUBDIRS:%=%/__man__)
304 doc-html: $(DOCSUBDIRS:%=%/__doc_html__)
305 doc-sgml: $(DOCSUBDIRS:%=%/__doc_sgml__)
306
307 .PHONY: man doc-html doc-sgml $(DOCSUBDIRS:%=%/__man__) $(DOCSUBDIRS:%=%/__doc_html__) $(DOCSUBDIRS:%=%/__doc_sgml__)
308
309 # Misc. rules
310
311 $(MC_SRCS:.mc=.mc.rc): $(WMC)
312
313 $(IDL_GEN_HEADERS) $(IDL_GEN_C_SRCS) $(IDL_TLB_SRCS:.idl=.tlb): $(WIDL)
314
315 $(SUBDIRS): dummy
316         @cd $@ && $(MAKE)
317
318 dummy:
319
320 .PHONY: dummy $(SUBDIRS)
321
322 # End of global rules