geany/doc/Makefile.am

174 lines
5.0 KiB
Makefile

man_MANS=geany.1
if INSTALL_HTML_DOCS
htmldocimagesdir = $(docdir)/html/images
dist_htmldocimages_DATA = \
images/build_menu_commands_dialog.png \
images/find_dialog.png \
images/find_in_files_dialog.png \
images/main_window.png \
images/pref_dialog_edit_completions.png \
images/pref_dialog_edit_display.png \
images/pref_dialog_edit_features.png \
images/pref_dialog_edit_indentation.png \
images/pref_dialog_files.png \
images/pref_dialog_gen_misc.png \
images/pref_dialog_gen_startup.png \
images/pref_dialog_interface_interface.png \
images/pref_dialog_interface_notebook.png \
images/pref_dialog_interface_toolbar.png \
images/pref_dialog_keys.png \
images/pref_dialog_printing.png \
images/pref_dialog_templ.png \
images/pref_dialog_tools.png \
images/pref_dialog_various.png \
images/pref_dialog_vte.png \
images/replace_dialog.png
endif
doc_DATA = \
$(top_srcdir)/AUTHORS \
$(top_srcdir)/ChangeLog \
$(top_srcdir)/COPYING \
$(top_srcdir)/NEWS \
$(top_srcdir)/README \
$(top_srcdir)/THANKS \
$(top_srcdir)/TODO
DOCDIR = $(DESTDIR)$(docdir)
EXTRA_DIST = \
geany.html \
geany.css \
geany.txt \
geany.1
# HTML user manual and hacking file
if WITH_RST2HTML
geany.html: $(srcdir)/geany.css $(srcdir)/geany.txt
$(AM_V_GEN)$(RST2HTML) -stg --stylesheet=$(srcdir)/geany.css $(srcdir)/geany.txt $@
hacking.html: $(srcdir)/geany.css $(top_srcdir)/HACKING
$(AM_V_GEN)$(RST2HTML) -stg --stylesheet=$(srcdir)/geany.css $(top_srcdir)/HACKING $@
all-local: geany.html hacking.html
# clean on 'maintainer-clean' rather than 'clean' in case it was not
# built by Make but rather part of the distribution. This is fine even
# then, as configure will properly require what is needed to build it
# again if it is missing.
maintainer-clean-local: maintainer-clean-html-local
maintainer-clean-html-local:
-rm -f geany.html
clean-local: clean-html-local
clean-html-local:
-rm -f hacking.html
endif
# PDF user manual
if WITH_RST2PDF
geany-$(VERSION).pdf: geany.txt
$(AM_V_GEN)$(RST2PDF) $(srcdir)/geany.txt -o $@
all-local: geany-$(VERSION).pdf
clean-local: clean-pdf-local
clean-pdf-local:
-rm -f geany-$(VERSION).pdf
endif
# API Documentation
if WITH_DOXYGEN
doxygen_sources = \
$(srcdir)/plugins.dox \
$(srcdir)/pluginsignals.c \
$(srcdir)/pluginsymbols.c \
$(srcdir)/stash-example.c \
$(srcdir)/stash-gui-example.c
EXTRA_DIST += $(doxygen_sources)
doxygen_dependencies = \
$(doxygen_sources) \
$(top_srcdir)/src/*.[ch] \
$(top_srcdir)/plugins/geanyplugin.h \
$(top_srcdir)/src/tagmanager/tm_source_file.[ch] \
$(top_srcdir)/src/tagmanager/tm_workspace.[ch] \
$(top_srcdir)/src/tagmanager/tm_tag.h \
$(top_srcdir)/src/tagmanager/tm_parser.h
Doxyfile.stamp: Doxyfile $(doxygen_dependencies)
$(AM_V_GEN)$(DOXYGEN) Doxyfile && echo "" > $@
ALL_LOCAL_TARGETS = Doxyfile.stamp
CLEAN_LOCAL_TARGETS = clean-api-docs-local
clean-api-docs-local:
-rm -rf reference/ Doxyfile.stamp doxygen_*
if ENABLE_GTKDOC_HEADER
# set WARN_IF_UNDOCUMENTED because apparently doxygens warns for undocumented stuff
# in headers (even though it's correctly documented in the corresponding .c file) only
# for xml output
Doxyfile-gi: Doxyfile
$(AM_V_GEN)$(SED) \
-e 's,gironly=@internal,gironly=,' \
-e 's,^\(GENERATE_HTML.*\)YES,\1NO,' \
-e 's,^\(GENERATE_XML.*\)NO,\1YES,' \
-e 's,^\(WARN_IF_UNDOCUMENTED.*\)YES,\1NO,' \
-e 's,^\(SORT_MEMBER_DOCS.*\)YES,\1NO,' \
-e 's,^\(SORT_BRIEF_DOCS.*\)YES,\1NO,' \
$< > $@ || { $(RM) $@ && exit 1; }
# we depend on Doxyfile.stamp not have this run in parallel with it to avoid
# concurrent Doxygen runs, which might overwrite each other's files
Doxyfile-gi.stamp: Doxyfile-gi Doxyfile.stamp $(doxygen_dependencies)
$(AM_V_GEN)$(DOXYGEN) Doxyfile-gi && echo "" > $@
geany-gtkdoc.h: Doxyfile-gi.stamp $(top_srcdir)/scripts/gen-api-gtkdoc.py
$(AM_V_GEN)$(top_srcdir)/scripts/gen-api-gtkdoc.py xml -d $(builddir) -o $@ \
--sci-output geany-sciwrappers-gtkdoc.h
geany-sciwrappers-gtkdoc.h: geany-gtkdoc.h
geany_gtkdocincludedir = $(includedir)/geany/gtkdoc
nodist_geany_gtkdocinclude_HEADERS = geany-gtkdoc.h geany-sciwrappers-gtkdoc.h
ALL_LOCAL_TARGETS += geany-gtkdoc.h geany-sciwrappers-gtkdoc.h
CLEAN_LOCAL_TARGETS += clean-gtkdoc-header-local
clean-gtkdoc-header-local:
-rm -rf xml/ Doxyfile-gi Doxyfile-gi.stamp geany-gtkdoc.h geany-sciwrappers-gtkdoc.h
endif
all-local: $(ALL_LOCAL_TARGETS)
clean-local: $(CLEAN_LOCAL_TARGETS)
endif
uninstall-local:
rm -f $(DOCDIR)/html/index.html
rm -f $(DOCDIR)/manual.txt
rm -f $(DOCDIR)/ScintillaLicense.txt
# manually install some files under another name
install-data-local:
if INSTALL_HTML_DOCS
$(mkinstalldirs) $(DOCDIR)/html
# as we don't install with the automated mechanism so we can rename the file,
# we need to find the source file in the right location (either builddir or srcdir)
dir=$(builddir); test -f "$$dir/geany.html" || dir=$(srcdir); \
$(INSTALL_DATA) "$$dir/geany.html" $(DOCDIR)/html/index.html
endif
$(mkinstalldirs) $(DOCDIR)
$(INSTALL_DATA) $(srcdir)/geany.txt $(DOCDIR)/manual.txt
$(INSTALL_DATA) $(top_srcdir)/scintilla/License.txt $(DOCDIR)/ScintillaLicense.txt