DebuggingEvince
Available languages : Italiano,
This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages. |
Introduction
Evince is the default application in Ubuntu for opening .pdf, .ps, .djvu, and other supported files as outlined by the project.
Not a bug
The following specific cases are not bugs to report:
Evince can't display dvi files
Evince uses texlive to render .dvi files. If you cannot open a .dvi file (error message "Unable to open document. DVI document has incorrect format"), install the texlive package and try again. (There's bug report #42410 about correcting this error message).
Evince can't display CJK fonts
CJK stands for Chinese-Japanese-Korean. A pdf that includes such text but lacks the embedded fonts will not render correctly unless you install the package poppler-data.
Debugging procedure
In all reports, please ensure you attach an uncompressed/untarred document that the issue is reproducible with.
Crash or Freeze
If Evince crashes, please report this following https://wiki.ubuntu.com/ReportingBugs.
Rendering issues
Once you have the document and have confirmed it doesn't render as it's supposed to in Evince, you have to find the correct package for this bug. Evince uses:
libpoppler for rendering pdf files
libspectre for rendering postscript files
libpango, libfreetype and fontconfig for fonts choosing and rendering
libcairo for 2D vector graphics
Try opening it with different viewers to try and isolate the problem:
PostScript (.ps)
- ghostscript
- .djvu
djVuLibre - package djview4
When pdf files don't include the embedded fonts used in the document, then if Ubuntu doesn't have the specific font installed, it will search for the nearest equivalent, using fc-match <font>.
It might also be helpful to use the pdfinfo and pdffonts utils (included in the poppler-utils package).
Printing problems
It is best to file printing problems following https://wiki.ubuntu.com/DebuggingPrintingProblems first. If it turns out to be a bug in Evince, it may be reassigned.
Triage responses
No document attached:
Thank you for taking the time to report this and helping to make Ubuntu better. Could you please attach an example document that demonstrates this issue?
Reporting bugs upstream
Once the report has been marked Triaged, then one would want to next gather the required information necessary to forward to the appropriate upstream tracker. This includes the version Evince, poppler, and cairo via a terminal:
apt-cache policy evince libcairo2 libpoppler[0-9]
As well, if reporting an Evince crash, one may post the backtrace as a comment, and bugzilla will wrap it up into a button to expand out.
Backporting Fixes
Bug fixes are reviewed for backporting to all supported Ubuntu releases following https://wiki.ubuntu.com/StableReleaseUpdates.