Bug 694404 - DOC: add man pages for systemd-ask-password, systemd-*-ask-password-agent and systemd-machine-id-setup
Summary: DOC: add man pages for systemd-ask-password, systemd-*-ask-password-agent and...
Keywords:
Status: CLOSED NEXTRELEASE
Alias: None
Product: Fedora
Classification: Fedora
Component: systemd
Version: rawhide
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: systemd-maint
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks: systemd-RFE
TreeView+ depends on / blocked
 
Reported: 2011-04-07 08:57 UTC by Rahul Sundaram
Modified: 2012-08-08 23:24 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-08-08 23:03:42 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

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.


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