Replace serdi -b and -e options with a block size option

This is more powerful, and reduces the number of command line options that
almost nobody needs to care about.

1 files changed, 7 insertions, 9 deletions

diff --git a/doc/serdi.1 b/doc/serdi.1
index 2a110785..99652738 100644
--- a/doc/serdi.1
+++ b/doc/serdi.1
@@ -6,9 +6,10 @@
 .Nd read, filter, transform, and write RDF data
 .Sh SYNOPSIS
 .Nm serdi
-.Op Fl Cabefhlmqtvx
+.Op Fl Cafhlmqtvx
 .Op Fl F Ar pattern | Fl G Ar pattern
 .Op Fl I Ar base
+.Op Fl b Ar bytes
 .Op Fl c Ar prefix
 .Op Fl i Ar syntax
 .Op Fl k Ar bytes
@@ -77,9 +78,11 @@ or to provide a base URI for input from stdin or a string.
 Write ASCII output.
 If this is enabled, all non-ASCII characters will be escaped, even if the output syntax allows them to be written in UTF-8.
 .Pp
-.It Fl b
-Bulk output writing.
-If this is enabled, output will be written a page at a time, rather than a byte at a time.
+.It Fl b Ar bytes
+I/O block size.
+This is the number of bytes in a file that will be read or written at once.
+The default is 4096, which should perform well in most cases.
+Note that this only applies to files, standard input and output are always processed one byte at a time.
 .Pp
 .It Fl c Ar prefix
 Chop
@@ -88,11 +91,6 @@ from matching blank node IDs.
 This is the inverse of
 .Fl p .
 .Pp
-.It Fl 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.
-.Pp
 .It Fl f
 Fast and loose mode.
 This disables shortening URIs into prefixed names or relative URI references.