I've been trying to be good and make my proto-packages .dtx
files (in particular, the files in the TeX-SX Package but that's not particularly relevant). My workflow goes a bit like this:
- Hack a few macros with tests in a
.tex
file - Fork the macro bit into a
.sty
file and the tests stay in a.tex
file - Munge the macros into something reasonable
- Convert the tests into something approximating documentation
- Convert the
.sty
file to a.dtx
- Add the documentation
- Announce it somewhere and ask for testers
At this point, I enter the "add feature and fix bugs" stage. Editing the .dtx
is a little less intuitive than the .sty
(having to remember the macrocode
stuff, but I'm getting used to it), but I don't usually want to rebuild the documentation every time - I usually have a separate test file that tests only those bits that I'm editing. So whilst I'm okay at adding pdflatex file.dtx
to generate the new .sty
file, it's a bit much that it generates the documentation as well. Not only is it a waste of time but also can hide any errors in the .sty
bit under a wreath of information about the documentation bit.
So: how do I tell pdflatex
to only generate the .sty
file when I run pdflatex file.dtx
?
(Incidentally, if anyone happens to suggest any improvements on my workflow, I'll be very grateful.)
.sty
..."