From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 28878 invoked by alias); 25 Jul 2017 12:01:19 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 41456 Received: (qmail 1307 invoked from network); 25 Jul 2017 12:01:19 -0000 X-Qmail-Scanner-Diagnostics: from out1-smtp.messagingengine.com by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1. Clear:RC:0(66.111.4.25):SA:0(-0.7/5.0):. Processed in 2.01829 secs); 25 Jul 2017 12:01:19 -0000 X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-0.7 required=5.0 tests=RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,T_DKIM_INVALID autolearn=unavailable autolearn_force=no version=3.4.1 X-Envelope-From: d.s@daniel.shahaf.name X-Qmail-Scanner-Mime-Attachments: | X-Qmail-Scanner-Zip-Files: | Received-SPF: none (ns1.primenet.com.au: domain at daniel.shahaf.name does not designate permitted sender hosts) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=4wGjxC jWITSOI6vyZfC5Hpw6Mfdra7yE/RS+fKZ4EPE=; b=ePrGxGCay97t5QgWXFcq8n nqnLPMk+lJmdxo7m1vOyg/Nm1kVLOjMiQp25Z5FHC+BZ3hh1wsxXwHwqCVd/5UL1 VcOQut5Fh4nO6Frz6vdZIoMQjUVjpYM+2CD58zyUoxjjw3sBvAQnK5vJYkz4ngMF bEv540UT+WGjf3srz3HTGFpmQzmZoFXjEZUwgwqTT9o9DgBMLSX1xv9F7VyHH2zR UgHel4DOtrnws8RQIie1Ea66Tm5Uv9hVsDjNivberLUO1Lxd2Jfano2EZIQt8zGz LdSliY2qcMrP6dHqGpTeCv6DqySXn06JKnVBDxjGkY65r9Icqq/GVYX0VK21h+2g == DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=4wGjxC jWITSOI6vyZfC5Hpw6Mfdra7yE/RS+fKZ4EPE=; b=mZF19aRB4Y0pqmNU76zkL1 kT59JpeknQh/9nn7WI0+4xf7l9Hi0Or7dInMfDftHzsiqhBP099sZqmReITn1XC+ t+4e8PDK7fmdVkzTh7NOPczc40YAp+nDu87t8yS5DzhBneh8kaESJnGEmMtKNOR8 KA4ZLprXoUmipuSwFJWFejdndo0B7RZEXcFTHX5DC9ToD2n6dJbIcalt2brgtJAm LjQOlFFNQJwNdrJ2btS33j8Ib+E8PFAukolbxDUhJtnH0yvXT8zN3R81OR7srF0h GC/oDjlYMzhGIyIcQ7OV1JvQnJsB13G0kypQ/8YVMhF9p1jqjGlfMrdhfelVjngg == X-ME-Sender: Message-Id: <1500984067.1893542.1051881016.081D3983@webmail.messagingengine.com> From: Daniel Shahaf To: zsh-workers@zsh.org MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" X-Mailer: MessagingEngine.com Webmail Interface - ajax-c8af44bc In-Reply-To: <24145.1500962240@thecus.kiddle.eu> Date: Tue, 25 Jul 2017 12:01:07 +0000 Subject: Re: [PATCH v2] Correct completion of 'tmux new '. References: <20170720210607.16753-1-danielsh@tarpaulin.shahaf.local2> <1500659163.916799.1048510048.293AC92C@webmail.messagingengine.com> <19454.1500796085@thecus.kiddle.eu> <1500818487.2639605.1049794664.32ABA0EF@webmail.messagingengine.com> <24145.1500962240@thecus.kiddle.eu> 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