Raptor RDF Syntax Library - Building and Installing from Source

From dc563890e25c6bc0e49da846e0a1ad54c3e25caf Mon Sep 17 00:00:00 2001 From: Dave Beckett Date: Tue, 28 Feb 2023 19:55:08 -0800 Subject: https and 2023 --- INSTALL.html | 36 ++++++++--------- LICENSE.html | 22 +++++----- NEWS.html | 96 ++++++++++++++++++++++---------------------- README.html | 72 +++++++++++++++++---------------- RELEASE.html | 124 ++++++++++++++++++++++++++++----------------------------- TODO.html | 10 +++-- UPGRADING.html | 12 +++--- 7 files changed, 188 insertions(+), 184 deletions(-) diff --git a/INSTALL.html b/INSTALL.html index 31fa35dd..94b1142c 100644 --- a/INSTALL.html +++ b/INSTALL.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library - Building and Installing from Source @@ -31,7 +31,7 @@ documentation provided on the web site. ensures that a tested and working set of files are used.

The released sources are available from -http://download.librdf.org/source/ (master site). +https://download.librdf.org/source/ (master site). Do not use GitHub tagged tarballs, they are not the same thing and are not supported.

@@ -79,9 +79,9 @@ and x86 OSX but is also tested on other systems occasionally.

Libcurl, libxml2 or libfetch for retrieving URIs.

libxslt (requiring libxml2 also) to provide the XSLT functionality for the GRDDL and microformats parser.

YAJL to provide JSON +

YAJL to provide JSON parsers if it is available.

ICU to provide +

ICU to provide Unicode NFC checking only if enabled with --with-icu-config

@@ -93,8 +93,8 @@ section.

If there is no configure program, you can create it using the autogen.sh script, as long as you have the -automake and -autoconf +automake and +autoconf tools. This is done by:

@@ -132,8 +132,8 @@ GIT sources.  autogen.sh enforces the requirements.
 
 
 Raptor also requires specific versions of
-flex and
-GNU Bison
+flex and
+GNU Bison
 to build lexers and parsers.  configure will warn or fail if they
 are missing or the installed versions are too old.
 These are only required when building from GIT.
@@ -213,12 +213,12 @@ The default is to look for this on the PATH.
 
 
--with-curl-config=NAME

 Set the path to the libcurl curl-config program.
+href="https://curl.se/libcurl/">libcurl curl-config program.
 The default is to look for this on the PATH.
 
 
 --with-icu-config=NAME

-Set the path to the ICU
+
Set the path to the ICU
 icu-config program. This will NOT be searched for on the PATH.
 
 
@@ -227,7 +227,7 @@ icu-config program. This will NOT be searched for on the PATH.
 
 
 --with-yajl=DIR|no

-Build against YAJL
+
Build against YAJL
 installed into directory DIR or with 'no', disable looking
 for YAJL.  The default is to search a set of common installation directories
 such /opt/local, /usr/local and /usr.
@@ -307,7 +307,7 @@ a system directory such as /usr.  In that case you may have to do
 for the library.  These are installed into
 PREFIX/share/gtk-doc/html/raptor
 and are also available from the
-Raptor web site.
+Raptor web site.
 
 
 In addition, the examples in the tutorial as well as some other
@@ -335,7 +335,7 @@ sub-directory.  These can be compiled with:
 
 
 -  rapper http://librdf.org/raptor/raptor.rdf
+  rapper https://librdf.org/raptor/raptor.rdf
 
 
 Raptor can also extract RDF content inside general XML when the
@@ -348,7 +348,7 @@ RDF/XML is embedded inside some SVG, it could be extracted with:

You can also run it on other syntaxes such as -N-Triples +N-Triples files with the -i option like this:

@@ -358,7 +358,7 @@ files with the -i option like this:

The default output is a simple statement dump format, but it can be changed to write -N-Triples +N-Triples by using the -o option, like this:

@@ -369,13 +369,13 @@ by using the -o option, like this:

See the rapper manual page for full details using 'man rapper' or read the HTML version in docs/rapper.html or on the -Raptor website. +Raptor website.

diff --git a/LICENSE.html b/LICENSE.html index 3d000a1a..4eb80c90 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library - License @@ -16,15 +16,15 @@

1. The GNU Lesser General Public License (LGPL) Version 2.1 or any newer version

See http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html or COPYING.LIB for the full LGPL 2.1 license text. +

See https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html or COPYING.LIB for the full LGPL 2.1 license text.

-Copyright (C) 2000-2023 Dave Beckett
-Copyright (C) 2000-2005 University of Bristol. +Copyright (C) 2000-2023 Dave Beckett
+Copyright (C) 2000-2005 University of Bristol. All Rights Reserved.
@@ -54,7 +54,7 @@ All Rights Reserved.
Under Term 3 of the LGPL Version 2.1, you may choose to license the entire package under the GPL. If that option is chosen, then this package is licensed under the terms of the - GPL Version 2 + GPL Version 2 or alternatively, any newer version of the GPL. See COPYING for the full GPL 2.0 license text.
@@ -62,21 +62,21 @@ All Rights Reserved.
3. The Apache License V2.0 or any newer version
-
See http://www.apache.org/licenses/LICENSE-2.0 or LICENSE-2.0.txt for the full ASL 2.0 license text. +
See https://www.apache.org/licenses/LICENSE-2.0 or LICENSE-2.0.txt for the full ASL 2.0 license text.
- Copyright (C) 2000-2023 Dave Beckett
- Copyright (C) 2000-2005 University of Bristol. + Copyright (C) 2000-2023 Dave Beckett
+ Copyright (C) 2000-2005 University of Bristol.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:
-
http://www.apache.org/licenses/LICENSE-2.0
+
https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, @@ -93,7 +93,7 @@ All Rights Reserved.
-
Copyright (C) 2000-2023 Dave Beckett
Copyright (C) 2000-2005 University of Bristol
+
Copyright (C) 2000-2023 Dave Beckett
Copyright (C) 2000-2005 University of Bristol
diff --git a/NEWS.html b/NEWS.html index 5c367ce5..3f648abd 100644 --- a/NEWS.html +++ b/NEWS.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library - News @@ -11,7 +11,7 @@
2023-03-01 Raptor2 Version 2.0.16 Released

