I am using makeinfo tho generate the html documentation of a program.
For HTML, makeinfo includes this option
--split=SPLIT
split at SPLIT, where SPLIT may be `chapter', `section' or `node'.
I want to include the split option to my makefile.
What I plan to do is define three different simple targets. Such
as: html, html-split-chapter, html-split-section, html-split-node.
Basically I have to figure out the things that the user might need
to produce, and create a target for each one of them.
Without requiring "additional parameters" to get the job done.
Currently I have the following target, but it is not very
user friendly. $(hmldir) is the directory they want to
store the out-of-tree html output
opts = --force --enable-encoding -I ${srcdir}
$(hmldir)/antares.html: $(srcs) | $$(@D)
makeinfo $(opts) --html-o $@ $<
"make help" is also a very nice feature, in case they forget.
If users type "make" with no parameters, I give them the "help",
and mention "make help" in the text. Easy to use, and friendly.
