From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 23161 invoked from network); 26 Jun 2020 18:53:13 -0000 Received: from ns1.primenet.com.au (HELO primenet.com.au) (203.24.36.2) by inbox.vuxu.org with ESMTPUTF8; 26 Jun 2020 18:53:12 -0000 Received: (qmail 20825 invoked by alias); 26 Jun 2020 18:53:03 -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: List-Unsubscribe: Sender: zsh-workers@zsh.org X-Seq: 46132 Received: (qmail 2613 invoked by uid 1010); 26 Jun 2020 18:53:03 -0000 X-Qmail-Scanner-Diagnostics: from out3-smtp.messagingengine.com by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.102.3/25850. spamassassin: 3.4.4. Clear:RC:0(66.111.4.27):SA:0(-2.6/5.0):. Processed in 3.708083 secs); 26 Jun 2020 18:53:03 -0000 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) X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduhedrudeluddgudeffecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkffoggfgsedtkedttd ertddtnecuhfhrohhmpeffrghnihgvlhcuufhhrghhrghfuceougdrshesuggrnhhivghl rdhshhgrhhgrfhdrnhgrmhgvqeenucggtffrrghtthgvrhhnpeffhfegtedtueekuefhud dvjeevfedtkeetjeetvdfhhfegkeevgfevtdelffegfeenucfkphepjeelrddujeeirdef ledrieelnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomh epugdrshesuggrnhhivghlrdhshhgrhhgrfhdrnhgrmhgv X-ME-Proxy: From: Daniel Shahaf To: zsh-workers@zsh.org Subject: [PATCH] docs: Use an itemized list in the documentation of the *(o) glob qualifier. Date: Fri, 26 Jun 2020 18:52:21 +0000 Message-Id: <20200626185221.21656-1-danielsh@tarpaulin.shahaf.local2> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Qmail-Scanner-2.11: added fake Content-Type header Content-Type: text/plain This should be easier to read, both as a tutorial and as a reference. --- Doc/Zsh/expn.yo | 28 ++++++++++++++++++---------- 1 file changed, 18 insertions(+), 10 deletions(-) diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index 3800f2fb0..a637b78a1 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -2869,18 +2869,26 @@ matches in directory traversal order will be considered. Implies tt(oN) when no tt(o)var(c) qualifier is used. ) item(tt(o)var(c))( -specifies how the names of the files should be sorted. If var(c) is -tt(n) they are sorted by name; if it is tt(L) they -are sorted depending on the size (length) of the files; if tt(l) -they are sorted by the number of links; if tt(a), tt(m), or tt(c) -they are sorted by the time of the last access, modification, or -inode change respectively; if tt(d), files in subdirectories appear before +specifies how the names of the files should be sorted. The following values +of var(c) sort in the following ways: + +startsitem() +sitem(tt(n))(By name.) +sitem(tt(L))(By the size (length) of the files.) +sitem(tt(l))(By number of links.) +sitem(tt(a))(By time of last access, youngest first.) +sitem(tt(m))(By time of last modification, youngest first.) +sitem(tt(c))(By time of last inode change, youngest first.) +sitem(tt(d))(By directories: files in subdirectories appear before those in the current directory at each level of the search DASH()- this is best combined with other criteria, for example `tt(odon)' to sort on names for -files within the same directory; if tt(N), no sorting is performed. -Note that tt(a), tt(m), and tt(c) compare -the age against the current time, hence the first name in the list is the -youngest file. Also note that the modifiers tt(^) and tt(-) are used, +files within the same directory.) +sitem(tt(N))(No sorting is performed.) +xitem(tt(e)var(string)) +sitem(tt(+)var(cmd))(Sort by shell code (see below).) +endsitem() + +Note that the modifiers tt(^) and tt(-) are used, so `tt(*(^-oL))' gives a list of all files sorted by file size in descending order, following any symbolic links. Unless tt(oN) is used, multiple order specifiers may occur to resolve ties.