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 moving or duplicating
> documentation from the manpage, it will always be the primary place for
> tmux documentation.
Right. Man is the manual, help is a cheatsheet.
> On Mon, Feb 18, 2013 at 12:36:25PM +0300, anatoly techtonik wrote:
> > On Mon, Feb 18, 2013 at 12:04 PM, Nicholas Marriott
> > <[1]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][2]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][3]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][4]nicholas.marri...@gmail.com
> > > > >
> > > > > References
> > > > >
> > > > > ** **Visible links
> > > > > ** **1. mailto:[5]nicholas.marri...@gmail.com
> > > > > ** **2. mailto:[6]nicholas.marri...@gmail.com
> > > > > ** **3. mailto:[7]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
> > 4. mailto:nicholas.marri...@gmail.com
> > 5. mailto:nicholas.marri...@gmail.com
> > 6. mailto:nicholas.marri...@gmail.com
> > 7. 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
