[Open-graphics] Nanocontroller Manual and Documentation Build Tweaks

Petter Urkedal urkedal at nbi.dk
Sun Aug 12 11:58:09 EDT 2007


I'd like to add a preliminary reference manual for the nanocontroller.
Apart from the obvious reason, that'll give people who read the latest
newsletter some more comprehensible material than the RTL and C sources.
The LaTeX source is attached for preview.

The idea is to put it in ogp/docs, but I'd like to make some adjustments
to the Makefile:

  * I use \ref and table-of-contents, so I'll need to run latex and
    pdflatex twice.  I could make separate rules for my document; the
    choice is between build time and bloating the Makefile with
    per-document rules.

  * Currently the LaTeX-rules do not remove the generated file in case
    of an error.

  * I'd like to add the "-interaction nonstopmode" flag to latex and
    pdflatex, unless someone thinks the interactive mode is useful.

If this is good, then the new LaTeX rule will be

%.dvi: %.tex
        if ! $(LATEX) $(LATEX_FLAGS) $< || \
           ! $(LATEX) $(LATEX_FLAGS) $<; then \
            rm -f $@; false; \
        fi

and similar for pdflatex.

Any comments before I commit?

(FYI, I'll also commit some improvements to the assembler and debugger
to complete the features described in the manual, and a bug fix of the
OGA1/HQ RTL.)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: oga1hq-manual.tex
Type: application/x-latex
Size: 20777 bytes
Desc: not available
Url : http://lists.duskglow.com/open-graphics/attachments/20070812/030d82ce/oga1hq-manual.latex


More information about the Open-graphics mailing list