[arch-projects] [initscripts] Add manpage for rc.d script
As suggested by Tom at [1], I'm sending this patch here (see attachment). Please proof-read and give comments. Cheers, Elvis [1] https://bugs.archlinux.org/task/25269
2011/7/27 Elvis Stansvik <elvstone@gmail.com>:
As suggested by Tom at [1], I'm sending this patch here (see attachment). Please proof-read and give comments.
No further comments on this one? So it can go in? No hurry. Just asking since I saw a new version of initscripts getting pushed out and thought this one might have been forgotten. Cheers, Elvis
On Sun, Jul 31, 2011 at 11:51 AM, Elvis Stansvik <elvstone@gmail.com> wrote:
Not forgotten, I was just waiting for comments. No one said anything so I'll apply it now and it will be out in the next release. Thanks, -t
On Wed, Jul 27, 2011 at 12:09:10PM +0200, Elvis Stansvik wrote:
I'd like to see this in a more canonical format, e.g. rc.d <action> [daemons] list is an action, too.
Not sure I like this paragraph. It'd a bit repetitious in context with the above synopsis and makes no mention of /etc/rc.d. Maybe something like... rc.d controls and shows the status of programs which install a control script in /etc/rc.d. Actions will vary between daemons, but are typically one of 'start', 'start', or 'restart'. See <<A,Actions>> below for more information. The 'list' action will display the status of the given daemons, displaying all if no daemons are given. I'm sending a patch shortly to make this last part about 'list' accurate.
It might just be me, but I don't like the usage of the word 'signal' here, as it might imply that a signal is sent, which isn't always the case.
This whole section should be pluralized wrt daemons, no? dave
daemons.
On Sun, Jul 31, 2011 at 2:30 PM, Dave Reisner <d@falconindy.com> wrote:
I'm not a good english writer/speaker but i believe its: was created. List action take 2 arguments (started/stopped). It should take place in the man page. I'm not sure status is can be classified as "standard", few package in official repo use it ! -- Sébastien Luttringer www.seblu.net
On Sun, Jul 31, 2011 at 03:03:18PM +0200, Seblu wrote:
'is created' is better, since we usually speak in the present tense about code (e.g. git commits), and this is also in line with what mkinitcpio uses in its manpage. 'was created' is also proper, just not in this context.
Maybe it should be ;) d
2011/7/31 Dave Reisner <d@falconindy.com>:
I'm preparing a patch to incorporate these suggestions (minus the "list <daemons>" thing as I saw that was reverted, right?). Anyone know how I can get a newline in the synopsis, because I guess there are two distinct synopsises now: rc.d <action> [daemons] rc.d list [started|stopped] Or? The '+' to get a newline didn't work for manpage output of a2x. Elvis
On Sun, Jul 31, 2011 at 3:52 PM, Elvis Stansvik <elvstone@gmail.com> wrote:
[seblu@rwolf ~]$ rc.d usage: rc.d <action> <daemon> [daemon] ... rc.d list [started|stopped] rc.d help -- Sébastien Luttringer www.seblu.net
2011/7/31 Seblu <seblu@seblu.net>:
Right, so three synopsises. But I can't figure out how to force a line break in the manpage. (This is the first one I ever wrote). Elvis
participants (4)
-
Dave Reisner
-
Elvis Stansvik
-
Seblu
-
Tom Gundersen