Re: [avr-libc-dev] Building documentation in MinGW/MSYS

[Joerg Wunsch]

As Eric Weddington wrote:

> For the first time ever, the avr-libc documentation can finally be
> built on a MinGW/MSYS host! All of it: html, ps, pdf, and man
> pages. This is the first time I've ever been able to do this in the
> 4 years that I've been working on avr-libc. The patches to enable
> this have been committed on the 1.4 branch and HEAD.

Congratulations!

I finally had the time to review all your changes, and about the only
one I'm not really happy with is:

 * doc/api/Makefile.am (doxygen.confg): Remove the dependency on
 $(top_srcdir)/stamp-h1 as there is no rule in this Makefile to build
 it, which causes an error. The rule is located in the top level
 Makefile.

I see your point, but some kind of dependency ought to be there to
rebuild the docs in case something else has been changed.  I think we
simply need to find a better way to propagate a reconfiguration step
that has been performed at the top level down into the docs build.

> The only unknown is with Miktex. It has a "Basic Installation" and a
> "Full Installation". I don't know if only the Basic Installation is
> required. I went ahead and did the Full Installation and I know it
> works with that.

Just go ahead with the full version.  For Unix systems, the teTeX
distribution has now become the de-facto standard for LaTeX & Co., and
like MikTeX, it's an ``all inclusive'' system that installs as much as
might ever be needed by default.

-- 
cheers, J"org               .-.-.   --... ...--   -.. .  DL8DTL

http://www.sax.de/~joerg/                        NIC: JW11-RIPE
Never trust an operating system you don't have sources for. ;-)