diff options
author | David Robillard <d@drobilla.net> | 2022-11-28 13:46:05 -0500 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2022-11-28 13:46:05 -0500 |
commit | 79ba155516166b8b7be14ab30c22f6f6d93b550f (patch) | |
tree | 00412fc8f808f1305452a3714d9106a1cc55643d /doc/serdi.1 | |
parent | 445a56f6d576f1d5bd3f61fd5e722722b563ee74 (diff) | |
download | serd-79ba155516166b8b7be14ab30c22f6f6d93b550f.tar.gz serd-79ba155516166b8b7be14ab30c22f6f6d93b550f.tar.bz2 serd-79ba155516166b8b7be14ab30c22f6f6d93b550f.zip |
Improve serdi man page
Diffstat (limited to 'doc/serdi.1')
-rw-r--r-- | doc/serdi.1 | 39 |
1 files changed, 37 insertions, 2 deletions
diff --git a/doc/serdi.1 b/doc/serdi.1 index 88546884..48b1a5d4 100644 --- a/doc/serdi.1 +++ b/doc/serdi.1 @@ -47,8 +47,15 @@ If this is enabled, output will be written a page at a time, rather than a byte Chop .Ar prefix from matching blank node IDs. -This is the inverse of +This is typically used to revert the effects of .Fl p . +For example, with +.Ar prefix +.Dq doc01 , +the blank node +.Li _:doc01b42 +will be emitted as +.Li _:b42 . .Pp .It Fl e Eat input one character at a time, rather than a page at a time which is the default. @@ -89,6 +96,15 @@ Add .Ar prefix to blank node IDs. This can be used to avoid clashes between blank node IDs in input documents. +The effects can be reversed in a later run with +.Fl c . +For example, with +.Ar prefix +.Dq doc01 , +the blank node +.Li _:b42 +will be emitted as +.Li _:doc01b42 . .Pp .It Fl q Suppress all output except data. @@ -98,10 +114,29 @@ Keep relative URIs within a .Ar root URI. This will avoid creating any relative URI references with leading path segments like -.Dq ../ +.Pa ../ that enter a parent of .Ar root . .Pp +For example, +if +.Pa /home/you/file.ttl +is written to the file +.Pa /home/me/output.ttl +using the destination's base URI, +then it could be written as +.Li <../you/file.ttl> . +Setting +.Fl r Li file:///home/me/ +would prevent references from +.Dq escaping +like this, +so the above would instead be written as +.Li <file:///home/you/file.ttl> , +since it can't be expressed relative to the root URI. +.Pp +This is useful for keeping relative references within some directory. +.Pp .It Fl s Ar string Parse .Ar string |