* Mono.Documentation/monodocs2slashdoc.cs: Code refactor; use
[mono.git] / mcs / build / library.make
1 # -*- makefile -*-
2 #
3 # The rules for building our class libraries.
4 #
5 # The NO_TEST stuff is not too pleasant but whatcha
6 # gonna do.
7
8 # All the dep files now land in the same directory so we
9 # munge in the library name to keep the files from clashing.
10
11 sourcefile = $(LIBRARY).sources
12
13 # If the directory contains the per profile include file, generate list file.
14 PROFILE_sources = $(PROFILE)_$(LIBRARY).sources
15 ifeq ($(wildcard $(PROFILE_sources)), $(PROFILE_sources))
16 PROFILE_excludes = $(wildcard $(PROFILE)_$(LIBRARY).exclude.sources)
17 COMMON_sourcefile := $(sourcefile)
18 sourcefile = $(depsdir)/$(PROFILE)_$(LIBRARY).sources
19 $(sourcefile): $(PROFILE_sources) $(PROFILE_excludes) $(COMMON_sourcefile)
20         @echo Creating the per profile list $@ ...
21         $(topdir)/tools/gensources.sh $(PROFILE_sources) $(PROFILE_excludes) > $@
22 endif
23
24 PLATFORM_excludes := $(wildcard $(LIBRARY).$(PLATFORM)-excludes)
25
26 ifndef PLATFORM_excludes
27 ifeq (cat,$(PLATFORM_CHANGE_SEPARATOR_CMD))
28 response = $(sourcefile)
29 endif
30 endif
31
32 ifndef response
33 response = $(depsdir)/$(PROFILE)_$(LIBRARY).response
34 library_CLEAN_FILES += $(response) $(LIBRARY).mdb $(BUILT_SOURCES)
35 endif
36
37 ifndef LIBRARY_NAME
38 LIBRARY_NAME = $(LIBRARY)
39 endif
40
41 ifdef LIBRARY_COMPAT
42 lib_dir = compat
43 else
44 lib_dir = lib
45 endif
46
47 makefrag = $(depsdir)/$(PROFILE)_$(LIBRARY).makefrag
48 the_libdir = $(topdir)/class/$(lib_dir)/$(PROFILE)/
49 the_lib = $(the_libdir)$(LIBRARY_NAME)
50 the_pdb = $(the_lib:.dll=.pdb)
51 the_mdb = $(the_lib).mdb
52 library_CLEAN_FILES += $(makefrag) $(the_lib) $(the_lib).so $(the_pdb) $(the_mdb)
53
54 ifdef LIBRARY_NEEDS_POSTPROCESSING
55 build_libdir = fixup/$(PROFILE)/
56 build_lib = $(build_libdir)$(LIBRARY_NAME)
57 library_CLEAN_FILES += $(build_lib) $(build_lib:.dll=.pdb)
58 else
59 build_lib = $(the_lib)
60 endif
61
62 ifdef NO_SIGN_ASSEMBLY
63 SN = :
64 else
65 sn = $(topdir)/class/lib/net_1_1_bootstrap/sn.exe
66 SN = $(Q) MONO_PATH="$(topdir)/class/lib/net_1_1_bootstrap$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) $(RUNTIME_FLAGS) $(sn)
67 SNFLAGS = -q -R
68 endif
69
70 ifeq ($(PLATFORM), win32)
71 GACDIR = `cygpath -w $(mono_libdir)`
72 GACROOT = `cygpath -w $(DESTDIR)$(mono_libdir)`
73 test_flags += -d:WINDOWS
74 else
75 GACDIR = $(mono_libdir)
76 GACROOT = $(DESTDIR)$(mono_libdir)
77 endif
78
79 all-local: $(the_lib)
80
81 install-local: all-local
82 test-local: all-local
83 uninstall-local:
84
85 ifdef NO_INSTALL
86 install-local uninstall-local:
87         @:
88
89 else
90
91 ifdef LIBRARY_INSTALL_DIR
92 install-local:
93         $(MKINSTALLDIRS) $(DESTDIR)$(LIBRARY_INSTALL_DIR)
94         $(INSTALL_LIB) $(the_lib) $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME)
95         test ! -f $(the_lib).mdb || $(INSTALL_LIB) $(the_lib).mdb $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME).mdb
96
97 uninstall-local:
98         -rm -f $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME) $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME).mdb
99
100 else
101
102 # If RUNTIME_HAS_CONSISTENT_GACDIR is set, it implies that the internal GACDIR
103 # of the runtime is the same as the GACDIR we want.  So, we don't need to pass it
104 # to gacutil.  Note that the GACDIR we want may not be the same as the value of
105 # GACDIR set above, since the user could have overridden the value of $(prefix).
106 #
107 # This makes a difference only when we're building from the mono/ tree, since we
108 # have to ensure that the internal GACDIR of the in-tree runtime matches where we
109 # install the DLLs.
110
111 ifndef RUNTIME_HAS_CONSISTENT_GACDIR
112 gacdir_flag = /gacdir $(GACDIR)
113 endif
114
115 ifndef LIBRARY_PACKAGE
116 ifdef LIBRARY_COMPAT
117 LIBRARY_PACKAGE = compat-$(FRAMEWORK_VERSION)
118 else
119 LIBRARY_PACKAGE = $(FRAMEWORK_VERSION)
120 endif
121 endif
122
123 ifneq (none, $(LIBRARY_PACKAGE))
124 package_flag = /package $(LIBRARY_PACKAGE)
125 endif
126
127 install-local: $(gacutil)
128         $(GACUTIL) /i $(the_lib) /f $(gacdir_flag) /root $(GACROOT) $(package_flag)
129
130 uninstall-local: $(gacutil)
131         -$(GACUTIL) /u $(LIBRARY_NAME:.dll=) $(gacdir_flag) /root $(GACROOT) $(package_flag)
132
133 endif # LIBRARY_INSTALL_DIR
134 endif # NO_INSTALL
135
136 clean-local:
137         -rm -f $(tests_CLEAN_FILES) $(library_CLEAN_FILES) $(CLEAN_FILES)
138
139 test-local run-test-local run-test-ondotnet-local:
140         @:
141
142 DISTFILES = $(wildcard *$(LIBRARY)*.sources) $(EXTRA_DISTFILES)
143
144 ASSEMBLY      = $(LIBRARY)
145 ASSEMBLY_EXT  = .dll
146 the_assembly  = $(the_lib)
147 include $(topdir)/build/tests.make
148
149 ifdef HAVE_CS_TESTS
150 DISTFILES += $(test_sourcefile)
151 endif
152
153 # make dist will collect files in .sources files from all profiles
154 dist-local: dist-default
155         subs=' ' ; \
156         for f in `$(topdir)/tools/removecomments.sh $(wildcard *$(LIBRARY).sources)` $(TEST_FILES) ; do \
157           case $$f in \
158           ../*) : ;; \
159           *) dest=`dirname $$f` ; \
160              case $$subs in *" $$dest "*) : ;; *) subs=" $$dest$$subs" ; $(MKINSTALLDIRS) $(distdir)/$$dest ;; esac ; \
161              cp -p $$f $(distdir)/$$dest || exit 1 ;; \
162           esac ; done ; \
163         for d in . $$subs ; do \
164           case $$d in .) : ;; *) test ! -f $$d/ChangeLog || cp -p $$d/ChangeLog $(distdir)/$$d ;; esac ; done
165
166 ifdef LIBRARY_NEEDS_POSTPROCESSING
167 dist-local: dist-fixup
168 FIXUP_PROFILES = default net_2_0
169 dist-fixup:
170         $(MKINSTALLDIRS) $(distdir)/fixup $(FIXUP_PROFILES:%=$(distdir)/fixup/%)
171 endif
172
173 ifndef LIBRARY_COMPILE
174 LIBRARY_COMPILE = $(CSCOMPILE)
175 endif
176
177 ifndef LIBRARY_SNK
178 LIBRARY_SNK = $(topdir)/class/mono.snk
179 endif
180
181 ifdef gacutil
182 $(gacutil):
183         cd $(topdir) && $(MAKE) PROFILE=net_1_1_bootstrap
184 endif
185
186 ifdef sn
187 $(sn):
188         cd $(topdir) && $(MAKE) PROFILE=net_1_1_bootstrap
189 endif
190
191 ifdef BUILT_SOURCES
192 ifeq (cat, $(PLATFORM_CHANGE_SEPARATOR_CMD))
193 BUILT_SOURCES_cmdline = $(BUILT_SOURCES)
194 else
195 BUILT_SOURCES_cmdline = `echo $(BUILT_SOURCES) | $(PLATFORM_CHANGE_SEPARATOR_CMD)`
196 endif
197 endif
198
199 Q_AOT=$(if $(V),,@echo "AOT [$(PROFILE)] $(notdir $(@))";)
200
201 # The library
202
203 $(the_lib): $(the_libdir)/.stamp
204
205 $(build_lib): $(response) $(sn) $(BUILT_SOURCES) $(build_libdir:=/.stamp)
206 ifdef LIBRARY_USE_INTERMEDIATE_FILE
207         $(LIBRARY_COMPILE) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS) -target:library -out:$(LIBRARY_NAME) $(BUILT_SOURCES_cmdline) @$(response)
208         $(SN) $(SNFLAGS) $(LIBRARY_NAME) $(LIBRARY_SNK)
209         $(Q) mv $(LIBRARY_NAME) $@
210         $(Q) test ! -f $(LIBRARY_NAME).mdb || mv $(LIBRARY_NAME).mdb $@.mdb
211         $(Q) test ! -f $(LIBRARY_NAME:.dll=.pdb) || mv $(LIBRARY_NAME:.dll=.pdb) $(dir $@)$(LIBRARY_NAME:.dll=.pdb)
212 else
213         $(LIBRARY_COMPILE) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS) -target:library -out:$@ $(BUILT_SOURCES_cmdline) @$(response)
214         $(SN) $(SNFLAGS) $@ $(LIBRARY_SNK)
215 endif
216 ifdef ENABLE_AOT
217 ifneq (,$(filter $(AOT_IN_PROFILES), $(PROFILE)))
218         $(Q_AOT) MONO_PATH=$(the_libdir) $(RUNTIME) --aot=bind-to-runtime-version $@ > $(PROFILE)_aot.log 2>&1
219 endif
220 endif
221
222 $(makefrag): $(sourcefile)
223         @echo Creating $@ ...
224         @sed 's,^,$(build_lib): ,' $< >$@
225
226 ifneq ($(response),$(sourcefile))
227 $(response): $(sourcefile) $(PLATFORM_excludes)
228         @echo Creating $@ ...
229         @sort $(sourcefile) $(PLATFORM_excludes) | uniq -u | $(PLATFORM_CHANGE_SEPARATOR_CMD) >$@
230 endif
231
232 -include $(makefrag)
233
234 # for now, don't give any /lib flags or set MONO_PATH, since we
235 # give a full path to the assembly.
236
237 ## Include corcompare stuff
238 include $(topdir)/build/corcompare.make
239
240 all-local: $(makefrag) $(test_makefrag) $(btest_makefrag)
241 ifneq ($(response),$(sourcefile))
242 $(response): $(topdir)/build/library.make $(depsdir)/.stamp
243 endif
244 $(makefrag) $(test_response) $(test_makefrag) $(btest_response) $(btest_makefrag): $(topdir)/build/library.make $(depsdir)/.stamp
245
246 ## Documentation stuff
247
248 Q_MDOC_UP=$(if $(V),,@echo "MDOC-UP [$(PROFILE)] $(notdir $(@))";)
249 MDOC_UP  =$(Q_MDOC_UP) \
250         if `echo $(PROFILE) | grep ^net_1_ > /dev/null 2>/dev/null` ; then    \
251                 $(RUNTIME) $(topdir)/tools/mdoc/monodocer1.exe                      \
252                         -path:Documentation/en -assembly:$(the_lib) ;                     \
253         else                                                                  \
254                 $(RUNTIME) $(topdir)/tools/mdoc/mdoc.exe update --delete            \
255                         -o Documentation/en $(the_lib) ;                                  \
256         fi
257
258 doc-update-local: $(the_libdir)/.doc-stamp
259
260 $(the_libdir)/.doc-stamp: $(the_lib)
261         $(MDOC_UP)
262         @echo "doc-stamp" > $@
263