Lennart Poettering <[email protected]> writes: > On Thu, 31.05.12 13:22, Gergely Nagy ([email protected]) wrote: > >> > On Thu, 31.05.12 12:56, Zbigniew Jędrzejewski-Szmek ([email protected]) >> > wrote: >> >> On 05/31/2012 12:40 PM, Lennart Poettering wrote: >> >> > I'd be open to rename "systemctl man" to "systemctl doc" too, if people >> >> > want this, if we make it cover both man and info. Not sure I like "doc" >> >> > too much though. Maybe we can find another name? Suggestions? The reason >> >> > I picked "man" in the first place is that it is kinda an obvious choice >> >> > and man is much more ubiquititous than info. >> >> 'help' seems to be used -- e.g. 'git help rebase'. >> > >> > We already have "systemctl help", which is equivalent to "systemctl >> > --help". >> > >> > I wonder though whether it would make sense to make "systemctl help" >> > with params work as before but with params take over the role of >> > "systemctl man"? Would that be confusing? >> >> I don't think it would be. It would actually match my expectations >> (spoiled by git, I am). > > OK, let's do it like this: let's rename "systemctl man" to "systemctl > help", and when somebody calls that without any arguments we show one > line that reads something like this: "This command expects one or more > unit names. Or did you mean systemctl --help?" > > That way we are still helpful to users but kinda avoid the problem of > overloading one command with different meanings. > > "systemctl help" would invoke "man" and "info" as necessary, but for > http/https it would just output some informational message including the > URL but not invoke xdg-open (for the reasons mentioned earlier). I think > this would be a really nice solution that should make most people happy, > feel natural, and have very few unpleasant surprises.
Sounds good. If I have some more time today, I'll prepare a patch that does the above (and supports all the info URIs mentioned elsewhere). -- |8] _______________________________________________ systemd-devel mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/systemd-devel
