DebuggingEvince
|
Size: 1612
Comment: Initial skeleton of this page
|
Size: 4275
Comment: Misc. minor presentation fixes
|
| 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 supported files as outlined by the project. |
| Line 8: | Line 10: |
| Bugs related to Evince fall into 3 categories: 1. Evince crashes when I open a specific document (or when I open it and perform a specific action, like scroll, zoom or rotate) 1. Evince does not display ("render") the document correctly 1. Evince displays the document as it should, but then doesn't print it correctly |
= 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 [[https://bugs.launchpad.net/ubuntu/+source/evince/+bug/42410|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'''. |
| Line 15: | Line 24: |
| == Stock Reply == | In all reports, please ensure you attach an uncompressed/untarred document that the issue is reproducible with. |
| Line 17: | Line 26: |
| In the event that a bug reporter is having a crash with a specific document obtaining that document will help. | == Crash or Freeze == |
| Line 19: | Line 28: |
| {{{ 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. }}} |
If Evince crashes, please report this following [[https://wiki.ubuntu.com/ReportingBugs]]. |
| Line 23: | Line 30: |
| == How to Forward == | == Rendering issues == |
| Line 25: | Line 32: |
| The upstream bug tracking system for Evince is at http://bugzilla.gnome.org/browse.cgi?product=evince | 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: * [[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 Try opening it with different viewers to try and isolate the problem: * Adobe Reader - package [[https://launchpad.net/ubuntu/+source/acroread|acroread]] in Precise only, or Adobe Reader via the latest [[https://launchpad.net/~ubuntu-wine/+archive/ubuntu/ppa|WINE]]. * Xpdf - package [[https://launchpad.net/ubuntu/+source/xpdf|xpdf]] * Okular - package [[https://launchpad.net/ubuntu/+source/okular|okular]] * ePdfView - package [[https://launchpad.net/ubuntu/+source/epdfview|epdfview]] in Precise only * PostScript (.ps) * ghostscript * .djvu * djVuLibre - package [[https://launchpad.net/ubuntu/+source/djview4|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 29: | Line 55: |
| 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. | 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. * Evince: [[http://bugzilla.gnome.org/browse.cgi?product=evince]] * Poppler: [[http://bugs.freedesktop.org/query.cgi]] = Backporting Fixes = Bug fixes are reviewed for backporting to all [[https://wiki.ubuntu.com/Releases|supported Ubuntu releases]] following [[https://wiki.ubuntu.com/StableReleaseUpdates]]. ---- 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 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.
DebuggingEvince (last edited 2014-12-29 01:44:55 by penalvch)