diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/man/serd-pipe.1 | 98 |
1 files changed, 58 insertions, 40 deletions
diff --git a/doc/man/serd-pipe.1 b/doc/man/serd-pipe.1 index b1e01990..4d475985 100644 --- a/doc/man/serd-pipe.1 +++ b/doc/man/serd-pipe.1 @@ -8,15 +8,15 @@ .Nd read and write RDF data .Sh SYNOPSIS .Nm serd-pipe -.Op Fl Cfhqv +.Op Fl CVhq .Op Fl B Ar base .Op Fl I Ar syntax .Op Fl O Ar syntax +.Op Fl R Ar root .Op Fl b Ar bytes .Op Fl k Ar bytes -.Op Fl r Ar root +.Op Fl o Ar filename .Op Fl s Ar string -.Op Fl w Ar filename .Op Ar input ... .Sh DESCRIPTION .Nm @@ -60,12 +60,34 @@ then input is read as TriG and output is written as NQuads The options are as follows: .Bl -tag -width 3n .It Fl B Ar base -Input base URI. -Relative URI references in the input will be resolved against this. -When the input is a file, -the URI of the file is automatically used as the base URI. -This option can be used to override that, -or to provide a base URI for input from stdin or a string. +Base URI, path, or +.Cm rebase +to use the output path. +This is used to resolve relative URI references in the input. +.Pp +If the input is a file, +its path is used by default, +so relative paths are written as they are in the input. +The special +.Cm rebase +argument will instead use the output path set by the +.Fl o +option, +so paths are written relative to the output file. +.Pp +The distinction matters when reading from bundles of files that refer to each other. +For example, +when copying +.Pa in/manifest.ttl +to +.Pa out/manifest.ttl , +the relative URI reference +.Ql <data.ttl> +will be written as +.Ql <../in/data.ttl> +when using +.Fl o +.Cm rebase . .It Fl C Convert literals to canonical form. Literals with supported XSD datatypes will be parsed and rewritten canonically. @@ -155,26 +177,7 @@ The .Cm empty syntax suppresses the output, so that only warnings and errors will be printed. -.It Fl b Ar bytes -I/O block size. -This is the number of bytes in a file that will be read or written at once. -The default is 4096, which should perform well in most cases. -Note that this only applies to files, standard input and output are always processed one byte at a time. -.It Fl f -Fast and loose URI mode: -preserve full URIs (without qualifying or making relative), -and pass prefixed names through as-is. -.It Fl h -Print the command line options. -.It Fl k Ar bytes -Parser stack size. -Parsing is performed using a pre-allocated stack for performance and security reasons. -By default, the stack is 1 MiB, which should be sufficient for most data. -This can be increased to support unusually structured data and huge literals, -or decreased to reduce overall memory requirements and reduce startup time. -.It Fl q -Suppress all output except data. -.It Fl r Ar root +.It Fl R Ar root Keep relative URIs within a .Ar root URI. @@ -188,29 +191,44 @@ 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 +using +.Fl B Cm rebase , +then it will be written as .Li <../you/file.ttl> . Setting -.Fl r Li file:///home/me/ +.Fl R Pa /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. +.Li <file:///home/you/file.ttl> . .Pp This is useful for keeping relative references within some directory. -.It Fl s Ar string -Parse -.Ar string -as input. -.It Fl v +.It Fl V Display version information and exit. -.It Fl w Ar filename +.It Fl b Ar bytes +I/O block size. +This is the number of bytes in a file that will be read or written at once. +The default is 4096, which should perform well in most cases. +Note that this only applies to files, standard input and output are always processed one byte at a time. +.It Fl h +Print the command line options. +.It Fl k Ar bytes +Parser stack size. +Parsing is performed using a pre-allocated stack for performance and security reasons. +By default, the stack is 1 MiB, which should be sufficient for most data. +This can be increased to support unusually structured data and huge literals, +or decreased to reduce overall memory requirements and reduce startup time. +.It Fl o Ar filename Write output to the given .Ar filename instead of stdout. +.It Fl q +Suppress all output except data. +.It Fl s Ar string +Parse +.Ar string +as input. .El .Sh ENVIRONMENT Errors and warnings are printed in color by default if the output is a terminal. |