From 692a15363f1332ad62e3e915a7842fbc343d45b3 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Tue, 21 May 2013 17:11:04 +0100 Subject: 31418: improve documentation for "age" function --- Doc/Zsh/calsys.yo | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) (limited to 'Doc') diff --git a/Doc/Zsh/calsys.yo b/Doc/Zsh/calsys.yo index 259eb23b3..b3eb454a0 100644 --- a/Doc/Zsh/calsys.yo +++ b/Doc/Zsh/calsys.yo @@ -651,16 +651,24 @@ date specification must be quoted to ensure tt(age) receives the correct arguments, hence the use of the additional colon to separate the date and time. -example(AGEREF1=2006/10/04:10:15 +example(AGEREF=2006/10/04:10:15 AGEREF2=2006/10/04:10:45 print *+LPAR()PLUS()age+RPAR()) This shows the same example before using another form of argument -passing. The dates and times in the parameters tt(AGEREF1) and tt(AGEREF2) +passing. The dates and times in the parameters tt(AGEREF) and tt(AGEREF2) stay in effect until unset, but will be overridden if any argument is passed as an explicit argument to age. Any explicit argument causes both parameters to be ignored. +Instead of an explicit date and time, it's possible to use the +modification time of a file as the date and time for either argument +by introducing the file name with a colon: + +example(print *+LPAR()e-age :file1 :file2-+RPAR()) + +This matches all files modified no earlier than tt(file1) and +no later than tt(file2). texinode(Calendar Styles)(Calendar Utility Functions)(Calendar System User Functions)(Calendar Function System) sect(Styles) -- cgit 1.4.1