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

 
 

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

Submitted by:  Andrew Stevenson <cqexbesd>
Submitted on:  Tue 19 Jan 2010 04:31:41 PM UTC  
 
Category: Build InfrastructureSeverity: 3 - Normal
Priority: 5 - NormalItem Group: Build system
Status: FixedPercent Complete: 0%
Assigned to: Joerg Wunsch <joerg_wunsch>Open/Closed: Closed
Release: 1.6.7Fixed Release: None

Add a New Comment(Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

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>
Project AdministratorIn charge of this item.
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.)

Attach File(s):
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

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

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 3 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Thu 21 Jan 2010 08:57:16 AM UTCjoerg_wunschStatusNone=>Fixed
      Assigned toNone=>joerg_wunsch
      Open/ClosedOpen=>Closed

    Back to the top


    Powered by Savane 3.1-cleanup1