Please backport yelp-tools 3.12.1-1 (main) from utopic

[Doug Smythies]

Please backport yelp-tools 3.12.1-1 (main) from utopic to trusty.

Reason for the backport:
========================
For many many months prior to the initial release of 14.04 (Trusty) we, the Ubuntu Doc Team, had been working on issues with the official documentation and the related higher level tools. Some solutions and workarounds had been able to be implemented in the documentation, other fixes required changes to yelp-tools (and yelp-xsl). In some cases the solutions are interdependent, meaning changes to the documentation requires the newer version of the tools and style sheets to result in the correct rendering for display or compiling into html.

A bug report was submitted requesting that Ubuntu release 14.04 have at least yelp-tools version 3.11.3. That never happened.
O.K. so now we are requesting a backport, as server type people tend to stay with LTS releases we need to be able to have people build the documents on 14.04 servers.

References:
https://bugs.launchpad.net/ubuntu/+source/yelp-tools/+bug/1276230
https://bugs.launchpad.net/ubuntu/+source/yelp-xsl/+bug/1276227

Testing:
========
Mark off items in the checklist [X] as you test them, but please leave the checklist so that backporters can quickly evaluate the state of testing.

Test build kindly provided by Gunnar Hjalmarsson and available at:
https://launchpad.net/~ubuntu-core-doc/+archive/ubuntu/ppa

* trusty:
[X] Package builds without modification
[X] yelp-tools installs cleanly and runs on Ubuntu server
[X] yelp-tools installs cleanly and runs on Ubuntu desktop
[X] yelp-tools installs cleanly and runs on Ubuntu desktop, with GNOME, GNOME flashback (Compiz), GNOME Flashback (Metacity), Ubuntu (default)

Reverse dependencies:
=====================
The following reverse-dependencies need to be tested against the new version of yelp-tools. For reverse-build-dependencies (-Indep), please test that the package still builds against the new yelp-tools. For reverse-dependencies, please test that the version of the package currently in the release still works with the new yelp-tools installed. Reverse- Recommends, Suggests, and Enhances don't need to be tested, and are listed for completeness-sake.

yelp-tools
----------
* ubuntu-kylin-docs
  [X] trusty (Reverse-Build-Depends-Indep)
* cheese
  [X] trusty (Reverse-Build-Depends)
* gnome-user-docs
  [X] trusty (Reverse-Build-Depends-Indep)
      package only. I do not know how to build the HTML
* empathy
  [X] trusty (Reverse-Build-Depends)
* lightsoff
  [X] trusty (Reverse-Build-Depends)
* frogr
  [FAIL] trusty (Reverse-Build-Depends)
  Note not the fault of yelp-tools because the build FAILS with yelp-tools 3.10.0-1 anyhow.
* lightdm
  [X] trusty (Reverse-Build-Depends)
* gnome-nibbles
  [X] trusty (Reverse-Build-Depends)
* libgda5
  [X] trusty (Reverse-Build-Depends)
* totem
  [X] trusty (Reverse-Build-Depends)
* gucharmap
  [X] trusty (Reverse-Build-Depends)
* evince
  [X] trusty (Reverse-Build-Depends)
* gnome-system-monitor
  [X] trusty (Reverse-Build-Depends)
* gnome-sudoku
  [X] trusty (Reverse-Build-Depends)
* quadrapassel
  [X] trusty (Reverse-Build-Depends)
* zenity
  [X] trusty (Reverse-Build-Depends)
* gnome-desktop3
  [X] trusty (Reverse-Build-Depends)
* rhythmbox
  [X] trusty (Reverse-Build-Depends)
* gnome-control-center-signon
  [X] trusty (Reverse-Build-Depends)
* gdm
  [X] trusty (Reverse-Build-Depends)
* gnome-mahjongg
  [X] trusty (Reverse-Build-Depends)
* aisleriot
  [X] trusty (Reverse-Build-Depends)
* anjuta
  [X] trusty (Reverse-Build-Depends)
