From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 7620 invoked from network); 21 Sep 2001 14:16:40 -0000 Received: from sunsite.dk (130.225.51.30) by ns1.primenet.com.au with SMTP; 21 Sep 2001 14:16:40 -0000 Received: (qmail 16195 invoked by alias); 21 Sep 2001 14:16:21 -0000 Mailing-List: contact zsh-workers-help@sunsite.dk; run by ezmlm Precedence: bulk X-No-Archive: yes X-Seq: 15851 Received: (qmail 16139 invoked from network); 21 Sep 2001 14:16:19 -0000 X-VirusChecked: Checked Sender: kiddleo@cav.logica.co.uk Message-ID: <3BAB4919.FF10480D@yahoo.co.uk> Date: Fri, 21 Sep 2001 15:05:13 +0100 From: Oliver Kiddle X-Mailer: Mozilla 4.77 [en] (X11; U; Linux 2.2.15 i686) X-Accept-Language: en MIME-Version: 1.0 To: zsh-workers@sunsite.dk Subject: PATCH: documentation for printf Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit The documentation change associated with 15848: Index: Doc/Zsh/builtins.yo =================================================================== RCS file: /cvsroot/zsh/zsh/Doc/Zsh/builtins.yo,v retrieving revision 1.35 diff -u -r1.35 builtins.yo --- Doc/Zsh/builtins.yo 2001/09/10 21:33:16 1.35 +++ Doc/Zsh/builtins.yo 2001/09/21 14:00:38 @@ -717,6 +717,24 @@ ) enditem() ) +findex(printf) +item(tt(printf) var(format) [ var(arg) ... ])( +Print the arguments according to the format specification. Formatting +rules are the same as used in C. The same escape sequences as for tt(echo) +are recognised in the format. All C format specifications ending in one of +csdiouxXeEfgG are handled. In addition to this, `tt(%b)' can be used +instead of `tt(%s)' to cause escape sequences in the argument to be +recognised and `tt(%q)' can be used to quote the argument in such a way +that allows it to be reused as shell input. With the numeric format +specifiers, if the corresponding argument starts with a quote character, +the numeric value of the following character is used as the number to +print. + +If arguments remain unused after formatting, the format string is reused +until all arguments have been consumed. If more arguments are required by +the format than have been specified, the behaviour is as if zero or an +empty string had been specified as the argument. +) findex(pushd) pindex(PUSHD_TO_HOME, use of) pindex(PUSHD_MINUS, use of) _____________________________________________________________________ This message has been checked for all known viruses by the MessageLabs Virus Scanning Service. For further information visit http://www.messagelabs.com/stats.asp