bugAVR C Runtime Library - Bugs: bug #28688, using_tools.dox fails to build due...

 
 

You are not allowed to post comments on this tracker with your current authentication level.

bug #28688: using_tools.dox fails to build due to extra underscore

Submitter:  Andrew Stevenson <cqexbesd>
Submitted:  Tue 19 Jan 2010 04:31:41 PM UTC
   
 
Category:  Build Infrastructure Severity:  3 - Normal
Priority:  5 - Normal Item Group:  Build system
Status:  Fixed Assigned to:  joerg_wunsch
Percent Complete:  0% Open/Closed:  Closed
Release:  1.6.7 Fixed Release:  None

Thu 21 Jan 2010 08:57:16 AM UTC, comment #1: 

I added some logic to detect whether doxygen did generate
the filename with one or two underscores (so it ought to
run on doxygen < 1.6.x still).

Alas, we cannot remove the editing logic from the Makefile,
as doxygen still generates LaTeX tables that cannot span
more than one output page by default.

Joerg Wunsch <joerg_wunsch>
Group administrator
Tue 19 Jan 2010 04:31:41 PM UTC, original submission:  

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.

Andrew Stevenson <cqexbesd>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by joerg_wunsch (Posted a comment)
  • -email is unavailable- added by cqexbesd (Submitted the item)
  •  

    Follow 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2010-01-21 joerg_wunsch StatusNone Fixed
        Assigned toNone joerg_wunsch
        Open/ClosedOpen Closed

    Back to the top

    Powered by Savane 3.13-caa5.
    Corresponding source code