doc Makefile modified to let automake do much of the work
Also no longer using build/ directory for output and using -o in favor of stdout to correct @contents error.perfodd
parent
2d928215cd
commit
fdd7d0f1b2
|
@ -11,6 +11,9 @@
|
||||||
*.pdf
|
*.pdf
|
||||||
*.toc
|
*.toc
|
||||||
|
|
||||||
|
stamp-vti
|
||||||
version.texi
|
version.texi
|
||||||
easejs.info
|
easejs.info
|
||||||
stamp-vti
|
easejs.txt
|
||||||
|
easejs.html
|
||||||
|
easejs-single.html
|
||||||
|
|
|
@ -26,20 +26,20 @@ impl-details.texi integration.texi mkeywords.texi source-tree.texi
|
||||||
|
|
||||||
EXTRA_DIST = img README highlight.pack.js interactive.js easejs.css
|
EXTRA_DIST = img README highlight.pack.js interactive.js easejs.css
|
||||||
|
|
||||||
path_doc=.
|
|
||||||
path_build=../build
|
path_build=../build
|
||||||
path_lib=../lib
|
path_lib=../lib
|
||||||
docdir = @docdir@
|
docdir = @docdir@
|
||||||
path_doc_output=${path_build}/doc
|
path_doc_output_plain=easejs.txt
|
||||||
path_doc_output_plain=${path_doc_output}/easejs.txt
|
path_doc_output_html=easejs.html
|
||||||
path_doc_output_html=${path_doc_output}/easejs
|
path_doc_output_html1=easejs-single.html
|
||||||
path_doc_output_html1=${path_doc_output}/easejs.html
|
path_doc_css=easejs.css
|
||||||
path_doc_css=${path_doc}/easejs.css
|
path_doc_img=img
|
||||||
path_doc_img=${path_doc}/img
|
path_easejs_texi=easejs.texi
|
||||||
path_doc_css_ref=easejs.css
|
path_doc_css_ref=$(path_doc_css)
|
||||||
path_easejs_texi=${path_doc}/easejs.texi
|
|
||||||
|
|
||||||
doc_src := $(wildcard $(path_doc)/*.texi)
|
MAKEINFOHTML=$(MAKEINFO) --html --css-ref="$(path_doc_css_ref)"
|
||||||
|
|
||||||
|
doc_src := $(wildcard *.texi)
|
||||||
doc_imgs := $(patsubst %.dia, %.png, $(wildcard $(path_doc_img)/*.dia))
|
doc_imgs := $(patsubst %.dia, %.png, $(wildcard $(path_doc_img)/*.dia))
|
||||||
doc_imgs_txt := $(patsubst %.dia, %.png, $(wildcard $(path_doc_img)/*.txt))
|
doc_imgs_txt := $(patsubst %.dia, %.png, $(wildcard $(path_doc_img)/*.txt))
|
||||||
|
|
||||||
|
@ -49,55 +49,35 @@ doc_replace := s/<\/body>/<script type="text\/javascript" \
|
||||||
;s/\>\;=/\&\#8805\;/g\
|
;s/\>\;=/\&\#8805\;/g\
|
||||||
;s/\<\;=/\&\#8804\;/g
|
;s/\<\;=/\&\#8804\;/g
|
||||||
|
|
||||||
.PHONY: doc mkbuild-doc img pdf info plain html
|
.PHONY: doc mkbuild-doc img info html
|
||||||
|
|
||||||
# generate texinfo documentation (twice to generate TOC), then remove the extra
|
|
||||||
# files that were generated
|
|
||||||
#
|
|
||||||
# generates: pdf, info, HTML (multiple pages), HTML (single page)
|
|
||||||
default: pdf info plain html
|
|
||||||
|
|
||||||
mkbuild-doc: $(path_doc_output)
|
mkbuild-doc: $(path_doc_output)
|
||||||
|
|
||||||
$(path_doc_output):
|
dvi-local: img
|
||||||
[ -d $(path_doc_output) ] || mkdir -p "$(path_doc_output)"
|
pdf-local: img
|
||||||
|
html-local: img easejs.css highlight.pack.js interactive.js
|
||||||
|
|
||||||
# doc images
|
# doc images
|
||||||
$(path_doc)/img/%.png: $(path_doc)/img/%.dia
|
img/%.png: img/%.dia
|
||||||
echo "$<" | grep -q 'wide' \
|
echo "$<" | grep -q 'wide' \
|
||||||
&& dia -e $@ -s x250 $< \
|
&& dia -e $@ -s x250 $< \
|
||||||
|| dia -e $@ -s 300x $<
|
|| dia -e $@ -s 300x $<
|
||||||
|
|
||||||
# doc pdf
|
|
||||||
$(path_doc_output)/%.pdf: $(doc_src) $(doc_imgs) | mkbuild-doc img
|
|
||||||
TEXINPUTS="$(path_doc):" \
|
|
||||||
pdftex -output-directory "${path_doc}" "${path_easejs_texi}" && \
|
|
||||||
TEXINPUTS="$(path_doc):" \
|
|
||||||
pdftex -output-directory "${path_doc}" "${path_easejs_texi}"
|
|
||||||
mv -f "${path_doc}"/*.pdf "${path_doc_output}"
|
|
||||||
cd "$(path_doc)" && rm -f $(shell cat "$(path_doc)/.gitignore")
|
|
||||||
|
|
||||||
# doc plain text
|
# doc plain text
|
||||||
$(path_doc_output_plain): $(doc_imgs_txt) | mkbuild-doc
|
$(path_doc_output_plain): $(doc_imgs_txt)
|
||||||
makeinfo --plain -I "$(path_doc)" "${path_easejs_texi}" > $@
|
makeinfo --plain -I "." "${path_easejs_texi}" -o "$@"
|
||||||
|
|
||||||
# doc html (multiple pages)
|
# doc html (multiple pages); override default target to call automake's first
|
||||||
$(path_doc_output_html)/index.html: $(doc_src) $(path_doc_css) \
|
# and then post-process output (it has no *-hook target support)
|
||||||
| $(path_doc_output_html)/img $(path_doc_output_html)/interactive.js \
|
html: html-am $(path_doc_output_html)/$(path_doc_css_ref)
|
||||||
$(path_doc_output_html)/highlight.pack.js \
|
sed -i '$(doc_replace)' easejs.html/*.htm?
|
||||||
$(path_doc_output_html)/$(path_doc_css_ref) mkbuild-doc img
|
|
||||||
makeinfo --html --css-ref="$(path_doc_css_ref)" \
|
|
||||||
-I "$(path_doc)" -o "${path_doc_output_html}" "${path_easejs_texi}"
|
|
||||||
sed -i '$(doc_replace)' $(path_doc_output_html)/*.htm?
|
|
||||||
|
|
||||||
# doc html (single page)
|
# doc html (single page)
|
||||||
$(path_doc_output_html1): $(doc_src) $(path_doc_css) \
|
html-single: $(path_doc_output_html1)
|
||||||
| $(path_doc_output)/img $(path_doc_output)/interactive.js \
|
$(path_doc_output_html1): html-local
|
||||||
$(path_doc_output)/highlight.pack.js mkbuild-doc img
|
$(MAKEINFO) --no-split --html --css-include="${path_doc_css}" \
|
||||||
makeinfo --no-split --html --css-include="${path_doc_css}" \
|
-I "." -o "$(path_doc_output_html1)" "${path_easejs_texi}" \
|
||||||
-I "$(path_doc)" -o - "${path_easejs_texi}" \
|
&& sed -i '$(doc_replace)' "$(path_doc_output_html1)"
|
||||||
| sed '$(doc_replace)' \
|
|
||||||
> "$(path_doc_output_html1)"
|
|
||||||
|
|
||||||
# doc images (in build dir)
|
# doc images (in build dir)
|
||||||
$(path_doc_output)/img: $(doc_imgs) | mkbuild-doc img
|
$(path_doc_output)/img: $(doc_imgs) | mkbuild-doc img
|
||||||
|
@ -108,34 +88,24 @@ $(path_doc_output_html)/img: $(path_doc_output)/img
|
||||||
ln -s ../img $@
|
ln -s ../img $@
|
||||||
|
|
||||||
# interactive html doc (js)
|
# interactive html doc (js)
|
||||||
$(path_doc_output_html)/%.js: $(path_doc)/%.js
|
$(path_doc_output_html)/%.js: %.js
|
||||||
cp $< $@
|
cp $< $@
|
||||||
$(path_doc_output)/%.js: $(path_doc)/%.js
|
$(path_doc_output)/%.js: %.js
|
||||||
cp $< $@
|
cp $< $@
|
||||||
|
|
||||||
# doc css
|
# doc css
|
||||||
$(path_doc_output_html)/%.css: $(path_doc)/%.css
|
$(path_doc_output_html)/%.css: %.css
|
||||||
cp $< $@
|
cp $< $@
|
||||||
|
|
||||||
|
|
||||||
img: $(doc_imgs)
|
img: $(doc_imgs)
|
||||||
pdf: $(path_doc_output)/easejs.pdf
|
|
||||||
install-pdf: pdf
|
|
||||||
install -d $(DESTDIR)$(docdir)
|
|
||||||
install -m644 $(path_doc_output)/easejs.pdf $(DESTDIR)$(docdir)/easejs.pdf
|
|
||||||
|
|
||||||
plain: $(path_doc_output_plain)
|
plain: $(path_doc_output_plain)
|
||||||
install-plain: plain
|
install-plain: plain
|
||||||
install -d $(DESTDIR)$(docdir)
|
install -d $(DESTDIR)$(docdir)
|
||||||
install -m644 $(path_doc_output_plain) $(DESTDIR)$(docdir)/easejs.txt
|
install -m644 $(path_doc_output_plain) $(DESTDIR)$(docdir)/easejs.txt
|
||||||
|
|
||||||
html: $(path_doc_output_html)/index.html $(path_doc_output_html1)
|
clean-local:
|
||||||
install-html: html
|
|
||||||
install -d $(DESTDIR)$(docdir)/easejs
|
|
||||||
install -m644 $(path_doc_output_html)/index.html $(DESTDIR)$(docdir)/easejs/index.html
|
|
||||||
install -m644 $(path_doc_output_html1) $(DESTDIR)$(docdir)/easejs.html
|
|
||||||
|
|
||||||
clean:
|
|
||||||
rm -rf $(path_doc_output)
|
|
||||||
rm -rf $(path_doc_img)/*.png
|
rm -rf $(path_doc_img)/*.png
|
||||||
|
rm -f $(path_doc_output_plain)
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue