src/usr.bin/printf/printf.1, branch upstream/11.2.0 FreeBSD source tree https://cgit-dev.freebsd.org/src/atom?h=upstream%2F11.2.0 2014-04-21T22:47:18Z Add parameterized position handling to printf(1). 2014-04-21T22:47:18Z Pedro F. Giffuni pfg@FreeBSD.org 2014-04-21T22:47:18Z urn:sha1:b0620803d5b1d2d184c35fdce6670ce475b0f9da Add a new %n$ option to change the order of the parameters as done in the ksh93 builtin printf (among others). For example: %printf '%2$1d %1$s\n' one 2 three 4 2 one 4 three The feature was written by Garret D'Amore under a BSD license for Nexenta/illumos. Reference: http://garrett.damore.org/2010/10/new-implementation-of-printf.html PR: bin/152934 Obtained from: Illumos MFC after: 2 weeks Remove trailing whitespace per mdoc lint warning 2012-03-29T05:02:12Z Eitan Adler eadler@FreeBSD.org 2012-03-29T05:02:12Z urn:sha1:50d675f7a9fca2f3fba3a23ac41a8ae2c0162e4e Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days printf(1): Document that %c and precision for %b/%s use bytes, not chars. 2011-05-28T14:32:47Z Jilles Tjoelker jilles@FreeBSD.org 2011-05-28T14:32:47Z urn:sha1:27a43b2e515bc2f8f34782b8e14e04cd2ec9471c This means these features do not work as expected with multibyte characters. This perhaps less than ideal behaviour matches printf(3) and is specified by POSIX. printf: Allow multibyte characters for '<char> form, avoid negative codes. 2011-05-28T11:37:47Z Jilles Tjoelker jilles@FreeBSD.org 2011-05-28T11:37:47Z urn:sha1:98102dabd3d1f00bb970634a5722be0f7e93078d Examples: LC_ALL=en_US.UTF-8 printf '%d\n' $(printf \'\\303\\244) LC_ALL=en_US.ISO8859-1 printf '%d\n' $(printf \'\\344) Both of these should print 228. Like some other shells, incomplete or invalid multibyte characters yield the value of the first byte without a warning. Note that there is no general way to go back from the character code to the character. printf(1): Move non-bugs from the BUGS section to a new section CAVEATS. 2011-04-25T19:15:58Z Jilles Tjoelker jilles@FreeBSD.org 2011-04-25T19:15:58Z urn:sha1:1792d820be90e4cd5e41cea3e0e1fb39680b2d99 printf(1): Mention effect of '#' modifier on other conversions. 2011-04-25T12:36:29Z Jilles Tjoelker jilles@FreeBSD.org 2011-04-25T12:36:29Z urn:sha1:8a906b236a671afcc18c2e66a6b760674ecef57f Remove the advertising clause from UCB copyrighted files in usr.bin. This 2010-12-11T08:32:16Z Joel Dahl joel@FreeBSD.org 2010-12-11T08:32:16Z urn:sha1:da52b4caaf187775f6b56a72c6b16e94ad728f7b is in accordance with the information provided at ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change Also add $FreeBSD$ to a few files to keep svn happy. Discussed with: imp, rwatson sh: Add printf builtin. 2010-11-19T12:56:13Z Jilles Tjoelker jilles@FreeBSD.org 2010-11-19T12:56:13Z urn:sha1:9897c45f31fe59265a9bd531cac4e6eb8effc04d This was removed in 2001 but I think it is appropriate to add it back: * I do not want to encourage people to write fragile and non-portable echo commands by making printf much slower than echo. * Recent versions of Autoconf use it a lot. * Almost no software still wants to support systems that do not have printf(1) at all. * In many other shells printf is already a builtin. Side effect: printf is now always the builtin version (which behaves identically to /usr/bin/printf) and cannot be overridden via PATH (except via the undocumented %builtin mechanism). Code size increases about 5K on i386. Embedded folks might want to replace /usr/bin/printf with a hard link to /usr/bin/alias. Note bug in trying to printf(1) things like: '-%s\n' "foo" 2010-09-09T19:27:40Z David E. O'Brien obrien@FreeBSD.org 2010-09-09T19:27:40Z urn:sha1:4b2f91532164095cf83202b30824896be0adf41a printf(1): Clarify that \OOO produces a byte, different %b escape sequences. 2010-09-05T21:44:50Z Jilles Tjoelker jilles@FreeBSD.org 2010-09-05T21:44:50Z urn:sha1:3cf53e8550e625965b82310f07bc6ca93226a901 Octal escape sequences are expanded to bytes, not characters, and multiple are required for a multibyte character. The valid escape sequences in %b strings are slightly different from the escape sequences in the format string.