Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 1:07 PM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > > Or I would be quite happy with a "tmux help" command which lists all > commands (perhaps even with a one-line description). But that is a > larger code change. > > But we are not going to go the route of m

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 12:28 PM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > Perhaps it would be useful if you at least gave us the text you would > like tmux to show so we are discussing something concrete? > Right. $ tmux -h tmux 1.7 - terminal multiplexer - manages multiple wi

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 1:38 PM, Sinbad wrote: > i agree with antoly, i found it surprising that a > new tool like tmux doesn't have 'tmux -h' or 'tmux > --help', the first command i ran when i first > installed tmux was 'tmux -h', it started a session > instead of printing concise help, this was

Re: Extend -h, --help output

2013-02-18 Thread Sinbad
i agree with antoly, i found it surprising that a new tool like tmux doesn't have 'tmux -h' or 'tmux --help', the first command i ran when i first installed tmux was 'tmux -h', it started a session instead of printing concise help, this was a surprise to me, and felt counter intuitive. And also in

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 12:21 PM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > Funny I just tried "cd -h", "df -h", "ls -h", "ps -h" and none of them > gave me help. It seems people with expectations for -h are going to have > them dashed fairly often? > People are being told that it

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 11:45 AM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > There is no way tmux will support -h or --help unless you can change the > consensus on OpenBSD, or at least other common OpenBSD ports to Linux > like OpenSSH. > For that I need the starting point. Where

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
The reason is that users expect -h to work as in svn or hg way I described earlier. A poll is the proof. -- anatoly t. On Mon, Feb 18, 2013 at 11:37 AM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > "You don't want to do it" is not a good argument for changing it. > > A poll is not

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 12:04 PM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > Actually we already have "tmux list-commands" so you could just make a > flag to show a short version of this (command names only), add the > START_SERVER flag and alias "help" to it. This might also be goo

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
Yes, the point is that you do not use tmux in isolation, it is part of a Unix-like system (be it Linux or BSD or other). On Unix systems, "man" (and "info" on GNU) is the default place for documentation. In theory your system docs should tell you how to use man, but I recognise that sometimes new

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
Perhaps it would be useful if you at least gave us the text you would like tmux to show so we are discussing something concrete? I don't object to -h particularly, even if the argument that "people expect it" is clearly spurious. Some people may try it. But it should not duplicate the man page.

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
Funny I just tried "cd -h", "df -h", "ls -h", "ps -h" and none of them gave me help. It seems people with expectations for -h are going to have them dashed fairly often? On Mon, Feb 18, 2013 at 12:13:43PM +0300, anatoly techtonik wrote: >The reason is that users expect -h to work as in svn o

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
Actually we already have "tmux list-commands" so you could just make a flag to show a short version of this (command names only), add the START_SERVER flag and alias "help" to it. This might also be good for people writing shell completions. Or it might be better a new command which also printed a

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
There is no way tmux will support -h or --help unless you can change the consensus on OpenBSD, or at least other common OpenBSD ports to Linux like OpenSSH. However we already have "ambiguous command" matching: $ tmux lis ambiguous command: lis, could be: list-buffers, list-clients, list-commands

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
"You don't want to do it" is not a good argument for changing it. A poll is not going to help. This is not a democracy. You need to give reasons. On Mon, Feb 18, 2013 at 11:26:32AM +0300, anatoly techtonik wrote: >Yes. I think it needs to be changed. The other aspect that you probably >

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
Yes. I think it needs to be changed. The other aspect that you probably don't want to change, because you've used to it and therefore it is a work that you're not interested in. I think the only solution here is to run a poll as a proof to show that this behavior really provides a value (or not).

Re: Extend -h, --help output

2013-02-18 Thread Nicholas Marriott
I do not think it needs to change. Do you? On Mon, Feb 18, 2013 at 11:08:36AM +0300, anatoly techtonik wrote: >On Mon, Feb 18, 2013 at 12:44 AM, Nicholas Marriott ><[1]nicholas.marri...@gmail.com> wrote: > > tmux is a BSD program and traditionally BSD programs do not support -h, >

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 12:48 AM, Thomas Adam wrote: > On Sun, Feb 17, 2013 at 10:40:48PM +0300, anatoly techtonik wrote: > > Hi, > > > > While my previous message awaits moderator's approval, here is another > one. > > > > $ tmux -h > > tmux: unknown option -- h > > usage: tmux [-28lquv] [-c she

Re: Extend -h, --help output

2013-02-18 Thread anatoly techtonik
On Mon, Feb 18, 2013 at 12:44 AM, Nicholas Marriott < nicholas.marri...@gmail.com> wrote: > tmux is a BSD program and traditionally BSD programs do not support -h, > --help or indeed any extended built-in help beyond the usage string. You > should be able to see the tmux help with "man tmux". Th

Re: Extend -h, --help output

2013-02-17 Thread Thomas Adam
On Sun, Feb 17, 2013 at 10:40:48PM +0300, anatoly techtonik wrote: > Hi, > > While my previous message awaits moderator's approval, here is another one. > > $ tmux -h > tmux: unknown option -- h > usage: tmux [-28lquv] [-c shell-command] [-f file] [-L socket-name] > [-S socket-path] [

Re: Extend -h, --help output

2013-02-17 Thread Nicholas Marriott
tmux is a BSD program and traditionally BSD programs do not support -h, --help or indeed any extended built-in help beyond the usage string. You should be able to see the tmux help with "man tmux". On Sun, Feb 17, 2013 at 10:40:48PM +0300, anatoly techtonik wrote: >Hi, >While my previous