-Fixes CVE-2017-18926
+Fixes CVE-2017-18926 and CVE-2020-25713
Multiple Appveyor Windows and CMake build fixes by 0u812. (Note: the resulting binaries and libraries were not tested on Windows)
Turtle parser now reads input in chunks so can handle huge files. Patch by Sebastian Freundt
Added a serializer for the mKR language. Patch by Richard H. McCullough.
@@ -77,7 +77,7 @@ for the full details of the changes.

2013-11-24 Raptor2 Version 2.0.11 Released

-Completed support for RDF 1.1 N-Triples (aka N-Triples 2013)
+Completed support for RDF 1.1 N-Triples (aka N-Triples 2013)
Added a few new API calls
Made several build, portability and configuration improvements
Fixed reported issues: @@ -92,8 +92,8 @@ for the full details of the changes.

2013-07-27 Raptor2 Version 2.0.10 Released

-Completed support for Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 (Turtle 2013)
-Added support for N-Triples W3C Working Group Note 09 April 2013 (N-Triples 2013)
+Completed support for Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 (Turtle 2013)
+Added support for N-Triples W3C Working Group Note 09 April 2013 (N-Triples 2013)
Added a few new Turtle and N-Triples support functions
Update configure to better handle mixed pkg-config settings
Fixed reported issues: @@ -110,7 +110,7 @@ for the full details of the changes.

2013-02-26 Raptor2 Version 2.0.9 Released

-Added full parsing and serializing support for Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013
+Added full parsing and serializing support for Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013
Added CMake build framework for building Raptor on Microsoft (Daniel Richard G.)
Made a few minor fixes and improvements
Fixed reported issues: @@ -128,7 +128,7 @@ for the full details of the changes.

2012-06-24 Raptor2 Version 2.0.8 Released

-Added support for RDFa 1.1 via updated librdfa
+Added support for RDFa 1.1 via updated librdfa
Multiple portability fixes for Windows and Solarises. (Daniel Richard G.)
Multiple minor fixes and improvements
Fixed reported issues: @@ -146,7 +146,7 @@ for the full details of the changes.

CVE-2012-0037 fixed
Removed Expat support
-Removed internal Unicode NFC code for better and optional ICU
+Removed internal Unicode NFC code for better and optional ICU
Added options for denying file requests and XML entity loading
Added options for SSL certificate verifying
Fixed reported issues: @@ -172,7 +172,7 @@ for the full details of the changes.

2011-11-14 Raptor2 Version 2.0.5 Released
-
All parsers and serializers use the W3C Format URIs as their primary URI
+
All parsers and serializers use the W3C Format URIs as their primary URI
N-Quads parser can now handle optional context/graph URI
Turtle serializer uses official text/turtle mime type
Added some additional UTF-8 and snprintf utility functions
@@ -254,9 +254,9 @@ Fixed reported issue: 0000405.
-
The Raptor 2 API reference manual +
The Raptor 2 API reference manual section on -Changes between raptor 1.4.21 and 2.0.0 +Changes between raptor 1.4.21 and 2.0.0 provides detailed function, macro, enum and type changes. The upgrading document explains how to upgrade existing Raptor V1 code to the new APIs. @@ -279,9 +279,9 @@ Fixed a few bugs including reported issue 0000402
-
The Raptor 2 API reference manual +
The Raptor 2 API reference manual section on -Changes between raptor 1.4.21 and 1.9.1 +Changes between raptor 1.4.21 and 1.9.1 provides detailed function, macro, enum and type changes. The upgrading document explains how to upgrade existing Raptor V1 code to the new APIs. @@ -304,7 +304,7 @@ Features are now called options and have typed values.
GRDDL parser now saves and restores shared libxslt state.
Added serializers for HTML 'html' and N-Quads 'nquads'.
Added parser 'json' for JSON-Resource centric and JSON-Triples.
-Switched to GIT version control hosted by GitHub.
+Switched to GIT version control hosted by GitHub.
Added memory-based AVL-Tree to the public API.
Fixed reported issues: 0000357, @@ -315,9 +315,9 @@ Fixed reported issues: 0000379
-
The Raptor 2 API reference manual +
The Raptor 2 API reference manual section on -Changes between raptor 1.4.21 and 1.9.0 +Changes between raptor 1.4.21 and 1.9.0 provides detailed function and type changes. The upgrading document explains how to upgrade existing Raptor V1 code to the new APIs. @@ -393,7 +393,7 @@ for the full details of the changes.

2008-06-25 Raptor Version 1.4.18 Released

-Added an RDFa parser using an embedded version of librdfa by Manu Sporny of Digital Bazaar.
+Added an RDFa parser using an embedded version of librdfa by Manu Sporny of Digital Bazaar.
Added an Atom 1.0 (RFC 4287) serializer with several output parameters.
Improved RSS 1.0 serializer functionality and resilience.
Added new API methods for qname, serializer, sequence and XML writer classes.
@@ -410,9 +410,9 @@ for the full details of the changes.

