最近 doxygen が 1.8.8 から 1.8.9 になって、 cross/avr-libc を make package しようとすると、

refman.pdf

を作るところになって、失敗する。

Makefile:6: recipe for target 'refman.pdf' failed
gmake[4]: *** [refman.pdf] Error 1
gmake[4]: Leaving directory '/export/WRKOBJDIR/wip/avr-libc/work/avr-libc-1.8.1/doc/api/latex_src'
Makefile:627: recipe for target 'avr-libc-user-manual.pdf' failed
gmake[3]: *** [avr-libc-user-manual.pdf] Error 2
gmake[3]: Leaving directory '/export/WRKOBJDIR/wip/avr-libc/work/avr-libc-1.8.1/doc/api'
Makefile:369: recipe for target 'all-recursive' failed
gmake[2]: *** [all-recursive] Error 1
gmake[2]: Leaving directory '/export/WRKOBJDIR/wip/avr-libc/work/avr-libc-1.8.1/doc'
Makefile:423: recipe for target 'all-recursive' failed
gmake[1]: *** [all-recursive] Error 1
gmake[1]: Leaving directory '/export/WRKOBJDIR/wip/avr-libc/work/avr-libc-1.8.1'
Makefile:361: recipe for target 'all' failed
gmake: *** [all] Error 2
*** Error code 2

その時に、refman.log を探して、中を見ると、

+tex [333] [334]) (./util_2twi_8h.tex [335]) (./wdt_8h.tex)
 ! Undefined control sequence.
 l.303 \backmatter

という文字があって、今これを書くまで、 ここが問題だと思っていたが、そうではないらしい

というのは、その失敗した時に、それと同じことを手で次のように入力すると、

(cd /export/WRKOBJDIR/wip/avr-libc/work/avr-libc-1.8.1/doc/api/latex_src; 
  latex refman.tex)|& tee /tmp/good

無事 refman.pdf が出来る。それで、その時と、失敗する時の refman.log を見較べていたら、上の部分は同じ。

大きく違うのは次の部分だと判明

--- /tmp/bad    2015-02-11 11:51:17.000000000 +0900
+++ /tmp/good   2015-02-11 11:51:01.000000000 +0900
@@ -1,8 +1,8 @@
-This is pdfTeX, Version 3.1415926-2.5-1.40.14 (Web2C 2013)
  (format=pdflatex 2015.2.11) 11 FEB 2015 11:51
+This is pdfTeX, Version 3.1415926-2.5-1.40.14 (Web2C 2013)
  (format=latex 2014.1.11) 11 FEB 2015 11:50

さてこの(起動の)違いはどこに

which latex して見れば良いのかな。それは同じだった。

-Output written on refman.pdf (337 pages, 1543903 bytes).
-PDF statistics:
- 7890 PDF objects out of 8907 (max. 8388607)
- 7429 compressed objects within 75 object streams
- 2822 named destinations out of 2984 (max. 500000)
- 58 words of extra memory for PDF output out of 10000 (max. 10000000)
+ 66i,16n,57p,4038b,611s stack positions out of 5000i,500n,10000p,200000b,80000s
 
+Output written on refman.dvi (346 pages, 3143740 bytes).

あれ、refman.pdf 出来ていますよ。