Bug 694404

Summary:	DOC: add man pages for systemd-ask-password, systemd-*-ask-password-agent and systemd-machine-id-setup
Product:	[Fedora] Fedora	Reporter:	Rahul Sundaram <metherid>
Component:	systemd	Assignee:	systemd-maint
Status:	CLOSED NEXTRELEASE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	rawhide	CC:	johannbg, johannbg, lpoetter, metherid, mschmidt, notting, plautrba
Target Milestone:	---
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-08 23:03:42 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	784611

Description Rahul Sundaram 2011-04-07 08:57:34 UTC

Description of problem:

With the latest systemd in Fedora 15 branch,  I have the following binaries 

---
systemd                           systemd-notify
systemd-analyze                   systemd-nspawn
systemd-ask-password              systemd-stdio-bridge
systemd-cgls                      systemd-tmpfiles
systemd-gnome-ask-password-agent  systemd-tty-ask-password-agent
systemd-machine-id-setup          

---

Atleast some of these appear to be helper binaries that shouldn't be called directly by the user.  Should move these to libexec and for the rest, man pages should be added.  Some of them are missing one.

Comment 1 Lennart Poettering 2011-04-08 15:31:11 UTC

These binaries are all at the right places since they need to be in $PATH.

systemd-analyze currently doesn't have a man page, since I don't want to make its interface official in any way by documenting it.

systemd-stdio-bridge is not a user command. It is used to implement "systemctl -H" and "systemctl -P", will only be called by systemd tools themselves, but it needs to be in the $PATH for that. I don't think a man page for a binary that is not supposed to be called by the user would be a good thing.

systemd, systemd-notify, systemd-nspawn, systemd-tmpfiles, systemd-cgls have man pages.

For systemd-ask-password, systemd-*-ask-password-agent and systemd-machine-id-setup I am happy to take man page patches!

Comment 2 Lennart Poettering 2011-04-08 15:57:45 UTC

I now added a man page for systemd-ask-password to systemd git.

Comment 3 Fedora Admin XMLRPC Client 2011-10-20 16:27:00 UTC

This package has changed ownership in the Fedora Package Database.  Reassigning to the new owner of this component.

Comment 4 Jóhann B. Guðmundsson 2012-01-26 22:00:29 UTC

Adding this to fit and finish tracker bug

Comment 5 Jóhann B. Guðmundsson 2012-02-20 11:43:51 UTC

Given that we will be only back porting important fixes for F15 at this point
in time I'm moving this RFE against Rawhide so it does not get forgotten or
lost in the EOL process.

Comment 6 Lennart Poettering 2012-08-08 23:03:42 UTC

systemd-*-ask-password-agent and systemd-machine-id-setup do have man pages now in F18 and newer. Closing.