[Bug 997891] Re: sometimes cannot build pdfs for de, sl, pt, es, nl, pl, or it locales

[Ubuntu Foundation's Bug Bot]

The attachment "Debdiff for precise-proposed" of this bug report has
been identified as being a patch in the form of a debdiff.  The ubuntu-
sponsors team has been subscribed to the bug report so that they can
review and hopefully sponsor the debdiff.  In the event that this is in
fact not a patch you can resolve this situation by removing the tag
'patch' from the bug report and editing the attachment so that it is not
flagged as a patch.  Additionally, if you are member of the ubuntu-
sponsors team please also unsubscribe the team from this bug report.

[This is an automated message performed by a Launchpad user owned by
Brian Murray.  Please contact him regarding any issues with the action
taken in this bug report.]

** Tags added: patch

-- 
You received this bug notification because you are a member of Ubuntu
Sponsors Team, which is subscribed to the bug report.
https://bugs.launchpad.net/bugs/997891

Title:
  sometimes cannot build pdfs for de, sl, pt, es, nl, pl, or it locales

Status in “sphinx” package in Ubuntu:
  New

Bug description:
  Newer versions of docutils (>=0.8) report full language name rather
  than shortcodes and hence breaking pdf compilation in de, sl, pt, es,
  nl, pl and it locales as the \shorthandoff directive is not added and
  triggering latex is generated.

  I submitted this patch upstream last night and it was accepted.
  https://bitbucket.org/birkenfeld/sphinx/pull-request/64/added-
  language-names-to-the-shorthandoff

  SRU Info:
  [Impact] - On systems where python-docutils is version 0.8 or above, this bug prevents pdf generation from sphinx generated latex source for the de, sl, pt, es, nl, pl and it locales. I expect that my upstream patch will be released with the next version of python-sphinx.

  [Development Fix] - A debdiff for quantal has been attached. It is
  functionally identical to the precise-proposed debdiff as the sphinx
  versions are still identical.

  [Stable Fix] - A debdiff for precise-proposed has been attached. It
  adds full language names to the pool of shortcodes which the tex file
  writer uses to evaluate the necessity of the \shorthandoff directive.

  [Test Case] - I encountered this issue while trying to build the
  Mahara manual ( git://gitorious.org/mahara/manual.git ) on precise.

  * Install git-core and python-sphinx along with its recommends.
  * git clone git://gitorious.org/mahara/manual.git
  * add the following to the bottom of manual/source/conf.py:
  language = 'de'
  * run 'make clean latex'
  * view the build/latex/Mahara.tex file with an editor.
  * You should see the following after the preamble and \def stuff:
  \begin{document}

  \maketitle
  * after applying the changes in the patches and viewing the .tex file again, you should see this:
  \begin{document}
  \shorthandoff{"}
  \maketitle

  [Regression Potential] - I don't believe it should regress, nothing is
  being taken away, rather additional workaround support is added.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/sphinx/+bug/997891/+subscriptions