?.*
AUTHORS.txt
INSTALL.txt
+README.txt
TAGS
\#*
\#.*
LOCALSTEPMAKE_TEMPLATES=lilypond ly
LILYPOND_BOOK_FLAGS=--extra-options '-e "(ly:set-option (quote internal-type-checking) \#t)"'
README_TOP_FILES= DEDICATION THANKS
-EXTRA_DIST_FILES= TRANSLATION
include $(depth)/make/stepmake.make
default: local-doc
+ifeq ($(out),www)
local-WWW-2: txt-to-html $(OUT_HTML_FILES)
local-WWW-clean: deep-WWW-clean
deep-WWW-clean:
rm -rf $(outdir)/wiki-dump
+endif
OUT_TXT_FILES = $(addprefix $(outdir)/, $(addsuffix .txt, $(README_TOP_FILES)))
ps: $(PS_FILES)
-# urg
default:
GENHTMLS = engraving colorado computer-notation
OUTGENHTMLS = $(addprefix $(outdir)/, $(GENHTMLS:%=%.html))
+ifeq ($(out),www)
local-WWW-2: $(addprefix $(outdir)/, $(BIB_FILES:.bib=.html) index.html)
+endif
$(outdir)/%.bib: %.bib
ln -f $< $@
mkdir -p $(dir $@)
ln -sf $(depth)/.. $(@)
+ifeq ($(out),www)
local-WWW-1: $(PDF_FILES)
local-WWW-2: $(HTML_FILES) $(OUT_HTML_FILES) $(source-links)
+endif
$(PDF_FILES) $(HTML_FILES): $(ITEXI_FILES)
local-dist: $(icon)
xgifs: $(OUTGIF_FILES)
pngs: $(OUTPNG_FILES)
+
+ifeq ($(out),www)
local-WWW-1: $(OUTPNG_FILES)
+endif
include $(depth)/make/stepmake.make
+ifeq ($(out),www)
local-WWW-1: $(OUT_TEXI_FILES)
+endif
.SECONDARY:
mkdir -p $(dir $@)
ln -sf $(depth)/.. $(@)
+ifeq ($(out),www)
local-WWW-1: $(MASTER_TEXI_FILES) $(PDF_FILES) info
local-WWW-2: $(HTML_FILES) $(DEEP_HTML_FILES) $(source-links)
+endif
$(outdir)/%.bib: %.bib
ln -f $< $@
The documentation is built by issuing
@example
-make web
+make doc
@end example
After compilation, the HTML documentation tree is available in
standard documentation path by issuing
@example
-make web-install
+make install-doc
@end example
@noindent
Separate installation of this documentation is done by issuing
@example
-make info-install
+make install-info
@end example
@noindent
-Note that to get the images in Info documentation, @code{web-install}
+Note that to get the images in Info documentation, @code{install-doc}
target creates symbolic links to HTML and PDF installed documentation
tree in @file{@var{prefix}/share/info}, in order to save disk space,
-whereas @code{info-install} copies images in
+whereas @code{install-info} copies images in
@file{@var{prefix}/share/info} subdirectories.
It is possible to build a documentation tree in
selection; this can be achieved by issuing
@example
-make WEB_TARGETS=online web
+make WEB_TARGETS=online doc
@end example
@noindent
./autogen.sh # ignore any warning messages
cp GNUmakefile.in GNUmakefile
make -C python
-nice make LILYPOND_EXTERNAL_BINARY=/path/to/bin/lilypond web
+nice make LILYPOND_EXTERNAL_BINARY=/path/to/bin/lilypond doc
@end example
Please note that this may break sometimes -- for example, if a new
python-modules:
$(MAKE) -C python
-do-top-doc: python-modules
+top-doc: python-modules
local-clean: local-clean-ChangeLog
local-clean-ChangeLog:
rm -f ChangeLog
-dist-toplevel-txt-files: do-top-doc
+dist-toplevel-txt-files: top-doc
-mkdir -p $(distdir)
ln $(TOPDOC_TXT_FILES) $(distdir)/
ln $(top-src-dir)/stepmake/aclocal.m4 $(distdir)/
-doc:
- $(MAKE) -C Documentation
-
info:
$(foreach d, $(INFO_DIRECTORIES),$(MAKE) -C $(d) out=www info && ) true
-info-install: info
+install-info: info
$(MAKE) out=www COPY_INFO_IMAGES=1 install-info-WWW
install-help2man:
$(MAKE) -C scripts man install-help2man
$(MAKE) -C lily man install-help2man
+install-doc:
+ $(MAKE) out=www install-WWW
+ $(MAKE) out=www install-info-WWW
+
+uninstall-doc:
+ $(MAKE) out=www uninstall-WWW
+
+local-install:
+ $(INSTALL) -d $(DESTDIR)$(local_lilypond_datadir)
+
+final-install:
+ @true
+
+ifeq ($(out),www)
# All web targets, except info image symlinks and info docs are
# installed in non-recursing target from TOP-SRC-DIR
install-WWW:
install-info-WWW:
$(foreach d, $(INFO_DIRECTORIES),$(MAKE) -C $(d) install-info && ) true
-web-install:
- $(MAKE) out=www install-WWW
- $(MAKE) out=www install-info-WWW
-
uninstall-WWW:
rm -rf $(DESTDIR)$(webdir)
-rmdir $(package_docdir)
$(MAKE) -C Documentation/user uninstall
$(MAKE) -C input/lsr uninstall
-web-uninstall:
- $(MAKE) out=www uninstall-WWW
-
-local-install:
- $(INSTALL) -d $(DESTDIR)$(local_lilypond_datadir)
-
-final-install:
- @true
-
# For online docs with content negotiation, issue `make web WEB_TARGETS=online'
# For both online and offline docs, issue `make web WEB_TARGETS="offline online"'
find $(outdir) -name '*-root' | xargs rm -rf
$(buildscript-dir)/www_post $(PACKAGE_NAME) $(TOPLEVEL_VERSION) $(outdir) "$(WEB_TARGETS)"
find $(outdir)/offline-root -type l -delete
+endif
tree-prefix = $(outdir)
src-ext = c cc yy ll hh icc py scm tex ps texi itexi tely itely sh
-web-clean: snippets-clean $(tree-share-prefix)/lilypond-force
+doc-clean: snippets-clean $(tree-share-prefix)/lilypond-force
default: $(config_h) build-dir-setup
test -n "$CONFIGURATION" && mc=" conf=$CONFIGURATION" || mc=""
+if make top-doc 1>/dev/null 2>&1; then
+ rm -f INSTALL.txt && ln Documentation/topdocs/out/INSTALL.txt .
+ rm -f README.txt && ln Documentation/topdocs/out/README.txt .
+fi
+
cat <<EOF
Type:
true
endif
+local-clean:
+ rm -f $(INFO_IMAGES_DIR)
+
+ifeq ($(out),www)
# All web targets, except info image symlinks and info docs are
# installed in non-recursing target from TOP-SRC-DIR
local-install-WWW: local-install-info
local-uninstall-WWW: local-uninstall-info
-local-clean:
- rm -f $(INFO_IMAGES_DIR)
-
local-WWW-1: info $(outdir)/lilypond-snippets.pdf \
$(outdir)/lilypond-snippets.texi
local-WWW-2: $(outdir)/lilypond-snippets/index.html \
$(outdir)/lilypond-snippets-big-page.html \
$(source-links)
+endif
.SECONDARY:
TITLE=Unofficial MusicXML test suite
TEST_SUITE_VERSION=0.1
+ifeq ($(out),www)
local-WWW-2: zip
+endif
zip: $(outdir)/MusicXML-TestSuite-$(TEST_SUITE_VERSION).zip
default:
+ifeq ($(out),www)
local-WWW-2: $(OUT_HTML_FILES)
$(buildscript-dir)/mass-link --prepend-suffix .$(ISOLANG) hard $(outdir) $(top-build-dir)/Documentation/$(outdir) $(HTML_FILES)
+endif
+default:
+
+ifeq ($(out),www)
local-WWW-1: $(MASTER_TEXI_FILES) $(PDF_FILES)
local-WWW-2: $(HTML_FILES)
find $(outdir) -name '*.html' | sed 's!$(outdir)/!!g' | xargs $(buildscript-dir)/mass-link --prepend-suffix .$(ISOLANG) hard $(outdir) $(top-build-dir)/Documentation/topdocs/$(outdir) NEWS.pdf
find $(outdir) \( -name 'lily-*.png' -o -name 'lily-*.ly' \) | sed 's!$(outdir)/!!g' | xargs $(buildscript-dir)/mass-link hard $(outdir) $(top-build-dir)/Documentation/topdocs/$(outdir)
+endif
default:
+ifeq ($(out),www)
local-WWW-1: $(MASTER_TEXI_FILES) $(PDF_FILES) $(XREF_MAPS_FILES)
local-WWW-2: $(DEEP_HTML_FILES) $(BIG_PAGE_HTML_FILES) $(DOCUMENTATION_LOCALE_TARGET)
$(DOCUMENTATION_LOCALE_TARGET):
$(MAKE) -C $(depth)/Documentation/po out=www messages
touch $@
+endif
+ifeq ($(out),www)
local-WWW-1: $(outdir)/collated-files.texi $(outdir)/collated-files.pdf
local-WWW-2: $(outdir)/collated-files.html
+endif
local-test-baseline:
rm -rf $(outdir)-baseline
all: $(OUT_FILES)
+ifeq ($(out),www)
local-WWW-1: $(ly_examples) $(pdf_examples) $(png_examples)
+endif
tar:
mkdir -p $(outdir)/$(tarball)
-.PHONY : all clean bin-clean config default dist doc exe help html lib TAGS\
- po web web-1 WWW-1 WWW-2 WWW-post local-WWW-1 local-WWW-2
+.PHONY : all clean bin-clean config default dist exe help html lib TAGS\
+ po doc doc-stage-1 WWW-1 WWW-2 WWW-post local-WWW-1 local-WWW-2
all: default
$(LOOP)
help: generic-help local-help
@echo -e "Generic targets:\n\
- all * update everything except website documentation\n\
+ all * update everything except documentation with images\n\
clean * remove all generated stuff in $(outdir)\n\
bin-clean * same as clean, except that mf/out is preserved\n\
default same as the empty target\n\
+ doc * update documentation with images in directory \`out-www'\n\
+ doc-stage-1 * update only PDF and Info documentation in directory \`out-www'\n\
+ doc-clean * clean \`out-www' directory\n\
exe update all executables\n\
help this help\n\
install * install programs and data (prefix=$(prefix))\n\
- uninstall* uninstall programs and data\n\
lib update all libraries\n\
- web * update website in directory \`out-www'\n\
- web-clean * clean \`out-www' directory\n\
+ uninstall* uninstall programs and data\n\
TAGS generate tagfiles\n\
\n\
\`make' may be invoked from any subdirectory.\n\
# plus WWW-post (only at toplevel)
# see INSTALL for more information.
+ifeq ($(out),www)
local-WWW-1:
local-WWW-2:
WWW-post:
WWW-2: local-WWW-2
$(LOOP)
+endif
-web: web-1
+doc: doc-stage-1
$(MAKE) out=www WWW-2
$(MAKE) out=www WWW-post
-web-1:
+doc-stage-1:
$(MAKE) -C $(depth)/scripts/build out=
$(MAKE) out=www WWW-1
-web-clean:
+doc-clean:
$(MAKE) out=www clean
ifeq ($(strip $(depth)),.)
po: new-po
$(LOOP)
-localpo:
+local-po:
@true
else
-po: localpo
+po: local-po
$(LOOP)
ALL_PO_SOURCES = $(ALL_C_SOURCES) $(ALL_CC_SOURCES) $(PYTHON_SCRIPTS_IN) $(PY_MODULES_IN) $(SCM_FILES) $(wildcard $(outdir)/*.hh) $(wildcard $(outdir)/*.cc)
-localpo:
+local-po:
ifneq ($(strip $(ALL_PO_SOURCES)),)
@echo $(ALL_PO_SOURCES)
xgettext --default-domain=$(package) --join \
default: $(INFO_FILES)
+ifeq ($(out),www)
local-WWW-1: $(XREF_MAPS_FILES)
+endif
local-doc: $(OUTTXT_FILES)
default: local-doc
+ifeq ($(out),www)
local-WWW-1: $(PDF_FILES)
local-WWW-2: $(HTML_FILES)
+endif
-make-txt-files: $(TO_TOP_FILES)
+txt-files: $(TO_TOP_FILES)
-.PHONY: web-install
-web-install:
-web-uninstall:
+.PHONY: install-doc uninstall-doc
+install-doc:
+uninstall-doc:
local-dist: configure
$(MAKE) -C Documentation/pictures icon
-do-top-doc:
- -$(MAKE) -C Documentation/topdocs/ README_TOP_FILES="$(TOPDOC_FILES)" make-txt-files
+top-doc:
+ $(MAKE) -C Documentation/topdocs/ README_TOP_FILES="$(TOPDOC_FILES)" txt-files
-$(README_TXT_FILES): do-top-doc
+$(README_TXT_FILES): top-doc
local-clean:
$(MAKE) final-install
endif
-local-dist: do-top-doc
+local-dist: top-doc
dist:
rm -rf $(distdir)
config rerun configure\n\
dist roll tarball: $(depth)/$(outdir)/$(distname).tar.gz\n\
distclean also remove configure output\n\
- doc update all documentation (without images)\n\
- info build Info documentation with images\n\
- info-install install Info documentation with images\n\
cvs-clean also remove out directories and generated files\n\
maintainerclean also remove distributed generated files\n\
po make new translation Portable Object database\n\
po-replace do po-update and replace catalogs with msgmerged versions\n\
po-update update translation Portable Object database\n\
- web-install * install website documentation in (webdir=$(webdir))\n\
+\n\
+ install-doc install website documentation in (webdir=$(webdir))\n\
and Info documentation with images\n\
- web-uninstall * remove installed documentation with images\n\
+ uninstall-doc remove installed documentation with images\n\
+ info build Info documentation with images\n\
+ install-info install Info documentation with images\n\
\n\
Some more targets are available for testing changes:\n\
test-baseline check test-redo test-clean\n\