remove "doc" make target and rename "user_doc"

Fixes #2874
This commit is contained in:
Kurtis Rader 2016-03-30 15:35:14 -07:00
parent 7e014174b8
commit 35cee1e39c
3 changed files with 14 additions and 20 deletions

View file

@ -266,29 +266,23 @@ prof: all
# #
# User documentation, describing the features of the fish shell. # User documentation, describing the features of the fish shell.
# #
# Depend on the sources (*.hdr.in) and manually make the intermediate *.hdr
# Depend on the sources (*.hdr.in) and manually make the # and doc.h files if needed. The sed command deletes everything including and
# intermediate *.hdr and doc.h files if needed # after the first -, for simpler version numbers. Cleans up the user_doc/html
# The sed command deletes everything including and after the first -, for simpler version numbers # directory once Doxygen is done.
# Cleans up the user_doc/html directory once Doxygen is done. #
doc: $(HDR_FILES_SRC) Doxyfile.user $(HTML_SRC) $(HELP_SRC) doc.h \
user_doc: $(HDR_FILES_SRC) Doxyfile.user $(HTML_SRC) $(HELP_SRC) doc.h $(HDR_FILES) lexicon_filter $(HDR_FILES) lexicon_filter
(cat Doxyfile.user; echo INPUT_FILTER=./lexicon_filter; \ (cat Doxyfile.user; echo INPUT_FILTER=./lexicon_filter; \
echo PROJECT_NUMBER=$(FISH_BUILD_VERSION) | $(SED) "s/-.*//") | doxygen - && touch user_doc; \ echo PROJECT_NUMBER=$(FISH_BUILD_VERSION) | $(SED) "s/-.*//") | \
cd user_doc/html && rm -f bc_s.png bdwn.png closed.png ftv2*.png nav*.png open.png sync_*.png tab*.* doxygen.* dynsections.js jquery.js pages.html doxygen - && touch user_doc; \
cd user_doc/html && rm -f bc_s.png bdwn.png closed.png ftv2*.png \
# nav*.png open.png sync_*.png tab*.* doxygen.* dynsections.js \
# Source code documentation. Also includes user documentation. jquery.js pages.html
#
doc: src/*.h src/*.cpp doc.h Doxyfile lexicon_filter
(cat Doxyfile; echo INPUT_FILTER=./lexicon_filter; echo PROJECT_NUMBER=$(FISH_BUILD_VERSION)) | doxygen - ;
# #
# PDF version of the source code documentation. # PDF version of the source code documentation.
# #
doc/refman.pdf: doc doc/refman.pdf: doc
cd doc/latex && \ cd doc/latex && \
make && \ make && \

View file

@ -37,7 +37,7 @@ git archive --format=tar --prefix="$prefix"/ HEAD > "$path"
# Don't run autoheader since configure.ac runs it. autoconf is enough. # Don't run autoheader since configure.ac runs it. autoconf is enough.
autoconf autoconf
./configure --with-doxygen ./configure --with-doxygen
make user_doc share/man make doc share/man
echo $VERSION > version echo $VERSION > version
cd /tmp cd /tmp
rm -f "$prefix" rm -f "$prefix"

View file

@ -56,7 +56,7 @@ is transformed into:
`@cmnd{echo} @args{hello} @args{world}` `@cmnd{echo} @args{hello} @args{world}`
which is then transformed by Doxygen into an HTML version (`make user_doc`): which is then transformed by Doxygen into an HTML version (`make doc`):
`<span class="command">echo</span> <span class="argument">hello</span> <span class="argument">world</span>` `<span class="command">echo</span> <span class="argument">hello</span> <span class="argument">world</span>`