Added two new JSON serializers: resource-centric 'json' (Talis RDF/JSON) and triple-centric 'json-triples'
-Added a new public XML SAX2 API class
+Added a new public XML SAX2 API class
Added a new error handling structure
-Made the I/O Stream class support reading
+Made the I/O Stream class support reading
Added several new API methods.
Made several fixes, portability and resilience improvements.
Fixed reported issues: 0000252 and 0000245. @@ -424,8 +424,8 @@ for the full details of the changes.

2007-10-01 Raptor Version 1.4.16 Released
-
100% support for the GRDDL W3C Recommendation of 2007-09-11
-Turtle parser and serializer were updated to support @base from Turtle 2007-09-11.
+
100% support for the GRDDL W3C Recommendation of 2007-09-11
+Turtle parser and serializer were updated to support @base from Turtle 2007-09-11.
Turtle and RDF/XML serializers had performance improvements for large graphs.
Added a TRiG Parser based on Turtle with named graph support.
Several other API changes, fixed and improvements were made.
@@ -441,7 +441,7 @@ for the full details of the changes.

2007-03-26 Raptor Version 1.4.15 Released

GRDDL parser substantially updated to support the -GRDDL W3C Working Draft 2 March 2007
+GRDDL W3C Working Draft 2 March 2007
Errors for XML parsing and URI 404s are reported much better
Fixed reported issues: 0000174, 0000177, 0000178, 0000180
Many other minor fixes and improvements. @@ -454,7 +454,7 @@ for the full details of the changes.

2007-01-31 Raptor Version 1.4.14 Released
-
New Turtle +
New Turtle serializer by Dave Robillard based on the existing RDF/XML-Abbrev serializer.
New GraphViz DOT format serializer by Evan Nemerson.
@@ -521,10 +521,10 @@ for the full details of the changes.

2006-04-22 Raptor Version 1.4.9 Released

-Raptor Tutorial added covering parsing and serializing with examples
-Raptor Reference Manual now covers 100% of the public API
+Raptor Tutorial added covering parsing and serializing with examples
+Raptor Reference Manual now covers 100% of the public API
rapper can now pretty-print RDF using namespaces as hints
-Turtle parser gains boolean literals
+Turtle parser gains boolean literals
Requests for content now send appropriate Accept: headers
No longer require libxml for rss-tag-soup parser
Various Win32 fixes and VC build files updates (John Barstow)
@@ -548,7 +548,7 @@ Created an enhanced API reference manual with gtk-doc
Serializers to build can now be selected at configure time
Parsers can now return the namespace prefix/URIs seen in parsing
Turtle parser update to version 2006-01-02 -(announcement)
+(announcement)
Fix for URI resolution bugs (win32 fix by John Barstow)
Several parser bug fixes for RDF/XML, RSS and GRDDL
RDF/XML serializers and XML writer can write XML 1.0 or XML 1.1
@@ -563,7 +563,7 @@ Many other changes, fixes and improvements. for version control after the 1.4.8 release. See the Redland Subversion site or the online -Raptor installation notes +Raptor installation notes for the latest information.
@@ -584,7 +584,7 @@ for the full details of the changes.

2005-05-19 Raptor Version 1.4.6 Released
-
Added a Gleaning Resource Descriptions from Dialects of Languages (GRDDL) parser for reading XHTML and XML as RDF triples
+
Added a Gleaning Resource Descriptions from Dialects of Languages (GRDDL) parser for reading XHTML and XML as RDF triples
Updated RSS enclosures support in RSS tag soup parser and RSS 1.0 serializer (Suzan Foster)
Fixed several crashes with RSS tag soup parser, RDF/XML-abbrev serializer.
The turtle parser now accepts """long literals""" @@ -695,7 +695,7 @@ statement to have one less 'const', to match the code.
raptor.h now includes stdarg.h
Portability fixes for win32
Updates to -Turtle +Turtle parser to only allow language with non-datatyped literals; allow a '_' immediately after a ':' in qnames and make bare ':' work.
@@ -713,7 +713,7 @@ for the full details of the changes.

2004-05-11 Raptor Version 1.3.0 Released

-Updated Turtle parser to fix the collections syntax, add integer literals and allow - in names.
+Updated Turtle parser to fix the collections syntax, add integer literals and allow - in names.
Added support for guessing a parser from content or identifiers
Completed parser feature support
Added sending HTTP Accept: headers for WWW retrieval when possible
@@ -727,7 +727,7 @@ for the full details of the changes.

2004-01-24 Raptor Version 1.2.0 Released

Added a -Turtle parser (was N-Triples Plus) now with collections.
+Turtle parser (was N-Triples Plus) now with collections.
Added raptor_syntaxes_enumerate to get syntax name, label, mime_type or uri_string of all known parsers.
Added WWW access via BSD libfetch if available.
@@ -736,8 +736,8 @@ Updated the GNOME GUI grapper program to report errors and warnings

2003-12-31 Raptor Version 1.1.0 Released

