From 91896cce95b646f5dd4914fc8a5525dd1ba1a2a3 Mon Sep 17 00:00:00 2001 From: frankmorgner Date: Tue, 1 Nov 2011 20:35:30 +0000 Subject: [PATCH] only refresh documentation if needed git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@605 96b47cad-a561-4643-ad3b-153ac7d7599c --- ccid/doc/Makefile.am | 5 ++++- doc/conf.py | 8 ++++---- npa/doc/Makefile.am | 7 +++++-- npa/doc/api.rst | 4 ++-- pcsc-relay/doc/Makefile.am | 5 ++++- virtualsmartcard/doc/Makefile.am | 9 ++++++--- 6 files changed, 25 insertions(+), 13 deletions(-) diff --git a/ccid/doc/Makefile.am b/ccid/doc/Makefile.am index 210db12..82a30cd 100644 --- a/ccid/doc/Makefile.am +++ b/ccid/doc/Makefile.am @@ -15,8 +15,11 @@ do_subst = sed \ EXTRA_DIST = README.rst.in README.rst autotools.rst autotools.rst.in questions.rst questions.rst.in -.PHONY: doc doc: $(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < questions.rst.in > questions.rst $(do_subst) < README.rst.in > README.rst + touch doc + +clean-local: + rm -f doc README.rst autotools.rst questions.rst diff --git a/doc/conf.py b/doc/conf.py index 20b9471..a354088 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -14,10 +14,10 @@ import sys, os, breathe from sphinxcontrib.doxylink import doxylink -os.system("make doc -C npa >/dev/null") -os.system("make doc -C virtualsmartcard >/dev/null") -os.system("make doc -C ccid >/dev/null") -os.system("make doc -C pcsc-relay >/dev/null") +os.system("make doc -C npa") +os.system("make doc -C virtualsmartcard") +os.system("make doc -C ccid") +os.system("make doc -C pcsc-relay") # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the diff --git a/npa/doc/Makefile.am b/npa/doc/Makefile.am index 12a05a5..d31d895 100644 --- a/npa/doc/Makefile.am +++ b/npa/doc/Makefile.am @@ -15,11 +15,14 @@ do_subst = sed \ EXTRA_DIST = README.rst.in README.rst Doxyfile.in example.c autotools.rst autotools.rst.in questions.rst questions.rst.in -.PHONY: doc -doc: +doc: $(top_srcdir)/src/npa/*.h $(do_subst) < Doxyfile.in > Doxyfile $(DOXYGEN) Doxyfile touch api.rst $(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < questions.rst.in > questions.rst $(do_subst) < README.rst.in > README.rst + touch doc + +clean-local: + rm -f doc README.rst autotools.rst questions.rst Doxyfile diff --git a/npa/doc/api.rst b/npa/doc/api.rst index e1df928..e915032 100644 --- a/npa/doc/api.rst +++ b/npa/doc/api.rst @@ -31,7 +31,7 @@ Secure Messaging (SM) ===================== The complete documentation can be found `here -<_static/doxygen-npa/group__sm.html>`_. +<_static/doxygen-npa/group__sm.html>`__. ----- Types @@ -49,7 +49,7 @@ Interface to German identity card (neuer Personalausweis, nPA) ============================================================== The complete documentation can be found `here -<_static/doxygen-npa/group__npa.html>`_. +<_static/doxygen-npa/group__npa.html>`__. ----- Types diff --git a/pcsc-relay/doc/Makefile.am b/pcsc-relay/doc/Makefile.am index 8752989..9048fdb 100644 --- a/pcsc-relay/doc/Makefile.am +++ b/pcsc-relay/doc/Makefile.am @@ -15,8 +15,11 @@ do_subst = sed \ EXTRA_DIST = README.rst.in README.rst autotools.rst.in questions.rst.in autotools.rst questions.rst -.PHONY: doc doc: $(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < questions.rst.in > questions.rst $(do_subst) < README.rst.in > README.rst + touch doc + +clean-local: + rm -f doc README.rst autotools.rst questions.rst diff --git a/virtualsmartcard/doc/Makefile.am b/virtualsmartcard/doc/Makefile.am index 10e8311..f3c99a6 100644 --- a/virtualsmartcard/doc/Makefile.am +++ b/virtualsmartcard/doc/Makefile.am @@ -19,9 +19,12 @@ EXTRA_DIST = README.rst.in README.rst autotools.rst.in questions.rst.in autotool dist_noinst_SCRIPTS = generate_modules.py -.PHONY: doc -doc: +doc: $(top_srcdir)/src/vpicc/virtualsmartcard/*.py $(top_srcdir)/src/vpicc/virtualsmartcard/cards/*.py $(do_subst) < autotools.rst.in > autotools.rst $(do_subst) < questions.rst.in > questions.rst $(do_subst) < README.rst.in > README.rst - ./generate_modules.py $(top_srcdir)/src/vpicc --dest-dir=api --suffix=rst --no-toc -1 + ./generate_modules.py $(top_srcdir)/src/vpicc --dest-dir=api --suffix=rst --no-toc -1 -f + touch doc + +clean-local: + rm -f doc README.rst autotools.rst questions.rst