man pages are missing for all the programs

Bug #837778 reported by Angus Salkeld on 2011-08-31
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
OpenStack Compute (nova)
Wishlist
Unassigned
Fedora
Won't Fix
Undecided

Bug Description

When packaging nova for Fedora we noticed that there are no man pages.

Even help2man generated output would be better than nothing.

openstack-nova.noarch: W: no-manual-page-for-binary nova-clear-rabbit-queues
openstack-nova.noarch: W: no-manual-page-for-binary nova-dhcpbridge
openstack-nova.noarch: W: no-manual-page-for-binary nova-manage
openstack-nova.noarch: W: no-manual-page-for-binary nova-console
openstack-nova.noarch: W: no-manual-page-for-binary nova-compute
openstack-nova.noarch: W: no-manual-page-for-binary nova-api
openstack-nova.noarch: W: no-manual-page-for-binary nova-volume
openstack-nova.noarch: W: no-manual-page-for-binary nova-logspool
openstack-nova.noarch: W: no-manual-page-for-binary nova-network
openstack-nova.noarch: W: no-manual-page-for-binary nova-spoolsentry
openstack-nova.noarch: W: no-manual-page-for-binary nova-vncproxy
openstack-nova.noarch: W: no-manual-page-for-binary nova-api-ec2
openstack-nova.noarch: W: no-manual-page-for-binary nova-debug
openstack-nova.noarch: W: no-manual-page-for-binary nova-api-os
openstack-nova.noarch: W: no-manual-page-for-binary nova-direct-api
openstack-nova.noarch: W: no-manual-page-for-binary nova-ajax-console-proxy
openstack-nova.noarch: W: no-manual-page-for-binary nova-stack
openstack-nova.noarch: W: no-manual-page-for-binary nova-scheduler
openstack-nova.noarch: W: no-manual-page-for-binary nova-objectstore
openstack-nova.noarch: W: no-manual-page-for-binary nova-instance-usage-audit

rpmlint complains:

openstack-nova.noarch: W: no-manual-page-for-binary nova-clear-rabbit-queues
openstack-nova.noarch: W: no-manual-page-for-binary nova-dhcpbridge
openstack-nova.noarch: W: no-manual-page-for-binary nova-manage
openstack-nova.noarch: W: no-manual-page-for-binary nova-console
openstack-nova.noarch: W: no-manual-page-for-binary nova-compute
openstack-nova.noarch: W: no-manual-page-for-binary nova-api
openstack-nova.noarch: W: no-manual-page-for-binary nova-volume
openstack-nova.noarch: W: no-manual-page-for-binary nova-logspool
openstack-nova.noarch: W: no-manual-page-for-binary nova-network
openstack-nova.noarch: W: no-manual-page-for-binary nova-spoolsentry
openstack-nova.noarch: W: no-manual-page-for-binary nova-vncproxy
openstack-nova.noarch: W: no-manual-page-for-binary nova-api-ec2
openstack-nova.noarch: W: no-manual-page-for-binary nova-debug
openstack-nova.noarch: W: no-manual-page-for-binary nova-api-os
openstack-nova.noarch: W: no-manual-page-for-binary nova-direct-api
openstack-nova.noarch: W: no-manual-page-for-binary nova-ajax-console-proxy
openstack-nova.noarch: W: no-manual-page-for-binary nova-stack
openstack-nova.noarch: W: no-manual-page-for-binary nova-scheduler
openstack-nova.noarch: W: no-manual-page-for-binary nova-objectstore
openstack-nova.noarch: W: no-manual-page-for-binary nova-instance-usage-audit

We should file a bug with upstream requesting man pages

I was thinking of using help2man in the spec as the --help output is
quite good. An least until upstream sort it out. (asking for man
pages normally takes a while).

Nice idea!

Thierry Carrez (ttx) on 2011-08-31
Changed in nova:
importance: Undecided → Wishlist
status: New → Confirmed

No progress, so unassigning

Tom Fifield (fifieldt) wrote :

Sad state of affairs continues ;)

$ ls -1 nova/doc/source/man/
nova-manage.rst

Joe Gordon (jogo) wrote :

This has been fixed in Folsom

Changed in nova:
status: Confirmed → Fix Released

This message is a reminder that Fedora 16 is nearing its end of life.
Approximately 4 (four) weeks from now Fedora will stop maintaining
and issuing updates for Fedora 16. It is Fedora's policy to close all
bug reports from releases that are no longer maintained. At that time
this bug will be closed as WONTFIX if it remains open with a Fedora
'version' of '16'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version'
to a later Fedora version prior to Fedora 16's end of life.

Bug Reporter: Thank you for reporting this issue and we are sorry that
we may not be able to fix it before Fedora 16 is end of life. If you
would still like to see this bug fixed and are able to reproduce it
against a later version of Fedora, you are encouraged to click on
"Clone This Bug" and open it against that version of Fedora.

Although we aim to fix as many bugs as possible during every release's
lifetime, sometimes those efforts are overtaken by events. Often a
more recent Fedora release includes newer upstream software that fixes
bugs or makes them obsolete.

The process we are following is described here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping

Fedora 16 changed to end-of-life (EOL) status on 2013-02-12. Fedora 16 is
no longer maintained, which means that it will not receive any further
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen this bug against that version.

Thank you for reporting this bug and we are sorry it could not be fixed.

Changed in fedora:
importance: Unknown → Undecided
status: Unknown → Won't Fix
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.