The following is an example makefile that can
be used with nmake on a Windows machine.
It automates most of the tedious work.
It's for a little project of mine that has
a number of .pm files and one .pl file.
To generate the documentation for all these
files I use:
nmake xref
nmake html
nmake index
To add an additional .pm file only two actions are needed:
(1) the file name has to be added to $(MODULES).
(2) its .xref file name has to be added to
the file izor.refs
The following is an example makefile that can
be used with nmake on a Windows machine.
It automates most of the tedious work.
It's for a little project of mine that has
a number of .pm files and one .pl file.
To generate the documentation for all these
files I use:
nmake xref
nmake html
nmake index
To add an additional .pm file only two actions are needed:
(1) the file name has to be added to $(MODULES).
(2) its .xref file name has to be added to
the file izor.refs
------------- begin ----------
ROBODOC = robodoc
.SUFFIXES : .pm .pl .xref .html
.pm.xref:
$(ROBODOC) $< $*.html HTML -v -g $*.xref
.pl.xref:
$(ROBODOC) $< $*.html HTML -v -g $*.xref
.pm.html:
$(ROBODOC) $< $*.html HTML SORT TOC -v -x izor.refs
.pl.html:
$(ROBODOC) $< $*.html HTML SORT TOC -v -x izor.refs
SOURCES = izor.pl
MODULES = izorclass.pm izortype.pm izorattribute.pm \ izormodel.pm serializegenerator.pm deserializegenerator.pm \ rosemodel.pm izorgenerator.pm izormethod.pm \ classidgenerator.pm creategenerator.pm izorconfiguration.pm \ xmldumpgenerator.pm
XREFS = $(MODULES:.pm=.xref) $(SOURCES:.pl=.xref)
HTMLS = $(XREFS:.xref=.html)
izor.refs : $(XREFS)
html : $(HTMLS)
xref : $(XREFS)
index : izor.refs
$(ROBODOC) izor.refs robodoc_mi.html INDEX HTML -v
clean :
del *.html
del *.xref
------------------ end ----------------------