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 4874 4875 4876 4877 4878 4879 4880 4881 4882 4883 4884 4885 4886 4887 4888 4889 4890 4891 4892 4893 4894 4895 4896 4897 4898 4899 4900 4901 4902 4903 4904 4905 4906 4907 4908 4909 4910 4911 4912 4913 4914 4915 4916 4917 4918 4919 4920 4921 4922 4923 4924 4925 4926 4927 4928 4929 4930 4931 4932 4933 4934 4935 4936 4937 4938 4939 4940 4941 4942 4943 4944 4945 4946 4947 4948 4949 4950 4951 4952 4953 4954 4955 4956 4957 4958 4959 4960 4961 4962 4963 4964 4965 4966 4967 4968 4969 4970 4971 4972 4973 4974 4975 4976 4977 4978 4979 4980 4981 4982 4983 4984 4985 4986 4987 4988 4989 4990 4991 4992 4993 4994 4995 4996 4997 4998 4999 5000 5001 5002 5003 5004 5005 5006 5007 5008 5009 5010 5011 5012 5013 5014 5015 5016 5017 5018 5019 5020 5021 5022 5023 5024 5025 5026 5027 5028 5029 5030 5031 5032 5033 5034 5035 5036 5037 5038 5039 5040 5041 5042 5043 5044 5045 5046 5047 5048 5049 5050 5051 5052 5053 5054 5055 5056 5057 5058 5059 5060 5061 5062 5063 5064 5065 5066 5067 5068 5069 5070 5071 5072 5073 5074 5075 5076 5077 5078 5079 5080 5081 5082 5083 5084 5085 5086 5087 5088 5089 5090 5091 5092 5093 5094 5095 5096 5097 5098 5099 5100 5101 5102 5103 5104 5105 5106 5107 5108 5109 5110 5111 5112 5113 5114 5115 5116 5117 5118 5119 5120 5121 5122 5123 5124 5125 5126 5127 5128 5129 5130 5131 5132 5133 5134 5135 5136 5137 5138 5139 5140 5141 5142 5143 5144 5145 5146 5147 5148 5149 5150 5151 5152 5153 5154 5155 5156 5157 5158 5159 5160 5161 5162 5163 5164 5165 5166 5167 5168 5169 5170 5171 5172 5173 5174 5175 5176 5177 5178 5179 5180 5181 5182 5183 5184 5185 5186 5187 5188 5189 5190 5191 5192 5193 5194 5195 5196 5197 5198 5199 5200 5201 5202 5203 5204 5205 5206 5207 5208 5209 5210 5211 5212 5213 5214 5215 5216 5217 5218 5219 5220 5221 5222 5223 5224 5225 5226 5227 5228 5229 5230 5231 5232 5233 5234 5235 5236 5237 5238 5239 5240 5241 5242 5243 5244 5245 5246 5247 5248 5249 5250 5251 5252 5253 5254 5255 5256 5257 5258 5259 5260 5261 5262 5263 5264 5265 5266 5267 5268 5269 5270 5271 5272 5273 5274 5275 5276 5277 5278 5279 5280 5281 5282 5283 5284 5285 5286 5287 5288 5289 5290 5291 5292 5293 5294 5295 5296 5297 5298 5299 5300 5301 5302 5303 5304 5305 5306 5307 5308 5309 5310 5311 5312 5313 5314 5315 5316 5317 5318 5319 5320 5321 5322 5323 5324 5325 5326 5327 5328 5329 5330 5331 5332 5333 5334 5335 5336 5337 5338 5339 5340 5341 5342 5343 5344 5345 5346 5347 5348 5349 5350 5351 5352 5353 5354 5355 5356 5357 5358 5359 5360 5361 5362 5363 5364 5365 5366 5367 5368 5369 5370 5371 5372 5373 5374 5375 5376 5377 5378 5379 5380 5381 5382 5383 5384 5385 5386 5387 5388 5389 5390 5391 5392 5393 5394 5395 5396 5397 5398 5399 5400 5401 5402 5403 5404 5405 5406 5407 5408 5409 5410 5411 5412 5413 5414 5415 5416 5417 5418 5419 5420 5421 5422 5423 5424 5425 5426 5427 5428 5429 5430 5431 5432 5433 5434 5435 5436 5437 5438 5439 5440 5441 5442 5443 5444 5445 5446 5447 5448 5449 5450 5451 5452 5453 5454 5455 5456 5457 5458 5459 5460 5461 5462 5463 5464 5465 5466 5467 5468 5469 5470 5471 5472 5473 5474 5475 5476 5477 5478 5479 5480 5481 5482 5483 5484 5485 5486 5487 5488 5489 5490 5491 5492 5493 5494 5495 5496 5497 5498 5499 5500 5501 5502 5503 5504 5505 5506 5507 5508 5509 5510 5511 5512 5513 5514 5515 5516 5517 5518 5519 5520 5521 5522 5523 5524 5525 5526 5527 5528 5529 5530 5531 5532 5533 5534 5535 5536 5537 5538 5539 5540 5541 5542 5543 5544 5545 5546 5547 5548 5549 5550 5551 5552 5553 5554 5555 5556 5557 5558 5559 5560 5561 5562 5563 5564 5565 5566 5567 5568 5569 5570 5571 5572 5573 5574 5575 5576 5577 5578 5579 5580 5581 5582 5583 5584 5585 5586 5587 5588 5589 5590 5591 5592 5593 5594 5595 5596 5597 5598 5599 5600 5601 5602 5603 5604 5605 5606 5607 5608 5609 5610 5611 5612 5613 5614 5615 5616 5617 5618 5619 5620 5621 5622 5623 5624 5625 5626 5627 5628 5629 5630 5631 5632 5633 5634 5635 5636 5637 5638 5639 5640 5641 5642 5643 5644 5645 5646 5647 5648 5649 5650 5651 5652 5653 5654 5655 5656 5657 5658 5659 5660 5661 5662 5663 5664 5665 5666 5667 5668 5669 5670 5671 5672 5673 5674 5675 5676 5677 5678 5679 5680 5681 5682 5683 5684 5685 5686 5687 5688 5689 5690 5691 5692 5693 5694 5695 5696 5697 5698 5699 5700 5701 5702 5703 5704 5705 5706 5707 5708 5709 5710 5711 5712 5713 5714 5715 5716 5717 5718 5719 5720 5721 5722 5723 5724 5725 5726 5727 5728 5729 5730 5731 5732 5733 5734 5735 5736 5737 5738 5739 5740 5741 5742 5743 5744 5745 5746 5747 5748 5749 5750 5751 5752 5753 5754 5755 5756 5757 5758 5759 5760 5761 5762 5763 5764 5765 5766 5767 5768 5769 5770 5771 5772 5773 5774 5775 5776 5777 5778 5779 5780 5781 5782 5783 5784 5785 5786 5787 5788 5789 5790 5791 5792 5793 5794 5795 5796 5797 5798 5799 5800 5801 5802 5803 5804 5805 5806 5807 5808 5809 5810 5811 5812 5813 5814 5815 5816 5817 5818 5819 5820 5821 5822 5823 5824 5825 5826 5827 5828 5829 5830 5831 5832 5833 5834 5835 5836 5837 5838 5839 5840 5841 5842 5843 5844 5845 5846 5847 5848 5849 5850 5851 5852 5853 5854 5855 5856 5857 5858 5859 5860 5861 5862 5863 5864 5865 5866 5867 5868 5869 5870 5871 5872 5873 5874 5875 5876 5877 5878 5879 5880 5881 5882 5883 5884 5885 5886 5887 5888 5889 5890 5891 5892 5893 5894 5895 5896 5897 5898 5899 5900 5901 5902 5903 5904 5905 5906 5907 5908 5909 5910 5911 5912 5913 5914 5915 5916 5917 5918 5919 5920 5921 5922 5923 5924 5925 5926 5927 5928 5929 5930 5931 5932 5933 5934 5935 5936 5937 5938 5939 5940 5941 5942 5943 5944 5945 5946 5947 5948 5949 5950 5951 5952 5953 5954 5955 5956 5957 5958 5959 5960 5961 5962 5963 5964 5965 5966 5967 5968 5969 5970 5971 5972 5973 5974 5975 5976 5977 5978 5979 5980 5981 5982 5983 5984 5985 5986 5987 5988 5989 5990 5991 5992 5993 5994 5995 5996 5997 5998 5999 6000 6001 6002 6003 6004 6005 6006 6007 6008 6009 6010 6011 6012 6013 6014 6015 6016 6017 6018 6019 6020 6021 6022 6023 6024 6025 6026 6027 6028 6029 6030 6031 6032 6033 6034 6035 6036 6037 6038 6039 6040 6041 6042 6043 6044 6045 6046 6047 6048 6049 6050 6051 6052 6053 6054 6055 6056 6057 6058 6059 6060 6061 6062 6063 6064 6065 6066 6067 6068 6069 6070 6071 6072 6073 6074 6075 6076 6077 6078 6079 6080 6081 6082 6083 6084 6085 6086 6087 6088 6089 6090 6091 6092 6093 6094 6095 6096 6097 6098 6099 6100 6101 6102 6103 6104 6105 6106 6107 6108 6109 6110 6111 6112 6113 6114 6115 6116 6117 6118 6119 6120 6121 6122 6123 6124 6125 6126 6127 6128 6129 6130 6131 6132 6133 6134 6135 6136 6137 6138 6139 6140 6141 6142 6143 6144 6145 6146 6147 6148 6149 6150 6151 6152 6153 6154 6155 6156 6157 6158 6159 6160 6161 6162 6163 6164 6165 6166 6167 6168 6169 6170 6171 6172 6173 6174 6175 6176 6177 6178 6179 6180 6181 6182 6183 6184 6185 6186 6187 6188 6189 6190 6191 6192 6193 6194 6195 6196 6197 6198 6199 6200 6201 6202 6203 6204 6205 6206 6207 6208 6209 6210 6211 6212 6213 6214 6215 6216 6217 6218 6219 6220 6221 6222 6223 6224 6225 6226 6227 6228 6229 6230 6231 6232 6233 6234 6235 6236 6237 6238 6239 6240 6241 6242 6243 6244 6245 6246 6247 6248 6249 6250 6251 6252 6253 6254 6255 6256 6257 6258 6259 6260 6261 6262 6263 6264 6265 6266 6267 6268 6269 6270 6271 6272 6273 6274 6275 6276 6277 6278 6279 6280 6281 6282 6283 6284 6285 6286 6287 6288 6289 6290 6291 6292 6293 6294 6295 6296 6297 6298 6299 6300 6301 6302 6303 6304 6305 6306 6307 6308 6309 6310 6311 6312 6313 6314 6315 6316 6317 6318 6319 6320 6321 6322 6323 6324 6325 6326 6327 6328 6329 6330 6331 6332 6333 6334 6335 6336 6337 6338 6339 6340 6341 6342 6343 6344 6345 6346 6347 6348 6349 6350 6351 6352 6353 6354 6355 6356 6357 6358 6359 6360 6361 6362 6363 6364 6365 6366 6367 6368 6369 6370 6371 6372 6373 6374 6375 6376 6377 6378 6379 6380 6381 6382 6383 6384 6385 6386 6387 6388 6389 6390 6391 6392 6393 6394 6395 6396 6397 6398 6399 6400 6401 6402 6403 6404 6405 6406 6407 6408 6409 6410 6411 6412 6413 6414 6415 6416 6417 6418 6419 6420 6421 6422 6423 6424 6425 6426 6427 6428 6429 6430 6431 6432 6433 6434 6435 6436 6437 6438 6439 6440 6441 6442 6443 6444 6445 6446 6447 6448 6449 6450 6451 6452 6453 6454 6455 6456 6457 6458 6459 6460 6461 6462 6463 6464 6465 6466 6467 6468 6469 6470 6471 6472 6473 6474 6475 6476 6477 6478 6479 6480 6481 6482 6483 6484 6485 6486 6487 6488 6489 6490 6491 6492 6493 6494 6495 6496 6497 6498 6499 6500 6501 6502 6503 6504 6505 6506 6507 6508 6509 6510 6511 6512 6513 6514 6515 6516 6517 6518 6519 6520 6521 6522 6523 6524 6525 6526 6527 6528 6529 6530 6531 6532 6533 6534 6535 6536 6537 6538 6539 6540 6541 6542 6543 6544 6545 6546 6547 6548 6549 6550 6551 6552 6553 6554 6555 6556 6557 6558 6559 6560 6561 6562 6563 6564 6565 6566 6567 6568 6569 6570 6571 6572 6573 6574 6575 6576 6577 6578 6579 6580 6581 6582 6583 6584 6585 6586 6587 6588 6589 6590 6591 6592 6593 6594 6595 6596 6597 6598 6599 6600 6601 6602 6603 6604 6605 6606 6607 6608 6609 6610 6611 6612 6613 6614 6615 6616 6617 6618 6619 6620 6621 6622 6623 6624 6625 6626 6627 6628 6629 6630 6631 6632 6633 6634 6635 6636 6637 6638 6639 6640 6641 6642 6643 6644 6645 6646 6647 6648 6649 6650 6651 6652 6653 6654 6655 6656 6657 6658 6659 6660 6661 6662 6663 6664 6665 6666 6667 6668 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 6693 6694 6695 6696 6697 6698 6699 6700 6701 6702 6703 6704 6705 6706 6707 6708 6709 6710 6711 6712 6713 6714 6715 6716 6717 6718 6719 6720 6721 6722 6723 6724 6725 6726 6727 6728 6729 6730 6731 6732 6733 6734 6735 6736 6737 6738 6739 6740 6741 6742 6743 6744 6745 6746 6747 6748 6749 6750 6751 6752 6753 6754 6755 6756 6757 6758 6759 6760 6761 6762 6763 6764 6765 6766 6767 6768 6769 6770 6771 6772 6773 6774 6775 6776 6777 6778 6779 6780 6781 6782 6783 6784 6785 6786 6787 6788 6789 6790 6791 6792 6793 6794 6795 6796 6797 6798 6799 6800 6801 6802 6803 6804 6805 6806 6807 6808 6809 6810 6811 6812 6813 6814 6815 6816 6817 6818 6819 6820 6821 6822 6823 6824 6825 6826 6827 6828 6829 6830 6831 6832 6833 6834 6835 6836 6837 6838 6839 6840 6841 6842 6843 6844 6845 6846 6847 6848 6849 6850 6851 6852 6853 6854 6855 6856 6857 6858 6859 6860 6861 6862 6863 6864 6865 6866 6867 6868 6869 6870 6871 6872 6873 6874 6875 6876 6877 6878 6879 6880 6881 6882 6883 6884 6885 6886 6887 6888 6889 6890 6891 6892 6893 6894 6895 6896 6897 6898 6899 6900 6901 6902 6903 6904 6905 6906 6907 6908 6909 6910 6911 6912 6913 6914 6915 6916 6917 6918 6919 6920 6921 6922 6923 6924 6925 6926 6927 6928 6929 6930 6931 6932 6933 6934 6935 6936 6937 6938 6939 6940 6941 6942 6943 6944 6945 6946 6947 6948 6949 6950 6951 6952 6953 6954 6955 6956 6957 6958 6959 6960 6961 6962 6963 6964 6965 6966 6967 6968 6969 6970 6971 6972 6973 6974 6975 6976 6977 6978 6979 6980 6981 6982 6983 6984 6985 6986 6987 6988 6989 6990 6991 6992 6993 6994 6995 6996 6997 6998 6999 7000 7001 7002 7003 7004 7005 7006 7007 7008 7009 7010 7011 7012 7013 7014 7015 7016 7017 7018 7019 7020 7021 7022 7023 7024 7025 7026 7027 7028 7029 7030 7031 7032 7033 7034 7035 7036 7037 7038 7039 7040 7041 7042 7043 7044 7045 7046 7047 7048 7049 7050 7051 7052 7053 7054 7055 7056 7057 7058 7059 7060 7061 7062 7063 7064 7065 7066 7067 7068 7069 7070 7071 7072 7073 7074 7075 7076 7077 7078 7079 7080 7081 7082 7083 7084 7085 7086 7087 7088 7089 7090 7091 7092 7093 7094 7095 7096 7097 7098 7099 7100 7101 7102 7103 7104 7105 7106 7107 7108 7109 7110 7111 7112 7113 7114 7115 7116 7117 7118 7119 7120 7121 7122 7123 7124 7125 7126 7127 7128 7129 7130 7131 7132 7133 7134 7135 7136 7137 7138 7139 7140 7141 7142 7143 7144 7145 7146 7147 7148 7149 7150 7151 7152 7153 7154 7155 7156 7157 7158 7159 7160 7161 7162 7163 7164 7165 7166 7167 7168 7169 7170 7171 7172 7173 7174 7175 7176 7177 7178 7179 7180 7181 7182 7183 7184 7185 7186 7187 7188 7189 7190 7191 7192 7193 7194 7195 7196 7197 7198 7199 7200 7201 7202 7203 7204 7205 7206 7207 7208 7209 7210 7211 7212 7213 7214 7215 7216 7217 7218 7219 7220 7221 7222 7223 7224 7225 7226 7227 7228 7229 7230 7231 7232 7233 7234 7235 7236 7237 7238 7239 7240 7241 7242 7243 7244 7245 7246 7247 7248 7249 7250 7251 7252 7253 7254 7255 7256 7257 7258 7259 7260 7261 7262 7263 7264 7265 7266 7267 7268 7269 7270 7271 7272 7273 7274 7275 7276 7277 7278 7279 7280 7281 7282 7283 7284 7285 7286 7287 7288 7289 7290 7291 7292 7293 7294 7295 7296 7297 7298 7299 7300 7301 7302 7303 7304 7305 7306 7307 7308 7309 7310 7311 7312 7313 7314 7315 7316 7317 7318 7319 7320 7321 7322 7323 7324 7325 7326 7327 7328 7329 7330 7331 7332 7333 7334 7335 7336 7337 7338 7339 7340 7341 7342 7343 7344 7345 7346 7347 7348 7349 7350 7351 7352 7353 7354 7355 7356 7357 7358 7359 7360 7361 7362 7363 7364 7365 7366 7367 7368 7369 7370 7371 7372 7373 7374 7375 7376 7377 7378 7379 7380 7381 7382 7383 7384 7385 7386 7387 7388 7389 7390 7391 7392 7393 7394 7395 7396 7397 7398 7399 7400 7401 7402 7403 7404 7405 7406 7407 7408 7409 7410 7411 7412 7413 7414 7415 7416 7417 7418 7419 7420 7421 7422 7423 7424 7425 7426 7427 7428 7429 7430 7431 7432 7433 7434 7435 7436 7437 7438 7439 7440 7441 7442 7443 7444 7445 7446 7447 7448 7449 7450 7451 7452 7453 7454 7455 7456 7457 7458 7459 7460 7461 7462 7463 7464 7465 7466 7467 7468 7469 7470 7471 7472 7473 7474 7475 7476 7477 7478 7479 7480 7481 7482 7483 7484 7485 7486 7487 7488 7489 7490 7491 7492 7493 7494 7495 7496 7497 7498 7499 7500 7501 7502 7503 7504 7505 7506 7507 7508 7509 7510 7511 7512 7513 7514 7515 7516 7517 7518 7519 7520 7521 7522 7523 7524 7525 7526 7527 7528 7529 7530 7531 7532 7533 7534 7535 7536 7537 7538 7539 7540 7541 7542 7543 7544 7545 7546 7547 7548 7549 7550 7551 7552 7553 7554 7555 7556 7557 7558 7559 7560 7561 7562 7563 7564 7565 7566 7567 7568 7569 7570 7571 7572 7573 7574 7575 7576 7577 7578 7579 7580 7581 7582 7583 7584 7585 7586 7587 7588 7589 7590 7591 7592 7593 7594 7595 7596 7597 7598 7599 7600 7601 7602 7603 7604 7605 7606 7607 7608 7609 7610 7611 7612 7613 7614 7615 7616 7617 7618 7619 7620 7621 7622 7623 7624 7625 7626 7627 7628 7629 7630 7631 7632 7633 7634 7635 7636 7637 7638 7639 7640 7641 7642 7643 7644 7645 7646 7647 7648 7649 7650 7651 7652 7653 7654 7655 7656 7657 7658 7659 7660 7661 7662 7663 7664 7665 7666 7667 7668 7669 7670 7671 7672 7673 7674 7675 7676 7677 7678 7679 7680 7681 7682 7683 7684 7685 7686 7687 7688 7689 7690 7691 7692 7693 7694 7695 7696 7697 7698 7699 7700 7701 7702 7703 7704 7705 7706 7707 7708 7709 7710 7711 7712 7713 7714 7715 7716 7717 7718 7719 7720 7721 7722 7723 7724 7725 7726 7727 7728 7729 7730 7731 7732 7733 7734 7735 7736 7737 7738 7739 7740 7741 7742 7743 7744 7745 7746 7747 7748 7749 7750 7751 7752 7753 7754 7755 7756 7757 7758 7759 7760 7761 7762 7763 7764 7765 7766 7767 7768 7769 7770 7771 7772 7773 7774 7775 7776 7777 7778 7779 7780 7781 7782 7783 7784 7785 7786 7787 7788 7789 7790 7791 7792 7793 7794 7795 7796 7797 7798 7799 7800 7801 7802 7803 7804 7805 7806 7807 7808 7809 7810 7811 7812 7813 7814 7815 7816 7817 7818 7819 7820 7821 7822 7823 7824 7825 7826 7827 7828 7829 7830 7831 7832 7833 7834 7835 7836 7837 7838 7839 7840 7841 7842 7843 7844 7845 7846 7847 7848 7849 7850 7851 7852 7853 7854 7855 7856 7857 7858 7859 7860 7861 7862 7863 7864 7865 7866 7867 7868 7869 7870 7871 7872 7873 7874 7875 7876 7877 7878 7879 7880 7881 7882 7883 7884 7885 7886 7887 7888 7889 7890 7891 7892 7893 7894 7895 7896 7897 7898 7899 7900 7901 7902 7903 7904 7905 7906 7907 7908 7909 7910 7911 7912 7913 7914 7915 7916 7917 7918 7919 7920 7921 7922 7923 7924 7925 7926 7927 7928 7929 7930 7931 7932 7933 7934 7935 7936 7937 7938 7939 7940 7941 7942 7943 7944 7945 7946 7947 7948 7949 7950 7951 7952 7953 7954 7955 7956 7957 7958 7959 7960 7961 7962 7963 7964 7965 7966 7967 7968 7969 7970 7971 7972 7973 7974 7975 7976 7977 7978 7979 7980 7981 7982 7983 7984 7985 7986 7987 7988 7989 7990 7991 7992 7993 7994 7995 7996 7997 7998 7999 8000 8001 8002 8003 8004 8005 8006 8007 8008 8009 8010 8011 8012 8013 8014 8015 8016 8017 8018 8019 8020 8021 8022 8023 8024 8025 8026 8027 8028 8029 8030 8031 8032 8033 8034 8035 8036 8037 8038 8039 8040 8041 8042 8043 8044 8045 8046 8047 8048 8049 8050 8051 8052 8053 8054 8055 8056 8057 8058 8059 8060 8061 8062 8063 8064 8065 8066 8067 8068 8069 8070 8071 8072 8073 8074 8075 8076 8077 8078 8079 8080 8081 8082 8083 8084 8085 8086 8087 8088 8089 8090 8091 8092 8093 8094 8095 8096 8097 8098 8099 8100 8101 8102 8103 8104 8105 8106 8107 8108 8109 8110 8111 8112 8113 8114 8115 8116 8117 8118 8119 8120 8121 8122 8123 8124 8125 8126 8127 8128 8129 8130 8131 8132 8133 8134 8135 8136 8137 8138 8139 8140 8141 8142 8143 8144 8145 8146 8147 8148 8149 8150 8151 8152 8153 8154 8155 8156 8157 8158 8159 8160 8161 8162 8163 8164 8165 8166 8167 8168 8169 8170 8171 8172 8173 8174 8175 8176 8177 8178 8179 8180 8181 8182 8183 8184 8185 8186 8187 8188 8189 8190 8191 8192 8193 8194 8195 8196 8197 8198 8199 8200 8201 8202 8203 8204 8205 8206 8207 8208 8209 8210 8211 8212 8213 8214 8215 8216 8217 8218 8219 8220 8221 8222 8223 8224 8225 8226 8227 8228 8229 8230 8231 8232 8233 8234 8235 8236 8237 8238 8239 8240 8241 8242 8243 8244 8245 8246 8247 8248 8249 8250 8251 8252 8253 8254 8255 8256 8257 8258 8259 8260 8261 8262 8263 8264 8265 8266 8267 8268 8269 8270 8271 8272 8273 8274 8275 8276 8277 8278 8279 8280 8281 8282 8283 8284 8285 8286 8287 8288 8289 8290 8291 8292 8293 8294 8295 8296 8297 8298 8299 8300 8301 8302 8303 8304 8305 8306 8307 8308 8309 8310 8311 8312 8313 8314 8315 8316 8317 8318 8319 8320 8321 8322 8323 8324 8325 8326 8327 8328 8329 8330 8331 8332 8333 8334 8335 8336 8337 8338 8339 8340 8341 8342 8343 8344 8345 8346 8347 8348 8349 8350 8351 8352 8353 8354 8355 8356 8357 8358 8359 8360 8361 8362 8363 8364 8365 8366 8367 8368 8369 8370 8371 8372 8373 8374 8375 8376 8377 8378 8379 8380 8381 8382 8383 8384 8385 8386 8387 8388 8389 8390 8391 8392 8393 8394 8395 8396 8397 8398 8399 8400 8401 8402 8403 8404 8405 8406 8407 8408 8409 8410 8411 8412 8413 8414 8415 8416 8417 8418 8419 8420 8421 8422 8423 8424 8425 8426 8427 8428 8429 8430 8431 8432 8433 8434 8435 8436 8437 8438 8439 8440 8441 8442 8443 8444 8445 8446 8447 8448 8449 8450 8451 8452 8453 8454 8455 8456 8457 8458 8459 8460 8461 8462 8463 8464 8465 8466 8467 8468 8469 8470 8471 8472 8473 8474 8475 8476 8477 8478 8479 8480 8481 8482 8483 8484 8485 8486 8487 8488 8489 8490 8491 8492 8493 8494 8495 8496 8497 8498 8499 8500 8501 8502 8503 8504 8505 8506 8507 8508 8509 8510 8511 8512 8513 8514 8515 8516 8517 8518 8519 8520 8521 8522 8523 8524 8525 8526 8527 8528 8529 8530 8531 8532 8533 8534 8535 8536 8537 8538 8539 8540 8541 8542 8543 8544 8545 8546 8547 8548 8549 8550 8551 8552 8553 8554 8555 8556 8557 8558 8559 8560 8561 8562 8563 8564 8565 8566 8567 8568 8569 8570 8571 8572 8573 8574 8575 8576 8577 8578 8579 8580 8581 8582 8583 8584 8585 8586 8587 8588 8589 8590 8591 8592 8593 8594 8595 8596 8597 8598 8599 8600 8601 8602 8603 8604 8605 8606 8607 8608 8609 8610 8611 8612 8613 8614 8615 8616 8617 8618 8619 8620 8621 8622 8623 8624 8625 8626 8627 8628 8629 8630 8631 8632 8633 8634 8635 8636 8637 8638 8639 8640 8641 8642 8643 8644 8645 8646 8647 8648 8649 8650 8651 8652 8653 8654 8655 8656 8657 8658 8659 8660 8661 8662 8663 8664 8665 8666 8667 8668 8669 8670 8671 8672 8673 8674 8675 8676 8677 8678 8679 8680 8681 8682 8683 8684 8685 8686 8687 8688 8689 8690 8691 8692 8693 8694 8695 8696 8697 8698 8699 8700 8701 8702 8703 8704 8705 8706 8707 8708 8709 8710 8711 8712 8713 8714 8715 8716 8717 8718 8719 8720 8721 8722 8723 8724 8725 8726 8727 8728 8729 8730 8731 8732 8733 8734 8735 8736 8737 8738 8739 8740 8741 8742 8743 8744 8745 8746 8747 8748 8749 8750 8751 8752 8753 8754 8755 8756 8757 8758 8759 8760 8761 8762 8763 8764 8765 8766 8767 8768 8769 8770 8771 8772 8773 8774 8775 8776 8777 8778 8779 8780 8781 8782 8783 8784 8785 8786 8787 8788 8789 8790 8791 8792 8793 8794 8795 8796 8797 8798 8799 8800 8801 8802 8803 8804 8805 8806 8807 8808 8809 8810 8811 8812 8813 8814 8815 8816 8817 8818 8819 8820 8821 8822 8823 8824 8825 8826 8827 8828 8829 8830 8831 8832 8833 8834 8835 8836 8837 8838 8839 8840 8841 8842 8843 8844 8845 8846 8847 8848 8849 8850 8851 8852 8853 8854 8855 8856 8857 8858 8859 8860 8861 8862 8863 8864 8865 8866 8867 8868 8869 8870 8871 8872 8873 8874 8875 8876 8877 8878 8879 8880 8881 8882 8883 8884 8885 8886 8887 8888 8889 8890 8891 8892 8893 8894 8895 8896 8897 8898 8899 8900 8901 8902 8903 8904 8905 8906 8907 8908 8909 8910 8911 8912 8913 8914 8915 8916 8917 8918 8919 8920 8921 8922 8923 8924 8925 8926 8927 8928 8929 8930 8931 8932 8933 8934 8935 8936 8937 8938 8939 8940 8941 8942 8943 8944 8945 8946 8947 8948 8949 8950 8951 8952 8953 8954 8955 8956 8957 8958 8959 8960 8961 8962 8963 8964 8965 8966 8967 8968 8969 8970 8971 8972 8973 8974 8975 8976 8977 8978 8979 8980 8981 8982 8983 8984 8985 8986 8987 8988 8989 8990 8991 8992 8993 8994 8995 8996 8997 8998 8999 9000 9001 9002 9003 9004 9005 9006 9007 9008 9009 9010 9011 9012 9013 9014 9015 9016 9017 9018 9019 9020 9021 9022 9023 9024 9025 9026 9027 9028 9029 9030 9031 9032 9033 9034 9035 9036 9037 9038 9039 9040 9041 9042 9043 9044 9045 9046 9047 9048 9049 9050 9051 9052 9053 9054 9055 9056 9057 9058 9059 9060 9061 9062 9063 9064 9065 9066 9067 9068 9069 9070 9071 9072 9073 9074 9075 9076 9077 9078 9079 9080 9081 9082 9083 9084 9085 9086 9087 9088 9089 9090 9091 9092 9093 9094 9095 9096 9097 9098 9099 9100 9101 9102 9103 9104 9105 9106 9107 9108 9109 9110 9111 9112 9113 9114 9115 9116 9117 9118 9119 9120 9121 9122 9123 9124 9125 9126 9127 9128 9129 9130 9131 9132 9133 9134 9135 9136 9137 9138 9139 9140 9141 9142 9143 9144 9145 9146 9147 9148 9149 9150 9151 9152 9153 9154 9155 9156 9157 9158 9159 9160 9161 9162 9163 9164 9165 9166 9167 9168 9169 9170 9171 9172 9173 9174 9175 9176 9177 9178 9179 9180 9181 9182 9183 9184 9185 9186 9187 9188 9189 9190 9191 9192 9193 9194 9195 9196 9197 9198 9199 9200 9201 9202 9203 9204 9205 9206 9207 9208 9209 9210 9211 9212 9213 9214 9215 9216 9217 9218 9219 9220 9221 9222 9223 9224 9225 9226 9227 9228 9229 9230 9231 9232 9233 9234 9235 9236 9237 9238 9239 9240 9241 9242 9243 9244 9245 9246 9247 9248 9249 9250 9251 9252 9253 9254 9255 9256 9257 9258 9259 9260 9261 9262 9263 9264 9265 9266 9267 9268 9269 9270 9271 9272 9273 9274 9275 9276 9277 9278 9279 9280 9281 9282 9283 9284 9285 9286 9287 9288 9289 9290 9291 9292 9293 9294 9295 9296 9297 9298 9299 9300 9301 9302 9303 9304 9305 9306 9307 9308 9309 9310 9311 9312 9313 9314 9315 9316 9317 9318 9319 9320 9321 9322 9323 9324 9325 9326 9327 9328 9329 9330 9331 9332 9333 9334 9335 9336 9337 9338 9339 9340 9341 9342 9343 9344 9345 9346 9347 9348 9349 9350 9351 9352 9353 9354 9355 9356 9357 9358 9359 9360 9361 9362 9363 9364 9365 9366 9367 9368 9369 9370 9371 9372 9373 9374 9375 9376 9377 9378 9379 9380 9381 9382 9383 9384 9385 9386 9387 9388 9389 9390 9391 9392 9393 9394 9395 9396 9397 9398 9399 9400 9401 9402 9403 9404 9405 9406 9407 9408 9409 9410 9411 9412 9413 9414 9415 9416 9417 9418 9419 9420 9421 9422 9423 9424 9425 9426 9427 9428 9429 9430 9431 9432 9433 9434 9435 9436 9437 9438 9439 9440 9441 9442 9443 9444 9445 9446 9447 9448 9449 9450 9451 9452 9453 9454 9455 9456 9457 9458 9459 9460 9461 9462 9463 9464 9465 9466 9467 9468 9469 9470 9471 9472 9473 9474 9475 9476 9477 9478 9479 9480 9481 9482 9483 9484 9485 9486 9487 9488 9489 9490 9491 9492 9493 9494 9495 9496 9497 9498 9499 9500 9501 9502 9503 9504 9505 9506 9507 9508 9509 9510 9511 9512 9513 9514 9515 9516 9517 9518 9519 9520 9521 9522 9523 9524 9525 9526 9527 9528 9529 9530 9531 9532 9533 9534 9535 9536 9537 9538 9539 9540 9541 9542 9543 9544 9545 9546 9547 9548 9549 9550 9551 9552 9553 9554 9555 9556 9557 9558 9559 9560 9561 9562 9563 9564 9565 9566 9567 9568 9569 9570 9571 9572 9573 9574 9575 9576 9577 9578 9579 9580 9581 9582 9583 9584 9585 9586 9587 9588 9589 9590 9591 9592 9593 9594 9595 9596 9597 9598 9599 9600 9601 9602 9603 9604 9605 9606 9607 9608 9609 9610 9611 9612 9613 9614 9615 9616 9617 9618 9619 9620 9621 9622 9623 9624 9625 9626 9627 9628 9629 9630 9631 9632 9633 9634 9635 9636 9637 9638 9639 9640 9641 9642 9643 9644 9645 9646 9647 9648 9649 9650 9651 9652 9653 9654 9655 9656 9657 9658 9659 9660 9661 9662 9663 9664 9665 9666 9667 9668 9669 9670 9671 9672 9673 9674 9675 9676 9677 9678 9679 9680 9681 9682 9683 9684 9685 9686 9687 9688 9689 9690 9691 9692 9693 9694 9695 9696 9697 9698 9699 9700 9701 9702 9703 9704 9705 9706 9707 9708 9709 9710 9711 9712 9713 9714 9715 9716 9717 9718 9719 9720 9721 9722 9723 9724 9725 9726 9727 9728 9729 9730 9731 9732 9733 9734 9735 9736 9737 9738 9739 9740 9741 9742 9743 9744 9745 9746 9747 9748 9749 9750 9751 9752 9753 9754 9755 9756 9757 9758 9759 9760 9761 9762 9763 9764 9765 9766 9767 9768 9769 9770 9771 9772 9773 9774 9775 9776 9777 9778 9779 9780 9781 9782 9783 9784 9785 9786 9787 9788 9789 9790 9791 9792 9793 9794 9795 9796 9797 9798 9799 9800 9801 9802 9803 9804 9805 9806 9807 9808 9809 9810 9811 9812 9813 9814 9815 9816 9817 9818 9819 9820 9821 9822 9823 9824 9825 9826 9827 9828 9829 9830 9831 9832 9833 9834 9835 9836 9837 9838 9839 9840 9841 9842 9843 9844 9845 9846 9847 9848 9849 9850 9851 9852 9853 9854 9855 9856 9857 9858 9859 9860 9861 9862 9863 9864 9865 9866 9867 9868 9869 9870 9871 9872 9873 9874 9875 9876 9877 9878 9879 9880 9881 9882 9883 9884 9885 9886 9887 9888 9889 9890 9891 9892 9893 9894 9895 9896 9897 9898 9899 9900 9901 9902 9903 9904 9905 9906 9907 9908 9909 9910 9911 9912 9913 9914 9915 9916 9917 9918 9919 9920 9921 9922 9923 9924 9925 9926 9927 9928 9929 9930 9931 9932 9933 9934 9935 9936 9937 9938 9939 9940 9941 9942 9943 9944 9945 9946 9947 9948 9949 9950 9951 9952 9953 9954 9955 9956 9957 9958 9959 9960 9961 9962 9963 9964 9965 9966 9967 9968 9969 9970 9971 9972 9973 9974 9975 9976 9977 9978 9979 9980 9981 9982 9983 9984 9985 9986 9987 9988 9989 9990 9991 9992 9993 9994 9995 9996 9997 9998 9999 10000 10001 10002 10003 10004 10005 10006 10007 10008 10009 10010 10011 10012 10013 10014 10015 10016 10017 10018 10019 10020 10021 10022 10023 10024 10025 10026 10027 10028 10029 10030 10031 10032 10033 10034 10035 10036 10037 10038 10039 10040 10041 10042 10043 10044 10045 10046 10047 10048 10049 10050 10051 10052 10053 10054 10055 10056 10057 10058 10059 10060 10061 10062 10063 10064 10065 10066 10067 10068 10069 10070 10071 10072 10073 10074 10075 10076 10077 10078 10079 10080 10081 10082 10083 10084 10085 10086 10087 10088 10089 10090 10091 10092 10093 10094 10095 10096 10097 10098 10099 10100 10101 10102 10103 10104 10105 10106 10107 10108 10109 10110 10111 10112 10113 10114 10115 10116 10117 10118 10119 10120 10121 10122 10123 10124 10125 10126 10127 10128 10129 10130 10131 10132 10133 10134 10135 10136 10137 10138 10139 10140 10141 10142 10143 10144 10145 10146 10147 10148 10149 10150 10151 10152 10153 10154 10155 10156 10157 10158 10159 10160 10161 10162 10163 10164 10165 10166 10167 10168 10169 10170 10171 10172 10173 10174 10175 10176 10177 10178 10179 10180 10181 10182 10183 10184 10185 10186 10187 10188 10189 10190 10191 10192 10193 10194 10195 10196 10197 10198 10199 10200 10201 10202 10203 10204 10205 10206 10207 10208 10209 10210 10211 10212 10213 10214 10215 10216 10217 10218 10219 10220 10221 10222 10223 10224 10225 10226 10227 10228 10229 10230 10231 10232 10233 10234 10235 10236 10237 10238 10239 10240 10241 10242 10243 10244 10245 10246 10247 10248 10249 10250 10251 10252 10253 10254 10255 10256 10257 10258 10259 10260 10261 10262 10263 10264 10265 10266 10267 10268 10269 10270 10271 10272 10273 10274 10275 10276 10277 10278 10279 10280 10281 10282 10283 10284 10285 10286 10287 10288 10289 10290 10291 10292 10293 10294 10295 10296 10297 10298 10299 10300 10301 10302 10303 10304 10305 10306 10307 10308 10309 10310 10311 10312 10313 10314 10315 10316 10317 10318 10319 10320 10321 10322 10323 10324 10325 10326 10327 10328 10329 10330 10331 10332 10333 10334 10335 10336 10337 10338 10339 10340 10341 10342 10343 10344 10345 10346 10347 10348 10349 10350 10351 10352 10353 10354 10355 10356 10357 10358 10359 10360 10361 10362 10363 10364 10365 10366 10367 10368 10369 10370 10371 10372 10373 10374 10375 10376 10377 10378 10379 10380 10381 10382 10383 10384 10385 10386 10387 10388 10389 10390 10391 10392 10393 10394 10395 10396 10397 10398 10399 10400 10401 10402 10403 10404 10405 10406 10407 10408 10409 10410 10411 10412 10413 10414 10415 10416 10417 10418 10419 10420 10421 10422 10423 10424 10425 10426 10427 10428 10429 10430 10431 10432 10433 10434 10435 10436 10437 10438 10439 10440 10441 10442 10443 10444 10445 10446 10447 10448 10449 10450 10451 10452 10453 10454 10455 10456 10457 10458 10459 10460 10461 10462 10463 10464 10465 10466 10467 10468 10469 10470 10471 10472 10473 10474 10475 10476 10477 10478 10479 10480 10481 10482 10483 10484 10485 10486 10487 10488 10489 10490 10491 10492 10493 10494 10495 10496 10497 10498 10499 10500 10501 10502 10503 10504 10505 10506 10507 10508 10509 10510 10511 10512 10513 10514 10515 10516 10517 10518 10519 10520 10521 10522 10523 10524 10525 10526 10527 10528 10529 10530 10531 10532 10533 10534 10535 10536 10537 10538 10539 10540 10541 10542 10543 10544 10545 10546 10547 10548 10549 10550 10551 10552 10553 10554 10555 10556 10557 10558 10559 10560 10561 10562 10563 10564 10565 10566 10567 10568 10569 10570 10571 10572 10573 10574 10575 10576 10577 10578 10579 10580 10581 10582 10583 10584 10585 10586 10587 10588 10589 10590 10591 10592 10593 10594 10595 10596 10597 10598 10599 10600 10601 10602 10603 10604 10605 10606 10607 10608 10609 10610 10611 10612 10613 10614 10615 10616 10617 10618 10619 10620 10621 10622 10623 10624 10625 10626 10627 10628 10629 10630 10631 10632 10633 10634 10635 10636 10637 10638 10639 10640 10641 10642 10643 10644 10645 10646 10647 10648 10649 10650 10651 10652 10653 10654 10655 10656 10657 10658 10659 10660 10661 10662 10663 10664 10665 10666 10667 10668 10669 10670 10671 10672 10673 10674 10675 10676 10677 10678 10679 10680 10681 10682 10683 10684 10685 10686 10687 10688 10689 10690 10691 10692 10693 10694 10695 10696 10697 10698 10699 10700 10701 10702 10703 10704 10705 10706 10707 10708 10709 10710 10711 10712 10713 10714 10715 10716 10717 10718 10719 10720 10721 10722 10723 10724 10725 10726 10727 10728 10729 10730 10731 10732 10733 10734 10735 10736 10737 10738 10739 10740 10741 10742 10743 10744 10745 10746 10747 10748 10749 10750 10751 10752 10753 10754 10755 10756 10757 10758 10759 10760 10761 10762 10763 10764 10765 10766 10767 10768 10769 10770 10771 10772 10773 10774 10775 10776 10777 10778 10779 10780 10781 10782 10783 10784 10785 10786 10787 10788 10789 10790 10791 10792 10793 10794 10795 10796 10797 10798 10799 10800 10801 10802 10803 10804 10805 10806 10807 10808 10809 10810 10811 10812 10813 10814 10815 10816 10817 10818 10819 10820 10821 10822 10823 10824 10825 10826 10827 10828 10829 10830 10831 10832 10833 10834 10835 10836 10837 10838 10839 10840 10841 10842 10843 10844 10845 10846 10847 10848 10849 10850 10851 10852 10853 10854 10855 10856 10857 10858 10859 10860 10861 10862 10863 10864 10865 10866 10867 10868 10869 10870 10871 10872 10873 10874 10875 10876 10877 10878 10879 10880 10881 10882 10883 10884 10885 10886 10887 10888 10889 10890 10891 10892 10893 10894 10895 10896 10897 10898 10899 10900 10901 10902 10903 10904 10905 10906 10907 10908 10909 10910 10911 10912 10913 10914 10915 10916 10917 10918 10919 10920 10921 10922 10923 10924 10925 10926 10927 10928 10929 10930 10931 10932 10933 10934 10935 10936 10937 10938 10939 10940 10941 10942 10943 10944 10945 10946 10947 10948 10949 10950 10951 10952 10953 10954 10955 10956 10957 10958 10959 10960 10961 10962 10963 10964 10965 10966 10967 10968 10969 10970 10971 10972 10973 10974 10975 10976 10977 10978 10979 10980 10981 10982 10983 10984 10985 10986 10987 10988 10989 10990 10991 10992 10993 10994 10995 10996 10997 10998 10999 11000 11001 11002 11003 11004 11005 11006 11007 11008 11009 11010 11011 11012 11013 11014 11015 11016 11017 11018 11019 11020 11021 11022 11023 11024 11025 11026 11027 11028 11029 11030 11031 11032 11033 11034 11035 11036 11037 11038 11039 11040 11041 11042 11043 11044 11045 11046 11047 11048 11049 11050 11051 11052 11053 11054 11055 11056 11057 11058 11059 11060 11061 11062 11063 11064 11065 11066 11067 11068 11069 11070 11071 11072 11073 11074 11075 11076 11077 11078 11079 11080 11081 11082 11083 11084 11085 11086 11087 11088 11089 11090 11091 11092 11093 11094 11095 11096 11097 11098 11099 11100 11101 11102 11103 11104 11105 11106 11107 11108 11109 11110 11111 11112 11113 11114 11115 11116 11117 11118 11119 11120 11121 11122 11123 11124 11125 11126 11127 11128 11129 11130 11131 11132 11133 11134 11135 11136 11137 11138 11139 11140 11141 11142 11143 11144 11145 11146 11147 11148 11149 11150 11151 11152 11153 11154 11155 11156 11157 11158 11159 11160 11161 11162 11163 11164 11165 11166 11167 11168 11169 11170 11171 11172 11173 11174 11175 11176 11177 11178 11179 11180 11181 11182 11183 11184 11185 11186 11187 11188 11189 11190 11191 11192 11193 11194 11195 11196 11197 11198 11199 11200 11201 11202 11203 11204 11205 11206 11207 11208 11209 11210 11211 11212 11213 11214 11215 11216 11217 11218 11219 11220 11221 11222 11223 11224 11225 11226 11227 11228 11229 11230 11231 11232 11233 11234 11235 11236 11237 11238 11239 11240 11241 11242 11243 11244 11245 11246 11247 11248 11249 11250 11251 11252 11253 11254 11255 11256 11257 11258 11259 11260 11261 11262 11263 11264 11265 11266 11267 11268 11269 11270 11271 11272 11273 11274 11275 11276 11277 11278 11279 11280 11281 11282 11283 11284 11285 11286 11287 11288 11289 11290 11291 11292 11293 11294 11295 11296 11297 11298 11299 11300 11301 11302 11303 11304 11305 11306 11307 11308 11309 11310 11311 11312 11313 11314 11315 11316 11317 11318 11319 11320 11321 11322 11323 11324 11325 11326 11327 11328 11329 11330 11331 11332 11333 11334 11335 11336 11337 11338 11339 11340 11341 11342 11343 11344 11345 11346 11347 11348 11349 11350 11351 11352 11353 11354 11355 11356 11357 11358 11359 11360 11361 11362 11363 11364 11365 11366 11367 11368 11369 11370 11371 11372 11373 11374 11375 11376 11377 11378 11379 11380 11381 11382 11383 11384 11385 11386 11387 11388 11389 11390 11391 11392 11393 11394 11395 11396 11397 11398 11399 11400 11401 11402 11403 11404 11405 11406 11407 11408 11409 11410 11411 11412 11413 11414 11415 11416 11417 11418 11419 11420 11421 11422 11423 11424 11425 11426 11427 11428 11429 11430 11431 11432 11433 11434 11435 11436 11437 11438 11439 11440 11441 11442 11443 11444 11445 11446 11447 11448 11449 11450 11451 11452 11453 11454 11455 11456 11457 11458 11459 11460 11461 11462 11463 11464 11465 11466 11467 11468 11469 11470 11471 11472 11473 11474 11475 11476 11477 11478 11479 11480 11481 11482 11483 11484 11485 11486 11487 11488 11489 11490 11491 11492 11493 11494 11495 11496 11497 11498 11499 11500 11501 11502 11503 11504 11505 11506 11507 11508 11509 11510 11511 11512 11513 11514 11515 11516 11517 11518 11519 11520 11521 11522 11523 11524 11525 11526 11527 11528 11529 11530 11531 11532 11533 11534 11535 11536 11537 11538 11539 11540 11541 11542 11543 11544 11545 11546 11547 11548 11549 11550 11551 11552 11553 11554 11555 11556 11557 11558 11559 11560 11561 11562 11563 11564 11565 11566 11567 11568 11569 11570 11571 11572 11573 11574 11575 11576 11577 11578 11579 11580 11581 11582 11583 11584 11585 11586 11587 11588 11589 11590 11591 11592 11593 11594 11595 11596 11597 11598 11599 11600 11601 11602 11603 11604 11605 11606 11607 11608 11609 11610 11611 11612 11613 11614 11615 11616 11617 11618 11619 11620 11621 11622 11623 11624 11625 11626 11627 11628 11629 11630 11631 11632 11633 11634 11635 11636 11637 11638 11639 11640 11641 11642 11643 11644 11645 11646 11647 11648 11649 11650 11651 11652 11653 11654 11655 11656 11657 11658 11659 11660 11661 11662 11663 11664 11665 11666 11667 11668 11669 11670 11671 11672 11673 11674 11675 11676 11677 11678 11679 11680 11681 11682 11683 11684 11685 11686 11687 11688 11689 11690 11691 11692 11693 11694 11695 11696 11697 11698 11699 11700 11701 11702 11703 11704 11705 11706 11707 11708 11709 11710 11711 11712 11713 11714 11715 11716 11717 11718 11719 11720 11721 11722 11723 11724 11725 11726 11727 11728 11729 11730 11731 11732 11733 11734 11735 11736 11737 11738 11739 11740 11741 11742 11743 11744 11745 11746 11747 11748 11749 11750 11751 11752 11753 11754 11755 11756 11757 11758 11759 11760 11761 11762 11763 11764 11765 11766 11767 11768 11769 11770 11771 11772 11773 11774 11775 11776 11777 11778 11779 11780 11781 11782 11783 11784 11785 11786 11787 11788 11789 11790 11791 11792 11793 11794 11795 11796 11797 11798 11799 11800 11801 11802 11803 11804 11805 11806 11807 11808 11809 11810 11811 11812 11813 11814 11815 11816 11817 11818 11819 11820 11821 11822 11823 11824 11825 11826 11827 11828 11829 11830 11831 11832 11833 11834 11835 11836 11837 11838 11839 11840 11841 11842 11843 11844 11845 11846 11847 11848 11849 11850 11851 11852 11853 11854 11855 11856 11857 11858 11859 11860 11861 11862 11863 11864 11865 11866 11867 11868 11869 11870 11871 11872 11873 11874 11875 11876 11877 11878 11879 11880 11881 11882 11883 11884 11885 11886 11887 11888 11889 11890 11891 11892 11893 11894 11895 11896 11897 11898 11899 11900 11901 11902 11903 11904 11905 11906 11907 11908 11909 11910 11911 11912 11913 11914 11915 11916 11917 11918 11919 11920 11921 11922 11923 11924 11925 11926 11927 11928 11929 11930 11931 11932 11933 11934 11935 11936 11937 11938 11939 11940 11941 11942 11943 11944 11945 11946 11947 11948 11949 11950 11951 11952 11953 11954 11955 11956 11957 11958 11959 11960 11961 11962 11963 11964 11965 11966 11967 11968 11969 11970 11971 11972 11973 11974 11975 11976 11977 11978 11979 11980 11981 11982 11983 11984 11985 11986 11987 11988 11989 11990 11991 11992 11993 11994 11995 11996 11997 11998 11999 12000 12001 12002 12003 12004 12005 12006 12007 12008 12009 12010 12011 12012 12013 12014 12015 12016 12017 12018 12019 12020 12021 12022 12023 12024 12025 12026 12027 12028 12029 12030 12031 12032 12033 12034 12035 12036 12037 12038 12039 12040 12041 12042 12043 12044 12045 12046 12047 12048 12049 12050 12051 12052 12053 12054 12055 12056 12057 12058 12059 12060 12061 12062 12063 12064 12065 12066 12067 12068 12069 12070 12071 12072 12073 12074 12075 12076 12077 12078 12079 12080 12081 12082 12083 12084 12085 12086 12087 12088 12089 12090 12091 12092 12093 12094 12095 12096 12097 12098 12099 12100 12101 12102 12103 12104 12105 12106 12107 12108 12109 12110 12111 12112 12113 12114 12115 12116 12117 12118 12119 12120 12121 12122 12123 12124 12125 12126 12127 12128 12129 12130 12131 12132 12133 12134 12135 12136 12137 12138 12139 12140 12141 12142 12143 12144 12145 12146 12147 12148 12149 12150 12151 12152 12153 12154 12155 12156 12157 12158 12159 12160 12161 12162 12163 12164 12165 12166 12167 12168 12169 12170 12171 12172 12173 12174 12175 12176 12177 12178 12179 12180 12181 12182 12183 12184 12185 12186 12187 12188 12189 12190 12191 12192 12193 12194 12195 12196 12197 12198 12199 12200 12201 12202 12203 12204 12205 12206 12207 12208 12209 12210 12211 12212 12213 12214 12215 12216 12217 12218 12219 12220 12221 12222 12223 12224 12225 12226 12227 12228 12229 12230 12231 12232 12233 12234 12235 12236 12237 12238 12239 12240 12241 12242 12243 12244 12245 12246 12247 12248 12249 12250 12251 12252 12253 12254 12255 12256 12257 12258 12259 12260 12261 12262 12263 12264 12265 12266 12267 12268 12269 12270 12271 12272 12273 12274 12275 12276 12277 12278 12279 12280 12281 12282 12283 12284 12285 12286 12287 12288 12289 12290 12291 12292 12293 12294 12295 12296 12297 12298 12299 12300 12301 12302 12303 12304 12305 12306 12307 12308 12309 12310 12311 12312 12313 12314 12315 12316 12317 12318 12319 12320 12321 12322 12323 12324 12325 12326 12327 12328 12329 12330 12331 12332 12333 12334 12335 12336 12337 12338 12339 12340 12341 12342 12343 12344 12345 12346 12347 12348 12349 12350 12351 12352 12353 12354 12355 12356 12357 12358 12359 12360 12361 12362 12363 12364 12365 12366 12367 12368 12369 12370 12371 12372 12373 12374 12375 12376 12377 12378 12379 12380 12381 12382 12383 12384 12385 12386 12387 12388 12389 12390 12391 12392 12393 12394 12395 12396 12397 12398 12399 12400 12401 12402 12403 12404 12405 12406 12407 12408 12409 12410 12411 12412 12413 12414 12415 12416 12417 12418 12419 12420 12421 12422 12423 12424 12425 12426 12427 12428 12429 12430 12431 12432 12433 12434 12435 12436 12437 12438 12439 12440 12441 12442 12443 12444 12445 12446 12447 12448 12449 12450 12451 12452 12453 12454 12455 12456 12457 12458 12459 12460 12461 12462 12463 12464 12465 12466 12467 12468 12469 12470 12471 12472 12473 12474 12475 12476 12477 12478 12479 12480 12481 12482 12483 12484 12485 12486 12487 12488 12489 12490 12491 12492 12493 12494 12495 12496 12497 12498 12499 12500 12501 12502 12503 12504 12505 12506 12507 12508 12509 12510 12511 12512 12513 12514 12515 12516 12517 12518 12519 12520 12521 12522 12523 12524 12525 12526 12527 12528 12529 12530 12531 12532 12533 12534 12535 12536 12537 12538 12539 12540 12541 12542 12543 12544 12545 12546 12547 12548 12549 12550 12551 12552 12553 12554 12555 12556 12557 12558 12559 12560 12561 12562 12563 12564 12565 12566 12567 12568 12569 12570 12571 12572 12573 12574 12575 12576 12577 12578 12579 12580 12581 12582 12583 12584 12585 12586 12587 12588 12589 12590 12591 12592 12593 12594 12595 12596 12597 12598 12599 12600 12601 12602 12603 12604 12605 12606 12607 12608 12609 12610 12611 12612 12613 12614 12615 12616 12617 12618 12619 12620 12621 12622 12623 12624 12625 12626 12627 12628 12629 12630 12631 12632 12633 12634 12635 12636 12637 12638 12639 12640 12641 12642 12643 12644 12645 12646 12647 12648 12649 12650 12651 12652 12653 12654 12655 12656 12657 12658 12659 12660 12661 12662 12663 12664 12665 12666 12667 12668 12669 12670 12671 12672 12673 12674 12675 12676 12677 12678 12679 12680 12681 12682 12683 12684 12685 12686 12687 12688 12689 12690 12691 12692 12693 12694 12695 12696 12697 12698 12699 12700 12701 12702 12703 12704 12705 12706 12707 12708 12709 12710 12711 12712 12713 12714 12715 12716 12717 12718 12719 12720 12721 12722 12723 12724 12725 12726 12727 12728 12729 12730 12731 12732 12733 12734 12735 12736 12737 12738 12739 12740 12741 12742 12743 12744 12745 12746 12747 12748 12749 12750 12751 12752 12753 12754 12755 12756 12757 12758 12759 12760 12761 12762 12763 12764 12765 12766 12767 12768 12769 12770 12771 12772 12773 12774 12775 12776 12777 12778 12779 12780 12781 12782 12783 12784 12785 12786 12787 12788 12789 12790 12791 12792 12793 12794 12795 12796 12797 12798 12799 12800 12801 12802 12803 12804 12805 12806 12807 12808 12809 12810 12811 12812 12813 12814 12815 12816 12817 12818 12819 12820 12821 12822 12823 12824 12825 12826 12827 12828 12829 12830 12831 12832 12833 12834 12835 12836 12837 12838 12839 12840 12841 12842 12843 12844 12845 12846 12847 12848 12849 12850 12851 12852 12853 12854 12855 12856 12857 12858 12859 12860 12861 12862 12863 12864 12865 12866 12867 12868 12869 12870 12871 12872 12873 12874 12875 12876 12877 12878 12879 12880 12881 12882 12883 12884 12885 12886 12887 12888 12889 12890 12891 12892 12893 12894 12895 12896 12897 12898 12899 12900 12901 12902 12903 12904 12905 12906 12907 12908 12909 12910 12911 12912 12913 12914 12915 12916 12917 12918 12919 12920 12921 12922 12923 12924 12925 12926 12927 12928 12929 12930 12931 12932 12933 12934 12935 12936 12937 12938 12939 12940 12941 12942 12943 12944 12945 12946 12947 12948 12949 12950 12951 12952 12953 12954 12955 12956 12957 12958 12959 12960 12961 12962 12963 12964 12965 12966 12967 12968 12969 12970 12971 12972 12973 12974 12975 12976 12977 12978 12979 12980 12981 12982 12983 12984 12985 12986 12987 12988 12989 12990 12991 12992 12993 12994 12995 12996 12997 12998 12999 13000 13001 13002 13003 13004 13005 13006 13007 13008 13009 13010 13011 13012 13013 13014 13015 13016 13017 13018 13019 13020 13021 13022 13023 13024 13025 13026 13027 13028 13029 13030 13031 13032 13033 13034 13035 13036 13037 13038 13039 13040 13041 13042 13043 13044 13045 13046 13047 13048 13049 13050 13051 13052 13053 13054 13055 13056 13057 13058 13059 13060 13061 13062 13063 13064 13065 13066 13067 13068 13069 13070 13071 13072 13073 13074 13075 13076 13077 13078 13079 13080 13081 13082 13083 13084 13085 13086 13087 13088 13089 13090 13091 13092 13093 13094 13095 13096 13097 13098 13099 13100 13101 13102 13103 13104 13105 13106 13107 13108 13109 13110 13111 13112 13113 13114 13115 13116 13117 13118 13119 13120 13121 13122 13123 13124 13125 13126 13127 13128 13129 13130 13131 13132 13133 13134 13135 13136 13137 13138 13139 13140 13141 13142 13143 13144 13145 13146 13147 13148 13149 13150 13151 13152 13153 13154 13155 13156 13157 13158 13159 13160 13161 13162 13163 13164 13165 13166 13167 13168 13169 13170 13171 13172 13173 13174 13175 13176 13177 13178 13179 13180 13181 13182 13183 13184 13185 13186 13187 13188 13189 13190 13191 13192 13193 13194 13195 13196 13197 13198 13199 13200 13201 13202 13203 13204 13205 13206 13207 13208 13209 13210 13211 13212 13213 13214 13215 13216 13217 13218 13219 13220 13221 13222 13223 13224 13225 13226 13227 13228 13229 13230 13231 13232 13233 13234 13235 13236 13237 13238 13239 13240 13241 13242 13243 13244 13245 13246 13247 13248 13249 13250 13251 13252 13253 13254 13255 13256 13257 13258 13259 13260 13261 13262 13263 13264 13265 13266 13267 13268 13269 13270 13271 13272 13273 13274 13275 13276 13277 13278 13279 13280 13281 13282 13283 13284 13285 13286 13287 13288 13289 13290 13291 13292 13293 13294 13295 13296 13297 13298 13299 13300 13301 13302 13303 13304 13305 13306 13307 13308 13309 13310 13311 13312 13313 13314 13315 13316 13317 13318 13319 13320 13321 13322 13323 13324 13325 13326 13327 13328 13329 13330 13331 13332 13333 13334 13335 13336 13337 13338 13339 13340 13341 13342 13343 13344 13345 13346 13347 13348 13349 13350 13351 13352 13353 13354 13355 13356 13357 13358 13359 13360 13361 13362 13363 13364 13365 13366 13367 13368 13369 13370 13371 13372 13373 13374 13375 13376 13377 13378 13379 13380 13381 13382 13383 13384 13385 13386 13387 13388 13389 13390 13391 13392 13393 13394 13395 13396 13397 13398 13399 13400 13401 13402 13403 13404 13405 13406 13407 13408 13409 13410 13411 13412 13413 13414 13415 13416 13417 13418 13419 13420 13421 13422 13423 13424 13425 13426 13427 13428 13429 13430 13431 13432 13433 13434 13435 13436 13437 13438 13439 13440 13441 13442 13443 13444 13445 13446 13447 13448 13449 13450 13451 13452 13453 13454 13455 13456 13457 13458 13459 13460 13461 13462 13463 13464 13465 13466 13467 13468 13469 13470 13471 13472 13473 13474 13475 13476 13477 13478 13479 13480 13481 13482 13483 13484 13485 13486 13487 13488 13489 13490 13491 13492 13493 13494 13495 13496 13497 13498 13499 13500 13501 13502 13503 13504 13505 13506 13507 13508 13509 13510 13511 13512 13513 13514 13515 13516 13517 13518 13519 13520 13521 13522 13523 13524 13525 13526 13527 13528 13529 13530 13531 13532 13533 13534 13535 13536 13537 13538 13539 13540 13541 13542 13543 13544 13545 13546 13547 13548 13549 13550 13551 13552 13553 13554 13555 13556 13557 13558 13559 13560 13561 13562 13563 13564 13565 13566 13567 13568 13569 13570 13571 13572 13573 13574 13575 13576 13577 13578 13579 13580 13581 13582 13583 13584 13585 13586 13587 13588 13589 13590 13591 13592 13593 13594 13595 13596 13597 13598 13599 13600 13601 13602 13603 13604 13605 13606 13607 13608 13609 13610 13611 13612 13613 13614 13615 13616 13617 13618 13619 13620 13621 13622 13623 13624 13625 13626 13627 13628 13629 13630 13631 13632 13633 13634 13635 13636 13637 13638 13639 13640 13641 13642 13643 13644 13645 13646 13647 13648 13649 13650 13651 13652 13653 13654 13655 13656 13657 13658 13659 13660 13661 13662 13663 13664 13665 13666 13667 13668 13669 13670 13671 13672 13673 13674 13675 13676 13677 13678 13679 13680 13681 13682 13683 13684 13685 13686 13687 13688 13689 13690 13691 13692 13693 13694 13695 13696 13697 13698 13699 13700 13701 13702 13703 13704 13705 13706 13707 13708 13709 13710 13711 13712 13713 13714 13715 13716 13717 13718 13719 13720 13721 13722 13723 13724 13725 13726 13727 13728 13729 13730 13731 13732 13733 13734 13735 13736 13737 13738 13739 13740 13741 13742 13743 13744 13745 13746 13747 13748 13749 13750 13751 13752 13753 13754 13755 13756 13757 13758 13759 13760 13761 13762 13763 13764 13765 13766 13767 13768 13769 13770 13771 13772 13773 13774 13775 13776 13777 13778 13779 13780 13781 13782 13783 13784 13785 13786 13787 13788 13789 13790 13791 13792 13793 13794 13795 13796 13797 13798 13799 13800 13801 13802 13803 13804 13805 13806 13807 13808 13809 13810 13811 13812 13813 13814 13815 13816 13817 13818 13819 13820 13821 13822 13823 13824 13825 13826 13827 13828 13829 13830 13831 13832 13833 13834 13835 13836 13837 13838 13839 13840 13841 13842 13843 13844 13845 13846 13847 13848 13849 13850 13851 13852 13853 13854 13855 13856 13857 13858 13859 13860 13861 13862 13863 13864 13865 13866 13867 13868 13869 13870 13871 13872 13873 13874 13875 13876 13877 13878 13879 13880 13881 13882 13883 13884 13885 13886 13887 13888 13889 13890 13891 13892 13893 13894 13895 13896 13897 13898 13899 13900 13901 13902 13903 13904 13905 13906 13907 13908 13909 13910 13911 13912 13913 13914 13915 13916 13917 13918 13919 13920 13921 13922 13923 13924 13925 13926 13927 13928 13929 13930 13931 13932 13933 13934 13935 13936 13937 13938 13939 13940 13941 13942 13943 13944 13945 13946 13947 13948 13949 13950 13951 13952 13953 13954 13955 13956 13957 13958 13959 13960 13961 13962 13963 13964 13965 13966 13967 13968 13969 13970 13971 13972 13973 13974 13975 13976 13977 13978 13979 13980 13981 13982 13983 13984 13985 13986 13987 13988 13989 13990 13991 13992 13993 13994 13995 13996 13997 13998 13999 14000 14001 14002 14003 14004 14005 14006 14007 14008 14009 14010 14011 14012 14013 14014 14015 14016 14017 14018 14019 14020 14021 14022 14023 14024 14025 14026 14027 14028 14029 14030 14031 14032 14033 14034 14035 14036 14037 14038 14039 14040 14041 14042 14043 14044 14045 14046 14047 14048 14049 14050 14051 14052 14053 14054 14055 14056 14057 14058 14059 14060 14061 14062 14063 14064 14065 14066 14067 14068 14069 14070 14071 14072 14073 14074 14075 14076 14077 14078 14079 14080 14081 14082 14083 14084 14085 14086 14087 14088 14089 14090 14091 14092 14093 14094 14095 14096 14097 14098 14099 14100 14101 14102 14103 14104 14105 14106 14107 14108 14109 14110 14111 14112 14113 14114 14115 14116 14117 14118 14119 14120 14121 14122 14123 14124 14125 14126 14127 14128 14129 14130 14131 14132 14133 14134 14135 14136 14137 14138 14139 14140 14141 14142 14143 14144 14145 14146 14147 14148 14149 14150 14151 14152 14153 14154 14155 14156 14157 14158 14159 14160 14161 14162 14163 14164 14165 14166 14167 14168 14169 14170 14171 14172 14173 14174 14175 14176 14177 14178 14179 14180 14181 14182 14183 14184 14185 14186 14187 14188 14189 14190 14191 14192 14193 14194 14195 14196 14197 14198 14199 14200 14201 14202 14203 14204 14205 14206 14207 14208 14209 14210 14211 14212 14213 14214 14215 14216 14217 14218 14219 14220 14221 14222 14223 14224 14225 14226 14227 14228 14229 14230 14231 14232 14233 14234 14235 14236 14237 14238 14239 14240 14241 14242 14243 14244 14245 14246 14247 14248 14249 14250 14251 14252 14253 14254 14255 14256 14257 14258 14259 14260 14261 14262 14263 14264 14265 14266 14267 14268 14269 14270 14271 14272 14273 14274 14275 14276 14277 14278 14279 14280 14281 14282 14283 14284 14285 14286 14287 14288 14289 14290 14291 14292 14293 14294 14295 14296 14297 14298 14299 14300 14301 14302 14303 14304 14305 14306 14307 14308 14309 14310 14311 14312 14313 14314 14315 14316 14317 14318 14319 14320 14321 14322 14323 14324 14325 14326 14327 14328 14329 14330 14331 14332 14333 14334 14335 14336 14337 14338 14339 14340 14341 14342 14343 14344 14345 14346 14347 14348 14349 14350 14351 14352 14353 14354 14355 14356 14357 14358 14359 14360 14361 14362 14363 14364 14365 14366 14367 14368 14369 14370 14371 14372 14373 14374 14375 14376 14377 14378 14379 14380 14381 14382 14383 14384 14385 14386 14387 14388 14389 14390 14391 14392 14393 14394 14395 14396 14397 14398 14399 14400 14401 14402 14403 14404 14405 14406 14407 14408 14409 14410 14411 14412 14413 14414 14415 14416 14417 14418 14419 14420 14421 14422 14423 14424 14425 14426 14427 14428 14429 14430 14431 14432 14433 14434 14435 14436 14437 14438 14439 14440 14441 14442 14443 14444 14445 14446 14447 14448 14449 14450 14451 14452 14453 14454 14455 14456 14457 14458 14459 14460 14461 14462 14463 14464 14465 14466 14467 14468 14469 14470 14471 14472 14473 14474 14475 14476 14477 14478 14479 14480 14481 14482 14483 14484 14485 14486 14487 14488 14489 14490 14491 14492 14493 14494 14495 14496 14497 14498 14499 14500 14501 14502 14503 14504 14505 14506 14507 14508 14509 14510 14511 14512 14513 14514 14515 14516 14517 14518 14519 14520 14521 14522 14523 14524 14525 14526 14527 14528 14529 14530 14531 14532 14533 14534 14535 14536 14537 14538 14539 14540 14541 14542 14543 14544 14545 14546 14547 14548 14549 14550 14551 14552 14553 14554 14555 14556 14557 14558 14559 14560 14561 14562 14563 14564 14565 14566 14567 14568 14569 14570 14571 14572 14573 14574 14575 14576 14577 14578 14579 14580 14581 14582 14583 14584 14585 14586 14587 14588 14589 14590 14591 14592 14593 14594 14595 14596 14597 14598 14599 14600 14601 14602 14603 14604 14605 14606 14607 14608 14609 14610 14611 14612 14613 14614 14615 14616 14617 14618 14619 14620 14621 14622 14623 14624 14625 14626 14627 14628 14629 14630 14631 14632 14633 14634 14635 14636 14637 14638 14639 14640 14641 14642 14643 14644 14645 14646 14647 14648 14649 14650 14651 14652 14653 14654 14655 14656 14657 14658 14659 14660 14661 14662 14663 14664 14665 14666 14667 14668 14669 14670 14671 14672 14673 14674 14675 14676 14677 14678 14679 14680 14681 14682 14683 14684 14685 14686 14687 14688 14689 14690 14691 14692 14693 14694 14695 14696 14697 14698 14699 14700 14701 14702 14703 14704 14705 14706 14707 14708 14709 14710 14711 14712 14713 14714 14715 14716 14717 14718 14719 14720 14721 14722 14723 14724 14725 14726 14727 14728 14729 14730 14731 14732 14733 14734 14735 14736 14737 14738 14739 14740 14741 14742 14743 14744 14745 14746 14747 14748 14749 14750 14751 14752 14753 14754 14755 14756 14757 14758 14759 14760 14761 14762 14763 14764 14765 14766 14767 14768 14769 14770 14771 14772 14773 14774 14775 14776 14777 14778 14779 14780 14781 14782 14783 14784 14785 14786 14787 14788 14789 14790 14791 14792 14793 14794 14795 14796 14797 14798 14799 14800 14801 14802 14803 14804 14805 14806 14807 14808 14809 14810 14811 14812 14813 14814 14815 14816 14817 14818 14819 14820 14821 14822 14823 14824 14825 14826 14827 14828 14829 14830 14831 14832 14833 14834 14835 14836 14837 14838 14839 14840 14841 14842 14843 14844 14845 14846 14847 14848 14849 14850 14851 14852 14853 14854 14855 14856 14857 14858 14859 14860 14861 14862 14863 14864 14865 14866 14867 14868 14869 14870 14871 14872 14873 14874 14875 14876 14877 14878 14879 14880 14881 14882 14883 14884 14885 14886 14887 14888 14889 14890 14891 14892 14893 14894 14895 14896 14897 14898 14899 14900 14901 14902 14903 14904 14905 14906 14907 14908 14909 14910 14911 14912 14913 14914 14915 14916 14917 14918 14919 14920 14921 14922 14923 14924 14925 14926 14927 14928 14929 14930 14931 14932 14933 14934 14935 14936 14937 14938 14939 14940 14941 14942 14943 14944 14945 14946 14947 14948 14949 14950 14951 14952 14953 14954 14955 14956 14957 14958 14959 14960 14961 14962 14963 14964 14965 14966 14967 14968 14969 14970 14971 14972 14973 14974 14975 14976 14977 14978 14979 14980 14981 14982 14983 14984 14985 14986 14987 14988 14989 14990 14991 14992 14993 14994 14995 14996 14997 14998 14999 15000 15001 15002 15003 15004 15005 15006 15007 15008 15009 15010 15011 15012 15013 15014 15015 15016 15017 15018 15019 15020 15021 15022 15023 15024 15025 15026 15027 15028 15029 15030 15031 15032 15033 15034 15035 15036 15037 15038 15039 15040 15041 15042 15043 15044 15045 15046 15047 15048 15049 15050 15051 15052 15053 15054 15055 15056 15057 15058 15059 15060 15061 15062 15063 15064 15065 15066 15067 15068 15069 15070 15071 15072 15073 15074 15075 15076 15077 15078 15079 15080 15081 15082 15083 15084 15085 15086 15087 15088 15089 15090 15091 15092 15093 15094 15095 15096 15097 15098 15099 15100 15101 15102 15103 15104 15105 15106 15107 15108 15109 15110 15111 15112 15113 15114 15115 15116 15117 15118 15119 15120 15121 15122 15123 15124 15125 15126 15127 15128 15129 15130 15131 15132 15133 15134 15135 15136 15137 15138 15139 15140 15141 15142 15143 15144 15145 15146 15147 15148 15149 15150 15151 15152 15153 15154 15155 15156 15157 15158 15159 15160 15161 15162 15163 15164 15165 15166 15167 15168 15169 15170 15171 15172 15173 15174 15175 15176 15177 15178 15179 15180 15181 15182 15183 15184 15185 15186 15187 15188 15189 15190 15191 15192 15193 15194 15195 15196 15197 15198 15199 15200 15201 15202 15203 15204 15205 15206 15207 15208 15209 15210 15211 15212 15213 15214 15215 15216 15217 15218 15219 15220 15221 15222 15223 15224 15225 15226 15227 15228 15229 15230 15231 15232 15233 15234 15235 15236 15237 15238 15239 15240 15241 15242 15243 15244 15245 15246 15247 15248 15249 15250 15251 15252 15253 15254 15255 15256 15257 15258 15259 15260 15261 15262 15263 15264 15265 15266 15267 15268 15269 15270 15271 15272 15273 15274 15275 15276 15277 15278 15279 15280 15281 15282 15283 15284 15285 15286 15287 15288 15289 15290 15291 15292 15293 15294 15295 15296 15297 15298 15299 15300 15301 15302 15303 15304 15305 15306 15307 15308 15309 15310 15311 15312 15313 15314 15315 15316 15317 15318 15319 15320 15321 15322 15323 15324 15325 15326 15327 15328 15329 15330 15331 15332 15333 15334 15335 15336 15337 15338 15339 15340 15341 15342 15343 15344 15345 15346 15347 15348 15349 15350 15351 15352 15353 15354 15355 15356 15357 15358 15359 15360 15361 15362 15363 15364 15365 15366 15367 15368 15369 15370 15371 15372 15373 15374 15375 15376 15377 15378 15379 15380 15381 15382 15383 15384 15385 15386 15387 15388 15389 15390 15391 15392 15393 15394 15395 15396 15397 15398 15399 15400 15401 15402 15403 15404 15405 15406 15407 15408 15409 15410 15411 15412 15413 15414 15415 15416 15417 15418 15419 15420 15421 15422 15423 15424 15425 15426 15427 15428 15429 15430 15431 15432 15433 15434 15435 15436 15437 15438 15439 15440 15441 15442 15443 15444 15445 15446 15447 15448 15449 15450 15451 15452 15453 15454 15455 15456 15457 15458 15459 15460 15461 15462 15463 15464 15465 15466 15467 15468 15469 15470 15471 15472 15473 15474 15475 15476 15477 15478 15479 15480 15481 15482 15483 15484 15485 15486 15487 15488 15489 15490 15491 15492 15493 15494 15495 15496 15497 15498 15499 15500 15501 15502 15503 15504 15505 15506 15507 15508 15509 15510 15511 15512 15513 15514 15515 15516 15517 15518 15519 15520 15521 15522 15523 15524 15525 15526 15527 15528 15529 15530 15531 15532 15533 15534 15535 15536 15537 15538 15539 15540 15541 15542 15543 15544 15545 15546 15547 15548 15549 15550 15551 15552 15553 15554 15555 15556 15557 15558 15559 15560 15561 15562 15563 15564 15565 15566 15567 15568 15569 15570 15571 15572 15573 15574 15575 15576 15577 15578 15579 15580 15581 15582 15583 15584 15585 15586 15587 15588 15589 15590 15591 15592 15593 15594 15595 15596 15597 15598 15599 15600 15601 15602 15603 15604 15605 15606 15607 15608 15609 15610 15611 15612 15613 15614 15615 15616 15617 15618 15619 15620 15621 15622 15623 15624 15625 15626 15627 15628 15629 15630 15631 15632 15633 15634 15635 15636 15637 15638 15639 15640 15641 15642 15643 15644 15645 15646 15647 15648 15649 15650 15651 15652 15653 15654 15655 15656 15657 15658 15659 15660 15661 15662 15663 15664 15665 15666 15667 15668 15669 15670 15671 15672 15673 15674 15675 15676 15677 15678 15679 15680 15681 15682 15683 15684 15685 15686 15687 15688 15689 15690 15691 15692 15693 15694 15695 15696 15697 15698 15699 15700 15701 15702 15703 15704 15705 15706 15707 15708 15709 15710 15711 15712 15713 15714 15715 15716 15717 15718 15719 15720 15721 15722 15723 15724 15725 15726 15727 15728 15729 15730 15731 15732 15733 15734 15735 15736 15737 15738 15739 15740 15741 15742 15743 15744 15745 15746 15747 15748 15749 15750 15751 15752 15753 15754 15755 15756 15757 15758 15759 15760 15761 15762 15763 15764 15765 15766 15767 15768 15769 15770 15771 15772 15773 15774 15775 15776 15777 15778 15779 15780 15781 15782 15783 15784 15785 15786 15787 15788 15789 15790 15791 15792 15793 15794 15795 15796 15797 15798 15799 15800 15801 15802 15803 15804 15805 15806 15807 15808 15809 15810 15811 15812 15813 15814 15815 15816 15817 15818 15819 15820 15821 15822 15823 15824 15825 15826 15827 15828 15829 15830 15831 15832 15833 15834 15835 15836 15837 15838 15839 15840 15841 15842 15843 15844 15845 15846 15847 15848 15849 15850 15851 15852 15853 15854 15855 15856 15857 15858 15859 15860 15861 15862 15863 15864 15865 15866 15867 15868 15869 15870 15871 15872 15873 15874 15875 15876 15877 15878 15879 15880 15881 15882 15883 15884 15885 15886 15887 15888 15889 15890 15891 15892 15893 15894 15895 15896 15897 15898 15899 15900 15901 15902 15903 15904 15905 15906 15907 15908 15909 15910 15911 15912 15913 15914 15915 15916 15917 15918 15919 15920 15921 15922 15923 15924 15925 15926 15927 15928 15929 15930 15931 15932 15933 15934 15935 15936 15937 15938 15939 15940 15941 15942 15943 15944 15945 15946 15947 15948 15949 15950 15951 15952 15953 15954 15955 15956 15957 15958 15959 15960 15961 15962 15963 15964 15965 15966 15967 15968 15969 15970 15971 15972 15973 15974 15975 15976 15977 15978 15979 15980 15981 15982 15983 15984 15985 15986 15987 15988 15989 15990 15991 15992 15993 15994 15995 15996 15997 15998 15999 16000 16001 16002 16003 16004 16005 16006 16007 16008 16009 16010 16011 16012 16013 16014 16015 16016 16017 16018 16019 16020 16021 16022 16023 16024 16025 16026 16027 16028 16029 16030 16031 16032 16033 16034 16035 16036 16037 16038 16039 16040 16041 16042 16043 16044 16045 16046 16047 16048 16049 16050 16051 16052 16053 16054 16055 16056 16057 16058 16059 16060 16061 16062 16063 16064 16065 16066 16067 16068 16069 16070 16071 16072 16073 16074 16075 16076 16077 16078 16079 16080 16081 16082 16083 16084 16085 16086 16087 16088 16089 16090 16091 16092 16093 16094 16095 16096 16097 16098 16099 16100 16101 16102 16103 16104 16105 16106 16107 16108 16109 16110 16111 16112 16113 16114 16115 16116 16117 16118 16119 16120 16121 16122 16123 16124 16125 16126 16127 16128 16129 16130 16131 16132 16133 16134 16135 16136 16137 16138 16139 16140 16141 16142 16143 16144 16145 16146 16147 16148 16149 16150 16151 16152 16153 16154 16155 16156 16157 16158 16159 16160 16161 16162 16163 16164 16165 16166 16167 16168 16169 16170 16171 16172 16173 16174 16175 16176 16177 16178 16179 16180 16181 16182 16183 16184 16185 16186 16187 16188 16189 16190 16191 16192 16193 16194 16195 16196 16197 16198 16199 16200 16201 16202 16203 16204 16205 16206 16207 16208 16209 16210 16211 16212 16213 16214 16215 16216 16217 16218 16219 16220 16221 16222 16223 16224 16225 16226 16227 16228 16229 16230 16231 16232 16233 16234 16235 16236 16237 16238 16239 16240 16241 16242 16243 16244 16245 16246 16247 16248 16249 16250 16251 16252 16253 16254 16255 16256 16257 16258 16259 16260 16261 16262 16263 16264 16265 16266 16267 16268 16269 16270 16271 16272 16273 16274 16275 16276 16277 16278 16279 16280 16281 16282 16283 16284 16285 16286 16287 16288 16289 16290 16291 16292 16293 16294 16295 16296 16297 16298 16299 16300 16301 16302 16303 16304 16305 16306 16307 16308 16309 16310 16311 16312 16313 16314 16315 16316 16317 16318 16319 16320 16321 16322 16323 16324 16325 16326 16327 16328 16329 16330 16331 16332 16333 16334 16335 16336 16337 16338 16339 16340 16341 16342 16343 16344 16345 16346 16347 16348 16349 16350 16351 16352 16353 16354 16355 16356 16357 16358 16359 16360 16361 16362 16363 16364 16365 16366 16367 16368 16369 16370 16371 16372 16373 16374 16375 16376 16377 16378 16379 16380 16381 16382 16383 16384 16385 16386 16387 16388 16389 16390 16391 16392 16393 16394 16395 16396 16397 16398 16399 16400 16401 16402 16403 16404 16405 16406 16407 16408 16409 16410 16411 16412 16413 16414 16415 16416 16417 16418 16419 16420 16421 16422 16423 16424 16425 16426 16427 16428 16429 16430 16431 16432 16433 16434 16435 16436 16437 16438 16439 16440 16441 16442 16443 16444 16445 16446 16447 16448 16449 16450 16451 16452 16453 16454 16455 16456 16457 16458 16459 16460 16461 16462 16463 16464 16465 16466 16467 16468 16469 16470 16471 16472 16473 16474 16475 16476 16477 16478 16479 16480 16481 16482 16483 16484 16485 16486 16487 16488 16489 16490 16491 16492 16493 16494 16495 16496 16497 16498 16499 16500 16501 16502 16503 16504 16505 16506 16507 16508 16509 16510 16511 16512 16513 16514 16515 16516 16517 16518 16519 16520 16521 16522 16523 16524 16525 16526 16527 16528 16529 16530 16531 16532 16533 16534
|
Dear Emacs, please make this -*-Text-*- mode!
This file covers NEWS for R 2.x.y.
See 'NEWS' (or doc/html/NEWS.html or doc/NEWS.Rd) for
subsequent changes and NEWS.0 and NEWS.1 for earlier ones.
There is a change in format at 2.10.0: entries from
then on are generated from doc/NEWS.2.Rd.
CHANGES IN R VERSION 2.15.3:
NEW FEATURES:
• lgamma(x) for very small x (in the denormalized range) is no
longer Inf with a warning.
• image() now sorts an unsorted breaks vector, with a warning.
• The internal methods for tar() and untar() do a slightly more
general job for ‘ustar’-style handling of paths of more than 100
bytes.
• Packages compiler and parallel have been added to the reference
index (refman.pdf).
• untar(tar = "internal") has some support for pax headers as
produced by e.g. gnutar --posix (which seems prevalent on
OpenSUSE 12.2) or bsdtar --format pax, including long path and
link names.
• sQuote() and dQuote() now handle 0-length inputs. (Suggestion of
Ben Bolker.)
• summaryRprof() returns zero-row data frames rather than throw an
error if no events are recorded, for consistency.
• The included version of PCRE has been updated to 8.32.
• The tcltk namespace can now be re-loaded after unloading.
The Tcl/Tk event loop is inhibited in a forked child from package
parallel (as in e.g. mclapply()).
• parallel::makeCluster() recognizes the value random for the
environment variable R_PARALLEL_PORT: this chooses a random value
for the port and reduces the chance of conflicts when multiple
users start a cluster at the same time.
UTILITIES:
• The default for TAR on Windows for R CMD build has been changed
to be internal if no tar command is on the path.
This enables most packages to be built ‘out of the box’ without
Rtools: the main exceptions are those which need to be installed
to re-build vignettes and need Rtools for installation (usually
because they contain compiled code).
C-LEVEL FACILITIES:
• On a 64-bit Windows platform with enough RAM, R_alloc can now
allocate up to just under 32GB like other 64-bit platforms.
DEPRECATED AND DEFUNCT:
• Use of col2rgb(0) is deprecated (see the help page for its
limitations).
• The deprecated intensities component returned by hist() is no
longer recognized by the plot() method and will be removed in R
3.0.0.
• real(), as.real() and is.real() are now formally deprecated and
give a warning.
• This is formal notice that the non-API EISPACK entry points in R
will be removed shortly.
INSTALLATION:
• The configure tests for Objective C and Objective C++ now work on
Mac OS 10.8 with Xcode 4.5.2 (PR#15107).
• The cairo-based versions of X11() now work with current versions
of cairographics (e.g. 1.12.10). (PR#15168)
A workaround for earlier versions of R is to use X11.options(type
= "nbcairo").
• Configuration and R CMD javareconf now come up with a smaller set
of library paths for Java on Oracle-format JDK (including
OpenJDK). This helps avoid conflicts between libraries (such as
libjpeg) supplied in the JDK and system libraries. This can
always be overridden if needed: see the ‘R Installation and
Administration’ manual.
BUG FIXES:
• beta(a, b) could overflow to infinity in its calculations when
one of a and b was less than one. (PR#15075)
• lbeta(a, b) no longer gives NaN if a or b is very small (in the
denormalized range).
• bquote() is now able to substitute default arguments in
single-argument functions. (PR#15077)
• browseEnv(html = FALSE) would segfault if called from R (not
R.app) on a CRAN-style Mac OS X build of R.
• [[<- for lists (generic vectors) needed to increment NAMED count
when RHS is used more than once. (PR#15098)
• On Windows, warnings about opening a file or pipe with a
non-ASCII description were sometimes output in UTF-8 rather than
in the current locale's character set.
• The call() function did not duplicate its arguments. (PR#15115)
• TukeyHSD() could give NA results with some na.action methods such
as na.exclude(). (Hinted at on R-help by John Fox.)
• The deprecated svd(X, LINPACK = TRUE) could alter X in R
2.15.[12]. (Reported by Bill Dunlap.)
• Under Windows, file.link() and file.symlink() used the link name
twice, so would always fail. (Reported by Rui Barradas/Oliver
Soong).
• summaryRprof(memory = "both") mixed up the units of Vcells and
Ncells: it now works in bytes. (PR#15138)
• tools::Rd2HTML() would sometimes delete text. (PR#15134)
• plot() failed for "table" objects containing just one entry.
(PR#15118)
• embedFonts() needed to quote some filepaths. (PR#15149)
• parallel::mccollect() handled NULL returns incorrectly (removing
the element rather than setting it to NULL).
• The full reference index (fullrefman.pdf) was missing packages
compiler and parallel.
• The report for optim(method = "L-BFGS-B", control = list(trace =
1)) reported the last completed and not the current iteration,
unlike other methods and trace levels. (PR#15103)
• qt(1e-12, 1.2) no longer gives NaN.
• dt(1e160, 1.2, log=TRUE) no longer gives -Inf.
• On Windows the untar() function now quotes the directory name
when using an external tar utility, so R CMD check will handle
pathnames containing spaces.
• The version for Windows 8 and Windows Server 2012 is now
displayed by win.version(). (Reported by Gabor Grothendieck.)
• The custom Windows installer target myR in the installer Makefile
did not work in 2.15.2. (Reported by Erich Neuwirth.)
• aperm(matrix(1:6, 2, dimnames=list(A={}, B={})), "A") no longer
segfaults.
• Expressions involving user defined operators were not always
deparsed faithfully. (PR#15179)
• The enc2utf8() function converted NA_character_ to "NA" in
non-UTF-8 locales. (PR#15201)
• The exclude argument to xtabs() was ignored for "factor"
arguments.
• On Windows, work around an event-timing problem when the RGui
console was closed from the ‘X’ control and the closure
cancelled. (This would on some 64-bit systems crash R, typically
those with a slow GPU relative to the CPU.)
• On unix Rscript will pass the r_arch setting it was compiled with
on to the R process so that the architecture of Rscript and that
of R will match unless overridden.
• On Windows, basename(), dirname() and file.choose() have more
support for long non-ASCII file names with 260 or more bytes when
expressed in UTF-8.
CHANGES IN R VERSION 2.15.2:
NEW FEATURES:
• The X11() window gains an icon: the latter may be especially
useful on Ubuntu's ‘Unity’ interface.
The WM_CLASS should be set in circumstances where the Window
Manager failed to make use of X11 resource settings.
(Contributed by Philip Johnson.)
• The "Date" and "POSIXt" methods for cut() will accept an unsorted
breaks argument (as the default method does, although this was
undocumented). (Wish of PR#14961.)
• Reference class methods (in the methods package) that use other
methods in an indirect way (e.g., by sapply()) must tell the code
analysis to include that method. They can now do so by invoking
$usingMethods().
• More Polish translations are available: for the RGui menus and
for several recommended packages.
• Multistratum MANOVA works. In fact, it seems to have done so for
years in spite of the help page claiming it did not.
• qqline() has new optional arguments distribution, probs and
qtype, following the example of lattice's panel.qqmathline().
• The handling of single quotes in the en@quot pseudo-language has
been slightly improved. Double quotes are no longer converted.
• New functions checkPoFiles() and checkPoFile() have been added to
the tools package to check for consistency of format strings in
translation files.
• model.matrix(~1, ...) now also contains the same rownames that
less trivial formulae produce. (Wish of PR#14992, changes the
output of several packages.)
• Misuse of rep() on undocumented types of objects (e.g. calls) is
now reported as an error.
• The included LAPACK has been updated to 3.4.1, with some patches
from the current SVN sources. (_Inter alia_, this resolves
PR#14692.)
• file.copy(recursive = TRUE) has some additional checks on user
error leading to attempted infinite recursion (and on some
platforms to crashing R).
• PCRE has been updated to version 8.31, a bug-fix release.
• The included version of liblzma has been updated to version
5.0.4, a minor bug-fix release.
• New function .bincode(), a ‘bare-bones’ version of
cut.default(labels = FALSE) for use in packages with image()
methods.
• The HTML manuals now use directional single quotes.
• maintainer() now converts embedded new lines to spaces. It no
longer gives a non-obvious error for non-installed packages.
• The X11() device has some protection against being used with
forked processes _via_ package parallel.
• Setting the environment variable R_OSX_VALGRIND (to any value)
allows R to be run under valgrind on Mac OS 10.6 and 10.7
(valgrind currently has very limited support for 10.8), provided
system() is not used (directly or indirectly). This should not
be needed for valgrind >= 3.8.1.
• The model.frame() method for "lm" uses xlevels: this is safer if
data was supplied or model = FALSE was used and the levels of
factors used in the fit had been re-ordered since fitting.
Similarly, model.frame(fm, data=<data>) copies across the
variables used for safe prediction from the fit.
• Functions such as parLapply() in package parallel can make use of
a default cluster if one is set. (Reported by Martin Morgan.)
• chol(pivot = TRUE, LINPACK = FALSE) is now available using LAPACK
3.2 subroutine DPSTRF.
• The functions .C(), .Call(), .External() and .Fortran() now check
that they are called with an unnamed first argument: the formal
arguments were changed from name= to .NAME= in R 2.13.0, but some
packages were still using the old name. This is currently a
warning, but will be an error in future.
• step() no longer tries to improve a model with AIC of -Inf (a
perfect fit).
• spline() and splinefun() gain a new method "hyman", an
implementation of Hyman's method of constructing monotonic
interpolation splines. (Based on contributions of Simon Wood and
Rob Hyndman.)
• On Windows, the C stack size has been increased to 64MB (it has
been 10MB since the days of 32MB RAM systems).
PERFORMANCE IMPROVEMENTS:
• array() is now implemented in C code (for speed) when data is
atomic or an unclassed list (so it is known that as.vector(data)
will have no class to be used by rep()).
• rep() is faster and uses less memory, substantially so in some
common cases (e.g. if times is of length one or length.out is
given, and each = 1).
• findInterval(), tabulate(), cut(), hist() and image.default() all
use .Call() and are more efficient.
• duplicated(), unique() and similar now support vectors of lengths
above 2^29 on 64-bit platforms.
• Omitting PACKAGE in .C() etc calls was supposed to make use of
the DLL from the namespace within which the enclosing function
was defined. It was less successful in doing so than it might
be, and gave no indication it had failed.
A new search strategy is very successful and gives a warning when
it fails. In most cases this is because the entry point is not
actually provided by that package (and so PACKAGE should be used
to indicate which package is intended) but in some the namespace
does not have a DLL specified by a useDynLib() directive so
PACKAGE is required.
UTILITIES:
• R CMD check now checks if a package can be loaded by
library(pkgname, lib.loc = "somewhere") without being on the
library search path (unless it is already installed in .Library,
when it always will be).
• R CMD check --as-cran notes ‘hidden’ files and directories (with
names starting with a dot) that are not needed for the operation
of R CMD INSTALL or R CMD build: such files should be excluded
from the published tarball.
• R CMD check (if checking subdirectories) checks that the R code
in any demos is ASCII and can be parsed, and warns if not.
• When R CMD Rd2pdf is used with inputenx.sty, it allows further
characters (mainly for Eastern European languages) by including
ix-utf8enc.dfu (if available). (Wish of PR#14989.)
• R CMD build now omits several types of hidden files/directories,
including inst/doc/.Rinstignore, vignettes/.Rinstignore,
(.Rinstignore should be at top level), .deps under src,
.Renviron, .Rprofile, .Rproj.user, .backups, .cvsignore,
.cproject, .directory, .dropbox, .exrc, .gdb.history,
.gitattributes, .gitignore, .gitmodules, .hgignore, .hgtags,
.htaccess, .latex2html-init, .project, .seed, .settings,
.tm_properties and various leftovers.
• R CMD check now checks for .C(), .Call(), .External() and
.Fortran() calls in other packages, and gives a warning on those
found from R itself (which are not part of the API and change
without notice: many will be changed for R 3.0.0).
C-LEVEL FACILITIES:
• The limit for R_alloc on 64-bit platforms has been raised to just
under 32GB (from just under 16GB).
• The misuse of .C("name", ..., PACKAGE = foo) where foo is an
arbitrary R object is now an error.
The misuse .C("name",..., PACKAGE = "") is now warned about in R
CMD check, and will be an error in future.
DEPRECATED AND DEFUNCT:
• Use of array() with a 0-length dim argument is deprecated with a
warning (and was contrary to the documentation).
• Use of tapply() with a 0-length INDEX list is deprecated with a
warning.
• Translation packages are deprecated.
• Calling rep() or rep.int() on a pairlist is deprecated and will
give a warning. In any case, rep() converted a pairlist to a
list so you may as well do that explicitly.
• Entry point rcont2 is no longer part of the API, and will move to
package stats in R 3.0.0.
• The ‘internal’ graphics device invoked by
.Call("R_GD_nullDevice", package = "grDevices") is about to be
removed: use pdf(file = NULL) instead.
• eigen(EISPACK = TRUE), chol(pivot = FALSE, LINPACK = TRUE),
chol2inv(LINPACK = TRUE), solve(LINPACK = TRUE) and svd(LINPACK =
TRUE) are deprecated and give a warning.
They were provided for compatibility with R 1.7.0 (Mar 2003)!
• The ‘internal function’ kappa.tri() has been renamed to
.kappa_tri() so it is not inadvertently called as a method for
class "tri".
• Functions sessionData() and browseAll() in package methods are on
a help page describing them as ‘deprecated’ and are now formally
deprecated.
PACKAGE INSTALLATION:
• For a Windows or Mac OS X binary package install,
install.packages() will check if a source package is available on
the same repositories, and report if it is a later version or
there is a source package but no binary package available.
This check can be suppressed: see the help page.
• install.packages(type = "both") has been enhanced. In
interactive use it will ask whether to choose the source version
of a package if the binary version is older and contains compiled
code, and also asks if source packages with no binary version
should be installed).
INSTALLATION:
• There is a new configure option --with-libtiff (mainly in case
the system installation needs to be avoided).
• LAPACK 3.4.1 does use some Fortran 90 features, so g77 no longer
suffices.
• If an external LAPACK is used, it must be version 3.2 or later.
BUG FIXES:
• On Windows, starting Rterm via R.exe caused Ctrl-C to misbehave.
(PR#14948)
• The tools::latexToUtf8() function missed conversions that were
contained within braces.
• Long timezone specifications (such as a file name preceded by :)
could crash as.POSIXlt. (PR#14945)
• R CMD build --resave-data could fail if there was no data
directory but there was an R/sysdata.rda file. (PR#14947)
• is.na() misbehaved on a 0-column data frame. (PR#14959)
• anova.lmlist() failed if test was supplied. (PR#14960)
It was unable to compute Cp tests for object of class "lm" (it
assumed class "glm").
• The formula method for sunflowerplot() now allows xlab and ylab
to be set. (Reported by Gerrit Eichner.)
• The "POSIXt" and "Date" methods for hist() could fail on Windows
where adjustments to the right-hand boundary crossed a DST
transition time.
• On Windows, the code in as.POSIXct() to handle incorrectly
specified isdst fields might have resulted in NA being returned.
• aov() and manova() gave spurious warning about singular error
model in the multiresponse case.
• In ns() and bs(), specifying knots = NULL is now equivalent to
omitting it, also when df is specified. (PR#14970)
• sprintf() did not accept numbered arguments ending in zero.
(PR#14975)
• rWishart() could overflow the C stack and maybe crash the R
process for dimensions of several hundreds or more. (Reported by
Michael Braun on R-sig-mac.)
• Base package vignettes (e.g. vignette("Sweave")) were not fully
installed in builds of R from the tarball.
• lchoose() and choose() could overflow the C stack and crash R.
• When given a 0-byte file and asked to keep source references,
parse() read input from stdin() instead.
• pdf(compress = TRUE) did not delete temporary files it created
until the end of the R session. (PR#14991)
• logLik() did not detect the error of applying it to a
multiple-response linear model. (PR#15000)
• file.copy(recursive = TRUE) did not always report FALSE for a
failure two or more directories deep.
• qgeom() could return -1 for extremely small q. (PR#14967)
• smooth.spline() used DUP = FALSE which allowed its compiled C
code to change the function: this was masked by the default
byte-compilation. (PR#14965)
• In Windows, the GUI preferences for foreground color were not
always respected. (Reported by Benjamin Wells.)
• On OS X, the Quartz versions of the bitmap devices did not
respect antialias = "none". (PR#15006)
• unique() and similar would infinite-loop if called on a vector of
length > 2^29 (but reported that the vector was too long for 2^30
or more).
• parallel::stopCluster() now works with MPI clusters without snow
being on the search path.
• terms.formula() could exhaust the stack, and the stack check did
not always catch this before the segfault. (PR#15013)
• sort.list(method = "radix") could give incorrect results on
certain compilers (seen with clang on Mac OS 10.7 and Xcode
4.4.1).
• backsolve(T, b) gave incorrect results when nrows(b) > ncols(T)
and b had more than one column.
It could segfault or give nonsense if k was specified as more
than ncols(T).
• smooth.spline() did not check that a specified numeric spar was
of length 1, and gave corrupt results if it was of length 0.
• Protection added to do_system. (PR#15025)
• Printing of vectors with names > 1000 characters now works
correctly rather than truncating. (PR#15028)
• qr() for a complex matrix did not pivot the column names.
• --with-blas='-framework vecLib' now also works on OS X 10.8.
• R CMD check no longer fails with an error if a DESCRIPTION file
incorrectly contains a blank line. (Reported by Bill Dunlap.)
• install.packages(type = "both") could call chooseCRANmirror()
twice.
• lm.wfit() could segfault in R 2.15.1 if all the weights were
zero. (PR#15044)
• A malformed package name could cause R CMD INSTALL to write
outside the target library.
• Some of the quality control functions (e.g. tools::checkFF())
were wrongly identifying the source of S4 methods in a package
and so not checking them.
• The default type of display by browseEnv() when using R.app on
Mac OS X has been incorrect for a long time.
• The implementation of importMethodsFrom in a NAMESPACE file could
be confused and fail to find generics when importing from
multiple packages (reported and fixed by Michael Lawrence).
• The detection of the C stack direction is better protected
against compiler optimization. (PR#15011)
• Long custom line types would sometimes segfault on the
cairographics-based devices. (PR#15055)
• tools::checkPoFile() unprotected too early in its C code and so
segfaulted from time to time.
• The Fortran code underlying nlminb() could infinite-loop if any
of the input functions returned NA or NaN. This is now an error
for the gradient or Hessian, and a warning for the function (with
the value replaced by Inf). (In part, PR#15052.)
• The code for creating coerce() methods could generate false notes
about ambiguous selection; the notes have been suppressed for
this function.
• arima.sim() could give too long an output in some corner cases
(in part, PR#15068).
• anova.glm() with test = "Rao" didn't work when models included an
offset. (Reported by Søren Feodor Nielsen.)
• as.data.frame.matrix() could return invalid data frame with no
row.names attribute for 0-row matrix. (Reported by Hervé Pagès.)
• Compilation with the vecLib or Accelerate frameworks on OS X
without using that also for LAPACK is more likely to be
successful.
CHANGES IN R VERSION 2.15.1:
NEW FEATURES:
• source() now uses withVisible() rather than
.Internal(eval.with.vis). This sometimes alters tracebacks
slightly.
• install.packages("pkg_version.tgz") on Mac OS X now has sanity
checks that this is actually a binary package (as people have
tried it with incorrectly named source packages).
• splineDesign() and spline.des() in package splines have a new
option sparse which can be used for efficient construction of a
sparse B-spline design matrix (_via_ Matrix).
• norm() now allows type = "2" (the ‘spectral’ or 2-norm) as well,
mainly for didactical completeness.
• pmin() and pmax()) now also work when one of the inputs is of
length zero and others are not, returning a zero-length vector,
analogously to, say, +.
• colorRamp() (and hence colorRampPalette()) now also works for the
boundary case of just one color when the ramp is flat.
• .C() gains some protection against the misuse of character vector
arguments. (An all too common error is to pass character(N),
which initializes the elements to "", and then attempt to edit
the strings in-place, sometimes forgetting to terminate them.)
• Calls to the new function globalVariables() in package utils
declare that functions and other objects in a package should be
treated as globally defined, so that CMD check will not note
them.
• print(packageDescription(*)) trims the Collate field by default.
• The included copy of zlib has been updated to version 1.2.7.
• A new option "show.error.locations" has been added. When set to
TRUE, error messages will contain the location of the most recent
call containing source reference information. (Other values are
supported as well; see ?options.)
• The NA warning messages from e.g. pchisq() now report the call to
the closure and not that of the .Internal.
• Added Polish translations by Łukasz Daniel.
PERFORMANCE IMPROVEMENTS:
• In package parallel, makeForkCluster() and the multicore-based
functions use native byte-order for serialization (deferred from
2.15.0).
• lm.fit(), lm.wfit(), glm.fit() and lsfit() do less copying of
objects, mainly by using .Call() rather than .Fortran().
• .C() and .Fortran() do less copying: arguments which are raw,
logical, integer, real or complex vectors and are unnamed are not
copied before the call, and (named or not) are not copied after
the call. Lists are no longer copied (they are supposed to be
used read-only in the C code).
• tabulate() makes use of .C(DUP = FALSE) and hence does not copy
bin. (Suggested by Tim Hesterberg.) It also avoids making a
copy of a factor argument bin.
• Other functions (often or always) doing less copying include
cut(), dist(), the complex case of eigen(), hclust(), image(),
kmeans(), loess(), stl() and svd(LINPACK = TRUE).
• There is less copying when using primitive replacement functions
such as names(), attr() and attributes().
DEPRECATED AND DEFUNCT:
• The converters for use with .C() (see ?getCConverterDescriptions)
are deprecated: use the .Call() interface instead. There are no
known examples (they were never fully documented).
UTILITIES:
• For R CMD check, a few people have reported problems with
junctions on Windows (although they were tested on Windows 7, XP
and Server 2008 machines and it is unknown under what
circumstances the problems occur). Setting the environment
variable R_WIN_NO_JUNCTIONS to a non-empty value (e.g. in
~/.R/check.Renviron) will force copies to be used instead.
INSTALLATION:
• R CMD INSTALL with _R_CHECK_INSTALL_DEPENDS_ set to a true value
(as done by R CMD check --as-cran) now restricts the packages
available when lazy-loading as well as when test-loading (since
packages such as ETLUtils and agsemisc had top-level calls to
library() for undeclared packages).
This check is now also available on Windows.
C-LEVEL FACILITIES:
• C entry points mkChar and mkCharCE now check that the length of
the string they are passed does not exceed 2^31-1 bytes: they
used to overflow with unpredictable consequences.
• C entry points R_GetCurrentSrcref and R_GetSrcFilename have been
added to the API to allow debuggers access to the source
references on the stack.
WINDOWS-SPECIFIC CHANGES:
• Windows-specific changes will now be announced in this file
(NEWS). Changes up and including R 2.15.0 remain in the CHANGES
file.
• There are two new environment variables which control the
defaults for command-line options.
If R_WIN_INTERNET2 is set to a non-empty value, it is as if
--internet2 was used.
If R_MAX_MEM_SIZE is set, it gives the default memory limit if
--max-mem-size is not specified: invalid values being ignored.
BUG FIXES:
• lsfit() lost the names from the residuals.
• More cases in which merge() could create a data frame with
duplicate column names now give warnings. Cases where names
specified in by match multiple columns are errors.
• Nonsense uses such as seq(1:50, by = 5) (from package plotrix)
and seq.int(1:50, by = 5) are now errors.
• The residuals in the 5-number summary printed by summary() on an
"lm" object are now explicitly labelled as weighted residuals
when non-constant weights are present. (Wish of PR#14840.)
• tracemem() reported that all objects were copied by .C() or
.Fortran() whereas only some object types were ever copied.
It also reported and marked as copies _some_ transformations such
as rexp(n, x): it no longer does so.
• The plot() method for class "stepfun" only used the optional xval
argument to compute xlim and not the points at which to plot (as
documented). (PR#14864)
• Names containing characters which need to be escaped were not
deparsed properly. (PR#14846)
• Trying to update (recommended) packages in R_HOME/library without
write access is now dealt with more gracefully. Further, such
package updates may be skipped (with a warning), when a newer
installed version is already going to be used from .libPaths().
(PR#14866)
• hclust() is now fast again (as up to end of 2003), with a
different fix for the "median"/"centroid" problem. (PR#4195).
• get_all_vars() failed when the data came entirely from vectors in
the global environment. (PR#14847)
• R CMD check with _R_CHECK_NO_RECOMMENDED_ set to a true value (as
done by the --as-cran option) could issue false errors if there
was an indirect dependency on a recommended package.
• formatC() uses the C entry point str_signif which could write
beyond the length allocated for the output string.
• Missing default argument added to implicit S4 generic for
backsolve(). (PR#14883)
• Some bugs have been fixed in handling load actions that could
fail to export assigned items or generate spurious warnings in
CMD check on loading.
• For tiff(type = "windows"), the numbering of per-page files
except the last was off by one.
• On Windows, loading package stats (which is done for a default
session) would switch line endings on stdout and stderr from CRLF
to LF. This affected Rterm and R CMD BATCH.
• On Windows, the compatibility function x11() had not kept up with
changes to windows(), and issued warnings about bad parameters.
(PR#14880)
• On Windows, the Sys.glob() function did not handle UNC paths as
it was designed to try to do. (PR#14884)
• In package parallel, clusterApply() and similar failed to handle
a (pretty pointless) length-1 argument. (PR#14898)
• Quartz Cocoa display reacted asynchronously to dev.flush() which
means that the redraw could be performed after the plot has been
already modified by subsequent code. The redraw is now done
synchronously in dev.flush() to allow animations without sleep
cycles.
• Source locations reported in traceback() were incorrect when
byte-compiled code was on the stack.
• plogis(x, lower = FALSE, log.p = TRUE) no longer underflows early
for large x (e.g. 800).
• ?Arithmetic's “1 ^ y and y ^ 0 are 1, _always_” now also applies
for integer vectors y.
• X11-based pixmap devices like png(type = "Xlib") were trying to
set the cursor style, which triggered some warnings and hangs.
• Code executed by the built-in HTTP server no longer allows other
HTTP clients to re-enter R until the current worker evaluation
finishes, to prevent cascades.
• The plot() and Axis() methods for class "table" now respect
graphical parameters such as cex.axis. (Reported by Martin
Becker.)
• Under some circumstances package.skeleton() would give out
progress reports that could not be translated and so were
displayed by question marks. Now they are always in English.
(This was seen for CJK locales on Windows, but may have occurred
elsewhere.)
• The evaluator now keeps track of source references outside of
functions, e.g. when source() executes a script.
• The replacement method for window() now works correctly for
multiple time series of class "mts". (PR#14925)
• is.unsorted() gave incorrect results on non-atomic objects such
as data frames. (Reported by Matthew Dowle.)
• The value returned by tools::psnice() for invalid pid values was
not always NA as documented.
• Closing an X11() window while locator() was active could abort
the R process.
• getMethod(f, sig) produced an incorrect error message in some
cases when f was not a string).
• Using a string as a “call” in an error condition with
options(showErrorCalls=TRUE) could cause a segfault. (PR#14931)
• The string "infinity" allowed by C99 was not accepted as a
numerical string value by e.g. scan() and as.numeric().
(PR#14933)
• In legend(), setting some entries of lwd to NA was inconsistent
(depending on the graphics device) in whether it would suppress
those lines; now it consistently does so. (PR#14926)
• by() failed for a zero-row data frame. (Reported by Weiqiang
Qian.)
• The Yates' correction in chisq.test() could be bigger than the
terms it corrected, previously leading to an infinite test
statistic in some corner cases which are now reported as NaN.
• xgettext() and related functions sometimes returned items that
were not strings for translation. (PR#14935)
• plot(<lm>, which=5) now correctly labels the factor level
combinations for the special case where all h[i,i] are the same.
(PR#14837)
• Sys.glob() caused a segfault if the first element of path was
NA_character. (PR#14990)
CHANGES IN R VERSION 2.15.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• The behaviour of unlink(recursive = TRUE) for a symbolic link to
a directory has changed: it now removes the link rather than the
directory contents (just as rm -r does).
On Windows it no longer follows reparse points (including
junctions and symbolic links).
NEW FEATURES:
• Environment variable RD2DVI_INPUTENC has been renamed to
RD2PDF_INPUTENC.
• .Deprecated() becomes a bit more flexible, getting an old
argument.
• Even data-only packages without R code need a namespace and so
may need to be installed under R 2.14.0 or later.
• assignInNamespace() has further restrictions on use apart from at
top-level, as its help page has warned. Expect it to be disabled
from programmatic use in the future.
• system() and system2() when capturing output report a non-zero
status in the new "status" attribute.
• kronecker() now has an S4 generic in package methods on which
packages can set methods. It will be invoked by X %x% Y if
either X or Y is an S4 object.
• pdf() accepts forms like file = "|lpr" in the same way as
postscript().
• pdf() accepts file = NULL. This means that the device does NOT
create a PDF file (but it can still be queried, e.g., for font
metric info).
• format() (and hence print()) on "bibentry" objects now uses
options("width") to set the output width.
• legend() gains a text.font argument. (Suggested by Tim Paine,
PR#14719.)
• nchar() and nzchar() no longer accept factors (as integer
vectors). (Wish of PR#6899.)
• summary() behaves slightly differently (or more precisely, its
print() method does). For numeric inputs, the number of NAs is
printed as an integer and not a real. For dates and datetimes,
the number of NAs is included in the printed output (the latter
being the wish of PR#14720).
The "data.frame" method is more consistent with the default
method: in particular it now applies zapsmall() to
numeric/complex summaries.
• The number of items retained with options(warn = 0) can be set by
options(nwarnings=).
• There is a new function assignInMyNamespace() which uses the
namespace of the function it is called from.
• attach() allows the default name for an attached file to be
overridden.
• bxp(), the work horse of boxplot(), now uses a more sensible
default xlim in the case where at is specified differently from
1:n, see the discussion on R-devel, <URL:
https://stat.ethz.ch/pipermail/r-devel/2011-November/062586.html>.
• New function paste0(), an efficient version of paste(*, sep=""),
to be used in many places for more concise (and slightly more
efficient) code.
• Function setClass() in package methods now returns, invisibly, a
generator function for the new class, slightly preferred to
calling new(), as explained on the setClass help page.
• The "dendrogram" method of str() now takes its default for
last.str from option str.dendrogram.last.
• New simple fitted() method for "kmeans" objects.
• The traceback() function can now be called with an integer
argument, to display a current stack trace. (Wish of PR#14770.)
• setGeneric() calls can be simplified when creating a new generic
function by supplying the default method as the def argument.
See ?setGeneric.
• serialize() has a new option xdr = FALSE which will use the
native byte-order for binary serializations. In scenarios where
only little-endian machines are involved (these days, close to
universal) and (un)serialization takes an appreciable amount of
time this may speed up noticeably transferring data between
systems.
• The internal (un)serialization code is faster for long vectors,
particularly with XDR on some platforms. (Based on a suggested
patch by Michael Spiegel.)
• For consistency, circles with zero radius are omitted by points()
and grid.circle(). Previously this was device-dependent, but
they were usually invisible.
• NROW(x) and NCOL(x) now work whenever dim(x) looks appropriate,
e.g., also for more generalized matrices.
• PCRE has been updated to version 8.30.
• The internal R_Srcref variable is now updated before the browser
stops on entering a function. (Suggestion of PR#14818.)
• There are ‘bare-bones’ functions .colSums(), .rowSums(),
.colMeans() and .rowMeans() for use in programming where ultimate
speed is required.
• The formerly internal function .package_dependencies() from
package tools for calculating (recursive) (reverse) dependencies
on package databases has been renamed to package_dependencies()
and is now exported.
• There is a new function optimHess() to compute the (approximate)
Hessian for an optim() solution if hessian = TRUE was forgotten.
• .filled.contour() is a ‘bare-bones’ function to add a
filled-contour rectangular plot to an already prepared plot
region.
• The stepping in debugging and single-step browsing modes has
changed slightly: now left braces at the start of the body are
stepped over for if statements as well as for for and while
statements. (Wish of PR#14814.)
• library() no longer warns about a conflict with a function from
package:base if the function has the same code as the base one
but with a different environment. (An example is Matrix::det().)
• When deparsing very large language objects, as.character() now
inserts newlines after each line of approximately 500 bytes,
rather than truncating to the first line.
• New function rWishart() generates Wishart-distributed random
matrices.
• Packages may now specify actions to be taken when the package is
loaded (setLoadActions()).
• options(max.print = Inf) and similar now give an error (instead
of warnings later).
• The "difftime" replacement method of units tries harder to
preserve other attributes of the argument. (Wish of PR#14839.)
• poly(raw = TRUE) no longer requires more unique points than the
degree. (Requested by John Fox.)
PACKAGE parallel:
• There is a new function mcmapply(), a parallel version of
mapply(), and a wrapper mcMap(), a parallel version of Map().
• A default cluster can be registered by the new function
setDefaultCluster(): this will be used by default in functions
such as parLapply().
• clusterMap() has a new argument .scheduling to allow the use of
load-balancing.
• There are new load-balancing functions parLapplyLB() and
parSapplyLB().
• makePSOCKCluster() has a new option useXDR = FALSE which can be
used to avoid byte-shuffling for serialization when all the nodes
are known to be little-endian (or all big-endian).
PACKAGE INSTALLATION:
• Non-ASCII vignettes without a declared encoding are no longer
accepted.
• C/C++ code in packages is now compiled with -NDEBUG to mitigate
against the C/C++ function assert being called in production use.
Developers can turn this off during package development with
PKG_CPPFLAGS = -UNDEBUG.
• R CMD INSTALL has a new option --dsym which on Mac OS X (Darwin)
dumps the symbols alongside the .so file: this is helpful when
debugging with valgrind (and especially when installing packages
into R.framework). [This can also be enabled by setting the
undocumented environment variable PKG_MAKE_DSYM, since R 2.12.0.]
• R CMD INSTALL will test loading under all installed
sub-architectures even for packages without compiled code, unless
the flag --no-multiarch is used. (Pure R packages can do things
which are architecture-dependent: in the case which prompted
this, looking for an icon in a Windows R executable.)
• There is a new option install.packages(type = "both") which tries
source packages if binary packages are not available, on those
platforms where the latter is the default.
• The meaning of install.packages(dependencies = TRUE) has changed:
it now means to install the essential dependencies of the named
packages plus the Suggests, but only the essential dependencies
of dependencies. To get the previous behaviour, specify
dependencies as a character vector.
• R CMD INSTALL --merge-multiarch is now supported on OS X and
other Unix-alikes using multiple sub-architectures.
• R CMD INSTALL --libs-only now by default does a test load on
Unix-alikes as well as on Windows: suppress with --no-test-load.
UTILITIES:
• R CMD check now gives a warning rather than a note if it finds
inefficiently compressed datasets. With bzip2 and xz compression
having been available since R 2.10.0, it only exceptionally makes
sense to not use them.
The environment variable _R_CHECK_COMPACT_DATA2_ is no longer
consulted: the check is always done if _R_CHECK_COMPACT_DATA_ has
a true value (its default).
• Where multiple sub-architectures are to be tested, R CMD check
now runs the examples and tests for all the sub-architectures
even if one fails.
• R CMD check can optionally report timings on various parts of the
check: this is controlled by environment variable
_R_CHECK_TIMINGS_ documented in ‘Writing R Extensions’. Timings
(in the style of R CMD BATCH) are given at the foot of the output
files from running each test and the R code in each vignette.
• There are new options for more rigorous testing by R CMD check
selected by environment variables - see the ‘Writing R
Extensions’ manual.
• R CMD check now warns (rather than notes) on undeclared use of
other packages in examples and tests: increasingly people are
using the metadata in the DESCRIPTION file to compute information
about packages, for example reverse dependencies.
• The defaults for some of the options in R CMD check (described in
the ‘R Internals’ manual) have changed: checks for unsafe and
.Internal() calls and for partial matching of arguments in R
function calls are now done by default.
• R CMD check has more comprehensive facilities for checking
compiled code and so gives fewer reports on entry points linked
into .so/.dll files from libraries (including C++ and Fortran
runtimes).
Checking compiled code is now done on FreeBSD (as well as the
existing supported platforms of Linux, Mac OS X, Solaris and
Windows).
• R CMD build has more options for --compact-vignettes: see R CMD
build --help.
• R CMD build has a new option --md5 to add an MD5 file (as done by
CRAN): this is used by R CMD INSTALL to check the integrity of
the distribution.
If this option is not specified, any existing (and probably
stale) MD5 file is removed.
DEPRECATED AND DEFUNCT:
• R CMD Rd2dvi is now defunct: use R CMD Rd2pdf.
• Options such --max-nsize, --max-vsize and the function
mem.limits() are now defunct. (Options --min-nsize and
--min-vsize remain available.)
• Use of library.dynam() without specifying all the first three
arguments is now disallowed.
Use of an argument chname in library.dynam() including the
extension .so or .dll (which was never allowed according to the
help page) is defunct. This also applies to
library.dynam.unload() and to useDynLib directives in NAMESPACE
files.
• The internal functions .readRDS() and .saveRDS() are now defunct.
• The off-line help() types "postscript" and "ps" are defunct.
• Sys.putenv(), replaced and deprecated in R 2.5.0, is finally
removed.
• Some functions/objects which have been defunct for five or more
years have been removed completely. These include .Alias(),
La.chol(), La.chol2inv(), La.eigen(), Machine(), Platform(),
Version, codes(), delay(), format.char(), getenv(), httpclient(),
loadURL(), machine(), parse.dcf(), printNoClass(), provide(),
read.table.url(), restart(), scan.url(), symbol.C(), symbol.For()
and unix().
• The ENCODING argument to .C() is deprecated. It was intended to
smooth the transition to multi-byte character strings, but can be
replaced by the use of iconv() in the rare cases where it is
still needed.
INSTALLATION:
• Building with a positive value of --with-valgrind-instrumentation
now also instruments logical, complex and raw vectors.
C-LEVEL FACILITIES:
• Passing R objects other than atomic vectors, functions, lists and
environments to .C() is now deprecated and will give a warning.
Most cases (especially NULL) are actually coding errors. NULL
will be disallowed in future.
.C() now passes a pairlist as a SEXP to the compiled code. This
is as was documented, but pairlists were in reality handled
differently as a legacy from the early days of R.
• call_R and call_S are deprecated. They still exist in the
headers and as entry points, but are no longer documented and
should not be used for new code.
BUG FIXES:
• str(x, width) now obeys its width argument also for function
headers and other objects x where deparse() is applied.
• The convention for x %/% 0L for integer-mode x has been changed
from 0L to NA_integer_. (PR#14754)
• The exportMethods directive in a NAMESPACE file now exports S4
generics as necessary, as the extensions manual said it does.
The manual has also been updated to be a little more informative
on this point.
It is now required that there is an S4 generic (imported or
created in the package) when methods are to be exported.
• Reference methods cannot safely use non-exported entries in the
namespace. We now do not do so, and warn in the documentation.
• The namespace import code was warning when identical S4 generic
functions were imported more than once, but should not (reported
by Brian Ripley, then Martin Morgan).
• merge() is no longer allowed (in some ways) to create a data
frame with duplicate column names (which confused PR#14786).
• Fixes for rendering raster images on X11 and Windows devices when
the x-axis or y-axis scale is reversed.
• getAnywhere() found S3 methods as seen from the utils namespace
and not from the environment from which it was called.
• selectMethod(f, sig) would not return inherited group methods
when caching was off (as it is by default).
• dev.copy2pdf(out.type = "cairo") gave an error. (PR#14827)
• Virtual classes (e.g., class unions) had a NULL prototype even if
that was not a legal subclass. See ?setClassUnion.
• The C prototypes for zdotc and zdotu in R_ext/BLAS.h have been
changed to the more modern style rather than that used by f2c.
(Patch by Berwin Turlach.)
• isGeneric() produced an error for primitives that can not have
methods.
• .C() or .Fortran() had a lack-of-protection error if the
registration information resulted in an argument being coerced to
another type.
• boxplot(x=x, at=at) with non finite elements in x and non integer
at could not generate a warning but failed.
• heatmap(x, symm=TRUE, RowSideColors=*) no longer draws the colors
in reversed order.
• predict(<ar>) was incorrect in the multivariate case, for p >= 2.
• print(x, max=m) is now consistent when x is a "Date"; also the
“reached ... max.print ..” messages are now consistently using
single brackets.
• Closed the <li> tag in pages generated by Rd2HTML(). (PR#14841)
• Axis tick marks could go out of range when a log scale was used.
(PR#14833)
• Signature objects in methods were not allocated as S4 objects
(caused a problem with trace() reported by Martin Morgan).
CHANGES IN R VERSION 2.14.2:
NEW FEATURES:
• The internal untar() (as used by default by R CMD INSTALL) now
knows about some pax headers which bsdtar (e.g., the default tar
for Mac OS >= 10.6) can incorrectly include in tar files, and
will skip them with a warning.
• PCRE has been upgraded to version 8.21: as well as bug fixes and
greater Perl compatibility, this adds a JIT pattern compiler,
about which PCRE's news says ‘large performance benefits can be
had in many situations’. This is supported on most but not all R
platforms.
• Function compactPDF() in package tools now takes the default for
argument gs_quality from environment variable GS_QUALITY: there
is a new value "none", the ultimate default, which prevents
GhostScript being used in preference to qpdf just because
environment variable R_GSCMD is set. If R_GSCMD is unset or set
to "", the function will try to find a suitable GhostScript
executable.
• The included version of zlib has been updated to 1.2.6.
• For consistency with the logLik() method, nobs() for "nls" files
now excludes observations with zero weight. (Reported by Berwin
Turlach.)
UTILITIES:
• R CMD check now reports by default on licenses not according to
the description in ‘Writing R Extensions’.
• R CMD check has a new option --as-cran to turn on most of the
customizations that CRAN uses for its incoming checks.
PACKAGE INSTALLATION:
• R CMD INSTALL will now no longer install certain file types from
inst/doc: these are almost certainly mistakes and for some
packages are wasting a lot of space. These are Makefile, files
generated by running LaTeX, and unless the package uses a
vignettes directory, PostScript and image bitmap files.
Note that only PDF vignettes have ever been supported: some of
these files come from DVI/PS output from the Sweave defaults
prior to R 2.13.0.
BUG FIXES:
• R configured with --disable-openmp would mistakenly set
HAVE_OPENMP (internal) and SUPPORT_OPENMP (in Rconfig.h) even
though no OpenMP flags were populated.
• The getS3method() implementation had an old computation to find
an S4 default method.
• readLines() could overflow a buffer if the last line of the file
was not terminated. (PR#14766)
• R CMD check could miss undocumented S4 objects in packages which
used S4 classes but did not Depends: methods in their DESCRIPTION
file.
• The HTML Help Search page had malformed links. (PR#14769)
• A couple of instances of lack of protection of SEXPs have been
squashed. (PR#14772, PR#14773)
• image(x, useRaster=TRUE) misbehaved on single-column x.
(PR#14774)
• Negative values for options("max.print") or the max argument to
print.default() caused crashes. Now the former are ignored and
the latter trigger an error. (PR#14779)
• The text of a function body containing more than 4096 bytes was
not properly saved by the parser when entered at the console.
• Forgetting the #endif tag in an Rd file could cause the parser to
go into a loop. (Reported by Hans-Jorg Bibiko.)
• str(*, ....., strict.width="cut") now also obeys list.len = n.
(Reported by Sören Vogel.)
• Printing of arrays did not have enough protection (C level),
e.g., in the context of capture.output(). (Reported by Hervé
Pagès and Martin Morgan.)
• pdf(file = NULL) would produce a spurious file named NA.
(PR#14808)
• list2env() did not check the type of its envir argument.
(PR#14807)
• svg() could segfault if called with a non-existent file path.
(PR#14790)
• make install can install to a path containing + characters.
(PR#14798)
• The edit() function did not respect the options("keep.source")
setting. (Reported by Cleridy Lennert.)
• predict.lm(*, type="terms", terms=*, se.fit=TRUE) did not work.
(PR#14817)
• There is a partial workaround for errors in the TRE
regular-expressions engine with named classes and repeat counts
of at least 2 in a MBCS locale (PR#14408): these are avoided when
TRE is in 8-bit mode (e.g. for useBytes = TRUE and when all the
data are ASCII).
• The C function R_ReplDLLdo1() did not call top-level handlers.
• The Quartz device was unable to detect window sessions on Mac OS
X 10.7 (Lion) and higher and thus it was not used as the default
device on the console. Since Lion any application can use window
sessions, so Quartz will now be the default device if the user's
window session is active and R is not run via ssh which is at
least close to the behavior in prior OS X versions.
• mclapply() would fail in code assembling the translated error
message if some (but not all) cores encountered an error.
• format.POSIXlt(x) raised an arithmetic exception when x was an
invalid object of class "POSIXlt" and parts were empty.
• installed.packages() has some more protection against package
installs going on in parallel.
• .Primitive() could be mis-used to call .Internal() entry points.
CHANGES IN R VERSION 2.14.1:
NEW FEATURES:
• parallel::detectCores() is now able to find the number of
physical cores (rather than CPUs) on Sparc Solaris.
It can also do so on most versions of Windows; however the
default remains detectCores(logical = TRUE) on that platform.
• Reference classes now keep a record of which fields are locked.
$lock() with no arguments returns the names of the locked fields.
• HoltWinters() reports a warning rather than an error for some
optimization failures (where the answer might be a reasonable
one).
• tools::dependsOnPkg() now accepts the shorthand dependencies =
"all".
• parallel::clusterExport() now allows specification of an
environment from which to export.
• The quartz() device now does tilde expansion on its file
argument.
• tempfile() on a Unix-alike now takes the process ID into account.
This is needed with multicore (and as part of parallel) because
the parent and all the children share a session temporary
directory, and they can share the C random number stream used to
produce the unique part. Further, two children can call
tempfile() simultaneously.
• Option print in Sweave's RweaveLatex() driver now emulates
auto-printing rather than printing (which can differ for an S4
object by calling show() rather than print()).
• filled.contour() now accepts infinite values: previously it might
have generated invalid graphics files (e.g. containing NaN
values).
INSTALLATION:
• On 64-bit Linux systems, configure now only sets LIBnn to lib64
if /usr/lib64 exists. This may obviate setting LIBnn explicitly
on Debian-derived systems.
It is still necessary to set LIBnn = lib (or lib32) for 32-bit
builds of R on a 64-bit OS on those Linux distributions capable
for supporting that concept.
• configure looks for inconsolata.sty, and if not found adjusts the
default R_RD4PDF to not use it (with a warning, since it is
needed for high-quality rendering of manuals).
PACKAGE INSTALLATION:
• R CMD INSTALL will now do a test load for all sub-architectures
for which code was compiled (rather than just the primary
sub-architecture).
UTILITIES:
• When checking examples under more than one sub-architecture, R
CMD check now uses a separate directory examples_arch for each
sub-architecture, and leaves the output in file
pkgname-Ex_arch.Rout. Some packages expect their examples to be
run in a clean directory ....
BUG FIXES:
• stack() now gives an error if no vector column is selected,
rather than returning a 1-column data frame (contrary to its
documentation).
• summary.mlm() did not handle objects where the formula had been
specified by an expression. (Reported by Helios de Rosario
Martinez).
• tools::deparseLatex(dropBraces=TRUE) could drop text as well as
braces.
• colormodel = "grey" (new in R 2.14.0)) did not always work in
postscript() and pdf().
• file.append() could return TRUE for failures. (PR#14727)
• gzcon() connections are no longer subject to garbage collection:
it was possible for this to happen when unintended (e.g. when
calling load()).
• nobs() does not count zero-weight observations for glm() fits,
for consistency with lm(). This affects the BIC() values
reported for such glm() fits. (Spotted by Bill Dunlap.)
• options(warn = 0) failed to end a (C-level) context with more
than 50 accumulated warnings. (Spotted by Jeffrey Horner.)
• The internal plot.default() code did not do sanity checks on a
cex argument, so invalid input could cause problems. (Reported
by Ben Bolker.)
• anyDuplicated(<array>, MARGIN=0) no longer fails. (Reported by
Hervé Pagès.)
• read.dcf() removes trailing blanks: unfortunately on some
platforms this included \xa0 (non-breaking space) which is the
trailing byte of a UTF-8 character. It now only considers ASCII
space and tab to be ‘blank’.
• There was a sign error in part of the calculations for the
variance returned by KalmanSmooth(). (PR#14738)
• pbinom(10, 1e6, 0.01, log.p = TRUE) was NaN thanks to the buggy
fix to PR#14320 in R 2.11.0. (PR#14739)
• RweaveLatex() now emulates auto-printing rather than printing, by
calling methods::show() when auto-printing would.
• duplicated() ignored fromLast for a one-column data frame.
(PR#14742)
• source() and related functions did not put the correct timestamp
on the source references; srcfilecopy() has gained a new argument
timestamp to support this fix. (PR#14750)
• srcfilecopy() has gained a new argument isFile and now records
the working directory, to allow debuggers to find the original
source file. (PR#14826)
• LaTeX conversion of Rd files did not correctly handle
preformatted backslashes. (PR#14751)
• HTML conversion of Rd files did not handle markup within tabular
cells properly. (PR#14708)
• source() on an empty file with keep.source = TRUE tried to read
from stdin(), in R 2.14.0 only. (PR#14753)
• The code to check Rd files in packages would abort if duplicate
description sections were present.
CHANGES IN R VERSION 2.14.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• All packages must have a namespace, and one is created on
installation if not supplied in the sources. This means that any
package without a namespace must be re-installed under this
version of R (but previously-installed data-only packages without
R code can still be used).
• The yLineBias of the X11() and windows() families of devices has
been changed from 0.1 to 0.2: this changes slightly the vertical
positioning of text in the margins (including axis annotations).
This is mainly for consistency with other devices such as
quartz() and pdf(). (Wish of PR#14538.)
There is a new graphics parameter "ylbias" which allows the
y-line bias of the graphics device to be tweaked, including to
reproduce output from earlier versions of R.
• Labeling of the p-values in various anova tables has been
rationalized to be either "Pr(>F)" or "Pr(>Chi)" (i.e. the
"Pr(F)", "Pr(Chi)" and "P(>|Chi|)" variants have been
eliminated). Code which extracts the p value _via_ indexing by
name may need adjustment.
• :: can now be used for datasets made available for lazy-loading
in packages with namespaces (which makes it consistent with its
use for data-only packages without namespaces in earlier versions
of R).
• There is a new package parallel.
It incorporates (slightly revised) copies of packages multicore
and snow (excluding MPI, PVM and NWS clusters). Code written to
use the higher-level API functions in those packages should work
unchanged (apart from changing any references to their namespaces
to a reference to parallel, and links explicitly to multicore or
snow on help pages).
It also contains support for multiple RNG streams following
L'Ecuyer _et al_ (2002), with support for both mclapply and snow
clusters. This replaces functions like clusterSetupRNG() from
snow (which are not in parallel).
The version released for R 2.14.0 contains base functionality:
higher-level convenience functions are planned (and some are
already available in the ‘R-devel’ version of R).
• Building PDF manuals (for R itself or packages, e.g. _via_ R CMD
check) by default requires the LaTeX package inconsolata: see the
section on ‘Making the manuals’ in the ‘R Installation and
Administration Manual’.
• axTicks(*, log=TRUE) has changed in some cases to satisfy the
documented behavior and be consistent.
NEW FEATURES:
• txtProgressBar() can write to an open connection instead of the
console.
• Non-portable package names ending in . are no longer allowed.
Nor are single-character package names (R was already
disallowed).
• regexpr() and gregexpr() with perl = TRUE allows Python-style
named captures. (Wish and contribution of PR#14518.)
• The placement of ‘plotmath’ text in the margins of plots done by
base graphics now makes the same vertical adjustment as ordinary
text, so using ordinary and plotmath text on the same margin line
will seem better aligned (but not exactly aligned, since ordinary
text has descenders below the baseline and plotmath places them
on the baseline). (Related to PR#14537.)
• sunflowerplot() now has a formula interface. (Wish of PR#14541.)
• iconv() has a new argument toRaw to handle encodings such as
UTF-16 with embedded nuls (as was possible before the CHARSXP
cache was introduced).
It will also accept as input the type of list generated with
toRaw = TRUE.
• Garbage-collecting an unused input text connection no longer
gives a warning (since it ‘connects’ to nothing outside R).
• read.table() and scan() have gained a text argument, to allow
reading data from a (possibly literal) character string.
• optim(*, method = .) now allows method = "Brent" as an interface
to optimize(), for use in cases such as mle() where optim() is
used internally.
• mosaicplot() gains a border argument. (Wish of PR#14550.)
• smooth.spline() gains a tol argument which controls how different
x values need to be to be treated as distinct. The default has
been changed to be more reliable for inputs whose range is small
compared to their maximum absolute value. (Wish of PR#14452.)
• gl() runs faster by avoiding calling factor().
• The print() method for object.size() accepts B as well as b as an
abbreviation for ‘bytes’.
• unlink() gains a force argument to work like rm -f and if
possible override restrictive permissions.
• pbirthday() and qbirthday() now use exact calculations for
coincident = 2.
• unzip() and unz() connections have been updated with support for
more recent Zip64 features (including large file sizes and bzip2
compression, but not UTF-8 file names).
unzip() has a new option to restore file times from those
recorded (in an unknown timezone) in the zip file.
• update.packages() now accepts a character vector of package names
for the oldPkgs argument. (Suggestion of Tal Galili.)
• The special reference class fields .self and .refClassDef are now
read-only to prevent corrupting the object.
• decompose() now returns the original series as part of its value,
so it can be used (rather than reconstructed) when plotting.
(Suggestion of Rob Hyndman.)
• Rao's efficient score test has been implemented for glm objects.
Specifically, the add1, drop1, and anova methods now allow test =
"Rao".
• If a saved workspace (e.g. .RData) contains objects that cannot
be loaded, R will now start with an warning message and an empty
workspace, rather than failing to start.
• strptime() now accepts times such as 24:00 for midnight at the
end of the day, for although these are disallowed by POSIX
1003.1-2008, ISO 8601:2004 allows them.
• Assignment of names() to S4 objects now checks for a
corresponding "names" slot, and generates a warning or an error
if that slot is not defined. See the section on slots in
?Classes.
• The default methods for is.finite(), is.infinite() and is.nan()
now signal an error if their argument is not an atomic vector.
• The formula method for plot() no longer places package stats on
the search path (it loads the namespace instead).
• There now is a genuine "function" method for plot() rather than
the generic dispatching internally to graphics::plot.function().
It is now exported, so can be called directly as plot.function().
• The one-sided ks.test() allows exact = TRUE to be specified in
the presence of ties (but the approximate calculation remains the
default: the ‘exact’ computation makes assumptions known to be
invalid in the presence of ties).
• The behaviour of curve(add = FALSE) has changed: it now no longer
takes the default x limits from the previous plot (if any):
rather they default to c(0, 1) just as the "function" method for
plot(). To get the previous behaviour use curve(add = NA), which
also takes the default for log-scaling of the x-axis from the
previous plot.
• Both curve() and the plot() method for functions have a new
argument xname to facilitate plots such as sin(t) _vs_ t.
• The local argument to source() can specify an environment as well
as TRUE (parent.env()) and FALSE (.GlobalEnv). It gives better
error messages for other values, such as NA.
• vcov() gains methods for classes "summary.lm" and "summary.glm".
• The plot() method for class "profile.nls" gains ylab and lty
arguments, and passes ... on to plot.default.
• Character-string arguments such as the mode argument of vector(),
as.vector() and is.vector() and the description argument of
file() are required to be of length exactly one, rather than any
further elements being silently discarded. This helps catch
incorrect usage in programming.
• The length argument of vector() and its wrappers such as
numeric() is required to be of length exactly one (other values
are now an error rather than giving a warning as previously).
• vector(len) and length(x) <- len no longer accept TRUE/FALSE for
len (not that they were ever documented to, but there was
special-casing in the C code).
• There is a new function Sys.setFileTime() to set the time of a
file (including a directory). See its help for exactly which
times it sets on various OSes.
• The file times reported by file.info() are reported to sub-second
resolution on systems which support it. (Currently the POSIX
2008 and FreeBSD/Darwin/NetBSD methods are detected.)
• New function getCall(m) as an abstraction for m$call, enabling
update()'s default method to apply more universally. (NB: this
can be masked by existing functions in packages.)
• Sys.info() gains a euser component to report the ‘effective’ user
on OSes which have that concept.
• The result returned by try() now contains the original error
condition object as the "condition" attribute.
• All packages with R code are lazy-loaded irrespective of the
LazyLoad field in the DESCRIPTION file. A warning is given if
the LazyLoad field is overridden.
• Rd markup has a new \figure tag so that figures can be included
in help pages when converted to HTML or LaTeX. There are
examples on the help pages for par() and points().
• The built-in httpd server now allows access to files in the
session temporary directory tempdir(), addressed as the /session
directory on the httpd server.
• Development versions of R are no longer referred to by the number
under which they might be released, e.g. in the startup banner, R
--version and sessionUtils(). The correct way to refer to a
development version of R is ‘R-devel’, preferably with the date
and SVN version number.
E.g. R-devel (2011-07-04 r56266)
• There is a new function texi2pdf() in package tools, currently a
convenience wrapper for texi2dvi(pdf = TRUE).
• There are two new options for typesetting PDF manuals from Rd
files. These are beramono and inconsolata, and used the named
font for monospaced output. They are intended to be used in
combination with times, and times,inconsolata,hyper is now the
default for the reference manual and package manuals. If you do
not have that font installed, you can set R_RD4PF to one of the
other options: see the ‘R Installation and Administration
Manual’.
• Automatic printing for reference classes is now done by the
$show() method. A method is defined for class envRefClass and
may be overridden for user classes (see the ?ReferenceClasses
example). S4 show() methods should no longer be needed for
reference classes.
• tools::Rdiff (by default) and R CMD Rdiff now ignore differences
in pointer values when comparing printed environments, compiled
byte code, etc.
• The "source" attribute on functions created with keep.source=TRUE
has been replaced with a "srcref" attribute. The "srcref"
attribute references an in-memory copy of the source file using
the "srcfilecopy" class or the new "srcfilealias" class.
*NB:* This means that functions sourced with keep.source = TRUE
and saved (e.g., by save() or readRDS()) in earlier versions of R
will no longer show the original sources (including comments).
• New items User Manuals and Technical Papers have been added to
the HTML help main page. These link to vignettes in the base and
recommended packages and to a collection of papers about R
issues, respectively.
• Documentation and messages have been standardized to use
“namespace” rather than “name space”.
• setGeneric() now looks in the default packages for a non-generic
version of a function if called from a package with a namespace.
(It always did for packages without a namespace.)
• Setting the environment variable _R_WARN_ON_LOCKED_BINDINGS_ will
give a warning if an attempt is made to change a locked binding.
• \SweaveInput is now supported when generating concordances in
Sweave().
• findLineNum() and setBreakpoint() now allow the environment to be
specified indirectly; the latter gains a clear argument to allow
it to call untrace().
• The body of a closure can be one of further types of R objects,
including environments and external pointers.
• The Rd2HTML() function in package tools now has a stylesheet
argument, allowing pages to be displayed in alternate formats.
• New function requireNamespace() analogous to require(), returning
a logical value after attempting to load a namespace.
• There is a new type of RNG, "L'Ecuyer-CMRG", implementing
L'Ecuyer (1999)'s ‘combined multiple-recursive generator’
MRG32k3a. See the comments on ?RNG.
• help.search() and ?? can now display vignettes and demos as well
as help pages. The new option "help.search.types" controls the
types of documentation and the order of their display.
This also applies to HTML searches, which now give results in all
of help pages, vignettes and demos.
• socketConnection() now has a timeout argument. It is now
documented that large values (package snow used a year) do not
work on some OSes.
• The initialization of the random-number generator now uses the
process ID as well as the current time, just in case two R
processes are launched very rapidly on a machine with
low-resolution wall clock (some have a resolution of a second;
modern systems have microsecond-level resolution).
• New function pskill() in the tools package to send a terminate
signal to one or more processes, plus constants such as SIGTERM
to provide a portable way to refer to signals (since the numeric
values are OS-dependent).
• New function psnice() in the tools package to return or change
the ‘niceness’ of a process. (Refers to the ‘priority class’ on
Windows.)
• list.dirs() gains a recursive argument.
• An Authors@R field in a package DESCRIPTION file can now be used
to generate Author and Maintainer fields if needed, and to
auto-generate package citations.
• New utility getElement() for accessing either a list component or
a slot in an S4 object.
• stars() gains a col.lines argument, thanks to Dustin Sallings.
(Wish of PR#14657.)
• New function regmatches() for extracting or replacing matched or
non-matched substrings from match data obtained by regexpr(),
gregexpr() and regexec().
• help(package = "pkg_name", help_type = "HTML") now gives HTML
help on the package rather than text help. (This gives direct
access to the HTML version of the package manual shown _via_
help.start()'s ‘Packages’ menu.)
• agrep() gains a fixed argument to optionally allow approximate
regular expression matching, and a costs argument to specify
possibly different integer match costs for insertions, deletions
and substitutions.
• read.dcf() and write.dcf() gain a keep.white argument to indicate
fields where whitespace should be kept as is.
• available.packages() now works around servers that fail to return
an error code when PACKAGES.gz does not exist. (Patch submitted
by Seth Schommer.)
• readBin() can now read more than 2^31 - 1 bytes in a single call
(the previously documented limitation).
• New function regexec() for finding the positions of matches as
well as all substrings corresponding to parenthesized
subexpressions of the given regular expression.
• New function adist() in package utils for computing ‘edit’
(generalized Levenshtein) distances between strings.
• Class "raster" gains an is.na method to avoid confusion from the
misuse of the matrix method (such as PR#14618).
• The identical() function gains an ignore.bytecode argument to
control comparison of compiled functions.
• pmin and pmax now warn if an argument is partially recycled (wish
of PR#14638).
• The default for image(useRaster=) is now taken from option
"preferRaster": for the small print see ?image.
• str() now displays reference class objects and their fields,
rather than treating them as classical S4 classes.
• New function aregexec() in package utils for finding the
positions of approximate string matches as well as all substrings
corresponding to parenthesized subexpressions of the given
regular expression.
• download.file() has an extra argument to pass additional
command-line options to the non-default methods using
command-line utilities.
cacheOK = FALSE is now supported for method = "curl".
• interaction.plot(*, type = .) now also allows type "o" or "c".
• axTicks(*, log=TRUE) did sometimes give more values than the
ticks in the corresponding graphics::axis(). By default, it now
makes use of the new (graphics-package independent) axisTicks()
which can make use of a new utility .axisPars(). Further, it now
returns a decreasing sequence (as for log=FALSE) when usr is
decreasing.
• Using fix() or edit() on a R object (except perhaps a matrix or
data frame) writes its temporary file with extension .R so
editors which select their mode based on the extension will
select a suitable mode.
GRAPHICS DEVICES:
• The pdf() device makes use of Flate compression: this is
controlled by the new logical argument compress, and is enabled
by default.
• Devices svg(), cairo_pdf() and cairo_ps() gain a family argument.
On a Unix-alike X11() gains a family argument. This is one of
the x11.options() and so can be passed as an argument to the
bmp(), jpeg(), png() and tiff() devices.
Analogous changes have been made on Windows, so all built-in R
graphics devices now have a family argument except pictex()
(which has no means to change fonts).
• The bmp(), jpeg(), png() and tiff() devices now make use of the
antialias argument for type = "quartz".
• There are several new built-in font mappings for X11(type =
"Xlib"): see the help on X11Fonts().
• There is a new type X11(type = "dbcairo") which updates the
screen less frequently: see its help page.
• The X11() device now makes use of cursors to distinguish its
states. The normal cursor is an arrow (rather than a crosshair);
the crosshair is used when the locator is in use, and a watch
cursor is shown when plotting computations are being done.
(These are the standard names for X11 cursors: how they are
actually displayed depends on the window manager.)
• New functions dev.hold() and dev.flush() for use with graphics
devices with buffering. These are used for most of the
high-level graphics functions such as boxplot(), so that the plot
is only displayed when the page is complete.
Currently implemented for windows(buffered = TRUE), quartz() and
the cairographics-based X11() types with buffering (which are the
default on-screen devices).
• New function dev.capture() for capture of bitmap snapshots of
image-based devices (a superset of the functionality provided by
grid.cap() in grid).
• The default colormodel for pdf() and postscript() is now called
"srgb" to more accurately describe it. (Instead of "rgb", and in
the case of postscript() it no longer switches to and from the
gray colorspace, by default.)
The colormodel for postscript() which does use both gray and sRGB
colorspaces is now called "srgb+gray".
Plots which are known to use only black/white/transparent can
advantageously use colormodel = "gray" (just as before, but there
is now slightly more advantage in doing so).
• postscript() with values colormodel = "rgb" and colormodel =
"rgb-nogray" give the behaviour prior to R 2.13.0 of uncalibrated
RGB, which under some circumstances can be rendered much faster
by a viewer.
pdf(colormodel = "rgb") gives the behaviour prior to R 2.13.0 of
uncalibrated RGB, which under some circumstances can be rendered
faster by a viewer, and the files will be smaller (by about 9KB
if compression is not used).
• The postscript() device only includes the definition of the sRGB
colorspace in the output file for the colormodels which use it.
• The postscript() and pdf() devices now output greyscale raster
images (and not RGB) when colormodel = "gray".
• postscript(colormodel = "gray") now accepts non-grey colours and
uses their luminance (as pdf() long has).
• colormodel = "grey" is allowed as an alternative name for
postscript() and pdf().
• pdf() in the default sRGB colorspace outputs many fewer changes
of colorspace, which may speed up rendering in some viewing
applications.
• There is a new function dev.capabilities() to query the
capabilities of the current device. The initial set of
capabilities are support for semi-transparent colours, rendering
and capturing raster images, the locator and for interactive
events.
• For pdf(), maxRasters is increased as needed so the argument is
no longer used.
SWEAVE & VIGNETTES:
• Options keep.source = TRUE, figs.only = FALSE are now the
default.
• The way the type of user-defined options is determined has
changed. Previously they were all regarded as logical: now the
type is determined by the value given at first use.
• The allowed values of logical options are now precisely those
allowed for character inputs to as.logical(): this means that t
and f are no longer allowed (although T and F still are).
• The preferred location for vignette sources is now the directory
vignettes and not inst/doc: R CMD build will now re-build
vignettes in directory vignettes and copy the .Rnw (etc) files
and the corresponding PDFs to inst/doc. Further files to be
copied to inst/doc can be specified _via_ the file
vignettes/.install_extras.
• R CMD Sweave now supports a --driver option to select the Sweave
driver: the default is equivalent to --driver=RweaveLatex.
• R CMD Sweave and R CMD Stangle support options --encoding and
--options.
• The Rtangle() driver allows output = "stdout" or output =
"stderr" to select the output or message connection. This is
convenient for scripting using something like
R CMD Stangle --options='output="stdout"' foo.Rnw > foo2.R
• There is a new option pdf.compress controlling whether PDF
figures are generated using Flate compression (they are by
default).
• R CMD Sweave now has a --pdf option to produce a PDF version of
the processed Sweave document.
• It is no longer allowed to have two vignettes with the same
vignette basename (e.g. vig.Rnw and vig.Snw). (Previously one
vignette hid the other in the vignette() function.)
C-LEVEL FACILITIES:
• Function R_tmpnam2 has been added to the API to allow a temporary
filename to include a specified extension.
PACKAGE INSTALLATION:
• Package DESCRIPTION file field KeepSource forces the package to
be installed with keep.source = TRUE (or FALSE). (Suggestion of
Greg Snow. Note that as all packages are lazy-loaded, this is
now only relevant at installation.)
There are corresponding options --with-keep.source and
--without-keep.source for R CMD INSTALL.
• R CMD INSTALL has a new option --byte-compile to byte-compile the
packages during installation (since all packages are now
lazy-loaded). This can be controlled on a per-package basis by
the optional field ByteCompile in the DESCRIPTION file.
• A package R code but without a NAMESPACE file will have a default
one created at R CMD build or R CMD INSTALL time, so all packages
will be installed with namespaces. A consequence of this is that
.First.lib() functions need to be copied to .onLoad() (usually)
or .onAttach(). For the time being, if there is an
auto-generated NAMESPACE file and no .onLoad() nor .onAttach()
function is found but .First.lib() is, it will be run as the
attach hook (unless the package is one of a list of known
exceptions, when it will be run as the load hook).
• A warning is given if test-loading a package changes a locked
binding in a package other than itself. It is likely that this
will be disallowed in future releases. (There are _pro tem_ some
exceptions to the warning.)
• A dependency on SVN revision is allowed for R, e.g. R (>=
r56550). This should be used in conjunction with a version
number, e.g. R (>= 2.14.0), R (>= r56550) to distinguish between
R-patched and R-devel versions with the same SVN revision.
• installed.packages() now hashes the names of its cache files to
avoid very rare problems with excessively long path names.
(PR#14669)
• A top-level COPYING file in a package is no longer installed
(file names LICENSE or LICENCE having long been preferred).
UTILITIES:
• R CMD check now gives an error if the R code in a vignette fails
to run, unless this is caused by a missing package.
• R CMD check now unpacks tarballs in the same way as R CMD
INSTALL, including making use of the environment variable
R_INSTALL_TAR to override the default behaviour.
• R CMD check performs additional code analysis of package startup
functions, and notifies about incorrect argument lists and
(incorrect) calls to functions which modify the search path or
inappropriately generate messages.
• R CMD check now also checks compiled code for symbols
corresponding to functions which might terminate R or write to
stdout/stderr instead of the console.
• R CMD check now uses a pdf() device when checking examples
(rather than postscript()).
• R CMD check now checks line-endings of makefiles and
C/C++/Fortran sources in subdirectories of src as well as in src
itself.
• R CMD check now reports as a NOTE what look like methods
documented with their full names even if there is a namespace and
they are exported. In almost all cases they are intended to be
used only as methods and should use the \method markup. In the
other rare cases the recommended form is to use a function such
as coefHclust which would not get confused with a method,
document that and register it in the NAMESPACE file by
s3method(coef, hclust, coefHclust).
• The default for the environment variable _R_CHECK_COMPACT_DATA2_
is now true: thus if using the newer forms of compression
introduced in R 2.10.0 would be beneficial is now checked (by
default).
• Reference output for a vignette can be supplied when checking a
package by R CMD check: see ‘Writing R Extensions’.
• R CMD Rd2dvi allows the use of LaTeX package inputenx rather than
inputenc: the value of the environment variable RD2DVI_INPUTENC
is used. (LaTeX package inputenx is an optional install which
provides greater coverage of the UTF-8 encoding.)
• Rscript on a Unix-alike now accepts file names containing spaces
(provided these are escaped or quoted in the shell).
• R CMD build on a Unix-alike (only) now tries to preserve dates on
files it copies from its input directory. (This was the
undocumented behaviour prior to R 2.13.0.)
DEPRECATED AND DEFUNCT:
• require() no longer has a save argument.
• The gamma argument to hsv(), rainbow(), and rgb2hsv() has been
removed.
• The --no-docs option for R CMD build --binary is defunct: use
--install-args instead.
• The option --unsafe to R CMD INSTALL is defunct: use the
identical option --no-lock instead.
• The entry point pythag formerly in Rmath.h is defunct: use
instead the C99 function hypot.
• R CMD build --binary is formally defunct: R CMD INSTALL --build
has long been the preferred alternative.
• zip.file.extract() is now defunct: use unzip() or unz() instead.
• R CMD Rd2dvi without the --pdf option is now deprecated: only PDF
output will be supported in future releases (since this allows
the use of fonts only supported for PDF), and only R CMD Rd2pdf
will be available.
• Options such as --max-nsize and the function mem.limits() are now
deprecated: these limits are nowadays almost never used, and are
reported by gc() when they are in use.
• Forms like binomial(link = "link") for GLM families deprecated
since R 2.4.0 are now defunct.
• The declarativeOnly argument to loadNamespace() (not relevant
since R 2.13.0) has been removed.
• Use of library.dynam() without specifying all the first three
arguments is deprecated. (It is often called from a namespace,
and the defaults are only appropriate to a package.)
Use of chname in library.dynam() with the extension .so or .dll
(which is clearly not allowed according to the help page) is
deprecated. This also applies to library.dynam.unload() and
useDynLib directives in NAMESPACE files.
• It is deprecated to use mean(x) and sd(x) directly on data frames
(or also matrices, for sd) x, instead of simply using sapply.
In the same spirit, median(x) now gives an error for a data frame
x (it often gave nonsensical results).
• The keep.source argument to library() and require() is
deprecated: it was only used for packages installed without
lazy-loading, and now all packages are lazy-loaded.
• Using a false value for the DESCRIPTION field LazyLoad is
deprecated.
INSTALLATION:
• The base and recommended packages are now byte-compiled
(equivalent to make bytecode in R 2.13.x).
• Configure option --with-system-zlib now only makes use of the
basic interface of zlib and not the C function gzseek which has
shown erroneous behaviour in zlib 1.2.4 and 1.2.5.
• The zlib in the R sources is now version 1.2.5. (This is safe
even on 32-bit Linux systems because only the basic interface is
now used.)
• The .afm files in package grDevices are now installed as
compressed files (as long done on Windows), saving ca 2MB on the
installed size.
• The non-screen cairo-based devices are no longer in the X11
module and so can be installed without X11. (We have never seen
a Unix-alike system with cairographics installed but not X11, but
a user might select --without-x.)
• Configure will try to use -fobjc-exceptions for the Objective-C
compiler (if present) to ensure that even compilers that do not
enable exceptions by default (such as vanilla gcc) can be used.
(Objective-C is currently only used on Mac OS X.)
• The system call times is required.
• The C99 functions acosh, asinh, atanh, snprintf and vsnprintf are
now required.
• There is no longer support for making DVI manuals _via_ make dvi,
make install-dvi and similar. Only PDF manuals are supported (to
allow the use of fonts which are only available for PDF.)
• The configure arguments used during configuration of R are
included as a comment in Makeconf for informative purposes on
Unix-alikes in a form suitable for shell execution. Note that
those are merely command-line arguments, they do not include
environment variables (one more reason to use configure variables
instead) or site configuration settings.
• Framework installation now supports DESTDIR (Mac OS X only).
• Java detection (R CMD javareconf) works around bogus
java.library.path property in recent Oracle Java binaries.
BUG FIXES:
• The locale category LC_MONETARY was only being set on startup on
Windows: that is now done on Unix-alikes where supported.
• Reference class utilities will detect an attempt to modify
methods or fields in a locked class definition (e.g., in a
namespace) and generate an error.
• The formula methods for lines(), points() and text() now work
even if package stats is not on the search path.
• In principle, S4 classes from different packages could have the
same name. This has not previously worked. Changes have now
been installed that should allow such classes and permit methods
to use them. New functions className() and multipleClasses() are
related tools for programming.
• Work around an issue in Linux (a system select call resetting tv)
which prevented internet operations from timing out properly.
• Several stack trampling and overflow issues have been fixed in
TRE, triggered by agrep and friends with long patterns.
(PR#14627)
• (“design infelicity”) Field assignments in reference classes are
now consistent with slots in S4 classes: the assigned value must
come from the declared class (if any) for the field or from a
subclass.
• The methods objects constructed for "coerce" and "coerce<-" were
lacking some essential information in the generic, defined and
target slots; as() did not handle duplicate class definitions
correctly.
• The parser no longer accepts the digit 8 in an octal character
code in a string, nor does it accept unterminated strings in a
file. (Reported by Bill Dunlap.)
• The print() method for class "summary.aov" did not pass on
argument digits when summary() was called on a single object, and
hence used more digits than documented.
• The X11() device's cairo back-end produced incorrect capture
snapshot images on big-endian machines.
• loglin() gave a spurious error when argument margin consisted of
a single element of length one. (PR#14690)
• loess() is better protected against misuse, e.g. zero-length
span. (PR#14691)
• HoltWinters() checks that the optimization succeeded. (PR#14694)
• The (undocumented) inclusion of superclass objects in default
initializing of reference classes overwrote explicit field
arguments. The bug is fixed, the feature documented and a test
added.
• round(x, -Inf) now does something sensible (return zero rather
than NA).
• signif(x, -Inf) now behaves as documented (signif(x, 1)) rather
than giving zero.
• The "table" method for Axis() hardcoded side = 1, hence calls to
plot(<vector>, <table>) labelled the wrong axis. (PR#14699)
• Creating a connection might fail under gctorture(TRUE).
• stack() and unstack() converted character columns to factors.
unstack() sometimes produced incorrect results (a list or a
vector) if the factor on which to un-split had only one level.
• On some systems help(".C", help_type = "pdf") and similar
generated file names that TeX was unable to handle.
• Non-blocking listening socket connections continued to report
isIncomplete() as true even when the peer had closed down and all
available input had been read.
• The revised HTML search system now generates better hyperlinks to
help topics found: previously it gave problems with help pages
with names containing e.g. spaces and slashes.
• A late change in R 2.13.2 broke \Sexpr expressions in Rd files.
• The creation of ticks on log axes (including by axTicks())
sometimes incorrectly omitted a tick at one end of the range by
rounding error in a platform-dependent way. This could be seen
in the examples for axTicks(), where with axis limits c(0.2, 88)
the tick for 0.2 was sometimes omitted.
• qgamma() for small shape underflows to 0 rather than sometimes
giving NaN. (PR#8528, PR#14710)
• mapply() now gives an explicit error message (rather than an
obscure one) if inputs of zero and positive length are mixed.
• Setting a Hershey font family followed by string height query
would crash R.
• R CMD javareconf -e would fail for some shells due to a shift
error. Also the resulting paths will no longer contain
$(JAVA_HOME) as that can result in an unintended substitution
based on Makeconf instead of the shell setting.
CHANGES IN R VERSION 2.13.2:
NEW FEATURES:
• mem.limits() now reports values larger than the maximum integer
(previously documented to be reported as NA), and allows larger
values to be set, including Inf to remove the limit.
• The print() methods for classes "Date", "POSIXct" and "POSIXlt"
respect the option "max.print" and so are much faster for very
long datetime vectors. (Suggestion of Yohan Chalabi.)
• untar2() now works around errors generated with tar files that
use more than the standard 6 digits for the checksum. (PR#14654)
• install.packages() with Ncpus > 1 guards against simultaneous
installation of indirect dependencies as well as direct ones.
• Sweave now knows about a few more Windows' encodings (including
cp1250 and cp1257) and some inputenx encodings such as koi8-r.
• postscript(colormodel = "rgb-nogray") no longer sets the sRGB
colorspace for each colour and so some viewers may render its
files much faster than the default colormodel ="rgb".
• The default for pdf(maxRasters=) has been increased from 64 to
1000.
• readBin() now warns if signed = FALSE is used inappropriately
(rather than being silently ignored).
It enforces the documented limit of 2^31-1 bytes in a single
call.
• PCRE has been updated to version 8.13, a bug-fix release with
updated Unicode tables (version 6.0.0). An additional patch
(r611 from PCRE 8.20-to-be) has been added to fix a collation
symbol recognition issue.
INSTALLATION:
• It is possible to build in src/extra/xdr on more platforms.
(Needed since glibc 2.14 hides its RPC implementation.)
• configure will find the Sun TI-RPC implementation of xdr (in
libtirpc) provided its header files are in the search path: see
the ‘R Installation and Administration Manual’.
PACKAGE INSTALLATION:
• Using a broad exportPattern directive in a NAMESPACE file is no
longer allowed to export internal objects such as .onLoad and
.__S3MethodsTable__. .
These are also excluded from imports, along with .First.lib.
BUG FIXES:
• fisher.test() had a buglet: If arguments were factors with unused
levels, levels were dropped and you would get an error saying
that there should be at least two levels, inconsistently with
pre-tabulated data. (Reported by Michael Fay).
• package.skeleton() will no longer dump S4 objects supplied
directly rather than in a code file. These cannot be restored
correctly from the dumped version.
• Build-time expressions in help files did not have access to
functions in the package being built (with R CMD build).
• Because quote() did not mark its result as being in use,
modification of the result could in some circumstances modify the
original call.
• Plotting pch = '.' now guarantees at least a one-pixel dot if cex
> 0.
• The very-rarely-used command-line option --max-vsize was
incorrectly interpreted as a number of Vcells and not in bytes as
documented. (Spotted by Christophe Rhodes.)
• The HTML generated by Rd2HTML() comes closer to being standards
compliant.
• filter(x, recursive = TRUE) gave incorrect results on a series
containing NAs. (Spotted by Bill Dunlap.)
• Profiling stats::mle() fits with a fixed parameter was not
supported. (PR#14646)
• retracemem() was still using positional matching. (PR#14650)
• The quantile method for "ecdf" objects now works and is
documented.
• xtabs(~ .., ..., sparse=TRUE) now also works together with an
exclude = .. specification.
• decompose() computed an incorrect seasonal component for time
series with odd frequencies.
• The pdf() device only includes the definition of the sRGB
colorspace in the output file for the "rgb" colormodel (and not
for "gray" nor "cmyk"): this saves ca 9KB in the output file.
• .hasSlot() wrongly gave FALSE in some cases.
• Sweave() with keep.source=TRUE could generate spurious NA lines
when a chunk reference appeared last in a code chunk.
• \Sexpr[results=rd] in an .Rd file now first tries
parse_Rd(fragment=FALSE) to allow Rd section-level macros to be
inserted.
• The print() method for class "summary.aov" did not pass on
arguments such as signif.stars when summary() was called on a
single object. (PR#14684)
• In rare cases ks.test() could return a p-value very slightly less
than 0 by rounding error. (PR#14671)
• If trunc() was called on a "POSIXlt" vector and the result was
subsetted, all but the first element was converted to NA.
(PR#14679)
• cbind() and rbind() could cause memory corruption when used on a
combination of raw and logical/integer vectors.
CHANGES IN R VERSION 2.13.1:
NEW FEATURES:
• iconv() no longer translates NA strings as "NA".
• persp(box = TRUE) now warns if the surface extends outside the
box (since occlusion for the box and axes is computed assuming
the box is a bounding box). (PR#202)
• RShowDoc() can now display the licences shipped with R, e.g.
RShowDoc("GPL-3").
• New wrapper function showNonASCIIfile() in package tools.
• nobs() now has a "mle" method in package stats4.
• trace() now deals correctly with S4 reference classes and
corresponding reference methods (e.g., $trace()) have been added.
• xz has been updated to 5.0.3 (very minor bugfix release).
• tools::compactPDF() gets more compression (usually a little,
sometimes a lot) by using the compressed object streams of PDF
1.5.
• cairo_ps(onefile = TRUE) generates encapsulated EPS on platforms
with cairo >= 1.6.
• Binary reads (e.g. by readChar() and readBin()) are now supported
on clipboard connections. (Wish of PR#14593.)
• as.POSIXlt.factor() now passes ... to the character method
(suggestion of Joshua Ulrich). [Intended for R 2.13.0 but
accidentally removed before release.]
• vector() and its wrappers such as integer() and double() now warn
if called with a length argument of more than one element. This
helps track down user errors such as calling double(x) instead of
as.double(x).
INSTALLATION:
• Building the vignette PDFs in packages grid and utils is now part
of running make from an SVN checkout on a Unix-alike: a separate
make vignettes step is no longer required.
These vignettes are now made with keep.source = TRUE and hence
will be laid out differently.
• make install-strip failed under some configuration options.
• Packages can customize non-standard installation of compiled code
via a src/install.libs.R script. This allows packages that have
architecture-specific binaries (beyond the package's shared
objects/DLLs) to be installed in a multi-architecture setting.
SWEAVE & VIGNETTES:
• Sweave() and Stangle() gain an encoding argument to specify the
encoding of the vignette sources if the latter do not contain a
\usepackage[]{inputenc} statement specifying a single input
encoding.
• There is a new Sweave option figs.only = TRUE to run each figure
chunk only for each selected graphics device, and not first using
the default graphics device. This will become the default in R
2.14.0.
• Sweave custom graphics devices can have a custom function
foo.off() to shut them down.
• Warnings are issued when non-portable filenames are found for
graphics files (and chunks if split = TRUE). Portable names are
regarded as alphanumeric plus hyphen, underscore, plus and hash
(periods cause problems with recognizing file extensions).
• The Rtangle() driver has a new option show.line.nos which is by
default false; if true it annotates code chunks with a comment
giving the line number of the first line in the sources (the
behaviour of R >= 2.12.0).
• Package installation tangles the vignette sources: this step now
converts the vignette sources from the vignette/package encoding
to the current encoding, and records the encoding (if not ASCII)
in a comment line at the top of the installed .R file.
LICENCE:
• No parts of R are now licensed solely under GPL-2. The licences
for packages rpart and survival have been changed, which means
that the licence terms for R as distributed are GPL-2 | GPL-3.
DEPRECATED AND DEFUNCT:
• The internal functions .readRDS() and .saveRDS() are now
deprecated in favour of the public functions readRDS() and
saveRDS() introduced in R 2.13.0.
• Switching off lazy-loading of code _via_ the LazyLoad field of
the DESCRIPTION file is now deprecated. In future all packages
will be lazy-loaded.
• The off-line help() types "postscript" and "ps" are deprecated.
UTILITIES:
• R CMD check on a multi-architecture installation now skips the
user's .Renviron file for the architecture-specific tests (which
do read the architecture-specific Renviron.site files). This is
consistent with single-architecture checks, which use
--no-environ.
• R CMD build now looks for DESCRIPTION fields BuildResaveData and
BuildKeepEmpty for per-package overrides. See ‘Writing R
Extensions’.
BUG FIXES:
• plot.lm(which = 5) was intended to order factor levels in
increasing order of mean standardized residual. It ordered the
factor labels correctly, but could plot the wrong group of
residuals against the label. (PR#14545)
• mosaicplot() could clip the factor labels, and could overlap them
with the cells if a non-default value of cex.axis was used.
(Related to PR#14550.)
• dataframe[[row,col]] now dispatches on [[ methods for the
selected column. (Spotted by Bill Dunlap).
• sort.int() would strip the class of an object, but leave its
object bit set. (Reported by Bill Dunlap.)
• pbirthday() and qbirthday() did not implement the algorithm
exactly as given in their reference and so were unnecessarily
inaccurate.
pbirthday() now solves the approximate formula analytically
rather than using uniroot() on a discontinuous function.
The description of the problem was inaccurate: the probability is
a tail probability (‘2 _or more_ people share a birthday’)
• Complex arithmetic sometimes warned incorrectly about producing
NAs when there were NaNs in the input.
• seek(origin = "current") incorrectly reported it was not
implemented for a gzfile() connection.
• c(), unlist(), cbind() and rbind() could silently overflow the
maximum vector length and cause a segfault. (PR#14571)
• The fonts argument to X11(type = "Xlib") was being ignored.
• Reading (e.g. with readBin()) from a raw connection was not
advancing the pointer, so successive reads would read the same
value. (Spotted by Bill Dunlap.)
• Parsed text containing embedded newlines was printed incorrectly
by as.character.srcref(). (Reported by Hadley Wickham.)
• decompose() used with a series of a non-integer number of periods
returned a seasonal component shorter than the original series.
(Reported by Rob Hyndman.)
• fields = list() failed for setRefClass(). (Reported by Michael
Lawrence.)
• Reference classes could not redefine an inherited field which had
class "ANY". (Reported by Janko Thyson.)
• Methods that override previously loaded versions will now be
installed and called. (Reported by Iago Mosqueira.)
• addmargins() called numeric(apos) rather than
numeric(length(apos)).
• The HTML help search sometimes produced bad links. (PR#14608)
• Command completion will no longer be broken if tail.default() is
redefined by the user. (Problem reported by Henrik Bengtsson.)
• LaTeX rendering of markup in titles of help pages has been
improved; in particular, \eqn{} may be used there.
• isClass() used its own namespace as the default of the where
argument inadvertently.
• Rd conversion to latex mishandled multi-line titles (including
cases where there was a blank line in the \title section). (It
seems this happened only in 2.13.0 patched.)
• postscript() with an sRGB colormodel now uses sRGB for raster
images (in R 2.13.[01] it used uncalibrated RGB).
There is no longer an undocumented 21845-pixel limit on raster
images.
CHANGES IN R VERSION 2.13.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• replicate() (by default) and vapply() (always) now return a
higher-dimensional array instead of a matrix in the case where
the inner function value is an array of dimension >= 2.
• Printing and formatting of floating point numbers is now using
the correct number of digits, where it previously rarely differed
by a few digits. (See “scientific” entry below.) This affects
_many_ *.Rout.save checks in packages.
NEW FEATURES:
• normalizePath() has been moved to the base package (from utils):
this is so it can be used by library() and friends.
It now does tilde expansion.
It gains new arguments winslash (to select the separator on
Windows) and mustWork to control the action if a canonical path
cannot be found.
• The previously barely documented limit of 256 bytes on a symbol
name has been raised to 10,000 bytes (a sanity check). Long
symbol names can sometimes occur when deparsing expressions (for
example, in model.frame).
• reformulate() gains a intercept argument.
• cmdscale(add = FALSE) now uses the more common definition that
there is a representation in n-1 or less dimensions, and only
dimensions corresponding to positive eigenvalues are used.
(Avoids confusion such as PR#14397.)
• Names used by c(), unlist(), cbind() and rbind() are marked with
an encoding when this can be ascertained.
• R colours are now defined to refer to the sRGB color space.
The PDF, PostScript, and Quartz graphics devices record this
fact. X11 (and cairo) and Windows just assume that your screen
conforms.
• system.file() gains a mustWork argument (suggestion of Bill
Dunlap).
• new.env(hash = TRUE) is now the default.
• list2env(envir = NULL) defaults to hashing (with a suitably sized
environment) for lists of more than 100 elements.
• text() gains a formula method.
• IQR() now has a type argument which is passed to quantile().
• as.vector(), as.double() etc duplicate less when they leave the
mode unchanged but remove attributes.
as.vector(mode = "any") no longer duplicates when it does not
remove attributes. This helps memory usage in matrix() and
array().
matrix() duplicates less if data is an atomic vector with
attributes such as names (but no class).
dim(x) <- NULL duplicates less if x has neither dimensions nor
names (since this operation removes names and dimnames).
• setRepositories() gains an addURLs argument.
• chisq.test() now also returns a stdres component, for
standardized residuals (which have unit variance, unlike the
Pearson residuals).
• write.table() and friends gain a fileEncoding argument, to
simplify writing files for use on other OSes (e.g. a spreadsheet
intended for Windows or Mac OS X Excel).
• Assignment expressions of the form foo::bar(x) <- y and
foo:::bar(x) <- y now work; the replacement functions used are
foo::`bar<-` and foo:::`bar<-`.
• Sys.getenv() gains a names argument so Sys.getenv(x, names =
FALSE) can replace the common idiom of as.vector(Sys.getenv()).
The default has been changed to not name a length-one result.
• Lazy loading of environments now preserves attributes and locked
status. (The locked status of bindings and active bindings are
still not preserved; this may be addressed in the future).
• options("install.lock") may be set to FALSE so that
install.packages() defaults to --no-lock installs, or (on
Windows) to TRUE so that binary installs implement locking.
• sort(partial = p) for large p now tries Shellsort if quicksort is
not appropriate and so works for non-numeric atomic vectors.
• sapply() gets a new option simplify = "array" which returns a
“higher rank” array instead of just a matrix when FUN() returns a
dim() length of two or more.
replicate() has this option set by default, and vapply() now
behaves that way internally.
• aperm() becomes S3 generic and gets a table method which
preserves the class.
• merge() and as.hclust() methods for objects of class "dendrogram"
are now provided.
• The character method of as.POSIXlt() now tries to find a format
that works for all non-NA inputs, not just the first one.
• str() now has a method for class "Date" analogous to that for
class "POSIXt".
• New function file.link() to create hard links on those file
systems (POSIX, NTFS but not FAT) that support them.
• New Summary() group method for class "ordered" implements min(),
max() and range() for ordered factors.
• mostattributes<-() now consults the "dim" attribute and not the
dim() function, making it more useful for objects (such as data
frames) from classes with methods for dim(). It also uses
attr<-() in preference to the generics name<-(), dim<-() and
dimnames<-(). (Related to PR#14469.)
• There is a new option "browserNLdisabled" to disable the use of
an empty (e.g. via the ‘Return’ key) as a synonym for c in
browser() or n under debug(). (Wish of PR#14472.)
• example() gains optional new arguments character.only and
give.lines enabling programmatic exploration.
• serialize() and unserialize() are no longer described as
‘experimental’. The interface is now regarded as stable,
although the serialization format may well change in future
releases. (serialize() has a new argument version which would
allow the current format to be written if that happens.)
New functions saveRDS() and readRDS() are public versions of the
‘internal’ functions .saveRDS() and .readRDS() made available for
general use. The dot-name versions remain available as several
package authors have made use of them, despite the documentation.
readRDS() no longer wraps non-file connections in a call to
gzcon(), for efficiency (see its documentation).
saveRDS() supports compress = "xz".
• Many functions when called with a not-open connection will now
ensure that the connection is left not-open in the event of
error. These include read.dcf(), dput(), dump(), load(),
parse(), readBin(), readChar(), readLines(), save(), writeBin(),
writeChar(), writeLines(), .readRDS(), .saveRDS() and
tools::parse_Rd(), as well as functions calling these.
• Public functions find.package() and path.package() replace the
internal dot-name versions.
• The default method for terms() now looks for a "terms" attribute
if it does not find a "terms" component, and so works for model
frames.
• httpd() handlers receive an additional argument containing the
full request headers as a raw vector (this can be used to parse
cookies, multi-part forms etc.). The recommended full signature
for handlers is therefore function(url, query, body, headers,
...).
• file.edit() gains a fileEncoding argument to specify the encoding
of the file(s).
• The format of the HTML package listings has changed. If there is
more than one library tree , a table of links to libraries is
provided at the top and bottom of the page. Where a library
contains more than 100 packages, an alphabetic index is given at
the top of the section for that library. (As a consequence,
package names are now sorted case-insensitively whatever the
locale.)
• isSeekable() now returns FALSE on connections which have
non-default encoding. Although documented to record if ‘in
principle’ the connection supports seeking, it seems safer to
report FALSE when it may not work.
• R CMD REMOVE and remove.packages() now remove file R.css when
removing all remaining packages in a library tree. (Related to
the wish of PR#14475: note that this file is no longer
installed.)
• unzip() now has a unzip argument like zip.file.extract(). This
allows an external unzip program to be used, which can be useful
to access features supported by Info-ZIP's unzip version 6 which
is now becoming more widely available.
• There is a simple zip() function, as wrapper for an external zip
command.
• bzfile() connections can now read from concatenated bzip2 files
(including files written with bzfile(open = "a")) and files
created by some other compressors (such as the example of
PR#14479).
• The primitive function c() is now of type BUILTIN.
• plot(<dendrogram>, .., nodePar=*) now obeys an optional xpd
specification (allowing clipping to be turned off completely).
• nls(algorithm="port") now shares more code with nlminb(), and is
more consistent with the other nls() algorithms in its return
value.
• xz has been updated to 5.0.1 (very minor bugfix release).
• image() has gained a logical useRaster argument allowing it to
use a bitmap raster for plotting a regular grid instead of
polygons. This can be more efficient, but may not be supported by
all devices. The default is FALSE.
• list.files()/dir() gains a new argument include.dirs() to include
directories in the listing when recursive = TRUE.
• New function list.dirs() lists all directories, (even empty
ones).
• file.copy() now (by default) copies read/write/execute
permissions on files, moderated by the current setting of
Sys.umask().
• Sys.umask() now accepts mode = NA and returns the current umask
value (visibly) without changing it.
• There is a ! method for classes "octmode" and "hexmode": this
allows xor(a, b) to work if both a and b are from one of those
classes.
• as.raster() no longer fails for vectors or matrices containing
NAs.
• New hook "before.new.plot" allows functions to be run just before
advancing the frame in plot.new, which is potentially useful for
custom figure layout implementations.
• Package tools has a new function compactPDF() to try to reduce
the size of PDF files _via_ qpdf or gs.
• tar() has a new argument extra_flags.
• dotchart() accepts more general objects x such as 1D tables which
can be coerced by as.numeric() to a numeric vector, with a
warning since that might not be appropriate.
• The previously internal function create.post() is now exported
from utils, and the documentation for bug.report() and
help.request() now refer to that for create.post().
It has a new method = "mailto" on Unix-alikes similar to that on
Windows: it invokes a default mailer via open (Mac OS X) or
xdg-open or the default browser (elsewhere).
The default for ccaddress is now getOption("ccaddress") which is
by default unset: using the username as a mailing address
nowadays rarely works as expected.
• The default for options("mailer") is now "mailto" on all
platforms.
• unlink() now does tilde-expansion (like most other file
functions).
• file.rename() now allows vector arguments (of the same length).
• The "glm" method for logLik() now returns an "nobs" attribute
(which stats4::BIC() assumed it did).
The "nls" method for logLik() gave incorrect results for zero
weights.
• There is a new generic function nobs() in package stats, to
extract from model objects a suitable value for use in BIC
calculations. An S4 generic derived from it is defined in
package stats4.
• Code for S4 reference-class methods is now examined for possible
errors in non-local assignments.
• findClasses, getGeneric, findMethods and hasMethods are revised
to deal consistently with the package= argument and be consistent
with soft namespace policy for finding objects.
• tools::Rdiff() now has the option to return not only the status
but a character vector of observed differences (which are still
by default sent to stdout).
• The startup environment variables R_ENVIRON_USER, R_ENVIRON,
R_PROFILE_USER and R_PROFILE are now treated more consistently.
In all cases an empty value is considered to be set and will stop
the default being used, and for the last two tilde expansion is
performed on the file name. (Note that setting an empty value is
probably impossible on Windows.)
• Using R --no-environ CMD, R --no-site-file CMD or R
--no-init-file CMD sets environment variables so these settings
are passed on to child R processes, notably those run by INSTALL,
check and build. R --vanilla CMD sets these three options (but
not --no-restore).
• smooth.spline() is somewhat faster. With cv=NA it allows some
leverage computations to be skipped,
• The internal (C) function scientific(), at the heart of R's
format.info(x), format(x), print(x), etc, for numeric x, has been
re-written in order to provide slightly more correct results,
fixing PR#14491, notably in border cases including when digits >=
16, thanks to substantial contributions (code and experiments)
from Petr Savicky. This affects a noticeable amount of numeric
output from R.
• A new function grepRaw() has been introduced for finding subsets
of raw vectors. It supports both literal searches and regular
expressions.
• Package compiler is now provided as a standard package. See
?compiler::compile for information on how to use the compiler.
This package implements a byte code compiler for R: by default
the compiler is not used in this release. See the ‘R
Installation and Administration Manual’ for how to compile the
base and recommended packages.
• Providing an exportPattern directive in a NAMESPACE file now
causes classes to be exported according to the same pattern, for
example the default from package.skeleton() to specify all names
starting with a letter. An explicit directive to
exportClassPattern will still over-ride.
• There is an additional marked encoding "bytes" for character
strings. This is intended to be used for non-ASCII strings which
should be treated as a set of bytes, and never re-encoded as if
they were in the encoding of the current locale: useBytes = TRUE
is automatically selected in functions such as writeBin(),
writeLines(), grep() and strsplit().
Only a few character operations are supported (such as substr()).
Printing, format() and cat() will represent non-ASCII bytes in
such strings by a \xab escape.
• The new function removeSource() removes the internally stored
source from a function.
• "srcref" attributes now include two additional line number
values, recording the line numbers in the order they were parsed.
• New functions have been added for source reference access:
getSrcFilename(), getSrcDirectory(), getSrcLocation() and
getSrcref().
• Sys.chmod() has an extra argument use_umask which defaults to
true and restricts the file mode by the current setting of umask.
This means that all the R functions which manipulate
file/directory permissions by default respect umask, notably R
CMD INSTALL.
• tempfile() has an extra argument fileext to create a temporary
filename with a specified extension. (Suggestion and initial
implementation by Dirk Eddelbuettel.)
There are improvements in the way Sweave() and Stangle() handle
non-ASCII vignette sources, especially in a UTF-8 locale: see
‘Writing R Extensions’ which now has a subsection on this topic.
• factanal() now returns the rotation matrix if a rotation such as
"promax" is used, and hence factor correlations are displayed.
(Wish of PR#12754.)
• The gctorture2() function provides a more refined interface to
the GC torture process. Environment variables R_GCTORTURE,
R_GCTORTURE_WAIT, and R_GCTORTURE_INHIBIT_RELEASE can also be
used to control the GC torture process.
• file.copy(from, to) no longer regards it as an error to supply a
zero-length from: it now simply does nothing.
• rstandard.glm() gains a type argument which can be used to
request standardized Pearson residuals.
• A start on a Turkish translation, thanks to Murat Alkan.
• .libPaths() calls normalizePath(winslash = "/") on the paths:
this helps (usually) to present them in a user-friendly form and
should detect duplicate paths accessed via different symbolic
links.
• download.file() can be now used with external methods even if
there are spaces in the URL or the target filename.
• The first formal argument of .C(), .Fortran(), .Call() and
.External() is now referred to a .NAME rather than name: however
actual calls should have an unnamed first argument.
SWEAVE CHANGES:
• Sweave() has options to produce PNG and JPEG figures, and to use
a custom function to open a graphics device (see ?RweaveLatex).
(Based in part on the contribution of PR#14418.)
• The default for Sweave() is to produce only PDF figures (rather
than both EPS and PDF).
• Environment variable SWEAVE_OPTIONS can be used to supply
defaults for existing or new options to be applied after the
Sweave driver setup has been run.
• The Sweave manual is now included as a vignette in the utils
package.
• Sweave() handles keep.source=TRUE much better: it could duplicate
some lines and omit comments. (Reported by John Maindonald and
others.)
C-LEVEL FACILITIES:
• Because they use a C99 interface which a C++ compiler is not
required to support, Rvprintf and REvprintf are only defined by
R_ext/Print.h in C++ code if the macro R_USE_C99_IN_CXX is
defined when it is included.
• pythag duplicated the C99 function hypot. It is no longer
provided, but is used as a substitute for hypot in the very
unlikely event that the latter is not available.
• R_inspect(obj) and R_inspect3(obj, deep, pvec) are (hidden)
C-level entry points to the internal inspect function and can be
used for C-level debugging (e.g., in conjunction with the p
command in gdb).
• Compiling R with --enable-strict-barrier now also enables
additional checking for use of unprotected objects. In
combination with gctorture() or gctorture2() and a C-level
debugger this can be useful for tracking down memory protection
issues.
UTILITIES:
• R CMD Rdiff is now implemented in R on Unix-alikes (as it has
been on Windows since R 2.12.0).
• R CMD build no longer does any cleaning in the supplied package
directory: all the cleaning is done in the copy.
It has a new option --install-args to pass arguments to R CMD
INSTALL for --build (but not when installing to rebuild
vignettes).
There is new option, --resave-data, to call
tools::resaveRdaFiles() on the data directory, to compress
tabular files (.tab, .csv etc) and to convert .R files to .rda
files. The default, --resave-data=gzip, is to do so in a way
compatible even with years-old versions of R, but better
compression is given by --resave-data=best, requiring R >=
2.10.0.
It now adds a datalist file for data directories of more than
1Mb.
Patterns in .Rbuildignore are now also matched against all
directory names (including those of empty directories).
There is a new option, --compact-vignettes, to try reducing the
size of PDF files in the inst/doc directory. Currently this
tries qpdf: other options may be used in future.
When re-building vignettes and a inst/doc/Makefile file is found,
make clean is run if the makefile has a clean: target.
After re-building vignettes the default clean-up operation will
remove any directories (and not just files) created during the
process: e.g. one package created a .R_cache directory.
Empty directories are now removed unless the option
--keep-empty-dirs is given (and a few packages do deliberately
include empty directories).
If there is a field BuildVignettes in the package DESCRIPTION
file with a false value, re-building the vignettes is skipped.
• R CMD check now also checks for filenames that are
case-insensitive matches to Windows' reserved file names with
extensions, such as nul.Rd, as these have caused problems on some
Windows systems.
It checks for inefficiently saved data/*.rda and data/*.RData
files, and reports on those large than 100Kb. A more complete
check (including of the type of compression, but potentially much
slower) can be switched on by setting environment variable
_R_CHECK_COMPACT_DATA2_ to TRUE.
The types of files in the data directory are now checked, as
packages are _still_ misusing it for non-R data files.
It now extracts and runs the R code for each vignette in a
separate directory and R process: this is done in the package's
declared encoding. Rather than call tools::checkVignettes(), it
calls tools::buildVignettes() to see if the vignettes can be
re-built as they would be by R CMD build. Option --use-valgrind
now applies only to these runs, and not when running code to
rebuild the vignettes. This version does a much better job of
suppressing output from successful vignette tests.
The 00check.log file is a more complete record of what is output
to stdout: in particular contains more details of the tests.
It now checks all syntactically valid Rd usage entries, and warns
about assignments (unless these give the usage of replacement
functions).
.tar.xz compressed tarballs are now allowed, if tar supports them
(and setting environment variable TAR to internal ensures so on
all platforms).
• R CMD check now warns if it finds inst/doc/makefile, and R CMD
build renames such a file to inst/doc/Makefile.
INSTALLATION:
• Installing R no longer tries to find perl, and R CMD no longer
tries to substitute a full path for awk nor perl - this was a
legacy from the days when they were used by R itself. Because a
couple of packages do use awk, it is set as the make (rather than
environment) variable AWK.
• make check will now fail if there are differences from the
reference output when testing package examples and if environment
variable R_STRICT_PACKAGE_CHECK is set to a true value.
• The C99 double complex type is now required.
The C99 complex trigonometric functions (such as csin) are not
currently required (FreeBSD lacks most of them): substitutes are
used if they are missing.
• The C99 system call va_copy is now required.
• If environment variable R_LD_LIBRARY_PATH is set during
configuration (for example in config.site) it is used unchanged
in file etc/ldpaths rather than being appended to.
• configure looks for support for OpenMP and if found compiles R
with appropriate flags and also makes them available for use in
packages: see ‘Writing R Extensions’.
This is currently experimental, and is only used in R with a
single thread for colSums() and colMeans(). Expect it to be more
widely used in later versions of R.
This can be disabled by the --disable-openmp flag.
PACKAGE INSTALLATION:
• R CMD INSTALL --clean now removes copies of a src directory which
are created when multiple sub-architectures are in use.
(Following a comment from Berwin Turlach.)
• File R.css is now installed on a per-package basis (in the
package's html directory) rather than in each library tree, and
this is used for all the HTML pages in the package. This helps
when installing packages with static HTML pages for use on a
webserver. It will also allow future versions of R to use
different stylesheets for the packages they install.
• A top-level file .Rinstignore in the package sources can list (in
the same way as .Rbuildignore) files under inst that should not
be installed. (Why should there be any such files? Because all
the files needed to re-build vignettes need to be under inst/doc,
but they may not need to be installed.)
• R CMD INSTALL has a new option --compact-docs to compact any PDFs
under the inst/doc directory. Currently this uses qpdf, which
must be installed (see ‘Writing R Extensions’).
• There is a new option --lock which can be used to cancel the
effect of --no-lock or --pkglock earlier on the command line.
• Option --pkglock can now be used with more than one package, and
is now the default if only one package is specified.
• Argument lock of install.packages() can now be use for Mac binary
installs as well as for Windows ones. The value "pkglock" is now
accepted, as well as TRUE and FALSE (the default).
• There is a new option --no-clean-on-error for R CMD INSTALL to
retain a partially installed package for forensic analysis.
• Packages with names ending in . are not portable since Windows
does not work correctly with such directory names. This is now
warned about in R CMD check, and will not be allowed in R 2.14.x.
• The vignette indices are more comprehensive (in the style of
browseVignetttes()).
DEPRECATED & DEFUNCT:
• require(save = TRUE) is defunct, and use of the save argument is
deprecated.
• R CMD check --no-latex is defunct: use --no-manual instead.
• R CMD Sd2Rd is defunct.
• The gamma argument to hsv(), rainbow(), and rgb2hsv() is
deprecated and no longer has any effect.
• The previous options for R CMD build --binary (--auto-zip,
--use-zip-data and --no-docs) are deprecated (or defunct): use
the new option --install-args instead.
• When a character value is used for the EXPR argument in switch(),
only a single unnamed alternative value is now allowed.
• The wrapper utils::link.html.help() is no longer available.
• Zip-ing data sets in packages (and hence R CMD INSTALL options
--use-zip-data and --auto-zip, as well as the ZipData: yes field
in a DESCRIPTION file) is defunct.
Installed packages with zip-ed data sets can still be used, but a
warning that they should be re-installed will be given.
• The ‘experimental’ alternative specification of a namespace via
.Export() etc is now defunct.
• The option --unsafe to R CMD INSTALL is deprecated: use the
identical option --no-lock instead.
• The entry point pythag in Rmath.h is deprecated in favour of the
C99 function hypot. A wrapper for hypot is provided for R 2.13.x
only.
• Direct access to the "source" attribute of functions is
deprecated; use deparse(fn, control="useSource") to access it,
and removeSource(fn) to remove it.
• R CMD build --binary is now formally deprecated: R CMD INSTALL
--build has long been the preferred alternative.
• Single-character package names are deprecated (and R is already
disallowed to avoid confusion in Depends: fields).
BUG FIXES:
• drop.terms and the [ method for class "terms" no longer add back
an intercept. (Reported by Niels Hansen.)
• aggregate preserves the class of a column (e.g. a date) under
some circumstances where it discarded the class previously.
• p.adjust() now always returns a vector result, as documented. In
previous versions it copied attributes (such as dimensions) from
the p argument: now it only copies names.
• On PDF and PostScript devices, a line width of zero was recorded
verbatim and this caused problems for some viewers (a very thin
line combined with a non-solid line dash pattern could also cause
a problem). On these devices, the line width is now limited at
0.01 and for very thin lines with complex dash patterns the
device may force the line dash pattern to be solid. (Reported by
Jari Oksanen.)
• The str() method for class "POSIXt" now gives sensible output for
0-length input.
• The one- and two-argument complex maths functions failed to warn
if NAs were generated (as their numeric analogues do).
• Added .requireCachedGenerics to the dont.mind list for library()
to avoid warnings about duplicates.
• $<-.data.frame messed with the class attribute, breaking any S4
subclass. The S4 data.frame class now has its own $<- method,
and turns dispatch on for this primitive.
• Map() did not look up a character argument f in the correct
frame, thanks to lazy evaluation. (PR#14495)
• file.copy() did not tilde-expand from and to when to was a
directory. (PR#14507)
• It was possible (but very rare) for the loading test in R CMD
INSTALL to crash a child R process and so leave around a lock
directory and a partially installed package. That test is now
done in a separate process.
• plot(<formula>, data=<matrix>,..) now works in more cases;
similarly for points(), lines() and text().
• edit.default() contained a manual dispatch for matrices (the
"matrix" class didn't really exist when it was written). This
caused an infinite recursion in the no-GUI case and has now been
removed.
• data.frame(check.rows = TRUE) sometimes worked when it should
have detected an error. (PR#14530)
• scan(sep= , strip.white=TRUE) sometimes stripped trailing spaces
from within quoted strings. (The real bug in PR#14522.)
• The rank-correlation methods for cor() and cov() with use =
"complete.obs" computed the ranks before removing missing values,
whereas the documentation implied incomplete cases were removed
first. (PR#14488)
They also failed for 1-row matrices.
• The perpendicular adjustment used in placing text and expressions
in the margins of plots was not scaled by par("mex"). (Part of
PR#14532.)
• Quartz Cocoa device now catches any Cocoa exceptions that occur
during the creation of the device window to prevent crashes. It
also imposes a limit of 144 ft^2 on the area used by a window to
catch user errors (unit misinterpretation) early.
• The browser (invoked by debug(), browser() or otherwise) would
display attributes such as "wholeSrcref" that were intended for
internal use only.
• R's internal filename completion now properly handles filenames
with spaces in them even when the readline library is used. This
resolves PR#14452 provided the internal filename completion is
used (e.g., by setting rc.settings(files = TRUE)).
• Inside uniroot(f, ...), -Inf function values are now replaced by
a maximally *negative* value.
• rowsum() could silently over/underflow on integer inputs
(reported by Bill Dunlap).
• as.matrix() did not handle "dist" objects with zero rows.
CHANGES IN R VERSION 2.12.2 patched:
NEW FEATURES:
• max() and min() work harder to ensure that NA has precedence over
NaN, so e.g. min(NaN, NA) is NA. (This was not previously
documented except for within a single numeric vector, where
compiler optimizations often defeated the code.)
BUG FIXES:
• A change to the C function R_tryEval had broken error messages in
S4 method selection; the error message is now printed.
• PDF output with a non-RGB color model used RGB for the line
stroke color. (PR#14511)
• stats4::BIC() assumed without checking that an object of class
"logLik" has an "nobs" attribute: glm() fits did not and so BIC()
failed for them.
• In some circumstances a one-sided mantelhaen.test() reported the
p-value for the wrong tail. (PR#14514)
• Passing the invalid value lty = NULL to axis() sent an invalid
value to the graphics device, and might cause the device to
segfault.
• Sweave() with concordance=TRUE could lead to invalid PDF files;
Sweave.sty has been updated to avoid this.
• Non-ASCII characters in the titles of help pages were not
rendered properly in some locales, and could cause errors or
warnings.
• checkRd() gave a spurious error if the \href macro was used.
CHANGES IN R VERSION 2.12.2:
SIGNIFICANT USER-VISIBLE CHANGES:
• Complex arithmetic (notably z^n for complex z and integer n) gave
incorrect results since R 2.10.0 on platforms without C99 complex
support. This and some lesser issues in trigonometric functions
have been corrected.
Such platforms were rare (we know of Cygwin and FreeBSD).
However, because of new compiler optimizations in the way complex
arguments are handled, the same code was selected on x86_64 Linux
with gcc 4.5.x at the default -O2 optimization (but not at -O).
• There is a workaround for crashes seen with several packages on
systems using zlib 1.2.5: see the INSTALLATION section.
NEW FEATURES:
• PCRE has been updated to 8.12 (two bug-fix releases since 8.10).
• rep(), seq(), seq.int() and seq_len() report more often when the
first element is taken of an argument of incorrect length.
• The Cocoa back-end for the quartz() graphics device on Mac OS X
provides a way to disable event loop processing temporarily
(useful, e.g., for forked instances of R).
• kernel()'s default for m was not appropriate if coef was a set of
coefficients. (Reported by Pierre Chausse.)
• bug.report() has been updated for the current R bug tracker,
which does not accept emailed submissions.
• R CMD check now checks for the correct use of $(LAPACK_LIBS) (as
well as $(BLAS_LIBS)), since several CRAN recent submissions have
ignored ‘Writing R Extensions’.
INSTALLATION:
• The zlib sources in the distribution are now built with all
symbols remapped: this is intended to avoid problems seen with
packages such as XML and rggobi which link to zlib.so.1 on
systems using zlib 1.2.5.
• The default for FFLAGS and FCFLAGS with gfortran on x86_64 Linux
has been changed back to -g -O2: however, setting -g -O may still
be needed for gfortran 4.3.x.
PACKAGE INSTALLATION:
• A LazyDataCompression field in the DESCRIPTION file will be used
to set the value for the --data-compress option of R CMD INSTALL.
• Files R/sysdata.rda of more than 1Mb are now stored in the
lazyload database using xz compression: this for example halves
the installed size of package Imap.
• R CMD INSTALL now ensures that directories installed from inst
have search permission for everyone.
It no longer installs files inst/doc/Rplots.ps and
inst/doc/Rplots.pdf. These are almost certainly left-overs from
Sweave runs, and are often large.
DEPRECATED & DEFUNCT:
• The ‘experimental’ alternative specification of a namespace via
.Export() etc is now deprecated.
• zip.file.extract() is now deprecated.
• Zip-ing data sets in packages (and hence R CMD INSTALL
--use-zip-data and the ZipData: yes field in a DESCRIPTION file)
is deprecated: using efficiently compressed .rda images and
lazy-loading of data has superseded it.
BUG FIXES:
• identical() could in rare cases generate a warning about
non-pairlist attributes on CHARSXPs. As these are used for
internal purposes, the attribute check should be skipped.
(Reported by Niels Richard Hansen).
• If the filename extension (usually .Rnw) was not included in a
call to Sweave(), source references would not work properly and
the keep.source option failed. (PR#14459)
• format.data.frame() now keeps zero character column names.
• pretty(x) no longer raises an error when x contains solely
non-finite values. (PR#14468)
• The plot.TukeyHSD() function now uses a line width of 0.5 for its
reference lines rather than lwd = 0 (which caused problems for
some PDF and PostScript viewers).
• The big.mark argument to prettyNum(), format(), etc. was inserted
reversed if it was more than one character long.
• R CMD check failed to check the filenames under man for Windows'
reserved names.
• The "Date" and "POSIXt" methods for seq() could overshoot when to
was supplied and by was specified in months or years.
• The internal method of untar() now restores hard links as file
copies rather than symbolic links (which did not work for
cross-directory links).
• unzip() did not handle zip files which contained filepaths with
two or more leading directories which were not in the zipfile and
did not already exist. (It is unclear if such zipfiles are valid
and the third-party C code used did not support them, but
PR#14462 created one.)
• combn(n, m) now behaves more regularly for the border case m = 0.
(PR#14473)
• The rendering of numbers in plotmath expressions (e.g.
expression(10^2)) used the current settings for conversion to
strings rather than setting the defaults, and so could be
affected by what has been done before. (PR#14477)
• The methods of napredict() and naresid() for na.action =
na.exclude fits did not work correctly in the very rare event
that every case had been omitted in the fit. (Reported by Simon
Wood.)
• weighted.residuals(drop0=TRUE) returned a vector when the
residuals were a matrix (e.g. those of class "mlm"). (Reported
by Bill Dunlap.)
• Package HTML index files <pkg>/html/00Index.html were generated
with a stylesheet reference that was not correct for static
browsing in libraries.
• ccf(na.action = na.pass) was not implemented.
• The parser accepted some incorrect numeric constants, e.g. 20x2.
(Reported by Olaf Mersmann.)
• format(*, zero.print) did not always replace the full zero parts.
• Fixes for subsetting or subassignment of "raster" objects when
not both i and j are specified.
• R CMD INSTALL was not always respecting the ZipData: yes field of
a DESCRIPTION file (although this is frequently incorrectly
specified for packages with no data or which specify lazy-loading
of data).
R CMD INSTALL --use-zip-data was incorrectly implemented as
--use-zipdata since R 2.9.0.
• source(file, echo=TRUE) could fail if the file contained #line
directives. It now recovers more gracefully, but may still
display the wrong line if the directive gives incorrect
information.
• atan(1i) returned NaN+Infi (rather than 0+Infi) on platforms
without C99 complex support.
• library() failed to cache S4 metadata (unlike loadNamespace())
causing failures in S4-using packages without a namespace (e.g.
those using reference classes).
• The function qlogis(lp, log.p=TRUE) no longer prematurely
overflows to Inf when exp(lp) is close to 1.
• Updating S4 methods for a group generic function requires
resetting the methods tables for the members of the group (patch
contributed by Martin Morgan).
• In some circumstances (including for package XML), R CMD INSTALL
installed version-control directories from source packages.
• Added PROTECT calls to some constructed expressions used in C
level eval calls.
• utils:::create.post() (used by bug.report() and help.request())
failed to quote arguments to the mailer, and so often failed.
• bug.report() was naive about how to extract maintainer email
addresses from package descriptions, so would often try mailing
to incorrect addresses.
• debugger() could fail to read the environment of a call to a
function with a ... argument. (Reported by Charlie Roosen.)
• prettyNum(c(1i, NA), drop0=TRUE) or str(NA_complex_) now work
correctly.
CHANGES IN R VERSION 2.12.1:
NEW FEATURES:
• The DVI/PDF reference manual now includes the help pages for all
the standard packages: splines, stats4 and tcltk were previously
omitted (intentionally).
• <URL: http://www.rforge.net> has been added to the default set of
repositories known to setRepositories().
• xz-utils has been updated to version 5.0.0.
• reshape() now makes use of sep when forming names during
reshaping to wide format. (PR#14435)
• legend() allows the length of lines to be set by the end user
_via_ the new argument seg.len.
• New S4 reference class utility methods copy(), field(),
getRefClass() and getClass() have been added to package methods.
• When a character value is used for the EXPR argument in switch(),
a warning is given if more than one unnamed alternative value is
given. This will become an error in R 2.13.0.
• StructTS(type = "BSM") now allows series with just two seasons.
(Reported by Birgit Erni.)
INSTALLATION:
• The PDF reference manual is now built as PDF version 1.5 with
object compression, which on platforms for which this is not the
default (notably MiKTeX) halves its size.
• Variable FCLIBS can be set during configuration, for any
additional library flags needed when linking a shared object with
the Fortran 9x compiler. (Needed with Solaris Studio 12.2.)
BUG FIXES:
• seq.int() no longer sometimes evaluates arguments twice.
(PR#14388)
• The data.frame method of format() failed if a column name was
longer than 256 bytes (the maximum length allowed for an R name).
• predict(<lm object>, type ="terms", ...) failed if both terms and
interval were specified. (Reported by Bill Dunlap.)
Also, if se.fit = TRUE the standard errors were reported for all
terms, not just those selected by a non-null terms.
• The TRE regular expressions engine could terminate R rather than
give an error when given certain invalid regular expressions.
(PR#14398)
• cmdscale(eig = TRUE) was documented to return n-1 eigenvalues but
in fact only returned k. It now returns all n eigenvalues.
cmdscale(add = TRUE) failed to centre the return configuration
and sometimes lost the labels on the points. Its return value
was described wrongly (it is always a list and contains component
ac).
• promptClass() in package methods now works for reference classes
and gives a suitably specialized skeleton of documentation.
Also, callSuper() now works via the methods() invocation as well
as for initially specified methods.
• download.file() could leave the destination file open if the URL
was not able to be opened. (PR#14414)
• Assignment of an environment to functions or as an attribute to
other objects now works for S4 subclasses of "environment".
• Use of [[<- for S4 subclasses of "environment" generated an
infinite recursion from the method. The method has been replaced
by internal code.
• In a reference class S4 method, callSuper() now works in
initialize() methods when there is no explicit superclass method.
• ! dropped attributes such as names and dimensions from a
length-zero argument. (PR#14424)
• When list2env() created an environment it was missing a PROTECT
call and so was vulnerable to garbage collection.
• Sweave() with keep.source=TRUE dropped comments at the start and
end of code chunks. It could also fail when \SweaveInput was
combined with named chunks.
• The Fortran code used by nls(algorithm = "port") could
infinite-loop when compiled with high optimization on a modern
version of gcc, and SAFE_FFLAGS is now used to make this less
likely. (PR#14427, seen with 32-bit Windows using gcc 4.5.0 used
from R 2.12.0.)
• sapply() with default simplify = TRUE and mapply() with default
SIMPLIFY = TRUE wrongly simplified language-like results, as,
e.g., in mapply(1:2, c(3,7), FUN = function(i,j) call(':',i,j)).
• Backreferences to undefined patterns in [g]sub(pcre = TRUE) could
cause a segfault. (PR#14431)
• The format() (and hence the print()) method for class "Date"
rounded fractional dates towards zero: it now always rounds them
down.
• Reference S4 class creation could generate ambiguous inheritance
patterns under very special circumstances.
• [[<- turned S4 subclasses of "environment" into plain
environments.
• Long titles for help pages were truncated in package indices and
a few other places.
• Additional utilities now work correctly with S4 subclasses of
"environment" (rm, locking tools and active bindings).
• spec.ar() now also work for the "ols" method. (Reported by
Hans-Ruedi Kuensch.)
• The initialization of objects from S4 subclasses of "environment"
now allocates a new environment object.
• R CMD check has more protection against (probably erroneous)
example or test output which is invalid in the current locale.
• qr.X() with column names and pivoting now also pivots the column
names. (PR#14438)
• unit.pmax() and unit.pmin() in package grid gave incorrect
results when all inputs were of length 1. (PR#14443)
• The parser for NAMESPACE files ignored misspelled directives,
rather than signalling an error. For 2.12.x a warning will be
issued, but this will be correctly reported as an error in later
releases. (Reported by Charles Berry.)
• Fix for subsetting of "raster" objects when only one of i or j is
specified.
• grid.raster() in package grid did not accept "nativeRaster"
objects (like rasterImage() does).
• Rendering raster images in PDF output was resetting the clipping
region.
• Rendering of raster images on cairo X11 device was wrong,
particularly when a small image was being scaled up using
interpolation.
With cairo < 1.6, will be better than before, though still a
little clunky. With cairo >= 1.6, should be sweet as.
• Several bugs fixed in read.DIF(): single column inputs caused
errors, cells marked as "character" could be converted to other
types, and (in Windows) copying from the clipboard failed.
CHANGES IN R VERSION 2.12.0:
NEW FEATURES:
• Reading a package's CITATION file now defaults to ASCII rather
than Latin-1: a package with a non-ASCII CITATION file should
declare an encoding in its DESCRIPTION file and use that encoding
for the CITATION file.
• difftime() now defaults to the "tzone" attribute of "POSIXlt"
objects rather than to the current timezone as set by the default
for the tz argument. (Wish of PR#14182.)
• pretty() is now generic, with new methods for "Date" and "POSIXt"
classes (based on code contributed by Felix Andrews).
• unique() and match() are now faster on character vectors where
all elements are in the global CHARSXP cache and have unmarked
encoding (ASCII). Thanks to Matthew Dowle for suggesting
improvements to the way the hash code is generated in unique.c.
• The enquote() utility, in use internally, is exported now.
• .C() and .Fortran() now map non-zero return values (other than
NA_LOGICAL) for logical vectors to TRUE: it has been an implicit
assumption that they are treated as true.
• The print() methods for "glm" and "lm" objects now insert
linebreaks in long calls in the same way that the print() methods
for "summary.[g]lm" objects have long done. This does change the
layout of the examples for a number of packages, e.g. MASS.
(PR#14250)
• constrOptim() can now be used with method "SANN". (PR#14245)
It gains an argument hessian to be passed to optim(), which
allows all the ... arguments to be intended for f() and grad().
(PR#14071)
• curve() now allows expr to be an object of mode "expression" as
well as "call" and "function".
• The "POSIX[cl]t" methods for Axis() have been replaced by a
single method for "POSIXt".
There are no longer separate plot() methods for "POSIX[cl]t" and
"Date": the default method has been able to handle those classes
for a long time. This _inter alia_ allows a single date-time
object to be supplied, the wish of PR#14016.
The methods had a different default ("") for xlab.
• Classes "POSIXct", "POSIXlt" and "difftime" have generators
.POSIXct(), .POSIXlt() and .difftime(). Package authors are
advised to make use of them (they are available from R 2.11.0) to
proof against planned future changes to the classes.
The ordering of the classes has been changed, so "POSIXt" is now
the second class. See the document ‘Updating packages for
changes in R 2.12.x’ on <URL: http://developer.r-project.org> for
the consequences for a handful of CRAN packages.
• The "POSIXct" method of as.Date() allows a timezone to be
specified (but still defaults to UTC).
• New list2env() utility function as an inverse of
as.list(<environment>) and for fast multi-assign() to existing
environment. as.environment() is now generic and uses list2env()
as list method.
• There are several small changes to output which ‘zap’ small
numbers, e.g. in printing quantiles of residuals in summaries
from "lm" and "glm" fits, and in test statistics in
print.anova().
• Special names such as "dim", "names", etc, are now allowed as
slot names of S4 classes, with "class" the only remaining
exception.
• File .Renviron can have architecture-specific versions such as
.Renviron.i386 on systems with sub-architectures.
• installed.packages() has a new argument subarch to filter on
sub-architecture.
• The summary() method for packageStatus() now has a separate
print() method.
• The default summary() method returns an object inheriting from
class "summaryDefault" which has a separate print() method that
calls zapsmall() for numeric/complex values.
• The startup message now includes the platform and if used,
sub-architecture: this is useful where different
(sub-)architectures run on the same OS.
• The getGraphicsEvent() mechanism now allows multiple windows to
return graphics events, through the new functions
setGraphicsEventHandlers(), setGraphicsEventEnv(), and
getGraphicsEventEnv(). (Currently implemented in the windows()
and X11() devices.)
• tools::texi2dvi() gains an index argument, mainly for use by R
CMD Rd2pdf.
It avoids the use of texindy by texinfo's texi2dvi >= 1.157,
since that does not emulate 'makeindex' well enough to avoid
problems with special characters (such as (, {, !) in indices.
• The ability of readLines() and scan() to re-encode inputs to
marked UTF-8 strings on Windows since R 2.7.0 is extended to
non-UTF-8 locales on other OSes.
• scan() gains a fileEncoding argument to match read.table().
• points() and lines() gain "table" methods to match plot(). (Wish
of PR#10472.)
• Sys.chmod() allows argument mode to be a vector, recycled along
paths.
• There are |, & and xor() methods for classes "octmode" and
"hexmode", which work bitwise.
• Environment variables R_DVIPSCMD, R_LATEXCMD, R_MAKEINDEXCMD,
R_PDFLATEXCMD are no longer used nor set in an R session. (With
the move to tools::texi2dvi(), the conventional environment
variables LATEX, MAKEINDEX and PDFLATEX will be used.
options("dvipscmd") defaults to the value of DVIPS, then to
"dvips".)
• New function isatty() to see if terminal connections are
redirected.
• summaryRprof() returns the sampling interval in component
sample.interval and only returns in by.self data for functions
with non-zero self times.
• print(x) and str(x) now indicate if an empty list x is named.
• install.packages() and remove.packages() with lib unspecified and
multiple libraries in .libPaths() inform the user of the library
location used with a message rather than a warning.
• There is limited support for multiple compressed streams on a
file: all of [bgx]zfile() allow streams to be appended to an
existing file, but bzfile() reads only the first stream.
• Function person() in package utils now uses a given/family scheme
in preference to first/middle/last, is vectorized to handle an
arbitrary number of persons, and gains a role argument to specify
person roles using a controlled vocabulary (the MARC relator
terms).
• Package utils adds a new "bibentry" class for representing and
manipulating bibliographic information in enhanced BibTeX style,
unifying and enhancing the previously existing mechanisms.
• A bibstyle() function has been added to the tools package with
default JSS style for rendering "bibentry" objects, and a
mechanism for registering other rendering styles.
• Several aspects of the display of text help are now customizable
using the new Rd2txt_options() function.
options("help_text_width") is no longer used.
• Added \href tag to the Rd format, to allow hyperlinks to URLs
without displaying the full URL.
• Added \newcommand and \renewcommand tags to the Rd format, to
allow user-defined macros.
• New toRd() generic in the tools package to convert objects to
fragments of Rd code, and added "fragment" argument to Rd2txt(),
Rd2HTML(), and Rd2latex() to support it.
• Directory R_HOME/share/texmf now follows the TDS conventions, so
can be set as a texmf tree (‘root directory’ in MiKTeX parlance).
• S3 generic functions now use correct S4 inheritance when
dispatching on an S4 object. See ?Methods, section on “Methods
for S3 Generic Functions” for recommendations and details.
• format.pval() gains a ... argument to pass arguments such as
nsmall to format(). (Wish of PR#9574)
• legend() supports title.adj. (Wish of PR#13415)
• Added support for subsetting "raster" objects, plus assigning to
a subset, conversion to a matrix (of colour strings), and
comparisons (== and !=).
• Added a new parseLatex() function (and related functions
deparseLatex() and latexToUtf8()) to support conversion of
bibliographic entries for display in R.
• Text rendering of \itemize in help uses a Unicode bullet in UTF-8
and most single-byte Windows locales.
• Added support for polygons with holes to the graphics engine.
This is implemented for the pdf(), postscript(),
x11(type="cairo"), windows(), and quartz() devices (and
associated raster formats), but not for x11(type="Xlib") or
xfig() or pictex(). The user-level interface is the polypath()
function in graphics and grid.path() in grid.
• File NEWS is now generated at installation with a slightly
different format: it will be in UTF-8 on platforms using UTF-8,
and otherwise in ASCII. There is also a PDF version, NEWS.pdf,
installed at the top-level of the R distribution.
• kmeans(x, 1) now works. Further, kmeans now returns between and
total sum of squares.
• arrayInd() and which() gain an argument useNames. For arrayInd,
the default is now false, for speed reasons.
• As is done for closures, the default print method for the formula
class now displays the associated environment if it is not the
global environment.
• A new facility has been added for inserting code into a package
without re-installing it, to facilitate testing changes which can
be selectively added and backed out. See ?insertSource.
• New function readRenviron to (re-)read files in the format of
~/.Renviron and Renviron.site.
• require() will now return FALSE (and not fail) if loading the
package or one of its dependencies fails.
• aperm() now allows argument perm to be a character vector when
the array has named dimnames (as the results of table() calls
do). Similarly, array() allows MARGIN to be a character vector.
(Based on suggestions of Michael Lachmann.)
• Package utils now exports and documents functions
aspell_package_Rd_files() and aspell_package_vignettes() for
spell checking package Rd files and vignettes using Aspell,
Ispell or Hunspell.
• Package news can now be given in Rd format, and news() prefers
these inst/NEWS.Rd files to old-style plain text NEWS or
inst/NEWS files.
• New simple function packageVersion().
• The PCRE library has been updated to version 8.10.
• The standard Unix-alike terminal interface declares its name to
readline as 'R', so that can be used for conditional sections in
~/.inputrc files.
• ‘Writing R Extensions’ now stresses that the standard sections in
.Rd files (other than \alias, \keyword and \note) are intended to
be unique, and the conversion tools now drop duplicates with a
warning.
The .Rd conversion tools also warn about an unrecognized type in
a \docType section.
• ecdf() objects now have a quantile() method.
• format() methods for date-time objects now attempt to make use of
a "tzone" attribute with "%Z" and "%z" formats, but it is not
always possible. (Wish of PR#14358.)
• tools::texi2dvi(file, clean = TRUE) now works in more cases (e.g.
where emulation is used and when file is not in the current
directory).
• New function droplevels() to remove unused factor levels.
• system(command, intern = TRUE) now gives an error on a Unix-alike
(as well as on Windows) if command cannot be run. It reports a
non-success exit status from running command as a warning.
On a Unix-alike an attempt is made to return the actual exit
status of the command in system(intern = FALSE): previously this
had been system-dependent but on POSIX-compliant systems the
value return was 256 times the status.
• system() has a new argument ignore.stdout which can be used to
(portably) ignore standard output.
• system(intern = TRUE) and pipe() connections are guaranteed to be
available on all builds of R.
• Sys.which() has been altered to return "" if the command is not
found (even on Solaris).
• A facility for defining reference-based S4 classes (in the OOP
style of Java, C++, etc.) has been added experimentally to
package methods; see ?ReferenceClasses.
• The predict method for "loess" fits gains an na.action argument
which defaults to na.pass rather than the previous default of
na.omit.
Predictions from "loess" fits are now named from the row names of
newdata.
• Parsing errors detected during Sweave() processing will now be
reported referencing their original location in the source file.
• New adjustcolor() utility, e.g., for simple translucent color
schemes.
• qr() now has a trivial lm method with a simple (fast) validity
check.
• An experimental new programming model has been added to package
methods for reference (OOP-style) classes and methods. See
?ReferenceClasses.
• bzip2 has been updated to version 1.0.6 (bug-fix release).
--with-system-bzlib now requires at least version 1.0.6.
• R now provides jss.cls and jss.bst (the class and bib style file
for the Journal of Statistical Software) as well as RJournal.bib
and Rnews.bib, and R CMD ensures that the .bst and .bib files are
found by BibTeX.
• Functions using the TAR environment variable no longer quote the
value when making system calls. This allows values such as tar
--force-local, but does require additional quotes in, e.g., TAR =
"'/path with spaces/mytar'".
DEPRECATED & DEFUNCT:
• Supplying the parser with a character string containing both
octal/hex and Unicode escapes is now an error.
• File extension .C for C++ code files in packages is now defunct.
• R CMD check no longer supports configuration files containing
Perl configuration variables: use the environment variables
documented in ‘R Internals’ instead.
• The save argument of require() now defaults to FALSE and save =
TRUE is now deprecated. (This facility is very rarely actually
used, and was superseded by the Depends field of the DESCRIPTION
file long ago.)
• R CMD check --no-latex is deprecated in favour of --no-manual.
• R CMD Sd2Rd is formally deprecated and will be removed in R
2.13.0.
PACKAGE INSTALLATION:
• install.packages() has a new argument libs_only to optionally
pass --libs-only to R CMD INSTALL and works analogously for
Windows binary installs (to add support for 64- or 32-bit
Windows).
• When sub-architectures are in use, the installed architectures
are recorded in the Archs field of the DESCRIPTION file. There
is a new default filter, "subarch", in available.packages() to
make use of this.
Code is compiled in a copy of the src directory when a package is
installed for more than one sub-architecture: this avoid problems
with cleaning the sources between building sub-architectures.
• R CMD INSTALL --libs-only no longer overrides the setting of
locking, so a previous version of the package will be restored
unless --no-lock is specified.
UTILITIES:
• R CMD Rprof|build|check are now based on R rather than Perl
scripts. The only remaining Perl scripts are the deprecated R
CMD Sd2Rd and install-info.pl (used only if install-info is not
found) as well as some maintainer-mode-only scripts.
*NB:* because these have been completely rewritten, users should
not expect undocumented details of previous implementations to
have been duplicated.
R CMD no longer manipulates the environment variables PERL5LIB
and PERLLIB.
• R CMD check has a new argument --extra-arch to confine tests to
those needed to check an additional sub-architecture.
Its check for “Subdirectory 'inst' contains no files” is more
thorough: it looks for files, and warns if there are only empty
directories.
Environment variables such as R_LIBS and those used for
customization can be set for the duration of checking _via_ a
file ~/.R/check.Renviron (in the format used by .Renviron, and
with sub-architecture specific versions such as
~/.R/check.Renviron.i386 taking precedence).
There are new options --multiarch to check the package under all
of the installed sub-architectures and --no-multiarch to confine
checking to the sub-architecture under which check is invoked.
If neither option is supplied, a test is done of installed
sub-architectures and all those which can be run on the current
OS are used.
Unless multiple sub-architectures are selected, the install done
by check for testing purposes is only of the current
sub-architecture (_via_ R CMD INSTALL --no-multiarch).
It will skip the check for non-ascii characters in code or data
if the environment variables _R_CHECK_ASCII_CODE_ or
_R_CHECK_ASCII_DATA_ are respectively set to FALSE. (Suggestion
of Vince Carey.)
• R CMD build no longer creates an INDEX file (R CMD INSTALL does
so), and --force removes (rather than overwrites) an existing
INDEX file.
It supports a file ~/.R/build.Renviron analogously to check.
It now runs build-time \Sexpr expressions in help files.
• R CMD Rd2dvi makes use of tools::texi2dvi() to process the
package manual. It is now implemented entirely in R (rather than
partially as a shell script).
• R CMD Rprof now uses utils::summaryRprof() rather than Perl. It
has new arguments to select one of the tables and to limit the
number of entries printed.
• R CMD Sweave now runs R with --vanilla so the environment setting
of R_LIBS will always be used.
C-LEVEL FACILITIES:
• lang5() and lang6() (in addition to pre-existing lang[1-4]())
convenience functions for easier construction of eval() calls.
If you have your own definition, do wrap it inside #ifndef lang5
.... #endif to keep it working with old and new R.
• Header R.h now includes only the C headers it itself needs, hence
no longer includes errno.h. (This helps avoid problems when it
is included from C++ source files.)
• Headers Rinternals.h and R_ext/Print.h include the C++ versions
of stdio.h and stdarg.h respectively if included from a C++
source file.
INSTALLATION:
• A C99 compiler is now required, and more C99 language features
will be used in the R sources.
• Tcl/Tk >= 8.4 is now required (increased from 8.3).
• System functions access, chdir and getcwd are now essential to
configure R. (In practice they have been required for some
time.)
• make check compares the output of the examples from several of
the base packages to reference output rather than the previous
output (if any). Expect some differences due to differences in
floating-point computations between platforms.
• File NEWS is no longer in the sources, but generated as part of
the installation. The primary source for changes is now
doc/NEWS.Rd.
• The popen system call is now required to build R. This ensures
the availability of system(intern = TRUE), pipe() connections and
printing from postscript().
• The pkg-config file libR.pc now also works when R is installed
using a sub-architecture.
• R has always required a BLAS that conforms to IE60559 arithmetic,
but after discovery of more real-world problems caused by a BLAS
that did not, this is tested more thoroughly in this version.
BUG FIXES:
• Calls to selectMethod() by default no longer cache inherited
methods. This could previously corrupt methods used by as().
• The densities of non-central chi-squared are now more accurate in
some cases in the extreme tails, e.g. dchisq(2000, 2, 1000), as a
series expansion was truncated too early. (PR#14105)
• pt() is more accurate in the left tail for ncp large, e.g.
pt(-1000, 3, 200). (PR#14069)
• The default C function (R_binary) for binary ops now sets the S4
bit in the result if either argument is an S4 object. (PR#13209)
• source(echo=TRUE) failed to echo comments that followed the last
statement in a file.
• S4 classes that contained one of "matrix", "array" or "ts" and
also another class now accept superclass objects in new(). Also
fixes failure to call validObject() for these classes.
• Conditional inheritance defined by argument test in
methods::setIs() will no longer be used in S4 method selection
(caching these methods could give incorrect results). See
?setIs.
• The signature of an implicit generic is now used by setGeneric()
when that does not use a definition nor explicitly set a
signature.
• A bug in callNextMethod() for some examples with "..." in the
arguments has been fixed. See file
src/library/methods/tests/nextWithDots.R in the sources.
• match(x, table) (and hence %in%) now treat "POSIXlt" consistently
with, e.g., "POSIXct".
• Built-in code dealing with environments (get(), assign(),
parent.env(), is.environment() and others) now behave
consistently to recognize S4 subclasses; is.name() also
recognizes subclasses.
• The abs.tol control parameter to nlminb() now defaults to 0.0 to
avoid false declarations of convergence in objective functions
that may go negative.
• The standard Unix-alike termination dialog to ask whether to save
the workspace takes a EOF response as n to avoid problems with a
damaged terminal connection. (PR#14332)
• Added warn.unused argument to hist.default() to allow suppression
of spurious warnings about graphical parameters used with
plot=FALSE. (PR#14341)
• predict.lm(), summary.lm(), and indeed lm() itself had issues
with residual DF in zero-weighted cases (the latter two only in
connection with empty models). (Thanks to Bill Dunlap for
spotting the predict() case.)
• aperm() treated resize = NA as resize = TRUE.
• constrOptim() now has an improved convergence criterion, notably
for cases where the minimum was (very close to) zero; further,
other tweaks inspired from code proposals by Ravi Varadhan.
• Rendering of S3 and S4 methods in man pages has been corrected
and made consistent across output formats.
• Simple markup is now allowed in \title sections in .Rd files.
• The behaviour of as.logical() on factors (to use the levels) was
lost in R 2.6.0 and has been restored.
• prompt() did not backquote some default arguments in the \usage
section. (Reported by Claudia Beleites.)
• writeBin() disallows attempts to write 2GB or more in a single
call. (PR#14362)
• new() and getClass() will now work if Class is a subclass of
"classRepresentation" and should also be faster in typical calls.
• The summary() method for data frames makes a better job of names
containing characters invalid in the current locale.
• [[ sub-assignment for factors could create an invalid factor
(reported by Bill Dunlap).
• Negate(f) would not evaluate argument f until first use of
returned function (reported by Olaf Mersmann).
• quietly=FALSE is now also an optional argument of library(), and
consequently, quietly is now propagated also for loading
dependent packages, e.g., in require(*, quietly=TRUE).
• If the loop variable in a for loop was deleted, it would be
recreated as a global variable. (Reported by Radford Neal; the
fix includes his optimizations as well.)
• Task callbacks could report the wrong expression when the task
involved parsing new code. (PR#14368)
• getNamespaceVersion() failed; this was an accidental change in
2.11.0. (PR#14374)
• identical() returned FALSE for external pointer objects even when
the pointer addresses were the same.
• L$a@x[] <- val did not duplicate in a case it should have.
• tempfile() now always gives a random file name (even if the
directory is specified) when called directly after startup and
before the R RNG had been used. (PR#14381)
• quantile(type=6) behaved inconsistently. (PR#14383)
• backSpline(.) behaved incorrectly when the knot sequence was
decreasing. (PR#14386)
• The reference BLAS included in R was assuming that 0*x and x*0
were always zero (whereas they could be NA or NaN in IEC 60559
arithmetic). This was seen in results from tcrossprod, and for
example that log(0) %*% 0 gave 0.
• The calculation of whether text was completely outside the device
region (in which case, you draw nothing) was wrong for screen
devices (which have [0, 0] at top-left). The symptom was (long)
text disappearing when resizing a screen window (to make it
smaller). (PR#14391)
• model.frame(drop.unused.levels = TRUE) did not take into account
NA values of factors when deciding to drop levels. (PR#14393)
• library.dynam.unload required an absolute path for libpath.
(PR#14385)
Both library() and loadNamespace() now record absolute paths for
use by searchpaths() and getNamespaceInfo(ns, "path").
• The self-starting model NLSstClosestX failed if some deviation
was exactly zero. (PR#14384)
• X11(type = "cairo") (and other devices such as png using
cairographics) and which use Pango font selection now work around
a bug in Pango when very small fonts (those with sizes between 0
and 1 in Pango's internal units) are requested. (PR#14369)
• Added workaround for the font problem with X11(type = "cairo")
and similar on Mac OS X whereby italic and bold styles were
interchanged. (PR#13463 amongst many other reports.)
• source(chdir = TRUE) failed to reset the working directory if it
could not be determined - that is now an error.
• Fix for crash of example(rasterImage) on x11(type="Xlib").
• Force Quartz to bring the on-screen display up-to-date
immediately before the snapshot is taken by grid.cap() in the
Cocoa implementation. (PR#14260)
• model.frame had an unstated 500 byte limit on variable names.
(Example reported by Terry Therneau.)
• The 256-byte limit on names is now documented.
• Subassignment by [, [[ or $ on an expression object with value
NULL coerced the object to a list.
CHANGES IN R VERSION 2.11.1 patched:
NEW FEATURES:
• install.packages() has a new optional argument INSTALL_opts which
can be used to pass options to R CMD INSTALL for source-package
installs.
• R CMD check now runs the package-specific tests with LANGUAGE=en
to facilitate comparison to .Rout.save files.
• sessionInfo() gives more detailed platform information, including
32/64-bit and the sub-architecture if one is used.
DEPRECATED & DEFUNCT:
• The use of Perl configuration variables for R CMD check (as
previously documented in ‘Writing R Extensions’) is deprecated
and will be removed in R 2.12.0. Use the environment variables
documented in ‘R Internals’ instead.
BUG FIXES:
• R CMD Rd2dvi failed if run from a path containing space(s). This
also affected R CMD check, which calls Rd2dvi.
• stripchart() could fail with an empty factor level. (PR#14317)
• Text help rendering of \tabular{} has been improved: under some
circumstances leading blank columns were not rendered.
• strsplit(x, fixed=TRUE) marked UTF-8 strings with the local
encoding when no splits were found.
• weighted.mean(NA, na.rm=TRUE) and similar now returns NaN again,
as it did prior to R 2.10.0.
• R CMD had a typo in its detection of whether the environment
variable TEXINPUTS was set (reported by Martin Morgan).
• The command-line parser could mistake --file=size... for one of
the options for setting limits for Ncells or Vcells.
• The internal strptime() could corrupt its copy of the timezone
which would then lead to spurious warnings. (PR#14338)
• dir.create(recursive = TRUE) could fail if one of the components
existed but was a directory on a read-only file system. (Seen on
Solaris, where the error code returned is not even listed as
possible on the man page.)
• The postscript() and pdf() devices will now allow lwd values less
than 1 (they used to force such values to be 1).
• Fixed font face for CID fonts in pdf() graphics output.
(PR#14326)
• GERaster() now checks for width or height of zero and does
nothing in those cases; previously the behaviour was undefined,
probably device-specific, and possibly dangerous.
• wilcox.test(x, y, conf.int = TRUE) failed with an unhelpful
message if x and y were constant vectors, and similarly in the
one-sample case. (PR#14329)
• Improperly calling Recall() from outside a function could cause a
segfault. (Reported by Robert McGehee.)
• \Sexpr[result=rd] in an Rd file added a spurious newline, which
was displayed as extra whitespace when rendered.
• require(save = TRUE) recorded the names of packages it failed to
load.
• packageStatus() could return a data frame with duplicate row
names which could then not be printed.
• txtProgressBar(style = 2) did not work correctly.
txtProgressBar(style = 3) did not display until a non-minimum
value was set.
• contour() did not display dashed line types properly when contour
lines were labelled. (Reported by David B. Thompson.)
• tools::undoc() again detects undocumented data objects. Of
course, this also affects R CMD check.
• ksmooth(x,NULL) no longer segfaults.
• approxfun(), approx(), splinefun() and spline() could be confused
by x values that were different but so close as to print
identically. (PR#14377)
CHANGES IN R VERSION 2.11.1:
NEW FEATURES:
• R CMD INSTALL checks if dependent packages are available early on
in the installation of source packages, thereby giving clearer
error messages.
• R CMD INSTALL --build now names the file in the format used for
Mac OS X binary files on that platform.
• BIC() in package stats4 now also works with multiple fitted
models, analogously to AIC().
DEPRECATED & DEFUNCT:
• Use of file extension .C for C++ code in packages is now
deprecated: it has caused problems for some makes on
case-insensitive file systems (although it currently works with
the recommended toolkits).
INSTALLATION:
• Command gnutar is preferred to tar when configure sets TAR. This
is needed on Mac OS 10.6, where the default tar, bsdtar 2.6.2,
has been reported to produce archives with illegal extensions to
tar (according to the POSIX standard).
BUG FIXES:
• The C function mkCharLenCE now no longer reads past len bytes
(unlikely to be a problem except in user code). (PR#14246)
• On systems without any default LD_LIBRARY_PATH (not even
/usr/local/lib), [DY]LIB_LIBRARY_PATH is now set without a
trailing colon. (PR#13637)
• More efficient implementation of utf8ToInt() on long multi-byte
strings with many multi-byte characters. (PR#14262)
• aggregate.ts() gave platform-dependent results due to rounding
error for ndeltat != 1.
• package.skeleton() sometimes failed to fix filenames for .R or
.Rd files to start with an alphanumeric. (PR#14253)
It also failed when only an S4 class without any methods was
defined. (PR#14280)
• splinefun(method = "monoH.FC") was not quite monotone in rare
cases. (PR#14215)
• Rhttpd no longer crashes due to SIGPIPE when the client closes
the connection prematurely. (PR#14266)
• format.POSIXlt() could cause a stack overflow and crash when used
on very long vectors. (PR#14267)
• Rd2latex() incorrectly escaped special characters in \usage
sections.
• mcnemar.test() could alter the levels (dropping unused levels) if
passed x and y as factors (reported by Greg Snow).
• Rd2pdf sometimes needed a further pdflatex pass to get
hyperlinked pages correct.
• interaction() produced malformed results when levels were
duplicated, causing segfaults in split().
• cut(d, breaks = <n>) now also works for "Date" or "POSIXt"
argument d. (PR#14288)
• memDecompress() could decompress incompletely rare xz-compressed
input due to incorrect documentation of xz utils. (Report and
patch from Olaf Mersmann.)
• The S4 initialize() methods for "matrix", "array", and "ts" have
been fixed to call validObject(). (PR#14284)
• R CMD INSTALL now behaves the same way with or without
--no-multiarch on platforms with only one installed architecture.
(It used to clean the src directory without --no-multiarch.)
• [<-.data.frame was not quite careful enough in assigning (and
potentially deleting) columns right-to-left. (PR#14263)
• rbeta(n, a, b) no longer occasionally returns NaN for a >> 1 > b.
(PR#14291)
• pnorm(x, log.p = TRUE) could return NaN not -Inf for x near
(minus for lower.tail=TRUE) the largest representable number.
• Compressed data files *.(txt|tab|csv).(gz|bz2|xz) were not
recognized for the list of data topics and hence for packages
using LazyData. (PR#14273)
• textConnection() did an unnecessary translation on strings in a
foreign encoding (e.g. UTF-8 strings on Windows) and so was
slower than it could have been on very long input strings.
(PR#14286)
• tools::Rd2txt() did not render poorly written Rd files
consistently with other renderers.
It computed widths of strings that would be print()ed with
escapes incorrectly, for example in the computation of column
width for \tabular.
• na.action() did not extract the na.action component as
documented.
• do.call()ing NextMethod in erroneous ways no longer segfaults.
(PR#13487)
CHANGES IN R VERSION 2.11.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• Packages must have been installed under R >= 2.10.0, as the
current help system is the only one now supported.
• A port to 64-bit Windows is now available as well as binary
package repositories: see the ‘R Administration and Installation
Manual’.
• Argument matching for primitive functions is now done in the same
way as for interpreted functions except for the deliberate
exceptions
call switch .C .Fortran .Call .External
all of which use positional matching for their first argument,
and also some internal-use-only primitives.
• The default device for command-line R at the console on Mac OS X
is now quartz() and not X11().
NEW FEATURES:
• The open modes for connections are now interpreted more
consistently. open = "r" is now equivalent to open = "rt" for
all connections. The default open = "" now means "rt" for all
connections except the compressed-file connections gzfile(),
bzfile() and xzfile() for which it means "rb".
• R CMD INSTALL now uses the internal untar() function in package
utils: this ensures that all platforms can install bzip2- and
xz-compressed tarballs. In case this causes problems (as it has
on some Windows file systems when run from Cygwin tools) it can
be overridden by the environment variable R_INSTALL_TAR: setting
this to a modern external tar program will speed up unpacking of
large (tens of Mb or more) tarballs.
• help(try.all.packages = TRUE) is much faster (although the time
taken by the OS to find all the packages the first time it is
used can dominate the time).
• R CMD check has a new option --timings to record per-example
timings in file <pkg>.Rcheck/<pkg>-Ex.timings.
• The TRE library has been updated to version 0.8.0 (minor
bugfixes).
• grep[l], [g]sub and [g]regexpr now work in bytes in an 8-bit
locales if there is no marked UTF-8 input string: this will be
somewhat faster, and for [g]sub() give the result in the native
encoding rather than in UTF-8 (which returns to the behaviour
prior to R 2.10.0).
• A new argument skipCalls has been added to browser() so that it
can report the original context when called by other debugging
functions.
• More validity checking of UTF-8 and MBCS strings is done by
agrep() and the regular-expression matching functions.
• The undocumented restriction on gregexpr() to length(text) > 0
has been removed.
• Package tcltk now sends strings to Tcl in UTF-8: this means that
strings with a marked UTF-8 encoding are supported in non-UTF-8
locales.
• The graphics engine now supports rendering of raster (bitmap)
images, though not all graphics devices can provide (full)
support. Packages providing graphics devices (e.g., Cairo,
RSvgDevice, cairoDevice) will need to be reinstalled.
There is also support in the graphics engine for capturing raster
images from graphics devices (again not supported on all graphics
devices).
• R CMD check now also checks if the package and namespace can be
unloaded: this provides a check of the .Last.lib() and
.onUnload() hook functions (unless --install=fake).
• prop.table(x) now accepts a one-dimensional table for x.
• A new function vapply() has been added, based on a suggestion
from Bill Dunlap. It requires that a template for the function
value be specified, and uses it to determine the output type and
to check for consistency in the function values.
• The main HTML help page now links to a reformatted copy of this
NEWS file. (Suggested by Henrik Bengtsson.) Package index files
link to the package DESCRIPTION and NEWS files and a list of
demos when using dynamic help.
• The [ method for class "AsIs" allows the next method to change
the underlying class. (Wish of Jens Oehlschlägel.)
• write.csv[2] no longer allow argument append to be changed: as
ever, direct calls to write.table() give more flexibility as well
as more room for error.
• The index page for HTML help for a package now collapses multiple
signatures for S4 methods into a single entry.
• The use of .required by require() and detach() has been replaced
by .Depends which is set from the Depends field of a package
(even in packages with namespaces). By default detach() prevents
such dependencies from being detached: this can be overridden by
the argument force.
• bquote() has been extended to work on function definitions.
(Wish of PR#14031).
• detach() when applied to an object other than a package returns
the environment that has been detached, to parallel attach().
• readline() in non-interactive use returns "" and does not attempt
to read from the ‘terminal’.
• New function file_ext() in package tools.
• xtfrm() is now primitive and internally generic, as this allows
S4 methods to be set on it without name-space scoping issues.
There are now "AsIs" and "difftime" methods, and the default
method uses unclass(x) if is.numeric(x) is true (which will be
faster but relies on is.numeric() having been set correctly for
the class).
• is.numeric(x) is now false for a "difftime" object
(multiplication and division make no sense for such objects).
• The default method of weighted.mean(x, w) coerces w to be numeric
(aka double); previously only integer weights were coerced. Zero
weights are handled specially so an infinite value with zero
weight does not force an NaN result.
There is now a "difftime" method.
• bug.report() now has arguments package and lib.loc to generate
bug reports about packages. When this is used, it looks for a
BugReports field in the package DESCRIPTION file, which will be
assumed to be a URL at which to submit the report, and otherwise
generates an email to the package maintainer. (Suggested by
Barry Rowlingson.)
• quantile() now has a method for the date-time class "POSIXt", and
types 1 and 3 (which never interpolate) work for Dates and
ordered factors.
• length(<POSIXlt>) now returns the length of the corresponding
abstract timedate-vector rather than always 9 (the length of the
underlying list structure). (Wish of PR#14073 and PR#10507.)
• The readline completion backend no longer sorts possible
completions alphabetically (e.g., function argument names) if R
was built with readline >= 6.
• select.list() gains a graphics argument to allow Windows/Mac
users to choose the text interface. This changes the behaviour
of new.packages(ask=TRUE) to be like update.packages(ask=TRUE) on
those platforms in using a text menu: use ask="graphics" for a
graphical menu.
• New function chooseBioCmirror() to set the "BioC_mirror" option.
• The R grammar now prevents using the argument name in signatures
of S4 methods for $ and $<-, since they will always be called
with a character string value for name. The implicit S4 generic
functions have been changed to reflect this: packages which
included name in the signature of their methods need to be
updated and re-installed.
• The handling of the method argument of glm() has been refined
following suggestions by Ioannis Kosmidis and Heather Turner.
• str() gains a new argument list.len with default 99, limiting the
number of list() items (per level), thanks to suggestions from
David Winsenius.
• Having formal arguments of an S4 method in a different order from
the generic is now an error (the warning having been ignored by
some package maintainers for a long time).
• New functions enc2native() and enc2utf8() convert character
vectors with possibly marked encodings to the current locale and
UTF-8 respectively.
• Unrecognized escapes and embedded nuls in character strings are
now an error, not just a warning. Thus option "warnEscapes" is
no longer needed. rawToChar() now removes trailing nuls
silently, but other embedded nuls become errors.
• Informational messages about masked objects displayed when a
package is attached are now more compact, using strwrap() instead
of one object per line.
• print.rle() gains argument prefix.
• download.file() gains a "curl" method, mainly for use on
platforms which have curl but not wget, but also for some
hard-to-access URLs.
• In Rd, \eqn and \deqn will render in HTML (and convert to text)
upper- and lower-case Greek letters (entered as \alpha ...),
\ldots, ..., \ge and \le.
• utf8ToInt() and intToUtf8() now map NA inputs to NA outputs.
• file() has a new argument raw which may help if it is used with
something other than a regular file, e.g. a character device.
• New function strtoi(), a wrapper for the C function strtol.
• as.octmode() and as.hexmode() now allow inputs of length other
than one.
The format() and print() methods for "octmode" now preserve names
and dimensions (as those for "hexmode" did).
The format() methods for classes "octmode" and "hexmode" gain a
width argument.
• seq.int() returns an integer result in some further cases where
seq() does, e.g. seq.int(1L, 9L, by = 2L).
• Added \subsection{}{} macro to Rd syntax, for subsections within
sections.
• n-dimensional arrays with dimension names can now be indexed by
an n-column character matrix. The indices are matched against
the dimension names. NA indices are propagated to the result.
Unmatched values and "" are not allowed and result in an error.
• interaction(drop=TRUE) uses less memory (related to PR#14121).
• summary() methods have been added to the "srcref" and "srcfile"
classes, and various encoding issues have been cleaned up.
• If option "checkPackageLicense" is set to TRUE (not currently the
default), users will be asked to agree to non-known-to-be-FOSS
package licences at first use.
• Checking setAs(a, b) methods only gives a message instead of a
warning, when one of a or b is unknown.
• New function norm() to compute a matrix norm. norm() and also
backsolve() and sample() have implicit S4 generics.
• Files Renviron.site and Rprofile.site can have
architecture-specific versions on systems with sub-architectures.
• R CMD check now (by default) also checks Rd files for
auto-generated content in need of editing, and missing argument
descriptions.
• aggregate() gains a formula method thanks to a contribution by
Arni Magnusson. The data frame method now allows summary
functions to return arbitrarily many values.
• path.expand() now propagates NA values rather than converting
them to "NA".
• file.show() now disallows NA values for file names, headers, and
pager.
• The ‘fuzz’ used by seq() and seq.int() has been reduced from 1e-7
to 1e-10, which should be ample for the double-precision
calculations used in R. It ensures that the fuzz never comes
into play with sequences of integers (wish of PR#14169).
• The default value of RSiteSearch(restrict=) has been changed to
include vignettes but to exclude R-help. The R-help archives
available have been split, with a new option of "Rhelp10" for
those from 2010.
• New function rasterImage() in the graphics package for drawing
raster images.
• stats:::extractAIC.coxph() now omits aliased terms when computing
the degrees of freedom (suggestion of Terry Therneau).
• cor() and cov() now test for misuse with non-numeric arguments,
such as the non-bug report PR#14207.
• pchisq(ncp =, log.p = TRUE) is more accurate for probabilities
near one. E.g. pchisq(80, 4, ncp=1, log.p=TRUE). (Maybe what
was meant in PR#14216.)
• maintainer() has been added, to give convenient access to the
name of the maintainer of a package (contributed by David Scott).
• sample() and sample.int() allow zero items to be sampled from a
zero-length input. sample.int() gains a default value size=n to
be more similar to sample().
• switch() returned NULL on error (not previously documented on the
help page): it now does so invisibly, analogously to
if-without-else.
It is now primitive: this means that argument EXPR is always
matched to the first argument and there is no danger of partial
matching to later named arguments.
• Primitive functions UseMethod(), attr(), attr<-(), on.exit(),
retracemem() and substitute() now use standard argument matching
(rather than positional matching). This means that all
multi-argument primitives which are not internal now use standard
argument matching except where positional matching is desirable
(as for switch(), call(), .C() ...).
• All the one-argument primitives now check that any name supplied
for their first argument is a partial match to the argument name
as documented on the help page: this also applies to replacement
functions of two arguments.
• base::which() uses a new .Internal function when arr.ind is FALSE
resulting in a 10x speedup. Thanks to Patrick Aboyoun for
implementation suggestions.
• Help conversion to text now uses the first part of \enc{}{}
markup if it is representable in the current output encoding. On
the other hand, conversion to LaTeX with the default
outputEncoding = "ASCII" uses the second part.
• A new class "listOfMethods" has been introduced to represent the
methods in a methods table, to replace the deprecated class
"MethodsList".
• any() and all() return early if possible. This may speed up
operations on long vectors.
• strptime() now accepts "%z" (for the offset from UTC in the
RFC822 format of +/-hhmm).
• The PCRE library has been updated to version 8.02, a bug-fix
release which also updates tables to Unicode 5.02.
• Functions which may use a graphical select.list() (including
menu() and install.packages()) now check on a Unix-alike that Tk
can be started (and not just capabilities("tcltk") &&
capabilities("X11")).
• The parser no longer marks strings containing octal or hex
escapes as being in UTF-8 when entered in a UTF-8 locale.
• On platforms with cairo but not Pango (notably Mac OS X) the
initial default X11() type is set to "Xlib": this avoids several
problems with font selection when done by cairo rather than Pango
(at least on Mac OS X).
• New function arrayInd() such that which(x, arr.ind = TRUE) for an
array 'x' is now equivalent to arrayInd(which(x), dim(x),
dimnames(x)).
DEPRECATED & DEFUNCT:
• Bundles of packages are defunct.
• stats::clearNames() is defunct: use unname().
• Basic regular expressions are defunct, and strsplit(), grep(),
grepl(), sub(), gsub(), regexpr() and gregexpr() no longer have
an extended argument.
• methods::trySilent() is defunct.
• index.search() (which was deprecated in 2.10.0) is no longer
exported and has a different argument list.
• Use of multiple arguments to return() is now defunct.
• The use of UseMethod() with more than two arguments is now
defunct.
• In the methods package, the "MethodsList" metadata objects which
had been superseded by hash tables (environments) since R 2.8.0
are being phased out. Objects of this class are no longer
assigned or used as metadata by the package.
getMethods() is now deprecated, with its internal use replaced by
findMethods() and other changes. Creating objects from the
"MethodsList" class is also deprecated.
• Parsing strings containing both octal/hex and Unicode escapes now
gives a warning and will become an error in R 2.12.0.
INSTALLATION:
• UTF-8 is now used for the reference manual and package manuals.
This requires LaTeX ‘2005/12/01’ or later.
• configure looks for a POSIX compliant tr, Solaris's /usr/ucb/tr
having been found to cause Rdiff to malfunction.
• configure is now generated with autoconf 2.65, which works better
on recent systems and on Mac OS X.
PACKAGE INSTALLATION:
• Characters in R source which are not translatable to the current
locale are now handled more tolerantly: these will be converted
to hex codes with a warning. Such characters are only really
portable if they appear in comments.
• R CMD INSTALL now tests that the installed package can be loaded
(and backs out the installation if it cannot): this can be
suppressed by --no-test-load. This avoids installing/updating a
package that cannot be used: common causes of failures to load
are missing/incompatible external software and missing/broken
dependent packages.
• Package installation on Windows for a package with a src
directory now checks if a DLL is created unless there is a
src/Makefile.win file: this helps catch broken installations
where the toolchain has not reported problems in building the
DLL. (Note: this can be any DLL, not just one named
<pkg-name>.dll.)
BUG FIXES:
• Using with(), eval() etc with a list with some unnamed elements
now works. (PR#14035)
• The "quick" dispatch of S4 methods for primitive functions was
not happening, forcing a search each time. (Dispatch for
closures was not affected.) A side effect is that default values
for arguments in a method that do not have defaults in the
generic will now be ignored.
• Trying to dispatch S4 methods for primitives during the search
for inherited methods slows that search down and potentially
could cause an infinite recursion. An internal switch was added
to turn off all such methods from findInheritedMethods().
• R framework installation (on Mac OS X) would not work properly if
a rogue Resources directory was present at the top level. Such a
non-symlink will now be renamed to Resources.old (and anything
previously named Resources.old removed) as part of the framework
installation process.
• The checks for conforming S4 method arguments could fail when the
signature of the generic function omitted some of the formal
arguments (in addition to ...). Arguments omitted from the
method definition but conforming (per the documentation) should
now be ignored (treated as "ANY") in dispatching.
• The computations for S4 method evaluation when ... was in the
signature could fail, treating ... as an ordinary symbol. This
has been fixed, for the known cases.
• Various ar() fitting methods have more protection for singular
fits.
• callNextMethod now works again with the drop= argument in [
• parse() and parse_Rd() miscounted columns when multibyte UTF-8
characters were present.
• Formatting of help pages has had minor improvements: extra blank
lines have been removed from the text format, and empty package
labels removed from HTML.
• cor(A, B) where A is n x 1 and B a 1-dimensional array segfaulted
or gave an internal error. (The case cor(B, A) was PR#7116.)
• cut.POSIXt() applied to a start value after the DST transition on
a DST-change day could give the wrong time for argument breaks in
units of days or longer. (PR#14208)
• do_par() UNPROTECTed too early (PR#14214)
• Subassignment x[[....]] <- y didn't check for a zero-length right
hand side, and inserted a rubbish value. (PR#14217)
• fisher.test() no longer gives a P-value *very* slightly > 1, in
some borderline cases.
• Internal function matchArgs() no longer modifies the general
purpose bits of the SEXPs that make up the formals list of R
functions. This fixes an invalid error message that would occur
when a garbage collection triggered a second call to matchArgs
for the same function _via_ a finalizer.
• gsub() in 2.10.x could fail from stack overflow for extremely
long strings due to temporary data being allocated on the stack.
Also, gsub() with fixed=TRUE is in some circumstances
considerably faster.
• Several primitives, including attributes(), attr<-()
interactive(), nargs() and proc.time(), did not check that they
were called with the correct number of arguments.
• A potential race condition in list.files() when other processes
are operating on the directory has been fixed; the code now
dynamically allocates memory for file listings in a single pass
instead of making an initial count pass.
• mean(x, trim=, na.rm = FALSE) failed to return NA if x contained
missing values. (Reported by Bill Dunlap.)
• Extreme tail behavior of, pbeta() {and hence pf()}, e.g.,
pbeta(x, 3, 2200, lower.tail=FALSE, log.p=TRUE) now returns
finite values instead of jumping to -Inf too early. (PR#14230).
• parse(text=x) misbehaved for objects x that were not coerced
internally to character, notably symbols. (Reported to R-devel
by Bill Dunlap.)
• The internal C function coerceSymbol now handles coercion to
character, and warns if coercion fails (rather than silently
returning NULL). This allows a name to be given where a
character vector is required in functions which coerce
internally.
• The interpretation by strptime() of "%c" was non-standard (not
that it is ever advisable to use locale- and system-specific
input formats).
• capabilities("X11") now works the same way on Mac OS X as on
other platforms (and as documented: it was always true for R
built with --with-aqua, as the CRAN builds are).
• The X11() device with cairo but not Pango (notably Mac OS X) now
checks validity of text strings in UTF-8 locales (since Pango
does but cairo it seems does not).
• read.fwf() misread multi-line records when n was specified.
(PR#14241)
• all.equal(tolerance = e) passes the numeric tolerance also to the
comparison of the attributes.
• pgamma(0, 0), a boundary case, now returns 0, its limit from the
left, rather than the limit from the right.
• Issuing POST requests to the internal web server could stall the
request under certain circumstances.
• gzcon( <textConnection> ), an error, no longer damages the
connection (in a way to have it segfault). (PR#14237)
• All the results from hist() now use the nominal breaks not those
adjusted by the numeric ‘fuzz’: in recent versions the nominal
breaks were reported but the 'density' referred to the intervals
used in the calculation - which mattered very slightly for one of
the extreme bins. (Based on a report by Martin Becker.)
• If xy[z].coords (used internally by many graphics functions) are
given a list as x, they now check that the list has suitable
names and give a more informative error message. (PR#13936)
CHANGES IN R VERSION 2.10.1 patched:
NEW FEATURES:
• The handling of line textures in the postscript() and pdf()
devices was set up for round end caps (the only type which
existed at the time): it has now been adjusted for butt endcaps.
• lchoose(a, k) is now defined as log(abs(choose(a,k))),
analogously to lfactorial().
• Although \eqn{} in Rd files is defined as a ‘verbatim’ macro,
many packages expected ... and \ldots to be interpreted there (as
was the case in R < 2.10.0), so this is now done (using an
ellipsis in HTML rendering).
• Escaping of braces in quoted strings in R-code sections of Rd
files is allowed again. This had been changed for the new Rd
format in R 2.10.0 but was only documented on the developer site
and was handled inconsistently by the converters: text and
example conversion removed the escapes but HTML conversion did
not.
• The PCRE library has been updated to version 8.01, a bug-fix
release.
• tools::readNEWS() now accepts a digit as the first character of a
news section.
BUG FIXES:
• Using read.table(header=TRUE) on a header with an embedded new
line would copy part of the header into the data. (PR#14103)
• qpois(p = 1, lambda = 0) now gives 0 as for all other p.
(PR#14135)
• Functions related to string comparison (e.g. unique(), match())
could cause crashes when used with strings not in the native
encoding, e.g. UTF-8 strings on Windows. (PR#14114 and PR#14125)
• x[ , drop=TRUE] dropped an NA level even if it was in use.
• The dynamic HTML help system reported the wrong MIME type for the
style sheet.
• tools::codoc() (used by R CMD check) was missing cases where the
function had no arguments but was documented to have some.
• Help links containing special characters (e.g. "?") were not
generated correctly when rendered in HTML. (PR#14155)
• lchoose(a, k) no longer wrongly gives NaN for negative a.
• ks.test() could give a p-value that was off by one observation
due to rounding error. (PR#14145)
• readBin()/readChar() when reading millions of character strings
in a single call used excessive amounts of memory (which also
slowed them down).
• R CMD SHLIB could fail if used with paths that were not
alphanumeric, e.g. contained +. (PR#14168)
• sprintf() was not re-entrant, which potentially caused problems
if an as.character() method called it.
• The quartz() device did not restore the clipping region when
filling the background for a new page. This could be observed in
multi-page bitmap output as stale outer regions of the plot.
• p.adjust(method, n) now works correctly for the rare case n >
length(p), also when method differs from "bonferroni" or "none",
thanks to a patch from Gordon Smyth.
• tools::showNonASCII() failed to detect non-ASCII characters if
iconv() (incorrectly) converted them to different ASCII
characters. (Seen on Windows only.)
• tcrossprod() wrongly failed in some cases when one of the
arguments was a vector and the other a matrix.
• [cr]bind(..., deparse.level=2) was not always giving names when
documented to do so. (Discovered whilst investigating PR#14189.)
• match(incomparables=<non-NULL>) could in rare cases
infinite-loop.
• poisson.test() needed to pass argument conf.level to
binom.test(). (PR#14195)
• The "nls" method for df.residual() gave incorrect results for
models fitted with na.action = na.exclude. (PR#14194)
• A change to options(scipen=) was only implemented when printing
next occurred, even though it should have affected intervening
calls to axis(), contour() and filledcontour().
• prettyNum(drop0trailing=TRUE) did not handle signs of imaginary
parts of complex numbers correctly (and this was used by str():
PR#14201).
• system.time() had the sys.child component wrong (copied
user.child instead) on systems with HAVE_GETRUSAGE. (PR#14210)
• Changing both line texture and line cap (end) resulted in the
latter to be omitted form the PDF code. In addition, line cap
(end) and join are now set explicitly in PDF output to ensure
correct defaults.
• The suppression of auto-rotation in bitmap() and dev2bitmap()
with the "pdfwrite" device was not working correctly.
• plot(ecdf(), log="x") no longer gives an incorrect warning.
• read.fwf() works again when argument file is a connection.
• Startup files will now be found if their paths exceed 255 bytes.
(PR#14228)
• contrasts<- (in the stats package) no longer has an undeclared
dependence on methods (introduced in 2.10.0).
CHANGES IN R VERSION 2.10.1:
NEW FEATURES:
• The PCRE library has been updated to version 8.00.
• R CMD INSTALL has new options --no-R, --no-libs, --no-data,
--no-help, --no-demo, --no-exec, and --no-inst to suppress
installation of the specified part of the package. These are
intended for special purposes (e.g. building a database of help
pages without fully installing all packages).
• The documented line-length limit of 4095 bytes when reading from
the console now also applies also to parse(file="") (which
previously had a limit of around 1024 bytes).
• A Bioconductor mirror can be set for use by setRepositories()
_via_ the option "BioC_mirror", e.g. the European mirror can be
selected by
options(BioC_mirror="http://bioconductor.statistik.tu-dortmund.de").
• Double-clicking in a tk_select.list() list box now selects the
item and closes the list box (as happens on the Windows
select.list() widget).
INSTALLATION:
• configure will be able to find a usable libtiff in some rare
circumstances where it did not previously (where libtiff needed
to be linked explicitly against -ljpeg).
• Making refman.pdf works around a problem with the indexing with
hyperref 6.79d and later.
DEPRECATED & DEFUNCT:
• The extended argument is deprecated in strsplit(), grep(),
grepl(), sub(), gsub(), regexpr() and gregexpr() (not just the
value extended = FALSE) and will be removed in R 2.11.0.
BUG FIXES:
• trigamma(x) and other psigamma(x, n) calls are now accurate for
very large abs(x). (PR#14020)
• [g]sub(perl=FALSE, fixed=FALSE) could use excessive stack space
when used with a very long vector containing some non-ASCII
strings.
• The default method of weighted.mean(na.rm = TRUE) did not omit
weights for NA observations in 2.10.0. (PR#14032)
• [g]regexpr(pattern, fixed = TRUE) returned match positions in
bytes (not characters) in an MBCS locale if pattern was a single
byte.
[g]sub(fixed = TRUE) with a single-byte pattern could conceivably
have matched part of a multibyte character in a non-UTF-8 MBCS.
• findLineNum() and setBreakpoint() would sometimes fail if the
specified file was not in the current directory.
• Package tcltk's demo(tkdensity) was broken in 2.9.0 when demo()
was changed to set par(ask = TRUE).
• gsub() with backrefs could fail on extremely long strings
(hundreds of thousands of characters) due to integer overflow in
a length calculation.
• abline(untf=TRUE) now uses a better x-grid in log-scale, e.g.,
for plot(c(1,300), c(1,300), log="xy"); abline(4,1, untf=TRUE).
• detach()/unloadNamespace() arrange to flush the package's
lazyload cache of R objects once the package/namespace is no
longer needed.
• There have been small fixes to the rendering of help, e.g.
\command is now rendered verbatim (so e.g. -- is not interpreted,
PR#14045).
Also, there are many small changes to help files where the new
converters were not rendering them in the same way as before.
• available.packages() would fail when run on a repository with no
packages meeting the filtering conditions. (PR#14042)
• rep(x, times, each = 2) gave invalid results when the times
argument was a vector longer than x. Reported by Bill Dunlap.
• An error when unloadNamespace() attempted to run the .onUnload()
function gave an error in the reporting function and so was not
reported properly.
• Text help rendering did not handle very long input lines
properly.
• promptMethods() generated signature documentation improperly.
• pgamma(x, a, lower.tail=FALSE) and qgamma(...) are now
considerably more accurate in some regions for very small a.
qgamma() now correctly returns 0 instead of NaN in similar
extreme cases, and qgamma() no longer warns in the case of small
a, see (PR#12324).
• unname() now also removes names from a zero length vector.
• Printing results from ls.str() no longer evaluates unevaluated
calls.
• complete.cases() failed on a 0-column data frame argument.
(Underlies PR#14066.)
It could return nonsensical results if no input determined the
number of cases (seen in the no-segfault tests).
• An error in nls() with a long formula could cause a segfault.
(PR#14059)
• qchisq(p, df, ncp, lower.tail = FALSE) with ncp >= 80 was
inaccurate for small p (as the help page said): it is now less
inaccurate. (In part, PR#13999.)
For ncp less than but close to 80, pchisq() and qchisq() are more
accurate for probabilities very close to 1 (a series expansion
was truncated slightly too early).
pchisq(x, df, ncp) can no longer return values just larger than
one for large values of ncp.
• intToUtf8() could fail when asked to produce 10Mb or more
strings, something it was never intended to do: unfortunately
Windows crashed R (other OSes reported a lack of resources).
(PR#14068)
• chisq.test() could fail when given argument x or y which deparsed
to more than one line. (Reported by Laurent Gauthier.)
• S4 methods are uncached whenever the namespace containing them is
unloaded (by unloadNamespace() as well as by detach(unload =
TRUE)).
• The internal record-keeping by dyn.load/dyn.unload was
incomplete, which could crash R if a DLL that registered
.External routines had earlier been unloaded.
• bessel[JY](x, nu) with nu a negative integer (a singular case) is
now correct, analogously to besselI(), see PR#13556.
• tools::file_path_as_absolute() doubled the file separator when
applied to a file such as "/vmunix" or (on Windows) "d:/afile" in
a directory for which getwd() would return a path with a trailing
separator (largely cosmetic, as reasonable file systems handle
such a path correctly). (Perhaps what was meant by PR#14078.)
• unsplit(drop = TRUE) applied to a data frame failed to pass drop
to the computation of row names. (PR#14084)
• The "difftime" method of mean() ignored its na.rm argument.
• tcltk::tk_select.list() is now more likely to remove the widget
immediately after selection is complete.
• Adding/subtracting a "difftime" object to/from a "POSIXt" or
"Date" object works again (it was broken by the addition of
Ops.difftime).
• Conversion to latex of an Rd file with no aliases failed.
• wilcox.test(conf.int=TRUE) has achieved.level corrected and, for
exact=FALSE, now returns a estimate component which does not
depend on the alternative used.
• help.search() failed when the package argument was specified.
(PR#14113)
• switch(EXPR = "A") now returns NULL, as does switch(1) (which
used to signal an error).
CHANGES IN R VERSION 2.10.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• Package help is now converted from Rd by the R-based converters
that were first introduced in 2.9.0. This means
• Packages that were installed by R-devel after 2009-08-09
should not be used with earlier versions of R, and most
aspects of package help (including the runnable examples)
will be missing if they are so used.
• Text, HTML and latex help and examples for packages installed
under the new system are converted on-demand from stored
parsed Rd files. (Conversions stored in packages installed
under R < 2.10.0 are used if no parsed Rd files are found.
It is recommended that such packages be re-installed.)
• HTML help is now generated dynamically using an HTTP server
running in the R process and listening on the loopback interface.
• Those worried about security implications of such a server
can disable it by setting the environment variable
R_DISABLE_HTTPD to a non-empty value. This disables
help.start() and HTML help (so text help is shown instead).
• The Java/Javascript search engine has been replaced by an
HTML interface to help.search(). help.start() no longer has
an argument searchEngine as it is no longer needed.
• The HTML help can now locate cross-references of the form
\link[pkg]{foo} and \link[pkg:foo]{bar} where foo is an alias
in the package, rather than the documented (basename of a)
filename (since the documentation has been much ignored).
NEW FEATURES:
• polygon(), pdf() and postscript() now have an argument
fillOddEven (default FALSE), which controls the mode used for
polygon fills of self-intersecting shapes.
• New debugonce() function; further, getOption("deparse.max.lines")
is now observed when debugging, from a code suggestion by John
Brzustowski. (PR#13647/8)
• plot() methods for "stepfun" and hence "ecdf" no longer plot
points by default for n >= 1000.
• [g]sub(perl=TRUE) now also supports "\E" in order to *end* "\U"
and "\L" case changes, thanks to a patch from Bill Dunlap.
• factor(), levels()<-, etc, now ensure that the resulting factor
levels are unique (as was always the implied intention). Factors
with duplicated levels are still constructible by low-level
means, but are now declared illegal.
• New print() (S3) method for class "function", also used for
auto-printing. Further, .Primitive functions now print and
auto-print identically. The new method is based on code
suggestions by Romain François.
• The print() and toLatex() methods for class "sessionInfo" now
show the locale in a nicer format and have arguments to suppress
locale information.
• In addition to previously only round(), there are other Math
group (S3) methods for "difftime", such as floor(), signif(),
abs(), etc.
• For completeness, old.packages() and available.packages() allow
arguments type to be specified (you could always specify
arguments available or contriburl).
• available.packages() by default only returns information on the
latest versions of packages whose version requirements are
satisfied by the currently running R.
• tools::write_PACKAGES() has a new argument latestOnly, which
defaults to TRUE when only the latest versions in the repository
will be listed in the index.
• getOption() has a new argument default that is returned if the
specified option is not set. This simplifies querying a value
and checking whether it is NULL or not.
• parse() now warns if the requested encoding is not supported.
• The "table" method of as.data.frame() gains a stringsAsFactors
argument to allow the classifying factors to be returned as
character vectors rather than the default factor type.
• If model.frame.default() encounters a character variable where
xlev indicates a factor, it now converts the variable to a factor
(with a warning).
• curve() now returns a list containing the points that w§ere
drawn.
• spineplot() now accepts axes = FALSE, for consistency with other
functions called by plot.factor().
• The Kendall and Spearman methods of cor.test() can optionally use
continuity correction when not computing exact p-values. (The
Kendall case is the wish of PR#13691.)
• R now keeps track of line numbers during execution for code
sourced with options(keep.source = TRUE). The source reference
is displayed by debugging functions such as traceback(),
browser(), recover(), and dump.frames(), and is stored as an
attribute on each element returned by sys.calls().
• More functions now have an implicit (S4) generic definition.
• quantile.default() now disallows factors (wish of PR#13631) and
its help documents what numeric-like properties its input need to
have to work correctly.
• weighted.mean() is now generic and has "Date", "POSIXct" and
"POSIXlt" methods.
• Naming subscripts (e.g. x[i=1, j=2]) in data.frame methods for [
and [[ now gives a warning. (Names are ignored in the default
method, but could have odd semantics for other methods, and do
for the data.frame ones.)
• as.data.frame() has an "aovproj" method. (Wish of PR#13505)
• as.character(x) for numeric x no longer produces strings such as
"0.30", i.e., with trailing zeros. This change also renders
levels construction in factor() more consistent.
• codocClasses(), which checks consistency of the documentation of
S4 class slots, now does so in considerably more cases. The
documentation of inherited slots (from superclasses) is now
optional. This affects R CMD check <pkg> when the package
defines S4 classes.
• codoc() now also checks S4 methods for code/documentation
mismatches.
• for(), while(), and repeat() loops now always return NULL as
their (invisible) value. This change was needed to address a
reference counting bug without creating performance penalties for
some common use cases.
• The print() method for ls.str() results now obeys an optional
digits argument.
• The method argument of glm() now allows user-contributed methods.
• More general reorder.default() replaces functionality of
reorder.factor() and reorder.character().
• The function aspell() has been added to provide an interface to
the Aspell spell-checker.
• Filters RdTextFilter() and SweaveTeXFilter() have been added to
the tools package to provide support for aspell() or other spell
checkers.
• xtabs() with the new argument sparse = TRUE now returns a sparse
Matrix, using package Matrix.
• contr.sum() etc gain an argument sparse which allows sparse
matrices to be returned.
contrasts() also gains a sparse argument which it passes to the
actual contrast function if that has a formal argument sparse.
contrasts(f, .) <- val now also works when val is a sparse
Matrix. It is planned that model.matrix() will work with such
factors f in the future.
• readNEWS() will recognize a UTF-8 byte-order mark (BOM) in the
NEWS file. However, it is safer to use only ASCII code there
because not all editors recognize BOMs.
• New utility function inheritedSlotNames() for S4 class
programming.
• tabulate() now allows NAs to pass through (and be ignored).
• If debug() is called on an S3 generic function then all methods
are debugged as well.
• Outlier symbols drawn by boxplot() now obey the outlwd argument.
Reported by Jurgen Kluge.
• svd(x) and eigen(x) now behave analogously to qr(x) in accepting
logical matrices x.
• File NEWS is now in UTF-8, and has a BOM (often invisible) on the
first line, and Emacs local variables set for UTF-8 at the end.
RShowDoc("NEWS") should display this correctly, given suitable
fonts.
• terms.formula(simplify = TRUE) now does not deparse the LHS and
so preserves non-standard responses such as `a: b` (requested by
Sundar Dorai-Raj).
• New function news() for building and querying R or package news
information.
• z^n for integer n and complex z is more accurate now if |n| <=
65536.
• factor(NULL) now returns the same as factor(character(0)) instead
of an error, and table(NULL) consequently does analogously.
• as.data.frame.vector() (and its copies) is slightly faster by
avoiding a copy if there are no names (following a suggestion of
Tim Hesterberg).
• writeLines(), writeBin() and writeChar() have a new argument
useBytes. If false, character strings with marked encodings are
translated to the current locale (as before) but if true they are
written byte-by-byte.
• iconv() has a new argument mark which can be used (by experts) to
suppress the declaration of encodings.
• DESCRIPTION file's LinkingTo specs are now recognized as
installation dependencies, and included in package management
computations.
• Standardized DESCRIPTION file License specs are now available for
package management computations.
• "\uxxxx" and "\Uxxxxxxxx" escapes can now be parsed to a UTF-8
encoded string even in non-UTF-8 locales (this has been
implemented on Windows since R 2.7.0). The semantics have been
changed slightly: a string containing such escapes is always
stored in UTF-8 (and hence is suitable for portably including
Unicode text in packages).
• New as.raw() method for "tclObj" objects (wish of PR#13758).
• Rd.sty now makes a better job of setting email addresses,
including using a monospaced font.
• textConnection() gains an encoding argument to determine how
input strings with marked encodings will be handled.
• R CMD Rd2pdf is available as a shortcut for R CMD Rd2dvi --pdf.
• R CMD check now checks links where a package is specified
(\link[pkg]{file} or \link[pkg:file]{topic}), if the package is
available. It notes if the package is not available, as in many
cases this is an error in the link.
• identical() gains three logical arguments, which allow for even
more differentiation, notably -0 and 0.
• legend() now can specify the border color of filled boxes, thanks
to a patch from Frederic Schutz.
• Indexing with a vector index to [[ ]] has now been extended to
all recursive types.
• Pairlists may now be assigned as elements of lists. (Lists could
always be created with pairlist elements, but [[<- didn't support
assigning them.)
• The parser now supports C-preprocessor-like #line directives, so
error messages and source references may refer to the original
file rather than an intermediate one.
• New functions findLineNum() and setBreakpoint() work with the
source references to find the location of source lines and set
breakpoints (using trace()) at those lines.
• Namespace importing is more careful about warning on masked
generics, thanks to a patch by Yohan Chalabi.
• detach() now has an argument character.only with the same meaning
as for library() or require().
• available.packages() gains a filters argument for specifying the
filtering operations performed on the packages found in the
repositories. A new built-in "license/FOSS" filter only retains
packages for which installation can proceed solely based on
packages which can be verified as Free or Open Source Software
(FOSS) employing the available license specifications.
• In registering an S3 class by a call to setOldClass(), the data
part (e.g., the object type) required for the class can be
included as one of the superclasses in the Classes argument.
• The argument f to showMethods() can be an expression evaluating
to a generic function, allowing methods to be shown for
non-exported generics and other nonstandard cases.
• sprintf() now supports %o for octal conversions.
• New function Sys.readlink() for information about symbolic links,
including if a file is a symbolic link.
• Package tools has new functions checkRdaFiles() and
resaveRdaFiles() to report on the format of .rda/.RData data
files, and to re-save them in a different compressed format,
including choosing the most compact format available.
A new INSTALL option, --resave-data, makes use of this.
• File ~/.R/config is used in preference to ~/.Rconfig, and these
are now documented in ‘R Installation and Administration’.
• Logic operations with complex numbers now work, as they were
always documented to, and as in S.
• arrows() and segments() allow one of x1 or y1 to be omitted to
simplify the specification of vertical or horizontal lines
(suggestion of Tim Hesterberg).
• approxfun() is faster by avoiding repeated NA checks (diagnosis
and patch by Karline Soetaert & Thomas Petzoldt).
• There are the beginnings of a Nynorsk translation by Karl Ove
Hufthammer.
• stripchart() allows par bg to be passed in for the background
colour for pch = 21 (wish of PR#13984).
• New generic function .DollarNames() to enable class authors to
customize completion after the $ extractor.
• load(), save(), dput() and dump() now open a not-yet-open
connection in the appropriate mode (as other functions using
connections directly already did).
REGULAR EXPRESSIONS:
• A different regular expression engine is used for basic and
extended regexps and is also for approximate matching. This is
based on the TRE library of Ville Laurikari, a modified copy of
which is included in the R sources.
This is often faster, especially in a MBCS locale.
Some known differences are that it is less tolerant of invalid
inputs in MBCS locales, and in its interpretation of undefined
(extended) regexps such as "^*". Also, the interpretation of
ranges such as [W-z] in caseless matching is no longer to map the
range to lower case.
This engine may in future be used in ‘literal’ mode for fixed =
TRUE, and there is a compile-time option in src/main/grep.c to do
so.
• The use of repeated boundary regexps in gsub() and gregexpr() as
warned about in the help page does not work in this engine (it
did in the previous one since 2005).
• Extended (and basic) regexps now support same set of options as
for fixed = TRUE and perl = TRUE, including useBytes and support
for UTF-8-encoded strings in non-UTF-8 locales.
• agrep() now has full support for MBCS locales with a modest speed
penalty. This enables help.search() to use approximate matching
character-wise rather than byte-wise.
• [g]sub use a single-pass algorithm instead of matching twice and
so is usually faster.
• The perl = TRUE versions now work correctly in a non-UTF-8 MBCS
locale, by translating the inputs to UTF-8.
• useBytes = TRUE now inhibits the translation of inputs with
marked encodings.
• strsplit() gains a useBytes argument.
• The algorithm used by strsplit() has been reordered to batch by
elements of split: this can be much faster for fixed = FALSE (as
multiple compilation of regexps is avoided).
• The help pages, including ?regexp, have been updated and should
be consulted for details of the new implementations.
HELP & Rd FILE CHANGES:
• A new dynamic HTML help system is used by default, and may be
controlled using tools::startDynamicHelp(). With this enabled,
HTML help pages will be generated on request, resolving links by
searching through the current .libPaths(). The user may set
options("help.ports") to control which IP port is used by the
server.
• help.start() no longer sets options(htmlhelp = TRUE) (it used to
on Unix but not on Windows). Nor does it on Unix reset the
"browser" option if given an argument of that name.
Arguments update and remote are now available on all platforms:
the default is update = FALSE since the http server will update
the package index at first use.
• help() has a new argument help_type (with default set by the
option of that name) to supersede arguments offline, htmlhelp and
chmhelp (although for now they still work if help_type is unset).
There is a new type, "PDF" to allow offline PDF (rather than
PostScript).
A function offline_help_helper() will be used if this exists in
the workspace or further down the search path, otherwise the
function of that name in the utils namespace is used.
• Plain text help is now used as the fallback for HTML help (as it
always was for Compiled HTML help on Windows).
• It is possible to ask for static HTML pages to be prebuilt _via_
the configure option --enable-prebuilt-html. This may be useful
for those who wish to make HTML help available outside R, e.g. on
a local web site.
• An experimental tag \Sexpr has been added to Rd files, to
evaluate expressions at build, install, or render time.
Currently install time and render time evaluation are supported.
• Tags \if, \ifelse and \out have been added to allow
format-specific (or more general, using \Sexpr) conditional text
in man pages.
• The parse_Rd() parser has been made more tolerant of coding
errors in Rd files: now all syntax errors are reported as
warnings, and an attempt is made to continue parsing.
• parse_Rd() now has an argument fragment (default FALSE) to accept
small fragments of Rd files (so that \Sexpr can output Rd code
which is then parsed).
• parse_Rd() now always converts its input to UTF-8. The Rd2*
rendering functions have a new argument, outputEncoding, which
controls how their output is encoded.
• parse_Rd() no longer includes the newline as part of a "%"-style
comment.
• There have been various bug fixes and code reorganization in the
Rd renderers Rd2HTML, Rd2latex, Rd2txt, and Rd2ex.
All example files are now created with either ASCII or UTF-8
encoding, and the encoding is only marked in the file if there is
any non-UTF-8 code (previously it was marked if the help file had
non-ASCII contents, possibly in other sections).
• print.Rd() now adds necessary escape characters so that printing
and re-parsing an Rd object should produce an equivalent object.
• parse_Rd() was incorrectly handling multiple backslashes in R
code strings, converting 4n+3 backslashes to 2n+1 instead of
2n+2.
• parse_Rd() now recognizes the \var tag within a quoted string in
R-like text.
• parse_Rd() now treats the argument of \command as LaTeX-like,
rather than verbatim.
COMPRESSION:
• New function untar() to list or unpack tar archives, possibly
compressed. This uses either an external tar command or an
internal implementation.
• New function tar() to create (possibly compressed) tar archives.
• New functions memCompress() and memDecompress() for in-memory
compression and decompression.
• bzfile() has a compress argument to select the amount of effort
put into compression when writing.
• New function xzfile() for use with xz-compressed files. (This
can also read files compressed by some versions of lzma.)
• gzfile() looks at the file header and so can now also read
bzip2-ed files and xz-compressed files.
• There are the new options of save(compress = "bzip2") and "xz" to
use bzip2 or xz compression (which will be slower, but can give
substantially smaller files). Argument compression_level gives
finer control over the space/time tradeoffs.
load() can read such saves (but only as from this version of R).
• R CMD INSTALL/check and tools::writePACKAGES accept a wider range
of compressed tar archives. Precisely how wide depends on the
capabilities of the host system's tar command: they almost always
include .tar.bz2 archives, and with modern versions of tar other
forms of compression such as lzma and xz, and arbitrary
extensions.
• R CMD INSTALL has a new option --data-compress to control the
compression used when lazy-loading data. New possibilities are
--data-compress=bzip2 which will give ca 15% better compression
at the expense of slower installation times, and
--data-compress=xz, often giving even better compression on large
datasets at the expense of much longer installation times. (The
latter is used for the recommended packages: it is particularly
effective for survival.)
• file() for open = "", "r" or "rt" will automagically detect
compressed files (from gzip, bzip2 or xz). This means that
compressed files can be specified by file name (rather than _via_
a gzfile() connection) to read.table(), readlines(), scan() and
so on.
• data() can handle compressed text files with extensions
.{txt,tab,csv}.{gz,bz2,xz} .
DEPRECATED & DEFUNCT:
• png(type="cairo1") is defunct: the value is no longer recognized.
• tools::Rd_parse() is defunct (as this version of R uses only Rd
version 2).
• Use of file ~/.Rconf (which was deprecated in favour of
~/.Rconfig in 2004) has finally been removed.
• Bundles of packages are deprecated. See ‘Writing R Extensions’
for the steps needed to unbundle a bundle.
• help() arguments offline, htmlhelp and chmhelp are deprecated in
favour of help_type.
• clearNames() (in package stats) is deprecated for unname().
• Basic regular expressions (extended = FALSE) are deprecated in
strsplit, grep and friends. There is a precise POSIX standard
for them, but it is not what recent RE engines implement, and it
seems that in almost all cases package authors intended fixed =
TRUE when using extended = FALSE.
• methods::trySilent() is deprecated in favour of try(silent=TRUE)
or - more efficiently and flexibly - something like
tryCatch(error = function(e) e).
• index.search() is deprecated: there are no longer directories of
types other than help.
INSTALLATION:
• cairo >= 1.2 is now required (1.2.0 was released in July 2006)
for cairo-based graphics devices (which remain optional).
• A suitable iconv() is now required: support for configure option
--without-iconv has been withdrawn (it was deprecated in R
2.5.0).
• Perl is no longer ‘essential’. R can be built without it, but
scripts R CMD build, check, Rprof and Sd2d currently require it.
• A system glob function is now essential (a working Sys.glob() has
been assumed since R 2.9.0 at least).
• C99 support for MBCS is now required, and configure option
--disable-mbcs has been withdrawn.
• Having a version of tar capable of automagically detecting
compressed archives is useful for utils::untar(), and so gtar (a
common name for GNU tar) is preferred to tar: set environment
variable TAR to specify a particular tar command.
INTERNATIONALIZATION:
• There is some makefile support for adding/updating translations
in packages: see po/README and ‘Writing R Extensions’.
There is support for the use of dngettext for C-level
translations in packages: see ‘Writing R Extensions’.
BUG FIXES:
• Assigning an extra 0-length column to a data frame by DF[, "foo"]
<- value now works in most cases (by filling with NAs) or fails.
(It used to give a corrupt data frame.)
• validObject() avoids an error during evaluation in the case of
various incorrect slot definitions.
• n:m now returns a result of type "integer" in a few more boundary
cases.
• The zap.ind argument to printCoefmat() did not usually work as
other code attempted to ensure that non-zero values had a
non-zero representation.
• printCoefmat() formatted groups of columns together, not just the
cs.ind group but also the zap.ind group and a residual group. It
now formats all columns except the cs.ind group separately (and
zaps the zap.ind group column-by-column). The main effect will
be see in the output from print.anova(), as this grouped SS-like
columns in the zap.ind group.
• R_ReplDLLinit() initializes the top-level jump so that some
embedded applications on Windows no longer crash on error.
• identical() failed to take the encoding of character strings into
account, so identical byte patterns are not necessarily identical
strings, and similarly Latin-1 and UTF-8 versions of the same
string differ in byte pattern.
• methods(f) used to warn unnecessarily for an S4 generic f which
had been created based on an existing S3 generic.
• The check for consistent ordering of superclasses was not
ignoring all conditional relations (the symptom was usually
spurious warnings for classes extending "array").
• Trying to assign into a raw vector with an index vector
containing NAs could cause a segfault. Reported by Hervé Pagès.
• Rscript could segfault if (by user error) its filename argument
was missing. Reported by Martin Morgan.
• getAnywhere() (and functions that use it, including argument
completion in the console) did not handle special built-in
functions. Reported by Romain Francois.
• order() was missing a PROTECT() call and so could segfault when
called on character data under certain (rare) circumstances
involving marked non-native encodings.
• prettyNum(z, drop0trailing=TRUE) did not work correctly when z
was a complex vector. Consequently, str(z, ...) also did not.
(PR#13985)
• make distclean removed too many files in etc/ if builddir =
srcdir.
• R CMD replaced TEXINPUTS rather than appending to it (as
documented and intended).
• help.start() no longer fails on unix when "browser" is a
function.
• pbeta(x, ..., log.p = TRUE) is sometimes more accurate, e.g., for
very small x.
• Unserializing a pre-2.8 workspace containing pure ASCII character
objects with a Latin-1 or UTF-8 encoding would corrupt the
CHARSXP cache.
**************************************************
* *
* 2.9 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.9.2 patched
NEW FEATURES
o On systems using ICU for collation (including Mac OS X), using
Sys.setlocale() to change the LC_COLLATE setting is more
likely to change the collation provided by ICU.
BUG FIXES
o On systems using zipped data and help (Windows) the names of
datasets could clash with temporary filenames used when
running examples, causing errors.
o as.complex() sometimes warned about NAs on coercions and
sometimes not (when the C function asComplex was used, e.g. on
list elements). (PR#13942)
o cat() on an unopened connection could close it twice, and
with file() connections segfaulted on some systems.
o Printing a list could segfault if the elements are nested too
deeply.
CHANGES IN R VERSION 2.9.2
NEW FEATURES
o install.packages(NULL) now lists packages only once even if they
occur in more than one repository (as the latest compatible
version of those available will always be downloaded).
o approxfun() and approx() now accept a 'rule' of length two, for
easy specification of different interpolation rules on left and
right.
They no longer segfault for invalid zero-length specification
of 'yleft, 'yright', or 'f'.
o seq_along(x) is now equivalent to seq_len(length(x)) even where
length() has an S3/S4 method; previously it (intentionally)
always used the default method for length().
o PCRE has been updated to version 7.9 (for bug fixes).
o agrep() uses 64-bit ints where available on 32-bit platforms
and so may do a better job with complex matches.
(E.g. PR#13789, which failed only on 32-bit systems.)
DEPRECATED & DEFUNCT
o R CMD Rd2txt is deprecated. (It is just a wrapper for
R CMD Rdconv -t txt.)
o tools::Rd_parse() is deprecated and will be removed in 2.10.0
(which will use only Rd version 2).
BUG FIXES
o parse_Rd() still did not handle source reference encodings
properly.
o The C utility function PrintValue no longer attempts to print
attributes for CHARSXPs as those attributes are used
internally for the CHARSXP cache. This fixes a segfault when
calling it on a CHARSXP from C code.
o PDF graphics output was producing two instances of anything
drawn with the symbol font face. (Report from Baptiste Auguie.)
o length(x) <- newval and grep() could cause memory corruption.
(PR#13837)
o If model.matrix() was given too large a model, it could crash
R. (PR#13838, fix found by Olaf Mersmann.)
o gzcon() (used by load()) would re-open an open connection,
leaking a file descriptor each time. (PR#13841)
o The checks for inconsistent inheritance reported by setClass()
now detect inconsistent superclasses and give better warning
messages.
o print.anova() failed to recognize the column labelled
P(>|Chi|) from a Poisson/binomial GLM anova as a p-value
column in order to format it appropriately (and as a
consequence it gave no significance stars).
o A missing PROTECT caused rare segfaults during calls to
load(). (PR#13880, fix found by Bill Dunlap.)
o gsub() in a non-UTF-8 locale with a marked UTF-8 input
could in rare circumstances overrun a buffer and so segfault.
o R CMD Rdconv --version was not working correctly.
o Missing PROTECTs in nlm() caused "random" errors. (PR#13381 by
Adam D.I. Kramer, analysis and suggested fix by Bill Dunlap.)
o Some extreme cases of pbeta(log.p = TRUE) are more accurate
(finite values < -700 rather than -Inf). (PR#13786)
pbeta() now reports on more cases where the asymptotic
expansions lose accuracy (the underlying TOMS708 C code was
ignoring some of these, including the PR#13786 example).
o new.env(hash = TRUE, size = NA) now works the way it has been
documented to for a long time.
o tcltk::tk_choose.files(multi = TRUE) produces better-formatted
output with filenames containing spaces. (PR#13875)
o R CMD check --use-valgrind did not run valgrind on the package tests.
o The tclvalue() and the print() and as.xxx methods for class
"tclObj" crashed R with an invalid object -- seen with an
object saved from an earlier session.
o R CMD BATCH garbled options -d <debugger> (useful for
valgrind, although --debugger=valgrind always worked)
o INSTALL with LazyData and Encoding declared in DESCRIPTION
might have left options("encoding") set for the rest of the
package installation.
CHANGES IN R VERSION 2.9.1
NEW FEATURES
o New function anyDuplicated(x) returns 0 (= FALSE) or the index
of the first duplicated entry of x.
o matplot(), matlines() and matpoints() now also obey a 'lend'
argument, determining line end styles. (Wish of PR#13619).
o bw.SJ(), bw.bcv() and bw.ucv() now gain an optional 'tol'
argument allowing more accurate estimates.
o new.packages() no longer regards packages with the same name
as a member of an installed bundle as 'new' (this is now
consistent with the dependency checks in install.packages()).
It no longer reports on partially installed bundles (since
members can be updated individually if a bundle is unbundled).
o old.packages() and hence updates.packages() will look for
updates to members of package bundles before updates to the
whole bundle: this allow bundles to be split and installations
updated.
o nlminb() gives better non-convergence messages in some cases.
o S3 method dispatch will support S4 class inheritance for S3
methods, for primitives and via UseMethod(), if the argument
S3methods=TRUE is given to setClass(). S4 method dispatch
will use S3 per-object inheritance if S3Class() is set on the
object. See ?Methods and the paper referenced there.
o R CMD INSTALL is more tolerant of (malformed) packages with a
'man' directory but no validly named .Rd files.
o R CMD check now reports where options are used that cause some
of the checks to be skipped.
o RSiteSearch has been updated to be consistent with the new
layout of the search site itself, which now includes separate
options for vignettes, views, and r-sig-mixed-models, as well
as changed names for r-help. (Contributed by Jonathan Baron.)
o That R CMD check makes use of a
<pkg>/tests/Examples/<pkg>-Ex.Rout.save file as a reference
result is now documented in 'Writing R Extensions'.
DEPRECATED & DEFUNCT
o print.atomic() (defunct since 1.9.0) has been removed since it
caused confusion for an S4 class union "atomic".
o png(type="cairo1") is deprecated -- it was only needed for
platforms with 1.0 <= cairo < 1.2.
BUG FIXES
o The ... argument was not handled properly when ... was found
in the enclosure of the current function, rather than in the
function header itself. (This caused integrate() to fail in
certain cases.)
o col2rgb("#00000080", TRUE) would return the background colour.
(Reported by Hadley Wickham.)
o interaction() now ensures that the levels of the result are unique.
o packageDescription() and hence sessionInfo() now report the correct
package version also for a non-attached loaded namespace of
a version different from the default lib.loc.
o smoothScatter() now also works when e.g. xlim[2] < xlim[1].
o Invalid use of sprintf() such as sprintf("%S%") now give an error
instead of a segmentation fault, as do very unusual cases such as
sprintf("%s", tryCatch(stop(), error=identity)). (It was
always documented that misuse could crash R in
platform-dependent ways.)
o parse_Rd() would mishandle braces when they occurred at
the start of a line within an R string in an Rd file (reported
by Alex Couture-Beil) or when they occurred in an R comment
(reported by Mark Bravington).
o readNEWS() missed version numbers with more than one digit.
o building R --without-x no longer fails (PR#13665)
o printCoefmat(cbind(0,1)) now works too (PR#13677)
o bw.SJ(c(1:99, 1e6)) now works too.
o Rd2txt() could not handle empty descriptions of items in an Rd
file (reported by Mark Bravington), and did not wrap long lists
of arguments if they were given in a single item.
o stars() would do a partial plot when called with plot = FALSE;
it now consistently returns the locations of the stars.
o Rd2latex() could not handle empty sections.
o old.packages() and hence update.packages() would fail on a
repository which contained only one package but with multiple
versions of that package.
o as.character.Rd() added extra braces when displaying two-argument
macros. (Report and fix by Manuel Eugster.)
o unsplit() was misbehaving in the case of single-column data
frames. (Reported by Will Gray.)
o as(I(1), "vector") and similar coercions from objects of
"unregistered" S3 classes now work.
o srcref records produced by parse() and parse_Rd() did not record
the encoding of the source file. (Reported by Romain Francois.)
o The X11 version of View() was misbehaving in MBCS locales, and
PgUp/PgDn now behave better, thanks to a patch from Ei-ji Nakama.
o R CMD check looked at the environment variable PDFLATEX, but
as from R 2.8.1 R CMD Rd2dvi used R_PDFLATEXCMD in
preference, and that was set by R CMD (and not PDFLATEX). Now
R CMD check looks at R_PDFLATEXCMD.
o sprintf() now signals an error when the result of single format
specification would be longer than the limit (8192 bytes); it would
return "somewhat random" results or segfault previously. (PR#13667)
Further, arguments of type "language" or "symbol" are no longer
allowed, as these, e.g., sprintf("%s", quote(list())), typically
lead to unexpected results or hard to understand error messages.
o The new (in 2.9.0) 'stringsAsFactors' argument to expand.grid()
was not working: it now does work but has default TRUE for
backwards compatibility.
o tcrossprod(<1d-array>, <matrix>) now does work when the arguments
are of compatible dimensions.
o qbinom() now is accurate also in (large size, small prob)
cases. (PR#13711)
o The calculation of the Spearman p-value in cor.test() is
slightly more accurate in some cases. (PR#13574)
o The digamma(), trigamma() and psigamma() functions could be
inaccurate for values of x around 1e-15 due to cancellation.
(PR#13714).
o median.default() was altered in 2.8.1 to use sum() rather
than mean(), although it was still documented to use mean().
This caused problems for POSIXt objects, for which mean() but
not sum() makes sense, so the change has been reverted.
o Assigning an extra 0-length column to a data frame by
DF$foo <- value gave a corrupt data frame rather than failing.
(PR#13724) This also happened for DF[["foo"]] <- value.
o R CMD INSTALL no longer gives a spurious warning about old R
versions ignoring multiple dependencies, if the conditions are
known to be satisfied.
o The test for setting dim() allowed a value with two or more
NAs to be set on a 0-length object. (PR#13729) Also, it
allowed an even number of negative values.
o xtfrm(), rank(), sort() and order() did not always make use of
custom comparison methods specific to the class of elements
being sorted.
o Increase NAMED value on 'seq' value in for() loop so loop code
cannot modify 'seq' value.
o Prevent rectangles of size < 0.5 pixel from disappearing in
Quartz when using rastered backend. (PR#13744)
o Printing _NA_complex_ had a low-level thinko; patch thanks to
Bill Dunlap.
o CP1257 encoding for postscript/PDF has been corrected. (PR#13736)
o aov() with an error term was evaluating the ... arguments in
2.9.0 whilst checking their names, so could fail by evaluating
them in the wrong place. (PR#13733)
o The print() method for arima() failed if all coefs were fixed.
o R CMD INSTALL --no-latex was not implemented in 2.9.0 (only).
o Added a needed PROTECT call in RunFinalizers to handle cases where
the routine is called recursively from a GC in a finalizer.
o Constructing error messages about unused arguments in calls to
closures no longer evaluates the arguments.
o qr(x, LAPACK=TRUE) did not coerce integer x to numeric.
o qr.coef() misbehaved in the LAPACK case with a matrix RHS, so
that solve(qr(x, LAPACK=TRUE)) gave wrong results. (Found by
Avraham Adler, PR#13762 by Ravi Varadhan.)
CHANGES IN R VERSION 2.9.0
NEW FEATURES
o Package 'Matrix' is now a recommended package contained in the
basic R distribution. It provides S4 classes and methods for
dense and sparse matrices, often by using the numerical
libraries Lapack and from the SuiteSparse collection CHOLMOD,
CSparse, and SPQR among others.
o pdf() and postscript() gain a 'useKerning' argument to place
strings using kerning (which had previously been ignored in
display but not in strwidth), based in part on an idea and
code from Ei-ji Nakama. The default is TRUE.
Kerning involving spaces is now ignored (it was previously
only used in the computation of string widths).
o seq.default() and seq.int() ensure that the result is within the
interval [from, to] even when the last value would previously
have been slightly out of range because of the allowance for
rounding error in computing the number of elements.
o boxplot() gains a simple 'matrix' method, enabling boxplot(mat)
instead of boxplot(data.frame(mat)).
o zip.file.extract() gains an optional 'dir' argument (but use
unzip() instead).
o source() with 'encoding' specified (and not as "unknown") marks
the encoding of character strings in Latin-1 and UTF-8
locales.
o parse(text=z) now marks the encoding of character strings in
Latin-1 and UTF-8 locales if 'z' is of known encoding (that is
all elements are either ASCII or marked as Latin-1 or UTF-8).
o sprintf() does stricter error checking on input formats to
avoid passing invalid formats to the OS (which have a tendency
to crash under such inputs).
o expand.grid() gains a 'stringsAsFactors' argument to ask for
automatic conversion of character vectors to factors (which
happened for many years but was not previously documented).
[This did not actually work prior to R 2.9.1.]
o bxp() now computes the 'ylim' including the outliers only if
'outline = TRUE'. (Wish of PR#13196)
o barplot() gains a 'args.legend' argument. (Wish of PR#13265).
o RweaveLatexSetup() now accepts all (and not just some) options
passed through from Sweave()
o cumsum(x) and cumprod(x) for double precision x now use a long
double accumulator where available and so more closely match
sum() and prod() in potentially being more accurate.
o plot() methods for "stepfun" (and hence "ecdf") gain an 'col'
argument, allowing to set all three colors simultaneously.
o Iterating over a factor in a for loop now coerces to a character
vector (rather than using the integer codes).
o data.frame() now recycles columns of list arguments, not just
vectors and factors.
o plot.ts(plot.type="multiple") now makes use of *.lab and
*.axis graphical parameters (wish of PR#13134 and 13135).
o Classes can be exported from a name space using the NAMESPACE
file directive 'exportClassPattern' which has the same syntax
as 'exportPattern'.
o strftime() now converts its first argument with as.POSIXlt()
and so is no longer an alias for format.POSIXLt.
o body<-() now treats list values consistently with other
types: they no longer need to be wrapped in a list() call.
o option("pdfbrowser") is now set on Windows as well as on Unix-alikes.
o object.size() now returns an object of class "object_size" and
has a print() method.
o [col/row]Sums(), *Means() now have an additional '...' argument,
so that they can more easily be turned into generic functions.
o Package 'tools' contains dependsOnPkgs() to compute reverse
dependencies.
o Strict type checking is now turned on: this catches more
internal corruptions, and some badly written contributed code.
o There are new functions in package 'tcltk', tk_choose.files(),
tk_choose.dir() and tk_messageBox(), analogues of functions
available on Windows (the last is an analogue of winDialog).
o Sys.glob() now does tilde expansion on all platforms.
o read.table() and friends gain a 'fileEncoding' argument to
make re-encoding of input just a little bit simpler.
o grep() gains an 'invert' argument mimicking 'grep -v/--invert'.
o strwrap() now allows a separate prefix for the first line.
o grep() has a more efficient sibling grepl() that returns a
logical vector.
o xfig() has new arguments 'defaultFont' and 'textSpecial'
contributed by Sebastian Fischmeister.
o parse() and parse_Rd() now point to syntax errors in the
reported error context, and include the filename and line and
column numbers so smart text editors can jump to the error
location.
o str(<1d-array>) now writes "[1:n(1d)]" instead of the previous
less clear "[, 1:n]".
o New function testInstalledPackage() in package 'tools' allows
the examples (and if they were installed) any package-specific
tests to be run on an installed package.
testInstalledPackages() can run all the examples and tests in
the standard and/or recommended packages. Also
testInstalledBasic() can run the basic tests (if installed).
o file.copy() now has a 'recursive' argument.
o Errors in setOldClass() will cause a previous definition to be restored.
o Ambiguities in class inheritance and method selection resulting
from duplicates in superclasses are now resolved by requiring
(if possible) consistency with all the superclass inheritance. The
rules for method selection have been revised to take advantage of
the improved ordering.
See ?Methods and the reference there related to inheritance.
o New function unzip() in package 'utils' to expand or list zip
archives.
o Replacement functions for class() and oldClass() will unset
the S4 bit when the replacement can't be an S4 object;
oldClass() will return the S3 class for S4 objects with slot
.S3Class.
o clip() takes extra steps to avoid the next graphics call
resetting the clip region.
o New function sample.int() to provide documented access to the
internal part of sample() (sampling from seq_len(n)).
o New version of withVisible() for better handling of cases like
withVisible(eval.parent(....)). Moved to package 'base' with a
view to replace .Internal(eval.with.vis) in source() later.
o showClass() which is also used to auto-print class definitions, now
mentions the package where the class comes from, if there is one.
o simulate(obj) now also works for "glm" objects and for weighted
fits, thanks in part to contributions from Ben Bolker and
Heather Turner. There is now a means to extend the methods
available for "glm" objects, as glm families can have an
optional 'simulate' component.
o S4 classes that inherit from any of the "structure" classes or
from "vector" will turn on methods for all the "Ops" group of
functions when the package containing the classes is
loaded. See class?structure.
o A mechanism now allows S4 classes to inherit from object types
"environment", "externalptr" and symbol ("name"). See ?setClass.
o demo() gains 'echo' and 'ask' arguments, with defaults similar
to example().
o library() no longer checks for the packages merged during the
re-organization of 1.9.0.
o New function poisson.test() in package 'stats' for exact test
of rates and rate ratios.
o New function isdebugged() indicates whether its argument has the
debug flag set or not.
o ls.str() [via print method] now also works when some objects in
the environment are missing().
o Subsetting S4-objects (without an explicit "[" method) no longer
preserves the class in cases like setClass("C",
contains="list"); This reverts a "bug fix" activated in R 2.8.0.
o .packages() and .find.packages() no longer check the package
info for installed packages with dumped metadata, since this
was checked when the package was installed. .packages() only
considers such packages to be validly installed (any others
were installed in a long-obsolete version of R). Both changes
speed up searches in libraries of thousands of packages.
o boxplot() uses butt line endings for its median line
(suggestion of Uwe Ligges, PR#13553).
o S4 objects passed to a non-default S3 method will be converted
to a valid S3 object with the S3 class. See the section on
inheriting from non-S4 classes in ?Classes.
o A new class "nonStructure" has been defined; classes that extend
a vector class but that should lose their slots under Math or
Ops functions should extend this class. See class?nonStructure.
o axis.POSIXct() now plots in the timezone marked for its inputs
(if any) rather than in the local time. The latter was a
deliberate choice, but is easy to select by removing the
'tzone' attribute. (Suggestion of Dan Kelley.)
o A new function classesToAM() returns an adjacency matrix
representing the inheritance of the classes specified. Allows
better human examination of the patterns, e.g. by using the
matrix as input to one of the graph packages (see the
documentation).
o X11options(antialias = "none") now works, for consistency with
X11().
o sprintf() now allows zero-length arguments (with a zero-length
result). (Suggestion of Bill Dunlap.)
o unlink() is now able to remove broken symbolic links on
Unix-alikes.
o New selectSuperClasses() utility in package 'methods'.
o HoltWinters() now allows parameters alpha and beta to be fixed
at 0 and hence beta = FALSE and gamma = FALSE are used to
specify restricted models.
o A new function smoothScatter() has been added to package
'graphics'. It is appropriate for very dense scatter plots
and uses density estimation and color to reflect density of
plotting.
DEPRECATED & DEFUNCT
o allGenerics() is defunct.
o Use of allocVector(CHARSXP ...) is defunct and gives an error.
o The compatibility define for graphics structure NewDevDesc in
GraphicsDevice.h has been removed.
o Support for versioned installs (R CMD INSTALL --with-package-versions
and install.packages(installWithVers = TRUE)) has been removed.
Packages installed with versioned names will be ignored.
o The numeric and power(0.5) forms of argument to make.link()
which were deprecated in 2.4.0 are now defunct: use power()
directly.
o Conversion to Sd and Ssgm by R CMD Rdconv is now defunct.
o Support for R --gui=gnome is now defunct (and package
gnomeGUI has been withdrwan as it used a long-obsolete version
of GNOME).
o R CMD SHLIB on Windows will call the first target (not 'all') in
Makevars[.win] in future versions: so make 'all' the first
target if you have any.
UTILITIES
o R CMD build now also uses a Makevars[.win] file for cleaning
up src/.
o R CMD Rd2dvi and R CMD check are now able to cope with Cyrillic
characters in UTF-8 if environment variable _R_CYRILLIC_TEX_
is set to a non-empty value and the latex system has suitable
fonts (thanks to a hint from Alexey Shipunov).
o New function rtags() in package 'utils' that provides etags-like
indexing capabilities for R code files.
New front-end script R CMD rtags provides an interface to the
rtags() function (see R CMD rtags --help for details).
o New environment variable R_TEXI2DVICMD to hold the path (if any)
to 'texi2dvi' found at configure time: this now provides the
default to option("texi2dvi").
o massage-Examples.pl has been replaced by the R function
tools:::massageExamples().
o R CMD REMOVE now uses remove.packages() and hence removes all
members of a bundle.
o R CMD SHLIB is now an R script and has a new option -n aka
--dry-run to show what commands would be run. The same code
is used on Unix and Windows.
o R CMD Rdconv has new options --package and --version to set the
corresponding fields in HTML conversion.
o R CMD check runs the package tests with a custom startup file,
currently containing 'options(useFancyQuotes = FALSE)'.
Those tests are run by an R script: using a tests/Makefile
(undocumented) no longer works.
o R CMD config now knows about DYLIB_EXT and SHLIB_EXT, for use
in configure files.
o R CMD BATCH has a new option --no-timing to suppress printing
out the session timing.
o R CMD Rd2dvi can now work on an installed package.
o R CMD check no longer loads package 'tcltk' when checking for
code problems, so more problems may be reported.
o For R CMD SHLIB on Windows the default 'all' target only makes
the DLL, and no longer call targets 'before' and 'after'.
Rd CONVERSION
o Rd files have an optional \Rdversion{} section, which if
missing defaults to 1.0. There is support for version 1.1, a
slightly modified version with the following changes:
- The warnings for \code{} inside example are suppressed.
- Whitespace between arguments in \item and \section is
accepted without a warning (see below).
- $ is treated literally in text, even for latex conversions.
- \ is only an escape before % { } \ .
- \R, \dots and \ldots can be followed by {}, and it is
recommended that they when not followed by whitespace.
- The obsolete interpretation of \Alpha etc is no longer done.
o Rd conversion now handles ^ ~ < > | correctly in non-code
environments (such as \samp), and # and _ even in latex
conversion (but $ still needs to be escaped in version 1.0).
o Whitespace between first and second arguments is now accepted
for \item and \section, e.g. \item{foo} {some value}.
Previously arguments after whitespace were silently ignored,
and a warning is given for version 1.0 files.
o The Rd files created by prompt() and friends are declared to be
version 1.1.
o \alias now supports the escaping of { as well as of %, and this
is recommended.
o parse_Rd(), an experimental parser for Rd files, and Rd2txt(),
Rd2HTML(), Rd2latex() and Rd2ex(), even more experimental
converters, have been added to package 'tools'.
o R CMD check runs the package's Rd files through parse_Rd() for a
stricter syntax check. This can be suppressed by setting
_R_CHECK_RD_PARSE_ to FALSE.
o Added markup \verb, which displays like \code, but parses as
verbatim text. Currently only supported by parse_Rd() and
Rd2HTML().
INSTALLATION
o The shell used by the 'R' script and other shell scripts
intended to be run directly can be specified at installation
time by setting the (precious) configure variable R_SHELL.
o libtool has been updated to 2.2.6a.
o --with-ICU is now the default: this means that ICU will be
used for collation on Mac OS >= 10.4.
o make install-tests can be used to install the test files,
to allowed an installed version of R to be tested -- see the
R-admin manual. This is also supported by the function
testInstalledPackages() in package 'tools'.
o 'make install' using a parallel make should now work.
o 'make check' now always re-makes and re-runs the package
examples, which are now collated in the locale's order (and
not ASCII order).
o configure will now set the default optimization level for
gfortran on x86_64 Linux to -O as -O2 has caused problems with
gfortran 4.3.x.
PACKAGE INSTALLATION
o install.packages() is able to infer that repos=NULL was
intended from the extension on the file name specified as 'pkgs'.
On Mac OS X it now supports local binary packages with .tar.gz
extension. Nonetheless .tgz remains the preferred extension
and is expected in repositories.
It now checks >= version dependencies for dependent packages,
and so will install a newer version of a dependency if needed
and available on the repositories.
The library being installed into is considered when looking
for installed packages if it is not already part of
.libPaths() (as INSTALL already does).
It has a new argument 'Ncpus' to support parallel installs of
source packages.
o HTML links will be resolved first to the standard packages: this
avoids other installed packages diverting help on e.g. qr()
and plot() to themselves. The HTML files are only "touched" if
they have changed.
o A check is done that the R files can be parsed: this both
prevents a broken package without lazy-loading from being
installed and gives better diagnostics.
o install.packages() gains a 'configure.vars' argument, and both
this and 'configure.args' get their defaults from options().
o There is a unified R script for INSTALL on both Unix-alike and
Windows that takes option names used by either in the past.
It adds --no-multiarch to disable building other than the main
sub-architecture, and allows multiple instances of
--configure-args and --configure-vars (which will be
concatenated).
New option --install-tests will install any package-specific
tests.
o Times in the Packaged: and Built: fields are now recorded in
UTC, and in most cases in ISO 8601 format.
C-LEVEL FACILITIES
o A helper function, asCharacterFactor, converts from factors to
character vectors.
BUG FIXES
o The postscript() output for setting text is faster and smaller.
o Subsetting a data frame with duplicate column names without
selecting columns (e.g. z[i,]) no longer makes the column
names unique. This was never documented, but some packages
have assumed it.
o data.frame() no longer ignores row names on objects if the
first name is empty. (PR#13230: this has been the behaviour
for a long time, but apparently undocumented.)
o deparse(control="S_compatible") now never uses backticks.
o X-spline drawing is improved for cases where the control
points are located well off the edges of the device.
The symptom of this problem is the error "reached MAXNUMPTS".
o exists() with mode= "any" will no longer run an active binding's
function.
o format(c(1 + 2i, NA)) no longer has extraneous space in " NA".
o mood.test() could fail in 2.8.x on large samples because of
integer overflow.
o heatmap() without a dendrogram could fail. (PR#13512)
o Checks for missing values will no longer occasionally result in
an infinite loop or stack overflow error, depending on the
compiler. Active bindings are now always considered to be
non-missing.
o Rd conversion was not accepting \p (as in \pkg} or (when using
Perl 5.10.x) \k (as in \kbd) in any preamble text in a
\value{} section, since those are nowadays interpreted by
Perl. (PR#13575)
o if(as.raw(1)) TRUE now works as expected. (PR#13630)
Also, c(as.raw(12), TRUE) or c(raw(3), pi) do.
o duplicated(<data frame>, incomparables = NA) now gives the
intended error message. (PR#13632)
o name handling of as.data.frame() has been sanitized somewhat
o Evaluating an assignment expression with a string on the left
hand side no longer destructively changes the string to a symbol
in the expression.
**************************************************
* *
* 2.8 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.8.1 patched
NEW FEATURES
o R CMD check has a new argument '--install-args' to pass
command-line arguments to INSTALL.
E.g. --install-args="--docs=normal" on Windows if the HTML
Help Workshop is not installed.
o R-Forge has been added to R_HOME/etc/repositories, so it will
be available interactively in setRepositories().
o The compiled loess() code has been updated to the current
version of dloess from Netlib. This includes patches from Ben
Tyner which correct some errors when degree = 0 and hence
solve PR#13570.
INSTALLATION
o --with-ICU is now supported (and recommended) on Mac OS X using
Apple's supplied port. Note however that the locale category
LC_COLLATE cannot be changed whilst R is running on Apple's
version of ICU.
Configure supports a wider range of ICU versions on other
OSes: version 3.0 should suffice, and 3.2, 3.8 and 4.0 have
been tested.
BUG FIXES
o grid-based plots no longer reset the base text size to the
default 96dpi in cairo-based bitmap devices.
o Rd conversion was incorrectly parsing \\\* and \\\{ (and other
cases with an odd number of backslashes greater than one).
Text conversion of \code{\ etc} was incorrect (a single
backslash stands for itself inside \code).
\code{} inside \examples{} is now fixed up (but the warning
remains, since it will be handled incorrectly in earlier
versions of R).
o as.matrix.data.frame() could fail if coercion changed the
dimension of one of the columns (as e.g. the coercion of a "Surv"
object to a character vector does).
o When extracting part of a complex list structure using [[]]
with a vector index, the extracted part was not marked for
duplication on change. (PR#13411)
o Assigning an additional element to a pairlist/language element
by x[["foo"]] <- value did not name the additional element.
o .Call() and .External() were not accepting "NativeSymbolInfo"
and "NativeSymbol" objects as claimed. (Patch from Olaf
Mersmann.)
o codoc() was missing some default value mismatches with
unescaped backslashes, e.g. final="\\" needs to be written as
final="\\\\" in the Rd file.
The reports on values now give strings in the original quoted
format (with \ and " escaped).
o The $<- method for pairlists (including language objects)
failed to duplicate if NAMED was 2.
o read.table(blank.lines.skip = FALSE) gave a final empty row on
files with less than 5 lines (PR#13433).
o Workaround for a bug in some versions of iconv that was seen
with output lines of more than 10,000 bytes and with
re-encoding requested on an output connection.
o The fullrefman.{dvi,pdf} duplicated part I in part II (at
least on some systems).
o cbind() could crash with a zero-length input and a list result.
o pdf(colormodel = "gray") was setting the stroke colour for fills.
o file.show() with multiple files would only show multiple
copies of the first one. (PR#13469)
o formatC(mode = "character") was documented to work, but
did not. (PR#13474)
o besselI(x,.., expon.scaled=TRUE) now gives accurate results for
x < 1e5 whereas it previously underflowed for x >~= 1500.
Further, besselJ(x,..) also computes up to 1e5 (instead of 1e4).
o str() was incorrectly warning about its option component
'formatNum' set by strOptions().
o nls(algorithm = "port") did not accept the [factor] notation.
(PR#13650)
o The relational (aka "comparison") operators are now binary, also in
a lower level sense, and an expression as "<"(1) is now erronous.
o The 'offset' argument for lm() and glm() is not longer
documented to be allowed to be of length 1: this has not been
true for a long time.
o format.info(x) is now also correct when x has no finite content.
o predict.lm() now works correctly when the fit had more than
one offset (possibly specified both in the formula and as an
argument). This function is called by predict.glm(), so the
same isses are corrected there.
o besselI(x, nu) with nu a negative integer (a singular case) is now
correct. (PR#13556)
CHANGES IN R VERSION 2.8.1
NEW FEATURES
o sum() now has a method for "difftime" objects (via the Summary
group).
max(), min() and range() applied to "difftime" object(s) now
return a result in the common units of the objects, if there
is one.
o installed.packages() is now tolerant of malformed DESCRIPTION
files in installed packages (it ignores them, with a warning).
o qt() now works for 0 < df < 1.
o For consistency with matrix() and array(), dimnames(x) <-
list() removes the dimnames (as assigning NULL would do).
It was previously an error.
o nlminb() copies names from 'start' to the parameter vector
used (for consistency with optim()).
o legend() gains a 'title.col' argument: the title colour was
previously set from the first element of 'text.col' (which
remains the default).
o In an Rd file, use of top-level \itemize{} inside a \value{}
block is unnecessary and almost always gave a faulty
conversion. Most cases are now detected and corrected, but
give a warning as such code will not work correctly in earlier
versins of R.
Also, use of \code{} inside a code block such as \examples{}
will give a erroneous conversion that is now detected and
warned against.
o Autoflushing of stdout is turned on when Rd processing, so
warnings/error are likely to appear in the right place in
redirected output (such as that from R CMD check).
UTILITIES
o R_PDFLATEXCMD is added to the environment variables set by
'R CMD' and is used by R CMD Rd2dvi.
R_LATEXCMD, R_PDFLATEXCMD, R_MAKEINDEXCMD and R_DVIPSCMD
default to 'latex', 'pdflatex', 'makeindex' and 'dvips'
respectively if no suitable executable was found at configure
time (since they might well be available at run time,
particularly for binary installations of R). This affects
R CMD Rd2dvi and help(offline=TRUE).
R CMD Rd2dvi now gives an explicit error message if latex (or
pdflatex) fails.
R CMD Rd2dvi gains a --no-index argument: processing some
special characters on PDF indices gave errors which used to be
ignored.
DEPRECATED & DEFUNCT
o R CMD INSTALL --with-package-versions is deprecated (and
support has always been incomplete on Windows).
So is install.packages(installWithVers = TRUE).
o Rd conversion to Sd and Ssgm is now deprecated as we no longer
have any means to check the results (and Sd is long obsolete).
BUG FIXES
o add1.glm() no longer warns if applied to a binomial glm with a
factor response.
o aggregate.data.frame() now does something sensible with a
zero-column 'x' rather than failing with an obscure error
message. It gives an explicit error message if called with a
zero-row 'x'.
o integrate() now accepts integer results from f(): as documented,
but only double was accepted.
o contrib.url() produced an incorrect URL for the type
"mac.binary".
o pairwise.wilcox.test() did not pass on the 'paired' argument
(caught by Matthias Kohl)
o bmp(), jpeg(), and png() on unix with type="cairo" would segfault
on closure if the output file could not be opened.
o tiff() on unix would not write the output file for the first page
when multiple pages were plotted.
o str(1 + structure(1, class = "test")) no longer recurses indefinitely.
o pf(x, .., ncp, lower.tail=FALSE, log=TRUE) is much more accurate
for large x now.
o dev2bitmap() failed in 2.8.0 if 'taa' and 'gaa' were both NA.
o Under rare circumstances equality tests for character strings
could fail to report equality in 2.8.0 in the same way as
2.7.2. (This needed a current encoding of Latin-1 or UTF-8,
one string whose encoding was marked as that encoding and one
that was marked as "unknown". In that circumstance the two
strings are not actually known to be equal, but earlier
versions of R assumed that "unknown" meant the current
encoding, and this is done once again.)
o R CMD config could echo messages from GNU make if called from
within a Makefile (as e.g. package Rcpp did), especially from
within a parallel make run.
o Rounding error could affect window(extend=TRUE) when applied
to monthly series. (PR#13272)
o Offline help on a Unix-alike now works even if options
"latexcmd" and "dvipscmd" contain spaces
(e.g. "dvips -Pmy_printer").
Informative error messages are given if running latex or dvips
fail.
o Using plot.lm() on a "glm" object since 2.7.1 with which=5
caused the Pearson rather than deviance residuals to be used
in which=2 or 3 (including in the default case). (Thanks to
Effie Greathouse and Greg Snow.)
plot.lm() did not report on omitting observations with
leverage one if they also had residual exactly zero. This was
seen in example(occupationalStatus).
o deparse(nlines=) no longer pads short results with blank
lines. (PR#13299)
o legend(xpd=) now restores 'xpd' correctly. (PR#12756)
o The "formula" method for lines() now works if 'subset' is
supplied and no 'data' argument (as that for points() did).
o Sweave() now takes the defaults for the options 'pdf.version'
and 'pdf.encoding' of its RweaveLatex driver from pdf.options().
o prettyNum(x, drop0trailing=TRUE) treated "1.1e20" as "1.1e2"
and hence str() did as well, in 2.8.0 only.
o dchisq(x, df, ncp) no longer hangs for large x and ncp > 0,
and is more accurate in some cases (PR#13309).
o installed.packages(lib.loc = D, priority="NA") now also works when
D contains a single package. (PR#13332)
o legend(...., merge=TRUE) now warns and has no effect in the
case where no line segments are drawn. (PR#13340)
o transform.data.frame() works better when two or more columns are
added.
o Deparsing argument lists with non-syntactic names (e.g. that for
transform()) now uses backticks rather than double quotes to
produce syntactically valid output.
o matrix() failed to check for 0-length 'dimnames': it now
treats them as NULL (as array did). (PR#13361)
o 0^NA is now NA, not Inf, consistent with x^NA, x != 1.
o anova.mlm() did not work if T had only one row (including
e.g. the case M = ~1).
o axis.POSIXct() mislabelled for some time ranges of a few hours
(reported by Martin Becker).
o mantelhaen.test() with 'exact=FALSE' was not respecting
'alternative'. It now does one-sided tests similarly to
prop.test().
o anova.mlm() had trouble with some designs where near-zero rows of
the tranformation matrix were not removed (caught by Nils Skutara).
o Rd conversion was handling expressions like
'\item{foo}{see \eqn{x}}' (with one argument to \eqn
immediately followed by a right brace) incorrectly, sometimes
giving a spurious warning about 'missing text'.
o R CMD INSTALL used the C locale to install the DESCRIPTION
file, and so escaped non-ASCII characters in packages with a
declared encoding of "latin1" or "UTF-8". (However, the
installed DESCRIPTION file was rarely used since the dumped
metadata are available.)
o xspline() now respects inline par settings.
It and grid.xspline() now handle the special case of only two
control points, and splines with control points that are
located well outside the device (e.g., a zoomed view of a
larger curve). (Both cases were giving the error "reached
MAXNUMPTS").
o In setClass("C", contains="list"); x <- new("C", 1:3), x[2:3] now
remains of class "C". So does rep(x, 2) or rep.int(x, 3).
[NOTE: This "feature" has been reverted for R 2.9.0, see above]
o median.default() now also works for "numeric"-like vectors.
o The pdf() device can now handle the case where an image uses a
very large number of colours with different levels of
semi-transparency (alpha-values). It used to segfault.
(Also PR#13264.)
o window() failed to apply a fuzz to 'start' or 'end' and so
sometimes warned incorrectly for time series with 'freq' not a
power of two (e.g. 12 or 24).
o unique.default() now preserves the "tzone" attribute on
"POSIXct" objects.
o If all the packages had dependency lists of equal lengths,
occasionally install.packages() would compute an incorrect
sort order.
o col(x, as.factor=TRUE) and row(x, as.factor=TRUE) would fail
if x had no column (row) names. It was documented
incorrectly, and now returns a matrix factor.
o setRepositories() failed if "pkgType" was set to
"mac.binary.leopard".
o formals<-() changed the body of the function if this was a
length-one list.
o body<-() failed if the function had no arguments. It now
warns if discarding elements from a 'value' of type "expression".
o qr.coef() failed in the complex case for non-square systems.
(PR#13305)
o plot.dendrogram(horizontal=TRUE) did not not plot 'edgetext'
at the correct locations. (PR#13313)
o The starting point for plot.acf(ci.type="ma") was lag 0 when it
should have been lag 1. (PR#13071)
o There was an obscure bug with srcrefs, which could put the
parser into a condition giving "Error: bad value" on any input
CHANGES IN R VERSION 2.8.0
SIGNIFICANT USER-VISIBLE CHANGES
o var(), cov(), cor(), sd() etc now by default (when 'use' is not
specified) return NA in many cases where they signalled an
error before.
NEW FEATURES
o abbreviate() gains an optional argument 'strict' allowing cheap
and fast strict abbrevation.
o The "lm" methods of add1(), anova() and drop1() warn if they are
mis-used on an essentially exact fit.
o as.array() is now generic, gains a '...' argument.
o New function as.hexmode() for converting integers in hex format.
format.hexmode() and as.character.hexmode() gain an 'upper.case'
argument.
o bitmap() and dev2bitmap() gain support for anti-aliasing.
The default type has been changed to 'png16m', which supports
anti-aliasing.
o Box.test() gains a 'fitdf' argument to adjust the degrees of
freedom if applied to residuals.
o browseURL() has a new argument 'encodeIfNeeded' to use
URLencode() in cases where it seems likely that would be
helpful. (Unfortunately, those are hard to guess.)
o by() gains a 'simplify' argument, passed to tapply().
o capabilities() gains a new argument "tiff" to report if tiff()
is operational.
o chol2inv() now treats <numeric(1)> as a [1 x 1]-matrix.
o cov() and cor() have the option 'use = "everything"' as default,
and so does var() with its default 'na.rm = FALSE'. This
returns NA instead of signalling an error for NA observations.
Another new option is 'use = "na.or.complete"' which is the default
for var(*, na.rm=FALSE).
var(double(0), na.rm= L) now returns NA instead of signalling an error,
for both L = TRUE or FALSE, as one consequence of these changes.
o data.matrix() now tries harder to convert non-numeric columns,
via as.numeric() or as(, "numeric").
o dev.interactive() is able to recognize the standard screen
devices if getOption("device") is a function (as well as by name).
o dev.new() gains a '...' argument which can be used to pass
named arguments which will be used if appropriate to the
device selected.
o dimnames(x) <- value extends 'value' if it a list and too
short, and 'x' is an array. This allows constructions such as
dimnames(x)[[1]] <- 1:3 to work whether or not 'x' already has
dimnames.
o format(), formatC() and prettyNum() gain a new argument
'drop0trailing' which can be used to suppress trailing "0"s.
o format() now works for environments; also print(env) and str(env)
share the same code for environments.
o It is now possible to create and open a text-mode gzfile()
connection by explicitly using e.g. open="rt".
o New help.request() function for compiling an e-mail to R-help
according to "the rules". It is built on the new utility,
create.post() on which also bug.report() is based now; both
thanks to a contribution by Heather Turner.
o help.search() now assumes that non-ASCII items are in latin1
if that makes sense (all known examples on CRAN are).
o HoltWinters() and decompose() use a (statistically) more
efficient computation for seasonal fits (they used to waste
one period).
o intToUtf8() and intToBits() now accept numeric vectors,
truncating them to integers.
o is.unsorted() gains an argument 'strictly'. It now works for
classed objects with a >= or > method (as incorrectly
documented earlier).
o library() no longer warns about the masking objects that are
identical(.,.) to those they mask.
o lockBinding(), unlockBinding(), lockEnvironment() and
makeActiveBinding() now all return invisibly (they always
return NULL).
o mood.test() now behaves better in the presence of ties.
o na.action() now works on fits of classes "lm", "glm", ....
o optim(.., method="SANN", .., trace=TRUE) is now customizable via
the 'REPORT' control argument, thanks to code proposals by
Thomas Petzoldt.
o The 'factory-fresh' defaults for options("device") have been
changed to refer to the devices as functions in the grDevices
namespace and not as names. This makes it more likely that
the incorrect (since R 2.5.0) assumption in packages that
get(getOption("device"))() will work will catch users of those
packages.
o pch=16 now has no border (for consistency with 15, 17, 18) and
hence is now different from pch=19.
o pdf() has new arguments 'useDingbats' (set this to FALSE for use
with broken viewers) and 'colormodel'. It now only references
the ZapfDingbats font if it is used (for small opaque circles).
The default PDF version is now 1.4, since viewers that do not
accept that are now rare.
Different viewers were rendering consecutive text() calls on a
pdf() device in different ways where translucency was
involved. The PDF generated has been changed to force each
call to be rendered separately (which is the way xpdf or
ghostscript was rendering, but Acrobat was forming a
transparency group), which is consistent with other graphics
devices supporting semi-transparency.
o plot.dendrogram() has new arguments (xlim, ylim) which allows
zooming into a hiearchical clustering dendrogram.
o plot.ecdf() now defaults to pch=19 so as to better convey the
left-closed line segments.
o plot.histogram() gains an 'ann' argument. (Wish from Ben Bolker.)
o plot(<lm_obj>) now warns when it omits points with leverage one
from a plot.
o Plotmath now recognizes 'aleph' and 'nabla' (the Adobe Symbol
'gradient' glyph) as symbol names.
o polyroot() no longer has a maximum degree.
o The alpha/alphamax argument of the 'nls' and 'mle' profile()
methods is used to compute confidence limits for univariate
t-statistics rather than a confidence region for all the
parameters (and not just those being profiled).
o quantile.default() allows 'probs' to stray just beyond [0, 1],
to allow for computed values.
o New functions rawConnection() and rawConnectionValue() allow
raw vectors to be treated as connections.
o read.dcf() now consistently gives an error for malformed DCF.
o read.fwf() no longer passes its default for 'as.is' to
read.table(): this allows the latter's default to be used.
o readBin(), writeBin(), readChar() and writeChar() now open a
connection which was not already open in an appropriate binary
mode rather than the default mode.
readLines(), cat() and sink() now open a connection which was
not already open in an appropriate text mode rather than the
default mode.
o readCitationFile() (and hence citation) now reads a package's
CITATION file in the package's declared encoding (if there is one).
o The behaviour of readLines() for incomplete final lines on
binary-mode connections has been changed to be like blocking
rather than non-blocking text-mode connections.
o A new reorder.character() method has been added. This allows
use of 'reorder(x, ...)' as a shorthand for
'reorder(factor(x), ...)' when 'x' is a character vector.
o round() now computes in long doubles where possible so the
results are more likely to be correct to representation error.
o rug() now uses axis()'s new arguments from 2.7.2, hence no
longer draws an axis line.
o save() (optionally, but by default) checks for the existence
of objects before opening the file/connection (wish of
PR#12543).
o segments(), arrows() and rect() allow zero-length
coordinates. (Wish of PR#11192)
o set.seed(kind=NULL) now takes 'kind' from a saved seed if the
workspace has been restored or .Random.seed has been set in
some other way. Previously it took the 'currently used' value,
which was "default" unless random numbers had been used in
the current session. Similarly for the values reported by
RNGkind(). (Related to PR#12567.)
set.seed() gains a 'normal.kind' argument.
o setEPS() and setPS() gain '...' to allow other arguments to be
passed to ps.options(), including overriding 'width' and 'height'.
o setTimeLimit() function to set limits on the CPU
and/or elapsed time for each top-level computation, and
setSessionLimit() to set limits for the rest of the session.
o splinefun() has a new method = "monoH.FC" for monotone Hermite
spline interpolation.
o sprintf() optionally supports the %a/%A notation of C99 (if the
platform does, including under Windows).
o str()'s default method gains a 'formatNum' function argument which
is used for formatting numeric vectors. Note that this is very
slightly not backward compatible.
o The summary() method for class "ecdf" now uses a print()
method rather than printing directly.
o summary.manova() uses a stabler computation of the test
statistics, and gains a 'tol' argument to allow highly
correlated responses to be explored (with probable loss of
accuracy). Similar changes have been made to anova.mlm() and
anova.mlmlist().
o Sweave() now writes concordance information inside a
\Sconcordance LaTeX macro, which allows it to be inserted into
PDF output.
o system.time() now uses lazy evaluation rather than
eval/substitute, which results in more natural scoping. (PR#11169)
o In table(), 'exclude=NULL' now does something also for factor
arguments. A new 'useNA' argument allows you to control
whether to add NA levels unconditionally or only when present
in data. A new convenience function addNA() gives similar
functionality by adding NA levels to individual factors.
o unlink() tries the literal pattern if it does not match with
wildcards interpreted -- this helps with e.g. unlink("a[b")
which previously needed to be unlink("a\\[b").
o update.packages() gains an argument 'oldPkgs', where
new.packages() and old.packages() get 'instPkgs'. These allow
consideration of only subsets of packages instead of all
installed ones.
o which(b) is somewhat faster now, notably for named vectors, thanks
to a suggestion by Henrik Bengtsson.
o New generic function xtfrm() as an auxiliary helper for
sort(), order() and rank(). This should return a numeric
vector that sorts in the same way as its input. The default
method supports any class with ==, > and is.na() methods but
specific methods can be much faster.
As a side-effect, rank() will now work better on classed
objects, although possibly rather slowly.
o X11() and capabilities("X11") now catch some X11 I/O errors that
previously terminated R. These were rare and have only be
seen with a misconfigured X11 setup on some versions of X11.
o The handling of nuls in character strings has been changed --
they are no longer allowed, and attempting to create such a
string now gives a truncation warning (unless
options("warnEscapes") is false).
o The user environment and profile files can now be specified via
environment variables 'R_ENVIRON_USER' and 'R_PROFILE_USER',
respectively.
o ?pkg::topic and ?pkg:::topic now find help on 'topic' from
package 'pkg' (and not help on :: or :::).
o ??topic now does help.search("topic"); variations such as
??pkg::topic or field??topic are also supported.
o There is support for using ICU (International Components for
Unicode) for collation, enabled by configure option --with-ICU
on a Unix-alike and by a setting in MkRules on Windows.
Function icuSetCollate() allows the collation rules (including
the locale) to be tuned.
o If S4 method dispatch is on and S4 objects are found as
attributes, show() rather than print() is used to print the
S4 attributes.
o Starting package tcltk without access to Tk (e.g. no available
display) is now a warning rather than an error, as Tcl
will still be usable. (On most platforms it was possible to
inhibit Tk by not having DISPLAY set, but not on Windows nor
Mac OS X builds with --with-aqua.)
o Using $ on a non-subsettable object (such as a function) is
now an error (rather than returning NULL).
o Hexadecimal numerical constants (such as 0xab.cdp+12) may now
contain a decimal point.
o PCRE has been updated to version 7.8 (mainly bug fixes).
NEW FEATURES IN PACKAGE 'methods'
o S3 classes that are registered by a call to setOldClass() now
have the S3 class as a special slot, and therefore so do
any S4 classes that contain them. This mechanism is used to
support S4 classes that extend S3 classes, to the extent
possible. See ?Classes, ?setOldClass, and ?S3Class.
The treatment of special pseudo-classes "matrix", "array", and
"ts" as S4 classes has also been modified to be more
consistent and, within limitations imposed by special
treatment of these objects in the base code, to allow other
classes to contain them. See class?ts.
A general feature added to implement "ts" and also
"data.frame" as S4 classes is that an S4 class definition can
be supplied to setOldClass() when the S3 class has known
attributes of known class.
setOldClass() now saves all the S3 inheritance, allowing the
calls to be built up in stages, rather than including all the
S3 classes in each call. Also allows as(x,"S3") to generate
valid S3 inheritance from the stored definition. See ?S3.
o S4 methods may now be defined corresponding to "...", by
creating a generic function that has "..." as its signature.
A method will be selected and called if all the arguments
matching "..." are from this class or a subclass. See ?dotsMethods.
o New functions S3Part() and S3Class() provide access to the
corresponding S3 object and class for S4 classes that extend
either an S3 class or a basic R object type.
o show(<class definition>) now also shows the class name.
INSTALLATION
o If sub-architectures are used, a copy of Rscript is installed
in ${R_HOME}/bin/exec${R_ARCH} (since that in ${R_HOME}/bin
and /usr/bin might be overwritten in a subsequent installation).
PACKAGE INSTALLATION
o LazyLoad: yes is now the default, so packages wanting to avoid
lazy loading must set 'LazyLoad: no' (or an equivalent value) in
the DESCRIPTION file.
o R CMD INSTALL will now fail if it finds a non-executable
'configure' script in the package -- this usually indicates a
file system with insufficient permissions. If a
non-executable 'cleanup' script is found and either
--clean or --preclean is used, a warning is given.
DEPRECATED & DEFUNCT
o Use in packages of the graphics headers Rdevices.h and
Rgraphics.h is defunct: they are no longer installed.
o options("par.ask.default") is defunct in favour of
"device.ask.default".
o The 'device-independent' family "symbol" is defunct: use
font=5 (base) or fontface=5 (grid) instead.
o gammaCody() is defunct.
o par("gamma") is defunct.
o 'methods' package functions getAccess(), getAllMethods(),
getClassName(), getClassPackage(), getExtends(),
getProperties(), getPrototype(), getSubclasses, getVirtual(),
mlistMetaName(), removeMethodsObject() and seemsS4Object() are
defunct.
o Use of a non-integer .Random.seed is now an error. (R itself
has never generated such values, but user code has, and
R >= 2.6.0 has given a warning.)
o methods::allGenerics() is deprecated.
o In package installation, SaveImage: yes is now ignored, and
any use of the field will give a warning.
o unserialize() no longer accepts character strings as input.
o The C macro 'allocString' has been removed -- use 'mkChar' and
variants.
o Use of allocVector(CHARSXP ...) is deprecated and gives a warning.
UTILITIES
o The default for 'stylepath' in Sweave's (default) RweaveLatex
driver is now FALSE rather than TRUE if
SWEAVE_STYLEPATH_DEFAULT is unset : see ?RweaveLatex.
To support this, tools::texi2dvi adds the R 'texmf' directory
to the input search path.
o R CMD Rd2dvi now previews PDF output (as was documented) if
R_PDFVIEWER is set (as it will normally be on a Unix-alike but
not on Windows, where the file association is used by default).
o R CMD check checks for binary executable files (which should not
appear in a source package), using a suitable 'file' if
available, else by name.
o R CMD check now also uses codetools' checks on the body of S4
methods.
C-LEVEL FACILITIES
o R_ReadConsole will now be called with a buffer size of 4096
bytes (rather than 1024): maintainers of alternative
front-ends should check that they do not have a smaller limit.
o Graphics structure NewDevDesc has been renamed to DevDesc.
For now there is a compatibility define in GraphicsDevice.h,
but it will be removed in R 2.9.0.
o PROTECT and UNPROTECT macros now work even with R_NO_REMAP.
BUG FIXES
o @ now gives an error (and not just a warning) if it is being
applied to a non-S4 object.
o R CMD appends (not prepends) R's texmf path to TEXINPUTS.
o Objects generated by new() from S4 classes should now all
satisfy isS4(object). Previously, prototypes not of object
type S4 would not be S4 objects. new() applied to basic,
non-S4 classes still will (and should) return non-S4 objects.
o Functions writing to connections such as writeLines(),
writeBin(), writeChar(), save(), dput() and dump() now check
more carefully that the connections are opened for writing,
including connections that they open themselves.
Similarly functions which read such as readLines(), scan(),
dcf() and parse() check connections for being open for reading.
o Equality comparison of factors with <NA> levels now works
correctly again.
o Repainting of open X11 View() windows is now done whilst an
X11 dataentry window is in use.
o Indexing of data frames with NA column names and a numeric or
logical column index works again even if columns with NA names
are selected.
o on.exit() has been fixed to use lexical scope in determining
where to evaluate the exit action when the on.exit expression
appears in a function argument.
o rank() now consistently returns a double result for
ties.method = "average" and an integer result otherwise.
Previously the storage mode depended on 'na.last' and if any
NAs were present.
o The "lm" methods of add1(), and drop1() now also work on a model
fit with na.action = na.exclude.
o median(c(x = NA_real_)) no longer has spurious names().
o isoreg(x, y) now returns the correct result also when x has ties,
in all cases.
o What na.action() does is now correctly documented.
o source() with echo=TRUE now behaves like ordinary automatic
printing, by using methods::show() for S4 objects.
o Several bugs fixed in `?` with topics: it previously died trying
to construct some error messages; for S4 methods, class "ANY"
should be used for omitted arguments and default methods.
o trace() should create missing traceable classes in the global
environment, not in baseenv() where other classes will not be
found.
o Class inheritance using explicit coerce= methods via setIs()
failed to coerce the argument in method dispatch. With this
fixed, a mechanism was needed to prohibit such inheritance
when it would break the generic function (e.g.,
initialize). See ?setIs and ?setGeneric.
o RSiteSearch() encodes its query (it seems this is occasionally
needed on some platforms, but encoding other fields is harmful).
o 'incomparables' in match() was looking up indices in the wrong
table.
o write.dcf() did not escape "." according to Debian policy
(PR#12816).
o col2rgb() sometimes opened a graphics device unnecessarily, and
col2rgb(NA) did not return a transparent color, as documented.
o pdf(family="Japan") [and other CIDfonts] no longer seg.faults
when writing "western" text strings.
o as.list() applied to an environment now forces promises and
returns values.
o Promises capturing calls to sys.parent() and friends did not
work properly when evaluated via method dispatch for internal
S3 generics.
o The default "pkgType" option for non-CRAN builds of R on Mac OS X
is now correctly "source" as documented.
o The default R_LIBS_USER path in AQUA builds now matches the
Mac-specifc path used by the Mac GUI: ~/Library/R/x.y/library
o splinefun() with natural splines incorrectly evaluated derivatives
to the left of the first knot. (PR#13132, fix thanks to
Berwin Turlach)
o anova(glm(..., y=FALSE)) now works. (PR#13098)
o cut.Date(x, "weeks") could fail if x has only one unique value
which fell on a week boundary. (PR#13159)
**************************************************
* *
* 2.7 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.7.2 patched
BUG FIXES
o within(<dataframe>, { ... }) now also works when '...' removes
more than one column.
o Attempting to open an X11() device on a non-existent display
when one is already open on another display now gives a
warning rather than terminating R via a fatal X11 error.
(PR#12628)
o source() did not respect the setting of options("keep.source")
when setting source references.
o seek() now clears the pushback on a text-mode connection if
used to set a new position. (PR#12640)
o quartz() would segfault if asked to create a file for bitmap
output which could not be created. This applied also to the
type="quartz" versions of bmp(), jpeg(), png() and tiff().
o dnbinom(0, size, mu = <large>) suffered from cancellation in 2.7.2
only.
CHANGES IN R VERSION 2.7.2
NEW FEATURES
o sprintf() returns elements of the result in UTF-8 when the
format or any character input has a corresponding element
declared as UTF-8. Similarly for paste(), elements of the
result are in UTF-8 when any input to that element is declared
as UTF-8.
o axis() has new arguments 'col.ticks' and 'lwd.ticks' to allow
the colour and line width of ticks to be set separately from
that of the line (e.g. to set one or the other to transparent
or zero width).
o legend() has a new argument 'box.col' to set the colour of the
enclosing box.
o legend() gains a 'xpd' argument to make it easier to place a
legend in the margins or outer margins.
o stripchart() now passes '...' to title() (as well as to
plot.default() and axis()). (Wish of PR#12202)
o help.search() has new argument 'searchEngine' to go directly
to the search form: this is needed by users of Firefox 3.0.x,
for x <= 6, to workaround a bug in interpreting the search
results pages.
BUG FIXES
o Plotmath computed the glyph metrics for the wrong character (and
perhaps for a non-existent one) if this was a single-byte
character with the top bit set. An example was symbol("\300").
o sink() and cat() could divert output to a non-writable connection.
o phyper(x, 0,0,0) no longer hangs for huge x and gives 1 for x >= 0.
(PR#11813)
o plnorm(x, ..., log.p=TRUE) is now correct for x <= 0. (PR#11867)
o <data.frame>[, ch] gives an error (again!) when ch is a string not
exactly matching the column names, thanks to an oral bug report by
Matthew Dowle.
o data.frame(x=1:2, y=3:4, row.names=c("a","NA"))[c(2,NA),] has
correct row names c("NA","NA.1") again.
o The GUI data editor for dataframes did not handle escape
characters in entries properly. (PR#11897)
o PCRE has been updated to 7.7 (bugfix release).
o package.skeleton() wrongly warned about invalid code_files names
when these were not in the current directory.
o shapiro.test(c(0,0,1)) now has P value >= 0 (instead of barely
negative).
o assign() now warns if given a character vector of length > 1,
rather than silently taking the first element.
o rcond(<exactly singular matrix>) now gives 0 instead of an error.
o There was a memory leak in C function ucstoutf8 used by some
graphics devices.
o Plots of profile.mle() objects (package 'stats4') were
misbehaving when the 'which' argument had been used in their
calculation.
o dnbinom(x, size, mu=*, ..) is now more accurate for very large
'size'. The same applies to pnbinom() and rnbinom().
o axis() was ignoring par() mgp[3] if mgp was set in-line.
o Closing an X11 View() or dataentry window via its frame's
close control now works better on some window managers.
o Calling lapply() was not handling method dispatch correctly for
is.numeric(), is.matrix(), is.array(), log() and the Math2
group. This affected data.matrix() which incorrectly regarded
"Date" and "POSIXct" objects as numeric, and has been adjusted
to do so as exceptions.
o package.skeleton() was not looking for non-function objects in
its 'environment' argument.
o nls() was only finding its 'weights' argument in the case when
all the variables in the formula were of the same length and
hence that model.frame() could be used.
It was silently ignoring 'subset' and 'na.action' except in
that case. Now they are ignored only if 'data' is a list and
variables taken from 'data' are not all of the same length,
in which case a warning is given.
o The 'mle' confint() method now takes 'level' into account when
setting 'alpha' for the profile.
o within() was not handling correctly expressions that produced
NULL columns. (PR#11131)
o dev.print() and dev.copy2{eps,pdf}() now ensure that the current
device is restored as the active device even if an error
occurs. (PR#9801)
o as.Date() could fail to convert character strings representing
days on which midnight did not exist in the current timezone
(as happened in parts of Africa on 1960-01-01).
o The automatic placement of legend() with 'title' and a
reversed 'x' axis was incorrect. (PR#12019)
o The use of multiple packages in 'LinkingTo' works again, and
now works when the dependent packages are in the library to be
installed to (but not in the library path seen by R --vanilla).
o bxp() (and hence boxplot) now respects in-line graphical
parameters 'xaxp'/'yaxp' as appropriate. (PR#11463)
o barplot(log = "y") failed if there were NAs in the 'height'
argument. (PR#11585)
o pbeta() is more accurate in some cases with extreme values of
'ncp'. (PR#11277).
o edit.data.frame() no longer fails if called on a 0-column
data frame and no column is created.
o pchisq(x, df=0) was always one even for x < 0; similarly for
pgamma(x, alpha=0).
o add1() and drop1() now return a P-value of NaN in cases with
df=0 for test="Chisq" (they gave NaN until pchisq was altered
in R 2.6.2).
o The default methods of drop1() and add1() now re-evaluate in the
object's formula environment, rather than simply in the parent
(informal bug report by Werner Stahel).
o The undocumented limit of 8191 bytes on comments (from # to
the end of the line) in R code has been removed.
o qgamma() warns if used with shape < 1e-10, when it may be
unreliable. (PR#12324)
o Installing a source package was not using the package's declared
encoding (if any) as a default encoding for the help.search()
database in Meta/hsearch.rds. This could cause packages with
a default encoding to have some of their entries rejected by
help.search() in a multi-byte locale (such as a UTF-8 locale).
o duplicated() and unique() now handle 'incomparables' better,
and avoid occasional segfaults (PR#12551).
o plot(isoreg(x, y)) now plots the points correctly when 'x'
is unssorted.
o data.frame(row.names=NULL) once again behaves differently from
the default (as documented).
CHANGES IN R VERSION 2.7.1
NEW FEATURES
o tools::texi2dvi() has a new argument 'texinputs' to allow the
TeX and bibtex input paths to be specified (even on MiKTeX).
o dev.copy2pdf() gains an 'out.type' argument to allow it to be
used with cairo_pdf() or quartz(type = "pdf").
o poly() has additional checks against user error (as in PR#11243).
o The Mac OS quartz() device draws contiguous lines much faster.
o A field containing just a sign is no longer regarded as numeric
(it was on all platforms in 2.7.0, but not on most in earlier
versions of R). Similarly, '.' is now always non-numeric.
o CITATION files are now read in Latin-1: quite a few were
failing if used in a multibyte locale such as UTF-8.
o The DESCRIPTION file of a package can specify an 'OS_type' field
as either 'unix' or 'windows' to confine installation to that
OS type.
o HoltWinters() now uses optimize() rather than optim for
one-parameter problems which should be more reliable (PR#11469).
o axis() now respects the setting of par("xpd") when clipping.
o The 'factor' method of format() now preserves names, dims and
dimnames in the same way as for character and numeric inputs.
(PR#11512)
o read.DIF(*, transpose=TRUE) now allows to correctly read DIF files
produced by some versions of Excel.
DEPRECATED & DEFUNCT
o The use of unserialize() on character strings is deprecated:
that was a format used in R < 2.4.0.
o The use of embedded nuls in character strings is deprecated:
They will no longer be allowed in R 2.8.0.
UTILITIES
o R CMD check checks for possible check directories in the
sources -- in mid-2008 there were about 20 examples on CRAN.
o R CMD build tries harder to clean up the inst/doc directory
from the remnants of earlier builds.
It also removes any directories with extension .Rcheck, and
files .DS_Store and ._* (created by tar on Mac OS X under some
circumstances: it now sets environment variables to ask for
such files not to be created by that tar.)
BUG FIXES
o Encoding<- on NA_character_ converted it to "NA".
o Adobe Symbol was missing from the encodings in
tools::charset_to_Unicode.
o diag(matrix(x, 0, 0)) now returns a 0-length vector of the
correct mode, instead of always numeric.
o The parser sometimes accepted invalid quoted strings in a UTF-8
locale.
o plot.default(x, y) now dispatches to Axis() methods whether
y is NULL or not.
o On Mac OS X, the Cocoa Quartz window could close without warning
under certain circumstances (specific autorelease pool flush).
o Plotting symbols with separate border and fill colours (e.g.,
plot(pch = 21)) now works with transparent 'col', but opaque
or semi-transparent 'bg'. Previously, if 'col' was
transparent then 'bg' was ignored and nothing was drawn.
o file.path() did not work correctly in 2.7.0 if the components
had different encodings.
o merge() failed if there were no common columns and one of the
inputs had zero rows.
o expand.grid() failed if an input had length 0.
o match() does again truncate strings at embedded nuls (as newly
documented in 2.7.0).
o Because of a typo, 'pointsize' in png(type="cairo") (and jpeg,
bmp, tiff) devices was being interpreted in pixels not bigpoints.
o is() was wrong for some S3 class objects with class of length
greater than one.
o undoc() / codoc() were not checking all S4 methods in some cases.
o Use of textConnection(NULL, mode="w") could segfault.
o Use of strwidth/height(units="user") (the default) is again an
error before a user coordinate system has been set on the
device, rather than giving nonsensical values (the effect of
r31367).
o Rare string width calculations in package grid were not
interpreting the string encoding correctly.
o hasMethods(f, env) {without specified 'package'} now works better.
o A missing PROTECT could cause segfaults on string
comparisons. (PR#11421)
o str(structure(1, classID = "Pooh")) now works fine.
o A missing PROTECT could cause segfaults in if() if coercion of
the condition was required or a warning was to be given.
o plot(<table>) now uses a sensible default main title.
o validObject() called with complete=TRUE did not use inherited
validity methods for slot classes.
o Several bugs fixed in as(): the initial method lookup was not
using the table with inherited methods (so inheritance had to
be recomputed each time); coerce() should not be called
directly--it can insert invalid inherited methods; the
constructed as() methods were not retaining the function's
environment.
o influence.measures(<glm-object>) now computes the same
Cook's distance approximations as cooks.distance().
o plot(<glm>, which=5) uses more correct Cook's distance contours;
(fix to fix to PR#9316).
o pdf() and postscript() were not working correctly in 2.7.0 with
UTF-8 encoded data in a non-UTF-8 MBCS (e.g. EUC-JP on Unix,
CJK locales on Windows).
o conformMethod(), called by setMethod(), now checks better about
argument names in wrong order. Whereas it only warns currently,
it is planned to become an error in the future.
o The predict() method for prcomp() had an incorrect check for
the number of columns of 'newdata' if the columns were not named.
o The axis() function now distinguishes between setting "at" to
NULL or a zero-length vector, treating the latter as a request
for no ticks. This corrects the handling of the "x" parameter
to rug().
o glob2rx("*[*") now produces a correct regular expression.
o The canvas is no longer painted on copy or save in Cocoa Quartz.
o identify() in Quartz can now be terminated by either using popup
menu equivalent (Ctrl-click or second mouse button) or by pressing
the <Esc> key. The latter was documented but did not work.
o tools:::.check_package_depends() {called from 'R CMD check'} now
also works correctly when directory-name != package-name.
o Source references were sometimes off by a line.
o The quartz() parameter 'antialias' is no longer ignored.
o The Quartz device is now trying hard to remove anti-aliasing
effects for rasterized backends in plots that use adjacent,
borderless rectangles such as image().
o The srcfilecopy() function now adds a timestamp to the object it
creates.
o parse() would lose a token when run on stdin().
o socketConnection() was using internally the class "socket"
and not "sockconn", which caused a conflict with make.socket().
(PR#11515)
o Quartz is now trying harder to find the proper font for a given
family which resolves font issues on Mac OS X 10.4. Full font
names and PostScript names can be used interchangeably. (Note,
however that italic/oblique font faces of Helvetica are not
included in the Mac OS X 10.4 system).
o qf() no longer gives NaN when one of df1 and df2 is large and
the other is infinite (including if both are infinite); it is more
accurate e.g. for qf(1e-18, 2,4).
o qbeta(-1e10, 50, 40, log.p=TRUE) no longer hangs.
o Cocoa Quartz backend autodetection of display DPI was not
correct for screens rotated by 90 or 270 degrees.
o selectMethod("coerce", .) now uses a correct default for
'useInherited', and hence no longer may mess up the method cache.
o show() now also works on "unregistered" S3 class objects.
o formatC(*, format="fg", flag="#") is no longer dropping trailing
zeros.
o read.table(file = stdin()) with invalid input could leave the
connection in an invalid state and hence cause a later
segfault. (PR#11627)
o read.DIF() did not obey the default 'stringsAsFactors = TRUE'.
o The 'noquote' method for c() now works correctly with three or
more arguments.
o symbol() in plotmath expressions works again with non-ASCII
input on devices that use UTF-8 for the symbol font.
CHANGES IN R VERSION 2.7.0
SIGNIFICANT USER-VISIBLE CHANGES
o The default graphics device in non-interactive use is now
pdf() rather than postscript(). [PDF viewers are now
more widely available than PostScript viewers.]
The default width and height for pdf() and bitmap() have been
changed to 7 (inches) to match the screen devices.
o Most users of the X11() device will see a new device that has
different fonts, anti-aliasing of lines and fonts and
supports semi-transparent colours.
o Considerable efforts have been made to make the default output
from graphics devices as similar as possible (and in
particular close to that from postscript/pdf). Many devices
were misinterpreting 'pointsize' in some way, for example as
being in device units (pixels) rather than in points.
o Packages which include graphics devices need to be re-installed
for this version of R, with recently updated versions.
NEW FEATURES
o The apse code used by agrep() has been updated to version
0.16, with various bug fixes.
agrep() now supports multibyte character sets.
o any() and all() avoid coercing zero-length arguments (which
used a surprising amount of memory) since they cannot affect
the answer.
Coercion of other than integer arguments now gives a warning
as this is often a mistake (e.g. writing all(pr) > 0 instead
of all(pr > 0) ).
o as.Date(), as.POSIXct() and as.POSIXlt() now convert numeric
arguments (days or seconds since some epoch) provided the
'origin' argument is specified.
o New function as.octmode() to create objects such as file
permissions.
o as.POSIXlt() is now generic, and it and as.POSIXct() gain a
'...' argument. The character/factor methods now accept a
'format' argument (analogous to that for as.Date).
o New function browseVignettes() lists available vignettes in an
HTML browser with links to PDF, Rnw, and R files.
o There are new capabilities "aqua" (for the AQUA GUI and quartz()
device on Mac OS X) and "cairo" (for cairo-based graphics
devices).
o New function checkNEWS() in package 'tools' that detects common
errors in NEWS file formatting.
o deparse() gains a new argument 'nlines' to limit the number of
lines of output, and this is used internally to make several
functions more efficient.
o deriv() now knows the derivatives of digamma(x), trigamma(x)
and psigamma(x, deriv) (wrt to x).
o dir.create() has a new argument 'mode', used on Unix-alikes
(only) to set the permissions on the created directory.
o Where an array is dropped to a length-one vector by drop() or
[, drop = TRUE], the result now has names if exactly one of
the dimensions was named. (This is compatible with S.)
Previously there were no names.
o The 'incomparables' argument to duplicated(), unique() and
match() is now implemented, and passed to match() from merge().
o dyn.load() gains a 'DLLpath' argument to specify the path for
dependent DLLs: currently only used on Windows.
o The spreadsheet edit() methods (and used by fix()) for data
frames and matrices now warn when classes are discarded.
When editing a data frame, columns of unknown type (that is
not numeric, logical, character or factor) are now converted
to character (instead of numeric).
o file.create() has a new argument 'showWarnings' (default TRUE)
to show an informative warning when creation fails, and
dir.create() warns under more error conditions.
o New higher-order functions Find(), Negate() and Position().
o [dpqr]gamma(*, shape = 0) now work as limits of 'shape -> 0',
corresponding to the point distribution with all mass at 0.
o An informative warning (in addition to the error message) will
be given when the basic, extended or perl mode of grep(),
strsplit() and friends fails to compile the pattern.
o More study is done of perl=TRUE patterns in grep() and friends
when length(x) > 10: this should improve performance on long
vectors.
o grep(), strsplit() and friends with fixed=TRUE or perl=TRUE
work in UTF-8 and preserve the UTF-8 encoding for UTF-8 inputs
where supported.
o help.search() now builds the database about 3x times faster.
o iconv() now accepts "UTF8" on all platforms (many did, but not
e.g. libiconv as used on Windows).
o identity() convenience function to be used for programming.
o In addition to warning when 'pkgs' is not found,
install.packages() now reports if it finds a valid package
with only a case mismatch in the name.
o intToUtf8() now marks the Encoding of its output.
o The function is() now works with S3 inheritance; that is, with
objects having multiple strings in the class attribute.
o Extensions to condition number computation for matrices, notably
complex ones are provided, both in kappa() and the new rcond().
o list.files() gains a 'ignore.case' argument, to allow
case-insensitive matching on some Windows/MacOS file systems.
o ls.str() and lsf.str() have slightly changed arguments and
defaults such that ls.str() {no arguments} works when debugging.
o Under Unix, utils::make.packages.html() can now be used directly
to set up linked HTML help pages, optionally without creating
the package listing and search database (which can be much
faster).
o new.packages() now knows about the front-end package gnomeGUI
(which does not install into a library).
o optim(*, control = list(...)) now warns when '...' contains
unexpected names, instead of silently ignoring them.
o The options "browser" and "editor" may now be set to functions,
just as "pager" already could.
o packageDescription() makes use of installed metadata where
available (for speed, e.g. in make.packages.html()).
o pairwise.t.test() and pairwise.wilcox.test() now more explicitly
allow paired tests. In the former case it is now flagged as an
error if both 'paired' and 'pool.SD' are set TRUE (formerly,
'paired' was silently ignored), and one-sided tests are generated
according to 'alternative' also if 'pool.SD' is TRUE.
o paste() and file.path() are now completely internal, for speed.
(This speeds up make.packages.html(packages=FALSE)
severalfold, for example.)
o paste() now sets the encoding on the result under some
circumstances (see ?paste).
o predict.loess() now works when loess() was fitted with
transformed explanatory variables, e.g, loess(y ~ log(x) + log(z)).
o print(<data.frame>)'s new argument 'row.names' allows to suppress
printing rownames.
o print() and str() now also "work" for 'logLik' vectors longer than
one.
o Progress-bar functions txtProgressBar(), tkProgressBar() in
package tcltk and winProgressBar() (Windows only).
o readChar() gains an argument 'useBytes' to allow it to read a
fixed number of bytes in an MBCS locale.
o readNEWS() has been moved to the tools package.
o round() and signif() now do internal argument matching if
supplied with two arguments and at least one is named.
o New function showNonASCII() in package tools to aid detection
of non-ASCII characters in .R and .Rd files.
o The [dpq]signrank() functions now typically use considerably
less memory than previously, thanks to a patch from Ivo
Ugrina.
o spec.ar() now uses frequency(x) when calculating the
frequencies of the estimated spectrum, so that for monthly
series the frequencies are now per year (as for spec.pgram)
rather than per month as before.
o spline() gets an 'xout' argument, analogously to approx().
o sprintf() now does all the conversions needed in a first pass if
length(fmt) == 1, and so can be many times faster if called
with long vector arguments.
o [g]sub(useBytes = FALSE) now sets the encoding on changed
elements of the result when working on an element of known
encoding. (This was previously done only for perl = TRUE.)
o New function Sys.chmod(), a wrapper for 'chmod' on platforms
which support it. (On Windows it handles only the read-only
bit.)
o New function Sys.umask(), a wrapper for 'umask' on platforms
which support it.
o New bindings ttk*() in package tcltk for the 'themed widgets'
of Tk 8.5. The tcltk demos make use of these widgets where
available.
o write.table(d, row.names=FALSE) is faster when 'd' has millions of
rows; in particular for a data frame with automatic row names.
(Suggestion from Martin Morgan.)
o The parser limit on string size has been removed.
o If a NEWS file is present in the root of a source package, it
is installed (analogously to LICENSE, LICENCE and COPYING).
o Rd conversion to 'example' now quotes aliases which contain
spaces.
o The handling of DST on dates outside the range 1902-2037 has
been improved. Dates after 2037 are assumed to have the same
DST rules as currently predicted for the 2030's (rather than
the 1970s), and dates prior to 1902 are assumed to have no DST
and the same offset as in 1902 (if known, otherwise as in the
1970s).
o On platforms where we can detect that mktime sets errno
(e.g. Solaris and the code used on Windows but not Linux nor
Mac OS X), 1969-12-31 23:59:59 GMT is converted from POSIXlt
to POSIXct as -1 and not NA.
o The definition of 'whitespace' used by the parser is slightly
wider: it includes Unicode space characters on Windows and in
UTF-8 locales on machines which use Unicode wide characters.
o The src/extra/intl sources have been updated to those from
gettext 0.17.
o New flag --interactive on Unix-alikes forces the session to be
interactive (as --ess does on Windows).
o x[<zero-length>] <- NULL is always a no-op: previously
type-checking was done on the replacement value and so this
failed, whereas we now assume NULL can be promoted to any
zero-length vector-like object.
Other cases of a zero-length index are done more efficiently.
o There is a new option in Rd markup of \donttest{} to mark
example code that should be run by example() but not tested
(e.g. because it might fail in some locales).
o The error handler in the parser now reports line numbers for
more syntax errors (MBCS and Unicode encoding errors, line
length and context stack overflows, and mis-specified argument
lists to functions).
o The "MethodsList" objects originally used for method selection
are being phased out. New utilities provide simpler
alternatives (see ?findMethods), and direct use of the mangled
names for the objects is now deprecated.
o Creating new S4 class and method definitions in an environment
that could not be identified (as package, namespace or global)
previously generated an error. It now results in creating and
using an artificial package name from the current date/time,
with a warning. See ?getPackageName.
o Unix-alikes now give a warning on startup if locale settings
fail. (The Windows port has long done so.)
o Parsing and scanning of numerical constants is now done by R's
own C code. This ensures cross-platform consistency, and
mitigates the effects of setting LC_NUMERIC (within base R it
only applies to output -- packages may differ).
The format accepted is more general than before and includes
binary exponents in hexadecimal constants: see
?NumericConstants for details.
o Dependence specifications for R or packages in the Depends
field in a DESCRIPTION file can now make use of operators
< > == and != (in addition to <= and >=): such packages will
not be installable nor loadable in R < 2.7.0.
There can be multiple mentions of R or a package in the Depends
field in a DESCRIPTION file: only the first mention will be
used in R < 2.7.0.
GRAPHICS CHANGES
o The default graphics devices in interactive and
non-interactive sessions are now configurable via environment
variables R_INTERACTIVE_DEVICE and R_DEFAULT_DEVICE
respectively.
o New function dev.new() to launch a new copy of the default
graphics device (and taking care if it is "pdf" or
"postscript" not to trample on the file of an already running
copy).
o dev.copy2eps() uses dev.displaylist() to detect screen
devices, rather than list them in the function.
o New function dev.copy2pdf(), the analogue of dev.copy2eps().
o dev.interactive() no longer treats a graphics device as
interactive if it has a display list (but devices can still
register themselves on the list of interactive devices).
o The X11() and windows() graphics devices have a new argument
'title' to set the window title.
o X11() now has the defaults for all of its arguments set by the
new function X11.options(), inter alia replacing options
"gamma", "colortype" and "X11fonts".
o ps.options() now warns on unused option 'append'.
xfig() no longer takes default arguments from ps.options().
(This was not documented prior to 2.6.1 patched.)
pdf() now takes defaults from the new function pdf.options()
rather that from ps.options() (and the latter was not
documented prior to 2.6.1 patched).
The defaults for all arguments other than 'file' in
postscript() and pdf() can now be set by ps.options() or
pdf.options()
o New functions setEPS() and setPS() as wrappers to ps.options()
to set appropriate defaults for figures for inclusion in other
documents and for spooling to a printer respectively.
o The meaning of numeric 'pch' has been extended where MBCSes are
supported. Now negative integer values indicate Unicode
points, integer values in 32-127 represent ASCII characters,
and 128-255 are valid only in single-byte locales.
(Previously what happened with negative pch values was
undocumented: they were replaced by the current setting of
par("pch").)
o Graphics devices can say if they can rotate text well
(e.g. postscript() and pdf() can) and if so the device's
native text becomes the default for contour labels rather than
using Hershey fonts.
o The setting of the line spacing (par("cra")[2]) on the X11() and
windows() devices is now comparable with postscript() etc, and
roughly 20% smaller than before (it used to depend on the
locale for X11). (So is the pictex() device, now 20% larger.)
This affects the margin size in plots, and should result in
better-looking plots.
o There is a per-device setting for whether new frames need
confirmation. This is controlled by either par("ask") or
grid.prompt() and affects all subsequent plots on the device
using base or grid graphics.
o There is a new version of the X11() device based on cairo
graphics which is selected by type "cairo" or "nbcairo", and
is available on machines with cairo installed and preferably
pango (which most machines with gtk+ >= 2.8 will have). This
version supports translucent colours and normally does a
better job of font selection so it has been possible to
display (e.g.) English, Polish, Russian and Japanese text on
a single X11() window. It is the default where available.
There is a companion function, savePlot(), to save the current
plot to a PNG file.
On Unix-alikes, devices jpeg() and png() also accept
type = "cairo", and with that option do not need a running
X server. The meaning of capabilities("jpeg") and
capabilities("png") has changed to reflect this. On MacOS X,
there is a further type = "quartz". The default type is
selected by the new option "bitmapType", and is "quartz" or
"cairo" where available.
Where cairo 1.2 or later is supported, there is a svg() device
to write SVG files, and cairo_pdf() and cairo_ps() devices to
write (possibly bitmap) PDF and postscript files via cairo.
Some features require cairo >= 1.2, and some which are
nominally supported under 1.2 seem to need 1.4 to work well.
o There are new bmp() and tiff() devices.
o New function devSize() to report the size of the current
graphics device surface (in inches or device units). This
gives the same information as par("din"), but independent of
the graphics subsystem.
o New base graphics function clip() to set the clipping region (in
user coordinates).
o New functions grconvertX() and grconvertY() to convert between
coordinate systems in base graphics.
o identify() recycles its 'labels' argument if necessary.
o stripchart() is now a generic function, with default and
formula methods defined. Additional graphics parameters may
be included in the call. Formula handling is now
similar to boxplot().
o strwidth() and strheight() gain 'font' and 'vfont' arguments and
accept in-line pars such as 'family' in the same way as text()
does. (Longstanding wish of PR#776)
o example(ask=TRUE) now applies to grid graphics (e.g. from
lattice) as well as to base graphics.
o Option "device.ask.default" replaces "par.ask.default" now it
applies also to grid.prompt().
o plot.formula() only prompts between plots for interactive
devices (it used to prompt for all devices).
o When plot.default() is called with y=NULL it now calls Axis()
with the 'y' it constructs rather than use the default axis.
DEPRECATED & DEFUNCT
o In package installation, SaveImage: yes is defunct and
lazyloading is attempted instead.
o $ on an atomic vector or S4 object is now defunct.
o Partial matching in [[ is now only performed if explicitly
requested (by exact=FALSE or exact=NA).
o Command-line completion has been moved from package 'rcompgen'
to package 'utils': the former no longer exists as a separate
package in the R distribution.
o The S4 pseudo-classes "single" and double have been removed.
(The S4 class for a REALSXP is "numeric": for back-compatibility
as(x, "double") coerces to "numeric".)
o gpar(gamma=) in the grid package is now defunct.
o Several S4 class definition utilities, get*(), have been said
to be deprecated since R 1.8.0; these are now formally deprecated.
Ditto for removeMethodsObject().
o Use of the graphics headers Rgraphics.h and Rdevices.h is
deprecated, and these will be unavailable in R 2.8.0.
(They are hardly used except in graphics devices, for which
there is an updated API in this version of R.)
o options("par.ask.default") is deprecated in favour of
"device.ask.default".
o The 'device-independent' family "symbol" is deprecated as it was
highly locale- and device-dependent (it only did something
useful in single-byte locales on most devices) and font=5
(base) or fontface=5 (grid) did the job it was intended to do
more reliably.
o gammaCody() is now formally deprecated.
o Two low-level functions using MethodsList metadata objects
(mlistMetaName() and getAllMethods()) are deprecated.
o Setting par(gamma=) is now deprecated, and the windows()
device (the only known example) no longer allows it.
o The C macro 'allocString' will be removed in 2.8.0 -- use
'mkChar', or 'allocVector' directly if really necessary.
INSTALLATION
o Tcl/Tk >= 8.3 (released in 2000) is now required to build
package tcltk.
o configure first tries TCL_INCLUDE_SPEC and TK_INCLUDE_SPEC
when looking for Tcl/Tk headers. (The existing scheme did
not work for the ActiveTcl package on Mac OS X.)
o The Windows build only supports Windows 2000 or later (XP,
Vista, Server 2003 and Server 2008).
o New option --enable-R-static-lib installs libR.a which can
be linked to a front-end via 'R CMD config --ldflags'.
The tests/Embedding examples now work with a static R
library.
o Netscape (which was discontinued in Feb 2008) is no longer
considered when selecting a browser.
o xdg-open (the freedesktop.org interface to
kfmclient/gnome-open/...) is considered as a possible browser,
after real browsers such as firefox, mozilla and opera.
o The search for tclConfig.sh and tkConfig.sh now only looks in
directories with names containing $(LIBnn) in the hope of
finding the version for the appropriate architecture
(e.g. x86_64 or i386).
o libtool has been updated to version 2.2.
o Use of --with-system-zlib, --with-system-bzlib or
--with-system-pcre now requires version >= 1.2.3, 1.0.5, 7.6
respectively, for security.
UTILITIES
o Rdconv now removes empty sections including alias and keyword
entries, with a note.
o Keyword entries are no longer mandatory in Rd files.
o R CMD INSTALL now also installs tangled versions of all vignettes.
o R CMD check now warns if spaces or non-ASCII characters are
used in file paths, since these are not in general portable.
o R CMD check (via massage-Examples.pl) now checks all examples
with a 7 inch square device region on A4 paper, for
locale-independence and to be similar to viewing examples on
an on-screen device.
If a package declares an encoding in the DESCRIPTION file,
the examples are assumed to be in that encoding when running
the tests. (This avoids errors in running latin1 examples in a
UTF-8 locale.)
o R CMD check uses pdflatex (if available) to check the typeset
version of the manual, producing PDF rather than DVI. (This
is a better check since the package reference manuals on CRAN
are in PDF.)
o R CMD Rd2dvi gains a --encoding argument to be passed to
R CMD Rdconv, to set the default encoding for conversions.
If this is not supplied and the files are package sources and
the DESCRIPTION file contains an Encoding field, that is used
for the default encoding.
o available.packages() (and hence install.packages() etc) now
supports subdirectories in a repository, and
tools::write_PACKAGES() can now produce PACKAGES files
including subdirectories.
o The default for 'stylepath' in Sweave's (default) RweaveLatex
driver can be set by the environment variable
SWEAVE_STYLEPATH_DEFAULT: see ?RweaveLatex.
C-LEVEL FACILITIES
o Both the Unix and Windows interfaces for embedding now make
use of 'const char *' declarations where appropriate.
o Rprintf() and REprintf() now use 'const char *' for their format
argument -- this should reduce warnings when called from C++.
o There is a new description of the interface for graphics
devices in the 'R Internals' manual, and several new entry
points. The API has been updated to version R_GE_version = 5,
and graphics devices will need to be updated accordingly.
o Graphics devices can now select to be sent text in UTF-8, even
if the current locale is not UTF-8 (and so enable text entered
in UTF-8 to be plotted). This is used by postscript(), pdf()
and the windows() family of devices, as well as the new
cairo-based devices.
o More Lapack routines are available (and declared in R_Ext/Lapack.h),
notably for (reciprocal) condition number estimation of complex
matrices.
o Experimental utility R_has_slot supplementing R_do_slot.
o There is a new public interface to the encoding info stored on
CHARSXPs, getCharCE and mkCharCE using the enumeration type
cetype_t.
o A new header 'R_ext/Visibility.h' contains some definitions for
controlling the visibility of entry points, and how to control
visibility is now documented in 'Writing R Extensions'.
BUG FIXES
o pt(x, df) is now even more accurate in some cases (e.g. 12 instead
of 8 significant digits), when x^2 << df, thanks to a remark from
Ian Smith, related to PR#9945.
o co[rv](use = "complete.obs") now always gives an error if there
are no complete cases: they used to give NA if
method = "pearson" but an error for the other two methods.
(Note that this is pretty arbitrary, but zero-length vectors
always give an error so it is at least consistent.)
Since sd(na.rm=TRUE) and var(na.rm=TRUE) both call cov(use =
"complete.obs"), this applies also to them.
cor(use="pair") used to give diagonal 1 even if the variable
was completely missing for the rank methods but NA for the
Pearson method: it now gives NA in all cases.
cor(use="pair") for the rank methods gave a matrix result with
dimensions > 0 even if one of the inputs had 0 columns.
o Supplying edit.row.names = TRUE when editing a matrix without
row names is now an error and not a segfault. (PR#10500)
o The error handler in the parser reported unexpected
& as && and | as ||.
o ps.options(reset = TRUE) had not reset for a long time.
o paste() and file.path() no longer allow NA_character_ for
their 'sep' and 'collapse' arguments.
o by() failed for 1-column matrices and dataframes. (PR#10506)
However, to preserve the old behaviour, the default method
when operating on a vector still passes subsets of the vector
to FUN, and this is now documented.
o Better behaviour of str.default() for non-default
'strict.width' (it was calling str() rather than str.default()
internally); also, more useful handling of options("str").
o wilcox.test(exact=FALSE, conf.int=TRUE) could fail in some
extreme two-sample problems. (Reported by Wolfgang Huber.)
o par(pch=) would accept a multi-byte string but only use the
first byte. This would lead to incorrect results in an MBCS
locale if a non-ASCII character was supplied.
o There are some checks for valid C-style formats in, e.g.
png(filename=). (PR#10571)
o vector() was misinterpreting some double 'length' values, e.g,
NaN and NA_real_ were interpreted as zero. Also, invalid
types of 'length' were interpreted as -1 and hence reported as
negative. (length<- shared the code and hence the same
misinterpretations.)
o A basic class "S4" was added to correspond to the "S4" object
type, so that objects with this type will print, etc. The
class is VIRTUAL, since all actual S4 objects must have a real
class.
o Classes with no slots that contain only VIRTUAL classes are now
VIRTUAL, as was intended but confused by having an empty S4
object as prototype. ## backed out temporarily ##
o format.AsIs() discarded dimnames, causing dataframes with matrix
variables to be printed without using the column names, unlike
what happens in S-PLUS (Tim Hesterberg, PR#10730).
o xspline() and grid::grid.xspline() work in device coordinates
and now correct for anisotropy in the device coordinate
system.
o grid.locator() now indicates to the graphics device that it is
is in 'graphics input' mode (as locator() and identify()
always have). This means that devices can now indicate the
'graphics input' mode by e.g. a change of cursor.
o Locales without encoding specification and non-UTF-8 locales
now work properly on Mac OS X. Note that locales without
encoding specification always use UTF-8 encoding in Mac OS X
(except for specials "POSIX" and "C") - this is different from
other operating systems.
o iconv() now correctly handles to="" and from="" on Mac OS X.
o In diag()'s argument list, drop the explicit default (' = n')
for 'ncol' which is ugly when making diag() generic.
o S4 classes with the same name from different packages were not
recognized because of a bug in caching the new definition.
o jpeg() and png() no longer maintain a display list, as they
are not interactive devices.
o Using attr(x, "names") <- value (instead of the correct
names<-) with 'value' a pairlist (instead of the correct
character vector) worked incorrectly. (PR#10807)
o Using [<- to add a column to a data frame dropped other
attributes whereas [[<- and $<- did not: now all preserve
attributes. (PR#10873)
o File access functions such as file.exists(), file.info(),
dirname() and unlink() now treat an NA filename as a
non-existent file and not the file "NA".
o r<foo>(), the random number generators, are now more consistent
in warning when NA's (specifically NaN's) are generated.
o rnorm(n, mu = Inf) now returns rep(Inf, n) instead of NaN;
similar changes are applied to rlnorm(), rexp(), etc.
o [l]choose() now warns when rounding non-integer 'k' instead of
doing so silently. (May help confused users such as PR#10766.)
o gamma() was warning incorrectly for most negative values as being
too near a negative integer. This also affected other
functions making use of its C-level implementation.
o dumpMethod() and dumpMethods() now work again.
o package.skeleton() now also works for code_files with only
metadata (e.g. S4 setClass) definitions; it handles S4 classes and
methods, producing documentation and NAMESPACE exports if requested.
o Some methods package utilities (implicitGeneric(), makeGeneric())
will be more robust in dealing with primitive functions (not a
useful idea to call them with primitives, though)
o Making a MethodsList from a function with no methods table will
return an empty list, rather than cause an error (questionably
a bug, but caused some obscure failures).
o setAs() now catches 2 arguments in the method definition, if
they do not match the arguments of coerce().
o S4 methods with missing arguments in the definition are handled
correctly when non-signature arguments exist, and check for
conflicting local names in the method definition.
o qgamma() and qchisq() could be inaccurate for small p,
e.g. qgamma(1.2e-10, shape = 19) was 2.52 rather than 2.73.
o dbeta(.., ncp) is now more accurate for large ncp, and typically no
longer underflows for give.log = TRUE.
o coerce() is now a proper S4 object and so prints correctly.
o @ now checks it is being applied to an S4 object, and if not
gives a warning (which will become an error in 2.8.0).
o dump() and friends now warn that all S4 objects (even those
based on vectors) are not source()able, with a stronger wording.
o read.dcf(all = TRUE) was leaking connections.
o scan() with a non-default separator could skip nul bytes,
including those entered as \0 with allowEscapes=TRUE. This
was different from the default separator.
o determinant(matrix(,0,0)) now returns a correct "det" result;
also value 1 or 0 depending on 'logarithm', rather than numeric(0).
o Name space 'grDevices' was not unloading its DLL when the
name space was unloaded.
o getNativeSymbolInfo() was unaware of non-registered Fortran
names, because one of the C support routines ignored them.
o load() again reads correctly character strings with embedded nuls.
(This was broken in 2.6.x, but worked in earlier versions.)
**************************************************
* *
* 2.6 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.6.2 patched
BUG FIXES
o src/extra/pcre has been updated to PCRE 7.6 (bugfix release).
o unlink(..., recursive=TRUE) no longer crashes on some platforms
if a directory cannot be opened.
o Loading in 2.6.2 a saved workspace could give an unimportant
warning in a non-UTF-8 multibyte locale (in particular a CJK
locale on Windows) which is now suppressed.
o print() methods are more consistent in returning the original
argument invisibly.
o Using the X11 data editor (e.g. via edit(), fix() or View())
could crash if the 'End' key was used and all the columns
would have fitted into the window.
o Creating a new page on an X11() device (by plot.new() or
grid.newpage()) did not flush out the XClearWindow call, so
the X11 window might not be refreshed immediately.
o libtool has been updated to version 1.5.26, which avoids
many spurious configure warnings on Darwin/Mac OS X.
o l10n_info() now recognizes how Darwin/Mac OS X reports
Latin-1 locales (as charset ISO8859-1 rather than ISO-8859-1).
o Checking examples which used grid (e.g. via lattice) without
attaching grid no longer give errors from grid_plot_hook().
o kappa(m, exact=TRUE) no longer wrongly uses 'exact=FALSE' when m
is an 'lm' or 'qr' object because the kappa.tri(x, exact=TRUE)
now works correctly.
o help(topic, offline=TRUE) misbehaved when there were multiple
matches to 'topic'. (PR#10859)
o The 'multilib' changes on Linux broke the use of
sub-architectures without a main architecture.
o source(echo=TRUE) would skip lines consisting entirely of the
letter t. (PR#10923)
o bzip2 has been updated to 1.0.5 (security fix).
CHANGES IN R VERSION 2.6.2
NEW FEATURES
o colnames(DF) is now also fast for large dataframes DF with
automatic row.names. Note that the correct usage is
names(DF). (PR#10470)
o tools::texi2dvi() works around the failure of 'texi2dvi --quiet'
to be quiet in texinfo 4.11.
o On Linux, parallel 32/64-bit installations are supported using
multilib.
BUG FIXES
o A compilation problem on one system where glob was not found
has been corrected. (PR#10468)
o The "profile.nls" method of plot() was losing the x axis labels.
o array() computed the total number of entries in the array before
coercing the dimensions to integer. (Reported by Allen McIntosh.)
o persp() misreported errors in the y parameter. (Reported by Allen
McIntosh.)
o source("clipboard", echo=TRUE) and file("clipboard", open="rt")
gave spurious errors. (Reported by Fernando Saldanha.)
o attributes<-() stripped any existing attributes before checking
that all elements of the right-hand side had names.
o rbinom(n, size, *) gave NaN when 'size > .Machine$integer.max'.
o print.summary.lm() is now consistent in the capitalization of
"R-squared".
o confint() misreported on some rank-deficient lm() models.
(PR#10496) This could also occur in the default method.
o \code{\var{<name>}} was not rendered correctly to latex in Rd
files for non-alphabetic arguments <name>.
o In 2.6.1, curve(*, add=TRUE) used a wrong default 'xlim' when x
coordinates were logged.
o The Java-based search in help.start() now only requires a
JVM >= 1.4 (2.6.1 accidentally required >= 1.5).
o The default method for range() was omitting 'na.rm' for
non-numeric objects such as those of class "Date". (PR#10508)
o cut(x, breaks=<n>) misbehaved on a constant vector of negative
values.
o bxp(), the plotting engine of boxplot(), no longer plots staple
ticks multiple times. (PR#10499)
o The automatic detection of the domain for message translation
was not working correctly for messages in message(), warning()
and stop() in packages other than 'base'.
o The profile.nls() function misbehaved when encountering
non-convergence of the "port" algorithm.
o Under certain rare circumstances in R 2.6.x, log(), round()
and trunc() could alter their arguments in the caller. This
involved passing of empty '...' arguments, and was spotted
when using apply(x, 2, log).
o par() no longer warns unnecessarily when asked to set new=FALSE
on an unused graphics device.
o plot.formula() was not passing on '...' when used with a
one-sided formula.
plot.formula() was not accepting expressions for annotations
passed to title(). (PR#10525)
o pchisq(x, df=0, ncp=L) now returns the correct limit exp(-L/2) for
x=0 and is no longer returning NaN for x > 0, L < 80. (PR#10551)
o Non-ASCII characters were only working correctly in Hershey
fonts if these were specified by the 'vfont' argument to
text() and not if specified as a font family.
o There were several errors in Hershey$allowed, but the help
page listed the allowed combinations correctly.
o text() no longer attempts to use 'vfont' with an expression
for 'labels' (it was documented not to work).
o fisher.test(simulate.p.value = TRUE) gave incorrect answers
in some extremely degenerate problems. (PR#10558)
o src/extra/pcre has been updated to PCRE 7.5 (bugfix release).
o capture.output() completes an incomplete final line of
output when file = NULL. (PR#10534)
o capture.output() now returns invisibly if output is written to
a file/connection.
o format.AsIs() did not remove the "AsIs" class and so could go
into an infinite loop.
o summary.mlm() lost the names of the coefficients when there
was only one.
o Rdconv was not marking examples files with an encoding if
this was known from the package's DESCRIPTION file.
o readChar() from a raw vector was reading a number of bytes,
not characters.
o slotNames() was erroneously treating classes that extend
"character" as strings.
o R no longer ignores SIGPIPE signals even in processes launched
by system(). Instead PR#1959 is handled by a simple error
handler which will give an error message in circumstances
where none was given before.
o The AIC() S4 generic in package stats4 no longer disables
dispatch of S3 methods for AIC().
o The conflicts check in library() excluded all S4 generics, even
where they were unrelated to the function masked. It is now
more selective (although still too generous to S4 generics).
o proc.time() was missing a protect and could misbehave if
provoked by gctorture(). (PR#10600)
o The cut() and hist() methods for dates and datetimes are now
more accurate for intervals of "months" and "years", thanks to
Marc Schwarz.
o url()/download.file() could segfault if the HTTP interaction
involved a redirect to an address starting with '/' on the
same server.
o Memory allocations used in format() and in an internal utility
function could be off by one byte. (PR#10635)
o isoreg(x, y) no longer segfaults when y has NAs.
o split(x, g) always returns a list as documented. (It used to
return NULL for a zero-length 'x'.)
o tapply(x, g, ...) misbehaved if the args were of zero length.
(PR#10644)
o hist.POSIXt(*, xaxt = "n") no longer suppresses the y-axis.
o strptime() crashed under certain locales on Mac OS X.
o gregexpr() no longer segfaults when "" is given as the search
pattern. Thanks to Hervé Pagès for the bug report.
o matplot(x, *) with default 'pch' did not plot columns from column
number 37 on (because the default pch was NA for those). (PR#10676)
o print.htest() lost output when used within sink(file, split=TRUE).
o Setting par(col.main=) also set par("col") to the same colour.
o Anonymous fifos were broken (again).
CHANGES IN R VERSION 2.6.1
NEW FEATURES
o The "data.frame" and "factor" methods for [[ now support
the 'exact' argument introduced in 2.6.0.
o plot.lm() gains a new argument 'cex.caption' to allow the
size of the captions to be controlled.
o A series of changes make the CHARSXP cache introduced in 2.6.0
faster (and in some cases many times faster) in sessions with
a large number (e.g. a million) of unique character strings,
and also if there are many empty strings.
o embedFonts(), bitmap() and dev2bitmap() explicitly turn off
auto-rotation in Ghostscript when generating PDF.
o The canonical architecture is no longer checked when loading
packages using a non-empty sub-architecture, since it is
possible to (e.g.) build packages for i386-pc-linux-gnu on both
that architecture and on x86_64-unknown-linux-gnu.
o Deparsing will (if option warnIncomplete is set) warn on
strings longer than the parser limit (8192 bytes).
o url() now uses the UserAgent header in http transactions in
the same way as download.file() (making use of option
"HTTPUserAgent").
BUG FIXES
o iconv() is again able to translate character strings with
embedded nuls (such as those in UCS-2).
o new.packages() and update.packages() failed when called on an
empty library, since old.packages() threw an error.
old.packages() now returns NULL (as documented) in that case.
o Builds on Mac OS X 10.4 or higher now allocate enough space
in the binary headers to relocate dependent libraries into the
framework.
o R CMD build now computes the exclusion list on the copy it
makes: this avoids problems if the original sources contain
symbolic links (which are resolved in the copy). Thanks to
Michael Lawrence for diagnosis and patch.
o object.size() had slightly too low a size for objects of type "S4".
o symbol() in plotmath expressions was only accepting valid
character strings, which made it impossible to specify symbols
such as aleph (obtained by symbol("\300")) in a UTF-8 locale.
o An event handling issue caused autorepeat functions to
misbehave with tcltk (notably scrollbars).
o plot(sin, -5, 5) gives ylab 'sin(x)' again, where it resulted
in 'x(x)' in 2.6.0. Further, plot(sin) again plots from
[0,1] also in cases where a previously used coordinate system
differs.
o curve() with unspecified 'from', 'to' and 'xlim' now reuses the
previous x limits, and not slightly larger ones.
o It was intended that R code filenames in packages should start
with an ASCII letter or digits (and R CMD INSTALL uses that),
but the test used in R CMD build ([A-Za-z0-9]) was
locale-specific (and excluded t to y in Estonian, for
example). (PR#10351)
o 'R CMD build' could misbehave when faced with files with CRLF
line endings *and* no line ending on the final line of the
file, removing the last byte of the file.
o DF[i, j] failed in 2.6.0 if j was a logical vector selecting a
single column.
o Unix x11() would fail if a valid 'display' was specified but
DISPLAY was unset. (PR#10379)
o postscript() was not always ignoring .Postscript.Options in
the workspace (where it should not have occurred).
o help.search() would give an error if it found a badly
installed package, even if 'package' was not specified.
o tclServiceMode() (package tcltk) now works under Unix-alikes.
(Although documented, it used only to work under Windows.)
o As Mac OS X 10.5.x comes with incompatible /bin/sh shell, we
force SHELL=/bin/bash (which is ok) in that case. [Only for
2.6.x: another solution is used in 2.7.0.]
o Deliberately using malformed source attributes no longer
causes deparsing/printing of functions to crash R. (PR#10437)
o R CMD check and R CMD INSTALL now work with (some) directory
names containing spaces.
o choose(n, k) gave incorrect values for negative n and small k.
o plot.ts(x,y) could use wrong default labels; fixed thanks to
Antonio, Fabio di Narzo.
o reshape() got column names out of sync with contents in some
cases; found by Antonio Fabio Di Narzo.
o ar(x) for short 'x' (i.e. length <= 10) could fail because the
default 'order.max' was >= length(x) which is non-sensical.
o Keyboard events in getGraphicsEvent() could cause stack
imbalance errors. (PR#10453)
CHANGES IN R VERSION 2.6.0
SIGNIFICANT USER-VISIBLE CHANGES
o integrate(), nlm(), nlminb(), optim(), optimize() and uniroot()
now have '...' much earlier in their argument list. This
reduces the chances of unintentional partial matching but
means that the later arguments must be named in full.
o The default type for nchar() is now "chars". This is almost
always what was intended, and differs from the previous default
only for non-ASCII strings in a MBCS locale. There is a new
argument 'allowNA', and the default behaviour is now to throw
an error on an invalid multibyte string if type="chars" or
type="width".
o Connections will be closed if there is no R object referring to
them. A warning is issued if this is done, either at garbage
collection or if all the connection slots are in use.
NEW FEATURES
o abs(), sign(), sqrt(), floor(), ceiling(), exp() and the gamma,
trig and hyperbolic trig functions now only accept one
argument even when dispatching to a Math group method (which
may accept more than one argument for other group members).
o abbreviate() gains a 'method' argument with a new option
"both.sides" which can make shorter abbreviations.
o aggregate.data.frame() no longer changes the group variables
into factors, and leaves alone the levels of those which are
factors. (Inter alia grants the wish of PR#9666.)
o The default 'max.names' in all.names() and all.vars() is now
-1 which means unlimited. This fixes PR#9873.
o as.vector() and the default methods of as.character(),
as.complex(), as.double(), as.expression(), as.integer(),
as.logical() and as.raw() no longer duplicate in most cases
where the object is unchanged. (Beware: some code has been
written that invalidly assumes that they do duplicate, often
when using .C/.Fortran(DUP=FALSE).)
o as.complex(), as.double(), as.integer(), as.logical() and
as.raw() are now primitive and internally generic for
efficiency. They no longer dispatch on S3 methods for
as.vector() (which was never documented). as.real() and
as.numeric() remain as alternative names for as.double().
expm1(), log(), log1p(), log2(), log10(), gamma(), lgamma(),
digamma() and trigamma() are now primitive. (Note that logb()
is not.)
The Math2 and Summary groups (round, signif, all, any, max, min,
sum, prod, range) are now primitive.
See under METHODS PACKAGE below for some consequences for S4 methods.
o apropos() now sorts by name and not by position on the search
path.
o attr() gains an 'exact = TRUE' argument to disable partial
matching.
o bxp() now allows 'xlim' to be specified. (PR#9754)
o C(f, SAS) now works in the same way as C(f, treatment), etc.
o chol() is now generic.
o dev2bitmap() has a new option to go via PDF and so allow
semi-transparent colours to be used.
o dev.interactive() regards devices with the displaylist enabled
as interactive, and packages can register the names of their
devices as interactive via deviceIsInteractive().
o download.packages() and available.packages() (and functions
which use them) now support in 'repos' or 'contriburl' either
file: plus a general path (including drives on a UNC path on
Windows) or a file:/// URL in the same way as url().
o dQuote() and sQuote() are more flexible, with rendering
controlled by the new option 'useFancyQuotes'. This includes
the ability to have TeX-style rendering and directional quotes
(the so-called 'smart quotes') on Windows. The default is to
use directional quotes in UTF-8 locales (as before) and in the
Rgui console on Windows (new).
o duplicated() and unique() and their methods in base gain an
additional argument 'fromLast'.
o fifo() no longer has a default 'description' argument.
fifo("") is now implemented, and works in the same way as file("").
o file.edit() and file.show() now tilde-expand file paths on all
interfaces (they used to on some and not others).
o The find() argument is now named 'numeric' and not 'numeric.':
the latter was needed to avoid warnings about name clashes
many years ago, but partial matching was used.
o stats:::.getXlevels() confines attention to factors since some
users expected R to treat unclass(<a factor>) as a numeric
vector.
o grep(), strsplit() and friends now warn if incompatible sets
of options are used, instead of silently using the documented
priority.
o gsub()/sub() with perl = TRUE now preserves attributes from the
argument x on the result.
o is.finite() and is.infinite() are now S3 and S4 generic.
o jpeg(), png(), bmp() (Windows), dev2bitmap() and bitmap() have
a new argument 'units' to specify the units of 'width' and
'height'.
o levels() is now generic (levels<- has been for a long time).
o Loading serialized raw objects with load() is now considerably
faster.
o New primitive nzchar() as a faster alternative to
nchar(x) > 0 (and avoids having to convert to wide chars in
a MBCS locale and hence consider validity).
o The way old.packages() and hence update.packages() handle
packages with different versions in multiple package
repositories has been changed. The first package encountered
was selected, now the one with highest version number.
o optim(method = "L-BFGS-B") now accepts zero-length parameters,
like the other methods. Also, method = "SANN" no longer
attempts to optimize in this case.
o New options 'showWarnCalls' and 'showErrorCalls' to give a
concise traceback on warnings and errors. showErrorCalls=TRUE
is the default for non-interactive sessions. Option
'showNCalls' controls how abbreviated the call sequence is.
o New options 'warnPartialMatchDollar', 'warnPartialMatchArgs'
and 'warnPartialMatchAttr' to help detect the unintended use
of partial matching in $, argument matching and attr()
respectively.
o A device named as a character string in options(device =) is now
looked for in the grDevices name space if it is not visible
from the global environment.
o pmatch(x, y, duplicates.ok = TRUE) now uses hashing and so is
much faster for large x and y when most matches are exact.
o qr() is now generic.
o It is now a warning to have an non-integer object for
.Random.seed: this indicates a user had been playing with it,
and it has always been documented that users should only save
and restore it.
o New higher-order functions Reduce(), Filter() and Map().
o [g]regexpr() gain an 'ignore.case' argument for consistency with
grep(). (This does change the positional matching
of arguments, but no instances of positional matching beyond
the second were found.)
o relist() utility, an S3 generic with several methods, providing
an 'inverse' for unlist(); thanks to a code proposal from
Andrew Clausen.
o require() now returns invisibly.
o The interface to reshape() has been revised, allowing some
simplified forms that did not work before, and somewhat
improved error handling. A new argument 'sep' has been
introduced to replace simple usages of 'split' (the old
features are retained).
o rmultinom() uses a high-precision accumulator where available,
and so is more likely to give the same result on different
platforms (although it is still possible to get different
results, and the result may differ from previous versions of R).
o row() and col() now work on matrix-like objects such as data
frames, not just matrices.
o Rprof() allows smaller values of 'interval' on machines that
support it: for example modern Linux systems support
interval = 0.001.
o sample() now requires its first argument 'x' to be numeric
(in the sense of is.numeric()) as well as of length 1 and >= 1
before it is regarded as shorthand for 1:x.
o sessionInfo() now provides details about package name spaces
that are loaded but not attached. The output of sessionInfo
has been improved to make it easier to read when it is
inadvertently wrapped after being pasted into an email
message.
o setRepositories() has a new argument 'ind' to allow selections
to be made programmatically.
o sprintf() no longer has a output string length limit.
o storage.mode<- is now primitive, and hence makes fewer copies
of an object (none if the mode is unchanged). It is a little
less general than mode<-, which remains available. (See also
the entry under DEFUNCT below.)
o sweep() gains an argument 'check.margin = TRUE' which warns
about mismatched dimensions.
o The mathematical annotation facility (plotmath) now recognises
a symbol() function which forces the font to be a symbol font.
This allows access to all characters in the Adobe Symbol
encoding within plotmath expressions.
o For OSes that cannot unset environment variables, Sys.unsetenv()
sets the value to "", with a warning.
o New function Sys.which(), an interface to 'which' on
Unix-alikes and an emulation on Windows.
o On Unix-alikes, system(, intern = TRUE) reports on very long
lines that may be truncated, giving the line number of the
content being read.
o termplot() has a default for 'ask' that uses dev.interactive().
It allows 'ylim' to be set, or computed to cover all the
plots to be made (the new default) or computed for each plot
(the previous default).
o uniroot(f, *) is slightly faster for non-trivial f() because it
computes f(lower) and f(upper) only once, and it has new optional
arguments 'f.lower' and 'f.upper' by which the caller can pass these.
o unlink() is now internal, using common POSIX code on all platforms.
o unsplit() now works with lists of dataframes.
o The vcov() methods for classes "gls" and "nlme" have migrated to
package 'nlme'.
o vignette() has a new argument 'all' to choose between showing
vignettes in attached packages or in all installed packages.
o New function within(), which is like with(), except that it
returns modified versions back of lists and data frames.
o X11(), postscript() (and hence bitmap()), xfig(), jpeg(), png()
and the Windows devices win.print(), win.metafile() and bmp()
now warn (once at first use) if semi-transparent colours are
used (rather than silently treating them as fully
transparent).
o New function xspline() to provide base graphics support of
X-splines (cf grid.xspline).
o New function xyTable() does the 2D gridding "computations" used by
sunflowerplot().
o Rd conversion to HTML and CHM now makes use of classes, which
are set in the stylesheets. Editing R.css will change the
styles used for \env, \option, \pkg etc. (CHM styles are set
at compilation time.)
o The documented arguments of '%*%' have been changed to be x
and y, to match S and the implicit S4 generic.
o If members of the Ops group (the arithmetic, logical and
comparison operators) and '%*%' are called as functions,
e.g. '>'(x, y), positional matching is always used. (It used
to be the case that positional matching was used for the
default methods, but names would be matched for S3 and S4
methods and in the case of '!' the argument name differed
between S3 and S4 methods.)
o Imports environments of name spaces are named (as
"imports:foo"), and so are known e.g. to environmentName().
o Package 'stats4' uses lazy-loading not SaveImage (which is now
deprecated).
o Installing help for a package now parses the .Rd file only
once, rather than once for each type.
o PCRE has been updated to version 7.2.
o bzip2 has been updated to version 1.0.4.
o gettext has been updated to version 0.16.1.
o There is now a global CHARSXP cache, R_StringHash. CHARSXPs
are no longer duplicated and must not be modified in place.
Developers should strive to only use mkChar (and mkString) for
creating new CHARSXPs and avoid use of allocString. A new
macro, CallocCharBuf, can be used to obtain a temporary char
buffer for manipulating character data. This patch was
written by Seth Falcon.
o The internal equivalents of as.complex, as.double, as.integer
and as.logical used to handle length=1 arguments now accept
character strings (rather than report that this is
'unimplemented').
o Lazy-loading a package is now substantially more efficient (in
memory saved and load time).
o Various performance improvements lead to a 45% reduction
in the startup time without 'methods' (and one-sixth with -
'methods' now takes 75% of the startup time of a default session).
o The [[ subsetting operator now has an argument 'exact' that
allows programmers to disable partial matching (which will in
due course become the default). The default value is exact=NA
which causes a warning to be issued when partial matching
occurs. When exact = TRUE, no partial matching will be
performed. When exact = FALSE, partial matching can occur and
no warning will be issued. This patch was written by Seth
Falcon.
o Many of the C-level warning / error messages (e.g. from
subscripting) have been re-worked to give more detailed
information on either the location or the cause of the
problem.
o The S3 and S4 Math groups have been harmonized. Functions
log1p(), expm1(), log10() and log2() are members of the S3
group, and sign(), log1p(), expm1(), log2(), cummax(),
cummin(), digamma(), trigamma() and trunk() are members of the
S4 group. gammaCody() is no longer in the S3 Math group.
They are now all primitive.
o The initialization of the random-number stream makes use of the
sub-second part of the current time where available.
Initialization of the 1997 Knuth TAOCP generator is now done
in R code, avoiding some C code whose licence status has been
questioned.
o The reporting of syntax errors has been made more user-
friendly.
METHODS PACKAGE
o Packages using 'methods' have to have been installed in R 2.4.0
or later (when various internal representations were changed).
o Internally generic primitives no longer dispatch S4 methods on
S3 objects.
o load() and restoring a workspace attempt to detect and warn on
the loading of pre-2.4.0 S4 objects.
o Making functions primitive changes the semantics of S4
dispatch: these no longer dispatch on classes based on types
but do dispatch whenever the function in the base name space is
called.
This applies to as.complex(), as.integer(), as.logical(),
as.numeric(), as.raw(), expm1(), log(), log1p(), log2(),
log10(), gamma(), lgamma(), digamma() and trigamma(), as
well as the Math2 and Summary groups.
Because all members of the group generics are now primitive,
they are all S4 generic and setting an S4 group generic does
at last apply to all members and not just those already made
S4 generic.
as.double() and as.real() are identical to as.numeric(), and
now remain so even if S4 methods are set on any of them.
Since 'as.numeric' is the traditional name used in S4,
currently methods must be exported from a NAMESPACE for
'as.numeric' only.
o The S4 generic for '!' has been changed to have signature (x)
(was (e1)) to match the documentation and the S3 generic.
setMethod() will fix up methods defined for (e1), with a
warning.
o The "structure" S4 class now has methods that implement the
concept of structures as described in the Blue Book--that
element-by-element functions and operators leave structure
intact unless they change the length. The informal behavior
of R for vectors with attributes was inconsistent.
o The implicitGeneric() function and relatives have been added to
specify how a function in a package should look when methods are
defined for it. This will be used to ensure that generic versions
of functions in R core are consistent. See ?implicitGeneric.
o Error messages generated by some of the functions in the methods
package provide the name of the generic to provide more
contextual information.
o It is now possible to use setGeneric(useAsDefault = FALSE) to
define a new generic with the name of a primitive function
(but having no connection with the primitive).
o showMethods() has a "smart" default for 'inherited' such that
showMethods(<genfun>, incl = TRUE) becomes a useful short cut.
DEPRECATED & DEFUNCT
o $ on an atomic vector now gives a warning that it is 'invalid'.
It remains deprecated, but may be removed in R >= 2.7.0.
o storage.mode(x) <- "real" and storage.mode(x) <- "single" are
defunct: use instead storage.mode(x) <- "double" and
mode(x) <- "single".
o In package installation, SaveImage: yes is deprecated in
favour of LazyLoad: yes.
o seemsS4Object (methods package) is deprecated in favour of isS4().
o It is planned that [[exact=TRUE]] will become the default in
R 2.7.0.
UTILITIES
o checkS3methods() (invoked by R CMD check) now checks the
arguments of methods for primitive members of the S3 group
generics.
o R CMD check now does a recursive copy on the 'tests' directory.
o R CMD check now warns on non-ASCII .Rd files without an
\encoding field, rather than just on ones that are definitely
not from an ISO-8859 encoding. This agrees with the
long-standing stipulation in 'Writing R Extensions', and
catches some packages with UTF-8 man pages.
o R CMD check now warns on DESCRIPTION files with a non-portable
Encoding field, or with non-ASCII data and no Encoding field.
o R CMD check now loads all the 'Suggests' and 'Enhances'
dependencies to reduce warnings about non-visible objects, and
also emulates standard functions (such as shell()) on
alternative R platforms.
o R CMD check now (by default) attempts to latex the vignettes
rather than just weave and tangle them: this will give a NOTE
if there are latex errors.
o R CMD check computations no longer ignore Rd \usage entries for
functions for extracting or replacing parts of an object, so S3
methods should use the appropriate \method{} markup.
o R CMD check now checks for CR (as well as CRLF) line endings in
C/C++/Fortran source files, and for non-LF line endings in
Makefile[.in] and Makevars[.in] in the package 'src'
directory. R CMD build will correct non-LF line endings in
source files and in the make files mentioned.
o Rdconv now warns about unmatched braces rather than silently
omitting sections containing them. (Suggestion by Bill
Dunlap, PR#9649)
Rdconv now renders (rather than ignores) \var{} inside \code{}
markup in latex conversion.
R CMD Rdconv gains a --encoding argument to set the default
encoding for conversions.
o The list of CRAN mirrors now has a new (manually maintained)
column "OK" which flags mirrors that seem to be OK, only those
are used by chooseCRANmirror(). The now exported function
getCRANmirrors() can be used to get all known mirrors or only
the ones that are OK.
o R CMD SHLIB gains arguments --clean and --preclean to clean up
intermediate files after and before building.
o R CMD config now knows about FC and FCFLAGS (used for F9x
compilation).
o R CMD Rdconv now does a better job of rendering quotes in
titles in HTML, and \sQuote and \dQuote into text on Windows.
C-LEVEL FACILITIES
o New utility function alloc3DArray similar to allocMatrix.
o The entry point R_seemsS4Object in Rinternals.h has not been
needed since R 2.4.0 and has been removed. Use IS_S4_OBJECT
instead.
o Applications embedding R can use R_getEmbeddingDllInfo() to
obtain DllInfo for registering symbols present in the
application itself.
o The instructions for making and using standalone libRmath have
been moved to the R Installation and Administration manual.
o CHAR() now returns (const char *) since CHARSXPs should no
longer be modified in place. This change allows compilers to
warn or error about improper modification. Thanks to Hervé
Pagès for the suggestion.
o acopy_string is a (provisional) new helper function that
copies character data and returns a pointer to memory
allocated using R_alloc. This can be used to create a copy of
a string stored in a CHARSXP before passing the data on to a
function that modifies its arguments.
o asLogical, asInteger, asReal and asComplex now accept STRSXP
and CHARSXP arguments, and asChar accepts CHARSXP.
o New entry point R_GE_str2col listed in R_ext/GraphicsEngine.h
for external graphics device developers.
o doKeybd and doMouseevent are now exported in GraphicsDevice.h.
o R_alloc now has first argument of type 'size_t' to support
64-bit platforms (e.g. Win64) with a 32-bit 'long' type.
o The type of the last two arguments of getMatrixDimnames (non-API
but mentioned in R-exts.texi and in Rinternals.h) has been
changed to 'const char **' (from char **).
o R_FINITE now always resolves to the function call R_finite in
packages (rather than sometimes substituting isfinite). This
avoids some issues where R headers are called from C++ code
using features tested on the C compiler.
o The advice to include R headers from C++ inside extern "C" {}
has been changed. It is nowadays better *not* to wrap the
headers, as they include other headers which on some OSes
should not be wrapped.
o Rinternals.h no longer includes a substantial set of C headers.
All but ctype.h and errno.h are included by R.h which is supposed
to be used before Rinternals.h.
o Including C system headers can be avoided by defining NO_C_HEADERS
before including R headers. This is intended to be used from
C++ code, and you will need to include C++ equivalents such as
<cmath> before the R headers.
INSTALLATION
o The 'test-Lapack' test is now part of 'make check'.
o The 'stat' system call is now required, along with 'opendir'
(which had long been used but not tested for). ('make check'
would have failed in earlier versions without these calls.)
o 'evince' is now considered as a possible PDF viewer.
o 'make install-strip' now also strips the DLLs in the standard
packages.
o Perl 5.8.0 (released in July 2002) or later is now required.
(R 2.4.0 and later have in fact required 5.6.1 or later.)
o The C function 'finite' is no longer used: we expect a C99
compiler which will have 'isfinite'. (If that is missing, we
test separately for NaN, Inf and -Inf.)
o A script/executable 'texi2dvi' is now required on Unix-alikes:
it is part of the texinfo distribution.
o Files texinfo.tex and txi-en.tex are no longer supplied in
doc/manual (as the latest versions have an incompatible
licence). You will need to ensure that your texinfo and/or
TeX installations supply them.
o wcstod is now required for MBCS support.
o There are some experimental provisions for building on Cygwin.
PACKAGE INSTALLATION
o The encoding declared in the DESCRIPTION file is now used as
the default encoding for .Rd files.
o A standard for specifying package license information in the
DESCRIPTION License field was introduced, see 'Writing R
Extensions'. In addition, files LICENSE or LICENCE in a package
top-level source directory are now installed (so putting copies
into the 'inst' subdirectory is no longer necessary).
o install.packages() on a Unix-alike now updates
doc/html/packages.html only if packages are installed to
.Library (by that exact name).
o R CMD INSTALL --clean now runs SHLIB --clean to do the clean
up (unless there is a src/Makefile), and this will remove
$(OBJECTS) (which might have been redefined in Makevars).
R CMD INSTALL --preclean cleans up the sources after a
previous installation (as if that had used --clean) before
attempting to install.
R CMD INSTALL will now run R CMD SHLIB in the 'src' directory
if src/Makevars is present, even if there are no source files
with known extensions.
o If there is a file src/Makefile, src/Makevars is now ignored
(it could be included by src/Makefile if desired), and it is
preceded by etc/Makeconf rather than share/make/shlib.mk.
Thus the makefiles read are R_HOME/etc/Makeconf, src/Makefile
in the package and then any personal Makevars files.
o R CMD SHLIB used to support the use of 'OBJS' in Makevars, but
this was changed to 'OBJECTS' in 2001. The undocumented
alternative of 'OBJS' has finally been removed.
o R CMD check no longer issues a warning about no data sets
being present if a lazyload db is found (as determined by the
presence of Rdata.rdb, Rdata.rds, and Rdata.rdx in the 'data'
subdirectory.
BUG FIXES
o charmatch() and pmatch() used to accept non-integer values for
'nomatch' even though the return value was documented to be
integer. Now 'nomatch' is coerced to integer (rather than the
result being coerced to the type of 'nomatch').
o match.call() no longer 'works' outside a function unless
'definition' is supplied. (Under some circumstances it used
to 'work', matching itself.)
o The formula methods of boxplot, cdplot, pairs and spineplot
now attach 'stats' so that model.frame() is visible where
they evaluate it.
o Date-time objects are no longer regarded as numeric by
is.numeric().
o methods("Math") did not work if 'methods' was not attached.
o readChar() read an extra empty item (or more than one) beyond
the end of the source; in some conditions it would terminate
early when reading an item of length 0.
o Added a promise evaluation stack so interrupted promise
evaluations can be restarted.
o R.version[1:10] now nicely prints.
o In the methods package, prototypes are now inherited for the
.Data "slot"; i.e., for classes that contain one of the basic
data types.
o <data frame>[[i, j]] now works if 'i' is character.
o write.dcf() no longer writes NA fields (PR#9796), and works
correctly on empty descriptions.
o pbeta(x, log.p = TRUE) now has improved accuracy in many cases,
and so have functions depending on it such as pt(), pf() and
pbinom().
o mle() had problems with the L-BFGS-B in the no-parameter case
and consequentially also when profiling 1-parameter models
(fix thanks to Ben Bolker).
o Two bugs fixed in methods that in involve the "..." argument in
the generic function: previously failed to catch methods that
just dropped the "..."; and use of callGeneric() with no arguments
failed in some circumstances when "..." was a formal argument.
o sequence() now behaves more reasonably, although not
back-compatibly for zero or negative input.
o nls() now allows more peculiar but reasonable ways of being called,
e.g., with data=list(<uneven lengths>) or a model without variables.
o match.arg() was not behaving as documented when
several.ok=TRUE (PR#9859), gave spurious warnings when 'arg'
had the wrong length and was incorrectly documented (exact
matches are returned even when there is more than one partial
match).
o The data.frame method for split<-() was broken.
o The test for -D__NO_MATH_INLINES was badly broken and returned
true on all non-glibc platforms and false on all glibc ones
(whether they were broken or not).
o LF was missing after the last prompt when --quiet was used without
--slave. Use --slave when no final LF is desired.
o Fixed bug in initialisation code in 'grid' package for
determining the boundaries of shapes. Problem reported
by Hadley Wickham; symptom was error message:
"Polygon edge not found".
o str() is no longer slow for large POSIXct objects. Its output
is also slightly more compact for such objects; implementation
via new optional argument 'give.head'.
o strsplit(*, fixed=TRUE), potentially iconv() and internal string
formatting is now faster for large strings, thanks to report
PR#9902 by John Brzustowski.
o de.restore() gave a spurious warning for matrices (Ben Bolker)
o plot(fn, xlim=c(a,b)) would not set "from" and "to" properly
when plotting a function. The argument lists to curve() and
plot.function() have been modified slightly as part of the
fix.
o julian() was documented to work with POSIXt origins, but did
not work with POSIXlt ones. (PR#9908)
o Dataset HairEyeColor has been corrected to agree with
Friendly (2000): the change involves the breakdown of the
Brown hair / Brown eye cell by Sex, and only totals over Sex
are given in the original source.
o Trailing spaces are now consistently stripped from \alias{}
entries in .Rd files, and this is now documented. (PR#9915)
o .find.packages(), packageDescription() and sessionInfo()
assumed that attached environments named "package:foo" were
package environments, although misguided users could use such
a name in attach().
o spline() and splinefun() with method = "periodic" could return
incorrect results when length(x) was 2 or 3.
o getS3method() could fail if the method name contained a regexp
metacharacter such as "+".
o help(<a character vector>) now uses the name and not the
value of the vector unless it has length exactly one, so
e.g. help(letters) now gives help on 'letters'.
(Related to PR#9927)
o Ranges in chartr() now work better in CJK locales, thanks to
Ei-ji Nakama.
**************************************************
* *
* 2.5 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.5.1 patched
INSTALLATION
o doc/manual now includes the texinfo support file epsf.tex which
basic TeX installations often omit.
BUG FIXES
o Attempting to do in-memory serialization of an object requiring
more than 1Gb might have failed.
o Using formals<- on a function whose body was NULL worked
incorrectly. (PR#9758)
o logb() is now strictly a wrapper for log(), so if S4 methods
are set on log(), logb() will also dispatch on them.
o conflicts(where=) did not work correctly. (PR#9760)
o log(x, base) was intended to handle complex 'base' even for
real 'x', but there was a typo in the code to do so.
o Syntax errors would sometimes misreport the error context.
o qt(p, df=1) is now also correct for very small p. (PR#9804)
qt(p, df=2) ditto; also is more accurate for 0 < |p - 0.5| << 1.
qt(*, log.p=TRUE) now is finite and monotone (again!) where possible.
o Several functions including those making use of printCoefmat(),
layout() and sortedXyData() now work correctly with
non-default settings of options("OutDec").
o S4 method dispatch for group generics (and %*%) failed to pass
arguments to methods as promises and so in some circumstances
methods could change their arguments. (Seen for the 'Math'
group with package Matrix.)
o The print() method for "ts" now handles quarterly and monthly
series which do not start at the beginning of a quarter or
month respectively.
o Deserializing raw objects saved using save(..., ascii=TRUE)
now works correctly.
o ISOLatin7 encoding for postscript/PDF has been corrected.
(PR#9845)
o rbind(x,y) and cbind(x,y) did not dispatch properly when x and
y had multiple S3-style classes.
o The workaround for seeking on > 2Gb files did not work correctly
on Unix-alike 32-bit systems. (PR#9883)
o We had identical(NaN, NA_real_) != identical(NA_real_, NaN),
spotted by Petr Savicky.
CHANGES IN R VERSION 2.5.1
NEW FEATURES
o density(1:20, bw = "SJ") now works as bw.SJ() now tries a larger
search interval than the default (lower, upper) if it does not
find a solution within the latter.
o The output of library() (no arguments) is now sorted by library
trees in the order of .libPaths() and not alphabetically.
o R_LIBS_USER and R_LIBS_SITE feature possible expansion of
specifiers for R version specific information as part of the
startup process.
o C-level warning calls now print a more informative context,
as C-level errors have for a while.
o There is a new option "rl_word_breaks" to control the way the
input line is tokenized in the readline-based terminal
interface for object- and file-name completion.
This allows it to be tuned for people who use their space bar
vs those who do not. The default now allows filename-completion
with +-* in the filenames.
o If the srcfile argument to parse() is not NULL, it will be added
to the result as a "srcfile" attribute.
o It is no longer possible to interrupt lazy-loading (which was
only at all likely when lazy-loading environments), which
would leave the object being loaded in an unusable state.
This is a temporary measure: error-recovery when evaluating
promises will be tackled more comprehensively in 2.6.0.
INSTALLATION
o 'make check' will work with --without-iconv, to accommodate
building on AIX where the system iconv conflicts with
libiconv and is not compatible with R's requirements.
o There is support for 'DESTDIR': see the R-admin manual.
o The texinfo manuals are now converted to HTML with a style
sheet: in recent versions of makeinfo the markup such as @file
was being lost in the HTML rendering.
o The use of inlining has been tweaked to avoid warnings from
gcc >= 4.2.0 when compiling in C99 mode (which is the default
from configure).
BUG FIXES
o as.dendrogram() failed on objects of class "dendrogram".
o plot(type ="s") (or "S") with many (hundreds of thousands)
of points could overflow the stack. (PR#9629)
o Coercing an S4 classed object to "matrix" (or other basic class)
failed to unset the S4 bit.
o The 'useS4' argument of print.default() had been broken by an
unrelated change prior to 2.4.1. This allowed print() and
show() to bounce badly constructed S4 objects between
themselves indefinitely.
o Prediction of the seasonal component in HoltWinters() was one
step out at one point in the calculations.
decompose() incorrectly computed the 'random' component for a
multiplicative fit.
o Wildcards work again in unlink() on Unix-alikes (they did not
in 2.5.0).
o When qr() used pivoting, the coefficient names in qr.coef() were
not pivoted to match. (PR#9623)
o UseMethod() could crash R if the first argument was not a
character string.
o R and Rscript on Unix-alikes were not accepting spaces in -e
arguments (even if quoted).
o Hexadecimal integer constants (e.g. 0x10L) were not being parsed
correctly on platforms where the C function atof did not
accept hexadecimal prefixes (as required by C99, but not
implemented in MinGW as used by R on Windows). (PR#9648)
o libRlapack.dylib on Mac OS X had no version information and
sometimes an invalid identification name.
o Rd conversion of \usage treated '\\' as a single backslash in
all but latex: it now acts consistently with the other
verbatim-like environments (it was never 'verbatim' despite
the documentation).
\code{\.} is now rendered as '\.' in all formats, as
documented (it was not the case for latex conversion).
codoc() (and checkDocStyle() and checkDocUsage()) now apply
the same transformations to \usage as Rd conversion does,
so {, % and \\ in strings in usages will now be related
correctly to the help files.
o rbind() failed if the only data frame had 0 rows. (PR#9657)
o <a data.frame>[i, j] could sometimes select the wrong column
when j is numeric if there are duplicate column names.
o sample(x, size, replace=TRUE, prob) had a memory leak if
10000 < size <= 100000.
o x <- cbind(1:2); rownames(x) <- factor(c("A",NA)) now longer
segfaults.
o R CMD BATCH no longer assumes Sys.unsetenv() is supported (it
is not on older Solaris systems).
o median() returned a logical result when it was 'NA': it now
returns an NA of appropriate type (e.g. integer or double).
o grep(fixed = TRUE, perl = TRUE) ignored 'fixed', although it
was documented to ignore 'perl'
Same for [g]regexpr and [g]sub.
o getNamespaceExports("base") works again.
o runmed(c(), 1) no longer segfaults.
o qr.coef(QR, b) failed for an LAPACK-produced QR if b was
integer or for an over-determined system.
qr.solve() for an under-determined system produces a
solution with 0 and not NA for columns which are unused.
o segments() was not handling full transparency correctly in PDF.
(PR#9694)
Nor was arrows().
o callGeneric() inside a method with extra arguments {and hence
currently defined via .local()} now works.
o [g]sub(fixed=TRUE, useBytes=FALSE) could substitute in the
wrong place in an MBCS locale.
gregexpr() could give incorrect answers in MBCS locales for
perl = TRUE or fixed = TRUE (unless useBytes = TRUE).
o The legacy quartz() device no longer crashes in locator()
if the user attempts to close the window.
o "CGGStackRestore: gstack underflow" warning is no longer shown
in legacy quartz() device.
o formatC() now limits 'digits' to 50 to avoid problems in
C-level sprintf in some OSes.
o seq.int(x, y, by=z) gave 'x' (and not an error) if
0 > (y-x)/z > -1.
o promptClass() now lists methods, including those for generics in
other attached packages.
o Connection-related functions such as readBin() no longer crash
when supplied with a non-connection object.
o as.character.srcref() didn't handle bad srcref objects cleanly.
o predict.nls() no longer requires 'newdata' to contain exactly
the variable names needed to fit the model: variables used on
the LHS only are no longer required and further variables are
allowed.
o plot.hclust() had a 'out by one' error, and ignored the last
object when computing the window region (and could overrun
arrays).
o deriv() was creating results with double (and not integer) dims.
o The unserialize code (e.g. as called by load()) looked for a
function findPackageEnv() to set a saved package environment.
This was missing, but is now supplied.
o [cr]bind could segfault when creating a list matrix result.
(Reported by Martin Morgan.)
o besselI(x, nu, exp=TRUE) and besselY(x, nu) could give wrong
answers for nu < 0. (Reported by Hiroyuki Kawakatsu.)
o [g]sub could confuse a trailing byte '\' for a backreference
in MBCSs where '\' can occur as a trailing byte (not UTF-8 nor
EUC-JP, but SJIS and the CJK character sets used on Windows).
(PR#9751)
CHANGES IN R VERSION 2.5.0
USER-VISIBLE CHANGES
o apropos(x) and find(x) now both only work for character 'x',
and hence drop all non-standard evaluation behaviour.
o Data frames can have 'automatic' row names which are not
converted to dimnames by as.matrix(). (Consequently, e.g.,
t(.) for such data frames has NULL column names.) This
change leads to memory reductions in several places, but can
break code which assumes character dimnames for data frames
derived from matrices.
No existing R object is regarded as having 'automatic' row
names, and it may be beneficial to recreate such objects via
read.table() or data.frame().
o Using $ on an atomic vector now raises a warning, as does use
on an S4 class for which a method has not been defined.
o The Unix-alike readline terminal interface now does
command-completion for R objects, incorporating the
functionality formerly in package 'rcompletion' by Deepayan
Sarkar. This can be disabled by setting the environment
variable R_COMPLETION=FALSE when starting R (e.g. in
~/.Renviron). (Note that when this is enabled, filename
completion no longer works for file paths containing R
operators such as '+' and '-'.)
NEW FEATURES
o abbreviate() no longer has an 8191 byte limit on the size of
strings it can handle.
o abs(x) now returns integer for integer or logical arguments.
o apropos() has a new argument 'ignore.case' which defaults to
TRUE, potentially matching more than previously, thanks to a
suggestion by Seth Falcon.
o args(), str() and print() now give the argument lists of primitive
functions.
o as.matrix() gains the '...' argument that several packages have
assumed it always had (and S-PLUS has).
o Manipulation of integers as roman numerals via as.roman() in
package utils.
o attr() no longer treats name = NA_character_ as meaning
name = "NA".
o binom.test() now allows a 'fuzz' for calculated integer values
in its x and n arguments.
o boxplot(*, notch = TRUE) now warns when notches are outside
hinges; related to PR#7690.
o New function callCC() providing a downward-only version of
Scheme's call with current continuation.
o capabilities() now has a "profmem" entry indicating whether
R has been compiled with memory profiling.
o colnames<-() and rownames<-() now handle data frames explicitly,
so calling colnames<- on a data frame no longer alters the
representation of the row names.
o commandArgs() has a new 'trailingOnly' argument to be used in
conjunction with --args.
o contour() now passes graphical parameters in '...' to axis()
and box().
o New data set 'crimtab' on Student(1908)'s 3000 criminals.
o cut.default() has a new argument 'ordered_result'.
o .deparseOpts() has two new options: "keepNA" to ensure that
different types (logical, integer, double, character and
complex) of NAs are distinguished, and "S_compatible" to
suppress the use of R-specific features such as 123L and to
deparse integer values of a double vector with a trailing
decimal point.
The 'keepInteger' option now uses the suffix 'L' rather than
as.integer() where possible (unless all entries are NA or
"S_compatible" is also set).
Other deparse options can now be added to "all" (which has not
for some time actually switched on all options).
Integer sequences m:n are now deparsed in that form.
o deparse() and dput() now include "keepInteger" and "keepNA" in
their defaults for the 'control' argument.
o detach() now takes another argument, unload, which indicates
whether or not to unload the package and then only cleans
up the S4 methods if the package successfully unloads.
o There are new constants NA_integer_, NA_real_, NA_complex_ and
NA_character_ to denote NAs of those types, and they will be
used in deparsing in place of as.integer(NA) etc unless
.deparseOpts() includes "S_compatible".
o dev.print() now recognizes 'screen devices' as all those with
an enabled display list, rather than a hard-coded set.
o Objects of class "difftime" are now handled more flexibly. The
units of such objects can now be accessed via a units()
function, which also has a replacement form, and there are
conversion methods to and from numeric, which also allow the
specification of units. Objects of this class can also be
stored in data frames now. A format() method has been added,
and the print method was revised.
o New function environmentName() to give the print name of
environments such as "namespace:base".
This is now used by str().
o New function env.profile() provides R level access to summary
statistics on environments. In a related patch, new.env()
now allows the user to specify an initial size for a hashed
environment.
o file() can read the X11 clipboard selection as "X11_clipboard"
on suitable X11-using systems.
o file("stdin") is now recognized, and refers to the process's
'stdin' file stream whereas stdin() refers to the console.
These may differ, for example for a GUI console, an embedded
application of R or if --file= has been used.
o file_test() is now also available in package utils.
(It is now private in package tools.)
o file.show() gains an 'encoding' argument.
o New functions formatUL() and formatOL() in package utils for
formatting unordered (itemize) and ordered (enumerate) lists.
o The statistics reported when gcinfo(TRUE) are now of the amounts
used (in Mb) and not of the amounts free (which are not really
relevant when there are no hard limits, only gc trigger points).
o New function get_all_vars() to retrieve all the
(untransformed) variables that the default method of
model.frame() would use to create the model frame.
o interaction() has a new argument 'lex.order'.
o initialize() (in methods) now tries to be smarter about
updating the new instance in place, thereby reducing
copying.
o install.packages(dependencies = NA) is a new default, which is
to install essential dependencies when installing from
repositories to a single library. As a result of this change,
update.packages() will install any new dependencies of the
packages it is updating (alongside the package in the same
library tree).
If 'lib' is not specified or is specified of length one and
the chosen location is not a writable directory,
install.packages() offers to create a personal library
directory for you if one does not already exist, and to
install there.
o is.atomic, is.call, is.character, is.complex, is.double (== is.real),
is.environment, is.expression, is.function, is.integer,
is.list, is.logical, is.null, is.object, is.pairlist,
is.recursive, is.single and is.symbol (== is.name) are no
longer internally S3 generic, nor can S4 methods be written
for them.
The "factor" methods of is.integer and is.numeric have been
replaced by internal code.
o Added is.raw() for completeness.
o l10n_info() also reports if the current locale is Latin-1.
o levels<-(), names() and names<-() now dispatch internally for
efficiency and so no longer have S3 default methods.
o .libPaths() now does both tilde and glob expansion.
o Functions lm(), glm() loess(), xtabs() and the default method
of model.frame() coerce their 'formula' argument (if supplied)
to a formula.
o max(), min() and range() now work with character vectors.
o message() has a new argument 'appendLF' to handle messages
with and without newlines. There is a new message class
packageStartupMessage() that can be suppressed separately.
o A new function, method.skeleton() writes a skeleton version of
a call to setMethod() to a file, with correct arguments and
format, given the name of the function and the method signature.
o mode<- and storage.mode<- do slightly less copying.
o nls.control(* , printEval = FALSE, warnOnly = FALSE) are two new
options to help better analyze (non-)convergence of nls(),
thanks to Kate Mullen.
nls() and summary(nls()) now contain more information and also
print information about convergence.
o options(device = ) now accepts a function object as well as
the name of a function.
o pdf() supports new values for 'paper' of "US" (same as
"letter"), "a4r" and "USr" (the latter two meaning rotated to
landscape). postscript() also accepts paper = "US".
o persp() now respects the graphical pars 'cex.axis', 'cex.lab',
'font.axis' and 'font.lab'.
o New faster internal functions pmax.int() and pmin.int() for
inputs which are atomic vectors without classes (called by
pmax/pmin where applicable).
pmin/pmax are now more likely to work with classed objects:
they work with POSIXlt datetimes, for example.
o postscript() now by default writes grey colors (including black
and white) via 'setgray', which gives more widely acceptable
output. There are options to write pure RGB, CMYK or gray via
the new argument 'colormodel'.
o rbind.data.frame() now ignores all zero-row inputs, as well as
zero-column inputs (which it used to do, undocumented). This
is because read.table() can create zero-row data frames with
NULL columns, and those cannot be extended.
o readChar() and writeChar() can now work with a raw vector.
o read.table(), write.table() and allies have been moved to package
utils.
o rgb() now accepts the red, green and blue components in a
single matrix or data frame.
o New utility function RShowDoc() in package 'utils' to find and
display manuals and other documentation files.
o New .row_names_info() utility function finds the number of rows
efficiently for data frames; consequently, dim.data.frame()
has become very fast for large data frames with 'automatic'
row names.
o RSiteSearch() now also allows to search postings of the 'R-devel'
mailing list.
o screeplot() is now (S3) generic with a default method, thanks
to a patch from Gavin Simpson.
o Experimental 'verbose' argument for selectMethod(). Might be
replaced later by a better interface for method selection
inspection.
o Added links to source files to the parsing routines, so that
source() can now echo the original source and comments (rather
than deparsing). This affects example() and Sweave() as well.
o stack() and unstack() have been moved to package utils.
o strptime() now sets the "tzone" attribute on the result if
tz != "".
o str.default() typically prints fewer entries of logical vectors.
o The RweaveLatex driver for Sweave() now supports two new
options: expand=FALSE, to show chunk references in the output,
and concordance=TRUE, to output the concordance between input
and output lines.
o system() now takes the same set of arguments on all platforms,
with those which are not applicable being ignored with a
warning. Unix-alikes gain 'input' and 'wait', and Windows
gains 'ignore.stderr'.
o system.time() and proc.time() now return an object of class
"proc_time" with a print() method that returns a POSIX-like
format with names.
o Sys.getenv() has a new argument 'unset' to allow unset and set
to "" to be distinguished (if the OS does). The results of
Sys.getenv() are now sorted (by name).
o New function Sys.glob(), a wrapper for the POSIX.2 function
glob(3) to do wildcard expansion (on systems which have it,
plus an emulation on Windows).
o Sys.setenv() is a new (and preferred) synonym for Sys.putenv().
The internal C code uses the POSIX-preferred 'setenv' rather
than 'putenv' where the former is available.
o New function Sys.unsetenv() to remove environment variables
(on systems where unsetenv is implemented or putenv can remove
variables, such as on Windows).
o text(), mtext(), strheight(), strwidth(), legend(), axis(),
title(), pie(), grid.text() and textGrob() all attempt to
coerce non-language annotation objects (in the sense of is.object)
to character vectors. This is principally intended to cover
factors and POSIXt and Date objects, and is done via the
new utility function as.graphicsAnnot() in package grDevices.
o tcltk:tk_select.list() now chooses the width to fit the widest item.
o {re,un}tracemem() are now primitives for efficiency and so
migrate from 'utils' to 'base'.
o union(), interect(), setdiff() and setequal() now coerce their
arguments to be vectors (and they were documented only to
apply to vectors).
o uniroot() now works if the zero occurs at one of the ends of
the interval (suggestion of Tamas Papp).
o There is a new function View() for viewing matrix-like
objects in a spreadsheet, which can be left up whilst R is
running.
o New function withVisible() allows R level access to the
visibility flag.
o zip.file.extract() has been moved to package utils.
o A few more cases of subassignment work, e.g. <raw>[] <- <list>
and <vector>[] <- <expression>, with suitable coercion of the LHS.
o There is a warning if \ is used unnecessarily in a string when
being parsed, e.g. "\." where probably "\\." was intended.
("\." is valid, but the same as ".".) Thanks to Bill Dunlap
for the suggestion.
o Introduced the suffix L for integer literals to create
integer rather than numeric values, e.g. 100L, 0x10L, 1e2L.
o Set the parser to give verbose error messages in case of
syntax errors.
o The class "LinearMethodsList" has been extended and will be
used to create list versions of methods, derived from the
methods tables (environments). The older recursive
"MethodsList" class will be deprecated (by the release of
2.5.0 if possible).
o There are more flexible ways to specify the default library
search path. In addition to R_LIBS and .Library, there are
.Library.site (defaults to R_HOME/site-library) and
R_LIBS_USER (defaults to a platform- and version-specific
directory in ~/R). See ?.libPaths for details.
o LAPACK has been updated to version 3.1.0. This should cause
only small changes to the output, but do remember that the sign
of eigenvectors (and principal components) is indeterminate.
o PCRE has been updated to version 7.0.
o Several functions handle row names more efficiently:
- read.table() and read.DIF() make use of integer row names
where appropriate, and avoid at least one copy in assigning
them.
- data.frame() and the standard as.data.frame() methods avoid
generating long dummy row names and then discarding them.
- expand.grid() and merge() generate compact 'automatic' row
names.
- data.matrix() and as.matrix.data.frame() have a new argument
'rownames.force' that by default drops 'automatic' row names.
o <data frame>[i, j] is substantially more memory-efficient when
only a small part of the data frame is selected, especially
when (part of) a single column is selected.
o Command-line R (and Rterm.exe under Windows) accepts the options
'-f filename', '--file=filename' and '-e expression' to follow
other script interpreters. These imply --no-save unless
--save is specified.
o Invalid bytes in character strings in an MBCS now deparse/print
in the form "\xc1" rather than "<c1>", which means they can be
parsed/scanned.
o Printing functions (without source attributes) and expressions
now preserves integers (using the L suffix) and NAs (using
NA_real_ etc where necessary).
o The 'internal' objects .helpForCall, .tryHelp and topicName are
no longer exported from 'utils'.
o The internal regex code has been upgraded to glibc 2.5 (from 2.3.6).
o Text help now attempts to display files which have an \encoding
section in the specified encoding via file.show().
o R now attempts to keep track of character strings which are
known to be in Latin-1 or UTF-8 and print or plot them
appropriately in other locales. This is primarily intended
to make it possible to use data in Western European languages
in both Latin-1 and UTF-8 locales. Currently scan(),
read.table(), readLines(), parse() and source() allow
encodings to be declared, and console input in suitable
locales is also recognized.
New function Encoding() can read or set the declared encodings
for a character vector.
o There have been numerous performance improvements to the data
editor on both Windows and X11. In particular, resizing the
window works much better on X11.
o Packages graphics and grid no longer require grDevices, as
they might be used only with third-party devices.
DEPRECATED & DEFUNCT
o symbol.C() and symbol.For() are defunct, and have been replaced
by wrappers that give a warning.
o Calling a builtin function with an empty argument is now always
an error.
o The autoloading of ts() is defunct.
o The undocumented reserved word GLOBAL.ENV has been removed.
(It was yet another way to get the value of the symbol
.GlobalEnv.)
o The deprecated behaviour of structure() in adding a class when
specifying with "tsp" or "levels" attributes is now defunct.
o unix() is now finally defunct, having been deprecated for
at least seven years.
o Sys.putenv() is now deprecated in favour of Sys.setenv(),
following the POSIX recommendation.
o Building R with --without-iconv is deprecated.
o Using $ on an atomic vector is deprecated (it was previously
valid and documented to return NULL).
o The use of storage.mode<- for other than standard types (and
in particular for value "single") is deprecated: use mode<-
instead.
INSTALLATION
o A suitable iconv (e.g. from glibc or GNU libiconv) is
required. For 2.5.x only you can build R without it by
configuring using --without-iconv.
o There is support again for building on AIX (tested on 5.2 and 5.3)
thanks to Ei-ji Nakama.
o Autoconf 2.60 or later is used to create 'configure'. This
makes a number of small changes, and incorporates the changes
to the detection of a C99-compliant C compiler backported for
2.4.1.
o Detection of a Java development environment was added such that
packages don't need to provide their own Java detection. Newly
added make variables are JAVAC, JAVAH, JAR and JAVA_CPPFLAGS.
R CMD javareconf was updated to look for the corresponding
Java tools as well.
In addition, Java detection honors user-supplied environment
variables JAVA_CPPFLAGS, JAVA_LIBS and JAVA_LD_LIBRARY_PATH.
o Added workaround for reported non-POSIX sh on OSF1. (PR#9375)
o 'make install-strip' now works, stripping the executables and
also the shared libraries and modules on platforms where
'libtool' knows how to do so.
o Building R as a shared library and standalone nmath now
installs pkg-config files 'libR.pc' and 'libRmath.pc' respectively.
o Added test for insufficiently complete implementation of sigaction.
C-LEVEL FACILITIES
o Functions str2type, type2char and type2str are now available in
Rinternals.h.
o Added support for Objective C in R and packages (if available).
o R_ParseVector() has a new 4th argument 'SEXP srcfile' allowing
source references to be attached to the returned expression list.
o Added ptr_R_WriteConsoleEx callback which allows consoles to
distinguish between regular output and errors/warnings.
To ensure backward compatibility it is only used if
ptr_R_WriteConsole is set to NULL.
UTILITIES
o Additional Sweave() internal functions are exported to help
writing new drivers, and RweaveLatexRuncode() is now created
using a helper function (all from a patch submitted by Seth
Falcon).
o The following additional flags are accessible from R CMD config:
OBJC, OBJCFLAGS, JAR, JAVA, JAVAC, JAVAH, JAVA_HOME, JAVA_LIBS
and JAVA_CPPFLAGS.
o R CMD build now takes the package name from the DESCRIPTION
file and not from the directory. (PR#9266)
o checkS3methods() (and hence R CMD check) now checks agreement
with primitive internal generics, and checks for additional
arguments in methods where the generic does not have a '...'
argument.
codoc() now knows the argument lists of primitive functions.
o R CMD INSTALL and R CMD REMOVE now use as the default library
(if -l is not specified) the first library that would be used
if R were run in the current environment (and they run R to
find it).
o There is a new front-end Rscript which can be used for #!
scripts and similar tasks. See help("Rscript") and 'An
Introduction to R' for further details.
o R CMD BATCH (not Windows) no longer prepends
'invisible(options(echo = TRUE))' to the input script. This
was the default unless --slave is specified and the latter is
no longer overridden.
On all OSes it makes use of the -f argument to R, so
file("stdin") can be used from BATCH scripts.
On all OSes it reports proc.time() at the end of the script
unless q() is called with options to inhibit this.
o R CMD INSTALL now prepends the installation directory (if
specified) to the library search path.
o Package installation now re-encodes R files and the NAMESPACE
file if the DESCRIPTION file specifies an encoding, and sets
the encoding used for reading files in preparing for
LazyData. This will help if a package needs to be used in
(say) both latin1 and UTF-8 locales on different systems.
o R CMD check now reports on non-ASCII strings in datasets.
(These are a portability issue, which can be alleviated by
marking their encoding: see 'Writing R Extensions'.)
o Rdiff now converts CRLF endings in the target file, and
converts UTF-8 single quotes in either to ASCII quotes.
o New recommended package 'codetools' by Luke Tierney provides
code-analysis tools. This can optionally be used by 'R CMD
check' to detect problems, especially symbols which are not
visible.
o R CMD config now knows about LIBnn .
o New recommended package 'rcompgen' by Deepayan Sarkar
provides support for command-line completion under the Unix
terminal interface (provided readline is enabled) and the
Windows Rgui and Rterm front ends.
BUG FIXES
o gc() can now report quantities of 'Vcells' in excess of 16Gb on
64-bit systems (rather than reporting NA).
o Assigning class "factor" to an object now requires it has
integer (and not say double) codes.
o structure() ensures that objects with added class "factor" have
integer codes.
o The "formula" and "outer" attributes of datasets 'ChickWeight',
'CO2', 'DNase', 'Indometh', 'Loblolly', 'Orange' and 'Theoph'
now have an empty environment and not the environment used to
dump the datasets in the package.
o Dataset 'Seatbelts' now correctly has class c("mts", "ts").
o str() now labels classes on data frames more coherently.
o Several 'special' primitives and .Internals could return
invisibly if the evaluation of an argument led to the
visibility flag being turned off. These included
as.character(), as.vector(), call(), dim(), dimnames(),
lapply(), rep(), seq() and seq_along(). Others (e.g. dput()
and print.default()) could return visibly when this was not
intended.
o Several primitives such as dim() were not checking the number
of arguments supplied before method dispatch.
o Tracing of primitive functions has been corrected. It should
now be the case that tracing either works or is not allowed
for all primitive functions. (Problems remain if you make a
primitive into a generic when it is being traced. To be fixed
later.)
o max.col() now omits infinite values in determining the
relative tolerance.
o R CMD Sweave and R CMD Stangle now respond to --help and --version
like other utilities.
o .libPaths() adds only existing directories (as it was
documented to, but could add non-directories).
o setIs() and setClassUnion() failed to find some existing
subclasses and produced spurious warnings, now fixed.
o data.frame() ignored 'row.names' for 0-column data frames, and
no longer treats an explicit row.names=NULL differently from
the default value.
o identical() looked at the internal structure of the
'row.names' attribute, and not the value visible at R level.
o abline(reg) now also correctly works with intercept-only lm
models, and abline() warns more when it's called illogically.
o warning() was truncating messages at
getOption("warning.length") - 1 (not as documented), with no
indication. It now appends '[... truncated]'.
o Stangle/Sweave were throwing spurious warnings if options
'result' or 'strip.white' were unset.
o all.equal() was ignoring 'check.attributes' for list and
expression targets, and checking only attributes on raw vectors.
Logical vectors were being compared as if they were numeric,
(with a mean difference being quoted).
o Calculating the number of significant digits in a number was
itself subject to rounding errors for digits >= 16. The
calculation has been changed to err on the side of slightly
too few significant digits (but still at least 15) rather than
far too many. (An example is print(1.001, digits=16).)
o unlink() on Unix-alikes failed for paths containing spaces.
o substr() and friends treated NA 'start' or 'stop' incorrectly.
o merge(x, y, all.y = TRUE) would sometimes incorrectly return
logical columns for columns only in y when there were no
common rows.
o read.table(fn, col.names=) on an empty file returned NULL
columns, rather than logical(0) columns (which is what results
from reading a file with just a header).
o grid.[xy]axis(label=logical(0)) failed.
o expression() was unnecessarily duplicating arguments.
o as.expression(<list>) returned a single-element expression
vector, which was not compatible with S: it now copies lists
element-by-element.
o supsmu(periodic = TRUE) could segfault. (PR#9502, detection
and patch by Bill Dunlap.)
o pmax/pmin called with only logical arguments did not coerce to
numeric, although they were documented to do so (as max/min
do).
o methods() did not know that cbind() and rbind() are internally
generic.
o dim(x) <- NULL removed the names of x, but this was always
undocumented. It is not clear that it is desirable but it is
S-compatible and relied on, so is now documented.
o which(x, arr.ind = TRUE) did not return a matrix (as
documented) if 'x' was an array of length 0.
o C-level duplicate() truncated CHARSXPs with embedded nuls.
o Partial matching of attributes was not working as documented
in some cases if there were more than two partial matches or
if "names" was involved.
o data(package=character(0)) was not looking in ./data as
documented.
o summary.mlm() failed if some response names were "" (as can
easily happen if cbind() is used).
o The postscript() and pdf() drivers shared an encoding list
but used slightly different formats. This caused problems if
both were used with the same non-default encoding in the same
session. (PR#9517)
o The data editor was not allowing Inf, NA and NaN to be entered
in numerical columns. It was intended to differentiate
between empty cells and NAs, but did not do so: it now does
so for strings.
o supsmu() could segfault if all cases had non-finite values.
(PR#9519)
o plnorm(x, lower.tail=FALSE) was returning the wrong tail for
x <= 0. (PR#9520)
o which.min() would not report a minimum of +Inf, and
analogously for which.max(). (PR#9522)
o 'R CMD check' could fail with an unhelpful error when checking
Rd files for errors if there was only one file and that had a
serious error. (PR#9459)
o try() has been reimplemented using tryCatch() to solve two
problems with the original implementation: (i) try() would run
non-NULL options("error") expressions for errors within a try, and
(ii) try() would catch user interrupts.
o str(obj) could fail when obj contained a dendrogram.
o Using <data frame>[, <last column>] <- NULL failed (PR#9565)
o choose(n, k) could return non-integer values for integer n and
small k on some platforms.
o nclass.scott(x) and nclass.FD(x) no longer return NaN when var(x)
or IQR(x) (respectively) is zero.
hist() now allows breaks = 1 (which the above patch will
return), but not breaks = Inf (which gave an obscure error).
o strptime("%j") now also works for the first days of Feb-Dec.
(PR#9577)
o write.table() now recovers better if 'file' is an unopened
connection. (It used to open it for both the column names and
the data.)
o Fixed bug in mosaicplot(sort=) introduced by undocumented
change in R 2.4.1 (changeset r39655).
o contr.treatment(n=0) failed with a spurious error message.
(It remains an error.)
o as.numeric() was incorrectly documented: it is identical to
as.double.
o jitter(rep(-1, 3)) gave NaNs. (PR#9580)
o max.col() was not random for a row of zeroes. (PR#9542)
o ansari.test(conf.int=TRUE, exact=FALSE) failed.
o trace() now works on S3 registered methods, by modifying the
version in the S3 methods table.
o rep(length=1, each=0) segfaulted.
o postscript() could overflow a buffer if used with a long
'command' argument.
o The internal computations to copy complete attribute lists did
not copy the flag marking S4 objects, so the copies no longer
behaved like S4 objects.
o The C code of nlminb() was altering a variable without
duplicating it. (This did not affect nlminb() but would have
if the code was called from a different wrapper.)
o smooth(kind = "3RS3R") (the current default) used .C(DUP =
FALSE) but altered its input argument. (This was masked by
duplication in as.double.)
o The signature for the predefined S4 method for as.character()
was missing '...' .
o readBin(<raw vector>) could read beyond the end of the vector
when size-changing was involved.
o The C entry point PrintValue (designed to emulate auto-printing)
would not find show() for use on S4 objects, and did not have
the same search path (for show(), print() and print() methods)
as auto-printing. Also, auto-printing and print() of S4
objects would fail to find 'show' if the methods name space was
loaded but the package was not attached (or otherwise not in
the search path).
o print() (and auto-printing) now recognize S4 objects even when
'methods' is not loaded, and print a short summary rather than
dump the internal structure.
o Sweave and Stangle had problems due to partial matching of code
chunk names when run with split=TRUE.
o install.packages() on a source package now ensures that
R CMD INSTALL sees the same library search path as
install.packages() did when computing dependencies.
o density() now ensures its 'y' values are non-negative. (PR#8876)
o is.finite() and is.infinite() (and many other primitives)
are not internally generic and so do not support S4 methods,
which can no longer be set. (PR#7951)
o nls(algorithm = "port") now accepts a list 'start' argument,
as for the other methods (and as documented).
o Standard errors from the "ar" method of predict() could be
wrong for the last p predictions for models near
non-stationarity. (PR#9614)
**************************************************
* *
* 2.4 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.4.1 patched
NEW FEATURES
o The Simplified Chinese translations have been completed.
BUG FIXES
o co.intervals() sometimes failed to cover the largest value.
o tempfile() is now random across sessions as well as within a
session. (On some systems it would give the same hex suffix
at the start of each session.)
o Added infinite recursion test to internal function isMissing.
(PR#9426)
o The "Date" and "POSIXt" methods for cut() were not choosing
the first day of the year for breaks = "years".
(In part, PR#9433.)
o R is now able to deparse/print invalid multibyte strings in
MBCS locales (such as UTF-8) using hex escapes. This means
that e.g. demo(Hershey) works in all such locales.
o optimize() could give incorrect answers in some rare problems
with exact symmetry about the midpoint of the interval
supplied. (PR#9438)
o The residuals from an lm() fit with no coefficients but an
offset were incorrect.
o oneway.test() was expecting a literal formula and did not
accept a variable containing a formula.
o The legacy Quartz device (used by console R) displayed its
window outside the screen estate in some dual-head setups.
Now it will be always displayed in the center of the main
screen.
o read.ftable() was not functional on non-seekable connections
such as URLs.
o Some large memory allocations could cause segfaults or
crashes (e.g. followup to PR#9557).
o Sweave() would drop characters from the end of chunk names
ending in "R". (PR#9567)
o library(), i.e. its internal checkConflicts(), now (again) prints
"The following object(s) are masked .." only once per masked package.
o methods:::cbind(x) {one argument} now works, calling cbind2(x)
when 'x' is an S4 object.
CHANGES IN R VERSION 2.4.1
INSTALLATION
o The extraction of info from Subversion for an SVN checkout now
also works for svn >= 1.4.0. However, on Windows the 'Last
Changed Date' will be in the local timezone, and not in GMT as
previously.
o configure uses code borrowed from autoconf 2.60 to try harder to
ensure that a C99-compliant compiler is used. (It does so by
appending to CC.) This avoids problems with systems such as FC5
which override CFLAGS and thereby lose flags such as -std=gnu99.
NEW FEATURES
o rainbow(), heat.colors(), terrain.colors(), topo.colors() and
cm.colors() all gain an 'alpha' argument to be passed to hsv().
o dput() will give an incorrect representation of the row names
of a data frame with integer row names. This is now corrected
when the object is recreated.
C-LEVEL FACILITIES
o Using STRICT_R_HEADERS applies to more reported clashes with
Windows headers, including Calloc and Realloc. These and
Free need to be prefixed by R_ when STRICT_R_HEADERS is defined.
DEPRECATED & DEFUNCT
o The previously undocumented behaviour of structure() in adding a
class when specifying "tsp" or "levels" attributes is now
deprecated (with a warning).
BUG FIXES
o Fixed warning() to use .dfltWarn intead of .dfltStop for default
handling (PR#9274).
o R would slow down when the product of the length of a vector and
the length of a character vector used to subset it exceeded 2^31.
(PR#9280)
o merge() now allows zero-row data frames.
o add1.lm() had been broken by other changes for weighted fits.
o axis.POSIXct() would sometimes give the wrong labels.
o Help for a method call would fail. (PR#9291)
o gzfile() returned an object of class "file" not "gzfile". (PR#9271)
o load()ing from a connection had a logic bug in when it closed
the connection. (PR#9271)
o The lowess() algorithm is unstable if the MAD of the residuals
becomes (effectively) zero: R now terminates the iterations at
that point. (This may result in quite different answers.)
The 'delta' argument was incorrectly documented. (PR#9264)
o abbreviate() would only work for strings of up to 8191 bytes,
but this was not checked. Now longer strings are errors.
o Drawing X11 rotated text was buggy for VERY small (negative)
angle of rotation. Reported by Ben Bolker. (PR#9301)
o The X11 data editor would crash in an MBCS locale if R was
compiled with FC's CFLAGS that add buffer overflow and
stack-smashing detection.
o rect() was not accepting border=NA in some cases involving
cross-hatching.
o Fixes to S4 group generics to ensure that the correct number of
active arguments are in the signature of the group and all
members. Also a fix to keep the 'groupMembers' slot up to date.
o S4 group generic "Logic" (with '&', '|', but not '!') has been
created, following the green book (apart from '!').
o removeClass() now takes care to remove any subclass references
to the deleted class.
o mle() (in stats4) might not have worked as intended when the
order of parameters in 'start' differed from that in the
log-likelihood. (PR#9313)
o dotchart() now properly restores par() settings after itself.
o system() on Mac OS X was blocking arbitrary signals during the
call although only SIGPROF was meant to be blocked.
o methods cached via callNextMethod() and (sometimes) as() were
being cached as directly specified although in fact they were
inherited. Caused problems in later search for inherited methods.
o str() works properly for method definitions and other S4-classed
function objects.
o JAVA_LIBS are now set correctly on MacOS X.
o Fix null-termination issue suspected of causing crash with Fedora
Extra RPMS (PR#9339, Justin Harrington, analysis and fix from Bill
Dunlap).
o Name spaces restored via a saved session silently failed to cache
their methods because the methods package was not yet
attached. Fixed by attaching methods before restoring data.
o rbind()ing a list to a data frame generated invalid row names,
which were an error in 2.4.0. (PR#9346)
o boxplot.stats(x) now returns the correct minimum instead of an
error for x <- c(1,Inf,Inf,Inf), and hence boxplot(x) "works".
o promptClass() now uses \linkS4class{<ClassName>} instead of
of \link{<ClassName>-class}.
o gc() no longer reports nonsense values for the number of used
Vcells if the true value exceeds 2^31 (and hence over 16Gb of
heap is in use): it now reports NA. (PR#9345)
o rapply() now detects more user errors in supplying arguments. (PR#9349)
o boxplot() was ignoring argument 'boxfill'. (PR#9352)
o plot.lm(which = 6, id.n = 0) did not work. (PR#9333)
o .deparseOpts("delayPromises") was not matching the C code,
returning 64 rather than 32.
o bxp() could use partial matching on 'pars' when finding
defaults for some of its parameters, e.g. a setting of 'cex.axis'
in 'pars' or inline was used to set a default for 'outcex'.
o acf() now allows lag.max = 0 except when type="partial", and
forces the lag 0 autocorrelation to 1. (PR#9360)
o hist(*, include.lowest=., right=., plot=FALSE) does not warn
anymore, (PR#9356) and more.
o Some bugs in caching superclass/subclass relations and in
removing those relations on detach and on removeClass() have
been fixed.
o readBin() could return one too many strings if 'n' was an
over-estimate. (PR#9361)
o A request for an opaque colour in the pdf() device after a
translucent one did not set the transparency back to opaque in
2.4.0.
Semi-transparent background colours were not being plotted on
the pdf() device.
o plot.lm(which=5) in the case of constant leverage re-ordered
the factor levels but not the residuals, so the labelling by
factor level was often incorrect.
o packBits() was not accepting a logical argument. (PR#9374)
o make install was omitting doc/FAQ and doc/RESOURCES.
o A two-sample t.test(x, y, var.equal=TRUE) did not allow one of the
groups to be of size one.
o The "ts" method for print() failed on some corrupted objects
of class "ts", e.g. those without a "tsp" attribute.
o structure() reordered the "class" value given if there was a
"tsp" value specified.
o pairs() now does pass appropriate parts of '...' to the
'diag.panel' argument. (PR#9384)
o plot.lm() was using an incorrect estimate of dispersion for
some GLMs (including family=binomial and family=poisson).
(PR#9316)
o Subsetting operators were setting R_Visible too early, so
assignments in arguments could make the result invisible.
(PR#9263)
o The tk-GUI was displaying a warning due to an extra comma in
the list of manuals (PR#9396)
o packageDescription() now gives an explicit error on a corrupt
DESCRIPTION file.
o There was a scoping issue with tcltk callbacks given as
unevaluated expressions. This has only been partially fixed, a
complete fix probably requires redesign.
o trace() had its return value documented incorrectly and was
sometimes visible when it should not have been.
o pchisq() would sometimes use the wrong tail when calculating
non-central probabilities with lower.tail = FALSE. (PR#9406)
o rm() could remove the wrong objects when passed an expression.
(PR#9399) Now only names are allowed in the '...' argument,
and the incorrect documentation of what happened with
character objects is corrected.
o url() was not supporting 'encoding' except on file:// URLs.
CHANGES IN R VERSION 2.4.0
USER-VISIBLE CHANGES
o The startup message now prints first the version string and
then the copyright notice (to be more similar to R --version).
o save() by default evaluates promise objects. The old behaviour
(to save the promise and its evaluation environment) can be
obtained by setting the new argument 'eval.promises' to FALSE.
(Note that this does not apply to promises embedded in
objects, only to top-level objects.)
o The functions read.csv(), read.csv2(), read.delim(),
read.delim2() now default their 'comment.char' argument to "".
(These functions are designed to read files produced by other
software, which might use the # character inside fields, but
are unlikely to use it for comments.)
o The bindings in the base environment/name space (currently the
same thing) are now locked. This means that the values of
base functions cannot be changed except via
assignInNamespace() and similar tricks.
o [[ on a factor now returns a one-element factor (and not an
integer), as.list() on a factor returns a list of one-element
factors (and not of character vectors), and unlist() on a list
of factors returns a factor (and not an integer vector).
These changes may affect the results of sapply() and lapply()
applied to factors.
o mauchly.test() now returns the W statistic (for comparability
with SAS and SPSS), rather than the z (which was accidentally
not named in the output)
o sort(x, decreasing = FALSE, ...) is now a generic function.
This means that 'partial' is no longer the second argument,
and calls which used positional matching may be incorrect: we
try to detect them.
o See the section on 'Changes to S4 methods': all packages
depending on 'methods' need to be re-installed.
NEW FEATURES
o agrep(), grep(), strwrap(), strtrim(), substr() and
related functions now coerce arguments which should be
character via as.character() rather than internally (so method
dispatch takes place, e.g. for factors).
chartr(), charfold(), tolower() and toupper() now coerce their
main argument if necessary to a character vector via
as.character().
Functions which work element-by-element on character vectors
to give a character result now preserve attributes including
names, dims and dimnames (as suggested by the Blue Book
p. 144). Such functions include charfold(), chartr(), gsub(),
strtrim(), sub(), substr(), tolower() and toupper(). (Note
that coercion of a non-character argument may lose the
attributes.)
agrep(value = TRUE) preserves names for compatibility with
grep().
nchar() has always preserved dims/dimnames (undocumented
before) and now also preserves names.
o .Deprecated and .Defunct take a new parameter, msg, that allows
for the specification of the message printed and facilitates
deprecation of calling sequences etc.
o .Fortran() will map 'name' to lower case, and will work with
'name' containing underscores.
o The default is now .saveRDS(compress = TRUE)
o The :: operator now also works for packages without name spaces
that are on the search path.
o [[ on a list does not duplicate the extracted element unless
necessary. (It did not duplicate in other cases, e.g. a
pairlist.)
o argsAnywhere() works like args() on non-exported functions.
o as.data.frame() gains a '...' argument.
o Added an as.data.frame() method for class "ftable".
o as.list(<an expression>) is now handled by internal code and
no longer loses attributes such as names.
as.list(<a list>) no longer duplicates (unnecessarily).
o as.POSIX[cl]t can now convert character strings containing
fractional seconds.
o attach() can now attach a copy of an environment.
o available.packages() and installed.packages() gain a 'fields'
argument thanks to Seth Falcon.
o axis.POSIXct() uses a different algorithm for ranges of 2 to 50
days that will mark days at midnight in the current timezone
(even if the graph crosses a DST change).
o body<-() and formals<-() default to envir = environment(fun),
that is they do not by default change the environment.
(Previously they changed it to parent.frame().)
o New function combn(x, m, ..) for computing on all combinations of
size 'm' (for small 'm' !).
o The cumxxx() functions now handle logical/integer arguments
separately from numeric ones, and so return an integer result
where appropriate.
o data.frame() has a new argument 'stringsAsFactor'. This and
the default for read.table(as.is=) are set from the new global
option 'stringsAsFactors' via the utility function
default.stringsAsFactors().
o dev.interactive() now has an optional argument 'orNone'.
o df() now has a noncentrality argument 'ncp', based on a
contribution by Peter Ruckdeschel.
o example() gains an argument 'ask' which defaults to "TRUE when
sensible", but the default can be overridden by setting option
'example.ask'.
o expand.grid() now has an argument 'KEEP.OUT.ATTRS' which can
suppress (the potentially expensive) "out.attrs" attribute. It no
longer returns an extraneous 'colnames' attribute.
o The subset and subassign methods for factors now handle factor
matrices, and dim() can be set on a factor.
o There is now a format() method for class "ftable".
o head(x, n) and tail(x, n) now also work for negative arguments,
thanks to Vincent Goulet.
o head.matrix() and tail.matrix() are no longer hidden, to be used
for building head() and tail() methods for other classes.
o If help() finds multiple help files for a given topic, a menu
of titles is used to allow interactive choice.
o help.search() now rebuilds the database if 'package' specifies a
package not in the saved database.
o hist(*, plot = FALSE) now warns about unused arguments.
o history() gains a 'pattern' argument as suggested by Romain
Francois.
o integer(0) now prints as that rather than "numeric(0)" (it
always deparsed as "integer(0)").
o interaction(..., drop=TRUE) now gives the same result as
interaction(...)[,drop=TRUE] (it used to sometimes give a
different order for the levels).
o lag.plot() produces a conventional plot (not setting mfrow) if
only one plot is to be produced.
o lapply() does much less copying. Vector X are handled without
duplication, and other types are coerced via as.list(). (As a
result, package 'boot' runs its examples 4% faster.)
lapply(<a pairlist>) now coerces to a list (rather than traverse
the pairlist from the beginning for each item).
o legend() has new parameters 'box.lwd' and 'box.lty'.
o lines() gains a simple method for isoreg() results.
o load() no longer coerces pairlists to lists (which was
undocumented, but has been happening since 1998).
o make.link() now returns an object of class "link-glm".
The GLM families accept an object of this class for their
'link' argument, which allows user-specified link functions.
Also, quasi() allows user-specified variance functions.
o mapply() uses names more analogously to lapply(), e.g..
o matplot() now accepts a 'bg' argument similarly to plot.default() etc.
o median() is now generic, and its default method uses mean()
rather than sum() and so is more widely applicable (e.g. to dates).
o Dummy functions memory.size() and memory.limit() are available
on Unix-alikes, for people who have not noticed that documentation
is Windows-specific.
o merge() works more efficiently when there are relatively few
matches between the data frames (for example, for 1-1
matching). The order of the result is changed for 'sort = FALSE'.
o merge() now inserts row names as a character column and not a
factor: this makes the default sort order more comprehensible.
o Raw, complex and character vectors are now allowed in model
frames (there was a previously undocumented restriction to
logical, integer and numeric types.). Character vectors in a
formula passed to model.matrix() are converted to factors and
coded accordingly.
o modifyList() utility, typically for housekeeping nested lists.
o x <- 1:20; y <- rnorm(x); nls(y ~ A*exp(-x^2/sig)) no longer
returns an unhelpful error message. In this and similar cases, it
now tries a wild guess for starting values.
o Ops.difftime() now handles unary minus and plus.
o Ops.Date() and Ops.POSIXt() now allow character arguments
(which are coerced to the appropriate class before comparison,
for Ops.POSIXt() using the current time zone).
o There is a new option(max.contour.segments = 25000) which can be
raised to allow extremely complex contour lines in contour()
and contourLines(). (PR#9205)
o options(max.print = N) where N defaults to 99999 now cuts printing
of large objects after about N entries. print(x, ..., max = N)
does the same for the default method and those building on
print.default().
options("menu.graphics") controls if graphical menus should be
used when available.
options("par.ask.default") allows the default for par("ask")
to be set for a newly-opened device. (Defaults to FALSE, the
previous behaviour.)
The way option("papersize") is set has been changed. On
platforms which support the LC_PAPER locale category, the
setting is taken first from the R_PAPERSIZE environment
variable at run time, then from the LC_PAPER category
("letter" for _US and _CA locales and "a4" otherwise). On
other platforms (including Windows and older Unixen), the
choice is unchanged.
o package.skeleton() gains arguments 'namespace' and
'code_files'.
o par(ask=TRUE) now only applies to interactive R sessions.
o parse() now returns up to 'n' expressions, rather than fill
the expressions vector with NULL. (This is now compatible
with S.)
o The 'version' argument for pdf() is now increased
automatically (with a warning) if features which need a higher
level are used.
o pie() now allows expressions for 'labels', and empty slices.
o There is a new '%.%' operator for mathematical annotations
(plotmath) which draws a centred multiplication dot
(a \cdot in LaTeX), thanks to Uwe Ligges.
o predict.lm() gains a 'pred.var' argument. (Wishlist PR#8877.)
o print.summary.{aov,glm,lm,nls} and print.{aov,glm} make use of
naprint() to report when na.action altered the model frame.
o print.table(T, zero.print=ch) now also replaces 0 by ch when T is
non-integer with integer entries.
o Recursive rapply() which is similar to lapply but used
recursively and can restrict the classes of elements to which
it is applied.
o r2dtable() has been moved to package 'stats'.
o New function read.DIF() to read Data Interchange Format files,
and (on Windows) this format from the clipboard.
o New experimental function readNEWS() to read R's own "NEWS" file
and similarly formatted ones.
o readLines() has a new argument 'warn' to suppress warnings:
the default behaviour is still to warn.
o reg.finalizer() has a new argument 'onexit' to parallel the
C-level equivalent R_RegisterFinalizerEx.
o rep() is now a primitive function and under some conditions
very much faster: rep.int() is still a little faster (but does
less). (Because it is primitive there are minor changes to the
call semantics: see the help page.)
o The 'row.names' of a data frame may be stored internally as an
integer or character vector. This can result in considerably
more compact storage (and more logical row names from rbind)
when the row.names are 1:nrow(x). However, such data frames
are not compatible with earlier versions of R: this can be
ensured by supplying a character vector as 'row.names'.
row.names() will always return a character vector, but direct
access to the attribute may not.
The internal storage of row.names = 1:n just records 'n', for
efficiency with very long vectors.
The "row.names" attribute must be a character or integer
vector, and this is now enforced by the C code.
o The "data.frame" and "matrix" methods for rowsum() gain an 'na.rm'
argument.
o Experimental support for memory-use profiling via Rprof(),
summaryRprof(), Rprofmem() and tracemem().
o save.image() [also called by sys.save.image() and hence from q()]
now defaults to saving compressed binary images. To revert to
the previous behaviour set option "save.image.defaults": see
?save.image.
o There is a new primitive seq.int() which is slightly more
restricted than seq() but often very much faster, and new
primitives seq_along() and seq_len() which are faster still.
o serialize(connection = NULL) now returns a raw vector (and not
a character string). unserialize() accepts both old and new
formats (and has since 2.3.0).
o setwd() now returns the previously current directory (invisibly).
o The function sort() is now sort.int(), with a new generic
function sort() which behaves in the same way (except for the
order of its argument list) for objects without a class, and
relies on the '[' method for objects with a class (unless a
specific method has been written, as it has for class "POSIXlt").
o sort.list() now implements complex vectors (PR#9039), and how
complex numbers are sorted is now documented.
o spline() and splinefun() now follow approx[fun] to have an argument
'ties = mean' which makes them applicable also when 'x' has
duplicated values.
o str(x) does not print the S3 "class" attribute when it is the
same as 'mode' (which is printed anyway, possibly abbreviated)
and it puts it beside mode for atomic objects such as S3 class
"table".
o str(<data.frame>) now outputs 'data.frame' instead of
`data.frame'; this may affect some strict (Package) tests.
o str() now takes also its defaults for 'vec.len' and 'digits.d'
from options('str') which can be set by the new strOptions().
o symnum() has a new argument 'numeric.x' particularly useful for
handling 0/1 data.
o Sys.getlocale() and Sys.setlocale() support LC_MESSAGES,
LC_PAPER and LC_MEASUREMENT if the platform does.
o Sweave has a new options 'pdf.encoding' and 'pdf.version' for
its Rweave driver.
o The character vector used by an output textConnection() has
a locked binding whilst the connection is open.
There is a new function textConnectionValue() to retrieve the
value of an output textConnection().
o traceback() gains a 'max.lines' argument.
.Traceback is no longer stored in the workspace.
o warning(immediate. = TRUE) now applies to
getOption("warn") < 0 and not just == 0.
o warnings() is now an accessor function for 'last.warning' (which
is no longer stored in the workspace) with a print() method.
o The internal internet download functions have some new
features from libxml 2.6.26.
o There is an option "HTTPUserAgent" to set the User Agent in R
download requests etc. Patch from S. Falcon.
o PCRE has been updated to version 6.7.
o The C function substituteList now has tail recursion expanded
out, so C stack overflow is less likely. (PR#8141, fix by
Kevin Hendricks)
o The (somewhat soft) 1023/4 byte limit on command lines is now
documented in 'An Introduction to R'.
o The maximum number of open connections has been increased from
50 to 128.
o There is a new manual 'R Internals' on R internal stuctures
plus the former appendices of 'Writing R Extensions'.
o The autoloads introduced at the package re-organization have been
almost completely removed: the one that remains is for ts().
o The setting of the various Java configuration variables has been
improved to refer to JAVA_HOME, and they are now documented in
the R-admin manual.
o It is (again) possible to calculate prediction intervals from
"lm" objects for the original data frame, now with a warning
that the intervals refer to future observations. Weighted
intervals have also been implemented, with user-specifiable
weights. Warnings are given in cases where the default
behaviour might differ from user expectations. See the
?predict.lm for details.
CHANGES TO S4 METHODS
o The default prototype object for S4 classes will have its own
internal type in 2.4.0, as opposed to being an empty list (the
cause of several errors in the code up to 2.3.1). Note that old
binary objects, including class definitions, will be
inconsistent with the type, and should be recreated.
o S4 method dispatch has been completely revised to use cached
generic functions and to search for the best match among
inherited methods. See ?Methods and
http://developer.r-project.org/howMethodsWork.pdf
o Objects created from an S4 class are now marked by an internal flag,
tested by isS4() in R and by macro IS_S4_OBJECT() in C. This
is an efficient and reliable test, and should replace all
earlier heuristic tests.
o Some changes have been made to automatic printing of S4
objects, to make this correspond to a call to show(), as per
'Programming with Data'.
o S4 generic and class definitions are now cached when the related
package is loaded. This should improve efficiency and also
avoid anomalous situations in which a class or generic cannot
be found.
o trace() now creates a new S4 class for the traced object if
required. This allows tracing of user-defined subclasses of
"function".
DEPRECATED & DEFUNCT
o The re-named tcltk functions tkcmd, tkfile.tail, tkfile.dir,
tkopen, tkclose, tkputs, tkread are now defunct.
o Argument 'col' of bxp() has been removed: use 'boxfill'.
o Use of NULL as an environment is now an error.
o postscriptFont() is defunct: use Type1Font().
o La.chol() and La.chol2inv() are defunct (they were the same as
the default options of chol() and chol2inv).
o La.svd(method = "dgesvd") is defunct.
o Files install.R and R_PROFILE.R in packages are now ignored
(with a warning).
o The following deprecated command-line options to INSTALL have
been removed (use the fields in the DESCRIPTION file instead):
-s --save --no-save --lazy --no-lazy --lazy-data --no-lazy-data
o Graphical parameter 'tmag' is obsolete.
o mauchley.test() (package 'stats') is now defunct.
o symbol.C() and symbol.For() are deprecated. They are required in
S for use with is.loaded(), but are not so required in R.
o load()ing an object saved in one of the formats used prior to
R 1.4.0 is deprecated. Such objects should be re-saved in the
current format.
o save(version = 1) is now deprecated.
C-LEVEL FACILITIES
o The convenience function ScalarLogical now coerces all
non-zero non-NA values to TRUE.
o The vector accessor functions such as INTEGER, REAL and
SET_VECTOR_ELT now check that they are called on the
correct SEXPTYPE (or at least on a compatible one). See
`Writing R Extensions' for the details and for a stricter
test regime.
o It is no longer possible to pass list variables to
.C(DUP = FALSE): it would have given rise to obscure garbage
collection errors.
o allocString is now a macro, so packages using it will need to
be reinstalled.
o R_ParseVector was returning with object(s) protected in the
parser if the status was PARSE_INCOMPLETE or PARSE_ERROR.
o There is a new function Rf_endEmbeddedR to properly terminate
a session started by Rf_initEmbeddedR, and both are now
available on Windows as well as on Unix-alikes. These and
related functions are declared in a new header <Rembedded.h>.
If R_TempDir is set when embedded R is initialized it is
assumed to point to a valid session temporary directory: see
`Writing R Extensions'.
o There is a new interface allowing one package to make C routines
available to C code in other packages. The interface consists
of the routines R_RegisterCCallable and R_GetCCallable. These
functions are declared in <R_ext/Rdynload.h>. This interface
is experimental and subject to change.
In addition, a package can arrange to make use of header
files in another (already installed) package via the
'LinkingTo' field in the DESCRIPTION file: see 'Writing R
Extensions'.
UTILITIES
o R CMD SHLIB now handles (as linker commands) -L*, -l* and *.a.
o R CMD check now:
- warns if there are non-ASCII characters in the R code (as
these will likely be syntax errors in some locale).
- tests Rd cross-references by default, and tests for
(syntactically) valid CITATION metadata.
- tests that the package can be loaded, and that the package
and name space (if there is one) can each be loaded in
startup code (before the standard packages are loaded).
- tests for empty 'exec' or 'inst' directories.
- checks if $(FLIBS) is used when $(BLAS_LIBS) is.
- checks that all packages (except non-S4-using standard
packages) used in ::, :::, library() and require() calls are
declared in the DESCRIPTION file, and 'methods' is declared if
S4 classes or methods are set.
- throws an error if the standard packages 'methods' and
'stats4' are imported from in the NAMESPACE file and not
declared in the DESCRIPTION file.
o The test script produced by massage-Examples.pl no longer
creates objects in the base environment.
o New utilties R CMD Stangle and R CMD Sweave for extracting S/R
code from and processing Sweave documentation, respectively.
o The DESCRIPTION file of packages may contain an 'Enhances:'
field.
o An R CMD javareconf script has been added to allow Java
configuration to be updated even after R has been installed.
INSTALLATION
o The C function realpath (used by normalizePath()) is hidden on
some systems and we try harder to find it.
o There is a new option --enable-BLAS-shlib, which compiles the
BLAS into a dynamic library -lRblas and links against that.
For the pros and cons see the R-admin manual.
The defaults are now --without-blas (so you have explicitly to
ask for an external BLAS), and --enable-BLAS-shlib unless
a usable external BLAS is found or on AIX or on MacOS X 10.2
and earlier.
o MacOS X did not like having LSAME in both BLAS and LAPACK
libraries, so it is no longer part of the R-internal LAPACK.
We now require an external BLAS to provide LSAME: it seems
that nowadays all do.
o The configure test for 'whether mixed C/Fortran code can be
run' has been improved as on one system that test passed but
the Fortran run-time library was broken.
o A precious configure variable DEFS can be set to pass defines
(e.g. -DUSE_TYPE_CHECKING_STRICT) to C code when compiling R.
o There is now a test for visible __libc_stack_end on Linux
systems (since it is not visible on some recent glibc's
built from the sources).
o MacOS X 10.4 and higher now use two-level namespaces, single
module in a shared library and allow undefined symbols to be
resolved at run-time. This implies that common symbols are now
allowed in package libraries. --enable-BLAS-shlib is supported
for internal BLAS, external BLAS framework and external static
BLAS. An external dynamic library BLAS is NOT supported. (But
it can be easily used by replacing internal BLAS library file
later.) MacOS X < 10.4 does not support --enable-BLAS-shlib.
o Dynamic libraries and modules use a flat namespace on MacOS X
10.4 and higher if either Xcode tools don't support dynamic
lookup (Xcode < 2.3) or the FORCE_FLAT_NAMESPACE environment
variable is set. (The latter was introduced temporarily for
testing purposes and may go away anytime.)
o configure now defaults to 'run-time linking' on AIX
(and AIX < 4.2 is no longer allowed), using -bexpall rather
than export/import files. If this works, it allows R to be
built in the same way as other Unix-alikes, including with R
as a shared library and with a shared BLAS.
o The "mac.binary" package type now defaults to universal
binary. If a repository supports architecture-specific Mac
binaries, they can be requested by using "mac.binary.xxx" in
contrib.url(), where xxx is the desired architecture.
o There is a new configure option --enable-memory-profiling to
enable memory profiling with tracemem, Rprof, Rprofmem.
BUG FIXES
o The name of a Fortran symbol reported to be missing by
.Fortran() is now the actual name. (What was reported to be
an 'entry point' was missing the common leading underscore.)
o print() on a MBCS character string now works properly a
character at a time rather than a byte at time. (This does
not affect MBCSs like UTF-8 and the Windows DBCSes which have
non-ASCII lead bytes and always worked correctly.)
o glm() now recalculates the null deviance whenever there is an
offset (even if it is exactly zero to avoid a discontinuity in
that case, since the calculations with and without offset are
done by different algorithms).
o Amongst families, quasi() accepted an expression for link and
no other did. Now all accept an expression which evaluates to
a one-element character vector (although e.g. 'logit' is taken
as a name and not an expression).
o trace() now accepts arguments where= and signature= for the
old-style trace (no tracer or exit, edit==FALSE) and just
prints a message on entry. Also the undocumented feature of
where=function now works for generic functions as well.
o callNextMethod() failed for recursive use when the methods had
nonstandard argument lists. Now enforces the semantic rule
that the inheritance is fixed when the method containing the
callNextMethod() is installed. See Details in the documentation.
o UseMethod() looked for the defining environment of 'generic' as
if it were the current function, although some functions are
generic for methods of a different generic.
Lookup for S3 methods is confined to functions: previously a
non-function 'fun.class' could have masked a function of the
same name.
o Line types (lty) specified as hex strings were documented not to
allow zero, but some devices accepted zero and handled it in a
device-dependent way. Now it is an error on all devices.
(PR#8914)
o Subassignment for a time series can no longer extend the series:
it used to attempt to but failed to adjust the tsp attributes.
Now window() must be used.
o Function AIC() in package 'stats4' was not dispatching correctly
on S4 classes via logLik() because of name space issues.
o Subsetting LANGSXPs could break the call-by-value illusion.
(PR#7924) (patch from Kevin Hendricks).
o parse() with n > 1 gave a syntax error if fewer than n statements
were available.
o parse() with n > 1 gave strange results on some syntax errors.
(PR#8815)
o lag.plot() now respects graphical parameters for the axes.
o Using a wrong link in family() now gives more consistent error
messages.
o sort.list(method="radix") works on factors again.
o object.size() is more accurate for vector objects (it takes into
account the smaller header and also the fixed sizes used in
the node classes for small vector objects).
o addmargins(T, ...) now returns a "table" when 'T' is a "table", as
its help page has always suggested.
o remove() now explicitly precludes removing variables from
baseenv() and throws an error (this was previously ignored).
o Saving the workspace at the end of a session now works as has
long been intended, that is it is saved only if something has
been added/deleted/changed during the current session.
o The search for bindings in <<-, ->> and assign(inherits=TRUE)
was omitting the base package, although this was not
documented. Now the base package is included (but most
bindings there are locked).
o dweibull(0, shape) was NaN not Inf for shape < 1. Also, the
help for dgamma and dweibull gave support as x > 0, but
returned non-zero values for x = 0. (PR#9080)
o Subsetting arrays no longer preserves attributes (it was
removed for matrices in 1998).
o The "factor" method of as.character() no longer maps level
"NA" to "<NA>" (a legacy of before there were NA character
strings).
o terms(keep.order=TRUE) was not returning a valid "order"
attribute.
o The DLL registration code was not freeing .External symbols.
o The internet download routines expected URLs of less than 4096
bytes, but did not check. Now this is checked, and http:// URLs
are allowed to be up to 40960 bytes.
o parse(n=-1) threw a stack-imbalance error, and parse(n=3) did
not cope correctly with EOF during input.
o Zero-column data frames had no names (rather than character(0)).
o by() and acf() could get confused when they used very long
expressions as names.
o residuals(<glm object>, type="working") was NA for cases with
zero weight (whereas they are well-defined even though the
case was not used during the fitting) and the actual value is
now returned. This allows residuals to be computed from fits
with 'y = FALSE'.
The residuals in a fitted "glm" object are computed more
accurately: the previous formula was subject to cancellation.
o loess() now checks the validity of its 'control' argument.
o rownames(<0-row matrix>, do.NULL=FALSE) was wrong. (PR#9136)
o apply() now works as documented when applied over 2 or more
margins with one of zero extent. (It used to drop dimensions.)
o head() and tail() now also work row-wise for "table" and "ftable"
objects.
o NextMethod() could throw an error/crash if called from a method
that was called directly rather than from a generic (so
.Method was unset).
o order(x, na.last = NA) failed for a zero-length x.
o grep(pat, x, value = TRUE, perl = L) preserved names for
L == TRUE && !is.na(pat) but not otherwise. Now it always does.
o [rc]bind() now find registered methods and not just visible ones.
o Printing a factor no longer ignores attributes such as names and
dim/dimnames.
o Command-line arguments after --encoding were ignored.
o The check for impossible confidence levels was off by one in
wilcox.test (PR#8557)
o [[ on an environment could create aliases. (PR#8457)
o pt() with a very small (or zero) non-centrality parameter could
give an unduly stringent warning about 'full precision was not
achieved'. (PR#9171)
o writeChar() could segfault if 'nchars' was given silly values.
o qt() and rt() did not work for vector 'ncp', and qt() did not
work for negative 'ncp'.
o ns() failed to work correctly when 'x' was of length one.
o identical() ignored tags on pairlists (including names of
attributes) and required an identical ordering for
attribute values in their pairlists. Now names are compared
on pairlists, and attribute sets are treated as unordered.
o If they were unused arguments supplied to a closure, only
the first non-empty one was reported, despite the message.
Unmatched empty arguments (such as f(1,,) for a function of
one argument) were ignored. They are now an error.
o Calling a builtin with empty arguments used to silently remove
them (and this was undocumented). Now this is an error unless
builtin is c() or list() or there are only trailing empty
arguments, when it is a warning (for the time being: this will
be made an error in R 2.5.0).
o install.packages() ignored 'configure.args' if the vector was
unnamed.
o biplot() now works if there are missing values in the data.
o biplot() now passes par() values to all four axes (not
just those on sides 1 and 2).
o [.acf now handles an empty first index.
o Deparsing uses backticks more consistently to quote
non-syntactic names.
o Assigning to the symbol in a for() loop with a
list/expression/pairlist index could alter the index. Now the
loop variable is explicitly read-only. (PR#9216)
o Using old.packages() (and hence update.packages()) on an empty
(or non-existent) library failed with an obscure message.
o plot.xy() could segfault if supplied with an invalid 'col'
argument. (PR#9221)
o menu() with graphics=TRUE attempted to use Tcl/Tk on unix even
if DISPLAY was not set (in which case Tk is not available and
so the attempt is bound to fail).
o The print() method for 'dist' objects prints a matrix even for
n = 2.
o The cumxxx functions were missing some PROTECTs and so could
segfault on long vectors (especially with names or where
coercion to numeric occurred).
o The X11() device no longer produces (apparently spurious)
'BadWindow (invalid Window parameter)' warnings when run from
Rcmdr.
o legend() assumed that widths and heights of strings were positive,
which they need not be in user coordinates with reversed axes.
(In part, PR#9236)
o The plot() methods for "profile.nls" objects could get
confused if 'which' had been used in the profile() call. (PR#9231)
o boxplot() did not passed named arguments (except graphics
parameters) to bxp() as documented. (PR#9183)
o Only genuinely empty statements act as 'return' in the
browser, not say those starting with a comment char. (PR#9063)
o summary.mlm() incorrectly used accessor functions to fake an
"lm" object. (PR#9191)
o prettyNum() was not preserving attributes, despite being
explicitly documented to. (PR#8695)
o It was previously undocumented what happened if a graphical
parameter was passed in both '...' and 'pars' to boxplot()
and bxp(), and they behaved differently. Now those passed in
'...' have precedence in both cases.
o A failed subassignment could leave behind an object '*tmp*'.
The fix also sometimes gives better error messages.
o Using SIGUSR1 on Unix now always terminates a session, and no
longer is caught by browser contexts and restarts (such as try()).
o In the 'graphics' package, in-line 'font=5' was being ignored
(report by Tom Cook).
o nls() looked for non-parameter arguments in a function call in
the wrong scope (from the body of nls).
o Printing of complex numbers could misbehave when one of the
parts was large (so scientific notation was used) and the
other was so much smaller that it had no significant digits
and should have been printed as zero (e.g. 1e80+3e44i).
o Using install.packages with type="mac.binary" and target path
starting with ~ failed with a cryptic message while unpacking.
o getwd() now works correctly when the working directory is
unavailable (e.g. unreadable).
o The alternative hypothesis in wilcox.test() was labelled by an
unexplained quantity 'mu' which is now spelled out.
The alternative hypothesis in ks.test() is clearer both in the
documentation and in the result. (PR#5360)
**************************************************
* *
* 2.3 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.3.1 patched
BUG FIXES
o help.search() incorrectly documented where the data base was
saved and what was in it.
o str(<data.frame>, strict.width=.) produced an extraneous first line.
o Improve bessel[IJKY]() out-of-range checks; for instance,
besselI(0, nu) no longer warns.
o cbind() on some non-vector objects (e.g. names) segfaulted.
o xy.coords(numeric(0)) gave a misleading error message.
o INSTALL has been changed to avoid a few problems with the
base (not XPG4) Solaris sed.
o There were problems in src/main/printutils.c on some platforms
that did not have va_copy.
o [pq]unif allowed infinite ranges but handled them
inconsistently. (PR#8958)
[pq]unif claimed to allow min == max but did not do so.
o Subassignment within raw arrays of 3 or more dimensions was not
implemented.
o environment<-() did not even check if duplication was required.
o rt() was wrong for non-central t-distributions. qt() was wrong
for non-central distributions far enough in the left tail
(reported by Long Qu). (PR#9050)
o R CMD Rdconv --type=Ssgm no longer drops a \keyword{} if it is the
only one (one letter typo patch by Bill Dunlap). (PR#9051)
o poly(x, y, .., raw = TRUE) now does follow 'raw'.
o plot(0/ -1:1, type = "s") now works. (PR#9046)
o write.table(row.names=FALSE) does now quote column names. (PR#9044)
o rf() was wrong for non-central F (PR#9055). qf() was wrong for
non-central F with denominator df > 1e8.
o The C function dummy_vfprint had a potential memory leak. This
showed up with some connections when used with output of more
than 100,000 bytes in a single call.
o vignette() did not work if more than one vignette with the
same name was installed (PR#9069).
o mget() did not check that 'ifnotfound' was a list, and worked
incorrectly if it was a list of length > 1. Now 'ifnotfound'
is (if possible) coerced to a list.
o The internal check for conformance of time series assumed that the
'tsp' attribute was integer, whereas it was enforced to be
numeric by the attribute-setting code.
o Sweave() did not treat \begin{document} in comments correctly
(PR#9073).
o diff(x) gave wrong result when x was "POSIXlt" object.
o title() could crash R when passed a long non-character vector.
(PR#9115)
o Functions rgb(), hsv() and hcl() lost names unless 'alpha' was
specified. (In part, PR#9118)
o The residuals() method for "glm" failed unless 'y = TRUE' for
the fit: it now works for "working" and "partial" residuals
and gives a useful error message for other types. (PR#9124)
o R CMD Rdconv did not close the .Rd file, which matters on Windows.
(PR#9126)
o anova.mlm() could fail if applied to a single model.
o stopifnot(<FALSE-expr>) now gives a better message for a *long*
expression.
CHANGES IN R VERSION 2.3.1
NEW FEATURES
o In lm() and glm(), offsets are allowed to be length 1 (and
if so are replicated to the number of cases).
o The \uxxxx notation for Unicode characters in input strings
can now be used on any platform which supports MBCS, even if
the current locale is not MBCS (provided that the Unicode
character is valid in the current character set).
o The quasibinomial() family now allows the "cauchit" link. (PR#8851)
o edit.data.frame() no longer (silently) coerces character columns
to factor.
C-LEVEL FACILITIES
o The variables controlling stack checking are made available via
Rinterface.h to front-ends embedding R: see 'Writing R Extensions'
o R_SignalHandlers (defined in Rinterface.h) can be set to 0 to
suppress the R signal handlers in front-ends embedding R.
INSTALLATION CHANGES
o There have been a number of changes to help installation on
platforms that no one had beta-tested.
- Changes related to older header files, e.g. on Redhat 8.0/9.
- Problems with 'make install' on older (<3) versions of bash
on Solaris and elsewhere.
- AIX 5.2/gcc issues with needing -lm when making modules X11
and vfonts.
- Some versions of Solaris and AIX had an fcntl.h that
redefined 'open' to be 'open64' and thereby broke
compilation of src/main/connections.c and elsewhere.
o 'make uninstall' works better on a build using a named
subarchitecture.
BUG FIXES
o min(), max(), sum() and prod() gave nonsensical answers with
an empty list or raw argument.
o sum() on a data frame did not allow multiple arguments. (PR#8385)
o charmatch() and pmatch() did not specify they applied only to
character vectors. Now they do, and attempt to coerce 'x' and
'target' to character before attempting matching.
o The Summary() methods for data.frame, Date, POSIXct, POSIXlt
and difftime all required an argument which can match 'x',
although the generics did not.
o regexpr() now accepts 0-length 'text' inputs.
o help.search() no longer errors out on a wrongly installed package
(with no "hsearch.rds" file).
o The LaTeX version of the package reference manual was omitting
some topics, and was not sorting the foo-package topic first.
o Serializing (e.g. via save()) is better protected against C
stack overflow, which will now abort the conversion but no
longer crashes the R process on some platforms.
o rbind()ing dataframes with a single row could lead to a
corrupt data frame (a problem with the fix to PR#8506).
o plot(lm(y ~ 1)) now works also for 'which = 5'.
o dbeta(0, 1, a, 0) now correctly gives 'a' (limit) instead of 0,
and dbeta(0, a, b, ncp) now returns Inf instead of NaN.
o demo(Hershey) was failing on the Cyrillic octal codes in locales
(e.g. UTF-8) in which these are invalid.
o mean() on an integer (or logical) vector was treating NAs as
actual values (unless na.rm = TRUE).
o mean() on a complex vector was calculated incorrectly in
code to improve precision (PR#8842, John Peters).
o Graphical parameters bg, cex, col, lty, and lwd were being
checked as being of length one even by functions such as
title() that ignored them. (Functions such as lines() and
points() allow them to be of length > 1, so they might be
passed through ... to other high-level graphical functions
which then used to reject them.)
o str() now is fast again for large character vectors.
o edit() would default the environment of a function to .BaseEnv,
instead of to .GlobalEnv.
o lm() and glm() coerce their 'weights' and 'offset' values to
vector to avoid problems with specifying them as 1D or n x 1
arrays.
o image() with one or both axes on log scales would give a
spurious warning; contour() would give an error.
o legend() with log axes would place the title in the wrong place.
o edit.data.frame() was not returning factors edited with
factor.mode="numeric" to factors.
o edit.matrix() tried to set rownames and colnames from the
original matrix even if the sizes had been altered, and
ignored changes made to the column names. 'edit.row.names' has
a more sensible default (if the rownames are non-NULL).
o bindingIsLocked() was returning invalid values of a logical
vector on some platforms.
o merge.data.frame() did not make the column names unique (by
appending elements of 'suffixes') when performing a Cartesian
product. (PR#8676)
o rbind.data.frame() matches up the names of columns (which was
undocumented), but failed to do so when checking if it was
dealing with a factor column. (PR#8868)
If rbind() was used on data frames with duplicated names it
produced a corrupt data frame.
o dt(x, df, ncp= not.0) no longer gives erratic values for
|x| < ~1e-12. (PR#8874)
o \code{\linkS4class{.}} now works.
o ccf() aligns time series by ts.intersect() rather than
ts.union() and so is less likely to need a non-default
na.action. (PR#8893)
o optim(method="CG") could return a value that did not
correspond to $par for very badly behaved functions on which
the second phase of the line search failed. (PR#8786)
o print.ts() could fail on a corrupt time series: it now warns and
does the best it can.
CHANGES IN R VERSION 2.3.0
USER-VISIBLE CHANGES
o In the grid package there are new 'arrow' arguments to
grid.line.to(), grid.lines(), and grid.segments()
(grid.arrows() has been deprecated).
The new 'arrow' arguments have been added BEFORE
the 'name', 'gp' and 'vp' arguments so existing code that
specifies any of these arguments *by position* (not by name)
will fail.
o all.equal() is more stringent, see the PR#8191 bug fix below.
o The data frame argument to transform() is no longer called 'x',
but '_data'. Since this is an invalid name, it is less likely
to clash with names given to transformed variables. (People
were getting into trouble with transform(data, x=y+z).)
NEW FEATURES
o arima.sim() has a new argument 'start.innov' for compatibility
with S-PLUS. (If not supplied, the output is unchanged from
previous versions in R.)
o arrows() has been changed to be more similar to segments():
for example col=NA omits the arrow rather than as previously
(undocumented) using par("col").
o as.list() now accepts symbols (as given by as.symbol() aka
as.name()).
o atan2() now allows one complex and one numeric argument.
o The 'masked' warnings given by attach() and library() now only
warn for functions masking functions or non-functions masking
non-functions.
o New function Axis(), a generic version of axis(), with Date and
POSIX[cl]t methods. This is used by most of the standard
plotting functions (boxplot, contour, coplot, filled.contour,
pairs, plot.default, rug, stripchart) which will thus label x
or y axes appropriately.
o pbeta() now uses TOMS708 in all cases and so is more accurate
in some (e.g. when lower.tail = FALSE and when one of the
shape parameters is very small).
o [qr]beta(), [qr]f() and [qr]t() now have a non-centrality parameter.
o [rc]bind and some more cases of subassignment are implemented
for raw matrices. (PR#8529 and PR#8530)
o The number of lines of deparsed calls printed by browser() and
traceback() can be limited by the option "deparse.max.lines".
(Wish of PR#8638.)
o New canCoerce() utility function in "methods" package.
o [pq]chisq() are considerably more accurate for moderate (up to
80) values of ncp, and lower.tail = FALSE is fully supported
in that region. (They are somewhat slower than before.)
o chol(pivot = TRUE) now gives a warning if used on a (numerically)
non-positive-definite matrix.
o chooseCRANmirror() consults the CRAN master (if accessible) to
find an up-to-date list of mirrors.
o cov.wt() is more efficient for 'cor = TRUE' and has a new 'method'
argument which allows 'Maximum Likelihood'.
o do.call() gains an 'envir' argument.
o eigen() applied to an asymmetric real matrix now uses a
tolerance to decide if the result is complex (rather than
expecting the imaginary parts of the eigenvalues to be exactly
zero).
o New function embedFonts() for embedding fonts in PDF or
PostScript graphics files.
o fisher.test() now uses p-values computed via hypergeometric
distributions for all 2 by 2 tables. This might be slightly
slower for a few cases, but works much better for tables with
some large counts.
There is a new option to simulate the p-value for larger than
2 x 2 tables.
o for() now supports raw vectors as the set of indices.
o getNativeSymbolInfo() is vectorized for the 'name' argument. It
returns a named list of NativeSymbolInfo objects, but is
backward compatible by default when called with a character
vector of length 1, returning the NativeSymbolInfo object.
o help.search() no longer attempts to handle packages installed
prior to R 2.0.0, and reports the current path to the
package (rather than where it was originally installed: this
information is not shown by the print() method).
o Added "hexmode" to parallel "octmode".
o install.packages() now does tilde expansion on file paths
supplied as 'pkgs'.
o install.packages() has additional arguments 'configure.args' and
'clean' which allow the caller to provide additional arguments
to the underlying R CMD INSTALL shell command when installing
source packages on a Unix-alike.
o is.loaded() has a new argument 'type' to confine the search to
symbols for .C, .Fortran, .Call or .External: by default it
looks for a symbol which will match any of them. It is now
internal and not primitive, so argument matching works in the
usual way.
o The symmetry test for matrices used in eigen() has been ``exported''
as the 'matrix' method of a new S3-generic 'isSymmetric().
o .leap.seconds and the internal adjustment code now know about
the 23rd leap second on 2005-12-31: the internal code uses a
run-time test to see if the OS does.
o The 'col' argument of legend() now defaults to par("col")
(which defaults to "black", the previous default), so that
the lines/symbols are shown in the legend in the colour that
is used on the plot.
o log2() and log10() call C functions of the same name if
available, and will then be more likely to be precise to
machine accuracy.
o new.packages() gains a ... argument to pass e.g. 'destdir' to
install.packages(). (Wish of PR#8239.)
o nls() now supports 'weights'.
o The vector passed as the first argument of the 'fn' and 'gr'
arguments of optim() has the names (if any) given to argument
'par'.
o options(expressions) is temporarily increased by 500 during
error-handling. This enables e.g. traceback() to work when
the error is reaching the limit on the nesting of expressions.
o page() accepts general R objects, not just names (and
previously undocumented) character strings. This allows the
object to be specified as a call, for example. More options
are allowed in its '...' argument.
o pairs() allows a wider class of inputs, including data frames
with date and date-time columns.
o par() and the in-line use of graphical parameters produce more
informative error messages, distinguishing between
non-existent pars and inappropriate use of valid pars.
Graphical parameters 'family', 'lend', 'ljoin' and 'lmitre'
can now be set in-line.
There is no longer a warning if non-settable pars are used
in-line, but there is an appropriate warning if unknown pars
are passed.
The length limit for the 'family' parameter has been increased
to 200 bytes, to allow for the names of some CID-keyed fonts
in multi-byte locales.
o The pdf() device now allows 'family' to be specified in the same
generality as postscript().
o The pdf() device writes /FontDescriptor entries for all fonts
except the base 14, and does not write font entries for unused
fonts.
o Plotmath allows 'vartheta', 'varphi' and 'varsigma' (or 'stigma')
as synonyms for 'theta1', 'phi1' and 'sigma1', and the help
page has a note for TeX users.
o plot.xy() now takes its default arguments from the
corresponding par() settings, so points(type="l") and
lines(type="p") behave in the same way (and more obviously,
also for type="b").
o poly() has a new argument 'raw', mainly for pedagogical purposes.
o The class "POSIXlt" now supports fractional seconds (as
"POSIXct" has always done). The printing of fractional seconds
is controlled by the new option "digits.secs", and by default is off.
o postscript() supports family = "ComputerModernItalic" for
Computer Modern with italic (rather than slanted) faces.
o The postscript()/pdf() font metrics for the 14 standard fonts
(only, not the rest of the common 35) have been updated to
versions from late 1999 which cover more glyphs. There are
also a few differences in the metrics and hence the output
might be slightly different in some cases.
o The way families can be specified for postscript() and pdf()
has been expanded to include CID-keyed fonts, with new
functions Type1Font() and CIDFont() to set up such fonts
families.
o prettyNum() has new arguments 'preserve.width' and 'zero.print'.
When the former is not "none", as in calls from format() and
formatC(), the resulting strings are kept at the desired width
when possible even after adding of 'big.mark' or 'small.mark'.
o proc.time() and system.time() now record times to 1ms accuracy
where available (most Unix-like systems).
o The initialization methods for the quasi() family have been
changed to depend on the variance function, and in particular
to work better for the "mu(1-mu)" variance function. (PR#8486)
o read.table() gains a 'flush' argument passed to scan().
o require() now takes a 'lib.loc' argument.
o The second argument 'size' to sample() is required to have
length 1, so that errors when supplying arguments are more
easily detected.
o The default is now compress = !ascii in save() (but not save.image).
o scan() and write.table() now have some interruptibility, which
may be useful when processing very large files.
o A new heuristic test, seemsS4Object() is supplied, along with a
similar C-level test, R_seemsS4Object(object). The test
detects probable S4 objects by their class's attribute. See
the help page.
o S3 classes can now be made non-virtual S4 classes by supplying a
prototype object in the arguments to setOldClass().
o splinefun() returns a function that now also has a 'deriv' argument
and can provide up to the 3rd derivative of the interpolating
spline, thanks to Berwin Turlach.
o stopifnot(A) now gives a better error message when A has NAs, and
uses "not all TRUE" when A has length >= 2.
o str()'s default method has a new argument 'strict.width' which can
be used to produce strict 'width' conforming output. A new
options(str = list(strict.width = *)) setting allows to control
this for a whole session.
o summary.nls() has a new argument 'correlation' that defaults
to FALSE (like summary.lm).
o Sys.sleep() has sub-millisecond resolution on Unix-alikes
with gettimeofday().
o Sys.time() now has sub-millisecond accuracy on systems
supporting the POSIX call gettimeofday, and clock-tick
accuracy on Windows.
o The new function timestamp() adds a time stamp to the saved
command history on consoles which support it.
o New function tcrossprod() for efficiently computing x %*% t(x)
and x %*% t(y).
o The suffix used by tempfile() is now in hex on all platforms
and guaranteed to be at least 6 hex digits (usually 8).
o trace() now works more consistently and more like its
documentation, in particular the assertions about old tracing
being removed for new. For debugging purposes (of R) a
mechanism for debugging the trace computations themselves was
added. See trace.R.
o The implementation of trace() has beem made more general by
calling a function to do the trace interaction, and recover()
now detects trace calls to trim the irrelevant code underneath.
o unserialize() can now also read a byte stream from a raw vector.
o The useDynLib() directive in the NAMESPACE file now accepts the
names of the native/foreign symbols that are to be resolved in
the DLL for use in .C/.Call/.Fortran/.External calls. These
can be used as regular R variables instead of the (routine
name, PACKAGE) pairs currently recommended. Alternative names
can be given for the R variables mapping to these symbols.
The native routine registration information can also be used
directly via useDynLib(name, .registration = TRUE). See the
'Writing R Extensions' manual for more details.
checkFF() (package 'tools') has been updated accordingly.
o validObject() has an option complete=TRUE that recursively
checks the objects in the slots. Not used when new(...)
checks validity.
o New Vectorize() function, a wrapper for mapply().
o write.ftable() has gained an argument 'append = FALSE' (thanks to
Stephen Weigand).
o On Unix-alikes, X11() now has arguments to request the initial
position of the window, and 'gamma' defaults to the value of
getOptions("gamma"). These changes are consistent with the
windows() device.
o X11() and the Unix-alike data entry window can have properties
(including geometry) set by X resources: see their help files.
o xy.coords() & xyz.coords() now have NULL defaults for their 'y' or
'y' and 'z' arguments. This is more consistent with their earlier
documentation, and may be convenient for using them.
o Non-syntactic names of list elements are now printed quoted by
backticks rather than double quotes.
o There is some basic checking for imminent C stack overflow (when
the evaluation depth and the user interrupts are checked).
On systems with suitable OS support (not Windows), segfaults
from C stack overflow are caught and treated as an R error.
New function Cstack_info() reports on stack size and usage.
options(expressions) reverts to the default of 5000 now
stack checking is in place.
o Package tcltk does not try to initialize Tk on Unix-alikes
unless a DISPLAY variable is present. This allows packages
dependent on tcltk to be installed without access to an X server.
o The code used to guess timezone offsets where not supplied by
the OS uses a different algorithm that is more likely to guess
the summer-time transitions correctly.
o Package tools contains translation tables 'Adobe_glyphs' and
'charset_to_Unicode'.
o Changed the environment tree to be rooted in an empty
environment, available as emptyenv(). baseenv() has been
modified to return an environment with emptyenv() as parent,
rather than NULL.
o gettext has been updated to 0.14.5.
o PCRE has been updated to version 6.4.
o The method $.DLLInfo resolves the specified symbol in the DLL,
returning a NativeSymbolInfo object. Use [[ to access the actual
values in the DLLInfo object.
o On systems with either vasprintf or both va_copy and a vsnprintf
which reports the size of buffer required, connections such as
gzfile() and bzfile() can now write arbitrarily long lines,
not just 100000 chars.
o The R session temporary directory is now set in C code using
the same algorithm whether or not the shell front-end is used
and on all platforms. This looks at environment variables
TMPDIR, TMP and TEMP in turn, and checks if they point to a
writable directory.
o Some of the classical tests put unnecessary restrictions on the
LHS in the formula interface (e.g., t.test(x+y ~ g) was not
allowed).
o On suitably equipped Unix-alike systems, segfaults, illegal
operations and bus errors are caught and there is a simple
error-handler which gives the user some choice as to what to
do in interactive use.
On Windows access violations and illegal instructions are
caught with a simple error handler.
o Tracebacks now include calls such as .C/.Fortran/.Call, which
will help if errors occur in R code evaluated by compiled code
and in tracebacks presented by the segfault etc handlers.
o Treatment of signature objects and method definition objects has
been modified to give cleaner printing and more consistency in
the treatment of signatures. A sometimes useful utility,
methodSignatureMatrix(), is now exported.
o Printing the results of codoc() from package tools now helpfully
summarizes the found code/documentation mismatches.
o R refrains from printing a final EOL upon exiting the main loop
if the quiet flag is on and if the save action is known (e.g. this
is true for --slave).
DEPRECATED & DEFUNCT
o The deprecated and undocumented use of atan() with two arguments
has been removed: instead use atan2().
o write.table0() is defunct in favour of write.table().
o format.char() is defunct in favour of format.default().
o Support for the long-deprecated (and no longer documented)
arguments --min-vsize --min-nsize --max-vsize --max-nsize
--vsize --nsize of R CMD BATCH has been removed.
o The 'debian' subdirectory has been removed from the sources.
o The 'vfont' argument of axis() and mtext() has been removed:
use par(family=) instead.
o The unused graphical parameter "type" has been removed: it
invited confusion with the 'type' argument to default methods
of plot(), points() and lines().
o nlsMethod() and profiler() are no longer exported from the stats
name space (and nlsMethod.plinear() is no longer registered as
a method, as nlsMethod() was not generic).
o The re-named tcltk functions tkcmd, tkfile.tail, tkfile.dir,
tkopen, tkclose, tkputs, tkread are now formally deprecated.
o Argument 'col' of bxp() is now formally deprecated.
o Use of NULL as an environment is deprecated and gives a warning.
o postscriptFont() is deprecated in favour of Type1Font() (which
is just a change of name).
o La.chol() and La.chol2inv() are deprecated (they have since R
1.7.0 been the same as the default options of chol() and chol2inv).
o La.svd(method = "dgesvd") is deprecated.
o The use of install.R and R_PROFILE.R files in packages is
deprecated: use the DESCRIPTION file instead to arrange to
save an image or to load dependent packages.
The following command-line options to INSTALL are deprecated
(use the fields in the DESCRIPTION file instead):
-s --save --no-save --lazy --no-lazy --lazy-data --no-lazy-data
o Graphical parameter 'tmag' (which is long unused) is deprecated.
INTERNATIONALIZATION
A set of patches supplied by Ei-ji Nakama has been incorporated.
o New postscript encodings for CP1253, CP1257 and Greek (ISO 8859-7).
o Support for East Asian CID-keyed fonts in pdf() and postscript().
Although these usually contain Latin characters no accurate
AFMs are available and so CID-keyed fonts are intended only
for use with CJK characters.
o Wide-character width functions wc[s]width are provided that
overcome problems found with OS-supplied ones (and those
previously used by R on Windows). This means that
double-width CJK characters are now supported on all
platforms. It seems that the width of some characters (and
not just CJK characters) depends on which CJK locale's fonts
are in use and also on the OS.
Revised wide-character classification functions are
provided for use on Windows, AIX and MacOS X to replace
deficient OS-supplied ones.
o There is support for MBCS charsets in the pictex() graphics
device, and rotated (by 90 degrees) text may work better.
o The \u (and \U except on Windows) notation for characters which
is supported by the parser in all MBCS charsets is now always
interpreted as a Unicode point, even on platforms which do not
encode wchar_t in Unicode. These are now a syntax error in
single-byte locales.
o The default encoding for postscript() and pdf() is chosen to
be suitable for the current locale, if that is a single-byte
locale which is supported. This covers European (including
Greek) and Cyrillic languages.
In UTF-8 locales, a suitable single-byte encoding is chosen
for postscript() and pdf(), and text translated to it.
o xfig() gains an 'encoding' argument.
o There are some message translations into Spanish.
INSTALLATION CHANGES
o The encoding files for pdf()/postscript() have been moved to
directory 'enc' in package 'grDevices'.
o Support for MBCS is only enabled if iconv is found and it
supports enough conversions. (libiconv does.)
o In an MBCS locale, make check now translates the graphics
examples from Latin-1. This ensures that they will work
correctly in UTF-8: it is possible that in other MBCS locales
they will now fail (rather than work completely incorrectly).
o There is a new test, 'test-Docs', which as part of 'make
check-devel' tests the code in the documentation. Currently
it runs doc/manual/R-{exts,intro}.R and the compiled code in
R-exts.c.
o The workaround to allow an external LAPACK-containing BLAS
such as libsunperf to be used with the internal LAPACK has
been removed. If you have such a library you may now need
to use --with-lapack. It is no longer possible to use some
older versions of libsunperf, e.g. Forte 7 on 64-bit builds.
o A substitute for mkdtemp is provided, so it is now always
used for R_TempDir.
o Most of the functions checked for by 'configure' also have
declarations checked for in the appropriate header.
o The top-level documentation files AUTHORS COPYING.LIB COPYRIGHTS
FAQ RESOURCES THANKS have been moved to doc, and COPYING and NEWS
are installed there. The file Y2K has been removed from the
distribution.
o The extension .lo is no longer used in building R (only in
the optional build of libRmath.so): this allows a considerable
simplification of the Makefiles.
o Direct support for f2c has been removed: it can still be used
via a script which makes it look like a Fortran compiler.
(src/scripts/f77_f2c is an example of such a script.)
o There is a new flag SAFE_FFLAGS which is used for the
compilation of dlamc.f. It is set by configure for known
problem cases (recent g77 and gfortran), but can be overridden
by the user.
o The standard autoconf macros for large-file support are now used,
and these are enabled unless --disable-largefile is specified.
This replaces --enable-linux-lfs (and is now selected by default).
o Visibility attributes are used where supported (gcc4/gfortran on
some platforms, also gcc3/g77 on FC3 and partially elsewhere).
The main benefit should be faster loading (and perhaps better
optimized code) in some of the dynamic shared objects (e.g.
libR.so and stats.so).
o The *PICFLAGS are taken to be -fpic rather than -fPIC where
possible. This will make no difference on most platforms:
-fPIC is needed on Sparc (and still used there), but -fpic
should give slightly better performance on PowerPC (although
-fPIC is used on PPC64 as it is needed to build libR.so there).
o More use is made of inlining for small utility functions such
as isReal. Because this can only be done portably with C99
constructs (and we know of no actual implementation), this is
only done for the GNU C compiler.
o There is an experimental feature to allow shared installations
of sub-architectures. See the R-admin manual.
o All platforms now use R's internal implementation of strptime,
which allows fractional seconds. (The major platforms were
already using it.)
o The dlcompat work-around for old Mac OS X systems (<= 10.2)
has been removed. External dlcompat must be installed if needed.
UTILITIES
o R CMD check now uses an install log by default.
o R CMD check works for packages whose package name is different
from the directory name in which it is located.
o R CMD INSTALL now uses more randomness in the temporary
directory name even on systems without mktemp -d.
o R CMD f77 has been removed now f2c is no longer supported.
o The version string shown in the startup message and by
"R --version", and that stored in variable R.version.string
are now in exactly the same format.
o The base name of a help file needs to be valid as part of a file://
URL, so R CMD check now checks the names are ASCII and do not
contain % .
o R CMD check now warns about unknown sections in Rd files, and
invalid names for help, demo and R files, as well as unlikely
file names in the 'src' directory. The latter is controlled
by option --check-subdirs and by default is done if checking a
tarball without a configure script.
R CMD build excludes invalid files in the 'man', 'R' and 'demo'
subdirectories.
o \usepackage[noae]{Sweave} in the header of an Sweave file
supresses auto-usage of the ae package ("almost European"
fonts) and T1 input encoding.
DOCUMENTATION
o Rd format now allows \var{} markup inside \code{} and \examples{}.
o Markup such as --, ---, < and > is handled better when
converting .Rd files to [C]HTML.
o There is new markup \link[=dest]{name} to generate a link to topic
'dest' which is shown as 'name', and \linkS4class{abc} which
expands to \link[=abc-class]{abc}, for cross-referencing the
recommended form of documentation for S4 classes.
PACKAGE INSTALLATION
o There is now some support for Fortran 90/95 code in packages:
see `Writing R Extensions'.
o Installation of man sources and demos is now done by R code.
The restrictions on the names of help files, R files and
of demos are now enforced (see `Writing R Extensions').
o Packages which contain compiled code can now have more than
one dot in their name even on Windows.
o The Meta/hsearch.rds database saved now contains LibPath="".
This information is now always recreated when help.search() is
run, but the field is retained for back-compatibility.
o update.packages() now has a '...' argument to be passed to
install.packages(), including the formerly separate arguments
'destdir' and 'installWithVers'.
o Make macros AR and RANLIB are now declared in etc/Makeconf for
use by packages which wish to make static libraries.
C-LEVEL FACILITIES
o qgamma and rgamma in Rmath.h now check for non-positive arguments.
o The BLAS which ships with R now contains the complete set of
double-complex BLAS routines, rather than just those used in R.
<R_ext/BLAS.h> has been corrected to add the missing
double-precision BLAS functions drotmg and drotm, and to
exclude lsame (which is a Lapack auxiliary function and is now
declared in <R_ext/Lapack.h>). It also includes the double
complex routines added for this release of R provided Fortran
doublecomplex is usable on the platform.
o <R_ext/BLAS.h> and <R_ext/Lapack.h> now declare all the entry
points as 'extern'.
o The flag SAFE_FFLAGS is made available to packages via
etc/Makeconf and R CMD config. It can be used where
optimization needs to be defeated, e.g. in LAPACK setup.
o getNativeSymbolInfo has a withRegistrationInfo argument which
causes the address field to be a reference to the registration
information if it is available for that symbol. If the
registration information is not available, the address is a
reference to the native symbol. The default is FALSE which is
backward compatible, returning just the address of the symbol
and ignoring registration information.
o errorcall and warningcall are now declared in <Rinternals.h>
(they might be needed in front-ends).
o R_FlushConsole and R_ProcessEvents are now declared in <R.h>.
o The R_Sock* functions supporting socket connections are no
longer declared in R-ftp-http.h as they are not loaded into R
itself, and are now hidden in the module's DLL on suitable systems.
BUG FIXES
o Quoted arguments to the R script after --args are now
passed quoted to the R executable and so will be shown as
expected by commandArgs(). (They were previously split at
whitespace even inside quotes on Unix-alikes but not on
Windows.)
o axis() now supports pars 'xaxp'/'yaxp' as inline arguments.
o sort() now does not return inappropriate attributes such as
"dim" and "tsp": it only returns names.
sort(x, partial=) no longer returns unsorted names, and drops
names (since it is supplied for efficiency).
o Use of non-central F in pf() gives accurate values for larger ncp.
o R CMD build --binary does a better job of cleaning up after
failure to re-make vignettes.
o reg-test-1.R tested system(intern=TRUE) which depends on popen
and so is not supported on all platforms.
o Changed apparent mis-spelling of "Gibraltar" in dataset 'eurodist'.
o sysconf() is now used to find the number of clock ticks/second:
under some circumstances glibc reported CLK_TCK = 60 when the
true value was 100.
o identical() was not allowing for embedded nuls in character
strings. (NB: the comparison operators including == do not,
and never will.)
o The profile() and profiler() methods for "nls" objects now
support algorithm = "plinear" and algorithm = "port".
o The signal handlers for signals USR1 and USR2 where not
restored if the signal arrived when interrupts were suspended.
o Certain combinations of S4 inheritance could cause inherited
methods to override some directly specified methods.
o Some cases of named signatures in calls to setMethod() caused errors.
o all.equal() is now more consistent and "picky" about mismatching
attributes, in particular names(); this is a part of the
propositions by Andy Piskorkski (PR#8191).
o load() when applied to a connection leaves it open/not as it
found it, and checks explicitly for having a binary readable
connection.
o The p-values given by stat.anova() (called from several
anova() methods) are now NA (rather than spurious) if
non-nested models give rise to changes in deviance with a
different sign from changes in degrees of freedom.
o Built-ins were reported as the relevant call in C-level error()s
iff R profiling was in progress. Now they are never reported.
o Too-long signatures (with no names) were not being caught
in setMethod().
o Slot names in prototype() are being more thoroughly checked.
o signif() is more likely to follow the 'round to even' rule for
exactly representable numbers, e.g. signif(0.25, 1). (Related
to PR#8452.)
o nls() now works correctly with some low-dimensional fits,
e.g. with one or zero non-linear parameters.
o glm() could give an inappropriate error message if all
possible coefficients were invalid (e.g. a log-linear binomial
model with no intercept and a not all positive predictor).
o solve() gives clearer error messages for some incorrect usages.
(PR#8494 and similar)
o The gaussian() family was missing the 'valideta' component
(which could be needed for the "inverse" link function).
The starting values supplied by the gaussian family could be
invalid for the "log" and "inverse" link functions. This is
now reported.
o data.matrix() did not work correctly on zero-row data frames.
(PR#8496 and other problems.)
o The DSC comments in the files from postscript(onefile=FALSE) now
label all files as having page 1 of 1, as some other software
seems to expect that.
o The axis labels chosen for logarithmic axis are now less
likely to be linear and inappropriate (when the range is more
than 10 and less than 100). (PR#1235)
o Staircase lines (types "s" and "S") are now drawn
continuously rather than a point at a time and so line types,
mitring and so on work. (PR#2630)
o Calling par(mfg) before doing any plotting resulted in NewPage
never being called on the device, which in turn resulted in
incorrect output for postcript() and pdf() devices. (Reported
by Marc Schwartz in discussion of the non-bug PR#7820.)
o terms.formula needed to add parentheses to formulae with
terms containing '|'. (PR#8462)
o pbirthday() and qbirthday() now also work for very improbable
events {those you are typically *not* interested in}.
o Only source help files starting with an upper- or lower-case
letter or digit and extension .Rd or .rd are documented to be
processed. This is more liberal in that starting with a digit
is now also allowed, but rule is now enforced.
o nls(algorthm="port") was always taking positive numeric
differences and so could exceed the upper bounds.
o methods:::.asEnvironmentPackage() was not allowing for
versioned installs.
o .find.package() now reports which package(s) it cannot find in
the case it stops with an error.
o The standard Unix-alike version of file.show() gives an
informative message if it cannot open a file rather than the
(possibly incorrect) 'NO FILE'.
o window() did not allow non-overlapping ranges with
extend = TRUE. (PR#8545)
o pbinom(size = 0) now returns correct values (not NaN). (PR#8560)
o [dp]binom(x, *) for x < 0 now always returns 0. (PR#8700)
analogous change in pgeom(), pnbinom() and ppois().
o [dqpr]geom and [dpqr]nbinom() now all consistently accept prob = 1
but not prob = 0. qgeom(prob=1) now gives the correct values
(not -1).
o INSTALL on Unix-alikes was not loading dependent packages when
preparing for lazy-loading.
o qcauchy(1) now gives +Inf instead of just a very large number.
o df(0, f1, *) now properly returns Inf, 1, or 0 for f1 < , = , or > 2.
o qbinom(), qnbinom() and qpois() now use a better search and
normally reach the answer very quickly when it is large
(instead of being slow or infinite-looping).
o pt(x, df) lost accuracy in the far tails (when |x| > 1e154) for
small df (like df = 0.001 for which such extremes are not unlikely).
o dbeta(x, a, b) underflowed internally and incorrectly gave 0
for very small x and a.
o None of the warnings about convergence failures or loss of
precision in nmath (distribution and special functions) were
being reported to the R user.
o dnt was missing from standalone nmath (under Unix-alikes).
o split() now accepts factors with numeric (but not storage mode
integer) codes.
o The utilities such as 'check' now report active version numbers
again, as SVN 'last changed revision' numbers.
o addmargins() did not accept a name for 'FUN', only an expression.
o '+' for POSIXt objects now takes the tzone from whichever
object has it, so date+x is the same as x+date if x is numeric.
o mean.default() and var() compute means with an additional pass
and so are often more accurate, e.g. the variance of a
constant vector is (almost) always zero and the mean of such a
vector will be equal to the constant value to machine
precision. (PR#1228)
sum(), prod(), mean(), rowSums() and friends use a long double
accumulator where available and so may be more accurate. (This
is particularly helpful on systems such as Sparc and AMD64
where long double gives considerably greater exponent range
and precision than double.)
o read.dcf() now gives a warning on malformed lines.
o add1.[g]lm now try harder to use the environment of the
formula in the orginal fit to look for objects such as the
'data' and 'subset' arguments.
o gaussian()$aic was inconsistent with e.g. the lm results from
AIC() and extractAIC() for weighted fits: it treated the weights
as case weights and not variance factors.
o system() on Unix-alikes ignored non-logical values of 'intern' and
treated 'intern = NA' as true.
o as.table() now produces non-NA rownames when converting a
matrix of more than 26 rows. (PR#8652)
o Partial sorting used an algorithm that was intended only for a
few values of 'partial' and so could be far slower than a full
sort. It now switches to a barebones full sort for more than
10 values of 'partial' and uses a more efficient recursive
implementation for 2...10.
o summary.glm() returned an estimate of dispersion of Inf for a
gaussian glm with zero residual degrees of freedom and then
treated that as a known value. It now uses the estimate NaN,
which is consistent with summary.lm().
o Sys.sleep() on Unix-alikes was restricted to about 2147 seconds
and otherwise might never have returned. (PR#8678)
o is(obj, Cl) could wrongly report TRUE when Cl was a classUnion and
multiple inheritance was involved.
o confint[.lm / .default] used label "100 %" for level = 0.999
o Empty entries (i.e., extraneous ",") in NAMESPACE files now give
a better error message early at parsing time instead of a less
comprehensible one later at load time.
o all.equal(n1, n2) could erroneously return NA when n1, n2
contained large integers.
o anova.mlm() didn't handle multi-df effects properly in the
single-model case (PR#8679)
o anova.mlm() had its colnames mangled by data.frame() (needed
check.names=FALSE).
o summary.glm() gave an NA estimate of dispersion for fits with
zero weights. (PR#8720)
o qhyper() had too small a tolerance for right-continuity on
some platforms so was not always an inverse to phyper().
o rownames<-.data.frame() and dimnames<-.data.frame() tested the
length(s) of the replacement value(s) before coercion, which
can change the length (e.g. for class "POSIXlt").
o max() and min() ignored the largest/smallest representable
integer, as well as Inf/-Inf. (PR#8731)
o write.table() assumed factors had integer codes: it now allows
malformed factors with numeric codes (and otherwise throws an
error).
o Worked around a Solaris restriction which meant that
Sys.sleep() was only effective for times of up to one second.
o sink(, split=TRUE) now works correctly, but is allowed only on
platforms that support va_copy or __va_copy. (PR#8716)
o factanal(), prcomp() and princomp() now only check that columns
in the model frame that will be used are numeric (they
previously also checked columns which were part of negative terms
in the formula).
o Misuse of $ in apply could corrupt memory. (PR#8718)
o apply() could fail if the function returned NULL (e.g. if
there was a single row).
o registerS3method() failed due to a typo. (It was almost never
used.)
o Registering an S3 method for an S3 generic in another package
that was converted to an S4 generic in the same package as the
S3 method, registered the method in the wrong place.
o Recall() used lookup for the function in use and so could fail
if that was an S3 method not on the search path.
o Rdconv -t Ssgm failed if it encountered \link[opt]{arg}.
o uniroot() did not give a warning (as documented) if it failed
to converge in 'maxiter' steps. (PR#8751)
o eapply() (and as.list.environment()) did not work for the base
environment/name space. (PR#8761)
o Added protection in configure against systems for which using
xmkmf fails to report a C or C++ compiler.
o expand.grid() was constructing a data frame 'by hand' and so
setting integer row.names (which are documented to be
character). It now sets character row names, and
row.names.data.frame() coerces to character.
o qbeta() used == on volatile doubles for its convergence test,
which failed with gcc 3.3.x on ix86 Linux. We now use a less
fragile test (and lose a negligible amount of accuracy).
o ls.str() was missing inherits=FALSE, and so could have
reported on an object of the same name but a different mode in
the enclosure of the given environment.
o logLik.nls assumed that sigma^2 had been estimated, but did
not count this in the 'df' attribute.
**************************************************
* *
* 2.2 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.2.1 patched
INSTALLATION CHANGES
o The macro SOCKLEN_T has been replaced by R_SOCKLEN_T to work
around a problem with the headers of AIX 5.3.
BUG FIXES
o sub(fixed = TRUE) could get wrong the length of the character
string for elements of the result after the first.
o legend() worked out which elements of 'lty' were valid before
resizing 'lty', and so could fail if 'lty' was a different
length from 'legend'.
o str(<dendrogram>) sometimes used much too many spaces (in 2.2.x).
o eigen(eispack=TRUE) accessed areas off the matrix in some
circumstances (some asymmetric matrices with both complex
conjugate pair and real eigenvalues).
o strptime() in 2.2.1 sometimes did not set $isdst when it was
previously set.
o Another case of infinite influence has been worked around.
(An addendum to PR#8367.)
o qr.coef() worked incorrectly with multiple rhs in the
LAPACK-using cases. (PR#8476/8)
o rbind.data.frame() gave a corrupt data frame if one of the
named arguments was a zero-row data frame. (PR#8506)
o Checks for NULL in the rho argument of the C-level findVar
function have been added.
o The C-level substitute function was handling NULL in its 'rho'
argument incorrectly.
o The code for pgamma() introduced in 2.1.0 failed for large
values of 'shape' where the previous code was perfectly
acceptable, despite the claim to be uniformly better. For
example, pgamma(0.9e100, 1e100) was NaN. (PR#8528)
o There was no command 'ls' in browser() nor 'next' in debug(),
despite the documentation (which has been corrected).
Command 'where' in the browser() no longer changes to
step-though mode.
o factor.scope() could report incorrectly that interaction terms
were not in the upper scope when such terms in the model and
the upper scope had different orders for the main effects.
(Another manifestation of PR#7842.)
o The "lm" method of drop1() was giving incorrect results for
weighted fits (since deviance.lm() was called on a non-"lm" object).
o dotchart() was miscalculating the space for the labels in the
left margin. (PR#8681)
o r <- glm(.....); all.equal(r,r) # now gives TRUE instead of an error
o plot.acf() with a multiple time series was sometimes
miscalculating the 'ylim' value for the plot after the first.
(PR#8705)
CHANGES IN R VERSION 2.2.1
USER-VISIBLE CHANGES
o options("expressions") has been reduced to 1000: the limit
of 5000 introduced in 2.1.0 was liable to give crashes from C
stack overflow.
NEW FEATURES
o Use of 'pch' (e.g. in points) in the symbol font 5 is now
interpreted in the single-byte encoding used by that font.
Similarly, strwidth now recognizes that font 5 has a different
encoding from that of the locale. (These are likely to affect
the answer only in MBCS locales such as UTF-8.)
o The URW font metrics have been updated to versions from late
2002 which cover more glyphs, including Cyrillic.
o New postscript encodings for CP1250 (Windows East European),
ISO Latin-7 (8859-13, Latvian, Lithuanian and Maori), Cyrillic
(8859-5), KOI8-R, KOI8-U and CP1251.
o configure has more support for the Intel and Portland Group
compilers on ix86 and x86_64 Linux.
o R CMD INSTALL will clean up if interrupted (e.g. by ctrl-C from
the keyboard).
o There is now a comprehensive French translation of the messages,
thanks to Philippe Grosjean, Frederic Lehobey, Jean Thioulouse
and Emmanuel Paradis.
DEPRECATED & DEFUNCT
o The undocumented use of atan() with two arguments is deprecated:
instead use atan2() (as documented).
o The 'vfont' argument of axis() and mtext() is deprecated
(it currently warns and does nothing).
o The function mauchley.test() is deprecated (was a misspelling)
and replaced by mauchly.test()
BUG FIXES
o The malloc's of AIX and OSF/1 which return NULL for size 0
are now catered for in src/main/regex.c.
o Names of list elements which are missing are now printed as
$<NA> and not $"NA" (which is how the non-missing name "NA" is
printed). (Brought up in discussion of PR#8161.)
o help.start() was not linking R.css for use by its front page and
immediate links (2.2.0 only).
o Indexing by character NA matched the name "NA".
o The arith-true test used random inputs and did not set the seed, so
it could fail very occasionally.
o arima() with 'fixed' supplied and p=0 for the non-seasonal
part could give spurious warnings about 'some AR parameters
were fixed'.
o summary.matrix() could give an infinite recursion on some
classed objects (e.g. those of class "Surv").
o The 255th character in an 8-bit character set was not handled
correctly as a letter on some platforms where C char is
signed: for example it was printed as \377 and not allowed in
variable names. (Spotted by Alexey Shipunov in Russian
encodings.)
o Conversion from POSIXct to POSIXlt is done more accurately
around the change of DST in years not supported by the OS
(pre-1970 on Windows and some others, and in the far past or
future).
o chisq.test(cbind(1:0, c(7,16)), simulate.p = TRUE) gave wrong
P-values on some platforms. (PR#8224)
o pdf() was not writing details of the encoding to the file
correctly. (Spotted by Alexey Shipunov in Russian encodings.)
o image() was failing with an error when plotting a matrix
of all NA values. (PR#8228)
image() could fail if called with add=FALSE (the default) and
length(x)=1 for either x or y, as it uses the plot coordinates of
the previous plot (if any).
o tools::checkMD5sums was not accepting file names with spaces in.
o The plot() method for TukeyHSD() needed updating after adding
adjusted p-values. (PR#8229)
o read.fwf() did not work for header = TRUE. (PR#8226)
o diag() failed when its argument had NA values in its dimnames.
o [g]sub(pcre=TRUE) did not work correctly with \U and \L in a
UTF-8 locale, even on the example on the help page.
o promptMethods() was failing if the "methods" argument was supplied.
o is.loaded() now finds Fortran symbols whether or not the
registration mechanism has been used.
o ISODateTime() mistakenly corrected non-existent times (when
DST was being started) in the current time zone.
o Some replacement operations on data frames gave incorrect
answers, e.g. DF[3:4, "y"] if column "y" did not exist or was
a matrix.
o getGraphicsEvent() would cause memory corruption if passed an
empty prompt.
o qr() and chol() now pivot the colnames of the result when
pivoting is used. (PR#8258)
o example(points) omitted pch=0, although it was valid and
said in the text to be illustrated.
o plot.default() had an unused 'lab' argument, thereby preventing
the 'lab' graphics parameter being passed through '...' .
o Although polygon(col = NA) was the stated default, specifying
NA was not equivalent to omitting the argument (but col=NULL
was equivalent).
o Im(-1) was pi. (PR#8272, a side effect from all previous
versions of R returning the same value for Im and Arg of
non-complex numbers.)
o symbols(fg) defaulted to colour 1, not par("col") as documented.
It does now defaults to par("col").
o par("family") did not check the length of the value (up to 49
bytes) and so could segfault.
o aggregate.ts() did not allow for rounding in frequencies such
as 1/5.
o prcomp(tol=) was not dropping the sdev's corresponding to
dropped columns.
o Subassignment of a vector which increased the length of the
vector _and_ had the wrong length of replacement could
occasionally segfault. (This has been there since at least
mid 1997.)
o The registration of .Fortran symbols was broken: these could
only be looked up if there were also .Call symbols registered!
o R CMD build was incorrectly rejecting the recommended form of
name for a translation package, 'Translation-ll'. (PR#8314)
o numericDeriv() gave nonsense results unless the variables were
real, which was not checked.
o predict.prcomp() would sometimes give an error when predicting
a single observation. (PR#8324)
o mapply() could segfault if MoreArgs was not a list. (PR#8332)
o The arith-true test used identical() on floating-point results,
and this allowed a failure when the relative difference was
less than .Machine$double.eps but non-zero.
o qbinom() was not accepting p = -Inf when log.p = TRUE, although
it is a legitimate value.
o write.csv[2] only accepted logical constants for 'row.names', and
now accepts variables.
o Conversion of .Rd files did not correctly match braces
enclosing a whole argument, e.g. \eqn{{\bf a}}{a}.
o The C function pythag (used if hypot was not available) would
infinite-loop on systems with effective optimizing compilers.
o Writing long formats (more than 1000 bytes) with connections
that use dummy_vfprintf could fail on some systems. The limit
has been changed to 100000 bytes pending a more complete fix in R
2.3.0.
o Making in src/nmath/standalone without making R was not
making Rmath.h.
o Both the R front-end and INSTALL could find the attempted
temporary directory name already in use on platforms without
mktemp (and a genuine Bourne shell /bin/sh, not bash). Now
both the process ID and a timestamp are used to create the
directory name.
o [dpqr]gamma now return NaN for an invalid 'shape' parameter
(rather than throw an error), for consistency with other
distribution functions.
o t() now longer drops dimnames 'list(NULL,NULL)' or 'list(NULL)'.
o Influence measures such as rstandard() and cooks.distance()
could return infinite values rather than NaN for a case which
was fitted exactly. Similarly, plot.lm() could fail on such
examples. plot.lm(which = 5) had to be modified to only plot
cases with hat < 1. (PR#8367)
lm.influence() was incorrectly reporting 'coefficients' and
'sigma' as NaN for cases with hat = 1, and on some platforms
not detecting hat = 1 correctly.
o Rmath.h for standalone Rmath was not recording HAVE_WORKING_LOG,
so R_log was not available on platforms defining it.
o HoltWinters() was using a slightly incorrect formula in the C code.
o dir.create() could be confused by a trailing slash on the
path, and by paths containing drives on Windows.
o The search for tcl/tkConfig.sh looked in 'lib' before 'lib64'
directories (and not at all in /usr/local/lib64) and so might
prefer 32- to 64-bit versions if both are available.
o nlminb() used an uninitialized variable unless bounds were supplied,
and so failed on 64-bit Solaris.
CHANGES IN R VERSION 2.2.0
USER-VISIBLE CHANGES
o plot(<lm object>) uses a new default 'which = 5'
for the fourth panel when 'which' is not specified.
o The SVN revision number will appear after the date in the
welcome message. The date shown is now the date of the last
change to the sources rather than the date the sources were
prepared.
o is.null(expression()) now returns FALSE. Only NULL gives TRUE
in is.null().
o graphics::xy.coords, xyz.coords and n2mfrow have been moved to
the grDevices name space (to be available for grid as well).
graphics::boxplot.stats, contourLines, nclass.*, and chull
have been moved to the grDevices name space. The C code
underlying chull() has been moved to package grDevices.
o split(x, f), split<-() and unsplit() now by default split by all
levels of a factor f, even when some are empty.
Use split(x, f, drop = TRUE) if you want the old behavior of
dropping empty levels. split() and split<-() are S3 generic
functions with new arguments 'drop' and '...' and all methods now
should have 'drop' and '...' arguments as well.
o The default for 'allowEscapes' in both read.table() and scan()
has been changed to FALSE.
o The default for 'gcFirst' in system.time() is now TRUE.
NEW FEATURES
o .Platform has a new component 'path.sep', the separator used
between paths in environment variables such as PATH and TEXINPUTS.
o anova.mlm() now handles the single-model case.
o Hexadecimal values are now allowed for as.numeric() and
as.integer() on all platforms, and as integer constants in R code.
o attach() now prints an information message when objects are
masked on the search path by or from a newly attached database.
o axis() now returns 'at' positions.
o axis() has a new argument 'hadj' to control horizontal
adjustment of labels.
o axis.Date() and axis.POSIXct() now accept a 'labels' argument
(contributed by Gavin Simpson).
o barplot() now has arguments 'log = ""' and 'add = FALSE'
(as in barplot2() from package 'gplots').
o baseenv() has been added, to return the base environment. This
is currently still NULL, but will change in a future release.
o boxplot() now responds to supplying 'yaxs' (via bxp()).
(Wish of PR#8072.)
o capabilities() has a new component 'NLS'.
o cbind() and rbind() now react to 'deparse.level' = {0,1,2}
(as in another system not unlike R).
o Experimental versions of cbind() and rbind() in methods package,
based on new generic function cbind2(x,y) and rbind2(). This will
allow the equivalent of S4 methods for cbind() and rbind() ---
currently only after an explicit activation call, see ?cbind2.
o New functions cdplot() and spineplot() for conditional density
plots and spine plots or spinograms. Spine plots are now used
instead of bar plots for x-y scatterplots where y is a factor.
o checkDocFiles() in package 'tools' now checks for bad \usage
lines (syntactically invalid R code).
o The nonparametric variants of cor.test() now behave better in
the presence of ties. The "spearman" method uses the asymptotic
approximation in that case, and the "kendall" method likewise,
but adds a correction for ties (this is not necessary in the
Spearman case).
o The X11 dataentry() now has support for X Input Methods
(contributed by Ei-ji Nakama).
o density() is now an S3 generic where density.default() {former
density()} has new argument 'weights' for specifying observation
masses different than the default 1/N -- based on a suggestion and
code from Adrian Baddeley.
o download.packages() now carries on if it encounters a download
error (e.g. a repository with a corrupt index).
o dump() now skips missing objects with a warning rather than
throw an error.
o Added "POSIXlt" methods for duplicated() and unique().
o Function encoded_text_to_latex() in package tools translates
Latin 1,2,9 and UTF-8 encoded character vectors to LaTeX
escape sequences where appropriate.
o encodeString() allows justify = "none" for consistency with
format.default(). Some argument names have been lengthened
for clarity.
o file(), fifo() and pipe() now (if possible) report a reason
if they fail to open a connection.
o format.default() now has a 'width' argument, and 'justify' can
now centre character strings.
format.default() has new arguments 'na.encode' to control
whether NA character strings are encoded (true by default),
and 'scientific' to control the use of fixed/scientific
notation for real/complex numbers.
How format() works on a list is now documented, and uses
arguments consistently with their usage on an atomic vector.
o format.info() now has a 'digits' argument, and is documented
to work for all atomic vectors (it used to work for all but
raw vectors.).
o New function glob2rx() for translating `wildcard' aka `globbing'
to regular expressions.
o There is a new function gregexpr() which generalizes regexpr()
to search for all matches in each of the input strings (not
just the first match).
o [g]sub() now have a 'useBytes' argument like grep() and regexpr().
o [g]sub(perl = TRUE) support \L and \U in the replacement.
o iconv() has been moved from 'utils' to 'base'.
o identify()'s default method has additional arguments 'atpen'
and 'tolerance' (following S).
o KalmanForecast() and KalmanLike() now have an optional argument
fast=FALSE to prevent their arguments being modified.
o Exact p-values are available in ks.test() for the one-sided and
two-sided one-sample Kolmogorov-Smirnov tests.
o labels() now has a method for "dist" objects (replacing that
for names() which was withdrawn in 2.1.0).
o library() now explicitly checks for the existence of
directories in 'lib.loc': this avoids some warning messages.
o loadNamespace(keep.source=) now applies only to that name space
and not others it might load to satisfy imports: this is now
consistent with library().
o match.arg() has a new argument 'several.ok = FALSE'.
o max.col() has a new argument for non-random behavior in the
case of ties.
o memory.profile() now uses the type names returned by typeof()
and no longer has two unlabelled entries.
o methods() now warns if it appears to have been called on a
non-generic function.
o The default mosaicplot() method by default draws grey boxes.
o nlminb(), similar to that in S-PLUS, added to package 'stats'.
o New algorithm "port" (the nl2sol algorithm available in the
Port library on netlib) added to the nls() function in the
'stats' package.
o object.size() now supports more types, including external
pointers and weak references.
o options() now returns its result in alphabetical order, and is
documented more comprehensively and accurately. (Now all
options used in base R are documented, including
platform-specific ones.)
Some options are now set in the package which makes use of
them (grDevices, stats or utils) if not already set when the
package is loaded.
o New option("OutDec") to set the decimal point for output conversions.
o New option("add.smooth") to add smoothers to a plot, currently
only used by plot.lm().
o pie() has new optional arguments 'clockwise' and 'init.angle'.
o plot.lm() has two new plots (for 'which' = 5 or 6), plotting
residuals or cook distances versus (transformed) leverages - unless
these are constant. Further, the new argument 'add.smooth' adds a
loess smoother to the point plots by default, and 'qqline = TRUE'
adds a qqline() to the normal plot.
The default for 'sub.caption' has been improved for long calls.
o R.home() has been expanded to return the paths to components
(which can as from this version be installed elsewhere).
o readbin() and writeBin() now support raw vectors as well as
filenames and connections.
o read.dcf() can now read gzipped files.
o read.table() now passes 'allowEscapes' to scan().
o sample(x, size, prob, replace = TRUE) now uses a faster
algorithm if there are many reasonably probable values. (This
does mean the results will be different from earlier versions
of R.) The speedup is modest unless 'x' is very large _and_
'prob' is very diffuse so that thousands of distinct values
will be generated with an appreciable frequency.
o scatter.smooth() now works a bit more like other plotting
functions (e.g., accepts a data frame for argument 'x').
Improvements suggested by Kevin Wright.
o signif() on complex numbers now rounds jointly to give the
requested number of digits in the larger component, not
independently for each component.
o New generic function simulate() in the 'stats' package with
methods for some classes of fitted models.
o smooth.spline() has a new argument 'keep.data' which allows to
provide residuals() and fitted() methods for smoothing splines.
o Attempting source(file, chdir=TRUE) with a URL or connection
for 'file' now gives a warning and ignores 'chdir'.
o source() closes its input file after parsing it rather than
after executing the commands, as used to happen prior to
2.1.0. (This is probably only significant on Windows where
the file is locked for a much shorter time.)
o split(), split<-(), unsplit() now have a new argument 'drop = FALSE',
by default not dropping empty levels; this is *not* back compatible.
o sprintf() now supports asterisk `*' width or precision
specification (but not both) as well as `*1$' to `*99$'. Also the
handling of `%' as conversion specification terminator is now
left to the system and doesn't affect following specifications.
o The plot method for stl() now allows the colour of the range
bars to be set (default unchanged at "light gray").
o Added tclServiceMode() function to the tcltk package to allow
updating to be suspended.
o terms.formula() no longer allows '.' in a formula unless there
is a (non-empty) 'data' argument or 'allowDotAsName = TRUE' is
supplied. We have found several cases where 'data' had not
been passed down to terms() and so '.' was interpreted as a
single variable leading to incorrect results.
o New functions trans3d(), the 3D -> 2D utility from persp()'s
example, and extendrange(), both in package 'grDevices'.
o TukeyHSD() now returns p-values adjusted for multiple comparisons
(based on a patch contributed by Fernando Henrique Ferraz P. da Rosa).
o New functions URLencode() and URLdecode(), particularly for use
with file:// URLs. These are used by e.g. browse.env(),
download.file(), download.packages() and various help() print
methods.
o Functions utf8ToInt() and intToUtf8() to work with UTF-8
encoded character strings (irrespective of locale or OS-level
UTF-8 support).
o [dqp]wilcox and wilcox.test work better with one very large sample
size and an extreme first argument.
o write() has a new argument 'sep'.
o write.csv[2] now also support row.names = FALSE.
o The specification of the substitutions done when processing
Renviron files is more liberal: see ?Startup. It now
accepts forms like R_LIBS=${HOME}/Rlibrary:${WORKGRP}/R/lib .
o Added recommendation that packages have an overview man page
<pkg>-package.Rd, and the promptPackage() function to create a
skeleton version.
o Replacement indexing of a data frame by a logical matrix index
containing NAs is allowed in a few more cases, in particular
always when the replacement value has length one.
o Conversion of .Rd files to latex now handles encoding more
comprehensively, including some support for UTF-8.
o The internal regex code has been upgraded to glibc-2.3.5.
Apart from a number of bug fixes, this should be somewhat
faster, especially in UTF-8 locales.
o PCRE has been updated to version 6.2.
o zlib has been updated to version 1.2.3.
o bzip2 has been updated to version 1.0.3.
o Complex arithmetic is now done by C99 complex types where
supported. This is likely to boost performance, but is
subject to the accuracy with which it has been implemented.
o The printing of complex numbers has changed, handling numbers
as a whole rather than in two parts. So both real and
imaginary parts are shown to the same accuracy, with the
'digits' parameter referring to the accuracy of the larger
component, and both components are shown in fixed or
scientific notation (unless one is entirely zero when it is
always shown in fixed notation).
o Error messages from .C() and .Fortran(), and from parsing errors,
are now more informative.
o The date and date-time functions work better with dates more
than 5000 years away from 1970-01-01 (by making dubious
assumptions about the calendar in use).
o There is now a traditional Chinese translation, and a much more
extensive Russian translation.
DEPRECATED & DEFUNCT
o Capability "IEEE754" is defunct.
o loadURL() is defunct: use load(url()).
o delay() is defunct: use delayedAssign() instead.
o The 'CRAN' argument to update.packages(), old.packages(),
new.packages(), download.packages() and install.packages() is
defunct in favour of 'repos'.
o write.table0() is deprecated in favour of the much faster
write.table().
o format.char() is deprecated in favour of format.default().
o R_HOME/etc/Rprofile is no longer looked for if
R_HOME/etc/Rprofile.site does not exist. (This has been
undocumented since R 1.4.0.)
o CRAN.packages() is deprecated in favour of available.packages().
o Rd.sty no longer processes pre-2.0.0 conversions containing \Link.
o The stubs for the defunct device GNOME/gnome have been removed.
o print.matrix() (which has been identical to print.default since
R 1.7.0) has been removed.
INSTALLATION
o LDFLAGS now defaults to -L/usr/local/lib64 on most Linux
64-bit OSes (but not ia64). The use of lib/lib64 can be
overridden by the new variable LIBnn.
o The default installation directory is now ${prefix}/${LIBnn}/R,
/usr/local/lib64/R on most 64-bit Linux OSes and /usr/local/lib/R
elsewhere.
o The places where the doc, include and share directory trees are
installed can be specified independently: see the R-admin manual.
o We now test for wctrans_t, as apparently some broken OSes have
wctrans but not wctrans_t (which is required by the relevant
standards) .
o Any external BLAS found is now tested to see if the complex
routine zdotu works correctly: this provides a compatibility
test of compiler return conventions.
o Installation without NLS is now cleaner, and does not install
any message catalogues.
o src/modules/lapack/dlamc.f is now compiled with -ffloat-store
if f2c/gcc are used, as well as if g77 is used.
o All the Fortran code has been checked to be fully F77
compliant so there are no longer any warnings from F95
compilers such as gfortran.
o The (not-recommended) options --with-system-zlib,
--with-system-bzlib and -with-system-pcre now have 'system' in
the name.
o If a Java runtime environment is detected at configure time
its library path is appended to LD_LIBRARY_PATH or equivalent.
New Java-related variables JAVA_HOME (path to JRE/JDK), JAVA_PROG
(path to Java interpreter), JAVA_LD_PATH (Java library path)
and JAVA_LIBS (flags to link against JNI) are made available
in Makeconf.
o Ei-ji Nakama was contributed a patch for FPU control with the
Intel compilers on ix86 Linux.
MAC OS X INSTALLATION
o --with-blas="-framework vecLib" --with-lapack and
--with-aqua are now the default configure options.
o The default framework version name was changed to not contain
the patch level (i.e. it is now 2.2 instead of 2.2.0). Also
it can be overridden at configure time by setting FW_VERSION
to the desired name.
o The Rmath stand-alone library is now correctly installed inside
the R.framework if R was configured as a framework. In
addition, make install-Rmath-framework will install a
stand-alone Rmath framework in /Library/Frameworks (unless
overridden by RMATH_FRAMEWORK_DIR specifying full framework
path and name including the .framework extension).
PACKAGE INSTALLATION
o The encoding for a packages' 00Index.html is chosen from the
Encoding: field (if any) of the DESCRIPTION file and from the
\encoding{} fields of any Rd files with non-ASCII titles.
If there are conflicts, first-found wins with a warning.
o R_HOME/doc/html/packages.html is now remade by R not Perl code.
This may result in small changes in layout and a change in
encoding (to UTF-8 where supported).
o The return value of new.packages() is now updated for any
packages which may be installed.
o available.packages() will read a compressed PACKAGES.gz file in
preference to PACKAGES if available on the repository: this
will reduce considerably the download time on a dialup connection.
The downloaded information about a repository is cached for the
current R session.
o The information about library trees found by
installed.packages() is cached for the current session, and
updated only if the modification date of the top-level
directory has been changed.
o A data index is now installed for a package with a 'data' dir
but no 'man' dir (even though it will have undocumented data objects).
o contrib.url path for type="mac.binary" has changed from
bin/macosx/<version> to bin/macosx/<arch>/contrib/<version>
where <arch> corresponds to R.version$arch
UTILITIES
o checkFF() used by R CMD check has since R 2.0.0 not reported
missing PACKAGE arguments when testing installed packages with
name spaces. It now
- treats installed and source packages in the same way.
- reports missing arguments unless they are in a function in
the name space with a useDynLib declaration (as the
appropriate DLL for such calls can be searched for).
o Rd2dvi sets the encoding(s) used appropriately. If UTF-8
encoding is used, latex >= 2003/12/01 is required.
o codoc() allows help files named pkg_name-defunct.Rd to have
undocumented arguments (and not just base-defunct.Rd).
C-LEVEL FACILITIES
o C function massdist() {called from density()} has new argument
'xmass' (= weights).
o Raw vectors passed to .C() are now passed as unsigned char *
rather than as SEXPs. (Wish of Keith Frost, PR#7853)
o The search for symbols in a .C/.Call/... call without a
package argument now searches for an enclosing name space and
so finds functions defined within functions in a name space.
o R_max_col() has new (5th) argument '*ties_meth' allowing
non-random behavior in the case of ties.
o The header files have been rationalized: the BLAS routine
LSAME is now declared in BLAS.h not Linpack.h, Applic.h no
longer duplicates routines from Linpack.h, and Applic.h is
divided into API and non-API sections.
o memory.c has been instrumented so that Valgrind can track R's
internal memory management. To use this, configure using
--with-valgrind-instrumentation=level
where level is 1 or 2. Both levels will find more bugs with
gctorture(TRUE). Level 2 makes Valgrind run extremely slowly.
o Some support for raw vectors has been added to Rdefines.h.
o R_BaseEnv has been added, to refer to the base environment.
This is currently equal to R_NilValue, but it will change in
a future release.
BUG FIXES
o %/% has been adjusted to make x == (x %% y) + y * ( x %/% y )
more likely in cases when extended-precision registers were
interfering.
o Operations on POSIXct objects (such as seq(), max() and
subsetting) try harder to preserve time zones and warn if
inconsistent time zones are used.
o as.function.default() no longer asks for a bug report when
given an invalid body. (PR#1880, PR#7535, PR#7702)
o Hershey fonts and grid output (and therefore lattice output)
now rescale correctly in fit-to-window resizing on a Windows
graphics device. Line widths also scale now.
o Plotmath has more support for multibyte characters (contributed
by Ei-ji Nakama).
o The X11() device now hints the window manager so that decorations
appear reliably under e.g. the GNOME WM (contributed
by Ei-ji Nakama).
o Subsetting a matrix or an array as a vector used to attempt to
use the row names to name the result, even though the
array might be longer than the row names. Now this is only
done for 1D arrays when it is done in all cases, even matrix
indexing. (Tidies up after the fix to PR#937.)
o Constants in mathlib are declared 'const static double' to
avoid performance issues with the Intel Itanium compiler.
o The parser checks the format of numeric constants more
thoroughly so for example '123E-' is no longer valid.
o contourLines() no longer requires an open device (used to
start a device unnecessarily). Fix suggested by Barry Rowlingson.
o capabilities() used partial matching but was not documented
to: it no longer does so.
o kernel(1,0) printed wrongly; kernel(<name-string>, *) now returns
a named kernel in all cases; plot(kernel(.),..) is more flexible.
o qgamma(1,s) didn't give +Inf for some s.
o installed.packages() and download.packages() now always
return a matrix as documented, possibly with 0 rows (rather than
a 0-length character vector or NULL).
o Arithmetic operations on data frames no longer coerce the
names to syntatically valid names.
o Units are now properly recycled in grid layouts
when 'widths' or 'heights' are shorter than the number of
columns or rows (PR#8014).
o DF <- data.frame(A=1:2, B=3:4); DF[1, 1:3] <- NULL gave a wrong
error message.
o spline()/spinefun()'s C code had a memory access buglet which
never lead to incorrect results. (PR#8030)
o sum() was promoting logical arguments to double not integer
(as min() and other members of its group do).
o loess() had a bug causing it to occasionally miscalculate
standard errors (PR#7956). Reported by Benjamin Tyner, fixed
by Berwin Turlach.
o library(keep.source=) was ignored if the package had a
name space (the setting of options("keep.source.pkgs") was
always used).
o hist.POSIXct() and hist.Date() now respect par("xaxt").
o The 'vfont' argument was not supported correctly in title(),
mtext(), and axis(). The 'vfont' argument is superseded by
the par(family=) approach introduced in 2.0.0. This bug-fix
just updates the warning messages and documentation to
properly reflect the new order of things.
o The C-level function PrintGenericVector could overflow if
asked to print a length-1 character vector of several thousand
characters. This could happen when printing a list matrix,
and was fatal up to 2.1.1 and silently truncated in 2.1.1 patched.
o What happened for proc.time() and system.time() on
(Unix-alike) systems which do not support timing was
incorrectly documented. (They both exist but throw an error.)
Further, systen.time() would give an error in its on.exit
expression.
o weighted.residuals() now does sensible things for glm() fits:
in particular it now agrees with an lm() fit for a Gaussian glm()
fit. (PR#7961).
o The 'lm' and 'glm' methods for add1() took the weights and
offset from the original fit, and so gave errors in the
(dubious) usage where the upper scope resulted in a smaller
number of cases to fit (e.g. by omitting missing values in new
variables). (PR#8049)
o demo() had a 'device' argument that did nothing (although it
was documented to): it has been removed.
o Setting new levels on a factor dropped all existing
attributes, including class "ordered".
o format.default(justify="none") now by default converts NA
character strings, as the other values always did.
o format.info() often gave a different field width from format()
for character vectors (e.g. including missing values or
non-printable characters).
o axis() now ensures that if 'labels' are supplied as character
strings or expressions then 'at' is also supplied (since the
calculated value for 'at' can change under resizing).
o Defining S4 methods for "[" had resulted in changed behavior of S3
dispatch in a very rare case which no longer happens.
o Fixed segfault when PostScript font loading fails, e.g., when
R is unable to find afm files (reported by Ivo Welch).
o R CMD BATCH <file> now also works when <file> does not end in a
newline on Unix-alike platforms.
o terms.formula() got confused if the 'data' argument was a list with
non-syntactic names.
o prompt() and hence package.skeleton() now produce *.Rd files that
give no errors (but warnings) when not edited, much more often.
o promptClass() and promptMethods() now also escape "%" e.g. in '%*%'
and the latter gives a message about the file written.
o wilcox.test() now warns when conf.level is set higher than
achievable, preventing errors (PR#3666) and incorrect answers
with extremely small sample sizes.
o The default (protection pointer) stack size (the default for
'--max-ppsize') has been increased from 10000 to 50000 in order to
match the increased default options("expressions") (in R 2.1.0).
o The R front-end was expecting --gui=tk not Tk as documented,
and rejecting --gui=X11.
o Rdconv -t latex protected only the first << and >> in a chunk
against conversion to guillemets.
o callNextMethod() and callGeneric() have fixes related to
handling arguments.
o ls.diag() now works for fits with missing data. (PR#8139)
o window.default() had an incorrect tolerance and so sometimes
created too short a series if 'start' or 'end' were zero.
o Some (fairly pointless) cases of reshape left a
temporary id variable in the result (PR#8152)
o R CMD build used 'tar xhf' which is invalid on FreeBSD systems
(and followed tar chf, so there could be no symbolic links in
the tarball).
o Subassignment of length zero vectors to NULL gave garbage
answers. (PR#8157)
o Automatic coercion of raw vectors to lists was missing, so for a
list (or data frame) z, z[["a"]] <- raw_vector did not work
and now does. This also affected DF$a <- raw_vector for a
data frame DF.
o The internal code for commandArgs() was missing PROTECTs.
o The width for strwrap() was used as one less than specified.
o R CMD INSTALL was not cleaning up after an unsuccessful
install of a non-bundle which was not already installed.
**************************************************
* *
* 2.1 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.1.1 patched
BUG FIXES
o runmed(x, k = -1) now gives an error instead of a seg.fault.
o File creation errors in pdf(), postscript(), xfig() resulted
in a pointer being freed twice. (Reported by Matt McCall)
o model.matrix(~ .^2, data=foo) now works as most people would
expect (it used to expand '.' after using the a^2 = a rule).
o ftable() and xtabs() had a check for interactions that would
not work correctly with '.' in the formula.
o The formula method for pairs() was ignoring the na.action argument.
o scan() with the default separator (only) was stripping backslashes
inside quoted string inputs even if allowEscapes = FALSE.
o The "col" parameter to pairs() is now treated consistently with
plot(): it affects the data, not the axes. (Patch submitted
by Olaf Mersmann)
o Sweave failed for \Sexpr{character(0)}. Sweave-test-1.Rnw
contained a print() statement that is no longer needed.
o Typo meant that R_alloc was limited to 2^31 not 2^34 on 64-bit
builds of R.
o pgamma(Inf, shape) did not terminate for shape = 1.1 and some
other values (but not all) (PR#8001). This affected
pchisq(Inf, df1) and pf(Inf, df1, Inf) for some values of df1.
o regexpr("[a-z]", ...) could cause a buffer overrun with multi-byte
character sets, leading to random errors later.
o Installing a package with a 'data' directory which contains
files but those files generate no objects (e.g. the BioC
package makecdfenv) created an incorrectly formatted data
index that data(package="pkg") could not read.
o density(1/(0:2)) now works again (PR#8033).
o make.names() was not respecting the allow_=FALSE argument.
o Arg(-1) now gives pi, not 0; Arg(0i + -1) always worked.
o --enable-linux-lfs had been broken at 2.1.0.
o Printing was not allowing for double-width characters in its
layout.
o axTicks() is now also correct for reverse axis. (PR#7973)
o signif() rounded some numnbers near 1e-308 to the wrong
number of places (this showed up in the print-tests.R), and made
unnecessary rounding errors on some platforms on e.g. signif(18000, 3).
o window() was sometimes failing incorrectly due to representation
errors when the new and old deltat were not both integers
(e.g. multiples of 0.1).
o The 'lm' methods for add1() and drop1() ignored offsets (which
were added for lm() after they written). (PR#8049)
o atan2(0+1i, 0+0i) was incorrectly NA (from a typo in complex.c).
o The POSIXct method for as.Date() was rounding part days
before 1970-01-01 upwards rather than discarding them.
o qpois() was using an incorrect starting point and so could be
unnecessarily slow for large lambda. (PR#8058)
o Formatting of complex numbers with nsmall > 0 could be
incorrect (and was in print-tests.Rout) because of a typo.
o The test for new levels when predicting using model.frame()
sometimes reported levels that were not actually used.
o order(c("5","6",NA,"4",NA), na.last=FALSE) was incorrect.
o Coercion to raw could give spurious messages about discarding
imaginary parts.
Coercion of a list to raw was behaving inconsistently for
out-of-range values (and not warning).
o cor.test(method = "spearman") gave NA p-values for _very_ long
vectors. (PR#8087)
o Switching to the Mersenne-Twister RNG could cause a segfault on
first use.
A user-supplied RNG without user_unif_{nseed,seedloc} was
being re-initialized at each call.
o Reading very short tables from stdin() with read.table would
fail because of a typo.
CHANGES IN R VERSION 2.1.1
NEW FEATURES
o bug.report() now reports the locale in use.
o upgrade.packageStatus() allows user input "c" to cancel the
upgrade, just as update.packages() does.
o glm() now accepts 1D arrays (e.g. tables) as a response,
dropping them to a vector whilst preserving names.
o df() with one infinite df now works (to match pf()).
o Added tclServiceMode() function to the tcltk package to allow
updating to be suspended.
o The Encoding: field of a DESCRIPTION file is now documented,
and used by packageDescription() and library(help=).
o There has been progress on translations: existing translations
have been revised and expanded, and French and Korean have
been added.
The Windows installer supports a wide range of languages for
installation.
BUG FIXES
o lm(qr=FALSE) now works.
o predict.glm() not longer loses names for "response" predictions.
(PR#7792)
o Typo in menu(graphics=TRUE) meant it failed on Unix if tcltk
was not available.
o When names.dist() was removed, the result of cmdscale() lost
its rownames. The example also lost the labels.
o R CMD check assumed 'tar' was GNU tar and so supported -z.
o read.table() was not handing escaped quotes inside quoted fields
in the first five lines of the file. (PR#7789)
It was also not handling correctly EOF in the first five lines
when reading from stdin(). (PR#7772)
o 'make uninstall' was incomplete.
o make.packages.html() called by help.start() was failing if
there were installed packages with help titles invalid in the
current locale.
o printCoefmat(signif.legend = FALSE) was non-functional. (PR#7802)
o Some as.date.frame() methods failed because the expression
deparsed into multiple lines. (PR#7808)
o setRepositories() had a typo. (PR#7810)
o Printing arrays/data frames with multibyte characters in the
column labels was sometimes misaligned or using excessive space.
(PR#7803)
o The Tcl/Tk console did not support multibyte characters.
o as.POSIXlt() could give infinite recursion if passed a corrupt
"POSIXct" object (generated by an incorrect call to c.POSIXct,
PR#7826).
o update.packages() was not passing 'type' correctly to
install.packages().
o Printing the result of an unbalanced model.tables() call
sometimes got confused if terms() had rearranged interaction
terms. (PR#7829)
o .Platform$pkgType was wrong on the CRAN MacOS X build, and
.install.macbinary() was missing.
o as.personList() as used by citation() got confused by names
containing "and". (PR#7797)
o Subscripting an array by a matrix containing zero or negative
values or the wrong number of columns was not handled
consistently. (PR#7824)
o select.list(multiple=TRUE) now detects and tries again for invalid
text input.
o add1.[g]lm could give strange results with interaction terms
when the model and the upper scope had different orders for
the main effects. (PR#7842)
o A bug had sneaked into the anova.mlmlist() code, affecting the
Greenhouse-Geisser epsilon. Code wrongly assumed a matrix to
be symmetric. (Thanks to Bela Bauer.)
o anova.mlmlist() and mauchley.test() are now more tolerant to rank
deficiency in the M and X matrices (also when they are implicitly
generated via model.matrix()).
o anova.mlm had a scoping issue (PR#7898)
o pf() with infinite df is allowed again. It is now more accurate
for extreme ratios of dfs, especially when there is a
non-centrality parameter.
o df() was inaccurate for large df (1e16 or greater).
o dt() was inaccurate for large df (1e9 or greater) with a
non-centrality parameter.
o runmed(*, algorithm="Turlach") seg.faulted in rare cases.
o strwrap() now makes a reasonable job of text that is invalid in the
current locale.
o Reading with encoding "UCS-2LE" will remove any Byte Order
Mark, as most implementations of iconv fail to handle BOMs
(which are present in 'Windows Unicode' files).
o unique() for a list was incorrectly reporting `unimplemented'.
o The parser's contextstack was not protected against overflow,
e.g. more than 50 unmatched '('. (PR#7859)
o source(file, chdir = TRUE) was not checking that 'file' was a
filepath (rather than a URL). For 2.1.0 only, it did not work
even if 'file' was a filepath.
o Hershey fonts were being sized based on pixels not points so came
out too small on devices where pixels were noticeably different
from points (e.g., win.printer() and high-resolution screens).
Fix means that default size of Hershey fonts may be slightly
different, for example, smaller by default on PostScript and PDF.
o The branch cuts in the complex versions of the inverse
trigonometric and hyperbolic functions were non-standard.
(PR#7871)
o truncate() on file() connections was limited to files < 2Gb. It
now works for larger files at least on 64-bit OSes and others
where ftruncate supports such files. (Related to PR#7879)
o proj.aovlist() did not work correctly on objects fitted from a
data frame with row names.
o The coding standards recommendations had
nuke-trailing-whitespace where newer versions of ESS need
ess-nuke-trailing-whitespace. (PR#7888)
o package.skeleton() missed the first newline in the DESCRIPTION file.
o pbirthday() reported p = 1 too often when coincident > 2.
o plot(1:3, exp(1:3), log = "y", ylim = c(30,1)) {reversed
log-scale axis} now works, based on Uwe Ligges' suggestions.
(PR#7894)
o install.packages() was aborting when a package in a bundle was
chosen from a menu. It failed if more than one package in a
bundle was chosen from the command line.
o qcauchy() suffered from underflow in the extreme tails. (PR#7902)
o Printing of raw matrices/arrays was not implemented. (PR#7912)
o getCallingDLL()'s default first argument did not correspond to
its description and has been changed. The mismatch caused
symbols in .C/.Call/.Fortran calls without a PACKAGE= argument
to be potentially looked up in the wrong name space.
o Binary save() of raw vectors was not working correctly on
big-endian platforms. (PR#7812)
o as.Date.factor() now accepts a format argument.
o Workaround added for FreeBSD which does not have alloca.h _and_
does not allow alloca() to be declared.
o identify() now respects 'cex'. (PR#660)
Warnings from identify() are now printed immediately even on
consoles with delayed printing.
CHANGES IN R VERSION 2.1.0
USER-VISIBLE CHANGES
o box plots {by boxplot() or bxp()} now have the median line three
times the normal line width in order to distinguish it from the
quartile ones.
o Unix-alike versions of R can now be used in UTF-8 locales on
suitably equipped OSes. See the internationalization section
below.
o The meaning of 'encoding' for a connection has changed: See the
internationalization section below.
o There has been some rationalization of the format of
warning/error messages, to make them easier to translate.
Generally names of functions and arguments are single-quoted,
and classes double-quoted.
o Reading text files with embedded "\" (as in Windows file names)
may now need to use scan(* , allowEscapes = FALSE), see also below.
NEW FEATURES
o %% now warns if its accuracy is likely to be affected by lack
of precision (as in 1e18 %% 11, the unrealistic expectation of
PR#7409), and tries harder to return a value in range when it is.
o abbreviate() now warns if used with non-ASCII chars, as the
algorithm is designed for English words.
o The default methods for add1() and drop1() check for changes
in the number of cases in use.
The "lm" and "glm" methods for add1() quoted the <none> model
on the original fitted values when using (with a warning) a
smaller set of cases for the expanded models.
o Added alarm() function to generate a bell or beep or visual alert.
o all/any() now attempt to coerce their arguments to logical, as
documented in the Blue Book. This means e.g. any(list()) works.
o New functions for multivariate linear models: anova.mlm(),
SSD(), estVar(), mauchley.test() (for sphericity).
vcov() now does something more sensible for "mlm" class objects.
o as.data.frame.table() has a new argument 'responseName'
(contributed by Bill Venables).
o as.dist() and cophenetic() are now generic, and the latter has a
new method for objects of class "dendrogram".
o as.ts() is now generic.
o binomial() has a new "cauchit" link (suggested by Roger Koenker).
o chisq.test() has a new argument 'rescale.p'. It is now possible
to simulate (slowly) the P value also in the 1D case
(contributed by Rolf Turner).
o choose(n,k) and lchoose(.) now also work for arbitrary (real) n
in accordance with the general binomial theorem. choose(*,k)
is more accurate (and faster) for small k.
o Added colorRamp() and colorRampPalette() functions for color
interpolation.
o colSums()/rowSums() now allow arrays with a zero-length extent
(requested by PR#7775).
o confint() has stub methods for classes "glm" and "nls" that
invoke those in package MASS. This avoids using the "lm"
method for "glm" objects if MASS is not attached.
confint() has a default method using asymptotic normality.
o contr.SAS() has been moved from the 'nlme' package to the
'stats' package.
o New function convertColors() maps between color spaces.
colorRamp() uses it.
o The cov() function in the non-Pearson cases now ranks data after
removal of missing values, not before. The pairwise-complete
method should now be consistent with cor.test. (Code
contributed by Shigenobu Aoki.)
o Added delayedAssign() function to replace delay(), which is now
deprecated.
o dir.create() has a new argument 'recursive' serving the same
purpose as Unix's mkdir -p.
o do.call() now takes either a function or a character string as
its first argument. The supplied arguments can optionally be
quoted.
o duplicated() and unique() now accept "list" objects, but are
fast only for simple list objects.
o ecdf() now has jumps of the correct size (a multiple of 1/n)
if there are ties. (Wished by PR#7292).
o eff.aovlist() assumed orthogonal contrasts for any term
with more than one degree of freedom: this is now documented
and checked for. Where each term only occurs in only one
stratum the efficiencies are all one: this is detected and
orthogonal contrasts are not required.
o New function encodeString() to encode character strings in the
same way that printing does.
o file("clipboard") now work for reading the primary selection on
Unix-alikes with an active X11 display. (It has long worked
for reading and writing under Windows.) The secondary
selection can also be read: see ?file.
file() now allows mode "w+b" as well as "w+".
o file.append() has been tuned, including for the case of
appending many files to a single file.
o Functions flush.console() and select.list() are now available
on all platforms. There is a Tcl/Tk-based version of
select.list() called tk_select.list() in package tcltk.
o gc() now reports maximum as well as current memory use.
o A new function getGraphicsEvent() has been added which will allow
mouse or keyboard input from a graphics device. (NB: currently
only the Windows screen device supports this function. This
should improve before the 2.1.0 release.)
o New functions gray.colors()/grey.colors() for gray color
palettes.
o grep(), gsub(), sub() and regexpr() now always attempt to
coerce their 'pattern', 'x', 'replacement' and 'text'
arguments to character. Previously this was undocumented but
done by [g]sub() and regexpr() for some values of their
other arguments. (Wish of PR#7742.)
o gsub/sub() have a new 'fixed' method.
o New function hcl() for creating colors for a given hue,
chroma and luminance (i.e. perceptual hsv).
o isTRUE() convenience function to be used for programming.
o kmeans() now returns an object of class "kmeans" which has a
print() method.
Two alternative algorithms have been implemented.
If the number of centres is supplied, it has a new option of
multiple random starts.
o The limits on the grid size in layout() are now documented, and
have been raised somewhat by using more efficient internal
structures.
o legend() now accepts positioning by keyword, e.g. "topleft",
and can put a title within the legend. (Suggested by Elizabeth
Purdom in PR#7400.)
o mahalanobis() now has a '...' argument which is passed to solve()
for computing the inverse of the covariance matrix, this replaces
the former 'tol.inv' argument.
o menu() uses a multi-column layout if possible for more than
10 choices.
menu(graphics = TRUE) is implemented on most platforms via
select.list() or tk_select.list().
o New function message() in 'base' for generating "simple"
diagnostic messages, replacing such a function in the
'methods' package.
o na.contiguous() is now (S3) generic with first argument
renamed to 'object'.
o New function normalizePath() to find canonical paths (and on
Windows, canonical names of components).
o The default in options("expressions") has been increased to 5000,
and the maximal settable value to 500000.
o p.adjust() has a new method "BY".
o pbeta() now uses a different algorithm for large values of at
least one of the shape parameters, which is much faster and is
accurate and reliable for very large values. (This affects
pbinom(), pf(), qbeta() and other functions using pbeta at C
level.)
o pch="." now by default produces a rectangle at least 0.01" per
side on high-resolution devices. (It used to be one-pixel
square even on high-resolution screens and Windows printers,
but 1/72" on postscript() and pdf() devices.) Additionally,
the size is now scalable by 'cex'; see ?points and note that
the details are subject to change.
o pdf() now responds to the 'paper' and 'pagecentre'
arguments. The default value of 'paper' is "special"
for backward-compatibility (this is different from the
default for postscript()).
o plot.data.frame() tries harder to produce sensible plots for
non-numeric data frames with one or two columns.
o The predict() methods for "prcomp" and "princomp" now match
the columns of 'newdata' to the original fit using column
names if these are available.
o New function recordGraphics() to encapsulate calculations
and graphics output together on graphics engine display list.
To be used with care.
o New function RSiteSearch() to query R-related resources
on-line (contributed by Jonathan Baron and Andy Liaw).
o scan() arranges to share storage of duplicated character
strings read in: this can dramatically reduce the memory
requirements for large character vectors which will
subsequently be turned into factors with relatively few
levels. For a million items this halved the time and reduced
storage by a factor of 20.
scan() has a new argument 'allowEscapes' (default TRUE) that
controls when C-style escapes in the input are interpreted.
Previously only \n and \r were interpreted, and then only
within quoted strings when no separator was supplied.
scan() used on an open connection now pushes back on the
connection its private `ungetc' and so is safer to use to
read partial lines.
o scatter.smooth() and loess.smooth() now handle missing values
in their inputs.
o seq.Date() and seq.POSIXt() now allow 'to' to be before 'from'
if 'by' is negative.
o sprintf() has been enhanced to allow the POSIX/XSI specifiers
like "%2$6d", and also accepts "%x" and "%X".
sprintf() does limited coercion of its arguments.
sprintf() accepts vector arguments and operates on them in
parallel (after re-cycling if needed).
o New function strtrim() to trim character vectors to a display
width, allowing for double-width characters in multi-byte
character sets.
o subset() now has a method for matrices, similar to that for
data frames.
o Faster algorithm in summaryRprof().
o sunflowerplot() has new arguments 'col' and 'bg'.
o sys.function() now has argument 'which' (as has long been
presaged on its help page).
o Sys.setlocale("LC_ALL", ) now only sets the locale categories
which R uses, and Sys.setlocale("LC_NUMERIC", ) now gives a
warning (as it can cause R to malfunction).
o unclass() is no longer allowed for environments and external
pointers (since these cannot be copied and so unclass() was
destructive of its argument). You can still change the
"class" attribute.
o File-name matching is no longer case-insensitive with unz()
connections, even on Windows.
o New argument 'immediate.' to warning() to send an immediate
warning.
o New convenience wrappers write.csv() and write.csv2().
o There is a new version for write.table() which is implemented in C.
For simple matrices and data frames this is several times
faster than before, and uses negligible memory compared to the
object size.
The old version (which no longer coerces a matrix to a data
frame and then back to a matrix) is available for now as
write.table0().
o The functions xinch(), yinch(), and xyinch() have been moved
from package 'grDevices' into package 'graphics'.
o Plotmath now allows underline in expressions. (PR#7286,
contributed by Uwe Ligges.)
o BATCH on Unix no longer sets --gui="none" as the X11 module
is only loaded if needed.
o The X11 module (and the hence X11(), jpeg() and png() devices
and the X-based dataentry editor) is now in principle
available under all Unix GUIs except --gui="none", and this is
reflected in capabilities().
capabilities("X11") determines if an X server can be accessed,
and so is more likely to be accurate.
o Printing of arrays now honours the 'right' argument if there
are more than two dimensions.
o Tabular printing of numbers now has headers right-justified, as
they were prior to version 1.7.0 (spotted by Rob Baer).
o Lazy-loading databases are now cached in memory at first use:
this enables R to run much faster from slow file systems such
as USB flash drives. There is a small (less than 2Mb)
increase in default memory usage.
o The implicit class structure for numeric vectors has been
changed, so that integer/real vectors try first methods for
class "integer"/"double" and then those for class "numeric".
The implicit classes for matrices and arrays have been changed
to be "matrix"/"array" followed by the class(es) of the
underlying vector.
o splines::splineDesign() now allows the evaluation of a B-spline
basis everywhere instead of just inside the "inner" knots, by
setting the new argument `outer.ok = TRUE'.
o Hashing has been tweaked to use half as much memory as before.
o Readline is not used for tilde expansion when R is run with
--no-readline, nor from embedded applications. Then "~name"
is no longer expanded, but "~" still is.
o The regular expression code is now based on that in glibc 2.3.3.
It has stricter conformance to POSIX, so metachars such as
{ } + * may need to be escaped where before they did not
(but could have been).
o New encoding 'TeXtext.enc' improves the way postscript() works
with Computer Modern fonts.
o Replacement in a non-existent column of a data frame tries
harder to create a column of the correct length and so avoid a
corrupt data frame.
o For Windows and readline-based history, the saved file size is
re-read from R_HISTSIZE immediately before saving.
o Collected warnings during start-up are now printed before the
initial prompt rather than after the first command.
o Changes to package 'grid':
- preDrawDetails(), drawDetails(), and postDrawDetails()
methods are now recorded on the graphics engine
display list. This means that calculations within these
methods are now run when a device is resized or
when output is copied from one device to another.
- Fixed bug in grid.text() when 'rot' argument has length 0.
(privately reported by Emmanuel Paradis)
- New getNames() function to return just the names of all top-level
grobs on the display list.
- Recording on the grid display list is turned off within
preDrawDetails(), drawDetails(), and postDrawDetails() methods.
- Grid should recover better from errors or user-interrupts
during drawing (i.e., not leave you in a strange viewport
or with strange graphical parameter settings).
- New function grid.refresh() to redraw the grid display list.
- New function grid.record() to capture calculations
with grid graphics output.
- grobWidth and grobHeight ("grobwidth" and "grobheight" units)
for primitives (text, rects, etc, ...) are now
calculated based on a bounding box for the relevant grob.
NOTE: this has changed the calculation of the size of a scalar
rect (or circle or lines).
- New arguments 'warn' and 'wrap' for function grid.grab()
- New function grid.grabExpr() which captures the output from
an expression (i.e., not from the current scene) without
doing any drawing (i.e., no impact on the current scene).
- upViewport() now (invisibly) returns the path that it goes up
(suggested by Ross Ihaka).
- The 'gamma' gpar has been deprecated (this is a device property
not a property of graphical objects; suggested by Ross Ihaka).
- New 'lex' gpar; a line width multiplier.
- grid.text() now handles any language object as mathematical
annotation (instead of just expressions).
- plotViewport() has default value for 'margins' argument (that match
the default value for par(mar)).
- The 'extension' argument to dataViewport() can now be vector,
in which case the first value is used to extend the xscale and
the second value is used to extend the y scale.
(suggested by Ross Ihaka).
- All 'just' arguments (for viewports, layouts, rectangles, text)
can now be numeric values (typically between 0 [left] and 1 [right])
as well as character values ("left", "right", ...).
For rectangles and text, there are additional 'hjust' and 'vjust'
arguments which allow numeric vectors of justification in
each direction (e.g., so that several pieces of text can have
different justifications).
(suggested by Ross Ihaka)
- New 'edits' argument for grid.xaxis() and grid.yaxis() to
allow specification of on-the-fly edits to axis children.
- applyEdit(x, edit) returns x if target of edit (i.e., child
specified by a gPath) cannot be found.
- Fix for calculation of length of max/min/sum unit. Length is
now (correctly) reported as 1 (was reported as length of first arg).
- Viewport names can now be any string (they used to have to be a
valid R symbol).
- The 'label' argument for grid.xaxis() and grid.yaxis() can now
also be a language object or string vector, in which case it
specifies custom labels for the tick marks.
INTERNATIONALIZATION
o Unix-alike versions of R can now be used in UTF-8 and other
multi-byte locales on suitably equipped OSes if configured
with option --enable-mbcs (which is the default). [The
changes to font handling in the X11 module are based on the
Japanization patches of Ei-ji Nakama.]
Windows versions of R can be used in `East Asian' locales on
suitable versions of Windows.
See the 'Internationalization' chapter in the 'Installation
and Administration' manual.
o New command-line flag --encoding to specify the encoding to
be assumed for stdin (but not for a console).
o New function iconv() to convert character vectors between
encodings, on those OSes which support this. See the new
capabilities("iconv").
o The meaning of 'encoding' for a connection has changed: it now
allows any charset encoding supported by iconv on the
platform, and can re-encode output as well as input.
As the new specification is a character string and the old was
numeric, this should not cause incorrect operation.
o New function localeToCharset() to find/guess encoding(s) from
the locale name.
o nchar() returns the true number of bytes stored (including any
embedded nuls), this being 2 for missing values. It has an
optional argument 'type' with possible non-default values
"chars" and "width" to give the number of characters or the
display width in columns.
o Characters can be entered in hexadecimal as e.g. \x9c, and in
UTF-8 and other multibyte locales as \uxxxx, \u{xxxx},
\Uxxxxxxxx or \U{xxxxxxxx}. Non-printable Unicode characters
are displayed C-style as \uxxxx or \Uxxxxxxxx.
o LC_MONETARY is set to the locale, which affects the result of
Sys.localeconv(), but nothing else in R itself. (It could
affect add-on packages.)
o source() now has an 'encoding' argument which can be used to
make it try out various possible encodings. This is made use
of by example() which will convert (non-UTF-8) Latin-1 example
files in a UTF-8 locale.
o read/writeChar() work in units of characters, not bytes.
o .C() now accepts an ENCODING= argument where re-encoding is
supported by the OS. See `Writing R Extensions'.
o delimMatch (tools) now reports match positions and lengths in
units of characters, not bytes. The delimiters can be
strings, not just single ASCII characters.
o .Rd files can indicate via a \encoding{} argument the encoding
that should be assumed for non-ASCII characters they contain.
o Phrases in .Rd files can be marked by \enc{}{} to show a
transliteration to ASCII for use in e.g. text help.
o The use of 'pch' in points() now allows for multi-byte character
sets: in such a locale a glyph can either be specified as a
multi-byte single character or as a number, the Unicode point.
o New function l10n_info() reports on aspects of the
locale/charset currently in use.
o scan() is now aware of double-byte locales such as Shift-JIS
in which ASCII characters can occur as the second ('trail')
byte.
o Functions sQuote() and dQuote() use the Unicode directional
quotes if in a UTF-8 locale.
o The infrastructure is now in place for C-level error and warning
messages to be translated and used on systems with Native
Language Support. This has been used for the startup message
in English and to translate Americanisms such as 'color' into
English: translations to several other languages are under
way, and some are included in this release.
See 'Writing R Extensions' for how to make use of this in a
package: all the standard packages have been set up to do
translation, and the 'language' 'en@quot' is implemented to
allow Unicode directional quotes in a UTF-8 locale.
o R-level stop(), warning() and message() messages can be
translated, as can other messages via the new function
gettext(). Tools xgettext() and xgettext2pot() are provided in
package tools to help manage error messages.
gettextf() is a new wrapper to call sprintf() using
gettext() on the format string.
o Function ngettext() allows the management of singular and
plural forms of messages.
UTILITIES
o New functions mirror2html() and checkCRAN().
o R CMD check has a new option '--use-valgrind'.
o R CMD check now checks that Fortran and C++ files have LF
line endings, as well as C files. It also checks Makevars[.in]
files for portable compilation flags.
o R CMD check will now work on a source tarball and prints out
information about the version of R and the package.
o tools:::.install_package_code_files() (used to collate R files
when installing packages) ensures files are separated by a
line feed.
o vignette() now returns an object of class "vignette" whose
print() method opens the corresponding PDF file. The edit()
method can be used to open the code of the vignette in an
editor.
o R CMD INSTALL on Unix has a new option '--build' matching
that on Windows, to package as tarball the installed package.
o R CMD INSTALL on Unix can now install binary bundles.
o R CMD build now changes src files to LF line endings if necessary.
o R CMD build now behaves consistently between source and binary
builds: in each case it prepares a source directory and then
either packages that directory as a tarball or calls R CMD
INSTALL --build on the prepared sources.
This means that R CMD build --binary now respects
.Rbuildignore and will rebuild vignettes (unless the option
--no-vignettes is used). For the latter, it now installs the
current sources into a temporary library and uses that version
of the package/bundle to rebuild the vignettes.
o R CMD build now reports empty directories in the source tree.
o New function write_PACKAGES() in package 'tools' to help with
preparing local package repositories. (Based on a contribution
by Uwe Ligges.) How to prepare such repositories is
documented in the 'R Installation and Administration' manual.
o package.skeleton() adds a bit more to DESCRIPTION.
o Sweave changes:
- \usepackage[nogin]{Sweave} in the header of an Sweave file
supresses auto-setting of the graphical parameter like width
of graphics.
- The new \SweaveInput{} command works similar to LaTeX's
\input{} command.
- Option value strip.white=all strips all blank lines from the
output of a code chunk.
- Code chunks with eval=false are commented out by Stangle() and
hence no longer tested by R CMD check.
DOCUMENTATION
o File doc/html/faq.html no longer exists, and doc/manual/R-FAQ.html
(which has active links to other manuals) is used instead.
(If makeinfo >= 4.7 is not available, the version on CRAN is
linked to.)
o Manual 'Writing R Extensions' has further details on writing
new front-ends for R using the new public header files.
o There are no longer any restrictions on characters in the
\name{} field of a .Rd file: in particular _ is supported.
C-LEVEL FACILITIES
o There are new public C/C++ header files Rinterface.h and
R_ext/RStartup.h for use with external GUIs.
o Added an onExit() function to graphics devices, to be executed
upon user break if non-NULL.
o ISNAN now works even in C++ code that undefines the 'isnan' macro.
o R_alloc's limit on 64-bit systems has been raised from just
under 2^31 bytes (2Gb) to just under 2^34 (16Gb), and is now checked.
o New math utility functions log1pmx(x), lgamma1p(x),
logspace_add(logx, logy), and logspace_sub(logx, logy).
DEPRECATED & DEFUNCT
o The aqua module for MacOS X has been removed: --with-aqua now
refers to the unbundled Cocoa GUI.
o Capabilities "bzip2", "GNOME", "libz" and "PCRE" are defunct.
o The undocumented use of UseMethod() with no argument was
deprecated in 2.0.1 and is now regarded as an error.
o Capability "IEEE754" is deprecated.
o The 'CRAN' argument to update.packages(), old.packages(),
new.packages(), download.packages() and install.packages() is
deprecated in favour of 'repos', which replaces it as a
positional argument (so this is only relevant for calls with
named args).
o The S3 methods for getting and setting names of "dist" objects
have been removed (as they provided names with a different
length from the "dist" object itself).
o Option "repositories" is no longer used and so not set.
o loadURL() is deprecated in favour of load(url()).
o delay() is deprecated. Use delayedAssign() instead.
INSTALLATION CHANGES
o New configure option --enable-mbcs to enable support for
UTF-8 locales, on by default.
o R_XTRA_[CF]FLAGS are now used during the configuration tests,
and [CF]PICFLAGS if --enable-R-shlib was specified. This
ensures that features such as inlining are only used if the
compilation flags specified support them. (PR#7257)
o Files FAQ, RESOURCES, doc/html/resources.html are no longer in
the SVN sources but are made by 'make dist'.
o The GNOME GUI is unbundled, now provided as a package on CRAN.
o Configuring without having the recommended packages is now an
error unless --with-recommended-packages=no (or equivalent) is used.
o Configuring without having the X11 headers and libraries is now
an error unless --with-x=no (or equivalent) is used.
o Configure tries harder to find a minimal set of FLIBS. Under
some circumstances this may remove from R_LD_LIBRARY_PATH
path elements that ought to have specified in LDFLAGS (but
were not).
o The C code for most of the graphics device drivers and their
afm files are now in package grDevices.
o R is now linked against ncurses/termlib/termcap only if
readline is specified (now the default) and that requires it.
o Makeinfo 4.7 or later is now required for building the HTML and
Info versions of the manuals.
PACKAGE INSTALLATION CHANGES
o There are new types of packages, identified by the Type field
in the DESCRIPTION file. For example the GNOME console is now
a separate package (on CRAN), and translations can be
distributed as packages.
o There is now support of installing from within R both source and
binary packages on MacOS X and Windows. Most of the R
functions now have a 'type' argument defaulting to
getOption("pkgType") and with possible values "source",
"win.binary" and "mac.binary". The default is "source" except
under Windows and the CRAN GUI build for MacOS X.
o install.packages() and friends now accept a vector of URLs for
'repos' or 'contriburl' and get the newest available version of
a package from the first repository on the list in which it is
found. The argument 'CRAN' is still accepted, but deprecated.
install.packages() on Unix can now install from local .tar.gz
files via repos = NULL (as has long been done on Windows).
install.packages() no longer asks if downloaded packages
should be deleted: they will be deleted at the end of the
session anyway (and can be deleted by the user at any time).
If the repository provides the information, install.packages()
will now accept the name of a package in a bundle.
If 'pkgs' is omitted install.packages() will use a listbox to
display the available packages, on suitable systems.
'dependencies' can be a character vector to allow only some
levels of dependencies (e.g. not "Suggests") to be requested.
o There is a new possible value update.packages(ask="graphics")
that uses a widget to (de)select packages, on suitable systems.
o The option used is now getOption("repos") not getOption("CRAN")
and it is initially set to a dummy value. Its value can be a
character vector (preferably named) giving one or several
repositories.
A new function chooseCRANmirror() will select a CRAN mirror.
This is called automatically if the contrib.url() encounters
the initial dummy value of getOption("repos")
A new function setRepositories() can be used to create
getOption("repos") from a (platform-specific) list of known
repositories.
o New function new.packages() to report uninstalled packages
available at the requested repositories. This also reports
incomplete bundles. It will optionally install new packages.
o New function available.packages(), similar to CRAN.packages()
but for use with multiple repositories. Both now only report
packages whose R version requirements are met.
o update.packages() and old.packages() have a new option
'checkBuilt' to allow packages installed under earlier
versions of R to be updated.
o remove.packages() can now remove bundles.
o The Contains: field of the DESCRIPTION file of package bundles
is now installed, so later checks can find out if the bundle
is complete.
o packageStatus() is now built on top of *.packages, and gains a
'method' argument. It defaults to the same repositories as
the other tools, those specified by getOption("repos").
BUG FIXES
o Configuring for Tcl/Tk makes use of ${TK_LIB_SPEC} ${TK_LIBS}
not ${TK_LIB_SPEC} ${TK_XLIBSW}, which is correct for
recent versions of Tk, but conceivably not for old
tkConfig.sh files.
o detach() was not recomputing the S4 methods for primitives
correctly.
o Methods package now has class "expression" partly fixed in basic
classes, so S4 classes can extend these (but "expression" is
pretty broken as a vector class in R).
o Collected warnings had messages with unneeded trailing space.
o S4 methods for primitive functions must be exported from
name spaces; this is now done automatically.
Note that is.primitive() is now in "base", not "methods".
o Package grid:
- Fixed bug in grid.text() when "rot" argument has length 0.
(reported by Emmanuel Paradis)
o .install_package_vignette_index() created an index even in an
empty 'doc' directory.
o The print() method for factors now escapes characters in the
levels in the same way as they are printed.
o str() removed any class from environment objects.
str() no longer interprets control characters in character
strings and factor levels; also no longer truncates factor
levels unless they are longer than 'nchar.max'.
Truncation of such long strings is now indicated ''outside''
the string.
str(<S4.object>) was misleading for the case of a single slot.
str() now also properly displays S4 class definitions (such as
returned by getClass().
o print.factor(quote=TRUE) was not quoting levels, causing
ambiguity when the levels contained spaces or quotes.
o R CMD check was confused by a trailing / on a package name.
o write.table() was writing incorrect column names if the data
frame contained any matrix-like columns.
o write.table() was not quoting row names for a 0-column x.
o t(x)'s default method now also preserves names(dimnames(x)) for
1D arrays 'x'.
o r <- a %*% b no longer produces names(dimnames(r)) == c("", "")
unless one of a or b has named dimnames.
o Some .Internal functions that were supposed to return invisibly
did not. This was behind PR#7397 and PR#7466.
o eval(expr, NULL, encl) now looks up variables in encl, as
eval(expr, list(), encl) always did
o Coercing as.data.frame(NULL) to a pairlist caused an error.
o p.adjust(p, ..) now correctly works when `p' contains NAs (or when
it is of length 0 or length 2 for method = "hommel").
o 'methods' initialization was calling a function intended for
.Call() with .C().
o optim() needed a check that the objective function returns a
value of length 1 (spotted by Ben Bolker).
o X11() was only scaling its fonts to pointsize if the dpi
was within 0.5 of 100dpi.
o X11() font selection was looking for any symbol font, and
sometimes got e.g. bold italic if the server has such a font.
o dpois(*, lambda=Inf) now returns 0 (or -Inf for log).
o Using pch="" gave a square (pch=0)! Now it is regarded as the
same as NA, which was also undocumented but omits the point.
o Base graphics now notices (ab)lines which have a zero
coordinate on log scale, and omits them. (PR#7559)
o stop() and warning() now accept NULL as they are documented
to do (although this seems of little use and is equivalent to "").
o weighted.mean() now checks the length of the weight vector w.
o getAnywhere() was confused by names with leading or trailing dots
(spotted by Robert McGehee)
o eval() was not handling values from return() correctly.
o par(omd) is now of the form c(x1, x2, y1, y2) to match the
documentation and for S-PLUS compatibility.
[Previously, par(omd) was of the form c(bottom, left, top, right)
like par(oma) and par(omi)]
o formatC() did not check its 'flag' argument, and could
segfault if it was incorrect. (PR#7686)
o Contrasts needed to be coerced to numeric (e.g. from integer)
inside model.matrix. (PR#7695)
o socketSelect() did not check for buffered input.
o Reads on a non-blocking socket with no available data were
not handled properly and could result in a segfault.
o The "aovlist" method for se.contrast() failed in some very
simple cases that were effectively not multistratum designs,
e.g. only one treatment occurring in only one stratum.
o pgamma() uses completely re-written algorithms, and should work
for all (even very extreme) arguments; this is based on Morten
Welinder's contribution related to PR#7307.
o dpois(10, 2e-308, log=TRUE) and similar cases gave -Inf.
o x <- 2^(0:1000); plot(x, x^.9, type="l", log="xy")# and
x <- 2^-(1070:170); plot(x, x^.9, type="l", log="xy")# now both work
o summary.lm() asked for a report on a reasonable occurrence, but
the check failed to take account of NAs.
o lm() was miscalculating 'df.residual' for empty models with a
matrix response.
o summary.lm() now behaves more sensibly for empty models.
o plot.window() was using the wrong sign when adjusting
xlim/ylim for positive 'asp' and a reversed axis.
o If malloc() fails when allocating a large object the allocator now
does a gc and tries the malloc() again.
o packageSlot() and getGroupMembers() are now exported from the
'methods' package as they should from documentation and the
Green Book.
o rhyper() was giving numbers slightly too small, due to a bug in the
original algorithm. (PR#7314)
o gsub() was sometimes incorrectly matching ^ inside a string,
e.g. gsub("^12", "x", "1212") was "xx".
o [g]sub(perl = TRUE) was giving random results for a 0-length
initial match. (PR#7742)
o [g]sub was ignoring most 0-length matches, including all initial
ones. Note that substitutions such as gsub("[[:space:]]*", "
", ...) now work as they do in 'sed' (whereas the effect was
previously the same as gsub("[[:space:]]+", " ", ...)).
(In part PR#7742)
o Promises are now evaluated when extracted from an environment
using '$' or '[[ ]]'.
o reshape(direction="wide") had some sorting problems when
guessing time points (PR#7669)
o par() set 'xaxp' before 'xlog' and 'yaxp' before 'ylog',
causing PR#831.
o The logic in tclRequire() to check the availability of a Tcl
package turned out to be fallible. It now uses a try()-and-see
mechanism instead.
o Opening a unz() connection on a non-existent file left a file
handle in use.
o "dist" objects of length 0 failed to print.
o INSTALL and the libR try harder to find a temporary directory
(since there might be one left over with the same PID).
o acf() could cause a segfault with some datasets. (PR#7771)
o tan(1+LARGEi) now gives 0+1i rather than 0+NaNi (PR#7781)
o summary(data.frame(mat = I(matrix(1:8, 4)))) does not go into
infinite recursion anymore.
o writeBin() performed byte-swapping incorrectly on complex
vectors, also swapping real and imaginary parts. (PR#7778)
o read.table() sometimes discarded as blank lines containing
only white space, even if sep=",".
**************************************************
* *
* 2.0 SERIES NEWS *
* *
**************************************************
CHANGES IN R VERSION 2.0.1 patched
NEW FEATURES
o warnings() now looks only in the workspace for `last.warning'
(suggested by PR#7363).
o The search for browsers now starts with firefox, and has mozilla
ahead of netscape.
PACKAGE INSTALLATION CHANGES
o A package DESCRIPTION file which contains a Built field (it
should not!) is now worked around, with loud warnings.
BUG FIXES
o split() was accepting raw and list vectors as input, but
not populating the output correctly.
split() now handles vectors with names internally and so is
almost as fast as on vectors without names (and maybe 100x
faster than before).
o subset() now throws an error if its 'subset' argument is not
logical whereas it could appear to work and give wrong answers
with e.g. a numeric 'subset' argument.
o sum(), max(), min(), prod(), any() and all() were incorrectly
using partial matching for their na.rm argument.
o kmeans() now ensures that the initial cluster centers it chooses
are distinct.
o text()'s default method could segfault if passed 0-length coordinates.
o R CMD INSTALL (Unix) was sometimes leaving a temporary dir
behind. (PR#7230)
o read.table() could fail when the row.names were looking like numbers.
o seq(length= <n>) now always returns "integer" storage.
o labels.lm was broken. (PR#7417)
o The hashing used for character vectors in object.size() was
inefficient for vectors with thousands of identical values not
sharing the same storage (an unusual case).
o data.matrix() now warns if applied to a data frame with
classed columns.
o Plotting histograms where the expression used to deparse to
multiple lines now gives a sensible default title. (PR#7421)
o The print method for getDLLRegisteredRoutines() was badly
designed, and failed for all the standard packages' DLLs.
o getDLLRegisteredRoutines.character() was broken.
o write.table(x, row.names=FALSE) was incorrect for a 0-column x.
o write.table() assumed dec = "," if it was not ".".
o morley.tab used by R-intro was not installed on Unix since 2.0.0
(it was on Windows).
o gsub(perl=TRUE) returned a string which printed with trailing
garbage if there was a match at the beginning whose
replacement was shorter. (PR#7479)
Similarly, the result was truncated if a replacement at the
beginning was longer.
o Some PDF readers do not define PDFDocEncoding, so pdf()'s
ISOLatin1 encoding is now derived from WinAnsi rather than
PDFDocEncoding.
o xfig() had not been updated for the 2.0.0 alpha changes.
Using more than one plot with a non-white background and with
onefile=FALSE could segfault.
o sprintf() did not check for buffer overflow on character
strings. (PR#7554)
o The error message when evaluation depth was exceeded itself
caused an error in deparsing and so was not shown.
o The 'datalist' file was not being used during installation
(2.0.1 only).
o replications() was wrongly reporting lack of balance in
designs with interactions (and had since unique() gained a
matrix method).
CHANGES IN R VERSION 2.0.1
NEW FEATURES
o Platform equivalence in library() is tested by a new function
testPlatformEquivalence() which ignores the 'vendor' field and
can be customized by cognescenti.
o The assignment form of split() allows recycling of vectors
within the value list. In particular, things like
split(x, g) <- lapply(split(x, g), mean)
now work
DOCUMENTATION
o Manual `Writing R Extensions' has new sections on writing
portable packages and on writing new front-ends for R -- the
latter will be more comprehensive in R 2.1.0 which has new
public header files.
DEPRECATED & DEFUNCT
o The aqua module in MacOS X is deprecated.
o Capabilities "bzip2", "GNOME", "libz" and "PCRE" are deprecated.
o The GNOME GUI on Unix-alikes is deprecated as part of R;
it will be available in another form as from R 2.1.0.
o The undocumented use of UseMethod() with no argument is now
formally deprecated.
INSTALLATION CHANGES
o Building on Alpha OSF/1 no longer forces the C flag -std1,
which appears to be no longer needed. (PR#7257)
o The compiler flag -mieee-fp is no longer used on i386 Linux
(these days it is only passed to the linker and was only
invoked for compilation steps).
o -D__NO_MATH_INLINES is only used on older ix86 glibc-based
systems which need it (tested at configure time). This leads to
small improvements in speed and accuracy on modern systems.
o If makeinfo >= 4.5 is not available, warnings are given that
some of the HTML manuals will be missing, and the index page
given by help.start() will link to CRAN versions of those manuals.
o Files aclocal.m4 and acinclude.m4 used in maintainer builds
are not longer included in the distribution.
C-LEVEL FACILITIES
o It was not clear in 'Writing R Extensions' that some of the
entry points in the 'Utilities' section were not declared in
<R.h> (they were in <R_ext/Applic.h>). Now all the entry
points in that section are declared in <R_ext/Utils.h>,
included by <R.h>.
BUG FIXES
o The grid.grab() function in package grid would throw an error
if there were no viewports pushed (now returns NULL).
o model.frame.default() takes row names from the response
variable if that has suitable names and there is no 'data'
argument. (This follows S but was not previously implemented
in R.)
o write.table() was not respecting the 'dec' argument for complex
numbers.
o write.table() printed a mixture of numeric and complex numbers
as all complex. (PR#7260)
o R CMD INSTALL failed with versioned installs on packages which
save images (only).
o dlogis() gave NaN not 0 for large negative arguments.
o Importing from another name space was broken for versioned
installs, incorrectly reporting something like
"package 'imported_from' does not have a name space".
o The GNOME interface under Linux/Unix was broken. (PR#7276)
o For the jpeg/png devices under Linux/Unix, under certain rare
circumstances clipping needed to be cleared before starting a
new page. (PR#7270, which has been the case since the devices
were introduced in 1.1.0.)
o First lattice plot (first grid.newpage() call) did not start
a new page IF there had been a previous traditional graphics
plot (on the same device).
o Using install.packages() to install the same package to more
than one library gave an incorrect warning message. (If there
were two or more such packages it might give an error.)
o .packages(all.available=TRUE) returned packages with an invalid
version field in their DESCRIPTION whereas .find.packages() and
packageDescription() did not. Now all do not.
o packageDescription() now correctly reports that a package does
not exist, rather than that its DESCRIPTION file is 'missing
or broken'.
o 'make dist' from builddir != sourcedir was copying not linking
recommended packages to *.tgz.
o Slots in prototype objects can inherit from locally defined
classes (which were not being found correctly before).
o Several fixes to the behavior of as() when there are either
coerce= or replace= methods supplied in a call to
setIs(). Related fixes to setIs() to handle correctly previous
methods, if there were any.
o splinefun(1[0], 1[0])(1) doesn't segfault anymore (PR#7290).
spline() and splinefun() now also work with missing values by
omiting them.
o ecdf() was failing on inputs containing NAs. (Part of PR#7292)
o tools:::.install_package_description was splitting the Built:
field across lines on platforms with very long names.
o capabilities() was wrong for the Aqua GUI on MacOS X.
o Using Rprof() with a non-writable 'file' argument is now a
non-fatal error and does not abort R.
o binom.test() did not deparse its arguments early enough such
that the reported data were ugly if x was a table.
o Systems based on glibc, including those using R's substitute for
strptime, were handling strptime("2001", "%Y") incorrectly, in
some cases crashing. R's substitute code has been corrected
(but problems may remain if glibc is used). See the ?strptime
for what should happen (which is system-specific).
o untrace() after trace() failed if package 'methods' was attached.
(PR#7301)
o summary.stepfun() was reporting for n > 6 summaries of the
knots and levels as the actual values. Both print() and
summary() methods called the constant values "step heights",
although they were not the heights of the steps.
o is.na/is.nan() were giving spurious warnings if applied to a
raw vector.
o is.atomic() gave incorrect result (false) for a raw vector.
o rank() and order() accepted raw and list inputs, but did not
give a sensible answer (always 1:n). Similarly, partial sorts
of a raw vector were accepted but did nothing.
o require() without a version argument tried for an unversioned
load of a package even though a versioned install was already
loaded. This often led to a message that a required package
was being loaded when it was not actually being loaded.
o str(<S4.object>) made use of attributes() instead of slot(),
and hence didn't properly print NULL slots.
o contrib.url() now handles URLs ending in '/' correctly.
o str() removed any class from externalptr objects.
o logLik() and hence AIC() failed or gave incorrect answers
on "lm" fits with na.action = na.exclude (and perhaps other
na.actions's except na.omit and na.fail).
o pmax() and pmin() sometimes used NAs in internal subassignments,
and sometimes these failed.
o Subassigning an expression, e.g. expr[2] <- 1, could leave an
invalid object and so cause a segfault. (PR#7326)
o download/install.packages() would misbehave if there was more
than one version of a package in a repository.
o sort(partial=) silently ignored some other arguments: using
'decreasing' or 'index.return' or supplying a factor are now
errors.
o The ave() function had trouble if the grouping contained
unused levels.
o read.fwf() got confused by skip > 0 and could infinite loop
under some circumstances. (PR#7350)
o upgrade(x, ask = FALSE) was broken for a "packageStatus" object.
o Class "raw" had been omitted from the list of basic classes in
the "methods" package and so could not be used in S4 classes.
o Function getGroupMembers(), part of the definition of S4
classes, had been promised for release 2.0, but slipped through.
o toLatex(sessionInfo()) produced incorrect LaTeX on some
platforms due to special characters in the platform
identifier.
CHANGES IN R VERSION 2.0.0
USER-VISIBLE CHANGES
o The stub packages from 1.9.x have been removed: the library()
function selects the new home for their code.
o `Lazy loading' of R code has been implemented, and is used for
the standard and recommended packages by default. Rather than
keep R objects in memory, they are kept in a database on disc
and only loaded on first use. This accelerates startup (down
to 40% of the time for 1.9.x) and reduces memory usage -- the
latter is probably unimportant of itself, but reduces
commensurately the time spent in garbage collection.
Packages are by default installed using lazy loading if they
have more than 25Kb of R code and did not use a saved image.
This can be overridden by INSTALL --[no-]lazy or via a field
in the DESCRIPTION file. Note that as with --save, any other
packages which are required must be already installed.
As the lazy-loading databases will be consulted often, R
will be slower if run from a slow network-mounted disc.
o All the datasets formerly in packages 'base' and 'stats' have
been moved to a new package 'datasets'. data() does the
appropriate substitution, with a warning. However, calls to
data() are not normally needed as the data objects are visible
in the 'datasets' package.
Packages can be installed to make their data objects visible
via R CMD INSTALL --lazy-data or via a field in the
DESCRIPTION file.
o Package 'graphics' has been split into 'grDevices' (the graphics
devices shared between base and grid graphics) and 'graphics'
(base graphics). Each of the 'graphics' and 'grid' packages
load 'grDevices' when they are attached. Note that
ps.options() has been moved to grDevices and user hooks may
need to be updated.
o The semantics of data() have changed (and were incorrectly
documented in recent releases) and the function has been moved
to package 'utils'. Please read the help page carefully if
you use the 'package' or 'lib.loc' arguments.
data() now lists datasets, and not just names which data() accepts.
o Dataset 'phones' has been renamed to 'WorldPhones'.
o Datasets 'sunspot.month' and 'sunspot.year' are available
*********************************************************
* *
* News of 1.x.y is in file 'NEWS.1' *
* *
*********************************************************
%%% Local Variables:
%%% mode: text
%%% coding: utf-8
%%% End:
|