Add -% to blind-to-text, blind-colour-srgb, and blind-colour-ciexyz

Signed-off-by: Mattias Andrée <maandree@kth.se>

3 files changed, 108 insertions, 0 deletions

diff --git a/man/blind-colour-ciexyz.1 b/man/blind-colour-ciexyz.1
index ad1d8ef..01a9625 100644
--- a/man/blind-colour-ciexyz.1
+++ b/man/blind-colour-ciexyz.1
@@ -3,6 +3,8 @@
 blind-colour-ciexyz - Convert CIE XYZ for use with blind-single-colour(1)
 .SH SYNOPSIS
 .B blind-colour-ciexyz
+[-%
+.IR format ]
 .RI ( X
 .I Y
 .I Z
@@ -21,6 +23,42 @@ that colour model. If only
 is specified, the colour will be CIE Standard Illuminant D65-grey
 with a luminosity of
 .IR Y .
+.SH OPTIONS
+.TP
+.BR -% \ \fIformat\fP
+Selects in what format parameters are printed.
+.I format
+may include the prefix
+.B +
+that specified that non-negative values should be prefixed with a
+.BR + .
+After any prefix, there may be a positive number specifying
+the percision of the output, optionally followed by either of
+the letters
+.BR a ,
+.BR e ,
+.BR f ,
+other
+.B g
+(other their synonymous uppercases),
+at most once, with the same semantics as in
+.BR printf (3).
+.B f
+is used if this letter is omitted.
+
+If ommited,
+.B 25f
+is used unless all three of
+.IR X ,
+.IR Y ,
+and
+.I Z
+is specified, in which case the parameters are
+printed as-is. This default is selected for ease
+of interoperability with other software, however,
+.B a
+is recommeded to improve performance and remove
+truncation error.
 .SH SEE ALSO
 .BR blind (7),
 .BR blind-single-colour (1),
diff --git a/man/blind-colour-srgb.1 b/man/blind-colour-srgb.1
index c9b97fe..4934efa 100644
--- a/man/blind-colour-srgb.1
+++ b/man/blind-colour-srgb.1
@@ -3,6 +3,8 @@
 blind-colour-srgb - Convert sRGB for use with blind-single-colour(1) and blind-colour-matrix(1)
 .SH SYNOPSIS
 .B blind-colour-srgb
+[-%
+.IR format ]
 [-d
 .IR depth ]
 [-l]
@@ -38,6 +40,35 @@ unsigned integer with
 bits.
 .SH OPTIONS
 .TP
+.BR -% \ \fIformat\fP
+Selects in what format parameters are printed.
+.I format
+may include the prefix
+.B +
+that specified that non-negative values should be prefixed with a
+.BR + .
+After any prefix, there may be a positive number specifying
+the percision of the output, optionally followed by either of
+the letters
+.BR a ,
+.BR e ,
+.BR f ,
+other
+.B g
+(other their synonymous uppercases),
+at most once, with the same semantics as in
+.BR printf (3).
+.B f
+is used if this letter is omitted.
+
+If ommited,
+.B 25f
+is used. This default is selected for ease of
+interoperability with other software, however,
+.B a
+is recommeded to improve performance and remove
+truncation error.
+.TP
 .BR -d " "\fIdepth\fP
 If all three parameters are
 .RI 2^ depth -1,
diff --git a/man/blind-to-text.1 b/man/blind-to-text.1
index 4fe9b46..fdfa4f3 100644
--- a/man/blind-to-text.1
+++ b/man/blind-to-text.1
@@ -3,6 +3,8 @@
 blind-to-text - Convert a video to text
 .SH SYNOPSIS
 .B blind-to-text
+[-%
+.IR format ]
 .SH DESCRIPTION
 .B blind-to-text
 reads a video from stdin and prints it
@@ -36,6 +38,43 @@ line, after the head, where the second
 frame begins. The pixels are printed
 from left to right, from top to bottom,
 and from first frame to last frame.
+.SH OPTIONS
+.TP
+.BR -% \ \fIformat\fP
+Selects in what format parameters are printed.
+.I format
+may include the prefix
+.B +
+that specified that non-negative values should be prefixed with a
+.BR + .
+After any prefix, there may be a positive number specifying
+the percision of the output, optionally followed by either of
+the letters
+.BR a ,
+.BR e ,
+.BR f ,
+other
+.B g
+(other their synonymous uppercases),
+or if the input is integer typed,
+.B d
+or
+.BR i ,
+at most once, with the same semantics as in
+.BR printf (3).
+.B f
+is used if this letter is omitted.
+The percision must be omitted the input is integer typed.
+
+If ommited,
+.B 25f
+or
+.B i
+is used. These defaults are selected for ease of
+interoperability with other software, however,
+.B a
+is recommeded to improve performance and remove
+truncation error.
 .SH SEE ALSO
 .BR blind (7),
 .BR blind-from-text (1),