Bug 131742

Summary: No man pages for YaST2 command line tools
Product: [openSUSE] SUSE LINUX 10.0 Reporter: T. Ribbrock <argathin>
Component: YaST2Assignee: Jakub Friedl <jfriedl>
Status: RESOLVED FIXED QA Contact: Klaus Kämpf <kkaempf>
Severity: Enhancement    
Priority: P5 - None CC: andreas.hanke, cihlarov
Version: Final   
Target Milestone: ---   
Hardware: Other   
OS: Other   
Whiteboard:
Found By: Other Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

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