Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: [PATCH v2] Correct completion of 'tmux new <TAB>'.



Oliver Kiddle wrote on Tue, 25 Jul 2017 07:57 +0200:
> Daniel Shahaf wrote:
> > Why not document _precommand?  Firstly, documenting it would help
> 
> > Not quite what you meant to say, I think, but having that section of the
> > documentation grouped by logical function would make a lot of sense.
> > Right now, anyone who tries to understand _tags by RTFM'ing needs to
> 
> We currently document functions in three sections:
>   CONTROL FUNCTIONS
>   BINDABLE COMMANDS
>   UTILITY FUNCTIONS
> _precommand's primary purpose is not really as a utility function but
> any function can be treated as one.

I see.  However, I think it's better to have it documented than
undocumented, and the "Utility functions" is the place where it fits
best among the three existing options, so I think to add it there.  It
can move to another (sub)section when such is added.

Agreed with your other (snipped) points.

Cheers,

Daniel



Messages sorted by: Reverse Date, Date, Thread, Author