aboutsummaryrefslogtreecommitdiff
path: root/man/printf.1
diff options
context:
space:
mode:
authorSoccera1 <[email protected]>2026-07-28 15:54:54 +1000
committerSoccera1 <[email protected]>2026-07-28 15:54:54 +1000
commit6a2f098e72e71437154ec00506e8e736aa8e1026 (patch)
tree63e9f5596be38558dbeb40bb566735759a3ccabb /man/printf.1
parenta753f669c9bedfccb9f7f400da018bb487dca5d0 (diff)
downloadbnu-6a2f098e72e71437154ec00506e8e736aa8e1026.tar.gz
bnu-6a2f098e72e71437154ec00506e8e736aa8e1026.zip
Add docs
Diffstat (limited to 'man/printf.1')
-rw-r--r--man/printf.1111
1 files changed, 111 insertions, 0 deletions
diff --git a/man/printf.1 b/man/printf.1
new file mode 100644
index 0000000..a1a6be0
--- /dev/null
+++ b/man/printf.1
@@ -0,0 +1,111 @@
+.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
+.TH PRINTF "1" "2026-07-28" "BNU 9.11" "BNU Commands"
+.SH NAME
+printf \- format and print data
+.SH SYNOPSIS
+.B printf
+\fI\,FORMAT \/\fR[\fI\,ARGUMENT\/\fR]...
+.br
+.B printf
+\fI\,OPTION\/\fR
+.SH DESCRIPTION
+.\" This page is derived from GNU Coreutils documentation.
+This page documents BNU, an independent Bun implementation compatible with
+GNU Coreutils 9.11.
+.PP
+Print ARGUMENT(s) according to FORMAT, or execute according to OPTION:
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/printf#printf--help'\fB\-\-help\fP\X'tty: link'
+display this help and exit
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/printf#printf--version'\fB\-\-version\fP\X'tty: link'
+output version information and exit
+.PP
+FORMAT controls the output as in C printf. Interpreted sequences are:
+.TP
+\e"
+double quote
+.TP
+\e\e
+backslash
+.TP
+\ea
+alert (BEL)
+.TP
+\eb
+backspace
+.TP
+\ec
+produce no further output
+.TP
+\ee
+escape
+.TP
+\ef
+form feed
+.TP
+\en
+new line
+.TP
+\er
+carriage return
+.TP
+\et
+horizontal tab
+.TP
+\ev
+vertical tab
+.TP
+\eNNN
+byte with octal value NNN (1 to 3 digits)
+.TP
+\exHH
+byte with hexadecimal value HH (1 to 2 digits)
+.TP
+\euHHHH
+Unicode (ISO/IEC 10646) character with hex value HHHH (4 digits)
+.TP
+\eUHHHHHHHH
+Unicode character with hex value HHHHHHHH (8 digits)
+.TP
+%%
+a single %
+.TP
+%b
+ARGUMENT as a string with '\e' escapes interpreted,
+except that octal escapes should have a leading 0 like \e0NNN
+.TP
+%q
+ARGUMENT is printed in a format that can be reused as shell input,
+escaping non\-printable characters with the POSIX $'' syntax
+.PP
+and all C format specifications ending with one of diouxXfeEgGcs, with
+ARGUMENTs converted to proper type first. Variable widths are handled.
+.PP
+Your shell may have its own version of printf, which usually supersedes
+the version described here. Please refer to your shell's documentation
+for details about the options it supports.
+.SH AUTHORS
+Upstream GNU Coreutils documentation authors:
+Written by David MacKenzie.
+.br
+Adapted for BNU; the BNU implementation is independent.
+.SH "REPORTING BUGS"
+Report BNU bugs at <https://github.com/Soccera1/bnu/issues>.
+.br
+For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>.
+.SH COPYRIGHT
+Copyright \(co 2026 Free Software Foundation, Inc.
+.br
+This manual page was adapted for BNU in 2026.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+\fBprintf\fP(3)
+.PP
+.br
+Upstream documentation <https://www.gnu.org/software/coreutils/printf>
+.br
+BNU documentation is available locally via: info \(aq(bnu) printf invocation\(aq