* gnome-bluetooth
  [X] trusty (Reverse-Build-Depends)
* accerciser
  [X] trusty (Reverse-Build-Depends-Indep)
* grilo-plugins
  [X] trusty (Reverse-Build-Depends)
* jhbuild
  [X] trusty (Reverse-Build-Depends)
* ghex
  [X] trusty (Reverse-Build-Depends)
* gedit-plugins
  [X] trusty (Reverse-Build-Depends)
* gnome-documents
  [X] trusty (Reverse-Build-Depends)
* ubuntu-gnome-desktop
  [X] trusty (Reverse-Depends)
* vinagre
  [X] trusty (Reverse-Build-Depends)
* sflphone
  [X] trusty (Reverse-Build-Depends)
* gnome-mines
  [X] trusty (Reverse-Build-Depends)
* gtk-doc
  [X] trusty (Reverse-Build-Depends-Indep)
* gnome-packagekit
  [X] trusty (Reverse-Build-Depends)
* five-or-more
  [X] trusty (Reverse-Build-Depends)
* gnome-search-tool
  [X] trusty (Reverse-Build-Depends)
* gnome-devel-docs
  [X] trusty (Reverse-Build-Depends)
* gnome-clocks
  [X] trusty (Reverse-Build-Depends)
* glogic
  [X] trusty (Reverse-Build-Depends)
* gnome-user-share
  [X] trusty (Reverse-Build-Depends)
* gnome-chess
  [X] trusty (Reverse-Build-Depends)
* hitori
  [X] trusty (Reverse-Build-Depends)
* gnome-robots
  [X] trusty (Reverse-Build-Depends)
* gnome-dictionary
  [X] trusty (Reverse-Build-Depends)
* gnome-terminal
  [X] trusty (Reverse-Build-Depends)
* gnote
  [X] trusty (Reverse-Build-Depends)
* gthumb
  [X] trusty (Reverse-Build-Depends)
* file-roller
  [X] trusty (Reverse-Build-Depends)
* gnome-calculator
  [X] trusty (Reverse-Build-Depends)
* gnome-panel
  [X] trusty (Reverse-Build-Depends)
* d-feet
  [X] trusty (Reverse-Build-Depends)
* swell-foop
  [X] trusty (Reverse-Build-Depends)
* simple-scan
  [X] trusty (Reverse-Build-Depends)
* gedit
  [X] trusty (Reverse-Build-Depends)
* four-in-a-row
  [X] trusty (Reverse-Build-Depends)
* gnome-system-log
  [X] trusty (Reverse-Build-Depends)
* bijiben
  [X] trusty (Reverse-Build-Depends)
* metacity
  [X] trusty (Reverse-Build-Depends)
* epiphany-browser
  [X] trusty (Reverse-Build-Depends)
* evolution
  [x] trusty (Reverse-Build-Depends)
* gnome-color-manager
  [X] trusty (Reverse-Build-Depends)
* eog
  [X] trusty (Reverse-Build-Depends)
* gnome-klotski
  [X] trusty (Reverse-Build-Depends)
* seahorse
  [X] trusty (Reverse-Build-Depends)
* gnome-platform-devel
  [X] trusty (Reverse-Depends)
* baobab
  [X] trusty (Reverse-Build-Depends)
* ubuntu-docs
  [X] trusty (Reverse-Build-Depends-Indep)
     [X} the package
     [X} the help.ubuntu.com stuff
  Severguide is not in this list. It should be:
  [X} Trusty serverguide (Reverse-Build-Depends-Indep)
     [NA] there is no package
     [X} the help.ubuntu.com stuff
* glade
  [X] trusty (Reverse-Build-Depends)
* gnome-tetravex
  [X] trusty (Reverse-Build-Depends)
* gnome-nettool
  [X] trusty (Reverse-Build-Depends)
* brasero
  [X] trusty (Reverse-Build-Depends)
* easytag
  [X] trusty (Reverse-Build-Depends)
