DebuggingEvince

Differences between revisions 3 and 7 (spanning 4 versions)
⇤ ← Revision 3 as of 2009-02-13 11:05:53 →
Size: 2252
Editor: 139
Comment: added "backporting fixes" section
← Revision 7 as of 2009-02-18 23:29:12 → ⇥
Size: 2983
Editor: 78
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
[[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 and other similar types of files.
Line 19: Line 19:
== File missing == == Rendering issues ==
Line 27: Line 27:
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

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)
Line 31: Line 41:

= Other issues =
Line 33: Line 46:
The upstream bug tracking system for Evince is at http://bugzilla.gnome.org/browse.cgi?product=evince

= Other issues =		  * Upstream Evince bugs are at http://bugzilla.gnome.org/browse.cgi?product=evince
 * Upstream Poppler bugs are at http://bugs.freedesktop.org/query.cgi

Debugging Central

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 and other similar types of files.

Most 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)
  2. Evince does not display ("render") the document correctly
  3. Evince displays the document as it should, but then doesn't print it correctly

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:

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)

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

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)