[avr-libc-dev] [bug #28688] using_tools.dox fails to build due to extra underscore

[Andrew Stevenson]

URL:
  <http://savannah.nongnu.org/bugs/?28688>

                 Summary: using_tools.dox fails to build due to extra
underscore
                 Project: AVR C Runtime Library
            Submitted by: cqexbesd
            Submitted on: Tue 19 Jan 2010 16:31:41 GMT
                Category: Build Infrastructure
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Build system
                  Status: None
        Percent Complete: 0%
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 1.6.7
           Fixed Release: None

    _______________________________________________________

Details:

Building the api docs fails because sed complains it can't find
using_tools.tex.

What appears to be happening is that doxygen is run on using_tools.dox which
creates latex_src/using__tools.tex. The Makefile assumes the file will only
have one underscore (e.g. using_tools.tex). The filename is derived from the
argument to the \page macro in the original dox file but underscores are
escaped by being doubled. The simplest fix, below, is to allow for the doubled
underscore in the rest of the Makefile though alternatively the name of the
page could be changed.

--- doc/api/Makefile.am.orig    2010-01-19 16:13:58.000000000 +0000
+++ doc/api/Makefile.am 2010-01-19 16:05:10.000000000 +0000
@@ -182,8 +182,8 @@
                sed -e '/{TabularC}{3}/s/{TabularC}{3}/{longtable}{|l|l|l|}/'
\
                -e '/{longtable}{|l|l|l|}/,/TabularC/s/TabularC/longtable/'
\
                -e '/Architecture/s/\\\\\\hline/\\endhead\\hline/' \
-               using_tools.tex > tmp.$$ && \
-               mv -f tmp.$$ using_tools.tex
+               using__tools.tex > tmp.$$ && \
+               mv -f tmp.$$ using__tools.tex
 
 #doxygen.config: doxygen.config.in $(top_srcdir)/stamp-h1
 doxygen.config: doxygen.config.in

I am using doxygen 1.6.2 and avr-libc 1.6.7 under FreeBSD 8.




    _______________________________________________________

Reply to this item at:

  <http://savannah.nongnu.org/bugs/?28688>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.nongnu.org/