diff options
| author | David Robillard <d@drobilla.net> | 2021-08-12 13:23:59 -0400 |
|---|---|---|
| committer | David Robillard <d@drobilla.net> | 2023-12-02 18:49:08 -0500 |
| commit | 3ea3143632e3577ac5794faed1141e460a11a9fb (patch) | |
| tree | fbcf61902714cc54e99fe5c0acdd90fa46e4967e /doc | |
| parent | fa4c14acdeeabaf7aee0304a57ae7878ecea1776 (diff) | |
| download | serd-3ea3143632e3577ac5794faed1141e460a11a9fb.tar.gz serd-3ea3143632e3577ac5794faed1141e460a11a9fb.tar.bz2 serd-3ea3143632e3577ac5794faed1141e460a11a9fb.zip | |
Split SERD_READ_VERBATIM into two more precise flags
Although the "verbatim" idea is nice and simple, more fine-grained control is
necessary since these features (relative URI preservation and blank node label
clash avoidance) are useful in different situations.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/man/serd-pipe.1 | 24 |
1 files changed, 16 insertions, 8 deletions
diff --git a/doc/man/serd-pipe.1 b/doc/man/serd-pipe.1 index a986c570..056d236f 100644 --- a/doc/man/serd-pipe.1 +++ b/doc/man/serd-pipe.1 @@ -103,14 +103,11 @@ Variables can be written in SPARQL style, for example .Li ?var or .Li $var . -.It Cm verbatim -Normally, the reader expands all relative URIs, -and may adjust blank node labels to avoid clashing with generated ones. -This flag disables all of this processing, -so that URI references and blank nodes are passed to the sink exactly as they are in the input. -Note that this does not apply to CURIEs, since serd deliberately does not -have a way to represent CURIE nodes. -A bad namespace prefix is considered a syntax error. +.It Cm relative +Read relative URI references exactly without resolving them. +Normally, all relative URIs are expanded against the base URI when reading. +This flag disables that, +so URI references will be passed through exactly as they are in the input. .It Cm generated Read seemingly generated blank node labels exactly without adjusting them. Normally, blank node labels like @@ -119,6 +116,17 @@ are adapted to avoid potential clashes with generated ones. This flag disables that, so such labels will be passed through exactly as they are in the input. Note that this may corrupt the output by merging distinct blank nodes. +.It Cm global +Assume a clean global namespace for blank node labels, +and do not automatically add prefixes. +Normally, +a prefix like +.Li f1 +is added to blank node labels when reading multiple files, +to prevent labels in different files from clashing. +This option disables that, +so blank node labels will be passed through without any added prefix. +Note that this may corrupt the output by merging distinct blank nodes. .El .It Fl O Ar syntax Set an output syntax or option. |