doc: Make progdocs play nice with git
Moved contrib/asterisk-ng-doxygen to doc/asterisk-ng-doxygen.in Changed /Makefile to copy asterisk-ng-doxygen.in to asterisk-ng-doxygen then modify it with version instead of modifying asterisk-ng-doxygen directly. Updated clean targets as well. Updated /.gitignore and doc/.gitignore. Change-Id: I38712d3e334fa4baec19d30d05de8c6f28137622
This commit is contained in:
parent
97101bd481
commit
7de043e43d
4 changed files with 32 additions and 2 deletions
3
.gitignore
vendored
3
.gitignore
vendored
|
@ -31,3 +31,6 @@ menuselect-tree
|
|||
*.pyc
|
||||
*.gcno
|
||||
*.gcda
|
||||
latex
|
||||
doxygen.log
|
||||
|
||||
|
|
29
Makefile
29
Makefile
|
@ -430,6 +430,8 @@ _clean:
|
|||
rm -f main/version.c
|
||||
rm -f doc/core-en_US.xml
|
||||
rm -f doc/full-en_US.xml
|
||||
rm -f doxygen.log
|
||||
rm -rf latex
|
||||
@$(MAKE) -C menuselect clean
|
||||
cp -f .cleancount .lastclean
|
||||
|
||||
|
@ -445,6 +447,7 @@ distclean: $(SUBDIRS_DIST_CLEAN) _clean
|
|||
rm -f include/asterisk/autoconfig.h
|
||||
rm -f include/asterisk/buildopts.h
|
||||
rm -rf doc/api
|
||||
rm -f doc/asterisk-ng-doxygen
|
||||
rm -f build_tools/menuselect-deps
|
||||
|
||||
datafiles: _all doc/core-en_US.xml
|
||||
|
@ -742,8 +745,30 @@ webvmail:
|
|||
@echo " +-------------------------------------------+"
|
||||
|
||||
progdocs:
|
||||
(cat contrib/asterisk-ng-doxygen; echo "HAVE_DOT=$(HAVEDOT)"; \
|
||||
echo "PROJECT_NUMBER=$(ASTERISKVERSION)") | doxygen -
|
||||
# Note, Makefile conditionals must not be tabbed out. Wasted hours with that.
|
||||
@cp doc/asterisk-ng-doxygen.in doc/asterisk-ng-doxygen
|
||||
ifeq ($(DOXYGEN),:)
|
||||
@echo "Doxygen is not installed. Please install and re-run the configuration script."
|
||||
else
|
||||
ifeq ($(DOT),:)
|
||||
@echo "DOT is not installed. Doxygen will not produce any diagrams. Please install and re-run the configuration script."
|
||||
else
|
||||
# Enable DOT
|
||||
@echo "HAVE_DOT = YES" >> doc/asterisk-ng-doxygen
|
||||
endif
|
||||
# Set Doxygen PROJECT_NUMBER variable
|
||||
ifneq ($(ASTERISKVERSION),UNKNOWN__and_probably_unsupported)
|
||||
@echo "PROJECT_NUMBER = $(ASTERISKVERSION)" >> doc/asterisk-ng-doxygen
|
||||
else
|
||||
echo "Asterisk Version is unknown, not configuring Doxygen PROJECT_NUMBER."
|
||||
endif
|
||||
# Validate and auto-update local copy
|
||||
@doxygen -u doc/asterisk-ng-doxygen
|
||||
# Run Doxygen
|
||||
@doxygen doc/asterisk-ng-doxygen
|
||||
# Remove configuration backup file
|
||||
@rm -f doc/asterisk-ng-doxygen.bak
|
||||
endif
|
||||
|
||||
install-logrotate:
|
||||
if [ ! -d "$(DESTDIR)$(ASTETCDIR)/../logrotate.d" ]; then \
|
||||
|
|
2
doc/.gitignore
vendored
2
doc/.gitignore
vendored
|
@ -1 +1,3 @@
|
|||
core-en_US.xml
|
||||
api
|
||||
asterisk-ng-doxygen
|
||||
|
|
Loading…
Reference in a new issue