forked from dajobe/rasqal
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathRELEASE.html
5197 lines (3865 loc) · 179 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_34"><a name="rel0_9_34">Rasqal 0.9.34 changes</a></h2>
<p>Not yet released.
</p>
<h2 id="rel0_9_33"><a name="rel0_9_33">Rasqal 0.9.33 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=546">0000546</a>: Can't take query from URI when using -p</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=568">0000568</a>: Filter expression with division does not work</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=583">0000583</a>: CONSTRUCT halts at a template triple with unbound variable</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=588">0000588</a>: roqet: select from SERVICE returns all NULLs</li>
</ul>
<h3>SPARQL changes</h3>
<p>Fixed <code>BASE</code> to override any API base URI.</p>
<h3>Datetime class changes</h3>
<p>Fixed storing timezone minutes correctly.</p>
<h3>Graph pattern class changes</h3>
<p>Added new getter functions
<code>rasqal_graph_pattern_get_triples()</code>,
<code>rasqal_literal_get_type()</code>
and <code>rasqal_literal_get_language()</code>
from <a href="https://github.com/dajobe/rasqal/pull/1">Pull Request #1</a>
by Cosmin Basca. Thanks.
</p>
<h3>Query engine changes</h3>
<p>Fixed the aggregation total evaluation of <code>AVG</code>.</p>
<p>Fixed <code>STRBEFORE</code> and <code>STRAFTER</code> evaluation
to match languages if present and add the needle language to the
result.</p>
<p>Fixed <code>CONCAT()</code> evaluation to return the correct types
and languages.</p>
<p>Sorting now uses sort utility function
<code>raptor_sort_r()</code> with context args provided by Raptor
2.0.15+ or an internal simple (not so performant) replacement, if too
old.</p>
<h3>Query result formatter changes</h3>
<p>Can write variable bindings query results in <a href="http://contextknowledgesystems.org/CKS.html">mKR relation</a> CSV format.
Patch by Richard H. McCullough.</p>
<h3>Query result class changes</h3>
<p>Made internal changes to support reading and writing boolean
result formats. That means
<code>rasqal_query_results_formatter_read()</code> may now return
boolean results if the formatter supports it, such as SPARQL XML.
</p>
<p>Added <code>rasqal_new_query_results_from_string()</code> to make
a query results from a string (with optional length). The results
format is guessed from the input data - base_uri and string content
using <code>rasqal_world_guess_query_results_format_name()</code>.
</p>
<p>Added <code>rasqal_query_results_formats_check2()</code>
deprecating <code>rasqal_query_results_formats_check()</code>.
The API change is due to the return value; the result is now
non-0 if the format exists.
</p>
<p>Added <code>rasqal_new_query_results2()</code> deprecating
<code>rasqal_new_query_results()</code> removing the now
ignored <code>vars_table</code> parameter. A query result
now manages it's own variables table.</p>
<h3>Results class changes</h3>
<p>Fixed returning the correct variables count for reading SPARQL XML
results sets. This caused some queries to fail if the projected
variables count did not match the count in the result set.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=588">Issue #0000588</a>
</p>
<h3>Variables table class changes</h3>
<p>Added <code>rasqal_variables_table_add2()</code> deprecating
<code>rasqal_variables_table_add()</code>. This takes a more
sensible argument style with copying the input parameters name and
value, and allowing name length to be optionally given. This results
in smaller calling code and better ownership semantics.
</p>
<h3>Utility changes</h3>
<p><code>roqet(1)</code> now supports using a URI or local file to
send to a SPARQL protocol service URI.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=546">Issue #0000546</a>
</p>
<h3>Other changes</h3>
<p>Fixes to make Rasqal build in Travis CI, testing against newest
and oldest raptors.</p>
<p>Use <code>__FUNCTION__</code> (c99) replacing
<code>__func__</code> (c90) in debug macros.</p>
<p>Fixes in
<a href="https://github.com/dajobe/rasqal/pull/3">Pull Request #3</a>
for building with icc from Sebastian Freundt. Thanks.</p>
<p>Many code quality fixes from clang and coverity primarily in error
path cleanups (out of memory cases) and dead code.</p>
<p>Updated the fix-flex and fix-bison scripts to remove dead
code that clang and coverity complain about.</p>
<p>Added new C testrunner utility to run the tests to eventually
replace the (perl) improve and check-sparql scripts.
</p>
<p>Fixed some API changelog mistakes.</p>
<p>Updated gcc / clang warning args used (-Wxxxx) and made multiple
minor code fixes such as replacing %d with %u in debug messages or
adding missing default: to switches even when all cases were
covered.</p>
<p>Added many more internal casts to make -Wconversion happier when
enabled.</p>
<h2 id="rel0_9_32"><a name="rel0_9_32">Rasqal 0.9.32 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=558">0000558</a>: sparql11-update causes fallback to sparql10</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=560">0000560</a>: "--with-pcre-config" documented but not supported</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=561">0000561</a>: 'make check' fails; possibly because raptor2 built in separate directory</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=564">0000564</a>: Rasqal fails with linker error for armv7 cross-compilation: duplicate symbol _main</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=567">0000567</a>: Segfault based on documentation recommendation</li>
</ul>
<h3>SPARQL changes</h3>
<p>Fixed the SPARQL 1.0 and SPARQL 1.1 syntax feature checking so
that language <code>sparql11-update</code> allows all SPARQL 1.1
syntax features to be used.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=558">Issue #0000558</a>
</p>
<p>Updated the SPARQL parser to use and require Bison 3.0 (for
maintainer, building from GIT sources).
</p>
<p>Updated the SPARQL lexer for Bison 3.0.
</p>
<h3>API changes</h3>
<p>Made <code>rasqal_new_query()</code> match the documentation in
accepting a <code>NULL</code> name.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=567">Issue #0000567</a>
</p>
<h3>Configuration changes</h3>
<p>Make ossp work as a UUID library option.
<code>--with-uuid-library=ossp</code> and automatic discovery of ossp
UUID now work. Fixed the inclusion of OSSP's uuid.h header.</p>
<p>Fix the searching for the pcre-config and libgcrypt-config
configuration utilities. This probably never worked unless the
envariables form (<code>PCRE_CONFIG</code> and
<code>LIBGCRYPT_CONFIG</code>) were set.
</p>
<p>Added a new internal <code>to-ntriples</code> utility to remove all
use of <code>rapper(1)</code> so that the raptor utilities do not
need to be available for running tests with 'make check'.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=561">Issue #0000561</a>
</p>
<p>Make <code>--with-libgcrypt-config</code> work.
</p>
<p>Make <code>--with-pcre-config</code> work.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=560">Issue# 0000560</a>
</p>
<p>Fix noisy mhash_dir addition error; it was always added the cflags
and includes even when mhash_dir was blank.</p>
<p>Improve raptor missing / too old error message.</p>
<h3>Other changes</h3>
<p>Mention libmtwist near <code>--with-random-approach.</code>
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=561">Issue #0000561</a>
</p>
<h3>Internal changes</h3>
<p>Add more STANDALONE if/ifndef STANDALONE blocks around internal
code or functions used in tests.</p>
<p>Make <code>rasqal_xsd_check_double_format()</code> an internal
non-static symbol.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=564">Issue #0000564</a>
</p>
<h2 id="rel0_9_31"><a name="rel0_9_31">Rasqal 0.9.31 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=527">0000527</a>: segmentation fault in roqet when making a SPARQL SERVICE query that returns an HTTP error</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=536">0000536</a>: configure accepts bogus values for --with-xml2-config</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=537">0000537</a>: configure pkg-config checks not overridable</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=538">0000538</a>: work around MSVC 2008's inexcusable lack of stdint.h header</li>
<li><a href="http://bugs.librdf.org/mantis/view.php?id=539">0000539</a>: win32_rasqal_config.h doesn't work on MSVC2008</li>
</ul>
<h3><code>roqet(1)</code> utility changes</h3>
<p><code>roqet(1)</code> gains a new operating mode: reading query
result files in a given format and generating them in different
format. This means it can be used to convert result formats.
Use this mode with the <code>-t RESULT-FILE</code> major option
and <code>-R INPUT-RESULT-FORMAT</code> to set the input format.
<code>-r OUTPUT-RESULT-FORMAT</code> can be used to set the output
format.</p>
<pre>
# Convert a SPARQL TSV result to XML
$ roqet -t result.tsv -R tsv -r xml
# Convert a SPARQL XML result (default input format) to TSV
$ roqet -t result.srx -r tsv
</pre>
<p>Tidied and improved the help and error messages.</p>
<p>The utility now supports <code>-r simple</code> / <code>--results
simple</code> as it says in the documentation.</p>
<p>The debug result format now prints 'row:' when writing. (This
format has always promised it may change).</p>
<h3>Query result changes</h3>
<p>Added support for reading the
<a href="http://www.w3.org/TR/2013/REC-sparql11-results-csv-tsv-20130321/">SPARQL 1.1 Query Results CSV and TSV Formats</a>
W3C Recommendation, 21 March 2013. Writing support already existed.
This is a modular addition so the APIs that handle reading results
automatically get this support.</p>
<p>Added <code>rasqal_query_results_type_label()</code> to get a
string label for a <code>rasqal_query_results_type</code>.</p>
<h3>Query engine changes</h3>
<p>Internal work to support executing the SERVICE graph pattern.</p>
<p>Query engine can execute the new <code>VALUES</code> graph
pattern.</p>
<p>SPARQL lexer and parser handles <code>VALUES</code> replacing the
old <code>BINDINGS</code> syntax.</p>
<p>Fixed crash when a SERVICE returns no rowsource.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=527">Issue #0000527</a>
</p>
<p>Added proper validation of xsd:double and xsd:float literal format.</p>
<p>Correctly handle <code>GROUP BY</code> over no data - returning
one row with all bindings missing.</p>
<p>Literal languages are now normalized to lowercase (RDF Concepts)</p>
<h3>API changes</h3>
<p><code>rasqal_prefix_id()</code> now uses a q rather than _ to help
raptor N-Triples 2008 conformance.</p>
<p>Improved SPARQL 1.1 query formatter to handle <code>VALUES</code>
forms and to print in a prettier form with better indenting.</p>
<p><code>rasqal_graph_pattern_op</code> gains
<code>RASQAL_GRAPH_PATTERN_OPERATOR_VALUES</code></p>
<p><code>rasqal_new_rowsource_from_handler()</code> now allows a NULL
query so that rowsources can be fully independent of a query, such as
when building from a syntax string or other independent object.</p>
<p><code>rasqal_new_rowsequence_rowsource()</code> now allows an empty
sequence of rows.</p>
<h3>Portability changes</h3>
<p>Win32 build fix patches from Michael Stahl:
Fixes Issues
<a href="http://bugs.librdf.org/mantis/view.php?id=539">#0000539</a>
and
<a href="http://bugs.librdf.org/mantis/view.php?id=538">#0000538</a>
</p>
<h3>Configuration and build changes</h3>
<p>Added new internal convienience library
<a href="https://github.com/dajobe/libsv">libsv</a>
providing support for reading CSV and TSV files (and others
potentially). Required for the updated support for reading SPARQL
CSV and TSV result formats.
</p>
<p>Added new librasqalcmdline convienience library to share code
between <code>roqet(1)</code> and <code>check-query</code> (under
development, not installed).</p>
<p>Build internal libmtwist, libgetopt (new) as libtool convienience
libraries to stop automake moans about subdir-objects.</p>
<p><code>configure</code> was fixed to correctly find and use OSSP
libuuid even in the presence of half installed / broken UUID systems
like on OSX where just the headers are present.</p>
<p>Fixes for building with parallel make such as <code>make -jN</code></p>
<p>Fixed alignments and error paths found via clang.</p>
<p><code>configure</code> now uses PKG_CHECK_MODULES() to enable
overriding discovery of pkg-config if needed.
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=537">Issue #0000537</a>
</p>
<p>Fix crash if <code>xml2-config(1)</code> when pointed at a non
executable file. Patch from Michael Stahl
Fixes <a href="http://bugs.librdf.org/mantis/view.php?id=536">Issue #0000536</a>
</p>
<p><code>configure</code> ensures CPPFLAGS can be passed through
without destruction. This helps
<a href="https://wiki.debian.org/Hardening">Debian hardening</a>
</p>
<p>Removed the need for Perl XML::DOM to be installed in order for
'make test' to run via <code>check-sparql</code>. This requires
the <code>roqet(1)</code> new '-'t mode.
</p>
<p>Add a <code>configure</code> check for the debugging
<code>__func__</code> so that on systems where it does not exist the
debug macros work. It may or may not be a macro, so it cannot be
tested with #ifdef in the CPP.</p>
<p>Improved the <code>configure</code> check for Flex to allow it to
be missing for non-maintainer mode.</p>
<h3>Other changes</h3>
<p>Flex code generation updates - now recommend flex 2.5.36.</p>
<p>Fixes in tests data for N-Triples conformance that is checked by
newer Raptor.</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