Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 536566

Summary: x11-libs/fltk-1.3.3-r2 USE='doc pdf' with >=app-doc/doxygen-1.8.8 - cp: cannot stat ‘latex/refman.pdf’: No such file or directory
Product: Gentoo Linux Reporter: Andrey Grozin <grozin>
Component: [OLD] LibraryAssignee: Desktop Misc. Team <desktop-misc>
Status: RESOLVED FIXED    
Severity: normal CC: alunduil, dev-tools, nbowler, proteuss, rose, trent2
Priority: Normal    
Version: unspecified   
Hardware: All   
OS: Linux   
See Also: https://bugs.gentoo.org/show_bug.cgi?id=494390
Whiteboard:
Package list:
Runtime testing required: ---
Bug Depends on:    
Bug Blocks: 550348    
Attachments: patch for the ebuild
refman.log.bz2
refman.log.bz2

Description Andrey Grozin gentoo-dev 2015-01-14 08:15:18 UTC
Created attachment 393944 [details, diff]
patch for the ebuild

This is probably related to a newer version of doxygen. I started to "fix" problems, but stopped after 5-th one or so - their number is too large. In some places doxygen generated absolutely invalid latex, like

\begin{TabularC}
....
\end{TabularNC}

and I am not a doxygen expert to fix this. I propose to disable generation of pdf documentation, see the attached patch. html documentation is generated normally (with USE=doc); using USE=pdf to generate also pdf documentation is non-standard in any case.
Comment 1 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 08:20:38 UTC
Comment on attachment 393944 [details, diff]
patch for the ebuild

Er, so instead of fixing the issue you want to simply remove it.
Comment 2 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 08:25:45 UTC
If we're /not/ going to fix USE=pdf to generate the document, we could simply offer the previously generated PDF file (see [1]) instead. But I'd rather fix it. :)



[1] http://www.fltk.org/documentation.php
Comment 3 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 08:28:19 UTC
All I am getting is

sh: 1: epstopdf: not found

which means we should at least tweak the build time dependencies.
Comment 4 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 09:17:39 UTC
Could you attach your build log so that we know what errors you are seeing?
Comment 5 Andrey Grozin gentoo-dev 2015-01-14 10:24:56 UTC
Created attachment 393948 [details]
refman.log.bz2

To get a (minimally) useful pdflatex log, I did the following:

1. edited the (generated) Makefile in documentation/latex to replace pdflatex -> pdflatex -interaction nonstopmode (to see all errors)

2. edited the (generated) refman.tex: added \newcommand{\+}{} (because there are zillion \+ in this file, the maximum number of errors in nonstopmode is by far exceeded); replaced \begin{ImageNoCaption} ... \end{ImageNoCaption} -> DoxyImageNoCaption near the beginning (this is the easiest fix).

