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, 9 insertions, 1 deletions

diff --git a/doc/serd-pipe.1 b/doc/serd-pipe.1
index c7f77c9e..28f1373d 100644
--- a/doc/serd-pipe.1
+++ b/doc/serd-pipe.1
@@ -170,7 +170,7 @@ can be
 .Cm Turtle ,
 or one of the following options:
 .Pp
-.Bl -tag -width "QverbatimQ" -compact -offset indent
+.Bl -tag -width "QcontextualQ" -compact -offset indent
 .It Cm ascii
 Escape all non-ASCII characters.
 Normally, text is written in UTF-8.
@@ -178,6 +178,14 @@ This flag will escape non-ASCII characters in text as Unicode code points like
 .Li \eU00B7 or
 .Li \eU0001F600 .
 .Pp
+.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.
+.Pp
 .It Cm expanded
 Write expanded URIs instead of prefixed names.
 .Pp