File: TODO.html

package info (click to toggle)
redland 1.0.7-1
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 27,592 kB
  • ctags: 12,328
  • sloc: ansic: 79,017; xml: 25,115; sh: 10,162; yacc: 5,985; lex: 3,682; makefile: 3,260; perl: 2,814; cpp: 59
file content (200 lines) | stat: -rw-r--r-- 11,934 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
  <title>Redland RDF Application Framework - To Do List</title>
</head>
<body>

<h1>Redland RDF Application Framework - To Do list</h1>

<p>Bugs should be reported at the
<a href="http://bugs.librdf.org/">Redland Issue Tracker</a>.
</p>


<h2>Bugs, Features, Requests For Enhancement</h2>

<p>In no real order.  Help wanted.</p>

<ul>
<li>'triples' query language implementation seems to have rotted as of 1.0.0</li>
<li>Docs: hard to find/know of raptor parser and serializer features</li>
<li>RFE: model class method to load into model with context</li>
<li>RFE: model class method to a remove/load into model for some context</li>
<li>Docs: it was hard to find the legal (parser) feature URIs in
the documentation, or what values to use.</li>
<li>Documentation: describe the redland features available per class</li>
<li>Update the RDF/RDFS terms/labels for the latest RDF Schema revision</li>
<li>In-memory storage uses more memory than needed</li>
<li>Defensive code - check object types are correct by adding magic fields to start of all objects</li>
<li>Consider an AVL-tree in-memory store (<a href="http://www.msu.edu/user/pfaffben/avl/">libavl</a>)</li>
<li>Docs: note that compiling redland may also build raptor and rasqal, if they are needed</li>
<li>Document the storage constructor hash options under the main class</li>
<li>RFE: make add_statement method on model take URIs</li>
<li>Add arcs_in/arcs_out model methods</li>
<li>Add container class for manipulating RDF containers - Seq, Bag, Alt, ...</li>
<li>If LGPL/Apache license, include compatible code OR add separate package?</li>
<li>Write a C++ interface</li>
<li>Provide any necessary support for RDF Schema (fast rdf:type lookups)</li>
<li>Write some better example code</li>
<li>Write a quickstart / howto document</li>
<li>Maybe generate part of librdf.h automatically to make a 1-header file system.</li>
<li>Fix the URI hash mechanism - currently stores URI/pointer pairs in hash - wrong</li>
<li>The library does not do file locking on e.g. DB files</li>
<li>For IRIX (and others?), try also linking with -lpthreads when testing for working Berkeley DB</li>
<li>String encoding - needs iconv posix function and/or Unicode library.
Some utility functions have been written for UTF-8 to/from ISO Latin-1.</li>
</ul>

<p>(Excluding issues near <tt>FIXME</tt>s in the source)</p>


<h2>Done</h2>

<p>The most recent changes are at the top, with the first
release version where appropriate.</p>

