Bug 131742 - No man pages for YaST2 command line tools
Summary: No man pages for YaST2 command line tools
Status: RESOLVED FIXED
Alias: None
Product: SUSE LINUX 10.0
Classification: openSUSE
Component: YaST2 (show other bugs)
Version: Final
Hardware: Other Other
: P5 - None : Enhancement
Target Milestone: ---
Assignee: Jakub Friedl
QA Contact: Klaus Kämpf
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-11-01 12:43 UTC by T. Ribbrock
Modified: 2007-02-26 20:35 UTC (History)
2 users (show)

See Also:
Found By: Other
Services Priority:
Business Priority:
Blocker: ---
Marketing QA Status: ---
IT Deployment: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description T. Ribbrock 2005-11-01 12:43:14 UTC
None of the the YaST2 command line tools have man pages that describe their usage. I'm mainly thinking of "online_update" and "installation_sources" here, but there might be more. Also, there is no documentation about them in /usr/share/doc. It would be a great help if this was improved upon.
Comment 1 Michael Gross 2005-11-02 15:22:35 UTC
As is says in the description, these tools are for testin/gdebugging purposes ;)
But you can write manpages for them, of course...

Redirecting this to the maintainer of y2pmsh and taking Stanislav into CC.
What other tools would you like manpages for?
Comment 2 T. Ribbrock 2005-11-03 07:40:35 UTC
Well, I was not able to find *any* description of "online_update" or "installation_sources" - not even one that says that they are for "testing/debugging purposes"... :-) Given that "online_update" is used by YaST2 itself and that both tools can be useful for scripting/autoinstall purposes, I most definitely would not call them debugging tools.

y2pmsh might have been another one, though it is less important as most issues that could be needed for scripting/autoinstall can most likely be solved using YaST2 command line modules. However, THOSE modules have barely any documentation - not even the "yast2 MODULE help" function works for all of them! (example: "yast2 inst_source help" just displays the GUI - I think it should at least return some information about the fact that this module does not support command line operation - maybe even a reference to "installation_sources"...).

YaST2 is great as a GUI/TUI but there are many situations where scripts are more powerful - and in my opinion, man pages are the easiest and quickest way of finding documentation in that case.
Comment 4 Stanislav Visnovsky 2006-06-27 08:14:58 UTC
reopen to reassign.
Comment 5 Stanislav Visnovsky 2006-06-27 08:15:29 UTC
found it
Comment 6 Jakub Friedl 2007-02-26 20:35:19 UTC
new manpage is to be included in yast2-2.13.98.rpm