makefile option pour générer la documentation latex

Question

J'ai un projet qui peut être construit via makefile, et je voudrais ajouter la possibilité pour quelqu'un dans le répertoire de base non seulement de pouvoir construire l'exécutable via make, mais aussi de construire les pdfs de documentation à partir LATEX dans un répertoire distinct en tapant make docs ou quelque chose de similaire.
je besoin d'un seul laissez-passer pour générer la documentation, et il n'y a pas de dépendances dans les fichiers .tex.
Je n'ai aucune expérience avec makefiles récursives, donc toutes les ressources générales seraient également appréciées.

PS. Je n'utilise pas noweb ou des systèmes similaires, j'ai simplement des fichiers sources et des fichiers .tex séparés.

comportement désiré:
$ ls
docs/
Makefile
source1.cpp
source1.h
source2.cpp
source2.h
$ ls docs
Makefile
doc1.tex
$ make
= mon programme sera compilé =
$ make docs
$ ls docs
Makefile
doc1.tex
doc1.pdf

Answer 1

Je pense que vous pouvez facilement spécifier juste une commande pour exécuter le Makefile dans le répertoire docs dir et Exécutez pdflatex -output-directory = DIR. Donc, il finirait regarder quelque chose comme ceci:

Dans votre Makefile toplevel ajouter la règle

docs: 
     $(MAKE) -C doc all 

Puis dans la doc dir vous pouvez ajouter un Makefile avec une règle comme

%.pdf: %.tex 
     $(PDFLATEX PATH) --output-dir=$(DIR) $<