From e9b773bf452f0df0ea69e363bcb5899fea124b28 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sun, 11 Apr 2021 22:07:39 -0400 Subject: Add model --- doc/serdi.1 | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) (limited to 'doc/serdi.1') diff --git a/doc/serdi.1 b/doc/serdi.1 index 495c3940..e9d70857 100644 --- a/doc/serdi.1 +++ b/doc/serdi.1 @@ -1,12 +1,12 @@ -.Dd March 6, 2021 +.Dd April 14, 2021 .Dt SERDI 1 .Os Serd 0.30.11 .Sh NAME .Nm serdi -.Nd read and write RDF syntax +.Nd read, transform, and write RDF data .Sh SYNOPSIS .Nm serdi -.Op Fl abefhlqtvx +.Op Fl abefhlmqtvx .Op Fl I Ar base .Op Fl c Ar prefix .Op Fl i Ar syntax @@ -19,8 +19,8 @@ .Ar input ... .Sh DESCRIPTION .Nm -is a fast command-line utility for streaming and processing RDF data. -It reads one or more RDF documents and writes the data again, +is a fast command-line utility for processing RDF data. +It reads one or more documents and writes the data again, possibly transformed and/or in a different syntax. By default, the input syntax is guessed from the file extension, @@ -64,7 +64,11 @@ This is useful when reading from a pipe since output will be generated immediate With this option serdi uses one page less memory, but will likely be significantly slower. .Pp .It Fl f -Keep full URIs in input (don't qualify with namespace prefixes or make URIs relative). +Fast and loose mode. +This disables shortening URIs into prefixed names or relative URI references. +If the model is enabled, then this writes the model quickly in sorted order. +Note that doing so with TriG or Turtle may make the output ugly, +since blank nodes will not be inlined. .Pp .It Fl h Print the command line options. @@ -92,6 +96,12 @@ Lax (non-strict) parsing. If this is enabled, recoverable syntax errors will print a warning, but parsing will proceed starting at the next statement if possible. Note that data may be lost when using this option. .Pp +.It Fl m +Build a model in memory. +This loads all of the input into memory before writing the output. +This will reorder statements and eliminate duplicates, at the cost of performance and memory consumption. +When writing TriG or Turtle, this may enable better pretty-printing with more inline descriptions. +.Pp .It Fl o Ar syntax Write output as .Ar syntax . -- cgit v1.2.1