\Small is never defined (is it \small?). \clearemptydoublepage is never defined (is it \cleardoublepage?). \begin{TabularC} ends with \end{TabularNC} in 3 cases. See the log.
Comment 6 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 10:50:56 UTC
(In reply to Andrey Grozin from comment #5)
> Created attachment 393948 [details]
> bzip2ed refman.log
> 
> To get a (minimally) useful pdflatex log, I did the following:
> 
> 1. edited the (generated) Makefile in documentation/latex to replace
> pdflatex -> pdflatex -interaction nonstopmode (to see all errors)
> 
> 2. edited the (generated) refman.tex: added \newcommand{\+}{} (because there
> are zillion \+ in this file, the maximum number of errors in nonstopmode is
> by far exceeded);

> replaced \begin{ImageNoCaption} ... \end{ImageNoCaption}
> -> DoxyImageNoCaption near the beginning (this is the easiest fix).

I have that.

> \Small is never defined (is it \small?).

Easy enough.

> \clearemptydoublepage is never
> defined (is it \cleardoublepage?).

Used to be in fancyhdr but is now in edmargin, it seems, so \usepackage{edmargin} fixed that.

> \begin{TabularC} ends with
> \end{TabularNC} in 3 cases. See the log.

Yes, I'm seeing all those too after simply upgrading to =app-doc/doxygen-1.8.8
Comment 7 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 11:32:32 UTC
(In reply to Andrey Grozin from comment #5)

> 2. edited the (generated) refman.tex: added \newcommand{\+}{} (because there
> are zillion \+ in this file, the maximum number of errors in nonstopmode is
> by far exceeded); replaced \begin{ImageNoCaption} ... \end{ImageNoCaption}
> -> DoxyImageNoCaption near the beginning (this is the easiest fix).

That seems to be a quoting/encoding/escaping issue in doxygen.
Comment 8 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-14 11:41:22 UTC
All those \+ errors seem to boil down to something trying to turn
 FLTK
into
 F\+L\+T\+K
Comment 9 Andrey Grozin gentoo-dev 2015-01-14 11:57:24 UTC
(In reply to Jeroen Roovers from comment #8)
> All those \+ errors seem to boil down to something trying to turn
>  FLTK
> into
>  F\+L\+T\+K
Mostly, but not exclusively:
Open\+G\+L
F\+L\+U\+I\+D
U\+T\+F-\/8
G\+L\+U\+T
F\+A\+Q

It seems \+ is inserted before any capital letter in the middle of a word
Comment 10 Jeroen Roovers (RETIRED) gentoo-dev 2015-01-15 10:26:02 UTC
Curiously, we don't seem to have a doxygen-1.8.8 breakage tracker.
Comment 11 Andrey Grozin gentoo-dev 2015-01-25 22:06:21 UTC
Created attachment 394878 [details]
refman.log.bz2

with doxygen-1.8.9.1
Comment 12 Juergen Rose 2015-02-17 10:05:23 UTC
The same issue I see now with x11-libs/fltk-1.3.3-r3:
...
(cd latex ;\
pdflatex --interaction=nonstopmode refman.tex ;\
makeindex refman.idx ;\
pdflatex --interaction=nonstopmode refman.tex ;\
latex_count=5;\
while egrep -s 'Rerun (LaTeX|to get cross-references right)' refman.log \
        && [ $latex_count -gt 0 ] ;\
    do \
      echo "Rerunning latex ..." ;\
      pdflatex --interaction=nonstopmode refman.tex ;\
      latex_count=`expr $latex_count - 1` ;\
    done ; \
cd ..) > pdfall.log 2>&1
Warning: Tag `SHOW_DIRECTORIES' at line 462 of file `Doxybook' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `HTML_ALIGN_MEMBERS' at line 814 of file `Doxybook' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `XML_SCHEMA' at line 1134 of file `Doxybook' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `XML_DTD' at line 1140 of file `Doxybook' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
cp -f latex/refman.pdf fltk.pdf
cp: cannot stat ‘latex/refman.pdf’: No such file or directory
Makefile:134: recipe for target 'pdf' failed
make: *** [pdf] Error 1
make: Leaving directory '/var/tmp/portage/x11-libs/fltk-1.3.3-r3/work/fltk-1.3.3/documentation'
 * ERROR: x11-libs/fltk-1.3.3-r3::gentoo failed (compile phase):
 *   emake failed
 *
Comment 13 Jeroen Roovers (RETIRED) gentoo-dev 2015-02-17 10:25:03 UTC
(In reply to Juergen Rose from comment #12)
> The same issue I see now with x11-libs/fltk-1.3.3-r3:

Of course. -r3 didn't do anything about this issue, which probably shouldn't be fixed in fltk anyway.
Comment 14 Jeroen Roovers (RETIRED) gentoo-dev 2015-10-05 04:51:12 UTC
I'm all for removing USE="doc pdf" altogether.
Comment 15 Andrey Grozin gentoo-dev 2015-10-05 08:20:47 UTC
(In reply to Jeroen Roovers from comment #14)
> I'm all for removing USE="doc pdf" altogether.
I agree. Using USE=pdf to generate pdf docs in addition to html ones is non-standard anyway.
Comment 16 Jeroen Roovers (RETIRED) gentoo-dev 2015-10-07 04:58:40 UTC
Fixed in 1.3.3-r3 and up.