DebuggingEvince
|
Size: 1612
Comment: Initial skeleton of this page
|
Size: 4110
Comment: added link to Italian translation
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| Available languages : [[https://wiki.ubuntu.com/DebuggingEvince_it| Italiano]], |
|
| Line 6: | Line 8: |
| [[http://gnome.org/projects/evince/|Evince]] is the default application in Ubuntu for opening .pdf, .ps and other similar types of files. It uses the [[http://poppler.freedesktop.org/|poppler]] rendering library. | [[http://gnome.org/projects/evince/|Evince]] is the default application in Ubuntu for opening .pdf, .ps, .djvu and other similar types of files. |
| Line 8: | Line 10: |
| Bugs related to Evince fall into 3 categories: | Most bugs related to Evince fall into 3 categories: |
| Line 13: | Line 15: |
| = Common issues = == 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 [[https://bugs.launchpad.net/ubuntu/+source/evince/+bug/42410|bug report #42410]] about correcting this error message) == 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'''. |
|
| Line 15: | Line 27: |
| == Stock Reply == | == Crash or Freeze == |
| Line 17: | Line 29: |
| In the event that a bug reporter is having a crash with a specific document obtaining that document will help. | In case Evince crashes, follow standard [[DebuggingProgramCrash]] procedures. == Rendering issues == If the crash/incorrect rendering appears only with a specific document, obtaining that document will help. Here's a stock reply to use in this case: |
| Line 23: | Line 39: |
| == How to Forward == | Once you have the document and have confirmed it doesn't render as it's supposed to in Evince, you have to find the right package for this bug. Evince uses: * [[http://poppler.freedesktop.org/|libpoppler]] for rendering pdf files * [[http://libspectre.freedesktop.org/|libspectre]] for rendering postscript files * [[http://www.pango.org/|libpango]], [[http://www.freetype.org/|libfreetype]] and [[http://fontconfig.org/|fontconfig]] for fonts choosing and rendering * [[http://cairographics.org/|libcairo]] for 2D vector graphics |
| Line 25: | Line 45: |
| The upstream bug tracking system for Evince is at http://bugzilla.gnome.org/browse.cgi?product=evince | Try opening it with different viewers to try and isolate the problem: * Adobe Reader (package '''acroread''', available in the [[http://medibuntu.org/|Medibuntu]] repository) * Xpdf (package '''xpdf-reader''') * ePdfView * okular * for .ps files: ghostscript * for .djvu files: 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). |
| Line 30: | Line 60: |
= Other issues = == How to Forward == * Upstream Evince bugs are at http://bugzilla.gnome.org/browse.cgi?product=evince * Upstream Poppler bugs are at http://bugs.freedesktop.org/query.cgi == Backporting Fixes == Bug fixes are normally backported to all supported Ubuntu releases (you can see which releases are still supported [[http://en.wikipedia.org/wiki/List_of_Ubuntu_releases#Release_history|here]]). However, this is not always possible, for example when the code architecture has changed significantly. This means that sometimes bugs are marked as "Fix Released" even when they have been fixed only in recent versions of evince/poppler/etc. ---- CategoryDebugging |
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 similar types of files.
Most bugs related to Evince fall into 3 categories:
- Evince crashes when I open a specific document (or when I open it and perform a specific action, like scroll, zoom or rotate)
- Evince does not display ("render") the document correctly
- Evince displays the document as it should, but then doesn't print it correctly
Common issues
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)
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
Crash or Freeze
In case Evince crashes, follow standard DebuggingProgramCrash procedures.
Rendering issues
If the crash/incorrect rendering appears only with a specific document, obtaining that document will help. Here's a stock reply to use in this case:
Thank you for taking the time to report this bug and helping to make Ubuntu even better! It would be quite helpful if you attach the document you are having a problem with so we can better recreate this bug and work on fixing it. Thanks in advance.
Once you have the document and have confirmed it doesn't render as it's supposed to in Evince, you have to find the right 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:
Adobe Reader (package acroread, available in the Medibuntu repository)
Xpdf (package xpdf-reader)
- ePdfView
- okular
- for .ps files: ghostscript
for .djvu files: 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
Sometimes, when a document printed from evince doesn't print correctly, it is not a problem with Evince, but with cups, or the specific printer driver.
Other issues
How to Forward
Upstream Evince bugs are at http://bugzilla.gnome.org/browse.cgi?product=evince
Upstream Poppler bugs are at http://bugs.freedesktop.org/query.cgi
Backporting Fixes
Bug fixes are normally backported to all supported Ubuntu releases (you can see which releases are still supported here).
However, this is not always possible, for example when the code architecture has changed significantly. This means that sometimes bugs are marked as "Fix Released" even when they have been fixed only in recent versions of evince/poppler/etc.
DebuggingEvince (last edited 2014-12-29 01:44:55 by penalvch)