forked from dajobe/rasqal
-
Notifications
You must be signed in to change notification settings - Fork 0
/
RELEASE.html
4818 lines (3602 loc) · 165 KB
/
RELEASE.html
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
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?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>Rasqal RDF Query Library - Release Notes</title>
</head>
<body>
<h1>Rasqal RDF Query Library - Release Notes</h1>
<h2 id="rel0_9_31"><a name="rel0_9_31">Rasqal 0.9.31 changes</a></h2>
<p>Not yet released.
</p>
<h2 id="rel0_9_30"><a name="rel0_9_30">Rasqal 0.9.30 changes</a></h2>
<p>Removed RDQL support as promised. So long and thanks for all the
queries. Use SPARQL instead.
</p>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=506">0000506</a>: configure.ac has bash -specific (non-POSIX) == syntax</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=511">0000511</a>: Add support for OSSP UUID library</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=517">0000517</a>: Autoconf errors when checking for several headers and cross-compiling</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=523">0000523</a>: mpfr dependency</li>
</ul>
<h3>Decimal class changes</h3>
<p><code>rasqal_xsd_decimal_is_zero()</code> now uses <code>fabs()</code>
and an epsilon approach for C99 decimal mode.</p>
<p>Make <code>rasqal_xsd_decimal_compare()</code> work for C99
decimal mode.</p>
<p><code>rasqal_xsd_decimal_compare()</code> and
<code>rasqal_xsd_decimal_equals()</code> use Knuth's approximate
equality as decribed below.
</p>
<h3>Literal class changes</h3>
<p>Return rdf term type string from
<code>rasqal_literal_get_rdf_term_type()</code> for integer subtypes
(<code>RASQAL_LITERAL_INTEGER_SUBTYPE</code>).
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=519">Issue #0000519</a>
(Redland librdf)</p>
<p><code>rasqal_literal_to_result_term()</code> now returns NULL on
an alloc failure.</p>
<p><code>rasqal_new_floating_literal()</code> added, deprecating
<code>rasqal_new_float_literal()</code> and takes the float type
as an argument.
</p>
<h3>Query engine changes</h3>
<p>Fix some wrong data size allocs found by clang in Project
rowsource.</p>
<p>Take more care in promoting literals to float and exceeding the
range; turn them into doubles if that happens.</p>
<p>Floating and double comparisons and equality use a proper epsilon
check using Knuth's approximate comparison approach, rather than =.
Affects
<code>rasqal_literal_as_boolean()</code>,
<code>rasqal_literal_equals()</code>,
<code>rasqal_xsd_decimal_compare()</code>,
<code>rasqal_xsd_decimal_equals()</code>
and other internal methods.
</p>
<h3>Query language changes</h3>
<p>Updated the SPARQL syntax to support <code>integer^^uri-ref</code>.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=519">Issue #0000519</a> (Redland librdf)
</p>
<p>Removed RDQL support as promised. So long and thanks for all the queries.
Use SPARQL instead.
</p>
<h3>Portability changes</h3>
<p>Test for <code>mpfr_snprintf()</code> specifically which appeared
in MPFR 2.4.0.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=523">Issue #0000523</a>
</p>
<p>The Bison minimum version is now 2.0 (from 2004-12-25) until we
hear otherwise.</p>
<p>Use <code>RASQAL_DISABLE_DEPRECATED</code> to flag out deprecated
implementation code. Call gtkdoc-scan with the deprecated guard.
</p>
<p>Use <code>#if defined(RASQAL_DEBUG)</code> to help
portability when it's not defined.</p>
<p>Added good and bad cast macros for checking of type truncation.
Helped remove compiler warnings.</p>
<h3>Configuration changes</h3>
<p>Make <code>configure</code> handle Apple
<code>/usr/bin/flex</code> which adds an extra field so awk
<code>$NF</code> did not work.</p>
<p><code>configure</code> now supports finding UUID support inside
libc for OSX.
</p>
<p>Fix some <code>configure</code> portability with non-POSIX bash
syntax and adding some -W flags to autotool calls.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=506">Issue #0000506</a>
</p>
<p>Updated <code>autogen.sh</code> to abort run if a configuring
program fails, generate NEWS with old timestamp if missing so
automake can run and some small doc and message updates.</p>
<h2 id="rel0_9_29"><a name="rel0_9_29">Rasqal 0.9.29 changes</a></h2>
<p>Rasqal fully supports SPARQL 1.0 from this release. All the
approved tests pass.</p>
<p>Requires <a href="http://librdf.org/raptor/">Raptor</a> 2.0.7 or newer.</p>
<p>RDQL query language support will be removed in the next
release. SPARQL has been available for 4 years and is fully
supported.</p>
<p>Add support for SPARQL 1.1 draft <code>UUID()</code> and
<code>STRUUID()</code>.</p>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=493">0000493</a>: Offset in sub-select results in no rows at all.</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=494">0000494</a>: Temp buffer to small.</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=504">0000504</a>: rasqal_regex_replace() is not public</li>
</ul>
<h3>Datatype changes</h3>
<p>Added a new datatype
<code>rasqal_xsd_date</code> class for XSD with literal enum
<code>RASQAL_LITERAL_DATE</code>, constructor
<code>rasqal_new_xsd_date()</code>, destructor
<code>rasqal_free_xsd_datetime()</code> and core methods
<code>rasqal_xsd_date_to_counted_string()</code>,
<code>rasqal_xsd_date_to_string()</code>
<code>rasqal_xsd_date_equals()</code> (returning incomparible) and
<code>rasqal_xsd_date_compare()</code>.
</p>
<p>The <code>rasqal_xsd_datetime</code> and new date class above both
get the same new fields for comparing datetimes and dates:
<code>time_on_timeline</code> and <code>have_tz</code> to record the
three timezone possibilities: none ('N'), zulu ('Z') or numeric
('Y'). A "time on timeline" value is calculated on construction
and the field values are not normalized.
</p>
<p>Added <code>rasqal_xsd_datetime_equals2</code> deprecating
<code>rasqal_xsd_datetime_equals</code> and returning and
incomparible flag to caller.
</p>
<p>Added <code>rasqal_xsd_datetime_compare2()</code> deprecating
<code>rasqal_xsd_datetime_compare()</code> and returning the
incomparible state between datetimes. The new
<code>rasqal_xsd_date_compare()</code> uses this signature.
</p>
<p>Added new <code>rasqal_new_xsd_datetime_from_xsd_date()</code>
datetime constructor to build a datetime from a date.</p>
<p>Correct the buffer size in
<code>rasqal_xsd_datetime_get_seconds_as_decimal()</code>
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=494">Issue #0000494</a>
</p>
<h3>Graph pattern class changes</h3>
<p>Added <code>rasqal_query_graph_pattern_visit2()</code> deprecating
<code>rasqal_query_graph_pattern_visit()</code>
</p>
<h3>Literal class changes</h3>
<p>Enum <code>rasqal_op</code> gains new tokens
<code>RASQAL_EXPR_UUID</code> and <code>RASQAL_EXPR_STRUUID</code>
for the new SPARQL 1.1 draft <code>UUID()</code> and
<code>STRUUID</code> built-in functions.</p>
<p><code>rasqal_literal_divide()</code> result is now a decimal if
both args are integer - rule from XPath F&O;
</p>
<p>Added support for the XSD:Date datatype with a new
<code>rasqal_literal_type</code> enum value
<code>RASQAL_LITERAL_DATE</code>. Updated the literal code including
the constructor <code>rasqal_new_numeric_literal()</code> to
auto-convert to the internal format as well as the core literal
methods.
</p>
<h3>Query engine changes</h3>
<p>The rules for in-scope variables for <code>FILTER</code> were
corrected to match the SPARQL 1.0 semantics. This fixed the last
remaining failure Rasqal had for the SPARQL 1.0 approved test cases.
</p>
<p><code>DISTINCT</code> now
compares using RDF term comparison not value comparison so now "" is
distinct from ""^^xsd:string. This has a consquence of making RDQL
test B-01 as failing but this is no loss. Relatedly, RDQL support
will be removed in the next release.
</p>
<p>Handle errors found in aggregation expressions following SPARQL
standard.</p>
<p>Fix blank node generation when made in a <code>CONSTRUCT</code> to
match SPARQL standard.
</p>
<p>Make limit and offset check work properly in a subquery.
Fixes
<a href="http://bugs.librdf.org/mantis/view.php?id=493">Issue #0000493</a>
</p>
<p>Added support for executing SPARQL 1.1 draft <code>UUID()</code>
and <code>STRUUID</code> using either libuuid or internal random API
that backs executing <code>RAND()</code>.
</p>
<h3>Resilience changes</h3>
<p>Ran entire SPARQL 1.0 and 1.1 test suite through Rasqal and
valgrind to check for reference loss and memory leaks. Fixed several
issues in newer code.</p>
<p>Fixed several code issues with unused values found by clang. Or
changed code that was correct to make clang moan less.</p>
<p>Add code marking of good and bad type casts using macros
<code>RASQAL_GOOD_CAST</code> and <code>RASQAL_BAD_CAST</code>
macros.</p>
<h3>Other changes</h3>
<p>The <code>configure</code> test for libgcrypt as a digest backend
now works; it really didn't before now. Added option
<code>--with-libgcrypt-config=PATH</code> to allow selecting the path
to the <code>libgcrypt-config</code>. mhash remains the preferred
hash digest library as it provides more digests and is more commonly
available.
</p>
<p><code>configure</code> now looks for libuuid with
<code>pkg-config</code> to back the SPARQL 1.1 UUID generation
support. The UUID backend can be selected with new configure
option <code>--uuid-library=NAME</code></p>
<p>Made <code>rasqal_regex_replace()</code> public with same
signature as the internal API.
Fixes
<a href="http://bugs.librdf.org/mantis/view.php?id=504">Issue #0000504</a>
</p>
<p>The <code>tests/sparql/check-sparql</code> test runner was updated
to understand more of the manifest vocabulary.
</p>
<p>Building from GIT now requires automake 1.11.2+ for the
<code>-Wextra-portability</code> option.
</p>
<p>Added <code>-d none</code> to <code>roqet(1)</code> arguments so
it is possible disable debug output on the command line (default).
</p>
<h2 id="rel0_9_28"><a name="rel0_9_28">Rasqal 0.9.28 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=466">0000466</a>: zero size calloc does not return object (src/rasqal_row.c)</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=467">0000467</a>: Tests fail because diff doesn't accept -u flag</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=470">0000470</a>: snprintf portability issues</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=471">0000471</a>: Compile error when RASQAL_DEBUG set to > 1</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=474">0000474</a>: roqet flags listed in help, but not recognised</li>
</ul>
<h3>SPARQL changes</h3>
<p>The language name '<code>sparql</code>' is now SPARQL 1.1
</p>
<p>Added support for SPARQL 1.1 draft string functions
<code>STRBEFORE()</code>, <code>STRAFTER()</code>
and <code>REPLACE()</code>.
</p>
<h3>Query engine changes</h3>
<p>Add parsing and evaluation support for SPARQL 1.1 draft STRBEFORE
(2 args), STRAFTER (2 args) and REPLACE (3 or 4 args). The
evaluation of REPLACE currently fully works for PCRE regex with
Unicode and works for POSIX regex without Unicode.</p>
<p>Clear <code>errno</code> before calling <code>strtol()</code> and
checking the result. This caused issues when used in threaded
applications, even though Rasqal is not thread-safe.
</p>
<p>The (psuedo) random number generation now can use a variety of
library random routines, defaulting to a new internal
<a href="https://github.com/dajobe/libmtwist">Mersenne Twister implementation - libmtwist</a>.
The choice of PRNG can be made with
<code>configure --with-random-approach=ALGO</code> to pick from
<code>mtwist</code> (the default), <code>gmp</code> (when GMP is
available and used for decimals), <code>random_r()</code>,
<code>rand_r()</code> then the portable but not so safe:
<code>random()</code> and <code>rand()</code>.
</p>
<h3>Expression class changes</h3>
<p>Enum <code>rasqal_op</code> gains new tokens
<code>RASQAL_EXPR_STRBEFORE</code>,
<code>RASQAL_EXPR_STRAFTER</code> and
<code>RASQAL_EXPR_REPLACE</code> for the new SPARQL 1.1 string expressions.
<code>STRBEFORE()</code>, <code>STRAFTER()</code>
and <code>REPLACE()</code> respectively.
</p>
<p>Added <code>rasqal_new_4op_expression()</code> to construct 3/4-arg
expressions.
</p>
<h3>Query format and query result format changes</h3>
<p>Added the
<a href="http://www.w3.org/ns/formats/">W3C Format URIs</a>
to the JSON, XML, CSV and TSV SPARQL result formats. (Nicholas J Humfrey)
</p>
<p>Corrected the SPARQL query output for LIMIT and OFFSET</p>
<p>Handle <code><literal></literal></code> as
empty literal when reading in XML query results.</p>
<h3>Other changes</h3>
<p>Use a more comprehensive <code>configure</code> build and run test
for <code>ceil()</code>, <code>floor()</code> and
<code>round()</code> to prevent GCC optimizing it away and getting
the wrong answer when checking whether to link with -lm
</p>
<p>Removed the obsolete -w option from the <code>roqet --help</code>
message which was removed from code some time ago.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=474">Issue 0000474</a>.
</p>
<p>Prevent a gcc 4K stack size warning in a few tests.
</p>
<p>Reorganized the regex code to a new regex module, adding the new
function <code>rasqal_regex_replace()</code> for regex search and
replace (all) backing SPARQL 1.1 <code>REPLACE()</code></p>
<p>Several internal fixes for compiling with RASQAL_DEBUG > 1
(Lauri Aalto)
Fixes
<a href="http://bugs.librdf.org/mantis/view.php?id=471">Issue #0000471</a>
</p>
<p>Remove several internal uses of <code>snprintf()</code> for simple
integer formatting.
</p>
<p>The check-sparql utility used during 'make check' now sets the
DIFF envariable for check tests to allow use off GNU Diff.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=467">Issue #0000467</a>
(Peter O'Gorman / pogma)
</p>
<p>Code style changes for calling <code>calloc()</code>.</p>
<p>Do not <code>calloc()</code> with 0 count for a result row - not portable.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=466">Issue #0000466</a>
(Peter O'Gorman / pogma)
</p>
<p>The <code>check_query</code> utility (which is still not complete)
can now handle comparing query results when sorting is involved.
</p>
<h2 id="rel0_9_27"><a name="rel0_9_27">Rasqal 0.9.27 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=127">0000127</a>: <code>UNION</code> graph pattern support in query engine</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=423">0000423</a>: SPARQL <code>UNION</code> with shared variables fails</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=434">0000434</a>: <code>OPTIONAL</code> and named graphs don't mix</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=454">0000454</a>: xsd:nonNegativeInteger is parsed as <code>RASQAL_LITERAL_QNAME</code> instead of <code>RASQAL_LITERAL_[INTEGER|UDT|INTEGER_SUBTYPE]</code></li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=459">0000459</a>: Making a query that binds to a variable with the same name as a bnode fails</li>
</ul>
<h3>SPARQL changes</h3>
<p>The parser now supports the optional <code>SILENT</code> keyword
for <code>SERVICE</code>.</p>
<p>The parser now supports the <code>CONSTRUCT WHERE</code>
abbreviation, expanding the WHERE triples into a triple template
with the same triples.
</p>
<h3>Query engine changes</h3>
<p>sub-<code>SELECT</code>s are now supported including those that
contain sorting, grouping, limiting and offset as well as projection.
</p>
<p><code>CONSTRUCT</code> works when working over a query with
optionals. It previously stopped returning results at the first unbound
variable value.</p>
<p><code>OPTIONAL</code>, sub-graph pattern groups
and <code>UNION</code> fully execute correctly. Fixes were made to
the variable scoping and join operations.</p>
<p>A lot of refactoring was done to provide the structure to enable
sub-<code>SELECT</code> to be turned into a query algebra structure
and executed.
</p>
<p>An entirely new variable scoping algorithm was implemented to
properly compute where a variable is assigned; the assumption was
removed that a variable with a given name can only be bound in one
place.
</p>
<p>Several bugs were fixed in the join implementation which affected
the sub-graph pattern grouping (natural join) and optional (left
join).
</p>
<p>Pulled new internal function
<code>rasqal_query_results_formatter_get_read_rowsource()</code> out
of <code>rasqal_service_execute()</code> to provide the structure for
executing <code>SERVICE</code> queries in the query engine.
</p>
<h3>Literal class changes</h3>
<p><code>rasqal_new_numeric_literal_from_long()</code> added to make an
integer or decimal literal depending if it fits in range.
</p>
<p><code>rasqal_xsd_decimal_get_long()</code> added to convert an
arbitrary precision decimal to a C long with an overflow error flag.
</p>
<p>xsd:integer subtypes are stored and printed correctly.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=454">Issue #0000454</a>.
</p>
<h3>Query class changes</h3>
<p><code>rasqal_query_get_distinct()</code> added to get the distinct
flag from <code>SELECT DISTINCT ...</code> queries.
</p>
<p><code>rasqal_query_set_wildcard()</code> added to set the '*' flag
for <code>SELECT *</code> queries
</p>
<p><code>rasqal_query_has_variable2()</code> added with variable type
arg deprecating <code>rasqal_query_has_variable()</code>. Note the
warning about using <code>RASQAL_VARIABLE_TYPE_UNKNOWN</code> is
ambiguous.
</p>
<p>Deprecated <code>rasqal_query_has_variable()</code> for the
above. Lookup by any type.</p>
<p><code>rasqal_query_set_variable2()</code> added with type arg
deprecating <code>rasqal_query_set_variable()</code>. Note the
warning about using <code>RASQAL_VARIABLE_TYPE_UNKNOWN</code> is
ambiguous.
</p>
<p>Deprecated <code>rasqal_query_set_variable()</code> for above.
Lookup by any type.</p>
<h3>Query result format changes</h3>
<p>The CSV and TSV query result formats (names <code>csv</code>
and <code>tsv</code> respectively) were altered to match the editor's draft
<a href="http://www.w3.org/2009/sparql/docs/csv-tsv-results/results-csv-tsv.html">SPARQL 1.1 Query Results CSV and TSV Formats</a>
which includes no header line, no result number and implementing
the specified quoting and end of lines in the specification.
</p>
<h3>Variable class changes</h3>
<p><code>rasqal_variables_table_add_variable()</code> added to add an
existing variable to a variables table.
</p>
<p><code>rasqal_variables_table_get_by_name()</code> added with
variable type arg.</p>
<p><code>rasqal_variables_table_contains()</code> added to check
if a variable with the given type and name is in the variables table.
</p>
<h3><code>roqet(1)</code> utility changes</h3>
<p>Correctly order the help so the <code>-d/--dump-query</code> value
list appears after the option description.
</p>
<h3>Porting changes</h3>
<p>Several patches were made to aid compiling on MS Windows were
applied based on those made by the
<a href="http://techbase.kde.org/Getting_Started/Build/Windows/emerge">KDE Emerge scripts to build KDE on windows</a>.
This includes a native replacement for the missing gettimeofday()
and timegm() functions. MS Windows remains an unsupported target.
</p>
<h3>Other changes</h3>
<p>The minimum Raptor version needed is now 2.0.4
for the <code>raptor_bnodeid_ntriples_write()</code> function.
</p>
<p>The test runner was fixed to fail the suite when there are
failures as well as expected failures.
</p>
<p>Code style change and cleanup for alloc/free macros. New code style:</p>
<ol>
<li><code>var = RASQAL_CALLOC(type, nmem, size)</code><br />
Prefering:<br />
<code>var = RASQAL_CALLOC(type, 1, sizeof(*var))</code><br />
when nmem = 1</li>
<li><code>var = RASQAL_CALLOC(type, size)</code></li>
<li><code>RASQAL_FREE(type, var)</code></li>
</ol>
<p>The consequence here is allocs that mostly fit into 1 line without
so much boilerplate and duplication of types. The
<code>RASQAL_MALLOC</code> and <code>RASQAL_CALLOC</code> macros now
do the cast to the return type. <code>RASQAL_FREE</code> takes the
object type too but always casts arg to void This
</p>
<p>Code style change for allocating strings:</p>
<ol>
<li><code>len = strlen(); malloc(..., len + 1)</code></li>
<li>and <code>memcmp(..., len + 1)</code></li>
</ol>
<p>Expanded GCC warnings to take advantage of newer analysis which
found several issues:</p>
<ul>
<li>Use of int for storing string and buffer lengths: replaced many
internal uses with the correct size_t for length computations.</li>
<li>Use of int for storing time: replaced with time_t that may be
larger</li>
<li>Use of <code>void*</code> for pointer differences: replaced
with <code>ptrdiff_t</code> where necessary.</li>
<li>Precision truncation between int and long, size_t.</li>
<li>Precision truncation between float and double.</li>
</ul>
<p>Made several internal functions to improve the above. There
remain some int / size_t errors in the public API that will need new
API functions to properly fix for 64-bit machines dealing with
strings more than >32bits in length; which should be rare.
</p>
<p>Reduced Rasqal's call stack size by ensuring all I/O buffers are
dynamically allocated.
</p>
<p><code>configure</code> now always checks for where <code>ceil()</code>,
<code>floor()</code> and <code>round()</code> can be found: in libc
or libm.
</p>
<p>The <code>configure</code> default
for <code>--enable-maintainer-mode</code> no longer enables the
debugging symbols. These can be added
with <code>--enable-debug</code>
</p>
<p>The <code>configure</code> gains an option
<code>--with-gmp=</code><em>PATH</em> to set the installation path
of the
<a href="http://gmplib.org/">GNU Multiple Precision Arithmetic Library (GMP)</a>
if it is not in the standard lib/include prefix.
</p>
<h2 id="rel0_9_26"><a name="rel0_9_26">Rasqal 0.9.26 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=430">Issue #0000430</a>: Incorrect HTML generated with unknown literal types</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=431">Issue #0000431</a>: Only a limited number of literal datatypes are displayable in a HTML format.</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=436">Issue #0000436</a>: queries involving calculations with large numbers return incorrect results unless scientific notation is used</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=438">Issue #0000438</a>: timegm not available on solaris</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=439">Issue #0000439</a>: warning when variable is not selected makes 4store tests to fail</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=446">Issue #0000446</a>: rasqal may require -lm for floor, ceil, round on some systems and architectures</li>
</ul>
<h3>SPARQL 1.1 Query draft language changes</h3>
<p>Added support for SPARQL 1.1 message digest functions
<code>MD5()</code>, <code>SHA1()</code>, <code>SHA224()</code>,
<code>SHA256()</code>, <code>SHA384()</code> and <code>SHA512()</code></p>
<h3>Query engine changes</h3>
<p>Many internal query engine changes to more accuractly compute
variable scope, use and binding to better support more complex
queries with scopes such as <code>UNION</code> (now mostly working)
and sub-<code>SELECT</code> (execution is not yet supported).
</p>
<p>Added <code>rasqal_world_set_warning_level()</code> to set the
query warning level in the 0...100 range where 0 is no warnings, 50
is the default and 100 is all warnings.
</p>
<p>Query errors now fail with regular errors not fatal errors that
<code>abort()</code>. Query parsing errors are not work killing the
process. Also adjusted some error paths to prevent reporting 2
errors at once.
</p>
<p><code>rasqal_op</code> enumeration gains values
<code>RASQAL_EXPR_MD5</code>, <code>RASQAL_EXPR_SHA1</code>,
<code>RASQAL_EXPR_SHA224</code>, <code>RASQAL_EXPR_SHA256</code>,
<code>RASQAL_EXPR_SHA384</code> and <code>RASQAL_EXPR_SHA512</code>
for message digest expressions corresponding to SPARQL 1.1 message
digest functions.
</p>
<p>Added message digest support either built with internal MD5 and
SHA1 which are always available, or with libmhash which provides the
full list of message digests that SPARQL 1.1 requires (and is
optimized).
</p>
<p>Make <code>ROUND()</code> work with XSD Decimal when compiled
against <a href="http://gmplib.org/">GNU MP</a>.
</p>
<p>Check for overflow when converting a string to int and if
resulting long won't fit in an int, turn it into a decimal.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=436">Issue #0000436</a>.
</p>
<p>Removed Query Engine V1 that was long disabled.
<code>configure</code> loses
the <code>--with-query-engine-version</code> option.
</p>
<h3>Query results formatter class changes</h3>
<p>Fixed HTML query results generating invalid HTML.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=430">Issue #0000430</a>
</p>
<p>Support writing additional literal types in HTML query results.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=431">Issue #0000431</a>
</p>
<p>The JSON query result format now accepts the
<code>application/sparql-results+json</code> mime type, as specified
in the
<a href="http://www.w3.org/TR/rdf-sparql-json-res/">Serializing SPARQL Query Results in JSON</a>
W3C WG Note.
</p>
<h3><code>roqet(1)</code> utility changes</h3>
<p>Added options <code>-W</code>
/ <code>--warnings</code> <em>level</em> (default 50) to set the
warning level and <code>-E</code> to ignore errors.
</p>
<h3>Other changes</h3>
<p><code>configure</code> gains a <code>--enable-debug</code> option
to enable or disable the debugging messages. Useful for when
building using <code>autogen.sh</code> from GIT.
</p>
<p>Removed internal test/debug 'redland' triples store that has not
worked for some time. Removed the <code>--with-triples-source</code>
and <code>--with-redland-config</code> options from <code>configure</code>.
</p>
<p>Add a portable version of <code>timegm()</code> when it is not
present in the system (such as Solaris).
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=438">Issue #0000438</a>.
</p>
<p>Added <code>configure</code> tests
for <code>ceil()</code>, <code>floor()</code>
and <code>round()</code> that look for them in libc or libm.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=446">Issue #0000446</a>.
</p>
<p>Fixed up several code paths with problems found
by <a href="http://clang.llvm.org/">clang</a>, mostly unused
variables, unnecessary calculations but a couple of bad accesses.
</p>
<h2 id="rel0_9_25"><a name="rel0_9_25">Rasqal 0.9.25 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=421">Issue #0000421</a>: Use raptor_syntax_description_validate() to validate Query Results formats</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=427">Issue #0000427</a>: INSERT/DELETE with """ quoting doesn't quite work</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=428">Issue #0000428</a>: @lang doesn't work with """:</li>
</ul>
<h3>SPARQL 1.1 Query draft language changes</h3>
<p>Added support for SPARQL 1.1 numeric functions <code>ABS()</code>,
<code>ROUND()</code>, <code>CEIL()</code> and <code>FLOOR()</code>.
</p>
<p>Added support for SPARQL 1.1 <code>BIND(expr as ?var)</code>
using existing <code>RASQAL_GRAPH_PATTERN_OPERATOR_LET</code>.
</p>
<p>Added support for SPARQL 1.1 <code>CLEAR</code> and
<code>DROP</code> to use optional <code>SILENT</code> keyword.
</p>
<p>Added support for SPARQL 1.1 <code>RAND()</code> along with a
query API feature for user setting of the random seed.</p>
<p>Added support for SPARQL 1.1 TZ()</p>
<p>Fixed SPARQL 1.1 <code>ENCODE_FOR_URI()</code> to not preserve
language and datatype of input.
</p>
<p>Fixed support for SPARQL 1.1 <code>BNODE()</code> to work with no
argument given.
</p>
<p>Fixed SPARQL 1.1 <code>GROUP BY</code> to allow an optional
<code>AS ?var</code>.
</p>
<p>Fixed support for """-quoted and '''-quoted strings not over-quoting
and adding support for optional language.
Fixes
<a href="http://bugs.librdf.org/mantis/view.php?id=427">Issue #0000427</a>
and
<a href="http://bugs.librdf.org/mantis/view.php?id=428">Issue #0000428</a>.
</p>
<h3>DateTime class changes</h3>
<p>Added <code>rasqal_xsd_datetime_get_tz_as_counted_string()</code>
to get back the timezone string component of a datetime.
</p>
<h3>Datatype class changes</h3>
<p><code>rasqal_xsd_format_double()</code> now correctly formats
numbers that have no trailing 0s.
</p>
<h3>Decimal class changes</h3>
<p>Added <code>rasqal_xsd_decimal_abs()</code>,
<code>rasqal_xsd_decimal_round()</code>,
<code>rasqal_xsd_decimal_ceil()</code> and
<code>rasqal_xsd_decimal_floor()</code> to support the ABS(),
ROUND(), CEIL() and FLOOR() functions for decimals.
</p>
<h3>Expression class changes</h3>
<p>rasqal_op gains
<code>RASQAL_EXPR_ABS</code>,
<code>RASQAL_EXPR_ROUND</code>,
<code>RASQAL_EXPR_CEIL</code> and
<code>RASQAL_EXPR_FLOOR</code> for numeric operations,
<code>RASQAL_EXPR_RAND</code> for SPARQL 1.1 <code>RAND()</code>
and <code>RASQAL_EXPR_TZ</code> for SPARQL 1.1 TZ() timezone accessor.
</p>
<p>Added an evaluation context structure
<code>rasqal_evaluation_context</code> for the information needed to
evaluate any <code>rasqal_expression</code> tree. This makes
expression evaluation independent of a query, but still tied to a
rasqal world and (via variables) a variables table. Added constructor
<code>rasqal_new_evaluation_context()</code> to set the locator and
flags, destructor <code>rasqal_free_evaluation_context()</code>,
method <code>rasqal_evaluation_context_set_base_uri()</code> to
set/reset the shared reference to the context base URI
and method <code>rasqal_evaluation_context_set_rand_seed()</code>
to set the random seed for the evaluation.
</p>
<p>Added <code>rasqal_expression_evaluate2()</code> taking just an
expression and an evaluation context.
</p>
<p><code>rasqal_expression_evaluate()</code> is deprecated for the
above.
</p>
<p>Added new method
<code>rasqal_xsd_datetime_get_tz_as_counted_string()</code> for
executing <code>RASQAL_EXPR_TZ</code> for SPARQL 1.1 TZ().
</p>
<h3>Query Engine changes</h3>
<p>Initialise seed for RAND() from either a mixture of system sources
or from a value set by user. The user value can be set with new
query feature <code>RASQAL_FEATURE_RAND_SEED</code>. Uses
<code>rasqal_evaluation_context_set_rand_seed()</code> on the query's
internal evaluation context.
</p>
<p>Enable <code>rasqal_query_set_store_results()</code> to actually
work after a query prepare.
</p>
<p>Handle evaluation of <code>FILTER</code> over an empty inner graph
pattern such as in a query like <code>ASK WHERE { FILTER ( TRUE ) }</code>
</p>
<p>Ignore errors in executing SPARQL 1.1 project expression
<code>AS</code> variables.
</p>
<p>Update <code>rasqal_literal_as_boolean()</code>,
<code>rasqal_literal_as_integer</code> and
<code>rasqal_literal_as_floating</code> when evaluating NULL to
return a type error not an assertion failure or abort (in debug
mode).
</p>
<p>Change internal error handling to separate a NULL return from an
error return when evaluating expressions. Updated lots of callers of
expression evaluation to handle a NULL expression response. Needed
since now NULL is a valid expression evalution in some cases; like
STRLANG() on non-simple literals.
</p>
<p>Updated to use <code>rasqal_evaluation_context</code> for
expression evaluation.
</p>
<p>Handle support executing empty graph patterns such as in queries
like <code>SELECT (expr AS ?var) WHERE {}</code> which just evaluates
<code>expr</code> and returns a single row with a single result.
</p>
<h3>Query Result Formatter class changes</h3>
<p>Handle NULL values for RDF and Tables results.
</p>
<h3>Other changes</h3>
<p>Added <code>rasqal_world_get_query_language_description()</code>
to get a description of a query language replacing and deprecating
<code>rasqal_languages_enumerate()</code>.
</p>
<p>More fixes to check-query test script.
</p>
<p>Make GPL V2 or newer explicit in LICENSE.html.
</p>
<h2 id="rel0_9_24"><a name="rel0_9_24">Rasqal 0.9.24 Changes</a></h2>
<h3>SPARQL 1.1 Update draft Language changes</h3>
<p>Added support for <code>CLEAR</code> and <code>DROP</code>
applying to more than one graph. The options are now: just default
graph with <code>DEFAULT</code>, all named graphs with
<code>NAMED</code> and all graphs with <code>ALL</code>.
</p>
<p>Added support for optional <code>SILENT</code> flag before most
update operations.
</p>
<p>Added support for <code>ADD</code>, <code>MOVE</code> and
<code>COPY</code> operations which both operate between two graphs -
either named or default. The source graph is stored in the update
structure <code>graph_uri</code> field and the destination graph in
the <code>document_uri</code> field; the names have no meaning here
since both are graphs and a NULL value signifies the default graph.
</p>
<p>Added support for <code>DELETE WHERE {}</code> writing the triple
results into the <code>delete_templates</code> field of the update
structure.
</p>
<p>Added support for multiple update operations in one 'query'
separated by ';'.
</p>
<p><code>GROUP_CONCAT()</code> now sets the
<code>RASQAL_EXPR_FLAG_AGGREGATE</code> rasqal_expression flag
like the other builtin aggregate expressions.
</p>
<h3>Query Engine changes</h3>
<p>Fixed a few memory leaks in aggregate operation with
<code>GROUP</code> and with <code>HAVING</code>.
</p>
<h3>Literal API changes</h3>
<p>Fixed a memory leak with datetime literals.
</p>
<h3>Update API changes</h3>
<p><code>rasqal_update_type</code> gains new enum values
<code>RASQAL_UPDATE_TYPE_ADD</code>,
<code>RASQAL_UPDATE_TYPE_MOVE</code> and
<code>RASQAL_UPDATE_TYPE_COPY</code> for the SPARQL 1.1 Update ADD,
MOVE and COPY operations respectively.