Add "contextual" output option

This is mainly for developer or power-user cases, where one wants to look at
some data for investigation or debugging.  In such cases, it's common for the
set of prefixes to be implicitly known (because they are baked in to the
application, for example), so printing them just produces a large amount of
redundant noise.

That said, it can also be useful programmatically, because it allows several
snippets to be written independently and ultimately concatenated (with a header
to define the prefixes) without redundancy.

1 files changed, 7 insertions, 0 deletions

diff --git a/doc/man/serd-pipe.1 b/doc/man/serd-pipe.1
index a5dbd328..54e3a3b1 100644
--- a/doc/man/serd-pipe.1
+++ b/doc/man/serd-pipe.1
@@ -168,6 +168,13 @@ or an option:
 .Bl -tag -width 3n
 .It Cm ascii
 Escape all non-ASCII characters.
+.It Cm contextual
+Suppress writing directives that describe the context.
+Normally when writing Turtle or Trig,
+a document will have a header that defines all the prefixes used in the input.
+This flag will disable writing those directives,
+so the output is document fragment with an implicit context.
+This can be useful for writing output intended for humans.
 .It Cm expanded
 Write expanded URIs instead of prefixed names.
 .It Cm lax