Added an -N-Triples Plus parser
-Updated for RDF/XML Revised Working Draft (10 October 2003) allowing rdf:RDF to be optional by default. No further changes were needed for RDF/XML Revised Proposed Recommendation (15 December 2003)
+N-Triples Plus parser
+Updated for RDF/XML Revised Working Draft (10 October 2003) allowing rdf:RDF to be optional by default. No further changes were needed for RDF/XML Revised Proposed Recommendation (15 December 2003)
Made URI class constructors, methods and factory methods as well as some other utility functions using or returning URIs or literals take unsigned char* rather than char*.
@@ -775,7 +775,7 @@ Fixed some other minor memory leaks with rdf:datatype and rdf:ID
2003-07-29 Raptor Version 0.9.11 Released
-Completely handles the revised RDF/XML syntax + Completely handles the revised RDF/XML syntax (including post W3C Last Call changes) Added Unicode Normal Form C (NFC) checking for literals (requires GNOME glib 2.0 at present) @@ -812,7 +812,7 @@ Other minor bug fixes. Performance improvements - uses less memory, less repeated small malloc/free sequences, faster for larger files. Added WWW retrieval - can parse from an URI as well as files, given -either libcurl or libxml2 is available. +either libcurl or libxml2 is available. Minor bug fixes. Various Win32 configure, building patches Sources updated to use autoconf 1.6+, automake 2.52+ @@ -829,7 +829,7 @@ Linux utility. 2002-12-20 Raptor Version 0.9.7 Released -Passes about 90% of RDF Core WG Test Cases + Passes about 90% of RDF Core WG Test Cases All memory leaks fixed Portability fixes - compilers, scripts, auto* tools, libxml2 version rdf:ID syntax and duplicates checked @@ -841,9 +841,9 @@ Added more conformance tests, errors and warnings. Calling API changed to provide a common interface to the RDF parsers. The libraptor.3 manual page describes the changes. Added support for RDF datatyped literals in -RDF/XML with +RDF/XML with rdf:datatype attribute on property elements and -N-Triples +N-Triples with the "string"^^<datatypeURIref>. Added support for rdf:parseType="Collection" for RDF Collections URI class allows swappable implementation by applications. @@ -856,7 +856,7 @@ Reorganised source into separate modules - URI, xml parser, ntriples parser, XML namespaces, XML qnames, locator. More resilience with XML errors and XML parser errors - none of libxml2's XML test suite examples crash raptor. -N-Triples +N-Triples parser recovers gracefully from errors in content Packing for debian included Added manual pages libraptor.3 and rapper.1 @@ -874,9 +874,9 @@ Support xml:lang passing to application 2002-03-27 Raptor Version 0.9.4 Released XML Base support (xml:base) added -xml:lang support added with N-Triples lang-string support -All N-Triples string escapes implemented -N-Triples support with XML literals - xml("<foo/>") and plain "foo" +xml:lang support added with N-Triples lang-string support +All N-Triples string escapes implemented +N-Triples support with XML literals - xml("<foo/>") and plain "foo" removed all special code for containers; treated as regular typedNodes rdf:parseType="Literal" now working Builds as shared and static libraries @@ -884,14 +884,14 @@ Conformance test suite added 2001-08-21 Raptor Version 0.9.3 Released -N-Triples + N-Triples parser added rdf:parseType="Literal" works much better (Aaron Michal and me) DAML collections support added (Aaron Michal) Win32 patch added - I can't confirm my merge didn't break this (Aaron Michal) -N-Triples updated to support CR, LF and CR LF endings +N-Triples updated to support CR, LF and CR LF endings Make parser generated ids appear distinguised from regular URIs -Added N-Triples output +Added N-Triples output Made rdf:type, rdf:value as property attributes work Made empty typed nodes work GNOME xml / libxml error location (line, column) values corrected. @@ -912,7 +912,7 @@ Added better XML parser auto-detection for various expats and libxml -Copyright (C) 2001-2023 Dave Beckett Copyright (C) 2001-2005 University of Bristol +Copyright (C) 2001-2023 Dave Beckett Copyright (C) 2001-2005 University of Bristol diff --git a/README.html b/README.html index 27a8295a..5095083f 100644 --- a/README.html +++ b/README.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library @@ -8,12 +8,12 @@ Raptor RDF Syntax Library -Dave Beckett +Dave Beckett Overview -Raptor + Raptor is a free software / Open Source C library that provides a set of parsers and serializers that generate Resource Description Framework (RDF) triples @@ -27,7 +27,7 @@ RDF/XML (regular, abbreviated, XMP), Turtle 2013, N-Quads, N-Triples Raptor was designed to work closely with the -Redland RDF library +Redland RDF library (RDF Parser Toolkit for Redland) but is entirely separate. It is a portable library that works across many POSIX systems (Unix, GNU/Linux, BSDs, OSX, cygwin, win32). @@ -44,8 +44,8 @@ and file-by-file changes in the ChangeLog. -Designed to integrate well with Redland -Parses content on the web if libcurl, libxml2 or BSD libfetch is available. +Designed to integrate well with Redland +Parses content on the web if libcurl, libxml2 or BSD libfetch is available. Supports all RDF terms including datatyped and XML literals Optional features including parsers and serialisers can be selected at configure time. Language bindings to Perl, PHP, Python and Ruby when used via Redland @@ -55,7 +55,9 @@ and file-by-file changes in the ChangeLog. Known bugs and issues are recorded in the -Redland issue tracker. +Redland issue tracker +or at +GitHub issues for Raptor. @@ -65,20 +67,20 @@ and file-by-file changes in the ChangeLog. RDF/XML Parser A Parser for the standard -RDF/XML syntax. +RDF/XML syntax. -Fully handles the RDF/XML syntax updates for XML Base, xml:lang, RDF datatyping and Collections. -Handles all RDF vocabularies such as FOAF, RSS 1.0, Dublin Core, OWL, DOAP +Fully handles the RDF/XML syntax updates for XML Base, xml:lang, RDF datatyping and Collections. +Handles all RDF vocabularies such as FOAF, RSS 1.0, Dublin Core, OWL, DOAP Handles rdf:resource / resource attributes -Uses libxml XML parser +Uses libxml XML parser N-Quads Parser A parser for the -RDF 1.1 N-Quads - A line-based syntax for an RDF datasets, W3C Candidate Recommendation, 05 November 2013. +RDF 1.1 N-Quads - A line-based syntax for an RDF datasets, W3C Candidate Recommendation, 05 November 2013. This is an extension to N-Triples, providing an optional 4th context graph term at the end of the line when a triple is associated with a named graph. @@ -88,25 +90,25 @@ named graph. N-Triples Parser A parser for the -RDF 1.1 N-Triples - A line-based syntax for an RDF graph, W3C Candidate Recommendation, 05 November 2013 (aka N-Triples 2013) +RDF 1.1 N-Triples - A line-based syntax for an RDF graph, W3C Candidate Recommendation, 05 November 2013 (aka N-Triples 2013) based on the older -N-Triples. +N-Triples. Turtle Parser A parser for the -Turtle Terse RDF Triple Language W3C Candidate Recommendation, 19 February 2013 +Turtle Terse RDF Triple Language W3C Candidate Recommendation, 19 February 2013 based on earlier work -Turtle Terse RDF Triple Language (2004) +Turtle Terse RDF Triple Language (2004) TRiG Parser A parser for the -RDF 1.1 TriG RDF Dataset Language. +RDF 1.1 TriG RDF Dataset Language. The parser does not support the entire 1.1 TRiG specification; the @@ -136,7 +138,7 @@ as well as the earlier Atom 0.3. GRDDL and microformats parser A parser/processor for -Gleaning Resource Descriptions from Dialects of Languages (GRDDL) +Gleaning Resource Descriptions from Dialects of Languages (GRDDL) syntax, W3C Recommendation of 2007-09-11 which allows reading XHTML and XML as RDF triples by using profiles in the document that declare XSLT transforms from the XHTML or XML content into RDF/XML or other @@ -154,9 +156,9 @@ a lax HTML parser to allow HTML tag soup to be read. RDFa parser A parser for -RDFa 1.0 +RDFa 1.0 (W3C Recommendation 14 October 2008) and -RDFa 1.1 +RDFa 1.1 (W3C Recommendation 07 June 2012) implemented via librdfa linked inside Raptor. librdfa was, written primarily by Manu Sporny @@ -164,7 +166,7 @@ of Digital Bazaar and is licensed with the same license as Raptor. As of Raptor 2.0.8 the RDFa parser passes all of the -RDFa 1.0 test suite +RDFa 1.0 test suite except for 4 tests and all of the RDFa 1.1 test suite except for 30 tests. @@ -176,9 +178,9 @@ except for 30 tests. RDF/XML Serializer A serializer to the standard -RDF/XML syntax +RDF/XML syntax as revised by the -W3C RDF Core working group +W3C RDF Core working group in 2004. This writes a plain triple-based RDF/XML serialization with no optimisation or pretty-printing. @@ -192,7 +194,7 @@ of some pre-processing. This is suitable for small documents. N-Quads Serializer A serializer for the -RDF 1.1 N-Quads -A line-based syntax for an RDF datasets, W3C Candidate Recommendation, 05 November 2013. +RDF 1.1 N-Quads -A line-based syntax for an RDF datasets, W3C Candidate Recommendation, 05 November 2013. This is an extension to N-Triples, providing an optional 4th context graph term at the end of the line when a triple is associated with a named graph. @@ -202,13 +204,13 @@ named graph. N-Triples Serializer A serializer for the -RDF 1.1 +RDF 1.1 N-Triples - A line-based syntax for an RDF graph (aka N-Triples 2013) based on the earlier -N-Triples +N-Triples syntax as used by the -W3C RDF Core working group -for the RDF Test Cases. +W3C RDF Core working group +for the RDF Test Cases. @@ -225,7 +227,7 @@ for the RDF Test Cases. json: in a resource-centric abbreviated form like Turtle or RDF/XML-Abbreviated as defined by: -RDF 1.1 +RDF 1.1 JSON Alternate Serialization (RDF/JSON), W3C Working Group Note, 07 November 2013 json-triples: a triple-centric format based on the @@ -253,7 +255,7 @@ format. Turtle Serializer A serializer for the -Turtle Terse RDF Triple Language W3C Candidate Recommendation, 19 February 2013 +Turtle Terse RDF Triple Language W3C Candidate Recommendation, 19 February 2013 XMP Serializer @@ -276,7 +278,7 @@ It is demonstrated in the rapper utility program which shows how to call the parser and write the triples in a serialization. When Raptor is used inside -Redland, +Redland, the Redland documentation explains how to call the parser and contains several example programs. There are also further examples in the example directory @@ -292,7 +294,7 @@ of the distribution. The packaged sources are available from http://download.librdf.org/source/ (master site) The development GIT sources can also be -browsed at GitHub +browsed at GitHub or checked out at git://github.com/dajobe/raptor.git @@ -307,14 +309,14 @@ under the LGPL (GPL) or Apache 2.0 licenses. See Mailing Lists -The Redland mailing lists + The Redland mailing lists discusses the development and use of Raptor and Redland as well as future plans and announcement of releases. -Copyright (C) 2000-2021 Dave Beckett Copyright (C) 2000-2005 University of Bristol +Copyright (C) 2000-2023 Dave Beckett Copyright (C) 2000-2005 University of Bristol diff --git a/RELEASE.html b/RELEASE.html index 6ce31164..8f95e8f1 100644 --- a/RELEASE.html +++ b/RELEASE.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library - Release Notes @@ -422,8 +422,8 @@ to use and require Bison 3.0.0. suites for the updated specifications: -RDF 1.1 N-Triples - A line-based syntax for an RDF graph, W3C Candidate Recommendation, 05 November 2013 (aka N-Triples 2013) -RDF 1.1 N-Quads - A line-based syntax for an RDF datasets, W3C Candidate Recommendation, 05 November 2013 +RDF 1.1 N-Triples - A line-based syntax for an RDF graph, W3C Candidate Recommendation, 05 November 2013 (aka N-Triples 2013) +RDF 1.1 N-Quads - A line-based syntax for an RDF datasets, W3C Candidate Recommendation, 05 November 2013 The main fixes were: @@ -457,7 +457,7 @@ strings created by raptor_term_to_counted_string() and Parser changes N-Triples parser was updated to support all of -RDF 1.1 +RDF 1.1 N-Triples - A line-based syntax for an RDF graph (aka N-Triples 2013) It now supports # comments after the end of lines, checks for illegal unicode escapes, checks for bad URIs and @@ -518,14 +518,14 @@ sanitizing. Parser changes Turtle parser was updated to handle -Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 +Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 (Turtle 2013) The main changes were to align with SPARQL-style blank node names, prefixes and local names. N-Triples parser was updated to handle -N-Triples - A line-based syntax for an RDF graph W3C Working Group Note 09 April 2013 (N-Triples 2013) +N-Triples - A line-based syntax for an RDF graph W3C Working Group Note 09 April 2013 (N-Triples 2013) The main changes were to allow \b \f, UTF-8 in strings and URIs and the SPARQL-style blank node names. @@ -606,7 +606,7 @@ Fixes Issue #0000521 Turtle Parser: Added full support for -Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 +Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 This includes accepting new keywords from SPARQL @@ -622,7 +622,7 @@ which should be written as %20. Serializer changes Turtle Serializer: Added full support for -Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 +Turtle Terse RDF Triple Language W3C Candidate Recommendation 19 February 2013 which particular effects the encoding of URIs in the serializer. @@ -693,7 +693,7 @@ f94fa561db05b21132b14a2b72f05b77e666c252 on Wed Apr 28 21:31:54 2010 when the guess is very poor, rather just return the first bad result. Fixes Issue #0000487 -which was reported in Redland librdf but +which was reported in Redland librdf but is implemented here. @@ -702,7 +702,7 @@ from the guessed parser. RDFa parser: Updated librdfa to the latest GIT supporting -RDFa 1.1 +RDFa 1.1 with 30 tests still not passing - mostly issues in the core librdfa. Made several resilience and crash fixes. Updated the RDFa 1.0 test suite to latest tests and made fixes. The RDFa parser now accepts @@ -861,7 +861,7 @@ no parser that requires an XML parser, libxml2 will not be required. Removed internal Unicode NFC checking code used for checking RDF/XML literals conformance which was expensive to check and a large of compiled-in static dataset that was rather out of date. Replaced -with optional compiled use of ICU. +with optional compiled use of ICU. If ICU is not explicitly configured, no literal checking is done. Options changes @@ -1000,7 +1000,7 @@ generate permuations: Parser class changes Updated all parser URIs to use the -W3C Format URIs +W3C Format URIs as the primary URIs. Existing URIs become aliases. (Nicholas J Humfrey) @@ -1026,7 +1026,7 @@ type in the syntax recognizing code. Serializer class changes Updated all serializer URIs to use the -W3C Format URIs +W3C Format URIs as the primary URIs. Existing URIs become aliases. (Nicholas J Humfrey) @@ -1283,11 +1283,11 @@ unlikely error recovery conditions. Some actual potential crash bugs were found: The workaround for - ancient libxml2 error handling + ancient libxml2 error handling in raptor_libxml_xmlStructuredError_handler_parsing() was broken for some time, so that probably means nobody uses old libxml2. - librdfa URI + librdfa URI resolving in rdfa_resolve_uri() used unallocated memory in some relative URI cases. @@ -1479,9 +1479,9 @@ in the form of additional APIs, new serializers and parsers. The details of the additions, removals and changes of functions, structures, typedefs and enums are listed in the -Raptor 2 API reference manual +Raptor 2 API reference manual section on -Changes between raptor 1.4.21 and 1.9.0. +Changes between raptor 1.4.21 and 1.9.0. The upgrading document explains how to upgrade existing code that uses the V1 APIs to use the new APIs. @@ -1499,7 +1499,7 @@ the new APIs. GRDDL parser now saves and restores shared libxslt state. Added serializers for HTML 'html' and N-Quads 'nquads'. Added parser 'json' for JSON-Resource centric and JSON-Triples. -Switched to GIT version control hosted by GitHub. +Switched to GIT version control hosted by GitHub. Added memory-based AVL-Tree to the public API. @@ -1551,10 +1551,10 @@ librdf will default to use these.. The API reference manual now includes an automatically generated reference section on the -functions and types that were added, removed and changed between raptor 1 and raptor 2 APIs. +functions and types that were added, removed and changed between raptor 1 and raptor 2 APIs. It also includes an automatically generated section on the -parser and serializers with their names, mime types and Q values. +parser and serializers with their names, mime types and Q values. The tutorial examples were updated to the Raptor 2 APIs. @@ -2092,7 +2092,7 @@ parsing. RDFA parser (via librdfa): Update to latest librdfa GIT sources with head a438ce68a40e04b399ec2b2c613d0c867d9315c7 now moved to -http://github.com/msporny/librdfa +https://github.com/msporny/librdfa to fix handling single character namespaces (Issue #0000310), empty datatype attribute and empty xml:lang attributes @@ -2596,7 +2596,7 @@ for future replacing of raptor_statement Parser Changes A new -RDFa +RDFa parser was added (name rdfa) using librdfa to implement it. librdfa is linked as part of Raptor and @@ -2604,7 +2604,7 @@ written by Manu Sporny of Digital Bazaar, licensed with the same license as Raptor. The RDFa -test suite +test suite was added to the test and (via librdfa) Raptor passes all but 4 tests which fail due to different output xmlns attribute ordering (which does not matter to XML parsers). @@ -2819,10 +2819,10 @@ add extra top-level JSON object data. Example of using the resource-centric serializer while defining a callback: -$ rapper -q -o json -f jsonCallback=foo http://librdf.org/raptor/raptor.rdf +$ rapper -q -o json -f jsonCallback=foo https://librdf.org/raptor/raptor.rdf foo( { - "http://librdf.org/raptor/#raptor" : { + "https://librdf.org/raptor/#raptor" : { "http://usefulinc.com/ns/doap#description" : [ { ... @@ -3027,11 +3027,11 @@ only one parser and one serializer feature was possible. The main changes to this release are: Provide 100% support for the -GRDDL W3C Recommendation of 2007-09-11. +GRDDL W3C Recommendation of 2007-09-11. The -Turtle +Turtle parser and serializer were updated to support @base for specifying a base URI, following Turtle of 2007-09-11. @@ -3059,7 +3059,7 @@ for large graphs. 0000232: libraptor does not correctly free up libxml error handler, causing crashes in subsequent calls to libxml error handlers 0000237: raptor_sequence robustness: item ownership on insert error 0000238: GRDDL parser in SVN overwrites blank nodes when merging graphs - 0000239: GRDDL parser in SVN returns 60 less triples with http://www.w3.org/ + 0000239: GRDDL parser in SVN returns 60 less triples with https://www.w3.org/ @@ -3143,7 +3143,7 @@ Added raptor_www_get_final_uri() to return the final URI The GRDDL parser/processor was substantially updated and now supports 100% of the -Gleaning Resource Descriptions from Dialects of Languages (GRDDL) +Gleaning Resource Descriptions from Dialects of Languages (GRDDL) syntax, W3C Recommendation of 2007-09-11: @@ -3271,7 +3271,7 @@ some of the names and values that caused the error. General Changes GRDDL parser now passes the (unapproved) test suite for the -GRDDL W3C Working Draft 2 March 2007 +GRDDL W3C Working Draft 2 March 2007 except for two tests that have been reported as having errors. @@ -3303,30 +3303,30 @@ rather than the RSS Tag Soup parser. libxml structured error reporing api. From -$ rapper -i grddl http://librdf.org/LICENSE.txt -rapper: Parsing URI http://librdf.org/LICENSE.txt -rapper: Error - URI http://librdf.org/LICENSE.txt - XML error - http://librdf.org/LICENSE.txt:2: -rapper: Error - URI http://librdf.org/LICENSE.txt - XML error - parser -rapper: Error - URI http://librdf.org/LICENSE.txt - XML error - error : -rapper: Error - URI http://librdf.org/LICENSE.txt - XML error - Document is empty -rapper: Error - URI http://librdf.org/LICENSE.txt - XML error - Redland RDF Application Framework - License -rapper: Error - URI http://librdf.org/LICENSE.txt - XML error - ^ -rapper: Failed to parse URI http://librdf.org/LICENSE.txt grddl content +$ rapper -i grddl https://librdf.org/LICENSE.txt +rapper: Parsing URI https://librdf.org/LICENSE.txt +rapper: Error - URI https://librdf.org/LICENSE.txt - XML error - https://librdf.org/LICENSE.txt:2: +rapper: Error - URI https://librdf.org/LICENSE.txt - XML error - parser +rapper: Error - URI https://librdf.org/LICENSE.txt - XML error - error : +rapper: Error - URI https://librdf.org/LICENSE.txt - XML error - Document is empty +rapper: Error - URI https://librdf.org/LICENSE.txt - XML error - Redland RDF Application Framework - License +rapper: Error - URI https://librdf.org/LICENSE.txt - XML error - ^ +rapper: Failed to parse URI https://librdf.org/LICENSE.txt grddl content rapper: Parsing returned 0 triples To this: -$ rapper -i grddl http://librdf.org/LICENSE.txt -rapper: Parsing URI http://librdf.org/LICENSE.txt -rapper: Error - URI http://librdf.org/LICENSE.txt:1 - XML parser error: Document is empty -rapper: Error - URI http://librdf.org/LICENSE.txt:1 - XInclude processing failed for GRDDL document -rapper: Failed to parse URI http://librdf.org/LICENSE.txt grddl content +$ rapper -i grddl https://librdf.org/LICENSE.txt +rapper: Parsing URI https://librdf.org/LICENSE.txt +rapper: Error - URI https://librdf.org/LICENSE.txt:1 - XML parser error: Document is empty +rapper: Error - URI https://librdf.org/LICENSE.txt:1 - XInclude processing failed for GRDDL document +rapper: Failed to parse URI https://librdf.org/LICENSE.txt grddl content rapper: Parsing returned 0 triples GRDDL parser updated to support the -GRDDL W3C Working Draft 2 March 2007: +GRDDL W3C Working Draft 2 March 2007: Namespace and profile URI handling now works. @@ -3387,7 +3387,7 @@ multiple function / user_data pairs. General Changes Added a -Turtle Terse RDF Triple Language serialiser by Dave Robillard based on the existing RDF/XML-Abbrev +Turtle Terse RDF Triple Language serialiser by Dave Robillard based on the existing RDF/XML-Abbrev serialiser. @@ -3467,7 +3467,7 @@ the mime type (q=10), then that parser is used. Serializer Changes Added a new -Turtle Terse RDF Triple Language +Turtle Terse RDF Triple Language serializer and two new internal APIs based on the existing RDF/XML-Abbrev serialiser, written by Dave Robillard: @@ -3595,7 +3595,7 @@ allowed to be retrieved, or denied entirely. Documentation Changes The -Raptor Reference Manual +Raptor Reference Manual now includes descriptions of all the parsers and serializers and the tutorial has a new section describing how to filter URIs and deny network requests. @@ -3621,7 +3621,7 @@ URI is given and it is needed. handle a list of URIs in the profile so it now can support dataview:transformation in XML taking a list of transformations as defined in -The GRDDL profile for XHTML part of the GRDDL specification. +The GRDDL profile for XHTML part of the GRDDL specification. It now also recognises Embedded RDF and HCalendar @@ -3734,13 +3734,13 @@ for version control and the Raptor installation instructi Documentation Changes A new -Raptor Tutorial +Raptor Tutorial was written covering using all parsing and serializing functions along with example code. The -Raptor Reference Manual +Raptor Reference Manual now covers 100% of all functions, structs and defines with gtkdoc generated documentation. @@ -3927,7 +3927,7 @@ no longer be returned in any statement position (to be confirmed). for version control after the 1.4.8 release. Please check the Redland Subversion site for the latest status or the online -Raptor installation notes +Raptor installation notes for the raptor specific subversion installation information. @@ -4068,7 +4068,7 @@ escaping. Turtle Parser Changes Updated to support Turtle version 2006-01-02 -(announcement). +(announcement). Switch qname, blank node and prefix definitions to SPARQL ones. @@ -4195,7 +4195,7 @@ serialize to RDF/XML if the predicate URI is not absolute. Added --with-xslt-config configure option Added a new parser for -Gleaning Resource Descriptions from Dialects of Languages (GRDDL) +Gleaning Resource Descriptions from Dialects of Languages (GRDDL) which allows reading XHTML and XML as RDF triples by using profiles in the document that declare XSLT transforms from the XHTML/XML content into RDF/XML which is the RDF content. It does not @@ -4268,7 +4268,7 @@ width and height using gconf2. Added a new RDF/XML with abbreviations serializer rdfxml-abbrev written by Steve Shepard which handles several of the abbreviations specified by the -RDF/XML Syntax Specification (Revised) +RDF/XML Syntax Specification (Revised) W3C Recommendation. It is suitable for writing small documents as there are known scaling issues. @@ -4321,7 +4321,7 @@ improve the existing RDF/XML serializer and to provide a new This API it is also used by the next release of -Rasqal to provide serializing +Rasqal to provide serializing of query results to XML. @@ -4370,7 +4370,7 @@ this bug but it will not cause the test suite ('make check') to fail. Added additional -Turtle +Turtle parser tests that cover Notation 3 syntax that is not part of the Turtle language. @@ -4750,7 +4750,7 @@ available to check. Parser Changes The -Turtle +Turtle parser was updated to only allow language with non-datatyped literals, allow a '_' immediately after a ':' in qnames and to make a bare ':' qname work correctly. @@ -4773,7 +4773,7 @@ in lax mode. Parser modes are controlled by the Raptor 1.3.0 Changes A release primarily to provide support for -the new Rasqal +the new Rasqal RDF query library but with some new features and fixes. @@ -4789,7 +4789,7 @@ RDF-namespaced names in element and attributes and if they are forbidden giving an error otherwise if unknown, giving a warning. The -Turtle +Turtle parser was updated to correct the collections syntax, allow '-' in names and QNames and to add integer literals. This parser now correctly uses raptor_generate_id when a blank identifier name is @@ -4867,7 +4867,7 @@ for constructing strings from substrings appended or prepended. -Copyright (C) 2003-2021 Dave Beckett Copyright (C) 2003-2005 University of Bristol +Copyright (C) 2003-2023 Dave Beckett Copyright (C) 2003-2005 University of Bristol diff --git a/TODO.html b/TODO.html index bb55d717..d57c64d8 100644 --- a/TODO.html +++ b/TODO.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library - Issues @@ -9,12 +9,14 @@ Raptor RDF Syntax Library - Issues Issues should be reported at the -Redland Issue Tracker. +Redland Issue Tracker. +or at +GitHub issues for Raptor. -Copyright (C) 2001-2021 Dave Beckett Copyright (C) 2001-2005 University of Bristol +Copyright (C) 2001-2023 Dave Beckett Copyright (C) 2001-2005 University of Bristol diff --git a/UPGRADING.html b/UPGRADING.html index 3e721548..98f187f2 100644 --- a/UPGRADING.html +++ b/UPGRADING.html @@ -1,6 +1,6 @@ - - + + Raptor RDF Syntax Library - Upgrading to the Raptor V2 API @@ -50,7 +50,7 @@ split that into two stages. Release Notes in long summary form with some background to why, in the ChangeLog in very long form. The reference manual contains -a section +a section describing what was added, deleted, renamed and otherwise changed for both the functions exported from the library, as well as the typedefs and enum values. @@ -108,7 +108,7 @@ that are replaced by the functions around the world object in V2, use an #ifdef that provides the two code paths. -rasqal + rasqal in GIT (will be 0.9.20) uses this approach. @@ -117,7 +117,7 @@ source file is to copy it and make a V2 version and then choose the file to use at configure or build time. -librdf 1.0.11 uses this approach. + librdf 1.0.11 uses this approach. Either way, basing the interface on the V2 APIs makes it clear @@ -153,7 +153,7 @@ Raptor code. -Copyright 2010-2021 Dave Beckett +Copyright 2010-2023 Dave Beckett -- cgit v1.2.1