aboutsummaryrefslogtreecommitdiffstats
path: root/doc/serdi.1
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2021-04-11 22:07:39 -0400
committerDavid Robillard <d@drobilla.net>2022-01-14 19:37:51 -0500
commite9b773bf452f0df0ea69e363bcb5899fea124b28 (patch)
tree6cec0e4c4d93e2fbb56576fc6992169bd985fd52 /doc/serdi.1
parent37b14ad8b07f7e8d647e15a05339d31f2ee4dd58 (diff)
downloadserd-e9b773bf452f0df0ea69e363bcb5899fea124b28.tar.gz
serd-e9b773bf452f0df0ea69e363bcb5899fea124b28.tar.bz2
serd-e9b773bf452f0df0ea69e363bcb5899fea124b28.zip
Add model
Diffstat (limited to 'doc/serdi.1')
-rw-r--r--doc/serdi.122
1 files changed, 16 insertions, 6 deletions
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 .