1 ############################################################################
3 # This is the top-level Makefile for GHC
8 # Builds GHC, then builds the libraries,
9 # then uses this GHC ("stage 1") to build itself
16 # bootstrap2 + we build GHC one more time ("stage 3")
19 # Just build up to stage 1
22 # Just build stage 2 (stage 1 must be built)
25 # Just build stage 3 (stage 2 must be built)
31 # Install everything, including stage 2 compiler by default
32 # (override with stage=3, for example).
35 # Make a source dist (WARNING: runs 'make distclean' first)
38 # Builds a binary distribution
41 # Builds an HC-file bundle, for bootstrapping
43 # clean, distclean, maintainer-clean
44 # Increasing levels of cleanliness
46 ############################################################################
49 include $(TOP)/mk/boilerplate.mk
52 # Order is important! It's e.g. necessary to descend into include/
53 # before the rest to have a config.h, etc.
55 # If we're booting from .hc files, swap the order
56 # we descend into subdirs - to boot utils must be before driver.
58 .PHONY: stage1 stage2 stage3 bootstrap bootstrap2 bootstrap3
60 # We can't 'make boot' in libraries until stage1 is built
61 ifeq "$(BootingFromHc)" "YES"
62 SUBDIRS_NOLIB = includes rts compat compiler docs utils driver
64 SUBDIRS_NOLIB = includes compat utils driver docs compiler rts
67 SUBDIRS = $(SUBDIRS_NOLIB) libraries
70 $(MAKE) -C utils/mkdependC boot
71 @case '${MFLAGS}' in *-[ik]*) x_on_err=0;; *-r*[ik]*) x_on_err=0;; *) x_on_err=1;; esac; \
72 for i in $(SUBDIRS_NOLIB); do \
73 echo "------------------------------------------------------------------------"; \
74 echo "== $(MAKE) boot $(MFLAGS);"; \
75 echo " in $(shell pwd)/$$i"; \
76 echo "------------------------------------------------------------------------"; \
77 $(MAKE) --no-print-directory -C $$i $(MFLAGS) boot; \
78 if [ $$? -eq 0 -o $$x_on_err -eq 0 ] ; then true; else exit 1; fi; \
80 for i in $(SUBDIRS_NOLIB); do \
81 echo "------------------------------------------------------------------------"; \
82 echo "== $(MAKE) all $(MFLAGS);"; \
83 echo " in $(shell pwd)/$$i"; \
84 echo "------------------------------------------------------------------------"; \
85 $(MAKE) --no-print-directory -C $$i $(MFLAGS) all; \
86 if [ $$? -eq 0 -o $$x_on_err -eq 0 ] ; then true; else exit 1; fi; \
88 @$(MAKE) -C libraries boot
89 @$(MAKE) -C libraries all
92 $(MAKE) -C compiler boot stage=2
93 $(MAKE) -C compiler stage=2
96 $(MAKE) -C compiler boot stage=3
97 $(MAKE) -C compiler stage=3
99 bootstrap : bootstrap2
104 bootstrap3 : bootstrap2
109 # -----------------------------------------------------------------------------
112 # We want to install the stage 2 bootstrapped compiler by default, but we let
113 # the user override this by saying 'make install stage=1', for example.
115 INSTALL_STAGE = stage=2
120 # Same as default rule, but we pass $(INSTALL_STAGE) to $(MAKE) too
122 @case '${MFLAGS}' in *-[ik]*) x_on_err=0;; *-r*[ik]*) x_on_err=0;; *) x_on_err=1;; esac; \
123 for i in $(SUBDIRS); do \
124 echo "------------------------------------------------------------------------"; \
125 echo "== $(MAKE) $@ $(MFLAGS);"; \
126 echo " in $(shell pwd)/$$i"; \
127 echo "------------------------------------------------------------------------"; \
128 $(MAKE) --no-print-directory -C $$i $(INSTALL_STAGE) $(MFLAGS) $@; \
129 if [ $$? -eq 0 -o $$x_on_err -eq 0 ] ; then true; else exit 1; fi; \
132 ifeq "$(TARGETPLATFORM)" "i386-unknown-mingw32"
133 # These files need to be in the InstallShield
134 # INSTALL_DATAS rather than INSTALL_DOCS is used so these files go
135 # in the top-level directory of the distribution
136 INSTALL_DATAS += ANNOUNCE LICENSE README
139 # If installing on Windows with MinGW32, copy the gcc compiler, headers and libs
140 # and the perl interpreter and dll into the GHC prefix directory.
141 # Gcc and Perl source locations derived from configuration data.
142 ifeq "$(TARGETPLATFORM)" "i386-unknown-mingw32"
143 ifneq "$(WhatGccIsCalled)" ""
145 -mkdir $(prefix)/gcc-lib
146 -mkdir $(prefix)/include
147 -mkdir $(prefix)/include/mingw
148 -cp -rp $(GccDir)../include/* $(prefix)/include/mingw
149 -cp -rp $(GccDir)../lib/gcc-lib/mingw32/$(GccVersion)/* $(prefix)/gcc-lib
150 -cp $(GccDir)../lib/*.* $(prefix)/gcc-lib
151 -cp $(GccDir)gcc.exe $(prefix)
152 -cp $(GccDir)as.exe $(prefix)/gcc-lib
153 -cp $(GccDir)ld.exe $(prefix)/gcc-lib
154 -cp $(GccDir)dllwrap.exe $(prefix)/gcc-lib
155 -cp $(GccDir)dlltool.exe $(prefix)/gcc-lib
156 -cp $(GhcDir)../perl.exe $(prefix)
157 -cp $(GhcDir)../perl56.dll $(prefix)
162 @case '${MFLAGS}' in *-[ik]*) x_on_err=0;; *-r*[ik]*) x_on_err=0;; *) x_on_err=1;; esac; \
163 for i in $(SUBDIRS); do \
164 echo "------------------------------------------------------------------------"; \
165 echo "== $(MAKE) $@ $(MFLAGS);"; \
166 echo " in $(shell pwd)/$$i"; \
167 echo "------------------------------------------------------------------------"; \
168 $(MAKE) --no-print-directory -C $$i $(INSTALL_STAGE) $(MFLAGS) $@; \
169 if [ $$? -eq 0 -o $$x_on_err -eq 0 ] ; then true; else exit 1; fi; \
172 # -----------------------------------------------------------------------------
173 # Making a binary distribution
175 # `dist' `binary-dist'
176 # Create a distribution tar file for this program. The tar file
177 # should be set up so that the file names in the tar file start with
178 # a subdirectory name which is the name of the package it is a
179 # distribution for. This name can include the version number.
181 # For example, the distribution tar file of GCC version 1.40 unpacks
182 # into a subdirectory named `gcc-1.40'.
184 # The easiest way to do this is to create a subdirectory
185 # appropriately named, use ln or cp to install the proper files in
186 # it, and then tar that subdirectory.
188 # The dist target should explicitly depend on all non-source files
189 # that are in the distribution, to make sure they are up to date in
190 # the distribution. See Making Releases.
192 # binary-dist is a GHC addition for binary distributions
195 ifneq "$(TARGETPLATFORM)" "i386-unknown-mingw32"
196 BinDistShScripts = ghc-$(ProjectVersion) ghci-$(ProjectVersion) ghc-pkg-$(ProjectVersion) hsc2hs
201 BinDistPrlScripts = ghcprof
202 BinDistLibPrlScripts = ghc-asm ghc-split
203 BinDistBins = hp2ps runghc
204 BinDistOptBins = runhaskell
205 BinDistLinks = ghc ghci ghc-pkg
206 BinDistLibSplicedFiles = package.conf
207 BinDistDirs = includes compiler docs driver libraries rts utils
209 BIN_DIST_NAME=ghc-$(ProjectVersion)
210 BIN_DIST_TMPDIR=$(FPTOOLS_TOP_ABS)
212 BIN_DIST_TOP= distrib/Makefile-bin.in \
213 distrib/configure-bin.ac \
218 utils/mkdirhier/mkdirhier \
224 ifeq "$(darwin_TARGET_OS)" "1"
225 BIN_DIST_TOP+=mk/fix_install_names.sh
228 .PHONY: binary-dist-pre binary-dist binary-pack
230 binary-dist:: binary-dist-pre
233 ifeq "$(BIN_DIST)" ""
234 @echo "WARNING: To run the binary-dist target, you need to set BIN_DIST=1 in mk/build.mk" && exit 1
236 -rm -rf $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)
237 -$(RM) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME).tar.gz
238 @for i in $(BinDistDirs); do \
239 if test -d "$$i"; then \
240 echo $(MKDIRHIER) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM); \
241 $(MKDIRHIER) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM); \
242 echo $(MKDIRHIER) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM); \
243 $(MKDIRHIER) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM); \
244 echo $(MKDIRHIER) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/share; \
245 $(MKDIRHIER) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/share; \
246 echo $(MAKE) -C $$i $(MFLAGS) $(INSTALL_STAGE) install \
247 prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
248 exec_prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
249 bindir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM) \
250 libdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
251 libexecdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
252 datadir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/share; \
253 $(MAKE) -C $$i $(MFLAGS) $(INSTALL_STAGE) install \
254 prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
255 exec_prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
256 bindir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM) \
257 libdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
258 libexecdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
259 datadir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/share; \
264 @for i in $(BIN_DIST_TOP); do \
265 if test -f "$$i"; then \
266 echo cp $$i $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME); \
267 cp $$i $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME); \
270 @echo "Configuring the Makefile for this project..."
271 touch $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
272 echo "package = ghc" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
273 echo "version = $(ProjectVersion)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
274 echo "PACKAGE_SH_SCRIPTS = $(BinDistShScripts)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
275 echo "PACKAGE_PRL_SCRIPTS = $(BinDistPrlScripts)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
276 echo "PACKAGE_LIB_PRL_SCRIPTS = $(BinDistLibPrlScripts)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
277 echo "PACKAGE_LIB_SPLICED_FILES = $(BinDistLibSplicedFiles)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
278 echo "PACKAGE_BINS = $(BinDistBins)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
279 echo "PACKAGE_OPT_BINS = $(BinDistOptBins)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
280 echo "PACKAGE_LINKS = $(BinDistLinks)" >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
281 cat $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile-bin.in >> $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/Makefile.in
282 @echo "Generating a shippable configure script.."
283 $(MV) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/configure-bin.ac $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/configure.ac
284 ( cd $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME); autoconf )
286 # binary dist'ing the documentation.
287 # The default documentation to build/install is given below; overrideable
288 # via build.mk or the 'make' command-line.
290 ifndef BINDIST_DOC_WAYS
292 ifneq "$(XSLTPROC)" ""
293 BINDIST_DOC_WAYS = html
295 BINDIST_DOC_WAYS += ps pdf
297 ifneq "$(PDFXMLTEX)" ""
298 BINDIST_DOC_WAYS += pdf
302 BINDIST_DOC_WAYS += ps
308 endif # BINDIST_DOC_WAYS
311 ifneq "$(DIR_DOCBOOK_XSL)" ""
312 @for i in $(BinDistDirs); do \
313 if test -d "$$i"; then \
314 $(MAKE) -C $$i $(MFLAGS) $(BINDIST_DOC_WAYS); \
315 echo $(MAKE) -C $$i $(MFLAGS) install-docs XMLDocWays="$(BINDIST_DOC_WAYS)" \
316 prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
317 exec_prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
318 bindir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM) \
319 libdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
320 libexecdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
321 datadir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/share; \
322 $(MAKE) -C $$i $(MFLAGS) install-docs XMLDocWays="$(BINDIST_DOC_WAYS)" \
323 prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
324 exec_prefix=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME) \
325 bindir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM) \
326 libdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
327 libexecdir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM) \
328 datadir=$(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/share; \
333 # Rename scripts to $i.prl and $i.sh where necessary.
334 # ToDo: do this in a cleaner way...
336 ifneq "$(BinDistPrlScripts)" ""
338 @for i in $(BinDistPrlScripts); do \
339 echo "Renaming $$i to $$i.prl"; \
340 $(MV) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM)/$$i $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM)/$$i.prl; \
344 ifneq "$(BinDistLibPrlScripts)" ""
346 @for i in $(BinDistLibPrlScripts); do \
347 echo "Renaming $$i to $$i.prl"; \
348 $(MV) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM)/$$i $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/lib/$(TARGETPLATFORM)/$$i.prl; \
352 ifneq "$(BinDistShScripts)" ""
354 @for i in $(BinDistShScripts); do \
355 if test -x $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM)/$$i ; then \
356 echo "Renaming $$i to $$i.sh"; \
357 $(MV) $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM)/$$i $(BIN_DIST_TMPDIR)/$(BIN_DIST_NAME)/bin/$(TARGETPLATFORM)/$$i.sh; \
363 # Do this separately for now
366 ( cd $(BIN_DIST_TMPDIR); $(TAR) chzf $(BIN_DIST_NAME).tar.gz $(BIN_DIST_NAME) )
369 .PHONY: package-way-dist
371 ( cd $(BIN_DIST_TMPDIR); $(FIND) $(BIN_DIST_NAME)/ \( -name "*$(_way).a" -o -name "*.$(way_)hi" \) -print | xargs tar cvf $(BIN_DIST_TMPDIR)/ghc-$(ProjectVersion)-$(way)-$(TARGETPLATFORM).tar )
372 gzip $(BIN_DIST_TMPDIR)/ghc-$(ProjectVersion)-$(way)-$(TARGETPLATFORM).tar
377 ( cd $(BIN_DIST_TMPDIR); $(FIND) $(BIN_DIST_NAME)/ \( -name "*$(_way).a" -o -name "*.$(way_)hi" \) -print -exec $(RM) {} \; )
381 @echo "Mechanical and super-natty! Inspect the result and *if* happy; freeze, sell and get some sleep!"
383 # -----------------------------------------------------------------------------
384 # Building source distributions
391 # WARNING: `make dist' calls `make distclean' before tarring up the tree.
397 # Directory in which we're going to build the src dist
399 SRC_DIST_NAME=ghc-$(ProjectVersion)
400 SRC_DIST_DIR=$(shell pwd)/$(SRC_DIST_NAME)
403 # Files to include in source distributions
405 SRC_DIST_DIRS += docs distrib $(filter-out docs distrib,$(SUBDIRS))
407 configure.ac config.guess config.sub configure \
408 aclocal.m4 README ANNOUNCE HACKING LICENSE Makefile install-sh \
409 ghc.spec.in mk/bootstrap.mk \
410 mk/boilerplate.mk mk/config.h.in mk/config.mk.in mk/opts.mk \
411 mk/paths.mk mk/package.mk mk/suffix.mk mk/target.mk \
412 mk/fptools.css mk/fix_install_names.sh
414 # clean the tree first, leaving certain extra files in place (eg. configure)
418 -rm -rf $(SRC_DIST_DIR)
419 -$(RM) $(SRC_DIST_NAME).tar.gz
420 mkdir $(SRC_DIST_DIR)
421 mkdir $(SRC_DIST_DIR)/mk
422 $(FIND) $(SRC_DIST_DIRS) -type d \( -name _darcs -prune -o -name SRC -prune -o -name "autom4te*" -prune -o -print \) | sed -e 's!.*!mkdir "$(SRC_DIST_DIR)/&"!' | sh
423 $(FIND) $(SRC_DIST_DIRS) $(SRC_DIST_FILES) -name _darcs -prune -o -name SRC -prune -o -name "autom4te*" -prune -o -name "*~" -prune -o -name ".cvsignore" -prune -o -name "\#*" -prune -o -name ".\#*" -prune -o -name "log" -prune -o -name "*-SAVE" -prune -o -name "*.orig" -prune -o -name "*.rej" -prune -o ! -type d -print | sed -e 's!.*!$(LN_S) "$(FPTOOLS_TOP_ABS)/&" "$(SRC_DIST_DIR)/&"!' | sh
425 # Automatic generation of a MANIFEST file for a source distribution
426 # tree that is ready to go.
428 cd $(SRC_DIST_DIR); $(FIND) . \( -type l -o -type f \) -exec ls -lLG {} \; | sed -e 's/\.\///' > MANIFEST
430 dist-package :: dist-package-tar-gz
432 SRC_DIST_PATHS = $(patsubst %, $(SRC_DIST_NAME)/%, $(SRC_DIST_FILES) $(SRC_DIST_DIRS))
434 dist-package-tar-bz2 ::
435 BZIP2=-9 $(TAR) chjf $(SRC_DIST_NAME)-src.tar.bz2 $(SRC_DIST_NAME) || $(RM) $(SRC_DIST_NAME)-src.tar.bz2
437 dist-package-tar-gz ::
438 $(TAR) chzf $(SRC_DIST_NAME)-src.tar.gz $(SRC_DIST_NAME) || $(RM) $(SRC_DIST_NAME)-src.tar.gz
441 cd ..; $(LN_S) $(FPTOOLS_TOP_ABS) $(SRC_DIST_NAME) && \
442 $(ZIP) $(ZIP_OPTS) -r $(SRC_DIST_NAME)-src.zip $(SRC_DIST_PATHS)
444 # -----------------------------------------------------------------------------
448 $(RM) -r ghc-$(ProjectVersion)
449 $(LN_S) . ghc-$(ProjectVersion)
450 $(FIND) ghc-$(ProjectVersion)/compiler \
451 ghc-$(ProjectVersion)/utils \
452 ghc-$(ProjectVersion)/compat \
453 ghc-$(ProjectVersion)/libraries -follow \
454 \( -name "*.hc" -o -name "*_hsc.[ch]" -o -name "*_stub.[ch]" \) -print > hc-files-to-go
455 for f in `$(FIND) ghc-$(ProjectVersion)/compiler ghc-$(ProjectVersion)/utils ghc-$(ProjectVersion)/libraries -name "*.hsc" -follow -print` ""; do \
456 if test "x$$f" != "x" && test -e `echo "$$f" | sed 's/hsc$$/hs/g'`; then \
457 echo `echo "$$f" | sed 's/hsc$$/hs/g' ` >> hc-files-to-go ; \
460 for f in `$(FIND) ghc-$(ProjectVersion)/compiler ghc-$(ProjectVersion)/rts -name "*.cmm" -follow -print` ""; do \
461 if test "x$$f" != "x"; then \
462 echo `echo "$$f" | sed 's/cmm$$/hc/g' ` >> hc-files-to-go ; \
465 echo ghc-$(ProjectVersion)/libraries/base/GHC/PrimopWrappers.hs >> hc-files-to-go
466 echo ghc-$(ProjectVersion)/compiler/parser/Parser.hs >> hc-files-to-go
467 echo ghc-$(ProjectVersion)/compiler/parser/ParserCore.hs >> hc-files-to-go
468 echo ghc-$(ProjectVersion)/compiler/main/ParsePkgConf.hs >> hc-files-to-go
469 echo ghc-$(ProjectVersion)/libraries/haskell-src/Language/Haskell/Parser.hs >> hc-files-to-go
470 tar czf ghc-$(ProjectVersion)-$(TARGETPLATFORM)-hc.tar.gz `cat hc-files-to-go`
472 # -----------------------------------------------------------------------------
475 CLEAN_FILES += hc-files-to-go *-hc.tar.gz
477 DIST_CLEAN_FILES += config.cache config.status mk/config.h mk/stamp-h \
478 ghc.spec docs/users_guide/ug-book.xml
480 # don't clean config.mk: it's needed when cleaning stuff later on
481 LATE_DIST_CLEAN_FILES += mk/config.mk
484 $(RM) -rf autom4te.cache
486 # -----------------------------------------------------------------------------
488 # Turn off target.mk's rules for 'all', 'boot' and 'install'.
491 NO_INSTALL_TARGET=YES
493 include $(TOP)/mk/target.mk
495 # -----------------------------------------------------------------------------