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
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3146
3147
3148
3149
3150
3151
3152
3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
3311
3312
3313
3314
3315
3316
3317
3318
3319
3320
3321
3322
3323
3324
3325
3326
3327
3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
3384
3385
3386
3387
3388
3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
3403
3404
3405
3406
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420
3421
3422
3423
3424
3425
3426
3427
3428
3429
3430
3431
3432
3433
3434
3435
3436
3437
3438
3439
3440
3441
3442
3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
3501
3502
3503
3504
3505
3506
3507
3508
3509
3510
3511
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529
3530
3531
3532
3533
3534
3535
3536
3537
3538
3539
3540
3541
3542
3543
3544
3545
3546
3547
3548
3549
3550
3551
3552
3553
3554
3555
3556
3557
3558
3559
3560
3561
3562
3563
3564
3565
3566
3567
3568
3569
3570
3571
3572
3573
3574
3575
3576
3577
3578
3579
3580
3581
3582
3583
3584
3585
3586
3587
3588
3589
3590
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
3606
3607
3608
3609
3610
3611
3612
3613
3614
3615
3616
3617
3618
3619
3620
3621
3622
3623
3624
3625
3626
3627
3628
3629
3630
3631
3632
3633
3634
3635
3636
3637
3638
3639
3640
3641
3642
3643
3644
3645
3646
3647
3648
3649
3650
3651
3652
3653
3654
3655
3656
3657
3658
3659
3660
3661
3662
3663
3664
3665
3666
3667
3668
3669
3670
3671
3672
3673
3674
3675
3676
3677
3678
3679
3680
3681
3682
3683
3684
3685
3686
3687
3688
3689
3690
3691
3692
3693
3694
3695
3696
3697
3698
3699
3700
3701
3702
3703
3704
3705
3706
3707
3708
3709
3710
3711
3712
3713
3714
3715
3716
3717
3718
3719
3720
3721
3722
3723
3724
3725
3726
3727
3728
3729
3730
3731
3732
3733
3734
3735
3736
3737
3738
3739
3740
3741
3742
3743
3744
3745
3746
3747
3748
3749
3750
3751
3752
3753
3754
3755
3756
3757
3758
3759
3760
3761
3762
3763
3764
3765
3766
3767
3768
3769
3770
3771
3772
3773
3774
3775
3776
3777
3778
3779
3780
3781
3782
3783
3784
3785
3786
3787
3788
3789
3790
3791
3792
3793
3794
3795
3796
3797
3798
3799
3800
3801
3802
3803
3804
3805
3806
3807
3808
3809
3810
3811
3812
3813
3814
3815
3816
3817
3818
3819
3820
3821
3822
3823
3824
3825
3826
3827
3828
3829
3830
3831
3832
3833
3834
3835
3836
3837
3838
3839
3840
3841
3842
3843
3844
3845
3846
3847
3848
3849
3850
3851
3852
3853
3854
3855
3856
3857
3858
3859
3860
3861
3862
3863
3864
3865
3866
3867
3868
3869
3870
3871
3872
3873
3874
3875
3876
3877
3878
3879
3880
3881
3882
3883
3884
3885
3886
3887
3888
3889
3890
3891
3892
3893
3894
3895
3896
3897
3898
3899
3900
3901
3902
3903
3904
3905
3906
3907
3908
3909
3910
3911
3912
3913
3914
3915
3916
3917
3918
3919
3920
3921
3922
3923
3924
3925
3926
3927
3928
3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
3939
3940
3941
3942
3943
3944
3945
3946
3947
3948
3949
3950
3951
3952
3953
3954
3955
3956
3957
3958
3959
3960
3961
3962
3963
3964
3965
3966
3967
3968
3969
3970
3971
3972
3973
3974
3975
3976
3977
3978
3979
3980
3981
3982
3983
3984
3985
3986
3987
3988
3989
3990
3991
3992
3993
3994
3995
3996
3997
3998
3999
4000
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
4024
4025
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036
4037
4038
4039
4040
4041
4042
4043
4044
4045
4046
4047
4048
4049
4050
4051
4052
4053
4054
4055
4056
4057
4058
4059
4060
4061
4062
4063
4064
4065
4066
4067
4068
4069
4070
4071
4072
4073
4074
4075
4076
4077
4078
4079
4080
4081
4082
4083
4084
4085
4086
4087
4088
4089
4090
4091
4092
4093
4094
4095
4096
4097
4098
4099
4100
4101
4102
4103
4104
4105
4106
4107
4108
4109
4110
4111
4112
4113
4114
4115
4116
4117
4118
4119
4120
4121
4122
4123
4124
4125
4126
4127
4128
4129
4130
4131
4132
4133
4134
4135
4136
4137
4138
4139
4140
4141
4142
4143
4144
4145
4146
4147
4148
4149
4150
4151
4152
4153
4154
4155
4156
4157
4158
4159
4160
4161
4162
4163
4164
4165
4166
4167
4168
4169
4170
4171
4172
4173
4174
4175
4176
4177
4178
4179
4180
4181
4182
4183
4184
4185
4186
4187
4188
4189
4190
4191
4192
4193
4194
4195
4196
4197
4198
4199
4200
4201
4202
4203
4204
4205
4206
4207
4208
4209
4210
4211
4212
4213
4214
4215
4216
4217
4218
4219
4220
4221
4222
4223
4224
4225
4226
4227
4228
4229
4230
4231
4232
4233
4234
4235
4236
4237
4238
4239
4240
4241
4242
4243
4244
4245
4246
4247
4248
4249
4250
4251
4252
4253
4254
4255
4256
4257
4258
4259
4260
4261
4262
4263
4264
4265
4266
4267
4268
4269
4270
4271
4272
4273
4274
4275
4276
4277
4278
4279
4280
4281
4282
4283
4284
4285
4286
4287
4288
4289
4290
4291
4292
4293
4294
4295
4296
4297
4298
4299
4300
4301
4302
4303
4304
4305
4306
4307
4308
4309
4310
4311
4312
4313
4314
4315
4316
4317
4318
4319
4320
4321
4322
4323
4324
4325
4326
4327
4328
4329
4330
4331
4332
4333
4334
4335
4336
4337
4338
4339
4340
4341
4342
4343
4344
4345
4346
4347
4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
4362
4363
4364
4365
4366
4367
4368
4369
4370
4371
4372
4373
4374
4375
4376
4377
4378
4379
4380
4381
4382
4383
4384
4385
4386
4387
4388
4389
4390
4391
4392
4393
4394
4395
4396
4397
4398
4399
4400
4401
4402
4403
4404
4405
4406
4407
4408
4409
4410
4411
4412
4413
4414
4415
4416
4417
4418
4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
4433
4434
4435
4436
4437
4438
4439
4440
4441
4442
4443
4444
4445
4446
4447
4448
4449
4450
4451
4452
4453
4454
4455
4456
4457
4458
4459
4460
4461
4462
4463
4464
4465
4466
4467
4468
4469
4470
4471
4472
4473
4474
4475
4476
4477
4478
4479
4480
4481
4482
4483
4484
4485
4486
4487
4488
4489
4490
4491
4492
4493
4494
4495
4496
4497
4498
4499
4500
4501
4502
4503
4504
4505
4506
4507
4508
4509
4510
4511
4512
4513
4514
4515
4516
4517
4518
4519
4520
4521
4522
4523
4524
4525
4526
4527
4528
4529
4530
4531
4532
4533
4534
4535
4536
4537
4538
4539
4540
4541
4542
4543
4544
4545
4546
4547
4548
4549
4550
4551
4552
4553
4554
4555
4556
4557
4558
4559
4560
4561
4562
4563
4564
4565
4566
4567
4568
4569
4570
4571
4572
4573
4574
4575
4576
4577
4578
4579
4580
4581
4582
4583
4584
4585
4586
4587
4588
4589
4590
4591
4592
4593
4594
4595
4596
4597
4598
4599
4600
4601
4602
4603
4604
4605
4606
4607
4608
4609
4610
4611
4612
4613
4614
4615
4616
4617
4618
4619
4620
4621
4622
4623
4624
4625
4626
4627
4628
4629
4630
4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
4643
4644
4645
4646
4647
4648
4649
4650
4651
4652
4653
4654
4655
4656
4657
4658
4659
4660
4661
4662
4663
4664
4665
4666
4667
4668
4669
4670
4671
4672
4673
4674
4675
4676
4677
4678
4679
4680
4681
4682
4683
4684
4685
4686
4687
4688
4689
4690
4691
4692
4693
4694
4695
4696
4697
4698
4699
4700
4701
4702
4703
4704
4705
4706
4707
4708
4709
4710
4711
4712
4713
4714
4715
4716
4717
4718
4719
4720
4721
4722
4723
4724
4725
4726
4727
4728
4729
4730
4731
4732
4733
4734
4735
4736
4737
4738
4739
4740
4741
4742
4743
4744
4745
4746
4747
4748
4749
4750
4751
4752
4753
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763
4764
4765
4766
4767
4768
4769
4770
4771
4772
4773
4774
4775
4776
4777
4778
4779
4780
4781
4782
4783
4784
4785
4786
4787
4788
4789
4790
4791
4792
4793
4794
4795
4796
4797
4798
4799
4800
4801
4802
4803
4804
4805
4806
4807
4808
4809
4810
4811
4812
4813
4814
4815
4816
4817
4818
4819
4820
4821
4822
4823
4824
4825
4826
4827
4828
4829
4830
4831
4832
4833
4834
4835
4836
4837
4838
4839
4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
4850
4851
4852
4853
4854
4855
4856
4857
4858
4859
4860
4861
4862
4863
4864
4865
4866
4867
4868
4869
4870
4871
4872
4873
|
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="https://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title>Raptor RDF Syntax Library - Release Notes</title>
</head>
<body>
<h1 style="text-align:center">Raptor RDF Syntax Library - Release Notes</h1>
<h2 id="rel2_0_16"><a name="rel2_0_16">Raptor2 2.0.16 changes</a></h2>
<p>Release because ... it's been a while</p>
<p><a href="https://nvd.nist.gov/vuln/detail/CVE-2017-18926">CVE-2017-18926</a>
fixed in commit 590681e546cd9aa18d57dc2ea1858cb734a3863f</p>
<p><a href="https://nvd.nist.gov/vuln/detail/CVE-2020-25713">CVE-2020-25713</a>
fixed in commit 4f5dbbffcc1c6cf0398bd03450453289a0979dea</p>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=600">0000600</a>: Can't compile on Cygwin: sort_r.h "Cannot detect operating system"</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=606">0000606</a>: "JSON" format outputs invalid Unicode escapes</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=617">0000617</a>: heap buffer overflow in raptor_qname_format_as_xml</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=618">0000618</a>: heap buffer overflow in raptor_xml_writer_start_element_common</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=650">0000650</a>: Out of bounds read leads to segfault in raptor_xml_writer_start_element_common</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=652">0000652</a>: Manpage for the rapper utility describes the wrong Atom version</li>
</ul>
<h3>Parser changes</h3>
<p>The Turtle parser was improved to process input in chunks, rather
than all in one step (with a large memory buffer). This allows
Turtle to read and parse files much larger than the system memory; it
splits the inputs after the end of a turtle "sentence" that ends in a
<code>.</code>. Includes memory usage minimizing with AVLTree
pruning during serializing and addition of turtle serializer flush
implementation.
This improvment across multiple patches was contributed by
<a href="https://github.com/hroptatyr">Sebastian Freundt</a>. Thanks
<a href="https://github.com/dajobe/raptor/pull/37">Pull Request #37</a>
<a href="https://github.com/dajobe/raptor/pull/38">Pull Request #38</a>
</p>
<p>Turtle parser improvements for Bison 3+ and removing deprecated or
older style directives.
Thanks to fix from <a href="https://github.com/akimd">Akim Demaille</a>
<a href="https://github.com/dajobe/raptor/pull/43">Pull Request #43</a>
</p>
<p>Turtle parser fixes for cleaning up va_arg on failure paths.
[coverity CID 343351]
</p>
<p>grddl parser: fix leak on failure paths of WWW model methods
[coverity CID 343353]
</p>
<h3>Serializer changes</h3>
<p>Added a serializer for the
<a href="http://contextknowledgesystems.org/CKS.html">mKR (my Knowledge Representation)</a>
language with the name <code>mkr</code> Patch developed by Richard
H. McCullough based on the Turtle serializer. Thanks.
<a href="https://github.com/dajobe/raptor/pull/25">Pull Request #25</a>
</p>
<p>XML writer calculate max nspace declarations correctly.
Fixes Issues
<a href="https://bugs.librdf.org/mantis/view.php?id=617">#0000617</a>
and
<a href="https://bugs.librdf.org/mantis/view.php?id=618">#0000618</a>
</p>
<p>JSON writer changed to write UTF-8 for JSON literals
Add <code>RAPTOR_ESCAPED_WRITE_BITFLAG_UTF8</code> to
<code>RAPTOR_ESCAPED_WRITE_JSON_LITERAL</code>
Fixes Issue
<a href="https://bugs.librdf.org/mantis/view.php?id=606">#0000606</a>
</p>
<p>rdfxmla serializer was fixed to handle leak of iter object on some
failure pathes. [coverity CID 343354] [coverity CID 343358]
</p>
<p>Fix for RSS 1.0 serializing default namespaces.</p>
<h3>Writer changes</h3>
<p>XML Writer: compare namespace declarations correctly. Applied a patch from
0001-CVE-2020-25713-raptor2-malformed-input-file-can-lead.patch.1
that fixes
Issue <a href="https://bugs.librdf.org/mantis/view.php?id=650">#0000650</a>
which overwrote heap during XML writing in parse type literal
content. This was detected with clang asan. Thanks to fix from Michael Stahl
/ mst2.
</p>
<h3>Build and portability fixes</h3>
<p>CMake fixes</p>
<ul>
<li>Fix cmake builds for time.h check change, generated pc file.
Thanks to fix from <a href="https://github.com/Artturin">Artturin</a>.
<a href="https://github.com/dajobe/raptor/pull/52">Pull Request #52</a>
</li>
<li>Multiple cmake build fixes. Thanks to multiple changes from
<a href="https://github.com/mathvich">mathvich</a>.
<a href="https://github.com/dajobe/raptor/pull/50">Pull Request #50</a>
</li>
<li>Multiple fixes for Appveyor's Windows build using CMake
Thanks to fix from <a href="https://github.com/0u812">0u812</a>.
</li>
<li>Multiple fixes for Cmake build system to allow building from
source including running flex, bison and running the tests.
Thanks to fix from <a href="https://github.com/0u812">0u812</a>.
</li>
<li>Made Raptor build again with CMake under Windows via CI as a
service Appveyor. The resulting binaries and libraries were not
tested.</li>
</ul>
<p>Remove and fix obsolete autoconf: AC_PROG_LEX AC_HEADER_TIME AC_HEADER_STDC.
</p>
<p>Update bison check to find first new enough GNU bison</p>
<p>Fix configure.ac <code>-Wimplicit-function-declaration</code> in
<code>HAVE___FUNCTION__</code> test to provide Clang 16 support. Fix
from Sam James, thanks.
</p>
<p>Support newer ICU UC version (>=56) for newer NFC check
interface <code>unorm2_quickCheck()</code>..</p>
<p>Several minor fixes and workarounds for clang ASAN warnings or
false warnings - not able to understand raptor's reference model.</p>
<p>Updated fix-flex.pl script for newer flex naming conventions.</p>
<p>Portability fixes found with GCC 10 and newer compilers for wrong
error message callbacks in turtle and grddl parsers
</p>
<p>Later, updated to make bison 3.4 the minimum.</p>
<p>Update turtle parser and support scripts to work with Bison 3.0.5
Patch contributed by Adam Novak. Thanks.
<a href="https://github.com/dajobe/raptor/pull/39">Pull Request #39</a>
</p>
<p>Fix GNUInstallDirs for install paths to be able to install
libraptor2.a and raptor2.pc to a specific directory when
cross-compiling. Thanks to fix from
<a href="https://github.com/ariadnext">Eric Le Lay</a>.
<a href="https://github.com/dajobe/raptor/pull/36">Pull Request #36</a>
</p>
<p>Made some code changes to quiet GCC extra warnings.</p>
<p>Portability fixes for OpenBSD</p>
<p>Some portability for building under cygwin by Richard
H. McCullough while developing the mkr serializer.
</p>
<p>Portability fixes in the <code>raptor2.spec</code> file.
Thanks to fix by <a href="https://github.com/philjohn">philjohn</a>
</p>
<p>Enable <code>pkg-config</code> to work when cross-building such as
with yocto. Thanks to fix by Andreas Müller.
</p>
<p>Use only pkgconfig for libxslt and ICU UC. Patches from Hugh
McMaster. Thanks.
</p>
<p>Updated Travis configuration to try builds across a wider range of
compilers and with clang ASAN enabled.</p>
<h3>Other changes</h3>
<p>Handle deleting empty avltree. Fixes invalid pointer reference
reported by Li Qiang via email. Thanks.
</p>
<p>Change <code>rapper(1)</code> utility to count in longs instead of
ints. Because: billions and billions of triples. Thanks to patch
from <a href="https://github.com/JervenBolleman">Jerven Bolleman</a>.
</p>
<p>Accept cygwin as a Linux-like.
Fixes Issue <a href="https://bugs.librdf.org/mantis/view.php?id=600">#0000600</a>.
</p>
<p>Mention Atom 0.3 in docs and manual page
Fixes Issue <a href="https://bugs.librdf.org/mantis/view.php?id=652">#0000652</a>.
</p>
<p>Check <code>curl_easy_setopt()</code> return values for errors In
several places check for <code>curl_easy_setopt()</code> erorr
returns and fail. [coverity CID 343360]
</p>
<p>Fixed internal ICU string NFC check to convert to UTF-16 first
before trying to do a NFC normalization check. This allows returning
an error response.
</p>
<p><code>raptor_uri_counted_filename_to_uri_string()</code> fix to
copy NUL when copying the <code>file://</code>code prefix. Coverity
false positive since the following lines of code always add more
characters and a NUL. "Fixes" [Coverity CID 353858]
</p>
<h2 id="rel2_0_15"><a name="rel2_0_15">Raptor2 2.0.15 changes</a></h2>
<p>This release mainly made general bug fixes as well as several
fixes to the Turtle / N-Triples family of parsers and serializers. It
added utility functions for re-entrant sorting of objects and
sequences and a few other useful methods.<br />
</p>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=574">0000574</a>: Language tags with underscore</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=575">0000575</a>: Wrong API or wrong API documentation</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=576">0000576</a>: Wrong assert for a counted string being nul terminated</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=577">0000577</a>: iri parsing does not conform to REC-n-quads-20140225</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=579">0000579</a>: raptor_world_generate_bnodeid accepts world not parser</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=581">0000581</a>: My patch for parser and serializers count</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=584">0000584</a>: raptor fails to parse trig files with dos line endings</li>
</ul>
<h3>Parser changes</h3>
<p>Fixed <code>raptor_grddl_filter_triples()</code> check for three
URIs which has been broken since 2007 but just did more work. Found
via gcc5 warning.</p>
<p>The TRiG parser now accepts \r newlines between the graph name and
the following '{'.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=584">Issue #0000584</a>
</p>
<p>Turtle, TRiG, N-Triples and N-Quads parsers now check escapes
correctly for URI strings. \t \b \n \r \f are forbidden. Check that
raw ' ' or \u0020, \u003C or \u003E are also not accepted.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=577">Issue #0000577</a>
</p>
<p>N-Triples / N-Quads parsers nwo accept '_' as an alias for '-' in
lang strings. '_' is not legal.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=574">Issue #0000574</a>
</p>
<p>Updated RDFa parser (librdfa) to support full URLs for
<code>typeof</code> from upstream. Re-checked several tests which
have been passing for some time but the expected output was not a
correct conversion from the testsuite sparql.</p>
<h3>Serializer changes</h3>
<p>Turtle serializer now writes <code>()</code> instead of
<code>rdf:nil</code> via
<a href="https://github.com/dajobe/raptor/pull/16">Pull Request #16</a>
from Richard H. McCullough. Thanks!
</p>
<h3>I/O-stream class changes</h3>
<p><code>raptor_iostream_decimal_write()</code> and
<code>raptor_iostream_hexadecimal_write</code> now return non-0 if
they do not succeed in writing successfully.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=575">Issue #0000575</a>
</p>
<h3>Term class changes</h3>
<p><code>raptor_new_term_from_blank()</code> now also accepts "" as
the same as a NULL blank node ID argument.</p>
<h3>URI class changes</h3>
<p>Fixed <code>raptor_uri_counted_filename_to_uri_string()</code> to
use the passed in len, not look for end NUL char and count lengths.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=576">Issue #0000576</a>.
</p>
<p><code>raptor_new_uri_from_counted_string()</code> no longer
assumes a NUL terminated string. Remove a debug assert and use
<code>fwrite()</code> to emit the counted URI string to the debug
file handler.</p>
<p>Fixed <code>raptor_uri_normalize_path()</code> to check the size of
output buffer is big enough.</p>
<h3>Writer class changes</h3>
<p>Fixed <code>raptor_turtle_writer_quoted_counted_string()</code> to
use the passed in length, drop the <code>strlen()</code> call and use
the length internally.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=576">Issue #0000576</a>.
</p>
<h3>World class changes</h3>
<p>Added <code>raptor_world_get_parsers_count()</code>
and <code>raptor_world_get_serializers_count()</code>
with patch from Victor Porton. Thanks!
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=581">Issue #0000581</a>.</p>
<h3>Other Changes</h3>
<p>Made raptor work with Travis CI again; have to download and
install Bison 3.</p>
<p>Added <code>raptor_sort_r()</code> and
<code>raptor_sequence_sort_r()</code> re-entrant sort utility methods
based on the public domain <a
href="https://github.com/noporpoise/sort_r">sort_r</a> code by Isaac
Turner.
</p>
<p>Ensure <code>raptor_locator_format()</code> always adds a NUL to
terminate the output string.</p>
<p>Fix a -99 <= var <= 99 timezone interval check. Thanks to
Richard Trieu for the report.</p>
<p>Improve configure warning check using AC_LANG_WERROR</p>
<p>Use C99 <code>__FUNCTION__</code> replacing <code>__func__</code>
from C90.</p>
<p>Improve build-time flex and bison output to be more silent.</p>
<p>Added Intel C compiler (icc) support from Sebastian Freundt
(hroptatyr on GitHub) - Thanks.</p>
<h2 id="rel2_0_14"><a name="rel2_0_14">Raptor2 2.0.14 changes</a></h2>
<p>Many code quality fixes from clang and coverity primarily in error
path cleanups (out of memory cases) and dead code.</p>
<h3>Parser changes</h3>
<p>Turtle 1.1 parser: fixes about triple quoting alignment with
SPARQL from the www-rdf-comments list post REC
<a href="http://lists.w3.org/Archives/Public/public-rdf-comments/2014Feb/0018.html">report of problem</a>
and
<a href="http://lists.w3.org/Archives/Public/public-rdf-comments/2014Feb/0021.html">expected answer</a>.
</p>
<h3>Other changes</h3>
<p>Fixed RDFa 1.0 and RDFa 1.1 test suites to properly report
failures.</p>
<p>Updated the fix-flex and fix-bison scripts to remove dead
code that clang and coverity complain about.</p>
<h2 id="rel2_0_13"><a name="rel2_0_13">Raptor2 2.0.13 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=562">0000562</a>: N-Quads parsing of URIs with ' fails</li>
</ul>
<h3>Parser changes</h3>
<p>The N-Triples / N-Quads parser was updated to allow ' in URIs.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=562">Issue #0000562</a>.
</p>
<h3>Configuration changes</h3>
<p>Use the discovery of the <code>xml2-config(1)</code> /
<code>curl-config(1)</code> programs as test for presence of the
libraries. This fixes the issue where that after configuring, curl
was present but was not used for WWW fetching. This is seen when
the output of <code>curl-config --cflags</code> is empty / whitespace.
</p>
<p>Updated to use the <code>AC_CHECK_PROGS</code> macro to find jing
since <code>AC_CHECK_PROG</code> doesn't default to setting it as
found when present!
</p>
<h3>Internal changes</h3>
<p>The Turtle and parsedate parsers and the turtle lexer were updated
to use and require Bison 3.0.0.
</p>
<p>The JSON and turtle writers were updated to save several expensive
<code>strlen()</code> calls.</p>
<h2 id="rel2_0_12"><a name="rel2_0_12">Raptor2 2.0.12 changes</a></h2>
<h3>Parser changes</h3>
<p>The N-Triples / N-Quads parser was updated to pass all the two test
suites for the updated specifications:
</p>
<ul>
<li><a href="https://www.w3.org/TR/2013/CR-n-triples-20131105/">RDF 1.1 N-Triples - A line-based syntax for an RDF graph</a>, W3C Candidate Recommendation, 05 November 2013 (aka N-Triples 2013)</li>
<li><a href="https://www.w3.org/TR/2013/CR-n-quads-20131105/">RDF 1.1 N-Quads - A line-based syntax for an RDF datasets</a>, W3C Candidate Recommendation, 05 November 2013</li>
</ul>
<p>The main fixes were:</p>
<ul>
<li>allow <code>\b</code> and <code>\f</code> escapes (from Turtle, SPARQL)</li>
<li>fix the allowed blank node identifier characters</li>
<li>require all URIs to be absolute</li>
<li>handle a single short document with no end of line</li>
<li>support NULs inside literals</li>
<li>handle unescaped newlines inside literals</li>
</ul>
<h3>Term class changes</h3>
<p>Added <code>raptor_new_term_from_counted_string()</code> to
create a term from a Turtle or N-Triples string syntax. This is
the opposite of <code>raptor_term_to_turtle_counted_string()</code>
and <code>raptor_term_to_turtle_string()</code> and also reads the
strings created by <code>raptor_term_to_counted_string()</code> and
<code>raptor_term_to_string()</code>.
</p>
<h2 id="rel2_0_11"><a name="rel2_0_11">Raptor2 2.0.11 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=556">0000556</a>: Problem with relative URI in rdf:about, rdf:resource etc.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=554">0000554</a>: RDF/XML serializer does not canonicalize attribute order in XMLLiterals</li>
</ul>
<h3>Parser changes</h3>
<p>N-Triples parser was updated to support all of
<a href="https://www.w3.org/TR/2013/CR-n-triples-20131105/">RDF 1.1
N-Triples - A line-based syntax for an RDF graph</a> (aka N-Triples 2013)
It now supports <code># comments</code> after the end of
lines, checks for illegal unicode escapes, checks for bad URIs and
checks language tags.
Also removed support for legacy N-Triples
<code>"foo"-LANGTOKEN</code>.
Many internal changes were also made.
</p>
<p>RDF/XML parser fixed the XML Canonicalization so that it writes
the XML attributes in sorted order.
Fixes
<a href="https://bugs.librdf.org/mantis/view.php?id=554">Issue #0000554</a>.
</p>
<h3>URI class changes</h3>
<p>Added <code>raptor_uri_uri_string_is_absolute()</code> to
check if a URI is absolute.</p>
<h3>QName class changes</h3>
<p>Added <code>raptor_qname_format_as_xml()</code> to turn a qname
into an XML declaration.
</p>
<h3>Configuration and build changes</h3>
<p>Restructured code to build an internal librdfa convenience library
(never installed) so that newer automake will stop moaning about
subdir-objects.
</p>
<p><code>configure</code> now checks for clang to correctly find
supported warnings.</p>
<p>Various portability and build fixes (Daniel Richard G)</p>
<p>Build fixes: <code>make check</code> will now work if jing is not
installed (for feed XML generation validation).
</p>
<h3>Other changes</h3>
<p>Fixed a few issues found with LLVM 3.4 (SVN) run with address
sanitizing.</p>
<h2 id="rel2_0_10"><a name="rel2_0_10">Raptor2 2.0.10 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=532">0000532</a>: configure.ac: required file `src/raptor_config.h.in' not found</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=535">0000535</a>: configure accepts bogus values for --with-xml2-config</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=545">0000545</a>: Reopen issue 503</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=548">0000548</a>: xml:lang inside rdf:parseType="Literal" are removed in parsed output</li>
</ul>
<h3>Parser changes</h3>
<p>Turtle parser was updated to handle
<a href="https://www.w3.org/TR/2013/CR-turtle-20130219/">Turtle Terse RDF Triple Language</a> W3C Candidate Recommendation 19 February 2013
(Turtle 2013)
The main changes were to align with SPARQL-style blank node names,
prefixes and local names.
</p>
<p>N-Triples parser was updated to handle
<a href="https://www.w3.org/TR/2013/NOTE-n-triples-20130409/">N-Triples - A line-based syntax for an RDF graph</a> 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.</p>
<p>RDF/XML parser updated to understand the new RDF 1.1 datatypes:
rdf:HTML and rdf:langString</p>
<h3>Serializer changes</h3>
<p>Updated N-Triples and Turtle serializers (via writers) for 2013
versions based on SPARQL 1.1 definitions. These new formats
have incompatible changes.
</p>
<p>Added functions for writing escaped Turtle / N-Triples terms:</p>
<pre>
int raptor_string_escaped_write(const unsigned char *string,
size_t len, const char delim, unsigned int flags, raptor_iostream *iostr);
int raptor_term_escaped_write(const raptor_term *term, unsigned int flags,
raptor_iostream* iostr);
int raptor_uri_escaped_write(raptor_uri* uri, raptor_uri* base_uri,
unsigned int flags, raptor_iostream *iostr);
</pre>
<p>These uses the new new <code>raptor_escaped_write_bitflags</code>
enum bitflag values for the <code>flags</code> argument.</p>
<p>Deprecated <code>raptor_string_python_write()</code> for
<code>raptor_string_escaped_write()</code> with flags.</p>
<h3>Configuration and build changes</h3>
<p><code>configure</code> now recommends flex 2.5.36</p>
<p><code>configure</code> was updated to switch configuring libxml
and libcurl to use the <code>PKG_PROG_PKG_CONFIG</code> and
<code>PKG_CHECK_MODULES</code> macros. The preference remains to
prefer looking for the xml2-config and curl-config programs before
trying pkg-config unless <code>--with-curl-config=no</code>
<code>--with-xml2-config=no</code> are used.
</p>
<p><code>configure</code> now dies if xml2-config or xslt-config
point at non executable files. Patch from Michael Stahl - thanks.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=535">Issue #0000534</a>
</p>
<p><code>configure</code> now adds curl or libxml pkg-config requires
only if they were found via pkg-config; this prevents unnecessary
dependency on pkg-config files if they are not needed.</p>
<p>Updated autogen.sh and code to handle variations of header
macro.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=532">Issue #0000532</a>
</p>
<h2 id="rel2_0_9"><a name="rel2_0_9">Raptor2 2.0.9 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=499">0000499</a>: Turtle parser fails to correctly parse valid syntax</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=508">0000508</a>: Raptor objects to possibly valid Turtle syntax</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=520">0000520</a>: compilation failure</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=521">0000521</a>: Python RDF 1.0.14.1 segfault when one tries to parse xhtml+rdf using the RDFa parser</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=526">0000526</a>: Document how to find gtkdocize in INSTALL.html</li>
</ul>
<h3>Parser Changes</h3>
<p>RDFa parser:
Handle non-namespaced elements without crash in RDFa.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=521">Issue #0000521</a>
</p>
<p>Turtle Parser: Added full support for
<a href="https://www.w3.org/TR/2013/CR-turtle-20130219/">Turtle Terse RDF Triple Language</a> W3C Candidate Recommendation 19 February 2013
</p>
<p>This includes accepting new keywords from SPARQL
(<code>BASE</code> and <code>PREFIX</code>), triples forms and
details of the characters allowed in URIs, Literals, Prefix Names,
Local Names and Blank Node identifiers. Some existing documents that
used <code>\</code>-escapes in URIs to encode characters not allowed
in URIs, are now forbidden. For example ASCII 32 (0x20) - space,
which should be written as <code>%20</code>.
</p>
<h3>Serializer changes</h3>
<p>Turtle Serializer: Added full support for
<a href="https://www.w3.org/TR/2013/CR-turtle-20130219/">Turtle Terse RDF Triple Language</a> W3C Candidate Recommendation 19 February 2013
which particular effects the encoding of URIs in the serializer.
</p>
<h3>Configuration and build changes</h3>
<p>Added CMake build framework for building Raptor on Microsoft
Windows. Removed the old <code>win32/</code> area and
<code>win32_raptor_config.h</code> references. Contributed by Daniel
Richard G. for Teragram Inc.
</p>
<p>Ensure that a small system BUFSIZ does not affect parser guessing
Patch from Daniel Richard G for Teragram Inc.</p>
<p>Added a compile-time check for
<code>raptor_world_guess_parser_name()</code> to ensure that
<code>RAPTOR_READ_BUFFER_SIZE</code> is at least as large as
<code>FIRSTN</code>, because otherwise the guesser sees fewer than
<code>FIRSTN</code> bytes from the document. Patch from Daniel
Richard G for Teragram Inc.
</p>
<p>Update <code>configure</code> to allow xml2-config and curl-config
to work for libxml and libcurl. It now report on the source of xml, curl
libraries in the configuration status.</p>
<p><code>autogen.sh</code> updates to abort the run if a configuring
program fails, Generate NEWS with old timestamp if missing so
automake can run.</p>
<p>Handle the libxml2 <code>ret->checked</code> field not being
present in older libxml2 versions. The entities checked field was
added 2006-10-10 in <a href="http://git.gnome.org/browse/libxml2/commit/?id=a37a6ad91a61d168ecc4b29263def3363fff4da6and">libxml2 GIT commit a37a6ad91a61d168ecc4b29263def3363fff4da6and</a>
released in libxml2 2.6.27 on 2006-10-25.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=520">Issue #0000520</a>
</p>
<h3>Other changes</h3>
<p><code>raptor_www_set_ssl_verify_options()</code> now supports the
Curl 7.28.1 removal of <code>CURLOPT_SSL_VERIFYHOST</code> with a
value of 2. Now <code>verify_host</code> non-0 means to verify CN, 0
means to not verify.</p>
<p>Remove <code>-m MODE</code> from the <code>rapper(1)</code> help
message which was removed in commit
f94fa561db05b21132b14a2b72f05b77e666c252 on Wed Apr 28 21:31:54 2010
-0700 as part of the Raptor V2 work.
</p>
<h2 id="rel2_0_8"><a name="rel2_0_8">Raptor2 2.0.8 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=381">0000381</a>: Raptor incorrectly serializes turtle lists when list nodes are URIs.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=487">0000487</a>: Does raptor_world_guess_parser_name [librdf_parser_guess_name2] ever return NULL?</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=505">0000505</a>: Parsing certain escaped unicode strings in Turtle cases an error</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=507">0000507</a>: Turtle parse error causes fatal error</li>
</ul>
<h3>Parser class changes</h3>
<p>Guessing a parser with
<code>raptor_world_guess_parser_name()</code> now returns NULL failure
when the guess is very poor, rather just return the first bad result.
Fixes
<a href="https://bugs.librdf.org/mantis/view.php?id=487">Issue #0000487</a>
which was reported in <a href="https://librdf.org/">Redland librdf</a> but
is implemented here.
</p>
<p>Guess parser: now returns error file and line location information
from the guessed parser.</p>
<p>RDFa parser: Updated <a href="https://github.com/rdfa/librdfa">librdfa</a>
to the latest GIT supporting
<a href="https://www.w3.org/TR/2012/REC-rdfa-core-20120607/">RDFa 1.1</a>
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
aliases 'rdfa10', 'rdfa11' and the default 'rdfa' is RDFa 1.1
</p>
<p>RSS tag soup parser: Use <code>time()</code> when
<code>gettimeofday()</code> is not available. Fix several reference
leaks.
</p>
<p>RDF/XML parser: The range of RDF/XML entity recognizing heuristic was
broadened to allow recognition of documents produced by Stanford's
Protege software (and possibly others). Fixed some parser memory
leaks / double frees.
</p>
<p>Turtle parser: Do not report multiple errors for Turtle string decoding
problems. When a Turtle qname cannot be found, a fatal error is no
longer generated but a regular error message giving information on
the qname that failed (usually due to unknown prefix).
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=507">Issue #0000507</a>
</p>
<h3>SAX2 API changes</h3>
<p><code>raptor_sax2_inscope_xml_language()</code> will now return ""
for explicit no language (<code>xml:lang=""</code>) as well as NULL
for undefined language (no <code>xml:lang</code> present).
</p>
<h3>Serializer class changes</h3>
<p>Turtle: Do not emit a Turtle <code>(...)</code> collection if the
list item is a URI. This fixes
<a href="https://bugs.librdf.org/mantis/view.php?id=381">Issue #0000381</a>.
</p>
<h3>Term class changes</h3>
<p>Added <code>raptor_term_to_turtle_counted_string()</code> counted
string form of <code>raptor_term_to_turtle_string</code>.
</p>
<h3>Unicode class changes</h3>
<p><code>raptor_unicode_utf8_string_put_char()</code> and
<code>raptor_unicode_utf8_string_get_char()</code>
now allow reading / writing U+D800 to U+DFFF (UTF-16 surrogates).
rather than returning failure. BOMs remain forbidden - definitely not UTF-8.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=505">Issue #0000505</a>
</p>
<h3>URI class changes</h3>
<p>Fixed URI resolving with reference (relative) URIs that are bare
queries like '?y' with no path. Now matches the specification
RFC3986 section 5.4.1 Normal Examples.
</p>
<p>Added <code>raptor_new_uri_relative_to_base_counted()</code>
to construct URI relative to current base.
</p>
<p>Added <code>raptor_uri_to_turtle_counted_string()</code> counted
string form of <code>raptor_uri_to_turtle_string</code>.
</p>
<h3>WWW class changes</h3>
<p>The Curl WWW implementation now interprets
<code>Content-Location</code>code> header as absolute or relative URI.
</p>
<h3>Configuration and build changes</h3>
<p>All configure --with-foo options now handle --without-foo (and
--with-foo=no) to disable attempting to find the value in the PATH.
This can be used with --with-xml2-config, --with-xslt-config,
--with-curl-config, --with-icu-config and --with-libwww-config where
the value 'no' or --without-foo can be used to disable it and prevent
automatic searches for the config script in the PATH.
</p>
<p>The <code>-DRAPTOR_DEBUG</code> and <code>-DMAINTAINER_MODE</code>
flags are now written to the config header instead of added to
CPPFLAGS.
</p>
<p>The <code>-g</code> flag is no longer added to CFLAGS or CPPFLAGS
with <code>--enable-debug</code>.</p>
<p>The existing <code>--disable-release</code> (default) now
correctly removes -O options in flag variables for the maintainer.
</p>
<p><code>autogen.sh</code> now looks for the environment variable
<code>NOCONFIGURE</code> to prevent it running configure at the end
of the auto generation run.
</p>
<p>The <code>configure</code> vsnprintf() check was made more
comprehensive.
</p>
<h3>Other changes</h3>
<p>Multiple portability improvements to vsnprintf code and macros.
Also fixed uninitialized variable problems in non-c99 variant of
raptor_vsnprintf2(). Thanks to John Emmas for reporting.
</p>
<p>Multiple portability fixes for building out of the source tree.
Out of source tree 'make check' and 'make dist' should both work.
Thanks to Daniel Richard G. for the patches.
</p>
<p>Multiple portability fixes for building on old Solaris versions.
Thanks to Daniel Richard G. for the patches.
</p>
<p>Multiple portability fixes for building on Windows including
strcasecmp(), windows headers, configuration fixes, parsedate code,
URI test builds, vsnprintf building. Thanks to Daniel Richard G.
for the patches.
</p>
<p>Updated the example <code>rdfguess</code> to accept a file called
or no arguments to read from stdin.</p>
<h2 id="rel2_0_7"><a name="rel2_0_7">Raptor2 2.0.7 changes</a></h2>
<p>CVE-2012-0037 fixed</p>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=448">0000448</a>: Turtle parser does not return error status from turtle_parse_chunk()</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=469">0000469</a>: Allow rapper to bypass server SSL certs checks in libcurl</li>
</ul>
<p>Removed Expat support since expat has not had a release in years
and libxml2 works well. This allows some code simplification.
Updated <code>configure</code> so that if Raptor is configured with
no parser that requires an XML parser, libxml2 will not be required.
</p>
<p>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 <a href=https://icu.unicode.org">ICU</a>.
If ICU is not explicitly configured, no literal checking is done.</p>
<h3>Options changes</h3>
<p>Added new options:</p>
<dl>
<dt><code>RAPTOR_OPTION_NO_FILE</code><br/></dt>
<dd>Deny file requests during parsing. Enabled by default.</dd>
<dt><code>RAPTOR_OPTION_LOAD_EXTERNAL_ENTITIES</code><br/></dt>
<dd>Allow loading of XML external entity loading. Disabled by
default.</dd>
<dt><code>RAPTOR_OPTION_WWW_SSL_VERIFY_PEER</code><br/></dt>
<dd>Controls verifying an SSL peer during parsing / WWW. Takes an
integer value: non-0 to verify peer SSL certificate (default
1).</dd>
<dt><code>RAPTOR_OPTION_WWW_SSL_VERIFY_HOST</code><br/></dt>
<dd>Controls verifying an SSL host during parsing / WWW. Takes an
integer value: 0 none, 1 CN match, 2 host match (default). Other
values are ignored.</dd>
</dl>
<h3>Parser class changes</h3>
<p>The RDF/XML, RSS Tag Soup and RDFa parsers now pass on network,
file and entity loading parser options to the internal SAX2 to enable
enforcing of network, file and entity loading policy.</p>
<p>RDF/JSON parser handles an API change between YAJL V1 and V2.
</p>
<p>Turtle parser now returns parser errors to
<code>raptor_parse_chunk()</code>.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=488">Issue #0000488</a>
</p>
<h3>SAX2 class changes</h3>
<p>Added <code>raptor_sax2_set_uri_filter()</code> to set a URI
filter for any SAX2 calls that do internal lookups of URIs.
</p>
<p>Control file and network loading inside SAX2. Option
<code>RAPTOR_OPTION_LOAD_EXTERNAL_ENTITIES</code> now enforces
loading external XML entities and is by default enabled. If enabled,
<code>RAPTOR_OPTION_NO_FILE</code> and
<code>RAPTOR_OPTION_NO_NET</code> are also checked. All URIs loaded
are also passed through any URI filter, if set by
<code>raptor_sax2_set_uri_filter()</code>.
</p>
<h3>URI class changes</h3>
<p>Added new URI constructor
<code>raptor_new_uri_from_uri_or_file_string()</code>
to build a URI from a URI string or a filename string, normalizing
the result to a <code>file:</code> URI.
</p>
<p>Added
<code>raptor_uri_uri_string_to_counted_filename_fragment()</code> to
turn a URI string to a filename and URI fragment along with string
output string counts.
</p>
<p>Added utility methods for checking if a file: URI or filename is a
file that exists:
<code>raptor_uri_file_exists()</code> and
<code>raptor_uri_filename_exists()</code>
</p>
<h3>WWW class changes</h3>
<p>Added <code>raptor_www_set_ssl_verify_options()</code> to set SSL
verify options.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=469">Issue# 0000469</a>.
</p>
<p>The <code>raptor_www_fetch()</code> call now returns the status
from any URI filter that returns a non-0 response.
</p>
<h3>Build changes</h3>
<p>Added <code>--with-icu-config=</code><em>PATH</em> option
to enable use of ICU for NFC checking.</p>
<p>Requires automake 1.11.2+ for <code>-Wextra-portability</code></p>
<p><code>configure</code> uses <code>AM_PROG_AR</code> to make
automake <code>-Wextra-portability</code> happy.
</p>
<h2 id="rel2_0_6"><a name="rel2_0_6">Raptor2 2.0.6 changes</a></h2>
<p>Fixed expat support which was broken in 2.0.5</p>
<p>Handle libCurl SSL options before 7.16.4 (that's 2007) since old
libcurl is still around on Enterprise (that means old) linux systems.
</p>
<h3>Sequence Changes</h3>
<p>Added utility functions to swap elements, reverse the sequence and
generate permuations:</p>
<pre>
int raptor_sequence_swap(raptor_sequence* seq,
int i, int j);
int raptor_sequence_reverse(raptor_sequence* seq,
int start_index, int length);
int raptor_sequence_next_permutation(raptor_sequence *seq,
raptor_data_compare_handler compare);
</pre>
<h2 id="rel2_0_5"><a name="rel2_0_5">Raptor2 2.0.5 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=465">0000465</a>: c99 snprintf usage</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=476">0000476</a>: Add Format URIs to raptor_syntax_descriptions</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=479">0000479</a>: raptor 2.0.4 : -i nquads fails to treat the context term as optional bugs.librdf.org</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=481">0000481</a>: Invalid unicode characters cause raptor to emit infinite output while converting n-quads to n-triples</li>
</ul>
<h3>Parser class changes</h3>
<p>Updated all parser URIs to use the
<a href="https://www.w3.org/ns/formats/">W3C Format URIs</a>
as the primary URIs. Existing URIs become aliases. (Nicholas J Humfrey)
</p>
<p>GRDDL parser: Correctly set the base_uri when resolving the
sheet URI.</p>
<p>N-Quads parser: Make context optional. (Lauri Aalto)
Fixes
<a href="https://bugs.librdf.org/mantis/view.php?id=479">Issue #0000479</a>.
<br />
When guessing formats, make N-Quads always beat N-Triples since
since now all ntriples parse fine with the nquads parser. (Lauri Aalto)
</p>
<p>RDFA parser: fix when building with 64-bit systems to prevent
value truncation.</p>
<p>Turtle parser: now uses the official <em>text/turtle</em> mime
type in the syntax recognizing code.
</p>
<h3>Serializer class changes</h3>
<p>Updated all serializer URIs to use the
<a href="https://www.w3.org/ns/formats/">W3C Format URIs</a>
as the primary URIs. Existing URIs become aliases. (Nicholas J Humfrey)
</p>
<p>Turtle serializer now uses the official <em>text/turtle</em> mime
type in the syntax recognizing code.
Do not generate infinite output when the input Unicode UTF-8 encoding
is bad.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=481">Issue #000481</a>.
</p>
<h3>Unicode class changes</h3>
<p>Added new utility functions for calculating number of Unicode
characters in a UTF-8
string <code>raptor_unicode_utf8_strlen()</code> and getting a subset
of a UTF-8 string <code>raptor_unicode_utf8_substr()</code>:
</p>
<pre>
int raptor_unicode_utf8_strlen(const unsigned char *string,
size_t length);
size_t raptor_unicode_utf8_substr(
unsigned char* dest, size_t* dest_length_p,
const unsigned char* src, size_t src_length,
int startingLoc, int length);
</pre>
<h3>URI class changes</h3>
<p><code>raptor_uri_string_to_relative_uri_string()</code> now
compares URI paths not files. (Joe Presbrey)
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=472">Issue #0000472</a>
</p>
<h3>Build changes</h3>
<p>The library no longer needs <code>trunc()</code>,
<code>lround()</code>, <code>round()</code> or anything else from
libm. Removed the checks for these functions from
<code>configure</code>.
</p>
<p><code>configure</code> no longer enables debug messages by default
for <code>--enable-maintainer-mode</code> but now requires the
<code>--enable-debug</code> option to be given.
</p>
<h3>Other changes</h3>
<p>Records GIT version in the version string when building from GIT
sources with <code>--enable-maintainer-mode</code>. This makes it
clearer when an non-released version is being used.
</p>
<p>Added internal <code>raptor_format_integer()</code> which enabled
the removal of all internal use of <code>snprintf()</code>.
</p>
<p>Added <code>raptor_vsnprintf2()</code> deprecating
<code>raptor_vsnprintf()</code> which does not actually have the
vsnprintf() calling contention. Added <code>raptor_snprintf()</code>
with snprintf() calling convention. Added
<code>raptor_vasprintf()</code> with vasprintf() (GNU) calling
convention.
</p>
<pre>
int raptor_vsnprintf2(char *buffer, size_t size,
const char *format, va_list arguments);
int raptor_snprintf(char *buffer, size_t size, const char *format, ...);
int raptor_vasprintf(char **ret, const char *format, va_list arguments);
</pre>
<p><code>raptor_locator_format()</code> now picks a large enough
buffer size if <code>snprintf()</code> is likely not portable, when
HAVE_C99_VSNPRINTF is not defined.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=465">Issue #0000465</a>
</p>
<p>Internal code style changes for how allocation is done and casting
with new macros.</p>
<blockquote>
<p>RAPTOR_GOOD_CAST: code checks or logic ensures cast will not
truncate</p>
<p>RAPTOR_BAD_CAST: value may be truncated; may require API
change/break. Might be unrealistic e.g. a >4G error message,
qname prefix.</p>
<p>Some good uses:</p>
<ul>
<li>narrowing a known, checked unicode char to a U16</li>
</ul>
<p>Some 'bad' uses:</p>
<ul>
<li>only handing error messages, literal language, qname prefixes of
a max len constrained by int</li>
<li>passing in data to libxml constrained by int max len</li>
<li>locator column field constrained to int size</li>
</ul>
<p>Some bad uses:</p>
<ul>
<li>iostream read_bytes and write-bytes methods return int but could
easily return a lot more in the size_t range (compare to fread).
API change needed.</li>
<li>locator byte field constrained to int size. should be size_t</li>
<li>raptor_nfc_check returns int offset into a buffer that could
be larger</li>
<li>raptor_ntriples_parser_context changed line_length and offset
to size_t</li>
<li>raptor_turtle_parser changed buffer_length to size_t</li>
</ul>
</blockquote>
<p>Updated code to use <code>size_t</code> for sizes such as those
from <code>strlen()</code> and <code>ptrdiff_t</code> for pointer
differences so that on 64-bit architectures, values are not
potentially truncated to size of int.
</p>
<h2 id="rel2_0_4"><a name="rel2_0_4">Raptor2 2.0.4 changes</a></h2>
<p>Issues Fixed:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=308">0000308</a>: undefined reference to round and trunc while cross compiling for mipsel</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=449">0000449</a>: ntriples serializer and parser inconsistent w.r.t. _ in name tokens</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=451">0000451</a>: Incorrect qname definition in TRiG parser</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=455">0000455</a>: Incorrect AVL tree operations. [ with fix ]</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=456">0000456</a>: raptor-2.0.3 fails to build against yajl-2.0.2 API</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=457">0000457</a>: raptor-2.0.3 fails to build with curl-7.21.7</li>
</ul>
<h3>Parser class changes</h3>
<p>The <code>raptor_option</code> enumeration gains values for
setting SSL client side certificates:
<code>RAPTOR_OPTION_WWW_CERT_FILENAME</code> for the certificate
filename, <code>RAPTOR_OPTION_WWW_CERT_TYPE</code> for the
certificate type and <code>RAPTOR_OPTION_WWW_CERT_PASSPHRASE</code>
for the certificate passphrase.
</p>
<p><code>raptor_parser_parse_uri_with_connection()</code> (which is
called by <code>raptor_parse_uri()</code>) now uses
<code>raptor_www_set_ssl_cert_options()</code> to turn the parser
options above into settings on the WWW object.
</p>
<p>RDF/JSON parser: Gains support for building with
<a href="http://lloyd.github.com/yajl/">YAJL</a> V2. Note that YAJL
V1 and V2 both install the same library name 'libyajl' even though
they have different ABI and APIs.</p>
<p>TRiG parser: Fixed to support the legal <em>uri</em> <code>:
{</code> ... <code>}</code> syntax naming a graph where the
'<code>:</code>' is optional.
</p>
<p>Turtle parser: Modified to not include the internal
<code>input()</code> function in the lexer which is never needed.
</p>
<h3>Serializer class changes</h3>
<p>N-Triples and Turtle serializers: Now
use <code>raptor_bnodeid_ntriples_write()</code> to always write
legal blank node IDs.
</p>
<h3>WWW class changes</h3>
<p>Added support for <code>raptor_www</code> to handle setting SSL
client certificate options during WWW retrieval.
</p>
<p>Added <code>raptor_www_set_ssl_cert_options()</code> method to set
the SSL client certificates on a WWW object.
</p>
<h3>Other changes</h3>
<p>Make Raptor build against Curl 7.21.7 which removed a header file
that was made an empty file in the libcurl source code on April 26
2004 around version 7.12.0 which is now the minimum version Raptor
supports..
</p>
<p>Fixed an AVL Tree issue during deletion that messes up some pointers.
Patch from 'v-for-vandal'. Thanks.
</p>
<p>Added a utility function
<code>raptor_bnodeid_ntriples_write()</code> to write a N-Triples
blank node ID in legal form, replacing any letters not in the allowed
set.</p>
<p>Expanded GCC warnings and corrected a few internal uses
of <code>int</code> when <code>size_t</code> was meant. Others
remain.
</p>
<p>Reduced stack use of <code>raptor_www_file_handle_fetch()</code>
and <code>raptor_parser_parse_iostream()</code> by moving I/O buffer
to the www or parser objects respectively.
</p>
<h2 id="rel2_0_3"><a name="rel2_0_3">Raptor2 2.0.3 changes</a></h2>
<p>The main change is to add the new main header file
<code>raptor2.h</code>. The new header has been added to allow
applications to be sure they have got the raptor V2 header
(with <code>#include <raptor2.h></code> and not the raptor V1
header file (<code>#include <raptor.h></code>).
The <code>raptor.h</code> header will NOT be removed until the next
major raptor release (V3).
</p>
<h3>Turtle / TRiG parser changes</h3>
<p>Alter the parser to not use a large token stack when parsing TRiG
graphs, enabling the parser to handle much larger files. The parser
still gathers all input into a single memory segment so the maximum
amount of input is probably memory size/3.
</p>
<p>TRiG parser now allows a QName for the graph name.
</p>
<p>Attempted to make the parser handle streaming lexing and parsing
but only partially successful; bison could be made to stream parse
but flex could not be made to stream lex. This meant it could not
be convinced to return a "need more input" response at the end of a
chunk of data and continue lexing later.
</p>
<p>Fix value ownership fix graph name.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=437">Issue #0000437</a>
</p>
<h3>Other Changes</h3>
<p>Raptor was ran through the
LLVM <a href="http://clang-analyzer.llvm.org/">clang</a> static code
analyzer and several issues fixed, mostly in unused variables and in
unlikely error recovery conditions. Some actual potential crash bugs
were found:</p>
<ol>
<li>The workaround for
ancient <a href="https://gitlab.gnome.org/GNOME/libxml2/-/wikis/home">libxml2</a> error handling
in <code>raptor_libxml_xmlStructuredError_handler_parsing()</code>
was broken for some time, so that probably means nobody uses old
libxml2.</li>
<li><a href="https://github.com/msporny/librdfa/">librdfa</a> URI
resolving in <code>rdfa_resolve_uri()</code> used unallocated
memory in some relative URI cases.</li>
</ol>
<p>Bison 2.4 is required to build Raptor from GIT source with
no pregenerated files.
</p>
<h2 id="rel2_0_2"><a name="rel2_0_2">Raptor2 2.0.2 changes</a></h2>
<p>Fixed a too strict version checking bug in <code>raptor_new_world()</code>
</p>
<h2 id="rel2_0_1"><a name="rel2_0_1">Raptor 2.0.1 Changes</a></h2>
<p><b>DO NOT USE</b>. Use 2.0.2 which fixes a too strict version
checking bug in <code>raptor_new_world()</code>
</p>
<h3>Parser class changes</h3>
<p>The internal librdfa parser that uses Raptor internals now exports
symbols prefixed with raptor_librdfa so that Raptor can be linked
with the standard librdfa in applications without symbol clashes.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=416">Issue #0000416</a>
</p>
<h3>Serializer class changes</h3>
<p>The N-Quads serializer was fixed to output the graph name in the
fourth column, instead of repeating the object.
</p>
<h3>Internal changes</h3>
<p>Replaced all internal fatal errors that went to
an <code>abort()</code> with regular logged error.
</p>
<h2 id="rel2_0_0"><a name="rel2_0_0">Raptor 2.0.0 Changes</a></h2>
<p>Raptor V2 final release. See the release notes for 1.9.0 and
1.9.1 for the major changes in Raptor V2.</p>
<h3>API changes since 1.9.1 beta</h3>
<p>Added <code>raptor_syntax_description_validate()</code> to public
API to validate and compute counts for syntax descriptions.
Primarily this is for use by Rasqal.
</p>
<p>The <code>raptor_syntax_description</code> now has an array of URI
strings instead of a single one, to allow URI aliasing. This is
primarily for use by Rasqal.</p>
<p>Fixed guessing by URI in
<code>raptor_world_guess_parser_name()</code> which was not
working.</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=405">0000405</a>: RDFa parser does not handle base href with single quoted value</li>
</ul>
<h2 id="rel1_9_1"><a name="rel1_9_1">Raptor 1.9.1 Changes</a></h2>
<p>1.9.1 is the second beta release of Raptor 2 and intended to be
the last release before 2.0.0.
</p>
<h3>Raptor V1 to V2 upgrading changes</h3>
<p>Improved the <code>upgrade-script.pl</code> raptor V1 to V2
upgrade script to handle changes to enums and macros as well as
handle statement field renaming. Updated the generated documentation
to also include enum and macro changes.
</p>
<p>Added defensive code in each constructor to check the passed-in
raptor world object is a valid Raptor V2 world rather than V1. It
generates a warning once per run of the program.
</p>
<p>The <code>raptor_new_world()</code> function is now a macro that
calls an internal function <code>raptor_check_world_internal()</code>
with a version macro argument to detect when Raptor V2 is invoked with
an inconsistent header and library.
</p>
<h3>AVLTree class changes</h3>
<p>Free the iterator at the end of debug method
<code>raptor_avltree_print()</code>.
</p>
<h3>I/O Stream class changes</h3>
<p>Fix major copying too much error in the internal
<code>raptor_read_string_iostream_read_bytes()</code> memcpy that
could cause crashes - the function always copied the maximum amount
the user requested in the read method even if the string was
smaller.</p>
<h3>Parser class changes</h3>
<p>JSON parser: Made relative URIs option work.
</p>
<p>N-Quads parser: Added. The serializer already existed.</p>
<p>librdfa parser: Updated to latest librdfa GIT
1a1a08c790b7649a7f6c12fb9e40c0d3dbe70481</p>
<h3>Serializer class changes</h3>
<p>Fix <code>raptor_serializer_start_to_iostream()</code> to prevent
crash when this method is used more than once on the same
serializer.</p>
<p>RSS/Atom serializer: Fix crashes with feeds containing entries
with blank node items.
</p>
<h3>Stringbuffer class changes</h3>
<p>Added utility methods
<code>raptor_stringbuffer_append_uri_escaped_counted_string()</code>
and <code>raptor_stringbuffer_append_hexadecimal()</code>.
</p>
<h3>Term class changes</h3>
<p>Deleted <code>raptor_term_as_counted_string()</code> and
<code>raptor_term_as_string()</code>. Since 1.9.0 was an unstable
API, this is allowed.
</p>
<p>Added <code>raptor_term_to_counted_string()</code> replacing
deleted <code>raptor_term_as_counted_string()</code>.</p>
<p>Added <code>raptor_term_to_string()</code> replacing
deleted <code>raptor_term_as_string()</code>.</p>
<h3>URI class changes</h3>
<p>Added convenience methods for constructing URI terms from strings:
<code>raptor_new_term_from_counted_uri_string()</code> and
<code>raptor_new_term_from_uri_string()</code>.
</p>
<p>Use string lengths in equals and comparisons for faster checking.
Use <code>memcmp()</code> instead of <code>strncmp()</code> when
lengths are known and the same.
</p>
<h3>WWW class changes</h3>
<p>The CURL WWW module now looks for and uses the HTTP response
<code>Content-Location:</code> header to get the base URI for content
retrievals. This allows these base URIs to be used in parsing
content retrived from URIs.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=402">Issue #0000402</a>
</p>
<h2 id="rel1_9_0"><a name="rel1_9_0">Raptor 1.9.0 Changes</a></h2>
<p>1.9.0 is the first beta release of Raptor 2. There may be changes
and additional releases before version 2.0.0 with the final stable API.
</p>
<p>This is a major update and cleanup to the Raptor API and ABI with
additions, removals and changes. There are also major restructurings
of the internal code and cleanups. There are also some new features
in the form of additional APIs, new serializers and parsers.
</p>
<p>The details of the additions, removals and changes of functions,
structures, typedefs and enums are listed in the
<a href="https://librdf.org/raptor/api/">Raptor 2 API reference manual</a>
section on
<a href="https://librdf.org/raptor/api/raptor-changes.html">Changes between raptor 1.4.21 and 1.9.0</a>.
The <a href="UPGRADING.html">upgrading document</a>
explains how to upgrade existing code that uses the V1 APIs to use
the new APIs.
</p>
<p>The major changes in this release are:</p>
<ul>
<li>Removed all deprecated functions and typedefs.</li>
<li>Renamed all functions to the standard <code>raptor_</code><em>class</em><code>_</code><em>method</em> form.</li>
<li>All constructors take a <code>raptor_world</code> argument.</li>
<li>URIs are interned and there is no longer a swappable implementation.</li>
<li>Statement is now an array of 3-4 RDF Terms to support triples and quads.</li>
<li>World object owns logging, blank node ID generation and describing syntaxes.</li>
<li>Features are now called options and have typed values.</li>
<li>GRDDL parser now saves and restores shared libxslt state.</li>
<li>Added serializers for HTML 'html' and N-Quads 'nquads'.</li>
<li>Added parser 'json' for JSON-Resource centric and JSON-Triples.</li>
<li>Switched to GIT version control <a href="https://github.com/dajobe/raptor">hosted by GitHub</a>.</li>
<li>Added memory-based AVL-Tree to the public API.</li>
</ul>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=357">0000357</a>: raptor_term_as_string does not return N-Triples escaped string, although API says so</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=361">0000361</a>: HTML Table serializer</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=369">0000369</a>: Unescaped quotes in long literals (Turtle/N3) cause parser failure if at the end of the literal</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=370">0000370</a>: Odd behaviour regarding the parsing of Trig files</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=373">0000373</a>: Remove deprecated GTK symbols</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=379">0000379</a>: raptor libxslt security policy conflicts with apps that also use libxslt and set security policy</li>
</ul>
<!-- updated to 2010-08-15 ChangeLog changes -->
<h3>General changes</h3>
<p>Renamed the library name and package tarball name to a new
separate names (libraptor2, raptor2-X.tar.gz) so they can be
distinguished and installed into the same system as raptor 1 without
file clashes. Note: This does not apply to the
<code>rapper(1)</code> utility and it's manual page which are in both
packages. Packagers should stop packaging the <code>rapper(1)</code>
binary and the rapper manual page from raptor 1, in preference to the
raptor 2 version.
</p>
<p>Nicholas J Humfrey is a new committer.
</p>
<p>A utility script <code>docs/upgrade-script.pl</code> is
automatically generated from the changes data to aid migrating from
Raptor 1 to Raptor 2 APIs. If it is not a simple rename, the script
annotates the change as a comment near the code.
</p>
<p>Raptor's Statement, Term and URI classes can fully replace
librdf's <code>librdf_statement</code>, <code>librdf_node</code> and
<code>librdf_uri</code> classes. This has been tested with GIT
versions when both Rasqal and librdf are configured with
<code>--with-raptor2</code>. When raptor 2 is stable, Rasqal and
librdf will default to use these..
</p>
<h3>Documentation changes</h3>
<p>The API reference manual now includes an automatically generated
reference section on the
<a href="https://librdf.org/raptor/api/raptor-formats.html">functions and types that were added, removed and changed between raptor 1 and raptor 2 APIs</a>.
It also includes an automatically generated section on the
<a href="https://librdf.org/raptor/api/raptor-formats.html">parser and serializers with their names, mime types and Q values.</a>
</p>
<p>The tutorial examples were updated to the Raptor 2 APIs.
</p>
<p>NOTE: At this time, the descriptive parts of the tutorial have NOT
been updated to use the Raptor 2 API.
</p>
<h3>World class changes</h3>
<p>A log handler function for receiving warnings and errors (fatal or
other) are now all sent to a single log handler of type
<code>raptor_log_handler</code> registered to the world class with
<code>raptor_world_set_log_handler()</code>, rather than handlers set
for each parser, sax2, serializer or www instance. Several
constructors lose error handler and error data parameters
consequently.
</p>
<p>The enumerating approach for listing the known parsers and
serializers and writing into variables passed in, was replaced with
methods that return pointers to static
<code>raptor_syntax_description</code> objects to allow more
parameters to be returned. This allowed the removal of multiple
older calls that kept having to gain new return arguments.
The description also returns a list of (mime type, qname) pairs
using a new typedef <code>raptor_type_q</code>. It includes a set
of bitflags for some simple information such as
<code>RAPTOR_SYNTAX_NEED_BASE_URI</code> to describe when
a syntax requires a base URI passed in, otherwise is not needed
or optional.
</p>
<p><code>raptor_world_set_libxml_flags()</code> is replaced with
<code>raptor_world_set_flag()</code> which are simple flags that
require no initialisation of the world since they are used before it
is opened. This means that it cannot use the Options module for
world flags. New flag
<code>RAPTOR_WORLD_FLAGS_URI_INTERNING</code> allows disabling of
the URI interning using an AVL-Tree which can use up memory.
</p>
<p><code>raptor_world_set_libxslt_security_preferences()</code> and
<code>raptor_world_set_log_handler()</code> gains an int return value
to report failure if world is already opened.
</p>
<p>Moved the generation of blank node IDs from the parsers (many
objects) to the world class (1 object). Cannot think of good reasons
why the blank node ID generation policy needs to be different
per-parser. Enumeration <code>raptor_genid_type</code> was deleted
since only the blank node type was ever used.
</p>
<h3>AVL Tree changes</h3>
<p>The internal memory-based AVL Tree implementation is exposed as a
public API.
</p>
<h3>Features changes</h3>
<p>Replaced with <code>raptor_options</code></p>
<h3>Identifier class changes</h3>
<p>Replaced with Term class.
</p>
<p><code>raptor_identifier_type</code> enum was removed and replaced
with enum <code>raptor_term_type</code> and a smaller set of 3
possible term types. The enum values match the int values used
in <code>librdf_node_type</code>.
</p>
<h3>I/O Stream class changes</h3>
<p>Constructors all gain a world argument.
</p>
<p>Some methods now return an int error status such as
<code>raptor_iostream_write_end()</code>
</p>
<p>Many classes iostream writing methods and methods of the iostream
class itself were changed to follow the standard
<code>raptor_</code><em>CLASS</em><code>_write</code> naming
convention and to put the iostream argument at the end.
</p>
<p>Deprecated typedef <code>raptor_iostream_handler</code> was removed</p>
<p>Deprecated functions were removed:
<code>raptor_new_iostream_from_handler()</code>,
<code>raptor_iostream_get_bytes_written_count()</code> and
<code>raptor_iostream_write_string_turtle()</code>
</p>
<h3>Locator changes</h3>
<p>Renamed some methods to follow the
<code>raptor_locator_</code><em>method</em> standard.
</p>
<h3>Namespaces and namespace stack classes changes</h3>
<p>Constructors all gain a world argument and lose error handler,
error data arguments.
</p>
<h3>Options</h3>
<p>A new name for what were called features in Raptor 1 and this was
expanded to allow use of values types string, integer and boolean.
Options can be set on multiple classes such as parser, serializer but
are centrally described using the new
<code>raptor_option_description</code> structure.
</p>
<p>The option get / set operations were reduced from multiple methods
per class for getting / setting an int, int / string to just one get
and one set, with optional parameters. It can also handle adding new
types later, which will be passed in as strings and converted
internally.
</p>
<p>The options code
introduces a new enum <code>raptor_domain</code> which essentially is
for describing a class such as parser.
For example options listed
for domain <code>RAPTOR_DOMAIN_PARSER</code> will be usable with the
parser option get and set methods
<code>raptor_parser_get_option(parser, ...)</code> and
<code>raptor_parser_set_option(parser, ...)</code>.
</p>
<h3>Parser class changes</h3>
<p><code>raptor_parser_set_strict()</code> was removed and replaced
with a new parser option <code>RAPTOR_OPTION_STRICT</code>.
</p>
<p>Parser object methods to return information about the parser class
were removed since they can be done instead via fields of the static
object returned from
<code>raptor_world_get_parser_description()</code>. Deleted
functions include <code>raptor_parser_get_label()</code>,
<code>raptor_parser_get_mime_type()</code>, and
<code>raptor_parser_get_need_base_uri()</code>.
</p>
<p>Parsing may generate start graph and end graph events for syntaxes
that return graph names such as TRiG. These are returned by the handler
of typedef <code>raptor_graph_mark_handler</code>
set by new function <code>raptor_parser_set_graph_mark_handler()</code>
which returns a start or end event of type enum
<code>raptor_graph_mark_flags</code>.
</p>
<p><code>raptor_parser_get_accept_header()</code> fixed length of
static string to ensure NUL is copied.
</p>
<p>Many functions were renamed to match the
<code>raptor_parser_</code><em>method</em> naming standard. Some of
these get a long longer, but are at least consistent. For example
<code>raptor_parse_uri()</code> becomes
<code>raptor_parser_parse_uri()</code>.
</p>
<p>Deprecated typedef <code>raptor_ntriples_parser</code> was removed.
</p>
<p>Deprecated functions were removed:
<code>raptor_ntriples_term_as_string()</code>, and
<code>raptor_ntriples_string_as_utf8_string()</code>
</p>
<p>The librdfa parser was updated with the latest updates to the RDFa
syntax (first, rel/rev, whitespace, xml:lang) and fixes issues with
non-terminated strings.
</p>
<p>The GRDDL parser now saves and restores the libxslt global state
(handlers, security preferences) so that it does not affect other
applications in the same memory space. Part of this can be
overridden with
<code>raptor_world_set_libxslt_security_preferences()</code> which
allows user code to disable raptor touching the security preferences
entirely.
Fixes
<a href="https://bugs.librdf.org/mantis/view.php?id=379">Issue #0000379</a>
</p>
<p>The RDF/XML parser never generated special names for bag IDs
(bagidNNN), so all support for that has been removed.
</p>
<p>The RDF/XML parser uses the new reference-counted URIs and raptor
terms to prevent a lot of malloc/free for temporary uses.
</p>
<p>Removed RDF/XML parser feature
<code>RAPTOR_FEATURE_ASSUME_IS_RDF</code> since it did nothing since
at least 2003, maybe earlier.
</p>
<p>Added a JSON parser (name 'json') that can read both the
resource-centric and triples JSON RDF formats. Requires the YAJL
JSON parser library. Contributed by Nicholas J Humfrey.
</p>
<p>Moved the generation of blank node IDs from the parsers (many
objects) to the world class (1 object). Cannot think of good reasons
why the blank node ID generation policy needs to be different
per-parser.
</p>
<h3>QName class changes</h3>
<p>Constructors all gain a world argument and lose error handler,
error data arguments.
</p>
<h3>Sequence changes</h3>
<p>Use new generic <code>raptor_data_free_handler</code>,
<code>raptor_data_print_handler</code>,
<code>raptor_data_context_free_handler</code>,
<code>raptor_data_context_print_handler</code>
data-focused handlers which are shared with the AVL Tree.
</p>
<h3>Serializer class changes</h3>
<p>Added <code>raptor_serializer_flush()</code> for user code to
indicate to a serializer to flush state since the application knows a
block has been ended, or it needs to save memory. No serializer
currently implements this, but it is expected the abbreviated
serializers that use a lot of state - Turtle, RDF/XML-Abbrev - would
benefit from this.
</p>
<p>Added an HTML Table serializer with name 'table' contributed by
Nicholas J Humfrey.
</p>
<p>Removed the obsolete 'simple' serializer from the source code.
N-Triples is an appropriate simple (and well-defined) replacement
syntax.
</p>
<h3>Statement class changes</h3>
<p>This was made a more regular class that can be created, copied and
freed using reference counting. The structure changed to be an
array of 4 raptor terms rather than a complex union focused on
the allowed RDF Statements. This change allows representing
non-RDF triples as well as triples with named graphs (also known as
quads).
</p>
<p><code>raptor_statement_part_as_counted_string()</code> turns into
a method of the new Term class, as a "statement part" is now
represented as a Term.
</p>
<h3>Term class changes</h3>
<p>This new class with an open structure replaces
<code>raptor_identifier</code> and was created to represent an RDF
Term: literal, URI or blank node and is reference counted and
dynamic. It is a union of fields for three types.
</p>
<p>This class can fully replace librdf's librdf_node when both Rasqal
and librdf are built with <code>--with-raptor2</code>. The
semantics of comparison (ordering) and equality are the same.
</p>
<h3>Unicode changes</h3>
<p>Several utility functions were renamed to match their
functionality more accurately and be associated with the Unicode
module set of functions. For example <code>raptor_utf8_check()</code>
was renamed to <code>raptor_unicode_check_utf8_string()</code>
</p>
<h3>URI class changes</h3>
<p>The whole concept of URI handlers was removed, there is no longer
a way to replace the implementation of the URI class. The
implementation built in now interns URIs string so that a single URIs
for a string is only ever in memory once, but reference counted. This
is what Redland librdf has done for many years, and librdf can fully
use this.
</p>
<p>Deprecated functions were removed:
<code>raptor_uri_is_file_uri()</code>.
</p>
<p>The <code>raptor_uri_resolve_uri_reference()</code> now returns the
length of the URI written into the buffer.
</p>
<h3>WWW class changes</h3>
<p>Rename several of the functions to the standard constructor,
destructor and method naming format.
</p>
<h3>XML Writer class changes</h3>
<p>Constructors all gain a world argument and lose error handler,
error data arguments.
</p>
<h3>Configuration changes</h3>
<p>Added configure argument <code>--with-yajl=DIR</code> (or 'no') to
set the prefix where YAJL libraries and headers are installed.
</p>
<p>Raptor headers are now installed in a sub-directory of
<em>PREFIX</em><code>/include</code>.
</p>
<p><code>raptor-config</code> was removed. Building against raptor 2
should be done only using <code>pkg-config</code> with either
<code>--cflags</code> or <code>--libs</code> arguments like this:</p>
<pre>
cc -o prog prog.c `pkg-config raptor2 --cflags` `pkg-config raptor2 --libs`
</pre>
<h3>Internal changes</h3>
<p>Code style: lots of changes mostly adding lots more whitespace
such as to show control change (if, while) or early function exit
(return).
</p>
<p>All <code>strcpy()</code> with known lengths and
<code>strncpy()</code> were replaced with <code>memcpy()</code> which
is quicker and compilers optimize better.
</p>
<p>Code style:
use <code>TYPE* var_name = RAPTOR_CALLOC(TYPE, 1, sizeof(*var_name))</code>
rather than repeat the type name which can be error-prone.
</p>
<p>Code style: put whitespace round assignment and operators i.e.
use <code>c = a + b</code> rather than <code>c=a+b</code>.
</p>
<p>Code style: removed some <code>strdup()</code>s.
</p>
<p>Code style: try to remove un-necessary <code>strlen()</code> by
tending to pass around a string with it's length, a counted string.
This meant adding a few new constructors such as for the URI and Term
classes.
</p>
<p>Code style: methods called with a NULL object return failure
and destructors called with a NULL object return silently rather than
the former mix of crashing or <code>abort()</code>ing.
</p>
<p>Code style: copy constructor is now called
<code>raptor_</code><em>class</em><code>_copy()</code> rather than
<code>raptor_new_</code><em>class</em><code>_from_</code><em>class</em><code>()</code>
for brevity.
</p>
<p>Code style: print methods return an int return status indicating
success.
</p>
<h3>rapper Utility changes</h3>
<p>Print out the option types next to the description in the <code>-f
help</code> usage message.
</p>
<p>Removed unused <code>-a</code> flag from code.
</p>
<p>Did NOT rename <code>-f</code> option to match the renaming of
features to options in the API. Not needed.
</p>
<p>Removed long deprecated <code>-n</code> flag which was shortcut for
selecting the N-Triples parser and can be done with <code>-i ntriples</code>
</p>
<p>Removed <code>-s/--scan</code> flag since it is an option of a
single parser (RDF/XML) which can be done with <code>-f/--feature
scanForRDF</code>.
</p>
<h3>Other changes</h3>
<p>Removed support for building raptor with dmalloc debugging
(removing <code>--with-dmalloc</code> configure argument). Valgrind
wins.
</p>
<p>The example 'grapper' GNOME GUI utility for raptor was updated
to the latest GTK APIs (2.5.0+ but still quite old) so that it
builds with all the GTK 'disable deprecated' flags set. The
UI is not quite correct though - the preferences menu is broken.
</p>
<p>Switched to GIT version control, hosted by GitHub. The latest
raptor 1 code is available on branch 'raptor1' as well as from the
release tags for specific versions.
</p>
<!-- *************** 1.4.X Series ******************************** -->
<h2 id="rel1_4_21"><a name="rel1_4_21">Raptor 1.4.21 Changes</a></h2>
<p>This is a bug fix only release with no new features. New
development has moved to raptor 2 where a planned ABI and API break
is underway.
</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=318">0000318</a>: Cannot end a Turtle literal with \\ inside triple-quotes</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=319">0000319</a>: ntriples parser does not register that it accepts ntriples mime type - text/plain</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=326">0000326</a>: Turtle parser allows '.' in qnames which is not-to-spec</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=331">0000331</a>: Turtle long literals with raw newlines do not count line numbers correctly</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=332">0000332</a>: RDFXML parser finds duplicates and misbehaves (when it shouldn't)</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=337">0000337</a>: raptor/turtle outputs invalid qnames which cause syntax errors on parsing</li>
</ul>
<h3>Parser changes</h3>
<p>N-Triples parser: Declare acceptance of text/plain mime type with
q=0.1
</p>
<p>RDFA parser (via librdfa): Updated to fix some buffer management
problems when it was passed large blocks (4096 bytes or more), a few
memory leaks and some other minor bugs.
</p>
<p>RDF/XML parser: Properly reset the ID-checking set at the start of
each parse.
</p>
<p>Turtle parser: Allow \\ at the end of triple-quoted literals.
Forbid '.'s in prefixes and qnames (follow specification).
Properly count newlines inside the literals for error reporting.
</p>
<h3>Serializer changes</h3>
<p>Turtle serializer: Forbid '.'s in prefixes and qnames (follow
specification).
</p>
<h3>Other Changes</h3>
<p>Updated <code>configure</code> and the build system to use silent
rules for the maintainer (by default), or when
<code>--enable-silent-rules</code> is passed to
<code>configure</code>. This feature requires building with automake
1.11 which requires autoconf 2.62 or newer when building from GIT.
</p>
<p><code>autogen.sh</code> script was updated to enforce the
autotools versions above.
</p>
<h2 id="rel1_4_20"><a name="rel1_4_20">Raptor 1.4.20 Changes</a></h2>
<p>This is a bug fix only release with no new features. New
development has moved to raptor 2 where a planned ABI and API break
will happen. There may be preview releases of raptor 2 with 1.9.x
numbering.
</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=306">0000306</a>: rapper doesn't handle datatype=""and xml:lang="" properly with RDFa</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=307">0000307</a>: configure fails at vnsprintf test when cross compiling</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=310">0000310</a>: Raptor does not like single character namespaces with RDFa</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=312">0000312</a>: Ununitialized pointer in example rdfserialize.c causes crash</li>
</ul>
<h3>Parser Changes</h3>
<p>
GRDDL parser: Fix XML parser context resource leak if
<code>raptor_grddl_fetch_uri()</code> fails. Save and restore error
handlers properly to prevent crashes when an error is reported during
parsing.
</p>
<p>
RDFA parser (via librdfa): Update to latest librdfa GIT sources with head
a438ce68a40e04b399ec2b2c613d0c867d9315c7 <br />
now moved to
<a href="https://github.com/msporny/librdfa">https://github.com/msporny/librdfa</a>
to fix handling single character namespaces
(<a href="https://bugs.librdf.org/mantis/view.php?id=310">Issue #0000310</a>),
empty datatype attribute and empty xml:lang attributes
(<a href="https://bugs.librdf.org/mantis/view.php?id=306">Issue #0000306</a>)
</p>
<p>Added three unapproved RDFa tests 0172, 0173 and 0174 to cover the
fixes above.
</p>
<h3>Serializer Changes</h3>
<p>
Turtle serializer:
Applied scalability patch from Chris Cannam.
This switches the serializer to use a <code>raptor_avltree</code>
instead of a <code>raptor_sequence</code> for the subject and blanks
used with <code>raptor_abbrev_node_lookup()</code>. This fixes a
performance problem in the serializing and moves lookups from O(N) to
O(log N) - from list to balanced tree.
</p>
<h3>Other Changes</h3>
<p>If cross compiling, check for <code>vsnprintf()</code> C99 compatible at
runtime by setting define <code>CHECK_VSNPRINTF_RUNTIME</code> during
configuration.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=307">Issue #0000307</a>
</p>
<p>Use <code>calloc()</code> for allocating a <code>raptor_statement</code> in
rdfserializer.c example code to properly initialise state.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=312">Issue #0000312</a>
</p>
<p>Use <code>AC_SYS_LARGEFILE</code> to get large file IO checks which
allows 32-bit systems to read multi-gigabyte files.
</p>
<p><code>autogen.sh</code> script fix for if test when uname is not in
standard OSX dir.
</p>
<h2 id="rel1_4_19"><a name="rel1_4_19">Raptor 1.4.19 Changes</a></h2>
<blockquote>
<p><strong>WARNING: FUTURE ABI and API CHANGES.</strong> The next
release of raptor 1.4.x will include bug fixes only and no new
features. New development will move to raptor 2 where a planned ABI
and API break will happen. There may be preview releases of raptor 2
with 1.9.x numbering.</p>
</blockquote>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=259">0000259</a>: Fix NFC check for legal combiner sequence</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=262">0000262</a>: Error when <code>raptor_new_uri()</code> fails in Turtle parser</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=263">0000263</a>: Invalid turtle output syntax on empty integer/double/decimal literals </li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=266">0000266</a>: Default/atom namespace in atom serializer output</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=269">0000269</a>: strstr is called in <code>raptor_parse_chunk()</code> on a buffer string, where it should be called on a null-terminating string.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=270">0000270</a>: RSS serializer fixes for g++</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=276">0000276</a>: Fix <code>raptor_sequence_set_at()</code> when setting beyond end</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=277">0000277</a>: broken collection abbreviation in turtle serialization</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=287">0000287</a>: Fix <code>raptor_sax2_parse_chunk()</code> calling <code>raptor_log_error_to_handlers()</code> with expat</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=288">0000288</a>: raptor_get_feature function does not return feature value</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=289">0000289</a>: Fix RDFa parser problem when there is a subject and predicate specified on an element, but no child nodes for the object literal</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=290">0000290</a>: Fix performance problems when turtle parsing with lots of namespaces</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=293">0000293</a>: Fix RDF/XML Parser problem with legacy ordinal predicates</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=296">0000296</a>: Avoid calling <code>xsltSetDefaultSecurityPrefs()</code></li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=299">0000299</a>: Avoid calling <code>xmlSetStructuredErrorFunc()</code> and <code>xmlSetGenericErrorFunc()</code></li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=303">0000303</a>: rdfa parser does not parse content as RDFa which librdfa+expat alone handles</li>
</ul>
<h3>Parser Changes</h3>
<p><code>raptor_get_feature()</code> now returns the integer value rather than
just 1 or 0.<br />
<a href="https://bugs.librdf.org/mantis/view.php?id=288">Issue #0000288</a>
</p>
<p>Guess parser: return name of guessed parser not 'guess'.
</p>
<p>N-Triples parser:
Produce error messages when raptor_new_uri() fails. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=262">Issue #0000262</a>
</p>
<p>RDFa parser:
Fix problem when there is a subject and predicate specified on an
element, but no child nodes for the object literal using
latest librdfa GIT source with head
2ddcb3f9e010d0b3d9ee546e807539be5da1b14a <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=289">Issue #0000289</a>
</p>
<p>RSS tag soup parser:
Huge internal changes:<br />
Recording more atom core structures in triples (such as author, contributor -
person) rather than only channels and items<br />
Introduced a new 'blocks' concept to record single element structured
items such as atom category, link and rss enclosure<br />
Added itunes namespace and container.<br />
</p>
<p>RDF/XML Parser:
Adjust predicate_type when removing ordinal identifier type from predicate. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=293">Issue #0000293</a>
</p>
<h3>Serializer Changes</h3>
<p>Atom 1.0 serializer:
Now tested and takes more care to try to generate valid Atom 1.0
</p>
<p>Turtle serializer:
Validate XSD integer, decimal and double literal
output. Emit special short forms only if the whole literal value is
consumed by <code>strtol()</code> (for integers) or
<code>strtod()</code> (for decimals and doubles). Otherwise produce a
warning and emit literal in the normal
<code>"value"^^<datatype_uri></code> format. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=263">Issue #0000263</a><br />
Fix broken collection abbreviation<br />
<a href="https://bugs.librdf.org/mantis/view.php?id=277">Issue #0000277</a><br />
</p>
<p>RSS serializer:
Fixes for g++ <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=270 ">Issue #0000270</a>
<br />
Added a new serializer feature
<code>RAPTOR_FEATURE_PREFIX_ELEMENTS</code> (short name
prefixElements) for atom and rss 1.0 serializers to decide whether
core elements in the default namespace are declared with the prefix
or without a prefix.<br />
Removed generation of deprecated predicate ordinals of type
<code>RAPTOR_IDENTIFIER_TYPE_ORDINAL</code> and replace with resource type URIs
</p>
<h3>XML Support Changes</h3>
<p>Removed generic calls to <code>xmlSetStructuredErrorFunc()</code>
and <code>xmlSetGenericErrorFunc()</code> which can be a problem when
libxml is shared with other code in memory. They may be called
optionally but will do a save/restore of the existing functions.
This protection is enabled by the new API call
<code>raptor_set_libxml_flags()</code> to set the flags from values
in enum <code>raptor_libxml_flags</code>. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=299">Issue #0000299</a>
</p>
<p>Use context-specific libslt security configuration to avoid
calling generic call <code>xsltSetDefaultSecurityPrefs()</code> which
can be a problem when libxslt is shared with other code in memory.
Allow the user to set the policy for raptor globally with new API
function <code>raptor_set_libxslt_security_preferences()</code>. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=296">Issue #0000296</a>
</p>
<p>Make libxml SAX2 structured errors register parser-specific
handler function <code>raptor_libxml_xmlStructuredErrorFunc()</code>
instead of libxml global structured error handler. The libxml flag
method above can still enable registerding the global error handlers.
</p>
<p>In <code>raptor_sax2_parse_chunk()</code> fixed calls to
<code>raptor_log_error_to_handlers()</code> when built with expat. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=287">Issue #0000287</a>
</p>
<h3>Other Changes</h3>
<p>Win32 portability fixes from Lou Sakey:</p>
<ul>
<li>Handle absence of <code>gettimeofday()</code></li>
<li>Call <code>xmlCleanupParser()</code> libxml call last to avoid an access
violation on windows.</li>
<li>Windows <code>vsnprintf()</code> portability patch</li>
<li><code>raptor_sequence_set_at()</code> fixed to maintain the design
contract: provide "size" consecutive items in "sequence" starting from
"start" even when setting items more than +1 offset beyond the end of
sequence. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=276">Issue #0000276</a>
</li>
</ul>
<p><code>rapper(1)</code> utility changes: if counting, do not use a
serializer at all.
</p>
<h3>Internal Changes</h3>
<p>More internal changes to be more resiliant after allocation failure
(Lauri Aalto)
</p>
<p>Reorganised tests in source tree to pull out specific directories
for RDF/XML, Turtle, etc.
</p>
<p>Use a DJ Bernstein hash to replace a linked list for storing a
stack of namespaces. This makes turtle parsing with lots of
namespaces (100s) much faster. Based on the initial patch in the bug. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=290">Issue #0000290</a>
</p>
<p>Use new internal <code>raptor_memstr()</code> function to compare
a string against a buffer that may not be NUL terminated. <br />
<a href="https://bugs.librdf.org/mantis/view.php?id=269">Issue #0000269</a>
</p>
<p><code>raptor_error_handlers</code>: API structure gains world
field. BINARY COMPATIBILITY BREAK: sizeof(raptor_error_handlers)
changed. Source compatibility not broken.
</p>
<p><code>raptor_identifier</code>: API structure gains world
field. BINARY COMPATIBILITY BREAK: sizeof(raptor_identifier)
changed. Source compatibility not broken.
</p>
<p>More fixes for compiling with C++
</p>
<p>Move some more static data as constant to enable more efficient
compilation - moves to data segment of object binary.</p>
<p>Use memmove for overlapping copy, not memcpy when doing relative
URI resolving.
</p>
<h3>Raptor V2 Preparation Changes</h3>
<p>Lots of internal changes were made by Lauri Aalto preparing for
Raptor V2 to fully attach all static data and config to a new
<code>raptor_world</code> object. A new static instance of this
class is now used internally behind the existing V1 API and will be
required to be constructed by the library user for the V2 API with a
new constructor/destructor.</p>
<p><b>NOTE:</b> The method names here are illustrative of the final
V2 names but are not confirmed - <strong>These functions are not
supported in the 1.4.x series</strong>. Some methods will still be
altered for fields and (<code>raptor_world</code>) parameters. All constructors
should have it as a parameter. All methods will not have them (so
for example, all the URI methods named _v2 will lose the world
parameter and just have the URI parameter - but that is also because
the URI handler/context part will go into raptor_world in V2)</p>
<p>To use the <strong>unsupported and experimental</strong> V2
functions, define <code>-DRAPTOR_V2_EXPERIMENTAL=1</code> when
building with raptor.
</p>
<p>Added <code>raptor_world</code> typedef.</p>
<p>Added raptor world class constructor
<code>raptor_world* raptor_new_world(void)</code> and initializer:
<code>int raptor_world_open(raptor_world* world)</code>
</p>
<p>Added world class destructor:
<code>void raptor_free_world(raptor_world* world)</code>
</p>
<p>Added new V2 methods:</p>
<pre>
void raptor_world_set_libxslt_security_preferences(raptor_world *world,
void *security_preferences)
void raptor_world_set_libxml_flags(raptor_world *world, int flags)
void raptor_error_handlers_init_v2(raptor_world* world,
raptor_error_handlers* error_handlers);
</pre>
<p>Added V2 methods that are versions of existing methods, named with
_v2 suffix:</p>
<pre>
int raptor_parsers_enumerate_v2(raptor_world* world,
const unsigned int counter, const char **name, const char **label)
int raptor_syntax_name_check_v2(raptor_world* world, const char *name);
void raptor_print_locator_v2(raptor_world* world, FILE *stream,
raptor_locator* locator);
const char *raptor_locator_uri_v2(raptor_world* world,
raptor_locator *locator);
int raptor_features_enumerate_v2(raptor_world* world,
const raptor_feature feature, const char **name,
raptor_uri **uri, const char **label);
int raptor_serializers_enumerate_v2(raptor_world* world,
const unsigned int counter, const char **name, const char **label,
const char **mime_type, const unsigned char **uri_string);
int raptor_serializer_syntax_name_check_v2(raptor_world* world,
const char *name);
int raptor_serializer_features_enumerate_v2(raptor_world* world,
const raptor_feature feature, const char **name, raptor_uri **uri,
const char **label);
</pre>
<p>Added world pointer to raptor_identifier object</p>
<p>Added V2 identifier class constructor:</p>
<pre>
raptor_identifier* raptor_new_identifier_v2(raptor_world* world,
raptor_identifier_type type, raptor_uri *uri,
raptor_uri_source uri_source, const unsigned char *id,
const unsigned char *literal, raptor_uri *literal_datatype,
const unsigned char *literal_language);
</pre>
<p>Added V2 parser class method:</p>
<pre>
raptor_parser* raptor_new_parser_for_content_v2(raptor_world* world,
raptor_uri *uri, const char *mime_type, const unsigned char *buffer,
size_t len, const unsigned char *identifier)
raptor_world* raptor_parser_get_world(raptor_parser* rdf_parser);
</pre>
<p>Added V2 serializer class constructor and method:</p>
<pre>
raptor_serializer* raptor_new_serializer_v2(raptor_world* world,
const char *name)
raptor_world* raptor_serializer_get_world(raptor_serializer* rdf_serializer)
</pre>
<p>Added V2 statement class <code>raptor_statement_v2</code> typdef
for future replacing of <code>raptor_statement</code></p>
<p>Added V2 statement class methods:</p>
<pre>
void raptor_print_statement_v2(const raptor_statement_v2 * statement,
FILE *stream);
unsigned char* raptor_statement_part_as_counted_string_v2(raptor_world* world,
const void *term, raptor_identifier_type type,
raptor_uri* literal_datatype, const unsigned char *literal_language,
size_t* len_p);
unsigned char* raptor_statement_part_as_string_v2(raptor_world* world,
const void *term, raptor_identifier_type type,
raptor_uri* literal_datatype, const unsigned char *literal_language);
int raptor_statement_compare_v2(const raptor_statement_v2 *s1,
const raptor_statement_v2 *s2);
</pre>
<p>Added V2 uri class methods:</p>
<pre>
unsigned char* raptor_uri_as_counted_string(raptor_uri *uri, size_t* len_p);
raptor_uri* raptor_new_uri_v2(raptor_world* world,
const unsigned char *uri_string);
raptor_uri* raptor_new_uri_from_uri_local_name_v2(raptor_world* world,
raptor_uri *uri, const unsigned char *local_name);
raptor_uri* raptor_new_uri_relative_to_base_v2(raptor_world* world,
raptor_uri *base_uri, const unsigned char *uri_string);
raptor_uri* raptor_new_uri_from_id_v2(raptor_world* world,
raptor_uri *base_uri, const unsigned char *id);
raptor_uri* raptor_new_uri_for_rdf_concept_v2(raptor_world* world,
const char *name);
void raptor_free_uri_v2(raptor_world* world, raptor_uri *uri);
int raptor_uri_equals_v2(raptor_world* world, raptor_uri* uri1,
raptor_uri* uri2);
int raptor_uri_compare_v2(raptor_world* world, raptor_uri* uri1,
raptor_uri* uri2);
raptor_uri* raptor_uri_copy_v2(raptor_world* world, raptor_uri *uri);
unsigned char* raptor_uri_as_string_v2(raptor_world* world, raptor_uri *uri);
unsigned char* raptor_uri_as_counted_string_v2(raptor_world* world,
raptor_uri *uri, size_t* len_p);
raptor_uri* raptor_new_uri_for_xmlbase_v2(raptor_world* world,
raptor_uri* old_uri);
raptor_uri* raptor_new_uri_for_retrieval(raptor_uri* old_uri);
raptor_uri* raptor_new_uri_for_retrieval_v2(raptor_world* world,
raptor_uri* old_uri);
raptor_uri* raptor_new_uri_for_xmlbase_v2(raptor_world* world,
raptor_uri* old_uri);
raptor_uri* raptor_new_uri_for_retrieval_v2(raptor_world* world,
raptor_uri* old_uri);
unsigned char* raptor_uri_to_relative_counted_uri_string_v2(raptor_world* world,
raptor_uri *base_uri, raptor_uri *reference_uri, size_t *length_p);
unsigned char* raptor_uri_to_relative_uri_string_v2(raptor_world* world,
raptor_uri *base_uri, raptor_uri *reference_uri);
void raptor_uri_print_v2(raptor_world* world,
const raptor_uri* uri, FILE *stream);
unsigned char* raptor_uri_to_counted_string_v2(raptor_world* world,
raptor_uri *uri, size_t *len_p);
void raptor_uri_set_handler_v2(raptor_world* world,
const raptor_uri_handler *handler, void *context);
void raptor_uri_get_handler_v2(raptor_world* world,
const raptor_uri_handler **handler, void **context);
</pre>
<p>Added V2 www class methods:</p>
<pre>
raptor_www *raptor_www_new_with_connection_v2(raptor_world* world,
void* connection);
</pre>
<p>Added V2 qname class methods:</p>
<pre>
raptor_qname* raptor_new_qname_from_namespace_local_name_v2(raptor_world* world,
raptor_namespace *ns, const unsigned char *local_name,
const unsigned char *value);
</pre>
<p>Added V2 namespace class methods:</p>
<pre>
raptor_namespace_stack* raptor_new_namespaces_v2(raptor_world* world,
raptor_simple_message_handler error_handler, void *error_data, int defaults);
int raptor_namespaces_init_v2(raptor_world* world,
raptor_namespace_stack *nstack,
raptor_simple_message_handler error_handler, void *error_data,
int defaults);
</pre>
<p>Added V2 sequence class typedefs and methods:</p>
<pre>
typedef void (raptor_sequence_free_handler_v2(void* context, void* object));
typedef void (raptor_sequence_print_handler_v2(void *context, void *object,
FILE *fh));
raptor_sequence* raptor_new_sequence_v2(raptor_sequence_free_handler_v2* free_handler,
raptor_sequence_print_handler_v2* print_handler, void* handler_context);
void raptor_sequence_set_print_handler_v2(raptor_sequence *seq,
raptor_sequence_print_handler_v2 *print_handler);
</pre>
<p>Added V2 iostream class methods:</p>
<pre>
int raptor_iostream_write_uri_v2(raptor_world* world,
raptor_iostream *iostr, raptor_uri *uri);
void raptor_iostream_write_statement_ntriples_v2(raptor_world* world,
raptor_iostream* iostr, const raptor_statement *statement);
</pre>
<p>Added V2 xml writer class methods:</p>
<pre>
raptor_xml_writer* raptor_new_xml_writer_v2(raptor_world* world,
raptor_namespace_stack *nstack, raptor_iostream* iostr,
raptor_simple_message_handler error_handler, void *error_data,
int canonicalize);
int raptor_xml_writer_features_enumerate_v2(raptor_world* world,
const raptor_feature feature, const char **name, raptor_uri **uri,
const char **label);
</pre>
<h2 id="rel1_4_18"><a name="rel1_4_18">Raptor 1.4.18 Changes</a></h2>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=186">0000186</a>: Add RDFa support to Raptor</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=255">0000255</a>: rss-tag-soup serializer does not generate namespaces so re-serializing in rdf/xml looks wierd for atom</li>
</ul>
<h3>Parser Changes</h3>
<p>A new
<a href="https://www.w3.org/TR/2008/CR-rdfa-syntax-20080620/">RDFa</a>
parser was added (name <code>rdfa</code>) using
<a href="http://rdfa.digitalbazaar.com/librdfa/">librdfa</a> to
implement it. librdfa is linked as part of Raptor and
written by Manu Sporny of Digital Bazaar, licensed with the
same license as Raptor.</p>
<p>The RDFa
<a href="https://www.w3.org/2006/07/SWD/RDFa/testsuite/xhtml1-testcases/">test suite</a>
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).</p>
<h3>Serializer Changes</h3>
<p>Added new function
<code>raptor_serialize_start_to_iostream()</code> to have the new
semantics of not owning and destroying the passed-in iostream. This
allows the caller to serialize to an existing iostream and then
to continue to write to it. <code>raptor_serialize_start()</code>
owns and then closes the iostream that is passed in.
</p>
<p>A new Atom Syndication Format 1.0 (<a href="http://www.ietf.org/rfc/rfc4287.txt">RFC 4287</a>) serializer was added (name <code>atom</code>)
using the RSS 1.0 RDF triple model with mapping to atom terms
and consideration of atom output format conditions.
</p>
<p>RSS 1.0 serializer</p>
<ul>
<li>Allow setting output namespaces for the serializer</li>
<li>Allow writing extra RDF triples as RDF/XML attached to RSS items.</li>
<li>Recognize predicates with XML Literal and emit as
<code>parseType="Literal"</code> or when <code>content:encoded</code>,
as a CDATA block, by RSS 1.0 convention.</li>
<li>Removed code assumptions about triples appearing in a certain order.</li>
<li>Free namespaces and stack in correct order</li>
</ul>
<p>Turtle serializer now respects the <code>writeBaseURI</code>
feature to control generating the <code>@base</code> directive.
</p>
<p>Abbreviated serializers (RDF/XML Abbrev and Turtle) now remove
duplicate triples.
</p>
<p>Added feature <code>RAPTOR_FEATURE_RSS_TRIPLES</code> to add RDF
triples to RSS 1.0 or Atom serializer output with values 'rdfxml' or
'atom-triples'. Atom triples writes <code>at:map</code> sections for
the <code>atom:entry</code> elements and at:feedmap and
<code>at:entrymap</code> sections to the <code>atom:feed</code>
elements. <code>at:contentType</code> is used to provide a
<code>type</code> attribute value for an <code>atom:content</code>
that has a URI value.
</p>
<p>Added <code>RAPTOR_FEATURE_ATOM_ENTRY_URI</code> for the Atom
serializer to set the URI of an atom entry. If the URI matches the
URI of an entry item in the RDF mode of the channel, then an Atom
Entry document is generated rather than an Atom Feed document.
</p>
<h3>QName Class Changes</h3>
<p>Added <code>raptor_qname_to_counted_name()</code> to get
a formatted qname for a name.
</p>
<p><code>raptor_new_qname_from_namespace_local_name()</code> will
accept a NULL namespace to construct a namespace-less qname.
</p>
<h3>Sequence Class Changes</h3>
<p><code>raptor_sequence_set_at()</code> now handles
setting an item at an index in the sequence beyond capacity+1
to automatically extend.
</p>
<p>Added <code>raptor_sequence_delete_at()</code> to delete an item
at a position in a sequence and return it.
</p>
<h3>URI Class Changes</h3>
<p><code>raptor_uri_to_relative_counted_uri_string()</code> now
has support for a base URI with scheme and authority but no path,
so the result can be a relative URI starting with '/'.
</p>
<h3>XML Writer Class Changes</h3>
<p>XML Writer allows adding newlines via
<code>raptor_xml_writer_newline()</code> which
requires use of <code>raptor_xml_writer_flush()</code> to indicate
when XML writer output is finished.
</p>
<p>Added <code>raptor_xml_writer_get_depth()</code> to get the current
XML writer element stack depth.
</p>
<h3>Other Changes</h3>
<p>Many more resiliance checks were added.
</p>
<p>Removed all calls to abort() in code on fatal errors. This
requires using setjmp and longjmp inside parsers built with
flex and bison.
</p>
<p>The Turtle writer may optionally generate @base depending on
flags. (This is used by Turtle serializer to handle the writeBaseURI
feature)
</p>
<p>Tidied error messages for <code>rapper(1)</code> when parsing stdin.
</p>
<p>raptor_init() and raptor_finish() use a reference count to ensure
initialising and terminating happen at most once each.
</p>
<h2 id="rel1_4_17"><a name="rel1_4_17">Raptor 1.4.17 Changes</a></h2>
<p>The main changes to this release are:</p>
<p>Added two new JSON serializers: resource-centric 'json'
(Talis <a href="http://n2.talis.com/wiki/RDF_JSON_Specification">RDF/JSON</a>)
and triple-centric 'json-triples'.
</p>
<p>Made I/O Stream class <code>raptor_iostream</code> support
reading as well as writing with new constructors and
new methods.</p>
<p>Added a new public SAX2 API class <code>raptor_sax2</code>
exposing the existing internal API which has been around since the
first release of Raptor 8 years ago and runs on top of either expat
or libxml2.</p>
<p>Added new public error handlers structure
<code>raptor_error_handlers</code> containing a set of
(function, data pointers) pairs called <code>raptor_handler_closure</code>
for each error log level.
Added <code>raptor_log_level</code> enum for the error log level.
Added an initialization function for the structure,
<code>raptor_error_handlers_init()</code>.
</p>
<p>Several other API changes, fixes and improvements were made.</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=252">0000252</a>: Allow controlling of cache headers in Raptor</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=245">0000245</a>: Extra classes added to an OWL object</li>
</ul>
<h3>I/O Stream class changes</h3>
<p>Made I/O Stream class <code>raptor_iostream</code> support
reading data in addition to writing. (Dave B):</p>
<ul>
<li>Deprecated <code>raptor_iostream_handler</code> structure for new
<code>raptor_iostream_handler2</code> structure which contains the
new factory functions for reading.</li>
<li>Added new read I/O stream factory handler typedefs
<code>raptor_iostream_read_bytes_func</code> and
<code>raptor_iostream_read_eof_func</code>.
</li>
<li>Added new <code>raptor_new_iostream_from_handler2()</code> I/O
stream constructor to allow building of read and write iostreams
deprecating <code>raptor_new_iostream_from_handler()</code>.
</li>
<li>Added new <code>raptor_iostream_tell()</code> deprecating
<code>raptor_iostream_get_bytes_written_count</code>.
</li>
<li>Added new read I/O Stream constructors:
<code>raptor_new_iostream_from_sink</code>(),
<code>raptor_new_iostream_from_filename()</code>
<code>raptor_new_iostream_from_file_handle()</code> and
<code>raptor_new_iostream_from_string()</code>
</li>
<li>Added new read I/O Stream methods
<code>raptor_iostream_read_bytes()</code> and
and <code>raptor_iostream_read_eof()</code>.
</li>
</ul>
<p>Added new write I/O Stream method
<code>raptor_iostream_write_string_python()</code> to write an
encoded string to an I/O stream using python / JSON / Turtle /
N-Triples / SPARQL escaping rules. (Dave B)
</p>
<h3>Serializer Class Changes</h3>
<p>Added two new JSON serializers (Dave B):</p>
<ol>
<li>Resource-centric serializer named <code>json</code> based on
<a href="http://n2.talis.com/wiki/RDF_JSON_Specification">Talis RDF/JSON Specification</a></li>
<li>Triple-centric serializer named <code>json-triples</code> based on the SPARQL results in JSON format.</li>
</ol>
<p>Added new serializer features for the JSON serializers (DaveB):</p>
<ul>
<li><code>RAPTOR_FEATURE_JSON_CALLBACK</code> (name 'jsonCallback') to
set the top-level callback function name wrapper above the outer object.</li>
<li><code>RAPTOR_FEATURE_JSON_EXTRA_DATA</code> (name 'jsonExtraData') to
add extra top-level JSON object data.</li>
</ul>
<p>Example of using the resource-centric serializer while defining a
callback:</p>
<pre>
$ rapper -q -o json -f jsonCallback=foo https://librdf.org/raptor/raptor.rdf
foo(
{
"https://librdf.org/raptor/#raptor" : {
"http://usefulinc.com/ns/doap#description" : [ {
...
</pre>
<h3>Statement Class Changes</h3>
<p>Added <code>raptor_statement_compare()</code> to provide an
ordering between <code>raptor_statement</code> objects. (Dave B)
</p>
<h3>Parser Class Changes</h3>
<p>Added new parser features to control HTTP headers in
web requests (Dave B, based on a patch in the bug):<br />
Also never <code>Pragma:</code> header with libcurl ever.<br />
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=252">Issue #0000252</a>
</p>
<ul>
<li><code>RAPTOR_FEATURE_WWW_HTTP_CACHE_CONTROL</code> to control
sending <code>Cache-Control</code> (default: none)</li>
<li><code>RAPTOR_FEATURE_WWW_HTTP_USER_AGENT</code> to control
sending <code>User-Agent</code> (default: none)</li>
</ul>
<p>Turtle parser:</p>
<ul>
<li>Added tests to forbid <code>'</code> and
<code>'''</code>-quoted strings and to forbid <code>()</code> in
triple predicate position following the updated Turtle spec. (Dave B)</li>
<li>Write ';' statement terminators with a leading
space for consistency with '.' terminator. (Dave R)</li>
<li>Remove canonicalisation of integer and double
to match Turtle latest spec. (Dave B)</li>
</ul>
<h3>QName Class Changes</h3>
<p>Added new methods <code>raptor_qname_get_local_name()</code>,
<code>raptor_qname_get_value()</code> and
<code>raptor_qname_get_counted_value()</code>. (Dave B)
</p>
<h3>SAX2 Class Changes</h3>
<p>Added new public SAX2 API class <code>raptor_sax2</code> exposind
th existing internal one which has been around since the first
release of Raptor 8 years ago and runs on top of either expat or
libxml2. (Dave B)</p>
<ul>
<li>Constructor: <code>raptor_new_sax2()</code></li>
<li>Destructor: <code>raptor_free_sax2()</code></li>
<li>XML handler methods:
<code>raptor_sax2_set_start_element_handler()</code>,
<code>raptor_sax2_set_end_element_handler()</code>,
<code>raptor_sax2_set_characters_handler()</code>,
<code>raptor_sax2_set_cdata_handler()</code>,
<code>raptor_sax2_set_comment_handler()</code>,
<code>raptor_sax2_set_unparsed_entity_decl_handler()</code> and
<code>raptor_sax2_set_external_entity_ref_handler()</code>.
</li>
<li>XML handler factory typedefs:
<code>raptor_sax2_start_element_handler</code>,
<code>raptor_sax2_end_element_handler</code>,
<code>raptor_sax2_characters_handler</code>,
<code>raptor_sax2_cdata_handler</code>,
<code>raptor_sax2_comment_handler</code>,
<code>raptor_sax2_unparsed_entity_decl_handler</code> and
<code>raptor_sax2_external_entity_ref_handler</code>.
</li>
<li>Set XML Namespace handler method:
<code>raptor_sax2_set_namespace_handler()</code>
</li>
<li>Parsing methods:
<code>raptor_sax2_parse_start()</code> and
<code>raptor_sax2_parse_chunk()</code>
</li>
<li>Other methods:
<code>raptor_sax2_inscope_xml_language()</code> and
<code>raptor_sax2_inscope_base_uri()</code>
</li>
</ul>
<h3>Serializer Class Changes</h3>
<p>Abbreviated serializers (RDF/XML-Abbrev and Turtle):</p>
<ul>
<li>Switched from using a sequence to using an AVL Tree with a cursor
to more efficiently (faster) group/sort triples by subject. This
changes the previous syntax output order but has no semantic
difference. (Dave B)
</li>
<li>Use the AVL Tree to remove duplicate triples. (Dave B)<br />
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=245">Issue #0000245</a>
</li>
</ul>
<p>Turtle serializer:</p>
<ul>
<li>Feature <code>RAPTOR_FEATURE_WRITE_BASE_URI</code>
added to control writing <code>@base</code> directive to Turtle. (Dave R)</li>
<li>Remove canonicalisation of integer and double
to match Turtle latest spec. (Dave B)</li>
</ul>
<h3>URI Class Changes</h3>
<p>Update URI resolving for RFC3986 changes (Dave B)
</p>
<h3>WWW Class Changes</h3>
<p>Added new method <code>raptor_www_set_http_cache_control()</code>
to set the HTTP <code>Cache-Control:</code> header in requests.
(Dave B, based on a patch in the bug) <br />
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=252">Issue #0000252</a>
</p>
<h3>XML Class Changes</h3>
<p>Added new method <code>raptor_xml_element_get_language()</code>
to get the language associated with an element. (Dave B)
</p>
<h3>Portability and Resilience Changes</h3>
<p>Pass on error failures in parser and serializer factory
construction. (Lauri)
</p>
<p>Abbreviated serializers (RDF/XML-abbrev and Turtle): low memory
and allocation failure fixes. (Lauri)
</p>
<p>Altered API function signatures of
<code>raptor_uri_set_handler()</code>,
<code>raptor_uri_get_handler()</code>,
<code>raptor_new_namespaces(),</code>
<code>raptor_namespaces_init()</code> and
<code>raptor_new_xml_writer()</code> to add appropriate
<code>const</code>s. (Lauri)
</p>
<p>Portability fixes for RAPTOR_API and other macros. (Lauri)
</p>
<p>Removal of many sets of writable static data in N-Triples parser, URI
class, Unicode NFC code, libxml support, Turtle writer and XML
writer. (Lauri)
</p>
<p>Portability fixes for <code>round()</code> and
<code>trunc()</code> that are not always available in libc but might
be in libm. (Dave B)
</p>
<p>Turtle/N3 parsers and serializers, RDF/XML_Abbrev serializer: many
low memory fixes and better out of memory errors. (Lauri)
</p>
<h3>Other Changes</h3>
<p>Rewrote internal error log functions to use new error handlers
structures and simplify the calls. (Dave B)
</p>
<p>Expanded internal <code>raptor_avltree</code> datatype support to
add a cursor, allowing it to be used for creating large ordered
sequences that need to be walked. (Dave B)
</p>
<p>Updated <code>rdfdiff</code> utility to handle duplicate triples
in inputs. (Dave B)
</p>
<p><code>raptor_sequence_shift()</code> and
<code>raptor_sequence_unshift()</code> are now as efficient as the
sequence push and pop operations: O(1). (Lauri)
</p>
<p><code>autogen.sh</code> was updated.
</p>
<p><code>rapper</code> utility can now accept multiple
<code>-f</code> / <code>--feature</code> options; previously
only one parser and one serializer feature was possible.
</p>
<h2 id="rel1_4_16"><a name="rel1_4_16">Raptor 1.4.16 Changes</a></h2>
<p>The main changes to this release are:</p>
<p>Provide 100% support for the
<a href="https://www.w3.org/TR/2007/REC-grddl-20070911/">GRDDL W3C Recommendation of 2007-09-11</a>.
</p>
<p>The
<a href="https://www.dajobe.org/2004/01/turtle/">Turtle</a>
parser and serializer were updated to support
<code>@base</code> for specifying a base URI, following
Turtle of 2007-09-11.
</p>
<p>The Turtle and RDF/XML serializers had performance improvements
for large graphs.
</p>
<p>Added a TRiG Parser based on Turtle with named graph support.</p>
<p>Several other API changes, fixes and improvements were made.</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000188">0000188</a>: Wrong RAPTOR_API definition for mingw</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000192">0000192</a>: raptor_uri_filename_to_uri_string() - getcwd() loop error</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000194">0000194</a>: parser and serializer don't recognize the same mime types</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000195">0000195</a>: Compile error in raptor_serialize.c debug code</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000207">0000207</a>: RDF file can be parsed, but not then serialised.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000210">0000210</a>: RAPTOR_FEATURE_WRITER_XML_DECLARATION broken in Ruby</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000214">0000214</a>: Empty rdf:about, plus base-uri, produces incorrect turtle output</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000216">0000216</a>: flickrdf segfaults at raptor_serialize_end!</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000217">0000217</a>: flickrdf segfaults at raptor_serialize_end!</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000232">0000232</a>: libraptor does not correctly free up libxml error handler, causing crashes in subsequent calls to libxml error handlers</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000237">0000237</a>: raptor_sequence robustness: item ownership on insert error</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000238">0000238</a>: GRDDL parser in SVN overwrites blank nodes when merging graphs</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000239">0000239</a>: GRDDL parser in SVN returns 60 less triples with https://www.w3.org/</li>
</ul>
<h3>Namespaces Class Changes</h3>
<p><code>raptor_namespaces_init()</code> now returns an integer
status.
</p>
<h3>Parser Class Changes</h3>
<p>
Added <code>raptor_graph_handler</code> typedef and
<code>raptor_set_graph_handler()</code> to return named graph
identifiers during parsing, initially for the TRiG parser.
</p>
<p>These were added the GRDDL parser:</p>
<ul>
<li><code>RAPTOR_FEATURE_MICROFORMATS</code> (microformats) to enable
hCard and hCal microformats</li>
<li><code>RAPTOR_FEATURE_HTML_TAG_SOUP</code> (htmlTagSoup) to use
the HTML tag soup parser if the XML parsing fails</li>
<li><code>RAPTOR_FEATURE_HTML_LINK</code> (htmlLink) to enable html
<link></li>
<li><code>RAPTOR_FEATURE_WWW_TIMEOUT</code> (wwwTimeout) for setting
URI retrieval timeouts during processing</li>
</ul>
<h3>XML Element Class Changes</h3>
<p>Added
<code>raptor_new_xml_element_from_namespace_local_name()</code>
constructor to make an XML element from a local name relative
to a <code>raptor_namespace</code>.
</p>
<h3>Unicode Class Changes</h3>
<p>Defined a new <code>raptor_unichar</code> typedef for a Unicode
codepoint defined as <code>unsigned long</code> which was the
previous type used. Altered the Unicode function to take it as a
parameter. <code>raptor_unicode_char_to_utf8()</code>,
<code>raptor_utf8_to_unicode_char()</code>,
<code>raptor_unicode_is_xml11_namestartchar()</code>,
<code>raptor_unicode_is_xml10_namestartchar()</code>,
<code>raptor_unicode_is_xml11_namechar()</code> and
<code>raptor_unicode_is_xml10_namechar()</code>.
</p>
<h3>URI Class Changes</h3>
<p>Added <code>raptor_uri_compare()</code> and
<code>raptor_uri_compare_func</code> function pointer for
implementing it in the <code>raptor_uri_handler</code>. The handler
now has a version field <code>initialised</code> to trigger the new
factory method for uri compare when the version is 2 or more.
</p>
<h3>WWW Class Changes</h3>
<p>
Added <code>raptor_www_set_connection_timeout()</code>
to set the WWW retrieval connection timeout in seconds.
</p>
<p>
Added <code>raptor_www_final_uri_handler</code> typedef and
<code>raptor_www_set_final_uri_handler()</code> to return
the final URI seen <em>during</em> WWW retrieval such as after
redirects.
</p>
<p>
Added <code>raptor_www_get_final_uri()</code> to return the final URI
<em>after</em> a WWW retrieval which might include redirects.
</p>
<h3>Parser Changes</h3>
<p>The GRDDL parser/processor was substantially updated and now
supports 100% of the
<a href="https://www.w3.org/TR/2007/REC-grddl-20070911/">Gleaning Resource Descriptions from Dialects of Languages (GRDDL)</a>
syntax, W3C Recommendation of 2007-09-11:
</p>
<ul>
<li>Transforming XML with XSLT 1.0</li>
<li>Processing XML namespaces.</li>
<li>Transforming XHTML with XSLT 1.0</li>
<li>Processing HTML profiles.</li>
<li>Handling of base URIs and URI redirects.</li>
<li>XInclude processing.</li>
<li>Parsing as RDF/XML when it is recognised after a transform.</li>
</ul>
<p>it also:</p>
<ul>
<li>Handles hCard and hCal microformats when feature
<code>RAPTOR_FEATURE_MICROFORMATS</code> is enabled (default
enabled).</li>
<li>Handles <link type="application/rdf+xml" href="URI" /> to
RDF/XML content when feature <code>RAPTOR_FEATURE_HTML_LINK</code> is
enabled (default enabled).</li>
<li>Attempts parsing with libxml's HTML parser if XML parsing fails,
when feature <code>RAPTOR_FEATURE_HTML_TAG_SOUP</code> is enabled
(default enabled).</li>
<li>Discards errors during recursive processing such as 404s,
failure to parse, failure of XSLT processing.</li>
<li>Uses XSLT security - denies reading, writing to files,
directories or writing to network.</li>
<li>Accepts the <code>RAPTOR_FEATURE_NO_NET</code> feature to prevent
all networking.</li>
<li>Allows fine-grained URI filtering with
<code>raptor_parser_set_uri_filter()</code>.</li>
</ul>
<p>RDF/XML parser recognising was updated to just the start of the
document for guessing if it should handle content and to try
to avoid html URLs.
</p>
<p>RSS Tag soup parser recognising was updated to accept with the
string 'feed' in the identifier.
</p>
<p>TRiG Parser was added based on the Turtle parser, adding named
graphs. It returns name graph URis via a callback set with new API
call <code>raptor_set_graph_handler()</code>
</p>
<p>Turtle parser added <code>@base</code> support, fixed turtle
escapes to URIs. Recognising was updated to look for
<code>@prefix</code> early in the document.
</p>
<h3>Serializer Changes</h3>
<p>Turtle serialiser changes:</p>
<ul>
<li>Generate <code>@base</code> when an output base URI is given.</li>
<li>Properly format Turtle XSD doubles using new snprintf code.</li>
<li>Fix unwanted blank line at end of Turtle list abbreviation.</li>
<li>Use AVL Tree rather than sequence for significant performance
improvement for large serialisations.</li>
</ul>
<p>RDF/XML serialiser was changed to emit a legal empty RDF/XML
document when no triples are serialised and to skip emitting
statements with bad predicate uris rather than returning an error.
</p>
<p>RDF/XML Abbrev serialiser was changed to use an AVL tree rather
than sequence for significant performance improvement for large
serialisations.
</p>
<h3><code>rapper</code> Utility Changes</h3>
<p>Added an <code>--show-graphs</code> option to print named graph
URIs as seen (such as with TRiG).
</p>
<p>Added <code>-I</code> / <code>--input-uri</code> and
<code>-O</code> / <code>--output-uri</code> options to set the
input / parsing and output / serializing base URIs
separately. Defaults remain the same - the serializer base URI
defaults to the input base URI, however it was set.
</p>
<h3>Portability Changes</h3>
<p>Fixes for when building from Subversion on cygwin (EOL issues,
Makefiles).</p>
<p>Remove unused semicolons for prevention of compiler warnings.</p>
<p>Fix some uninitialized variables that some compilers complain about.</p>
<p>Allow <code>RAPTOR_ASSERT_DIE</code> to be externally defined.</p>
<p>Allow <code>RAPTOR_WWW_BUFFER_SIZE</code> to be externally defined.</p>
<h3>Other Changes</h3>
<p><code>autogen.sh</code> was updated to handle program versions
better using an inline perl helper.
</p>
<p>Start to add resiliance to memory allocation failures
and errors inside the library.
</p>
<p>Added AVL Tree code to make much faster key:value lookups. This
is used for RDF/XML parser XML ID checks and in the 'abbrev'
serializers - Turtle and RDF/XML-Abbrev for looking up nodes.
</p>
<p>Better libxml error messages are now returned, mentioning
some of the names and values that caused the error.
</p>
<h2 id="rel1_4_15"><a name="rel1_4_15">Raptor 1.4.15 Changes</a></h2>
<h3>General Changes</h3>
<p>GRDDL parser now passes the (unapproved) test suite for the
<a href="https://www.w3.org/TR/2007/WD-grddl-20070302/">GRDDL W3C Working Draft 2 March 2007</a>
except for two tests that have been reported as having errors.
</p>
<p>When using libcurl as the WWW retrieval library, errors in
resolving a URI such as not found (404) are now reported as proper
errors and cause parsing to fail rather than just return no triples.
</p>
<p>Some improvments where made to guessing for a parser to match some
content. Firstly, any mime type with Q <10 is added to the score,
don't lose the influence of the mime type entirely. The consequence of
this is that Turtle can pretend to be a partial N3 parser. Secondly,
the XHTML mime type is now correctly recognised by the GRDDL parser
rather than the RSS Tag Soup parser.</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000174">#0000174</a>: Serializing to rdfxml* with a base_uri doesn't set the <code>xml:base</code> attribute, but does truncate <code>rdf:about</code> and <code>rdf:resource</code> values</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000177">#0000177</a>: Some URI references mis-resolved</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000178">#0000178</a>: No errors from accessing 404 URIs</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000180">#0000180</a>: messages garble output to stdout</li>
</ul>
<h3>Parser and Serializer Changes</h3>
<p>Added better error reporting for XML errors using the
libxml structured error reporing api. From
</p>
<pre>
$ 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
</pre>
<p>To this:</p>
<pre>
$ 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
</pre>
<p>GRDDL parser updated to support the
<a href="https://www.w3.org/TR/2007/WD-grddl-20070302/">GRDDL W3C Working Draft 2 March 2007</a>:
</p>
<ul>
<li>Namespace and profile URI handling now works.</li>
<li>Run XML Include processing</li>
<li>Throw away XML validation errors</li>
<li>When a namespace URI is seen that was RDF/XML Mime type, run
the RDF/XML parser on the content.</li>
<li>Look for substrings inside rel attributes when looking for profiles.</li>
<li>Return a warning and do not fail if XSLT sheet is not found</li>
<li>Use libxml structured errors for better reporting</li>
<li>Removed old hard-coded xslt scripts</li>
</ul>
<p>Turtle parser was changed to accept the N3 mime
type <code>text/rdf+n3</code> at low Q(quality)
so it might work for N3 that is the RDF subset - quite common.
</p>
<p>Changed the RSS Tag Soup parser and RSS 1.0 serializer to stop
sharing use of the declared namespaces so that when using both at the
same time, there is no double-free of the same objects.
</p>
<p>Correct the content: namespace URI in the RSS parser and
serializers.
</p>
<h3>Other Changes</h3>
<p><code>rapper</code> gains a <code>-t/--trace</code> option to show
URIs traversed. Handy for GRDDL.
</p>
<p><code>raptor_uri_resolve_uri_reference()</code> no longer goes
past the end of buffer when the relative URI is <code>,/</code>
</p>
<p>Added an internal API for capturing parsed data as it is seen.
Use by GRDDL parser but with no public API.
</p>
<p>Added an internal API for structured error reporting. Updates
made throughout the library but with no public API.
</p>
<p>Internal API <code>raptor_new_sax2()</code> signature changed to
just have an <code>error_handlers</code> pointer argument rather than
multiple function / user_data pairs.
</p>
<h2 id="rel1_4_14"><a name="rel1_4_14">Raptor 1.4.14 Changes</a></h2>
<h3>General Changes</h3>
<p>Added a
<a href="https://www.dajobe.org/2004/01/turtle/">Turtle Terse RDF Triple Language</a> serialiser by <a href="http://codeson.net/">Dave Robillard</a> based on the existing RDF/XML-Abbrev
serialiser.
</p>
<p>Added a GraphViz
<a href="http://www.graphviz.org/doc/info/lang.html">DOT format</a> serialiser
by Evan Nemerson.
</p>
<p>The GRDDL parser now does namespace and profile URI recursion and
has other improvements and fixes.
</p>
<p>Fixed Issues:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=32">#0000032</a>: GRDDL indirection feature request</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=141">#0000141</a>: Crash when GRDDL parser is used with a used-generated blank node ID prefix.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=143">#0000143</a>: Crash when GRDDL parser fails to retrieve URI.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=148">#0000148</a>: A public function to generate a blank ID would be nice though.</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=155">#0000155</a>: entity processing in literal property elements (with libxml)</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=157">#0000157</a>: Crash when RDF/XML Abbrev serializer sees a <code>rdf:type</code> predicate with a literal object.</li>
</ul>
<h3>Configuration Changes</h3>
<p><code>raptor-config</code> gains a <code>--private-libs</code>
for the internal libraries used in building raptor, with the public
ones only emitted with <code>--libs</code>.
</p>
<p><code>raptor.pc</code> now uses <code>Libs.private</code> for
internal dynamically linked libraries.
</p>
<p>The libxml minimum version is now 2.6.8 since 2.6.7 crashes on
PPC64 Linux. 2.6.8 was released March 2004 so this should be no
burden.</p>
<p>Do not use <code>PATH_MAX</code> so raptor can build on Hurd.
</p>
<h3>Parser Changes</h3>
<p>RDF/XML parser now looks for the RDF/XML root element and
namespace declaration in the initial bytes of content when guessing.
This allows content that is in other mime types such as
<code>application/xml</code> to be more likely guessed as RDF/XML.
</p>
<p>When guessing a parser to use, if an an exact match is found for
the mime type (q=10), then that parser is used.
</p>
<p>The GRDDL parser has several changes:</p>
<ul>
<li>Recurses through the root element's namespace URI and the profile
URIs. It excludes several common namespace URIs from processing
(XHTML, RDF/XML, XML Schema) and does not traverse the GRDDL profile
URI itself.
</li>
<li>Tries to guess which of the RDF/XML or Turtle parser is wanted
from an XSLT result. Guessing is performed because not all the XSLT
sheets used in the demonstrations set the mime type to match Turtle's
unregistered type, or because the return no mime type, or return an
XML one, when it was expected RDF/XML would be received.
</li>
<li>Watches the processed URIs and never visits the same URI more
than once in a session.
</li>
<li>Passes on general XSLT errors to raptor rather than letting the
default (printing to stderr) work.
</li>
<li>Declares XSLT 'base' and 'Base' parameters to allow some XSLT
sheets to work - pragmatism.
</li>
</ul>
<h3>Serializer Changes</h3>
<p>Added a new
<a href="https://www.dajobe.org/2004/01/turtle/">Turtle Terse RDF Triple Language</a>
serializer and two new internal APIs based on the existing RDF/XML-Abbrev
serialiser, written by <a href="http://codeson.net/">Dave Robillard</a>:
</p>
<ul>
<li><code>turtle_writer</code> for serializing triples to Turtle This
may be moved to the public API in a future release.</li>
<li><code>raptor_abbrev</code> for the common 'abbreviated
serializer' core that is shared between the RDF/XML-Abbrev and Turtle
serializer.</li>
</ul>
<p>Added a new GraphViz
<a href="http://www.graphviz.org/doc/info/lang.html">DOT format</a> serialiser
writen by Evan Nemerson.
</p>
<p>Note that testing the turtle serializing (<code>make test</code>)
requires the <code>rdfdiff -u</code> and a few of the tests take some
time to run.</p>
<h3>Other Changes</h3>
<p>Added <code>raptor_home_url_string</code>
and <code>raptor_license_string</code> exported strings.
</p>
<p>Added <code>raptor_parser_generate_id()</code> as a public function
to generate an identifier for a parser.
</p>
<p><code>rdfdiff</code> gains the -u/--base-uri option to specify the
from file base URI so that if the from file is a local file or
relative URI, it can be given an absolute base.</p>
<p>Failures to retrieve content from a URI using
the <code>raptor_www</code> class implementations now return a
failure as well as setting the HTTP status code to 403 or 404 as
appropriate. Previously success may have been returned with no
bytes.</p>
<h2 id="rel1_4_13"><a name="rel1_4_13">Raptor 1.4.13 Changes</a></h2>
<h3>General Changes</h3>
<p>Prevent losing memory for a <code>raptor_xml_writer</code> when a
serializer is reused several times.</p>
<p>Fixed issues reported on the <a href="https://bugs.librdf.org/">Redland Issue Tracker</a>:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=134">Issue #0000134</a>: Check for equal scheme and authority during construction of relative URIs from two absolute URIs.</li>
</ul>
<h3>Configuration Changes</h3>
<p>In maintainer mode, add all the supported compiler <code>-W</code>
warning flags to the CFLAGS.
</p>
<p>Allow <code>LEX</code> to be set to things that aren't exactly
'flex'.</p>
<h3>Documentation Changes</h3>
<p>Added single triple serializing example to the tutorial to
demonstrate serializing without parsing and building
a <code>raptor_statement</code>.</p>
<h3>Other Changes</h3>
<p>Declare several raptor functions with GCC printf-formatting
attributes when using a new enough GCC.</p>
<p>RDF/XML parser now creates literals with
<code>raptor_stringbuffer</code> so that it does a lot less copying
when constructing longer literals.
</p>
<p>Added single <code>raptor_statement</code> serializing example
to demonstrate serializing alone without parsing.</p>
<h2 id="rel1_4_12"><a name="rel1_4_12">Raptor 1.4.12 Changes</a></h2>
<p>Restored the order of serialized syntaxes back to the same as in
Raptor 1.4.10 which Redland was relying on - asking to serialize to
mime type 'application/rdf+xml' without specifying a parser name in
Redland with Raptor 1.4.11 wrote it in XMP instead of RDF/XML as
it used to. This happened more often with language bindings.
That problem will be fixed in a future release of Redland but for now,
this stops wierd things like that happening.
</p>
<h2 id="rel1_4_11"><a name="rel1_4_11">Raptor 1.4.11 Changes</a></h2>
<h3>General Changes</h3>
<p>Added <code>raptor_get_feature_count()</code> to return
the count of features, in preference to using the
macro value <code>RAPTOR_FEATURE_LAST</code>.
</p>
<p>Added <code>raptor_www_set_uri_filter()</code> method of the
WWW class (<code>raptor_www</code>) objects to have an
optional URI filter function that checks if the URL given is
allowed to be retrieved, or denied entirely.
</p>
<p>Fixed issues reported on the <a href="https://bugs.librdf.org/">Redland Issue Tracker</a>:</p>
<ul>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000112">#0000112</a>: raptor_namespaces_qname_from_uri not public API?</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000110">#0000110</a>: strcasecmp problem under windows (raptor_rss.c does not compile)</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000091">#0000091</a>: guess parser should guess the syntax each time it is run, not be fixed</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000089">#0000089</a>: Add a NONET feature to prevent network fetches</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000041">#0000041</a>: Allow multiple transformation URLs in data-view:transformation property</li>
<li><a href="https://bugs.librdf.org/mantis/view.php?id=0000014">#0000014</a>: bNode content written twice in rdfxml-abbrev output mode</li>
</ul>
<h3>Documentation Changes</h3>
<p>The
<a href="https://librdf.org/raptor/api/">Raptor Reference Manual</a>
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.</p>
<h3>Parser Changes</h3>
<p>Added functionality to prevent network requests either via setting
a new feature <code>RAPTOR_FEATURE_NO_NET</code> that denies network
requests during a parser operation or with a URI filter function
<code>raptor_parser_set_uri_filter()</code>. This function uses
<code>raptor_www_set_uri_filter()</code> internally.
</p>
<p>Added <code>raptor_get_need_base_uri()</code> to tell if a parser
requires a base URI argument. Presently the <em>N-Triples</em> parser
is the only parser that does not require a base URI.
<code>raptor_start_parse()</code> will now throw an error if no base
URI is given and it is needed.
</p>
<p>The <em>GRDDL parser</em> was changed to
handle a list of URIs in the profile so it now
can support <code>dataview:transformation</code> in XML taking a list
of transformations as defined in
<a href="https://www.w3.org/2004/01/rdxh/spec#grddl-xhtml">The GRDDL profile for XHTML</a> part of the GRDDL specification.
It now also recognises
<a href="http://research.talis.com/2005/erdf/wiki/Main/RdfInHtml">Embedded RDF</a> and
<a href="http://microformats.org/wiki/hcalendar">HCalendar</a>
using well known XPaths and transforms them to RDF triples using well
known XSLT sheet URIs.
</p>
<p>The <em>Guess parser</em> now resets after each parse and does a
fresh guess on the syntax based on the incoming information.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=91">Issue #0000091</a>
</p>
<p>The <em>Turtle parser </em> (and experimental N3 parser) were
changed to now require base URIs as they always should have. The
error messages when reporting problems with grammar tokens now return
better responses. Added better memory cleanup during parser error
recovery.
</p>
<h3>Serializer Changes</h3>
<p>The <em>RSS 1.0 Serializer</em> now works again.</p>
<p>Updated the <em>RDF/XML Abbreviated</em> serializer to do proper
reference counting on the blank/resource nodes used as subjects and
objects to prevent dual-triple generation. Fixes the reported
<a href="https://bugs.librdf.org/mantis/view.php?id=14">Issue #0000014</a>
</p>
<h3>Other Changes</h3>
<p>The internal SAX2 API can also prevent network fetches with the
feature <code>RAPTOR_FEATURE_NO_NET</code>.</p>
<p>Fixed a SAX2 problem that caused parsers that use it to leak
memory for 1 URI, affected RDF/XML and RSS Tag Soup.
</p>
<p><code>rapper</code> help and verbose message formats were tidied.</p>
<h2 id="rel1_4_10"><a name="rel1_4_10">Raptor 1.4.10 Changes</a></h2>
<h3>General Changes</h3>
<p>No parser will now generate a triple with an identifier type
<code>RAPTOR_IDENTIFIER_TYPE_ORDINAL</code>. Only identifier type
resource, anonymous (blank node) and literal will be generated.
All serializers will convert any
<code>RAPTOR_IDENTIFIER_TYPE_ORDINAL</code> type on input to type
resource.
</p>
<h3>Configuration Changes</h3>
<p>No longer adds LDFLAGS to pkgconfig file <code>raptor.pc</code>
and <code>raptor-config</code> fixing
<a href="https://bugs.librdf.org/mantis/view.php?id=97">Issue #0000097</a>.
</p>
<h3>Parser Changes</h3>
<p>All parsers no longer generate a triple with an identifier type
<code>RAPTOR_IDENTIFIER_TYPE_ORDINAL</code>, as deprecated in 1.4.8.
The replacement type generated is <code>RAPTOR_IDENTIFIER_TYPE_RESOURCE</code>.
</p>
<p>The RSS Tag Soup (<code>rss-tag-soup</code>) parser now makes the
triples appear before parser destruction. This caused odd symptoms
like parsing in python returning no triples and the parser then
crashing during object destruction.
</p>
<p>The RDF/XML (<code>rdfxml</code>) parser no longer crashes if a
comment is seen outside an element, such as before or after the root
element.</p>
<h3>Serializer Changes</h3>
<p>The RDF/XML (<code>rdfxml</code>) serializer no longer crashes if
the serializer is used more than once.
</p>
<h2 id="rel1_4_9"><a name="rel1_4_9">Raptor 1.4.9 Changes</a></h2>
<h3>Configuration and Build Changes</h3>
<p>Now using <a href="http://subversion.tigris.org/">Subversion</a>
for version control and the <a href="INSTALL.html">Raptor installation instructions</a> explain how to get Raptor from Subversion.</p>
<p>configure now allows <code>--enable-parsers=node</code> and
<code>--enable-serializers=none</code>. Using both is possible!</p>
<p>No longer require libxml2 for the RSS Tag Soup parser</p>
<p>Various Win32 fixes and VC build files updates from John Barstow.
</p>
<h3>Documentation Changes</h3>
<p>A new
<a href="https://librdf.org/raptor/api/tutorial.html">Raptor Tutorial</a>
was written covering using all parsing and serializing functions along with
example code.
</p>
<p>The
<a href="https://librdf.org/raptor/api/reference-manual.html">Raptor Reference Manual</a>
now covers 100% of all functions, structs and defines with gtkdoc generated
documentation.</p>
<h3><code>rapper</code> utility Changes</h3>
<p><code>rapper</code> now uses namespaces found in parsing to give
hints to the serializer as to how to format the output. The result
of this is that <code>rapper</code> can be used as an RDF
pretty-printer and is especially good at such things as turning flat
N-Triples to RDF/XML or RDF/XML-Abbrev. such as:
</p>
<pre>
rapper -q -i ntriples -o rdfxml-abbrev example.nt
</pre>
<h3>Parser Changes</h3>
<p>All parsers no longer generate
<code>RAPTOR_IDENTIFIER_TYPE_PREDICATE</code> as the statement
predicate type, as deprecated in 1.4.8. The replacement
type generated is <code>RAPTOR_IDENTIFIER_TYPE_RESOURCE</code>.</p>
<p>The Turtle parser now has <code>true</code> and <code>false</code>
boolean literals, which were accidently omiited from the parser in
the 1.4.8 update.
</p>
<p>Parsers can register capabilities for handling multiple mime types
with Q values. These are then used in WWW requests for content
in the <code>Accept:</code> header for HTTP. Added
<code>raptor_parser_factory_add_mime_type</code> for registering,
<code>raptor_parser_get_accept_header</code> to get the accept header
values for the types supported by one parser.
</p>
<p>From the previous change, the RSS parser now accepts several
unregistered RSS mime types as well as the registered Atom one; the
RDF/XML parser accepts unregistered mime type <code>text/rdf</code>
seen occasionally; the Turtle parser accepts several experimental
mime types. All unregistered or experimental types are accepted with
lower Q than any registered type.
</p>
<p>The RSS Tag Soup parser for RSS* and Atom no longer requires
libxml2 (for it's XML Reader API). Internal changes mean that it
will fully work on top of expat.</p>
<h3>Serializer Changes</h3>
<p>The RSS/Atom serializer now uses input namespace declarations to
choose namespaces on output.</p>
<p>Added <code>raptor_serialize_set_namespace_from_namespace</code>
to set a namespace for serializing from an existing
<code>raptor_namespace</code>.
</p>
<p>Serializing to RDF/XML (or RDF/XML Abbrev) now does not
double-free URI strings.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=65">Issue #0000065</a>
</p>
<p>RSS serializer no longer writes the XML header twice.</p>
<h3>IOStream Class Changes</h3>
<p>Added <code>raptor_iostream_write_uri</code> to directly write a URI
to an iostream without the need to go via a string.</p>
<p>Fixed bug in <code>raptor_iostream_write_xml_any_escaped_string</code>
failing to write ';' after escaping U+0009 and U+000A</p>
<h3>Namespaces Class Changes</h3>
<p>Added <code>raptor_namespaces_qname_from_uri</code> to do URI
splitting into qname prefering to use the current in-scope namespaces
before having to search.</p>
<p><code>raptor_namespaces_format</code> now NULL-terminates the namespace string.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=62">Issue #0000062</a>
</p>
<p>Added <code>raptor_namespace_get_counted_prefix</code> to return a
namespace prefix and it's length.</p>
<h3>QName Class Changes</h3>
<p>Added <code>raptor_qname_get_namespace</code> to get the namespace
associated with a QName.</p>
<h3>StringBuffer Class Changes</h3>
<p><code>raptor_stringbuffer_append_counted_string</code> and
<code>raptor_stringbuffer_append_string</code> now Do nothing on
appending a NULL string or a string of length 0.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=73">Issue #0000073</a>
</p>
<h3>Unicode Class Changes</h3>
<p><code>raptor_utf8_to_unicode_char</code> now also checks for
overlong UTF-8 sequences, illegal code positions or out of range
codes.
</p>
<h3>URI Class Changes</h3>
<p>Deprecated <code>raptor_uri_is_file_uri</code> which takes a
URI string argument for new function <code>raptor_uri_string_is_file_uri</code>
which more clearly says that.
</p>
<p>Changed all URI string calloc/mallocs to add enough room for a
full pointer at the string end to stop valgrind moaning on 64bit
systems when looking for the end of string NUL.
</p>
<p><code>raptor_uri_set_handler</code> and
<code>raptor_new_iostream_from_handler</code> now take const
<em>handler</em> arguments.
</p>
<h3>WWW Class Changes</h3>
<p>Get the curl success status into a long, not an int which causes
failure on 64 bit.
Fixes <a href="https://bugs.librdf.org/mantis/view.php?id=75">Issue #0000075</a>
</p>
<p>WWW requests for content to parse now always send an appropriate
<code>Accept:</code> header with Q values for the parser, or for the
<code>guess</code> parser, all supported mime types.
</p>
<h3>Internal Changes</h3>
<p>Added XML element methods
<code>raptor_xml_element_get_attributes</code> and
<code>raptor_xml_element_get_attributes_count</code>,
<code>raptor_xml_element_is_empty</code>
to the SAX2 API.
</p>
<p>Many internal changes were made to the SAX2 API to finally
separate XML and RDF/XML parts. The SAX2 API is now fully usable on
either libxml2 or expat. That last sentence implies a lot of work,
by the way.</p>
<h2 id="rel1_4_8"><a name="rel1_4_8">Raptor 1.4.8 Changes</a></h2>
<h3>General Changes</h3>
<p>A large source re-arrangement was performed. All C sources and
headers that build the library are now in the src dir, general
documentation in the doc dir and utilities in the utils dir. This
both tidied up the mixture of files at the top level and also enabled
better use with gtk-doc.
</p>
<p>Future API change: From the next release of
Raptor, <code>raptor_statement</code> predicates will return
identifiers of type <code>RAPTOR_IDENTIFIER_TYPE_RESOURCE</code>
instead of <code>RAPTOR_IDENTIFIER_TYPE_PREDICATE</code>.
Identifiers of type <code>RAPTOR_IDENTIFIER_TYPE_ORDINAL</code> may
no longer be returned in any statement position (to be confirmed).
</p>
<p>Version Control change: Raptor will be switching to use
<a href="http://subversion.tigris.org/">Subversion</a>
for version control after the 1.4.8 release. Please check the
<a href="http://svn.librdf.org/">Redland Subversion site</a>
for the latest status or the online
<a href="https://librdf.org/raptor/INSTALL.html">Raptor installation notes</a>
for the raptor specific subversion installation information.
</p>
<h3>Configuration Changes</h3>
<p>The autogen.sh script for building from CVS was revamped to be
more modular.</p>
<p><code>configure</code> now takes an <code>--enable-gtk-doc</code>
option to enable building of the documentation using the
<code>gtk-doc</code> utility. It is by default enabled only if the
utility is available.
</p>
<p>Added a new configure option <code>--enable-serializers</code> (in
1.4.7) to allow the selection of the required RDF serializers from
any of those supported.</p>
<p><code>raptor-config</code> now has a <code>--options</code>
argument to list the configured or discovered options of the library
such as parsers, serializers and other choices.
</p>
<h3>Documentation Changes</h3>
<p>The GNOME <code>gtk-doc</code> program is now used to
automatically extract documentation from source comments into
reference documentation. This is then merged with templates and
additional documentation to provide a reference manual for raptor
as XML document which is turned into HTML along with GNOME devhelp
support.</p>
<p>This new documentation intended to replace the libraptor manual
page/web page as easier to read document with scope for better
expanding with more detail of raptor including examples and tutorial
information. The manual page will continue to contain the summary
information for the present.
</p>
<h3>Portability Changes</h3>
<p>Fixed a long-standing URI resolution bug on win32 - only remove
leading / if there is one present (patch from John C. Barstow)</p>
<h3><code>rapper</code> utility Changes</h3>
<p>Altered the <code>-g</code> argument to invoke the guessing parser
rather than guess on file/URI name alone. This is now equivalent to
choosing an input syntax of <em>guess</em> with <code>-i guess</code>.</p>
<p>Added a <code>--show-namespaces</code> long option (no short version)
to show namespaces that are declared in the parsed content.
</p>
<h3>Parser Changes</h3>
<p>A new guessing parser was added, picking the actual parser to use
at run-time based on protocol or other information.</p>
<p>Allow a content type returned by a protocol (such as HTTP) to
enable choosing of parser at run-time. Added a new optional
parser factory method <code>content_type_handler</code> to return this.
</p>
<p>Allow parsers to handle several syntaxes rather than only 1 or 2.
</p>
<p>Parsers can now return namespace prefix/URI declarations as
they are given in the content by the means of a new handler type
<code>raptor_namespace_handler</code> and parser method
<code>raptor_set_namespace_handler</code>. Duplicate namespace
prefix/URIs can be returned.
</p>
<h4>GRDDL Parser Changes</h4>
<p>Bug fix when the entire content is in one chunk (René Puls).</p>
<h4>Guessing Parser Changes</h4>
<p>A new parser that guesses the actual parser to use at run-time
based on a combination of MIME Content-Type, file or URI name and in
future, iniital bytes of the content. If the Content-Type is an
exact match to a known parser, it is always chosen before trying
heuristics.
</p>
<h4>RDF/XML Parser Changes</h4>
<p>When emitting literals, handle a datatyped empty literal. This
is a post-REC errata for the revised RDF/XML recommendation.
See
<a href="http://lists.w3.org/Archives/Public/www-archive/2005Jul/0017.html">archived example</a>
for further information.
</p>
<h4>RSS Tag Soup Parser Changes</h4>
<p>Added atom 1.0 support including use of the new namespace. Atom
0.3 namespace terms are turned into new properties. Replace atom
copies of Dublin Core or RSS properties with the original terms:
</p>
<div style="text-align:center">
<table>
<tr><th>Atom 1.0 term</th> <th>Original term</th></tr>
<tr><td><code>atom:content</code></td> <td><code>rss:description</code></td></tr>
<tr><td><code>atom:id</code></td> <td><code>rss:link</code></td></tr>
<tr><td><code>atom:published</code></td> <td><code>dc:date</code></td></tr>
<tr><td><code>atom:rights</code></td> <td><code>dc:rights</code></td></tr>
<tr><td><code>atom:title</code></td> <td><code>rss:title</code></td></tr>
</table>
</div>
<p>Apply the in-scope base URI (such as from <code>xml:base</code>)
to atom 1.0 fields that take URI values:
<code>atom:id</code>, <code>atom:icon</code> and <code>atom:logo</code>.
</p>
<p>Added optional date parsing code to turn XML RSS date fields into
ISO format ones, suitable for Atom and XML schema datatypes format.
Will use library parsedate code from curl or INN if available.
</p>
<p>XML RSS field <code>pubDate</code> is now turned into Dublin Core
<code>dc:date</code> field in the ISO format.
</p>
<p>XML RSS field <code>content</code> is turned into
<code>content:encoded</code> in RDF triples on output with
escaping.</p>
<h4>Turtle Parser Changes</h4>
<p>Updated to support Turtle version 2006-01-02
(<a href="https://www.dajobe.org/2004/01/turtle/">announcement</a>).
</p>
<p>Switch qname, blank node and prefix definitions to SPARQL ones.</p>
<p>Check for illegal not-hexadecimal \u and \U escape values.</p>
<p>Fix greedy matching of long literals ("""....""") that ended on
the last """ found rather than the first.</p> <!-- """ -->
<p>Added double and decimal constants.</p>
<p>Added optional +- sign to all numeric constants.</p>
<p>Allow \" escape inside long strings.</p>
<p>Take care to reset the generated <code>raptor_statement</code>
language and datatype fields when not used.
</p>
<h3>Serializer Changes</h3>
<p>Added a new Atom 1.0 serializer (name <em>atom</em>)
by parameterising the RSS 1.0 serializer.
</p>
<p>Added a new Adobe XMP compatible serializer (name <em>rdfxml-xmp</em>)
by parameterising the RDF/XML Abbreviated serializer. Patch provided by
Sid Steward.
</p>
<p>All serializers can be chosen at <code>configure</code> time from
those available using configure option <code>--enable-serializers</code>.
</p>
<p>The RSS parser and serializer can now be independently enabled or
disabled. The RSS serializer no longer requires an XML parser.</p>
<h3>RDF/XML Serializer / XML Writer Changes</h3>
<p>A new XML Writer feature
<code>RAPTOR_FEATURE_WRITER_XML_VERSION</code> was added to allow
chosing XML 1.0 (value 10) or XML 1.1 output (value 11). This
feature is also accepted by serializers as an option and used by the
RDF/XML and RDF/XML-Abbrev serializers.
</p>
<p>A new XML Writer feature
<code>RAPTOR_FEATURE_WRITER_XML_DECLARATION</code> was added to allow
omitting the XML declaration (default true).
</p>
<p>Added functions <code>raptor_xml_any_escape_string()</code>
and <code>raptor_iostream_write_xml_any_escaped_string()</code>
which take an XML version. The XML 1.0 functions give errors
when attempting to write #x1-#x1f (excluding #x9, #xA, #xD) or #x7F.
</p>
<h3>Atom 1.0 Serializer Changes</h3>
<p>Added a new serializer using the Atom 1.0 format and namespace.
This reads RDF triples in the RSS 1.0 model, along with any
additional atom 1.0 properties and serializes an Atom 1.0 feed
file.</p>
<h3>Adobe XMP Serializer Changes</h3>
<p>Added a new serializer writing RDF/XML in the profile used by
Adobe XMP. Note that this does require RDF triples to be used in a
certain style; for example all triple subjects are the "current
documment" giving <code>rdf:about=""</code>.</p>
<h3>URI Class Changes</h3>
<p>Fix a bug when adding a default path of / to a URI
in functions <code>raptor_new_uri_for_xmlbase()</code>
and <code>raptor_new_uri_for_retrieval()</code>.
(Bug #<a href="https://bugs.librdf.org/mantis/view.php?id=45">0000045</a>)
</p>
<p><em>raptor_uri_equals</em> was altered to accept NULL pointers,
which do not compare equal to a non-NULL URI. NULL does equal NULL.
</p>
<h3>Internal Changes</h3>
<p>The internal SAX2 class was extensively changed so that remaining
interdependencies with the RDF/XML parser were removed and it can now
be re-used for other syntaxes cleanly. Several functions
were modified or added.</p>
<p>Removed old and hardly-tested internal support for XML entity
resolution (libxml only).</p>
<p>Various fixes for GCC 4 warnings.
</p>
<h2 id="rel1_4_7"><a name="rel1_4_7">Raptor 1.4.7 Changes</a></h2>
<p>Fix a couple of crashes in the RSS tag soup parser / serializer
(Dave Beckett, Suzan Foster).</p>
<p><code>configure</code> now looks for the
<code>libxslt/xslt.h</code> header as well as the
<code>libxslt</code> library and disables XSLT and GRDDL support it
if is missing. This catches systems with the libraries without
headers as has happened on some OSX versions.
</p>
<p>In serializers rdfxml and rdfxml-abbrev, report failure to
serialize to RDF/XML if the predicate URI is not absolute.
</p>
<h2 id="rel1_4_6"><a name="rel1_4_6">Raptor 1.4.6 Changes</a></h2>
<p>Added <code>--with-xslt-config</code> configure option</p>
<p>Added a new parser for
<a href="https://www.w3.org/2004/01/rdxh/spec">Gleaning Resource Descriptions from Dialects of Languages (GRDDL)</a>
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
support all the GRDDL styles, for example
<code>dataview:namespaceTransformation</code>,
or perform recursive transformations.
</p>
<p>The turtle parser now accepts """long literals"""</p>
<p>XML writer feature support were added in 1.4.5 and not documented.
The new functions are:
<code>raptor_xml_writer_features_enumerate</code>,
<code>raptor_xml_writer_set_feature</code>,
<code>raptor_xml_writer_set_feature_string</code>,
<code>raptor_xml_writer_get_feature</code> and
<code>raptor_xml_writer_get_feature_string</code>.
The three XML writer features added are
\fBRAPTOR_FEATURE_WRITER_AUTO_INDENT\fR with boolean value (default true)
to auto-indent the XML,
\fBRAPTOR_FEATURE_WRITER_AUTO_EMPTY\fR with boolean value (default true)
to automatically generate empty elements if a start/end element sequence
has no content and
\fBRAPTOR_FEATURE_WRITER_INDENT_WIDTH\fR with an integer value (default 2)
to set the indenting level for the XML.
</p>
<p>New build configuration and portability fixes for win32 (John Barstow)</p>
<p>Portability fixes for win32 - added
<code>SIZEOF_UNSIGNED_SHORT</code> (Dave Viner, others)</p>
<p>Added a signing memory debugging system to aid checking when
raptor-allocated memory is freed in another library or vice-versa
enabled by <code>--with-memory-signing</code> configure option
(defaults to on in maintainer mode).</p>
<p>Fixed a few internal malloc/frees to use RAPTOR_MALLOC / RAPTOR_FREE
so that the above signed memory system worked.</p>
<p>RDF/XML serializer:
Use the maximal name when splitting a predicate.<br />
Turn datatyped literals that are rdf:XMLLiteral into inline XML with
<code>rdf:parseType="Literal"</code> rather than XML-escaped.
</p>
<p>RDF/XML abbreviated serializer:
Fix a crash when there is a NULL base URI.
Use the maximal name when splitting a predicate.<br />
Turn datatyped literals that are rdf:XMLLiteral into inline XML with
<code>rdf:parseType="Literal"</code> rather than XML-escaped.
</p>
<p>RSS tag soup parser:
Fix crash with unexpected use of <code>alternate</code> attribute.<br />
Update from Suzan Foster to reflect the latest status of the
enclosure vocabulary and allow multiple common items and fields.
</p>
<p>RSS 1.0 serializer:
Added RSS enclosures serializing.
</p>
<p><code>grapper</code> example GTK program now stores the window
width and height using gconf2.</p>
<h2 id="rel1_4_5"><a name="rel1_4_5">Raptor 1.4.5 Changes</a></h2>
<p>Added a new <em>RDF/XML with abbreviations</em> serializer
<code>rdfxml-abbrev</code> written by Steve Shepard which handles
several of the abbreviations specified by the
<a href="https://www.w3.org/TR/rdf-syntax-grammar/">RDF/XML Syntax Specification (Revised)</a>
W3C Recommendation. It is suitable for writing small documents as
there are known scaling issues.
</p>
<p>The RSS tag soup parser was updated to work better when there is
no base URI given. It also now supports reading the
<a href="http://inamidst.com/rss1.1/">RSS 1.1</a> format and
turning it into RSS 1.0 model triples.</p>
<p>Deprecated <code>raptor_ntriples_string_as_utf8_string</code> as
rather too internal to be useful, since it only works with a parser.
</p>
<p>More fixes to work around the broken libxml2 on Apple OSX 10.3.x
with inconsistent shared libraries / headers.</p>
<p>Experimental and incomplete Notation 3 parser - updated to match
changes to Turtle. CVS changes only, not enabled in standard builds.
</p>
<h2 id="rel1_4_4"><a name="rel1_4_4">Raptor 1.4.4 Changes</a></h2>
<p>Make the RSS tag soup parser handle RSS 0.9 namespace elements by
turning them into RSS 1.0.</p>
<p>Fix a couple of crashes in the RSS 1.0 serialiser when
no base URI is used.</p>
<p>Make <code>raptor_uri_to_relative_counted_uri_string</code>
work when the base or reference URI have no paths such as like
<em>http://example.org</em>
</p>
<p>Added portability fixes for Win32 to get Raptor 1.4.3 building
with MS Visual Studio using expat and libcurl. The RAPTOR_INTERNAL
define was moved to the build configuration and defines added for
integral type sizes. Patch from Dave Viner (dviner at apache dot
org).</p>
<h2 id="rel1_4_3"><a name="rel1_4_3">Raptor 1.4.3 Changes</a></h2>
<p>A release with the major new feature of an XML writer API.
This is now used along with a new supporting XML element class to
improve the existing RDF/XML serializer and to provide a new
<a href="http://purl.org/rss/1.0/spec">RSS 1.0</a> serializer.
</p>
<p>This API it is also used by the next release of
<a href="https://librdf.org/rasqal/">Rasqal</a> to provide serializing
of query results to XML.
</p>
<p>The new <code>raptor_xml_writer</code> class functions added are:
<code>raptor_new_xml_writer</code> (constructor),
<code>raptor_free_xml_writer</code> (destructor),
<code>raptor_xml_writer_empty_element</code>,
<code>raptor_xml_writer_start_element</code>,
<code>raptor_xml_writer_end_element</code>,
<code>raptor_xml_writer_cdata</code>,
<code>raptor_xml_writer_cdata_counted</code>,
<code>raptor_xml_writer_raw</code>,
<code>raptor_xml_writer_raw_counted</code>,
<code>raptor_xml_writer_comment</code> and
<code>raptor_xml_writer_comment_counted</code>.
</p>
<p>The new <code>raptor_xml_element</code> class functions added are:
<code>raptor_new_xml_element</code> (constructor),
<code>raptor_free_xml_element</code> (destructor),
<code>raptor_xml_element_get_name</code>,
<code>raptor_xml_element_set_attributes</code>,
<code>raptor_xml_element_declare_namespace</code> and
<code>raptor_iostream_write_xml_element</code>.
</p>
<h3>Parser Changes</h3>
<p>RSS tag soup parser now works with older libxml2s (2.5.10+),
including the one shipped with some Apple OSX versions that has an
inconsistent header file and library.</p>
<p>RSS tag soup parser recognises/scores more common XML RSS file names.</p>
<p>RSS tag soup parser turns XML RSS
<code><guid isPermaLink="true">val</guid></code>
into RDF/XML form <code><guid rdf:resource="val"/></code>, leaving
the non isPermaLink form to be a literal value.</p>
<p>A bug was found in libxml2 that causes double expanding of XML
entities in RDF/XML. This has been reported but cannot be worked
around from raptor. The expat XML parser can be used as an
alternative, as it does not have this problem. A test was added for
this bug but it will not cause the test suite ('make check') to
fail.</p>
<p>Added additional
<a href="https://www.dajobe.org/2004/01/turtle/">Turtle</a>
parser tests that cover Notation 3 syntax that is not part of the
Turtle language.</p>
<p>Added
<code>raptor_parser_set_feature_string</code> and
<code>raptor_parser_get_feature_string</code>
methods to set/get string feature values.</p>
<h3>Serializer Changes</h3>
<p>Added feature <code>relative_uris</code> for serializers. This
is used by the RDF/XML serializer and enabled by default.</p>
<p>Added feature <code>start_uri</code> for serializers with a string
value to set the start URI for serializing. Not used at present.</p>
<p>Added new methods <code>raptor_serializer_features_enumerate</code>
to list serializer features and functions to set/get serializer
feature integer or strings values:
<code>raptor_serializer_set_feature</code>,
<code>raptor_serializer_get_feature</code>,
<code>raptor_serializer_set_feature_string</code> and
<code>raptor_serializer_get_feature_string</code>.
</p>
<p>Added <code>raptor_serialize_set_namespace</code> to allow user
declaration of prefix/URI namespaces pairs as serializing hints.</p>
<p>the RDF/XML serializer was improved using the new XML Writer class
so it now uses any user-declared namespace hints in it's output and
emits relative URIs whenever possible. The latter was provided
by a patch from René Puls.</p>
<p>A new
<a href="http://purl.org/rss/1.0/spec">RSS 1.0</a>
serializer was added, using the new XML Writer class
and using the same structures, classes and properties as the RSS tag
soup parser.</p>
<h3>URI class changes</h3>
<p>Added relative URI generating code from a patch written by René Puls
and provide this with two new methods
<code>raptor_uri_to_relative_uri_string</code> and
<code>raptor_uri_to_relative_counted_uri_string</code>.
</p>
<p>Added <code>raptor_uri_print</code> to print a URI to a file handle.</p>
<p>Added methods <code>raptor_uri_to_string</code> and
<code>raptor_uri_to_counted_string</code> to return a URI as newly
allocated strings.</p>
<h3>I/O Stream Changes</h3>
<p>Many classes gained methods to write to iostreams, supporting the
new XML Writer class functionality. The added methods are:
<code>raptor_iostream_write_namespace</code>,
<code>raptor_iostream_write_ntriples_string</code>,
<code>raptor_iostream_write_qname</code>,
<code>raptor_iostream_write_statement_ntriples</code>,
<code>raptor_iostream_write_stringbuffer</code>,
<code>raptor_iostream_write_xml_element</code> and
<code>raptor_iostream_write_xml_escaped_string</code>.
</p>
<h3>Namespace Class Changes</h3>
<p>Added <code>raptor_namespace_copy</code> copy
constructor and <code>raptor_new_namespace_from_uri</code>
constructor to build a namespace from a raptor_uri object.</p>
<p>Added utility function <code>raptor_new_namespace_parts_from_string</code>
to decode syntax of the form
<code>xmlns:</code><em>prefix</em><code>="</code><em>uri</em><code>"</code>
into <em>prefix</em> and <em>uri</em> string pairs.
</p>
<p>Added <code>raptor_namespaces_find_namespace_by_uri</code> method
for namespace stack to find a declared namespace by URI. This
complements <code>raptor_namespaces_find_namespace</code> which
already provides searching by prefix.</p>
<h3>Unicode and UTF-8 Changes</h3>
<p>Added several methods for checking characters forming
parts of XML 1.0 or XML 1.1 names:
<code>raptor_unicode_is_xml10_namestartchar</code>,
<code>raptor_unicode_is_xml11_namestartchar</code>,
<code>raptor_unicode_is_xml10_namechar</code> and
<code>raptor_unicode_is_xml11_namechar</code>.
</p>
<p>Added a function <code>raptor_utf8_check</code> to check that a
string is legal UTF-8 and all the encoded Unicode characters are in
the range U+0 <= character <= U+10FFFF</p>
<p>Added a function <code>raptor_xml_name_check</code> to check that
a string is a legal XML name (1.0 or 1.1) as well as legal UTF-8.</p>
<h3>Other Changes</h3>
<p>Feature support: Added <code>raptor_feature_value_type</code> to
determine value of a feature - either integer (most) or string.</p>
<p>XML QName class: Added <code>raptor_qname_copy</code> copy
constructor.</p>
<p>Sequence class: Added <code>raptor_sequence_join</code>
to join two sequences of items, leaving one empty.</p>
<p>Statement class: Added <code>raptor_statement_copy</code> copy
constructor and <code>raptor_free_statement</code> destructor.
Previously these were internal to raptor.</p>
<p>The <code>rapper</code> utility was modified to add a feature form:
<code>-f xmlns:</code><em>PREFIX</em><code>="</code><em>URI</em><code>"</code>
allowing the setting of output serializer namespaces.</p>
<p>The namespace URI string constants exported by raptor are now of
type unsigned char*.</p>
<h2 id="rel1_4_2"><a name="rel1_4_2">Raptor 1.4.2 Changes</a></h2>
<p>Make <code>raptor_xml_escape_string</code> fail correctly when
given bad UTF-8 to escape.</p>
<h2 id="rel1_4_1"><a name="rel1_4_1">Raptor 1.4.1 Changes</a></h2>
<p>Fixed a buffer overrun in decoding a URI scheme in
<code>raptor_uri</code> constructors such as
<code>raptor_new_uri</code>.</p>
<p>Fixed a crash in RSS enclosures crash when the <code>url</code>
attribute seen on a non-<code><enclosure></code> element</p>
<p><code>raptor_xml_escape_string</code> return value has changed to
be an int, returning <0 on failure. This allows the empty string
encoding an empty string case to work and be distinguished from an
error.
</p>
<h2 id="rel1_4_0"><a name="rel1_4_0">Raptor 1.4.0 Changes</a></h2>
<p>A release with the major new feature of providing serializing of
RDF triples to syntaxes. It also added a new support class for I/O
streams and had other minor fixes.</p>
<p>Added a Raptor Serializer class (<code>raptor_serializer</code>)
with similar style to Parser (<code>raptor_parser</code>). Two
serializers are provided, for RDF/XML and N-Triples. The serializing
can be done to files, C <code>FILE*</code> or to strings. The
raptor_iostream class that provides this also allows writing
to any other form by creating a custom iostream.
</p>
<p>The new raptor_serializer class functions added are:
<code>raptor_serializers_enumerate</code>,
<code>raptor_serializer_syntax_name_check</code>,
<code>raptor_new_serializer</code>,
<code>raptor_free_serializer</code>,
<code>raptor_serialize_start</code>,
<code>raptor_serialize_start_to_filename</code>,
<code>raptor_serialize_start_to_string</code>,
<code>raptor_serialize_start_to_file_handle</code>,
<code>raptor_serialize_statement</code>,
<code>raptor_serialize_end</code>,
<code>raptor_serializer_get_iostream</code>,
<code>raptor_serializer_set_error_handler</code>,
<code>raptor_serializer_set_warning_handler</code> and
<code>raptor_serializer_get_locator</code>
</p>
<p>Added a Raptor I/O stream abstraction in
<code>raptor_iostream</code> class to support serializing of RDF to
multiple output streams such as to filenames, to C standard I/O
<code>FILE*</code> handles and to strings especially for
cross-language use. A <code>raptor_iostream_handler</code> can
be used to construct a user-defined iostream.
</p>
<p>The new raptor_iostream class functions added are:
<code>raptor_new_iostream_from_handler</code>,
<code>raptor_new_iostream_to_sink</code>,
<code>raptor_new_iostream_to_filename</code>,
<code>raptor_new_iostream_to_file_handle</code>,
<code>raptor_new_iostream_to_string</code>,
<code>raptor_free_iostream</code>,
<code>raptor_iostream_write_bytes</code>,
<code>raptor_iostream_write_byte</code>,
<code>raptor_iostream_write_end</code>,
<code>raptor_iostream_write_string</code>,
<code>raptor_iostream_write_counted_string</code>,
<code>raptor_iostream_get_bytes_written_count</code>,
<code>raptor_iostream_write_decimal</code> and
<code>raptor_iostream_format_hexadecimal</code>.
</p>
<p>The <code>rapper</code> utility was modified to use serializer
class so that the output formats supported are now N-Triples
(<code>-o ntriples</code>) - the default, and RDF/XML (<code>-o
rdfxml</code>).</p>
<p>Raptor now exports more static namespace URI strings for
general application use:
<code>raptor_xml_namespace_uri</code>,
<code>raptor_rdf_namespace_uri</code>,
<code>raptor_rdf_schema_namespace_uri</code>,
<code>raptor_xmlschema_datatypes_namespace_uri</code>,
<code>raptor_owl_namespace_uri</code>,
and the length
<code>raptor_rdf_namespace_uri_len</code>.
</p>
<p>The raptor_stringbuffer class gained a new method
<code>raptor_stringbuffer_copy_to_string</code>
which allows efficient copy-out of a constructed string.
</p>
<p>The raptor_www class gained a new method
<code>raptor_www_fetch_to_string</code> to allow retrieving of
web content as a single string.
</p>
<p>RSS tag soup parser gained support for generating triples for
enclosures, after a patch from Suzan Foster. Changes made include
correcting the enclosures namespace and tidying some memory leaks.
</p>
<h2 id="rel1_3_3"><a name="rel1_3_3">Raptor 1.3.3 Changes</a></h2>
<p>A release with major improvements along with several minor fixes.</p>
<p>Raptor's License was changed from LGPL 2.1/MPL 1.1 to
LGPL 2.1/Apache 2</p>
<p>Thanks to Chris Pointon for several patches to make Raptor
easier to build under Win32 which were applied, with some slight
modifications.</p>
<p>Increased WWW content retrieval buffer size from 256 bytes to 4K
since this was causing problems for even moderate size documents.</p>
<p>After testing raptor on a very large RDF/XML file with many
<code>rdf:ID</code> values, the check for duplicate values was found
to be inefficient in memory and slow. The implementation was
improved to be more memory efficient and a new parser feature
<code>check_rdf_id</code> was added to disable checking (default is
enabled).</p>
<p>Added a new Unicode NFC checker to replace the functionality
formally available by calling the GNOME glib function
g_utf8_normalize. This new checker is done via several tables and
adds approximately 50K to the object size of the library when
compiled on x86. This code and tables can be disabled with configure
option <code>--disable-nfc-check</code> causing all checks to
succeed.</p>
<p>Fix the exporting of
<code>raptor_xml_literal_datatype_uri_string</code> and
<code>raptor_xml_literal_datatype_uri_string_len</code> as constants
for use by applications. Previously raptor.h wasn't doing this
correctly.</p>
<p>Added <code>raptor_calloc_memory</code> for allocating zeroed
memory inside raptor, for use by applications passing memory in/out
of raptor.</p>
<p>Added a new configure option <code>--enable-parsers</code> to
allow the selection of the required RDF parsers from any of those
supported (RDF/XML, Turtle, N-Triples, RSS tag soup).
</p>
<p>Reorganised the sources to split parsing support from RDF/XML
to support compiling without this parser.</p>
<p>Updated the RSS Tag Soup parser to start to handle the Atom 0.3
currently being standardised by the
<a href="http://www.ietf.org/html.charters/atompub-charter.html">IETF Atom Publishing Format and Protocol</a>
working group.
</p>
<p>Altered the Turtle parser to work with large source documents that
exceeded bison limits. Thanks to Geoff Chappell for providing a fix for
this.</p>
<p>Rewrote the URI parsing to create an internal structure and
improved the relative URI resolving in preparation for future work
such as potentially supporting URI canonicalisation such as proposed
to be used by Atom.</p>
<h2 id="rel1_3_2"><a name="rel1_3_2">Raptor 1.3.2 Changes</a></h2>
<p>A release with some minor fixes.</p>
<p>Added a new configure option
<code>--with-expat-source=</code><em>DIR</em>
to allow the use of external expat source trees in either the old or
newer directory structure style. (Patch from Mark Smith).</p>
<p>Added <code>raptor_alloc_memory</code> for handlers that need to
allocate memory in the same heap as raptor uses for
<code>raptor_free_memory</code>. This is mostly useful for allocating
memory that is freed by raptor in error, ID and statement handlers
on win32 which has separate heaps for different DLLs.</p>
<p>A bug was fixed where errors which happened when fetching WWW
content were always printed to stderr. They are now passed to the
main error routines which allows applications to retrieve them.</p>
<p>Accessor functions were added for parts of the public
<code>raptor_locator</code> structure which makes it possible to get
structured error information from language bindings via Redland
(Patch from Edd Dumbill). The new functions are:</p>
<ul>
<li><code>int raptor_locator_line(raptor_locator *locator);</code></li>
<li><code>int raptor_locator_column(raptor_locator *locator);</code></li>
<li><code>int raptor_locator_byte(raptor_locator *locator);</code></li>
<li><code>const char * raptor_locator_file(raptor_locator *locator);</code></li>
<li><code>const char * raptor_locator_uri(raptor_locator *locator);</code></li>
</ul>
<p>The Unicode Normal Form C (NFC) checking via the GNOME glib
library function <code>g_utf8_normalize</code> is broken, comparing
the data it says is failed against other NFC checkers. It is also
slower than need be since it is doing full normalizing rather than
just checking for NFC, and adds a rather large dependency for just
one function. A new portable checker will be added in a later
release.</p>
<h2 id="rel1_3_1"><a name="rel1_3_1">Raptor 1.3.1 Changes</a></h2>
<p>A release primarily to fix some win32 and portability issues.</p>
<p>raptor.h now includes stdarg.h</p>
<p>Corrected the <code>raptor_print_statement</code> declaration in
raptor.h for the argument statement to have one less 'const' which
matches the actual code.</p>
<p>Made several portability fixes for compiling natively on win32
which doesn't quite do POSIX or C99.</p>
<p>Changed the support for file: URIs and converting to and from
filenames. It now %-escapes spaces and % characters on conversion
to and from filenames with
<code>raptor_uri_uri_string_to_filename</code>,
<code>raptor_uri_uri_string_to_filename_fragment</code>
and
<code>raptor_uri_filename_to_uri_string</code>.
For Win32, more tests were added and the
format of URIs supported corrected to use the <code>file:///c:</code>
form rather than <code>file://c|/</code></p>
<p>URIs that resolve to directories now return an error when lstat is
available to check.</p>
<h3>Parser Changes</h3>
<p>The
<a href="https://www.dajobe.org/2004/01/turtle/">Turtle</a>
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.
</p>
<p>The Turtle parser was fixed to re-initialise correctly when
performing multiple parsings. The other parsers already did this
correctly.</p>
<p>Added a warning to the RDF/XML parser for unknown
<code>rdf:parseType</code> values, when parsing in lax mode - which
is the default. It now tells the user when the parsing is working as
'Literal' mode by finding an unknown value. This is controlled by a
new parser feature warn_other_parsetypes which is default set true
in lax mode. Parser modes are controlled by the
<code>raptor_set_parser_strict</code> method.</p>
<h2 id="rel1_3_0"><a name="rel1_3_0">Raptor 1.3.0 Changes</a></h2>
<p>A release primarily to provide support for
the new <a href="https://librdf.org/rasqal/">Rasqal</a>
RDF query library but with some new features and fixes.</p>
<h3>Parser Changes</h3>
<p>Added a new constructor
<code>raptor_new_parser_for_content</code> to guess the parser to use
from hints in URIs or content, using a new utility function
<code>raptor_guess_parser_name</code>.</p>
<p>Additional checks were added to the RDF/XML parser for
RDF-namespaced names in element and attributes and if they are
forbidden giving an error otherwise if unknown, giving a warning.</p>
<p>The
<a href="https://www.dajobe.org/2004/01/turtle/">Turtle</a>
parser was updated to correct the collections syntax, allow '-' in
names and QNames and to add integer literals. This parser now correctly
uses <code>raptor_generate_id</code> when a blank identifier name is
needed.</p>
<p>Completed parser feature support by adding <code>raptor_get_feature</code>,
<code>raptor_feature_from_uri</code>, and
<code>raptor_features_enumerate</code> to get values and enable
discovery of supported features at run time.
<code>raptor_set_feature</code> was changed to give return a success
value</p>
<p>Added a new method <code>raptor_get_mime_type</code> to get the
MIME type of the syntax for a parser</p>
<p><code>raptor_parse_uri_with_connection</code> (which is called by
<code>raptor_parse_uri</code>) now sets the HTTP <code>Accept:</code>
header to the MIME type of the parser in WWW requests using the new
<code>raptor_www_set_http_accept()</code>.
</p>
<h3><code>rapper</code> changes</h3>
<p>Added options <code>-f</code>/<code>--feature</code> for setting
features and <code>-g</code>/<code>--guess</code> for guessing syntax
from some content or identifiers. See <a href="rapper.html">rapper(1)</a>
for all rapper options.</p>
<h3>Utility function changes</h3>
<p>Added <code>raptor_syntax_name_check</code> to check for valid
syntax language names.<br />
</p>
<p>Added <code>raptor_free_memory</code> to free memory returned by
raptor functions.</p>
<p>Added Unicode utility functions <code>raptor_unicode_char_to_utf8</code> and
<code>raptor_utf8_to_unicode_char</code>.</p>
<p>Exported URI string <code>raptor_xml_literal_datatype_uri_string</code>.</p>
<p>Deprecated <code>raptor_print_statement_detailed</code> always
intended to be internal.</p>
<h3>WWW Class changes</h3>
<p>Added support to set the HTTP <code>Accept:</code> header for curl
and libxml2 when retrieving HTTP content by the new
<code>raptor_www_set_http_accept</code> method.
</p>
<h3>New classes - Sequence and Stringbuffer</h3>
<p>Added a utility class <code>raptor_sequence</code> providing
simple sequences that can handle stacks and queues</p>
<p>Added a utility class <code>raptor_stringbuffer</code>
for constructing strings from substrings appended or prepended.</p>
<h2 id="rel_older"><a name="rel_older">Raptor 0.9.0 - Raptor 1.2.0 Changes</a></h2>
<p>Release notes for 1.2.0 and earlier are in the
<a href="NEWS.html">NEWS page</a> or
<a href="ChangeLog">ChangeLog</a>
</p>
<hr />
<p>Copyright (C) 2003-2023 <a href="https://www.dajobe.org/">Dave Beckett</a><br />Copyright (C) 2003-2005 <a href="https://www.bristol.ac.uk/">University of Bristol</a></p>
</body>
</html>
|