<ul>
<li>Initialise the default genid base in <code>librdf_new_world</code> with something more fine-grained than seconds.  Add some microseconds digits (1.0.3)</li>
<li>RFE: consider how to add parser guessing (via raptor) into the
redland parser API - use the 'guess' parser name (1.0.3)</li>
<li>RFE: add user mappings from URIs to namespace aliases to the serializer (Raptor 1.4.7)</li>
<li>RFE: The parser should be able to adjust error and warning
actions, stopping immediately or ignoring them by features. Document
the defaults. (1.0.2)</li>
<li>Add <tt>#ifdef WIN32</tt> around parts including the config file and create a win32 build (1.0.1 - third party)</li>
<li>RFE: Add node.as_sha1 easy digest methods for literal nodes (1.0.1)</li>
<li>RFE: return serialized models to syntax as strings (1.0.0)</li>
<li>Removed the useless parser error/warning callbacks with a proper
logging API that can be accessed by the application to and dealt with
as desired. (0.9.17)</li>
<li>Allow raptor parser features (<code>raptor_set_feature</code>) to be
set via <code>librdf_parser_set_feature</code> (0.9.17)</li>
<li>rdf_uri.h and rdf_node.h exported functions returning rdf_digest* which is a private structure, now made internal (0.9.16)</li>
<li>Added some defensive code checks for NULL object parameters and
abort when debugging (0.9.15)</li>
<li>The serializer code crashed in PHP (0.9.15)</li>
<li>raptor-uri-test in redland when compiled against
system raptor failed to find raptor.h; fixed in raptor 1.1.0.</li>
<li>Added <code>librdf_model_get_storage</code> method so storage
object needn't be kept around when dealing with model (0.9.15).</li>
<li>Fixed serializing URI http://xmlns.com/foaf/0.1/mbox_sha1 to a property element to breaks the namespace/URI after 'sha1' as the maximal legal XML name (0.9.15)</li>
<li>Altered rdfproc to by default append to stores on parsing (0.9.15)</li>
<li>Docs: note in language docs that 'make install' of the main
library is generally needed before any of the language builds will work (0.9.15)</li>
<li>BUG: Blank nodes with illegal nodeIDs (as far as RDF/XML are concerned)
can be serialized.  Fixed by the change below; all internal nodeIDs are now serializable in RDF/XML or N-Triples (0.9.14)</li>
<li>Rewrite incoming <code>rdf:nodeID</code> attribute values into same form as generated blank node IDs, ie. <code>r</code><em>redland-start-time</em><code>r</code><em>unique-sequence-counter</em> (0.9.14)</li>
<li>example2.c is rather useless, replaced with a simple string parsing example (0.9.13)</li>
<li>Replaced *_seriali[sz]e methods with *_to_stream in order to
reduce confusion versus serializer class (0.9.13)</li>
<li>BDB 4.1 causes problems - now supported (0.9.13)</li>
<li>perl - if you didn't clone a node before trying to re-use it the whole thing would segfault (0.9.13)</li>
<li>swig 1.3.14 may fail to work for some languages (perl,python ok) (0.9.13)</li>
<li>New method for syncing of models to store - librdf_model_sync (0.9.13)</li>
<li>Add proper error/warning reporting - world class has this now (0.9.13)</li>
<li>Ensure non-file: URIs do not cause crashes - fixed by Raptor URI class (0.9.13)</li>
<li>Add URI retrieval via external www libraries - done via raptor for retrieving URI content for parsing.  Not by a new module. (0.9.13)</li>
<li>RFE: Add is_literal etc. methods to node class (0.9.13)</li>
<li>storage hash-type="memory" with no name (not really needed) crashed (0.9.13)</li>
<li>Initial thread support (0.9.13)</li>
<li>Repat removed - not up-to-date, maintained (0.9.13)</li>
<li>Crashed when contexts are attempted to be used when not enabled with
contexts='yes' (0.9.13)</li>
<li>parse_as_stream methods assumed the URI object lived throughout the
parsing.  They may not, and had to be copied on the first call - fixed for raptor only (0.9.13)</li>
<li>make librdf_statement_set_subject* free any existing node before setting (0.9.12)</li>
<li>Pass RDF parser error messages to user code, scripting languages (0.9.12)</li>
<li>Add a swig test in autogen.sh, abort if it is too old (0.9.12)</li>
<li>swig 1.3.14 changed its default to shadow and failed to work out
of the box.  Add -noproxy to the swig line for 1.3.14+ (0.9.12)</li>
<li>Hacked around repat parser failing to pass bnode ids when as statement objects (0.9.12)</li>
<li>Added relative URI parsing code from Repat (via raptor) (0.9.12)</li>
<li>Handle xml:lang when the rdf parsers provide it (0.9.12)</li>
<li>Add query language interfaces (0.9.12)</li>
<li>Add support for blank nodes (were anonymous resources) (0.9.12)</li>
<li>Removed all node types except for resource, literal, blank, li (statement (0.9.12))</li>
<li>Use <a href="http://xmlsoft.org/">libxml</a> rather than expat as default xml parser (at least for raptor) Reasons: uses iconv to handle more content encodings and provides better error reporting (0.9.12)</li>
<li>Link XML Libraries (-lexpat etc.) before libwww libraries to
ensure correct XML library is used (0.9.11)</li>
<li>Python interface to parsers now works (0.9.11)</li>
<li>Multiple startup/shutdowns of entire library now works (0.9.11)</li>
<li>Make the library work as a shared library (0.9.11)</li>
<li>Model size method implemented (0.9.11)</li>
<li>Added a <a href="docs/java.html">Java interface</a> (0.9.10)</li>
<li><tt>librdf_hash_from_string()</tt> - \ escaping doesn't work properly (0.9.9)</li>
<li>SiRPAC wrappers handle multi-line literal objects (0.9.9)</li>
<li>Added <a href="docs/tcl.html">Tcl</a> interface (0.9.8)</li>
<li>Add module - <a href="http://librdf.org/raptor/">Raptor</a> RDF parser - internal (0.9.8)</li>
<li>Make API docbook sgml generate 1 big HTML file (0.9.6)</li>
<li>Python interface (0.9.6)</li>
<li>Add proper error/warning reporting for RDF/XML parsers (0.9.6)</li>
<li>Perl interface (0.9.4)</li>
<li>module - storage implemented as hashes</li>
<li>made <tt>get</tt> methods in all hash impls. use iterators (side
effecting - yuck)</li>
<li>made BDB V2 and V3 use btree and handle duplicates</li>
<li>removed GDBM from default code since doesn't handle duplicates</li>
<li>removed references to factories from simple user code</li>
<li>module - rdf parser - via libwww RDF parser</li>
<li>annotate the functions with gnome-doc / kernel-doc style comments
(after JavaDoc) with care taken to make sure it is clear who owns the
memory of objects passed in or returned by functions</li>
<li>module - rdf parser - via Java RDF API / SiRPAC</li>
<li>module - in memory storage</li>
<li>module - storage factory</li>
<li>module - model</li>
<li>module - memory allocation</li>
<li>change all functions to start with librdf_</li>
<li>a decent source-code based documentation system - GNOME / Linux kernel
gnome-doc / kernel-doc programs based on the Javadoc formatted comments
style, but for C</li>
<li>wrap the code with <tt>#ifdef</tt> etc. to prevent exposing internals to user code</li>
<li>module - berkeley DB hash</li>
<li>change functions to all start with RDF_ - new and free functions</li>
<li>decide on the license(s)  - GPL/LGPL and BSDish ???</li>
<li>iterator interface and module for returning results</li>
</ul>

