---- Reported by jim@yorba.org 2009-11-04 11:07:00 -0800 ----

Original Redmine bug id: 987
Original URL: http://redmine.yorba.org/issues/987
Searchable id: yorba-bug-987
Original author: Jim Nelson
Original description:

The Shotwell man page is only installed when using Debian packaging.

Related issues:
related to shotwell - Feature #2783: switch to CMake or another build system (Open)
related to shotwell - Bite-sized #3998: man page should list invocation
options (Fixed)
related to shotwell - 7558: Add a man page (Invalid)



---- Additional Comments From shotwell-maint@gnome.bugs 2013-01-15 13:13:00 -0800 ----

### History

####

#1

Updated by Adam Dingle almost 3 years ago

  * **Target version** set to _0.9_

####

#2

Updated by Adam Dingle almost 3 years ago

  * **Target version** deleted (<strike>_0.9_</strike>)

####

#3

Updated by Adam Dingle almost 3 years ago

  * **Target version** set to _0.9_
  * **Priority** set to _High_

Patch pending from Clinton.

####

#4

Updated by Adam Dingle almost 3 years ago

  * **Status** changed from _Open_ to _Review_
  * **Target version** deleted (<strike>_0.9_</strike>)

This is more involved than it appeared at first glance, actually. Let's put
this off until 0.10 since our whole build system may be changing anyway (see
#2783).

####

#5

Updated by Adam Dingle over 2 years ago

  * **Priority** deleted (<strike>_High_</strike>)

####

#6

Updated by Jim Nelson 10 months ago

The problem here is that the man page is located alongside the Debian
packaging, which is not included in the tarball. The reason for this is that
when we originally packaged Shotwell, the Debian guides out there stated that
that's where to put the man page for the debhelper programs to find and
properly install it. Indeed, as I understand things, installing a man page
requires more than copying a file, as (memory shaky here) there was some
indexing program the installer needed to run afterwards, probably for apropos.

So, two problems here: (1) we don't want two copies of the man page in our
source tree, so there should be only one that both the Debian installer and
our own installer can get to (assuming the Debian installer needs access to it
once this work is done), and (2) we need to install the man page in a proper,
cross-distro kind of way.

####

#7

Updated by Joe Bylund 10 months ago

The debian way of installing manpages is dh_installman, I believe that just
copies the manpages listed in debian/manpages or debian/packagename.manpages
to the proper manpath directory.

Apropos seems to just search the "descriptions" of the man pages, possibly
using regex's, but without any sort of index/hash.

A "sudo mandb --quiet" can help remove old manpages that weren't properly
removed.

Seems like we could just copy it over, possibly run mandb and let debian
continue the way it currently does.

####

#8

Updated by Jim Nelson 10 months ago

  * **Category** set to _documentation_

That seems reasonable. It would mean moving the man page out of the debian
directory and doing all this in the Makefile and removing the appropriate
commands from the debian/control file.



--- Bug imported by chaz@yorba.org 2013-11-25 21:42 UTC  ---

This bug was previously known as _bug_ 987 at http://redmine.yorba.org/show_bug.cgi?id=987

Unknown version " in product shotwell. 
   Setting version to "!unspecified".
Unknown milestone "unknown in product shotwell. 
   Setting to default milestone for this product, "---".
Setting qa contact to the default for this product.
   This bug either had no qa contact or an invalid one.
Resolution set on an open status.
   Dropping resolution