From 5aa146e1ce58d295b5f45446bbbbdbb30c8e557d Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sun, 8 Aug 2021 14:24:59 -0400 Subject: 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. --- doc/serdi.1 | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) (limited to 'doc') 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. -- cgit v1.2.1