xbps/doc/Makefile

-include ../config.mk

# Makefile to build the libxbps API documentation.
#
DOXYF	?=	xbps_api_doxyfile
FORMAT	?=	png
FILES	=	xbps_transaction_dictionary.$(FORMAT)
FILES	+=	xbps_pkgdb_dictionary.$(FORMAT)
FILES	+=	xbps_pkg_props_dictionary.$(FORMAT)
FILES	+=	xbps_pkg_files_dictionary.$(FORMAT)
FILES	+=	xbps_binary_pkg_content.$(FORMAT)

.PHONY: all
all: $(FILES) doxyfiletrans doxygendocs

$(FILES): %.$(FORMAT): %.dot
	dot -T$(FORMAT) $< -o images/$@

doxyfiletrans: $(DOXYF).in
ifdef DISTVER
	sed -e "s|@@PROJECT_NUMBER@@|${DISTVER}|" $< > $(DOXYF)
else
	sed -e "s|@@PROJECT_NUMBER@@|$$(date +%Y%m%d)|" $< > $(DOXYF)
endif

doxygendocs: $(FILES) doxyfiletrans
	doxygen $(DOXYF)

.PHONY: clean
clean:
	-rm -f images/*.$(FORMAT)
	-rm -rf ../api
	-rm -f $(DOXYF)

.PHONY: install
install:
	install -d $(DESTDIR)$(SHAREDIR)/doc/xbps
	cp -r ../api $(DESTDIR)$(SHAREDIR)/doc/xbps
Added a configure script to emulate GNU autoconf and related changes. Changes included in this set: * Added strlcat() and strlcpy() from OpenBSD, always use them if the system does not have them built in. * Changed an array of PATH_MAX size allocated in the stack, to a dynamically allocated buffer from heap. This should reduce memory usage a bit. * Simplify code that implemented a homegrown realpath(3) implementation, simply use realpath(3). * If compiler supports -fstack-protector, build all code with -D_FORTIFY_SOURCE=2 and --param ssp-buffer-size=1 so that all buffers are protected. 2010-05-20 02:08:27 +05:30			`-include ../config.mk`

Add infrastructure changes to build the API documentation. doxygen and graphviz are required. It's disabled by default, use the BUILD_API_DOCS make(1) argument to enable it. --HG-- extra : convert_revision : xtraeme%40gmail.com-20100123013719-pkk3a3823cx09v8l 2010-01-23 07:07:19 +05:30			`# Makefile to build the libxbps API documentation.`
			`#`
			`DOXYF ?= xbps_api_doxyfile`
			`FORMAT ?= png`
			`FILES = xbps_transaction_dictionary.$(FORMAT)`
Update API documentation and dot files. 2013-09-25 14:45:04 +05:30			`FILES += xbps_pkgdb_dictionary.$(FORMAT)`
Add infrastructure changes to build the API documentation. doxygen and graphviz are required. It's disabled by default, use the BUILD_API_DOCS make(1) argument to enable it. --HG-- extra : convert_revision : xtraeme%40gmail.com-20100123013719-pkk3a3823cx09v8l 2010-01-23 07:07:19 +05:30			`FILES += xbps_pkg_props_dictionary.$(FORMAT)`
			`FILES += xbps_pkg_files_dictionary.$(FORMAT)`
			`FILES += xbps_binary_pkg_content.$(FORMAT)`

			`.PHONY: all`
Transform PROJECT_NUMBER in the doxyfile. --HG-- rename : doc/xbps_api_doxyfile => doc/xbps_api_doxyfile.in 2011-02-05 17:04:45 +05:30			`all: $(FILES) doxyfiletrans doxygendocs`
Add infrastructure changes to build the API documentation. doxygen and graphviz are required. It's disabled by default, use the BUILD_API_DOCS make(1) argument to enable it. --HG-- extra : convert_revision : xtraeme%40gmail.com-20100123013719-pkk3a3823cx09v8l 2010-01-23 07:07:19 +05:30
			`$(FILES): %.$(FORMAT): %.dot`
			`dot -T$(FORMAT) $< -o images/$@`

Transform PROJECT_NUMBER in the doxyfile. --HG-- rename : doc/xbps_api_doxyfile => doc/xbps_api_doxyfile.in 2011-02-05 17:04:45 +05:30			`doxyfiletrans: $(DOXYF).in`
doc/Makefile: use DISTVER as version for generated API docs if defined. 2011-05-25 19:18:55 +05:30			`ifdef DISTVER`
			`sed -e "s\|@@PROJECT_NUMBER@@\|${DISTVER}\|" $< > $(DOXYF)`
			`else`
Transform PROJECT_NUMBER in the doxyfile. --HG-- rename : doc/xbps_api_doxyfile => doc/xbps_api_doxyfile.in 2011-02-05 17:04:45 +05:30			`sed -e "s\|@@PROJECT_NUMBER@@\|$$(date +%Y%m%d)\|" $< > $(DOXYF)`
doc/Makefile: use DISTVER as version for generated API docs if defined. 2011-05-25 19:18:55 +05:30			`endif`
Transform PROJECT_NUMBER in the doxyfile. --HG-- rename : doc/xbps_api_doxyfile => doc/xbps_api_doxyfile.in 2011-02-05 17:04:45 +05:30
			`doxygendocs: $(FILES) doxyfiletrans`
Add infrastructure changes to build the API documentation. doxygen and graphviz are required. It's disabled by default, use the BUILD_API_DOCS make(1) argument to enable it. --HG-- extra : convert_revision : xtraeme%40gmail.com-20100123013719-pkk3a3823cx09v8l 2010-01-23 07:07:19 +05:30			`doxygen $(DOXYF)`

			`.PHONY: clean`
			`clean:`
			`-rm -f images/*.$(FORMAT)`
			`-rm -rf ../api`
Transform PROJECT_NUMBER in the doxyfile. --HG-- rename : doc/xbps_api_doxyfile => doc/xbps_api_doxyfile.in 2011-02-05 17:04:45 +05:30			`-rm -f $(DOXYF)`
Added a configure script to emulate GNU autoconf and related changes. Changes included in this set: * Added strlcat() and strlcpy() from OpenBSD, always use them if the system does not have them built in. * Changed an array of PATH_MAX size allocated in the stack, to a dynamically allocated buffer from heap. This should reduce memory usage a bit. * Simplify code that implemented a homegrown realpath(3) implementation, simply use realpath(3). * If compiler supports -fstack-protector, build all code with -D_FORTIFY_SOURCE=2 and --param ssp-buffer-size=1 so that all buffers are protected. 2010-05-20 02:08:27 +05:30
			`.PHONY: install`
			`install:`
			`install -d $(DESTDIR)$(SHAREDIR)/doc/xbps`
			`cp -r ../api $(DESTDIR)$(SHAREDIR)/doc/xbps`