diff options
author | David Robillard <d@drobilla.net> | 2021-04-11 22:07:39 -0400 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2022-01-14 19:37:51 -0500 |
commit | e9b773bf452f0df0ea69e363bcb5899fea124b28 (patch) | |
tree | 6cec0e4c4d93e2fbb56576fc6992169bd985fd52 /doc | |
parent | 37b14ad8b07f7e8d647e15a05339d31f2ee4dd58 (diff) | |
download | serd-e9b773bf452f0df0ea69e363bcb5899fea124b28.tar.gz serd-e9b773bf452f0df0ea69e363bcb5899fea124b28.tar.bz2 serd-e9b773bf452f0df0ea69e363bcb5899fea124b28.zip |
Add model
Diffstat (limited to 'doc')
-rw-r--r-- | doc/conf.py.in | 4 | ||||
-rw-r--r-- | doc/serdi.1 | 22 |
2 files changed, 19 insertions, 7 deletions
diff --git a/doc/conf.py.in b/doc/conf.py.in index 5fdf1220..059f096f 100644 --- a/doc/conf.py.in +++ b/doc/conf.py.in @@ -14,6 +14,7 @@ pygments_style = "friendly" try: import sphinx_lv2_theme + have_lv2_theme = True except ModuleNotFoundError: have_lv2_theme = False @@ -24,6 +25,7 @@ _opaque = [ "SerdByteSinkImpl", "SerdByteSourceImpl", "SerdCaretImpl", + "SerdCursorImpl", "SerdEnvImpl", "SerdIterImpl", "SerdModelImpl", @@ -55,7 +57,7 @@ html_theme = "sphinx_lv2_theme" if have_lv2_theme: html_theme = "sphinx_lv2_theme" - if tags.has('singlehtml'): + if tags.has("singlehtml"): html_sidebars = { "**": [ "globaltoc.html", 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 . |