* gnome-core-devel
  [X] trusty (Reverse-Depends)
* gnomeradio
  [X] trusty (Reverse-Build-Depends)
* giggle
  [X] trusty (Reverse-Build-Depends)
* tali
  [X] trusty (Reverse-Build-Depends)
* iagno
  [X] trusty (Reverse-Build-Depends)

Note 1: I tested building the serverguide and desktop help, and examined every difference. There are additional .css file entries, as things evolved since my builds of the tools directly from git://git.gnome.org/yelp-tools a year ago. We do not use the added .css file entries (we didn't even know about them)

Note 2: There are probably other use cases for these tools, but I wouldn't know what they are or how to test them.

[Felix Geyer (debfx)]

Accepted into trusty-backports.

[Doug Smythies (dsmythies)]

Thank you very much!!

[Doug Smythies (dsmythies)]

I do not understand. The status was set to "Fix Released", so I assumed it was done. The documents say it would be set to "Fix Committed" if it was at this step: "The uploaded backport will then require manual acceptance by a member of the Ubuntu Archive Administrators team, so there may be a short delay at this point." I removed the PPA stuff and went back to normal, uninstalled yelp stuff and re-installed but got the old versions.

Reference:
https://wiki.ubuntu.com/UbuntuBackports

[Gunnar Hjalmarsson (gunnarhj)]

@Doug: trusty-backports must be enabled in "Software & Updates". Btw, did you do "sudo apt-get update"?

[Doug Smythies (dsmythies)]

@Gunnar: I do not know what you mean by "Software & Updates", but I suspect that is some desktop thing. I run servers. And the backport lines are present in the /etc/apt/sources.list file. Yes, I did "sudo apt-get update" before "sudo apt-get dist-upgrade".

I use the Canadian site (I think), so maybe it is a propagation delay issue.

[Gunnar Hjalmarsson (gunnarhj)]

Try "sudo apt-get upgrade" as well. Otherwise it's probably something with the Canadian mirror.

[Felix Geyer (debfx)]

Backports are not installed automatically.
Run apt-get install -t trusty-backports yelp-tools

[Doug Smythies (dsmythies)]

Felix: Thanks, yes that works.

But, Oh!! That means the objective of simply having the correct version yelp-tools and yelp-xsl if one just has an up-to-date 14.04 system has not been met.

[Gunnar Hjalmarsson (gunnarhj)]

On 2015-02-22 18:23, Felix Geyer wrote:
> Backports are not installed automatically.

If previous versions of the backported packages are installed, updating to the backport versions are accomplished automatically.

Accordingly, simply running

sudo apt-get upgrade

worked fine for me.

On 2015-02-22 19:01, Doug Smythies wrote:
> That means the objective of simply having the correct version
> yelp-tools and yelp-xsl if one just has an up-to-date 14.04 system
> has not been met.

I think it has.

Did you possibly remove yelp-tools and yelp-xsl before attempting to upgrade? If you did, it explains it.

[Felix Geyer (debfx)]

> If previous versions of the backported packages are installed,
> updating to the backport versions are accomplished automatically.

Right, but there is no previous backports version of yelp-tools.
You will _not_ get any packages from backports by simply apt-get (dist-)upgrading a vanilla trusty installation.

> Accordingly, simply running
> sudo apt-get upgrade
> worked fine for me.

Maybe you had a locally installed yelp-tools package with version > release and < backports?
Or you changed the apt pinning.

[Gunnar Hjalmarsson (gunnarhj)]

Hi Felix!

I stand corrected.

On 2015-02-23 08:26, Felix Geyer wrote:
>> Accordingly, simply running
>> sudo apt-get upgrade
>> worked fine for me.
>
> Maybe you had a locally installed yelp-tools package with version >
> release and < backports?

I had the PPA version installed.

The page https://help.ubuntu.com/community/UbuntuBackports
contains a few things I wasn't aware of before. Thanks for the lesson! :)