<h2>Decided to do differently, not to address</h2>

<p>I reserve the right to change my mind again!</p>
<ul>
<li>RFE: model.parseString(format, "string"), model.parseURI(format, URI, baseURI=URI) creating and destroying temporary parser objects for <em>format</em>.
Means no need to care about parser class if you just want simple things.  Similarly
for model.serialize() and Serializer class, however take care with serialise() method.  Better as model.load(), model.save() or write()?  Addressed by the guess parser in raptor 1.4.7+.</li>
<li>Make API docbook sgml generate decent PostScript / PDF output (1.0.3)</li>
<li>Split the header files into internal / user ones - now most headers are user ones (1.0.1)</li>
<li>Write stringbuffer for easy creation of growing in-memory strings - now being considered inside raptor.</li>
<li>Provide a way to represent reified statements</li>
<li>Redland does not work with GDBM hashes.  BDB is much better (0.9.12)</li>
<li>Redland does not work with BerkeleyDB V1.  Not fixing since it works with V2,V3 and V4 (0.9.12)</li>
<li>RFE: make Node and URI be the same class, change all methods using
Nodes to take URI OR URI or Literal as appropriate.  The RDF abstract
syntax has nodes that are (URI-refs or Literals or ...) so this design
matches it well (0.9.12)</li>
<li>These will not be made into modules at present, the internal RDF
parser will use expat or libxml as necessary.
<ul>
<li>Add module - xml dom parser - external</li>
<li>Add module - xml dom parser - libxml</li>
<li>Add module - xml sax parser - libxml</li>
<li>Add module - xml parser - sax</li>
<li>Add module - xml parser - dom</li>
<li>Modularise the library so some parts can be removed [already done]</li>
</ul>
</li>
<li>This is not needed as a module, the internal RDF parser will do this.
<ul>
<li>module - xml namespaces</li>
</ul>
</li>
</ul>

<hr />

<p>Copyright (C) 2000-2007 <a href="http://purl.org/net/dajobe/">Dave Beckett</a><br />Copyright (C) 2000-2005 <a href="http://www.bristol.ac.uk/">University of Bristol</a></p>

</body>
</html>