Bug 852726

Summary: Man page for rhc command missing
Product: OKD Reporter: Troy Dawson <tdawson>
Component: ocAssignee: Clayton Coleman <ccoleman>
Status: CLOSED NOTABUG QA Contact: libra bugs <libra-bugs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.xCC: guillermo.gomez
Target Milestone: ---Keywords: Reopened
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-08-29 18:09:50 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Troy Dawson 2012-08-29 12:22:04 UTC
Description of problem:

With a gem install, there is no man page explaining the rhc command and its behaviour.

Version-Release number of selected component (if applicable):

rhc-0.97.17

How reproducible:

Always

Steps to Reproduce:
1. gem install rhc
2. man rhc
3.
  
Actual results:

$ man rhc
No manual entry for rhc

Expected results:

A man page to show up

Additional info:

I know we have man pages.  They are in the rhc rpm.  We just have to get them into the gem file.

Comment 1 Clayton Coleman 2012-08-29 16:31:00 UTC
Gem files can't install man, and shouldn't.

Comment 2 Troy Dawson 2012-08-29 16:53:56 UTC
Can we at least have the man pages in the gem file.
That would provide two things.
 - people who want to use the gem man plugin can
 - people building packages from the gem (Fedora rpm's, possibly others) would be able to install man pages.

This would only mean adding one line to the gemspec

  s.files += Dir.glob("man/*")

Comment 3 Clayton Coleman 2012-08-29 18:09:50 UTC
Man files are going to be generated by the RPM build from the source - so as soon as J5's changes drop anyone with the gem source will be able to run a rake command to generate man files (bundle exec rake man:generate" or something).  This means that man files won't exist in source - they'll exist in the command metadata and be generated on demand.

Comment 4 Troy Dawson 2012-08-29 18:21:59 UTC
Thank sounds great.
Thank You

Comment 5 Guillermo Gómez 2012-09-22 13:30:37 UTC
News? As far as gem source version 0.98.16 i dont see any rake tasks.


rgds
Guillermo