On 06/17/05 14:45, Daniel-Constantin Mierla wrote:
On 06/17/05 09:59, Klaus Darilion wrote:
Daniel-Constantin Mierla wrote:
There are some other useful tools (which actually are wrappers): docbook2txt docbook2html docbook2pdf
The makefile in the new fork has now command to automatically generate the documentation based on this tools, e.g., make modules-readme make modules-docbook-html ...
cool. btw: Will you "backport" such features to ser?
sure, I will create a patch.
It was impossible to create and applicable patch -- there were some other changes in the Makefile, so I considered better to send the new make commands as attachment. You just have to copy and paste at the end of your Makefile.
Daniel
Daniel
regards, klaus
Serusers mailing list serusers@lists.iptel.org http://lists.iptel.org/mailman/listinfo/serusers
.PHONY: modules-readme modules-readme: -@for r in $(modules_basenames) "" ; do \ if [ -d "modules/$$r/doc" ]; then \ cd "modules/$$r/doc" ; \ if [ -f "$$r".sgml ]; then \ echo "" ; \ echo "docbook2txt $$r.sgml" ; \ docbook2txt "$$r".sgml ; \ mv "$$r".txt ../README ; \ fi ; \ cd ../../.. ; \ fi ; \ done
.PHONY: modules-docbook-txt modules-docbook-txt: -@for r in $(modules_basenames) "" ; do \ if [ -d "modules/$$r/doc" ]; then \ cd "modules/$$r/doc" ; \ if [ -f "$$r".sgml ]; then \ echo "" ; \ echo "docbook2txt $$r.sgml" ; \ docbook2txt "$$r".sgml ; \ fi ; \ cd ../../.. ; \ fi ; \ done
.PHONY: modules-docbook-html modules-docbook-html: -@for r in $(modules_basenames) "" ; do \ if [ -d "modules/$$r/doc" ]; then \ cd "modules/$$r/doc" ; \ if [ -f "$$r".sgml ]; then \ echo "" ; \ echo "docbook2html -u $$r.sgml" ; \ docbook2html -u "$$r".sgml ; \ fi ; \ cd ../../.. ; \ fi ; \ done
.PHONY: modules-docbook-pdf modules-docbook-pdf: -@for r in $(modules_basenames) "" ; do \ if [ -d "modules/$$r/doc" ]; then \ cd "modules/$$r/doc" ; \ if [ -f "$$r".sgml ]; then \ echo "" ; \ echo "docbook2pdf $$r.sgml" ; \ docbook2pdf "$$r".sgml ; \ fi ; \ cd ../../.. ; \ fi ; \ done
.PHONY: modules-docbook modules-docbook: modules-docbook-txt modules-docbook-html modules-docbook-pdf
install-modules-docbook: $(doc-prefix)/$(doc-dir) -@for r in $(modules_basenames) "" ; do \ if [ -n "$$r" ]; then \ if [ -d modules/"$$r"/doc ]; then \ if [ -f modules/"$$r"/doc/"$$r".txt ]; then \ $(INSTALL-TOUCH) $(doc-prefix)/$(doc-dir)/"$$r".txt ; \ $(INSTALL-DOC) modules/"$$r"/doc/"$$r".txt \ $(doc-prefix)/$(doc-dir)/"$$r".txt ; \ fi ; \ if [ -f modules/"$$r"/doc/"$$r".html ]; then \ $(INSTALL-TOUCH) $(doc-prefix)/$(doc-dir)/"$$r".html ; \ $(INSTALL-DOC) modules/"$$r"/doc/"$$r".html \ $(doc-prefix)/$(doc-dir)/"$$r".html ; \ fi ; \ if [ -f modules/"$$r"/doc/"$$r".pdf ]; then \ $(INSTALL-TOUCH) $(doc-prefix)/$(doc-dir)/"$$r".pdf ; \ $(INSTALL-DOC) modules/"$$r"/doc/"$$r".pdf \ $(doc-prefix)/$(doc-dir)/"$$r".pdf ; \ fi ; \ fi ; \ fi ; \ done