blind

commit 0f189ac84817338ce8ec1572244d1aa680a232f8
parent e7d073bf6fa91c43753ab67644d067e2ce5881a7
Author: Mattias Andrée <maandree@kth.se>
Date:   Sat, 13 May 2017 14:39:40 +0200

Add man pages for blind-{to,from}-portable and make -s the default (and invert it's meaning)

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

Diffstat:
M
README
 | 
6
++++++
A
man/blind-from-portable.1
 | 
21
+++++++++++++++++++++
M
man/blind-from-text.1
 | 
3
++-
A
man/blind-to-portable.1
 | 
31
+++++++++++++++++++++++++++++++
M
man/blind-to-text.1
 | 
3
++-
M
man/blind.7
 | 
6
++++++
M
src/blind-from-portable.c
 | 
4
++--
M
src/blind-to-portable.c
 | 
4
++--

8 files changed, 72 insertions(+), 6 deletions(-)
diff --git a/README b/README
@@ -48,6 +48,9 @@ UTILITIES
        blind-from-image(1)
               Convert an image to a frame
 
+       blind-from-portable(1)
+              Convert a video from a portable format to a processable format
+
        blind-from-text(1)
               Convert text to a video
 
@@ -111,6 +114,9 @@ UTILITIES
        blind-to-image(1)
               Convert a frame to an image
 
+       blind-to-portable(1)
+              Convert a video to a portable format
+
        blind-to-text(1)
               Convert a video to text
 
diff --git a/man/blind-from-portable.1 b/man/blind-from-portable.1
@@ -0,0 +1,21 @@
+.TH BLIND-FROM-PORTABLE 1 blind
+.SH NAME
+blind-from-portable - Convert a video from a portable format to a processable format
+.SH SYNOPSIS
+.B blind-from-portable
+[-s]
+.SH DESCRIPTION
+.B blind-from-portable
+converts a video from a portable format to a processable format.
+.SH OPTIONS
+.B -s
+Do not convert single-precision floating-points number
+from binary32, and double-precision floating-points number
+from binary64, to local encoding.
+.SH SEE ALSO
+.BR blind (7),
+.BR blind-to-portable (1),
+.BR blind-from-text (1)
+.SH AUTHORS
+Mattias Andrée
+.RI < maandree@kth.se >
diff --git a/man/blind-from-text.1 b/man/blind-from-text.1
@@ -14,7 +14,8 @@ with any whitespace, except on the first line,
 which represents the head.
 .SH SEE ALSO
 .BR blind (7),
-.BR blind-to-text (1)
+.BR blind-to-text (1),
+.BR blind-from-portable (1)
 .SH AUTHORS
 Mattias Andrée
 .RI < maandree@kth.se >
diff --git a/man/blind-to-portable.1 b/man/blind-to-portable.1
@@ -0,0 +1,31 @@
+.TH BLIND-TO-PORTABLE 1 blind
+.SH NAME
+blind-to-portable - Convert a video to a portable format
+.SH SYNOPSIS
+.B blind-to-portable
+[-s]
+.SH DESCRIPTION
+.B blind-to-portable
+converts a processable video into a portable format, so
+it can be sent to a computer with a different endianness
+or floating-point number encoding, and processes only
+multiple machines.
+.SH OPTIONS
+.B -s
+Do not convert single-precision floating-points number
+to binary32, and double-precision floating-points number
+to binary64.
+.SH NOTES
+The endian is changed to little endian.
+.SH RATIONALE
+Most computers use binary32 and binary64 for
+single-precision and double-precision floating-points
+number, respectively, however, this is not always the
+case for microcontrollers designed for embedded systems.
+.SH SEE ALSO
+.BR blind (7),
+.BR blind-from-portable (1),
+.BR blind-to-text (1)
+.SH AUTHORS
+Mattias Andrée
+.RI < maandree@kth.se >
diff --git a/man/blind-to-text.1 b/man/blind-to-text.1
@@ -38,7 +38,8 @@ from left to right, from top to bottom,
 and from first frame to last frame.
 .SH SEE ALSO
 .BR blind (7),
-.BR blind-from-text (1)
+.BR blind-from-text (1),
+.BR blind-to-portable (1)
 .SH AUTHORS
 Mattias Andrée
 .RI < maandree@kth.se >
diff --git a/man/blind.7 b/man/blind.7
@@ -61,6 +61,9 @@ Mirror a video horizontally
 .BR blind-from-image (1)
 Convert an image to a frame
 .TP
+.BR blind-from-portable (1)
+Convert a video from a portable format to a processable format
+.TP
 .BR blind-from-text (1)
 Convert text to a video
 .TP
@@ -124,6 +127,9 @@ Draw new frames on top of old frames with partial alpha
 .BR blind-to-image (1)
 Convert a frame to an image
 .TP
+.BR blind-to-portable (1)
+Convert a video to a portable format
+.TP
 .BR blind-to-text (1)
 Convert a video to text
 .TP
diff --git a/src/blind-from-portable.c b/src/blind-from-portable.c
@@ -88,12 +88,12 @@ int
 main(int argc, char *argv[])
 {
 	struct stream stream;
-	int strict = 0;
+	int strict = 1;
 	void (*process)(struct stream *stream, int strict);
 
 	ARGBEGIN {
 	case 's':
-		strict = 1;
+		strict = 0;
 		break;
 	default:
 		usage();
diff --git a/src/blind-to-portable.c b/src/blind-to-portable.c
@@ -99,12 +99,12 @@ int
 main(int argc, char *argv[])
 {
 	struct stream stream;
-	int strict = 0;
+	int strict = 1;
 	void (*process)(struct stream *stream, int strict);
 
 	ARGBEGIN {
 	case 's':
-		strict = 1;
+		strict = 0;
 		break;
 	default:
 		usage();