.\"                                      Hey, EMACS: -*- nroff -*-
.\"
.\" rapper.1 - Raptor RDF parser utility manual page
.\"
.\" $Id$
.\"
.\" Copyright (C) 2002-2004 David Beckett - http://purl.org/net/dajobe/
.\" Institute for Learning and Research Technology - http://www.ilrt.bris.ac.uk/
.\" University of Bristol - http://www.bristol.ac.uk/
.\"
.TH rapper 1 "2004-04-10"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
rapper \- Raptor RDF parser utility
.SH SYNOPSIS
.B rapper
.RB [ OPTIONS ]
.IR "<source-URI>"
.IR "[base-URI]"
.SH EXAMPLE
.nf
.B rapper -o ntriples http://www.ilrt.bris.ac.uk/discovery/rdf/resources/rss.rdf
.br
.B rapper -i rss-tag-soup pile-of-rss.xml http://example.org/base/
.br
.B rapper --count http://example.org/index.rdf
.br
.SH DESCRIPTION
The
.B rapper
utility allows parsing of RDF content by the
.B Raptor
RDF parser toolkit emitting the results as RDF triples in
a choice of syntaxes.  The \fIsource-URI\fR can be a file name or if
Raptor is built with a WWW retrieval library, a general URI.
The optional \fIbase-URI\fR is used as the document URI if present.
.SH OPTIONS
rapper uses the usual GNU command line syntax, with long
options starting with two dashes (`-') if supported by the
getopt_long function.  Otherwise the short options are only available.
.TP
.B \-h, \-\-help
Show a summary of the options.
.TP
.B \-i, \-\-input FORMAT
Set the input
.I FORMAT
to one of 'rdfxml' (RDF/XML, default), 'ntriples'
(N-Triples, see below), 'turtle' (Turtle, see below)
or 'rss-tag-soup' (RSS tag soup).  The list of
parsers depends on how libraptor(3) was built.  The list of
supported parsers is given in the help summary given by \-h.
.UE
.TP
.B \-o, \-\-output FORMAT
Set the output
.I FORMAT
to 'simple' (default) or 'ntriples' (N-Triples, see below)
.TP
.B \-c, \-\-count
Only count the triples and produce no other output.
.TP
.B \-e, \-\-ignore-errors
Ignore errors, do not emit the messages and try to continue parsing.
.TP
.B \-f, \-\-feature FEATURE[=VALUE]
Set a parser feature
.I FEATURE
to a value, or to 1 if
.I VALUE
is omitted,
Use \-f help to get a list of valid parser features.
.TP
.B \-g, \-\-guess
Guess the parser to use from the source-URI rather than use
the \-i FORMAT.
.TP
.B \-q, \-\-quiet
No extra information messages.
.TP
.B \-r, \-\-replace-newlines
Replace newlines in multi-line literals with spaces.
.TP
.B \-s, \-\-scan
Scan for <rdf:RDF> element in the RDF/XML source content..
.TP
.B \-w, \-\-ignore-warnings
Ignore warnings, do not emit the messages.
.TP
.B \-v, \-\-version
Print the raptor version and exit.
.SH "CONFORMING TO"
\fIRDF/XML Syntax (Revised)\fR,
W3C Recommendation,
.UR http://www.w3.org/TR/rdf-syntax-grammar/
http://www.w3.org/TR/rdf-syntax-grammar/
.UE

\fIN-Triples\fR, in \fIRDF Test Cases\fR, Jan Grant and Dave Beckett (eds.)
W3C Recommendation,
.UR http://www.w3.org/TR/rdf-testcases/#ntriples
http://www.w3.org/TR/rdf-testcases/#ntriples
.UE

\fITurtle Terse RDF Triple Language\fR, Dave Beckett,
.UR http://www.ilrt.bristol.ac.uk/discovery/2004/01/turtle/
http://www.ilrt.bristol.ac.uk/discovery/2004/01/turtle/
.UE
.SH SEE ALSO
.BR libraptor(3), raptor-config(1)
.SH CHANGES
.SS 1.3.0
Added \-f for features.
.br
Added \-g for guessing the parser to use.
.SS 1.1.0
Removed \-a, \-\-assume since rdf:RDF is now always optional.
.br
.SH AUTHOR
Dave Beckett - 
.UR http://purl.org/net/dajobe/
http://purl.org/net/dajobe/
.UE
.br
.UR
Institute for Learning and Research Technology (ILRT)
http://www.ilrt.bristol.ac.uk/
.UE
.br
.UR
University of Bristol
http://www.bristol.ac.uk/
.UE