manuals, sum-down, radix

1 files changed, 31 insertions, 0 deletions

diff --git a/man/man1/radix.1 b/man/man1/radix.1
new file mode 100644
index 0000000..43d70d4
--- /dev/null
+++ b/man/man1/radix.1
@@ -0,0 +1,31 @@
+.TH pf 1 2023-05-13 utils
+
+.SH NAME
+radix \- compute the digits of a number in a different base
+
+.SH SYNOPSIS
+.B radix
+.I base decimal
+
+.SH DESCRIPTION
+.B radix
+is an easy and convenient way to convert decimal numbers
+into many other bases, like octal, dozenal, or hexadecimal.
+
+It is implemented in
+.BR bc (1),
+which puts a system dependent limit on the bases.
+It also only accepts integer bases.
+.B radix
+itself has a limit of base 36, using Latin letters for digits greater than or equal to ten.
+
+For base 12 it uses the glyphs suggested by the British Dozenal Society which are acutally part of
+.BR unicode (7).
+(The American Dozenal Society suggests using homoglyphs of X and E for ten and eleven, respectively, instead.)
+
+.SH EXAMPLES
+.B radix
+.I 12 144
+
+.SH SEE ALSO
+.BR bc (1)