aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2019-05-05 18:35:44 +0200
committerDavid Robillard <d@drobilla.net>2020-06-21 18:12:04 +0200
commitb370b0b7ca8d915a10e3c2b1ef7a05a5c98e7918 (patch)
treeab4eaaa26fa142abbfe334a88997b799e0cdce4c
parent2d60bcc7dc13f14b41e8a17e7ce617710d55da1c (diff)
downloadserd-b370b0b7ca8d915a10e3c2b1ef7a05a5c98e7918.tar.gz
serd-b370b0b7ca8d915a10e3c2b1ef7a05a5c98e7918.tar.bz2
serd-b370b0b7ca8d915a10e3c2b1ef7a05a5c98e7918.zip
Use one sentence per line in man page
This apparently lets troff do line wrapping better in some scenarios, and is the best practice for text in revision control anyway.
-rw-r--r--doc/serdi.124
1 files changed, 11 insertions, 13 deletions
diff --git a/doc/serdi.1 b/doc/serdi.1
index b9e6696a..d035338b 100644
--- a/doc/serdi.1
+++ b/doc/serdi.1
@@ -33,18 +33,15 @@ Chop \fIPREFIX\fR from matching blank node IDs.
.TP
.BR \-e
-Eat input one character at a time, rather than a page at a time which is the
-default. This is useful when reading from a pipe since output will be
-generated immediately as input arrives, rather than waiting until an entire
-page of input has arrived. With this option serdi uses one page less memory,
-but will likely be significantly slower.
+Eat input one character at a time, rather than a page at a time which is the default.
+This is useful when reading from a pipe since output will be generated immediately as input arrives, rather than waiting until an entire page of input has arrived.
+With this option serdi uses one page less memory, but will likely be significantly slower.
.TP
.BR \-f
-Fast serialisation without object inlining. This affects only model
-(non-streaming) serialisation, and disables searching and statement reordering
-for pretty printing. Statements will be written in simple sorted order, which
-is faster, but may result in less readable output in Turtle or TriG.
+Fast serialisation without object inlining.
+This affects only model (non-streaming) serialisation, and disables searching and statement reordering for pretty printing.
+Statements will be written in simple sorted order, which is faster, but may result in less readable output in Turtle or TriG.
.TP
.BR \-h
@@ -65,14 +62,15 @@ Lax (non-strict) parsing.
.TP
.BR \-m
-Build and serialise a model. This loads the complete input data into memory
-before writing the output. This will normalize statement order, at the cost of
-performance and memory consumption.
+Build and serialise a model.
+This loads the complete input data into memory before writing the output.
+This will normalize statement order, at the cost of performance and memory consumption.
.TP
.BR \-o " " \fISYNTAX\fR
Write output as \fISYNTAX\fR.
-Valid values (case-insensitive): \*(lqturtle\*(rq, \*(lqntriples\*(rq, \*(lqtrig\*(rq, \*(lqnquads\*(rq, , \*(lqempty\*(rq. When \*(lqempty\*(rq is given, output is suppressed, so only errors will be printed.
+Valid values (case-insensitive): \*(lqturtle\*(rq, \*(lqntriples\*(rq, \*(lqtrig\*(rq, \*(lqnquads\*(rq, , \*(lqempty\*(rq.
+When \*(lqempty\*(rq is given, output is suppressed, so only errors will be printed.
.TP
.BR \-p " " \fIPREFIX\fR