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 good for
> people writing shell completions.
>
> Or it might be better a new command which also printed a line pointing
> to the man page, and maybe showed command usage for a specific command
> if it is given as an argument.
>
> If you do either I'll take a look but I think I would recommend a new
> command here.
>
> But I am not going to agree with --help or other long options and
> duplicating text between the man page and the code.
I see. Man pages is probably a main conflicting point. I was born after the
Unix, so the web became more natural source of information for me. If I
need to use new program such as tmux - I first type "-h" to read what is
does. If there is no such information - I search about chapter on official
site or wikipedia. If "tmux" doesn't appear to be intuitive enough I type
"tmux tutorial" in search form. If my brain is locked up trying to remember
the shortcuts - I type "tmux cheatsheet". Only if I offline, I have a
chance to type "man tmux" and start reading it.
I am a user - not a sysadmin, so most of the time I spend in browser.
> On Mon, Feb 18, 2013 at 08:45:10AM +0000, Nicholas Marriott 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.
> >
> > However we already have "ambiguous command" matching:
> >
> > $ tmux lis
> > ambiguous command: lis, could be: list-buffers, list-clients,
> > list-commands, list-keys, list-panes, list-sessions, list-windows
> >
> > So the most persuasive thing to implement would be to special-case "tmux
> > help" to list all commands, or even to run "man tmux" if you think that
> > is better. Although I think in the latter case you will need to explain
> > why "tmux help" is easier than "man tmux" :-).
> >
> >
> >
> > On Mon, Feb 18, 2013 at 08:37:40AM +0000, Nicholas Marriott wrote:
> > > "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
> > > > 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).
> > > > --
> > > > anatoly t.
> > > >
> > > > On Mon, Feb 18, 2013 at 11:23 AM, Nicholas Marriott
> > > > <[1]nicholas.marri...@gmail.com> wrote:
> > > >
> > > > 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][2]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".
> > > > >
> > > > > ** **That year this tradition comes down from?
> > > > > ** **Don't you think that things need to be changed?
> > > > > ** **In other word s- do you have arguments to keep the
> things as is
> > > > in 201x+?
> > > > > ** **--**
> > > > > ** **anatoly t.**
> > > > >
> > > > > References
> > > > >
> > > > > ** **Visible links
> > > > > ** **1. mailto:[3]nicholas.marri...@gmail.com
> > > >
> > > > References
> > > >
> > > > Visible links
> > > > 1. mailto:nicholas.marri...@gmail.com
> > > > 2. mailto:nicholas.marri...@gmail.com
> > > > 3. mailto:nicholas.marri...@gmail.com
>
------------------------------------------------------------------------------
The Go Parallel Website, sponsored by Intel - in partnership with Geeknet,
is your hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials, tech docs,
whitepapers, evaluation guides, and opinion stories. Check out the most
recent posts - join the conversation now. http://goparallel.sourceforge.net/
_______________________________________________
tmux-users mailing list
tmux-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/tmux-users