Bug 1288539 - [Tracker][RFE] Provide man pages for all Satellite 6 commands and config files
Summary: [Tracker][RFE] Provide man pages for all Satellite 6 commands and config files
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.1.4
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: Unspecified
Assignee: satellite-doc-list
QA Contact: satellite-doc-list
URL:
Whiteboard:
Depends On: 1420341 1420349 1420353 1457176 1505481 1535641 1541149 1558604
Blocks: 260381
TreeView+ depends on / blocked
 
Reported: 2015-12-04 14:26 UTC by daniel
Modified: 2019-12-16 05:09 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of:
: 1420341 1420349 1420353 1457176 (view as bug list)
Environment:
Last Closed: 2018-10-03 01:21:29 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1387890 0 medium CLOSED [RFE] More information on Scenarios 2021-02-22 00:41:40 UTC

Internal Links: 1387890

Description daniel 2015-12-04 14:26:43 UTC
1. Proposed title of this feature request  
       Provide man pages for all satellite 6 commands and config files
      
      
    3. What is the nature and description of the request?  
     Some commands like katello-installer, capsule-certs-gen, hammer,...
     do have no man page but only --help or --full-help and in case 
     documentation for $config file is needed one has to look in online
     documentation, sometimes even upstream which makes it hard to understand
     which value is provided by Red Hat then

    4. Why does the customer need this? (List the business requirements here)  
     Aside the face that man pages are good practice to have for _all_
     commands _and_ config files it is not always possible to have a look at
     documentation on line, further on documentations and --help pages are  
     often lacking examples which normally can be found in man pages. Especially 
     for conf* files it is sometime not easy to understand what setting should/could be 
     used 
      
      
    5. How would the customer like to achieve this? (List the functional requirements here)  
    man pages for all commands provided by satellite should be available as well as
    for configuration files. In order to get an interim solution it would be one possibility
    to have man pages pointing to web pages where detailed information is available which
    would at least for config files help to understand them better
      
    6. For each functional requirement listed, specify how Red Hat and the customer can test to confirm the requirement is successfully implemented.  
       man $command ; man $config_file
      
    7. Is there already an existing RFE upstream or in Red Hat Bugzilla?  
     Found none
      
    8. Does the customer have any specific timeline dependencies and which release would they like to target (i.e. RHEL5, RHEL6)?  
     no
      
    9. Is the sales team involved in this request and do they have any additional input?  
     no
      
      
    10. Would the customer be able to assist in testing this functionality if implemented?  
     yes

Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 Stephen Wadeley 2017-01-28 10:54:42 UTC
Hello Bryan

What is the correct BZ component for requesting man pages form engineering?

Should we turn this into a tracker bug and then clone for every package containing a command?

Thank you

Comment 3 Bryan Kearney 2017-02-07 15:42:33 UTC
We dont really have a good doc for this. Ack to using this as a tracker.

Comment 4 Stephen Wadeley 2017-02-08 13:46:13 UTC
Bug 1420341 - [RFE] Provide man pages for satellite-installer

Comment 5 Stephen Wadeley 2017-02-08 13:55:39 UTC
Hammer has only one very brief man page with a usage message.

Comment 6 Stephen Wadeley 2017-02-08 14:02:06 UTC
Bug 1420349 - [RFE] Provide man page for katello-certs-check

Comment 7 Stephen Wadeley 2017-02-08 14:08:45 UTC
Bug 1420353 - [RFE] Provide man page capsule-certs-generate

Comment 8 Andrew Dahms 2018-10-03 01:21:29 UTC
Thank you for raising this bug.

We have evaluated this request, and while we recognize that it is a valid request for the documentation, we do not expect this to be implemented in the product in the foreseeable future. We are therefore closing this out as WONTFIX. 

If you have any concerns about this, please feel free to contact Andrew Dahms.


Note You need to log in before you can comment on or make changes to this bug.