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
|
R News
CHANGES IN R 4.5.2:
UTILITIES:
• R CMD check now handles archives with extension .tar or .tar.zstd
(where zstd compression is supported by the R build).
BUG FIXES:
• t.test(c(1:3, Inf)) and similar no longer produce an error but
return a (still not so useful) "htest" result, fixing PR#18901,
thanks to Jesse Alderliesten.
• attr(., "tsp") <- val now uses getOption("ts.eps") instead of
hardwired 1e-5; consequently, ts(.., ts.eps=*) now passes ts.eps
to the "tsp" setting C code; both fixing a long-standing ‘FIXME’.
• insertSource() now ignores the internal .packageName object,
avoiding a superfluous message.
• In static HTML help, links to vignette files from the default
doc/index.html page now also work for packages not installed in
the default .Library, thanks to a report by Patrice Kiener.
• fixInNamespace("<S3method>") failed to update the S3 methods
table when the generic was not on the search path.
• In plain-text help (Rd2txt), an initial newline from an Rd inline
\eqn no longer breaks the paragraph.
• hist(*, log = "x") now works without a warning, thanks to Martin
Smith's PR#18921.
• Subassigning "POSIXlt", i.e., <tdat>[i] <- val and <tdat>[[i]] <-
val now rebalance as they should, thanks to Mikael Jagan's
PR#18919.
• <POSIXlt>[*] (re-)setting "balanced", fixing PR#18681 comment #7,
thanks to Mikael Jagan.
• All four of {col,row}{Sums,Means}(Z, na.rm=TRUE) now correctly
work with complex Z where is.na(Re(Z)) differs from is.na(Im(Z)),
fixing PR#18942, unearthed by Dirk Eddelbuettel.
• Fix for glyph rendering on the quartz() device when there is
other (“normal”) text drawn on the device. The problem was that
the text transformation matrix was not reset so glyphs would be
rendered incorrectly (often completely outside the device, i.e.,
not visible).
• Functions install.packages() and download.packages() again
consult option download.file.method when the download method is
unspecified.
• Tanguy Barthelemy and colleagues at the ‘R Dev Day’ following
Rencontres R in May 2025 extended the help page of lm(), fixing
PR#18058. As suggested by Thomas Soeiro, such notes were also
added to the glm(), poly() and splines::bs() and ns() pages.
• lbeta(1i, 1) now signals an error, as lbeta() is not implemented
for complex, fixing PR#18946 from Ben Bolker and Kasper
Kristensen.
• The Cairo-based SVG device uses pt as the default document unit
also with Cairo >= 1.17.8 (PR#18912).
• pretty(*, eps.correct = 2) has been fixed, e.g., to avoid over 1
million length result for pretty(c(0, 1e-322), eps.correct = 2).
• When "POSIXlt" date-time objects are NA-padded from subsetting or
increasing length in the `[` or `length<-` methods, the
"balanced" attribute is set to NA, now; noted in PR#18681, thanks
to Mikael Jagan.
CHANGES IN R 4.5.1:
NEW FEATURES:
• The internal method of unzip() now follows unzip 6.00 in how it
handles extracted file paths which contain "../". With thanks to
Ivan Krylov.
INSTALLATION:
• Standalone nmath can be built with early-2025 versions of
clang-based compilers such as LLVM clang 20, Apple clang 17 and
Intel icx 2025.0.
• Tcl/Tk 9 can be used to build package tcltk: this has become the
default in some Linux distributions.
BUG FIXES:
• Java detection in javareconf could not detect libjvm.* in the
zero variant of the JDK (PR#18884). All valid variants as of JDK
24u are now supported.
• factanal(.., rotation=*) now correctly updates rotmat, fixing
PR#18886.
• dnbinom(<large>, <muchlarger>, ..) now is 0 correctly, instead of
NaN or Inf sometimes.
• dbinom(<large>, n=Inf, ..) is 0 now correctly, instead of NaN
which also fixes many dnbinom() cases, notably those mentioned in
PR#16727 comment #5.
• Fixing C level “binomial deviance” bd0() for extreme arguments
(preventing under-/overflow) solves more PR#16727 cases and also
prevents some full accuracy loss in such cases for dbinom(),
dnbinom(), and via dbinom_raw() potentially dgeom(), dhyper(),
dbeta(), and df().
• signif(1.**e308, digits) no longer truncates unnecessarily (but
still to prevent overflow to Inf), fixing PR#18889.
• prettyNum(*, zero.print={>=1-char}, replace.zero=TRUE) now works
as documented, thanks to Marttila Mikko and Ivan Krylov's
messages on R-devel.
• pbeta(x, a,b, ..) for very large a,b no longer returns NaN but
the correct values (0 or 1, or their logs for log.p = TRUE).
This improves Mathlib's C level bratio() and hence also
pnbinom(), etc..
CHANGES IN R 4.5.0:
NEW FEATURES:
• as.integer(rl) and hence as.raw(rl) now work for a list of raw(1)
elements, as proposed by Michael Chirico's PR#18696.
• graphics' grid() gains optional argument nintLog.
• New functions check_package_urls() and check_package_dois() in
package tools for checking URLs and DOIs in package sources.
• New head() and tail() methods for class "ts" time series,
proposed by Spencer Graves on R-devel.
• New qr.influence() function, a “bare bones” interface to the
lm.influence() leave-one-out diagnostics computations; wished for
in PR#18739.
• Package citation() results auto-generated from the package
metadata now also provide package DOIs for CRAN and Bioconductor
packages.
• New function grepv() identical to grep() except for the default
value = TRUE.
• methods(<pkg>:::<genfun>) now does report methods when neither
the generic nor the methods have been exported.
• pdf() gains an author argument to set the corresponding metadata
field, and logical arguments timestamp and producer to optionally
omit the respective metadata. (Thanks to Edzer Pebesma.)
• grDevices::glyphInfo() gains a rot argument to allow per-glyph
rotation. (Thanks to Daniel Sabanes Bove.)
• Package tools now exports functions CRAN_current_db(),
CRAN_aliases_db(), CRAN_rdxrefs_db(), CRAN_archive_db(), and
CRAN_authors_db().
• Package tools now exports functions R() and
parse_URI_reference().
• Package tools now exports functions base_aliases_db() and
base_rdxrefs_db().
• It is now possible to set the background color for row and column
names in the data editor on Windows (Rgui).
• Rterm on Windows now accepts input lines of unlimited length.
• file.info() on Windows now provides file owner name and domain.
• Sys.info() on Windows now provides current user domain.
• findInterval() gets new arguments checkSorted and checkNA which
allow skipping relatively costly checks; related to PR#16567.
• pnorm(x) underflows more gracefully.
• get(nam, env) now signals a _classed_ error, "getMissingError",
as “subclass” of "missingArgError" where the latter is used also
in similar situations, e.g., f <- function(x) exp(x); try(f()) .
• The set operations now avoid the as.vector() transformation for
same-kind apparently vector-like operands.
• md5sum() can be used to compute an MD5 hash of a raw vector of
bytes by using the bytes= argument instead of files=. The two
arguments are mutually exclusive.
• Added function sha256sum() in package tools analogous to md5sum()
implementing the SHA-256 hashing algorithm.
• The xtfrm() method for class "AsIs" is now considerably faster
thanks to a patch provided by Ivan Krylov.
• The merge() method for data frames will no longer convert row
names used for indexing using I(), which will lead to faster
execution in cases where sort = TRUE and all.x and/or all.y are
set to TRUE.
• The methods package internal function .requirePackage() now calls
requireNamespace(p) instead of require(p), hence no longer adding
packages to the search() path in cases methods or class
definitions are needed. Consequently, previous workflows relying
on the old behaviour will have to be amended by adding
corresponding library(p) calls.
• More R-level messages use a common format containing "character
string" for more consistency and less translation work.
• available.packages() and install.packages() get an optional
switch cache_user_dir, somewhat experimentally.
• The sunspot.month data have been updated to Oct 2024; because of
recalibration also historical numbers are changed, and we keep
the previous data as sunspot.m2014 for reproducibility.
• The quartz() device now supports alpha masks. Thanks to George
Stagg, Gwynn Gebeyhu, Heather Turner, and Tomek Gieorgijewski.
• The print() method for date-time objects (POSIX.t) gets an
optional digits argument for _fractional_ seconds, passed to
improved format.POSIXlt(); consequently, print(<date.time>,
digits = n) allows to print fractions of seconds.
• install.packages() and download.packages() download packages
simultaneously using libcurl, significantly reducing download
times when installing or downloading multiple packages.
• Status reporting in download.file() has been extended to report
the outcome for individual files in simultaneous downloads.
• The Rd \link macro now allows markup in the link text when the
topic is given by the optional argument, e.g.,
\link[=gamma]{\eqn{\Gamma(x)}}.
• If La_library() is empty, sessionInfo() still reports
La_version() when available.
• seq.int(from, to, by, ....) when |by| = 1 now behaves as if by
was omitted, and hence returns from:to, possibly integer.
• seq.Date(from, to, by, ....) and seq.POSIXt(..) now also work
when from is missing and sufficient further arguments are
provided, thanks to Michael Chirico's report, patch proposal in
PR#17672 and ‘R Dev Day’ contributions.
The Date method also works for seq(from, to), when by is missing
and now defaults to "1 days".
It is now documented (and tested) that the by string may be
_abbreviated_ in both seq methods.
Both methods return or keep internal type "integer" more
consistently now. Also, as.POSIXct({}) is internally integer.
• duplicated(), unique(), and anyDuplicated() now also work for
class expression vectors.
• New function use() to use packages in R scripts with full control
over what gets added to the search path. (Actually already
available since R 4.4.0.)
• There is some support for zstd compression of tarballs in tar()
and untar(). (This depends on OS support of libzstd or by tar.)
• print(summary(<numbers>)) gets new optional argument zdigits to
allow more flexible and consistent (double) rounding. The
current default zdigits = 4L is somewhat experimental.
Specifying both digits = *, zdigits = * allows behaviour
independent of the global digits option.
• The format() method for "difftime" objects gets a new back
compatible option with.units.
• A summary() method for "difftime" objects which prints nicely,
similar to those for "Date" and "POSIXct".
• unique()'s default method now also deals with "difftime" objects.
• optimize(f, *) when f(x) is not finite says more about the value
in its warning message. It no longer replaces -Inf by the
largest _positive_ finite number.
• The documentation of gamma() and is.numeric() is more specific,
thanks to the contributors of PR#18677.
• New dataset gait thanks to Heather Turner and Ella Kaye, used in
examples.
• New datasets penguins and penguins_raw thanks to Ella Kaye,
Heather Turner, and Kristen Gorman.
• isSymmetric(<matrix>) gains a new option trans = "C"; when set to
non-default, it tests for “simple” symmetry of complex matrices.
• model.frame() produces more informative error messages in some
cases when variables in the formula are not found, thanks to Ben
Bolker's PR#18860.
• selectMethod(f, ..) now keeps the function name if the function
belongs to a group generic and the method is for the generic.
BLAS and LAPACK:
• The bundled BLAS and LAPACK sources have been updated to those
shipped as part of January 2025's LAPACK 3.12.1.
• It is intended that this will be the last update to BLAS and
LAPACK in the R sources. Those building R from source are
encouraged to use external BLAS and LAPACK and this will be
required in future.
• This update was mainly bug fixes but contained a barely
documented major change. The set of BLAS routines had been
unchanged since 1988, so throughout R's history. This update
introduced new BLAS routines dgemmtr and zgemmtr which are now
used by LAPACK routines. This means that BLAS implementations
are no longer interchangeable.
• To work around this, R can be configured with option
--with-2025blas which arranges for the 2025 BLAS additions to be
compiled into libRlapack (the internal LAPACK, not built if an
external LAPACK is used).
This option allows the continuation of the practice of swapping
the BLAS in use by symlinking lib/libRblas.*. It has the
disadvantage of using the reference BLAS version of the 2025
routines whereas an enhanced BLAS might have an optimized version
(OpenBLAS does as from version 0.3.29).
• Windows builds currently use the internal LAPACK and by default
the internal BLAS: notes on how to swap the latter _via_
Rblas.dll are in file src/extra/blas/Makefile.win.
INSTALLATION on a UNIX-ALIKE:
• A C23 compiler (if available) is now selected by default for
compilation of R and packages. R builds can opt out _via_ the
configure flag --without-C23, unless the specified or default
(usually gcc) compiler defaults to C23: gcc 15 does.
A C23 compiler is known to be selected with gcc 13-15, LLVM clang
18-20 (and 15 should), Apple clang 15-17 and Intel 2024.2-2025.0
(and 2022.2 should).
Current binary distributions on macOS use Apple clang 14 and so
do not use C23.
• The minimum autoconf requirement for a maintainer build has been
increased to autoconf 2.72.
• Building the HTML and Info versions of the R manuals now requires
texi2any from Texinfo 6.1 or later.
• Failures in building the manuals under doc now abort the
installation, removing any file which caused the failure.
• Control of symbol visibility is now supported on macOS (the
previous check only worked on ELF platforms).
• There is now support for installing the debug symbols for
recommended packages on macOS: see REC_INSTALL_OPT in file
config.site.
• configure is now able to find an external libintl on macOS (the
code from an older GNU gettext distribution failed to try linking
with the macOS Core Foundation framework).
INSTALLATION on WINDOWS:
• Both building R and installing packages use the C compiler in C23
mode.
• R on Windows by default uses pkg-config for linking against
external libraries. This makes it easier to test R and packages
with alternative toolchains (such as from Msys2, e.g., testing
with LLVM and possibly with sanitizers). It also allows more
significant Rtools updates within a single R minor release.
• The installer scripts for Windows have been tailored to Rtools45,
an update of the Rtools44 toolchain. It is based on GCC 14. The
experimental support for 64-bit ARM (aarch64) CPUs is based on
LLVM 19. R-devel and R 4.5.x are no longer maintained to be
buildable using Rtools44 and it is advised to switch to Rtools45.
DEPRECATED AND DEFUNCT:
• is.R() is defunct. Environment variable _R_DEPRECATED_IS_R_ no
longer has any effect.
• Deprecated (for more than 9 years!) functions linearizeMlist,
listFromMlist, and showMlist and the "MethodsList" class for S4
method handling were removed from package methods. Deprecated
functions balanceMethodsList, emptyMethodsList,
inheritedSubMethodLists, insertMethod, insertMethodInEmptyList,
makeMethodsList, mergeMethods, MethodsList, MethodsListSelect,
and SignatureMethod were made defunct, as were the "MethodsList"
branches of functions assignMethodsMetaData, finalDefaultMethod,
and MethodAddCoerce.
• getMethods(*, table = TRUE) is deprecated.
• Building with the bundled (and old) version of libintl is
deprecated and now gives a configure warning. This should be
selected only if neither the OS's libc (as on GNU Linux) nor an
external libintl library provide suitable functions.
Instead install libintl from a recent version of GNU gettext
(available for macOS) or use configure option --disable-nls.
The ability to use the bundled version may be removed as soon as
R 4.5.1.
• The deprecated xfig() graphics device has been removed.
PACKAGE INSTALLATION:
• Packages are now installed using C23 where supported by the OS
and R build.
Packages using R's compiler settings can ask *not* to use C23
_via_ including USE_C17 in SystemRequirements or can be installed
by R CMD INSTALL --use-C17. (Some packages ignore these settings
in their configure script or when compiling in sub-directories of
src, as will those using a src/Makefile.)
• Source installs now report the package version in the log.
• There is preliminary support for C++26 with GCC >= 14, Apple
clang++ >= 16 and LLVM clang++ >= 17.
C-LEVEL FACILITIES:
• The non-API and hidden entry points Rf_setIVector, Rf_setRVector
and Rf_setSVector have been removed.
• The internal code for changing the parent of an environment now
signals an error if the new parent is not an environment or if
the change would create a cycle in the parent chain.
• SET_TYPEOF now signals an error unless the old and new types have
compatible memory structure and content. Use of SET_TYPE in
package C code should be avoided and may be deprecated in the
near future. It is better to allocate an object of the desired
type in the first place.
• The set of LAPACK (double and complex) routines declared in the
headers R_ext/Lapack.h and R_ext/Applic.h has been extended,
mostly to routines actually in use by packages.
• Memory allocation messages now use the (non-SI notation) "Mb",
"Gb" , ..., and "Mbytes" strings as _arguments_ instead of as
part of the (translatable format) string. This is one step for
PR#18297; from Henrik Bengtsson.
• Header R_ext/Constants.h (included by R.h) now always includes
header float.h or cfloat for constants such as DBL_MAX.
• Strict R headers are now the default. This removes the legacy
definitions of PI, Calloc, Realloc and Free: use M_PI, R_Calloc,
R_Realloc or R_Free instead.
• The deprecated and seemingly never-used S-compatibility macros
F77_COM and F77_COMDECL have been removed from header R_ext/RS.h.
• The enum Rboolean defined in header R_ext/Boolean.h now has a
fixed underlying type of int on platforms whose C compiler
supports this.
This is a C23 feature (taken from C++11) and also supported in
all C standards by some versions of clang (from LLVM and Apple)
and (with a warning when using -pedantic) by GCC when in C17
mode.
A fair amount of code has assumed this: it may be changed to a
smaller type in future. In particular, as standard compilers do
not check the validity of assignment to an enum, it has been
possible to assign NA_INTEGER to an Rboolean variable, coerce it
to int and recover the value.
If there were a platform which used an underlying type of a
different size this would be an ABI-breaking change (but we are
unaware of any such platform).
• Header R_ext/Boolean.h now ensures that a bool type is available
either as a keyword (C23 and C++) or by including the C99 header
stdbool.h. This is being used internally in R to replace
Rboolean by bool.
• There are new functions asRboolean and asBool, variants of
asLogical more suited to converting logical arguments to Rboolean
or to bool. They require a length-one input and throw an error if
that evaluates to NA.
• Header R_exts/Error.h now ensures that Rf_error and similar are
given a noreturn attribute when used from C++ under all
compilers.
• Header R_exts/Utils.h no longer contains a declaration for
F77_SUB(interv). This is intended to be called from Fortran and
was wrongly declared: LOGICAL in Fortran corresponds to int * not
Rboolean *.
• Defining R_INCLUDE_BOOLEAN_H to 0 before including headers R.h or
Rinternals.h (or any other header which includes R_ext/Boolean.h)
stops the inclusion of header R_ext/Boolean.h which `defines'
constants TRUE, FALSE, true, false and the type bool which some
package maintainers wish to avoid.
Note that the last three are keywords in C23 and C++11 so cannot
be avoided entirely. However, with commonly-used compilers they
can be masked by a macro of the same name, often with a warning.
C-LEVEL API:
• The ‘Writing R Extensions’ Texinfo source now contains very
experimental annotations for more clearly identifying the API
status of C entry points. These annotations are used to produce
indices for API, experimental API, and embedded API entry points
in the rendered versions. This is very preliminary and may be
dropped if a better approach emerges.
Also for Fortran-callable entry points which are part of the API.
• ‘Writing R Extensions’ has a new section ‘Moving into C API
compliance’ to help package authors move away from using non-API
endpoints. This section will continue to be updated as work on
clarifying and tightening the C API continues.
• New API function R_mkClosure. This checks that its arguments are
valid and should be used instead of allocSExp(CLOSXP followed by
SET_FORMALS, SET_BODY, and SET_CLOENV.
• New API functions R_ClosureFormals, R_ClosureBody, and
R_ClosureEnv for extracting closure components. The existing
functions R_ClosureExpr and R_BytecodeExpr have also been added
to the API.
• New API function R_ParentEnv corresponding to R's parent.env().
• Further non-API entry points have been added to those reported by
R CMD check: COMPLEX0, ddfind, DDVAL, ENSURE_NAMEDMAX, ENVFLAGS,
FRAME, HASHTAB, INTERNAL, IS_ASCII, IS_UTF8, LEVELS, NAMED,
PRSEEN, RDEBUG, REAL0, Rf_findVarInFrame3, SET_BODY, SET_CLOENV,
SET_FORMALS, SET_PRSEEN, SET_RDEBUG, STRING_PTR, SYMVALUE, and
VECTOR_PTR. Any declarations for these in public header files
will be removed in the near future, and they will be hidden where
possible.
• Some R CMD check NOTEs on the use of non-API entry points have
been upgraded to WARNINGs in preparation for removing
declarations and, where possible, hiding these entry points.
• Additional non-API entry points have been added to those reported
by R CMD check: IS_LONG_VEC, PRCODE, PRENV, PRVALUE, R_nchar,
Rf_NonNullStringMatch, R_shallow_duplicate_attr, Rf_StringBlank,
SET_TYPEOF, TRUELENGTH, XLENGTH_EX, and XTRUELENGTH.
• Enable defining R_NO_REMAP_RMATH and calling Rf_*() as has been
documented in ‘Writing R Extensions’ for a while, fixing PR#18800
thanks to Mikael Jagan and Suharto Anggono.
• R_GetCurrentSrcref(skip) now skips calls rather than srcrefs,
consistent with counting items in the traceback() display. If
skip == NA_INTEGER, it searches for the first srcref, starting at
the current evaluation state and proceeding through the call
stack; otherwise, it returns the srcref of the requested entry
from the call stack.
UTILITIES:
• R CMD INSTALL (and hence check) now compile C++ code with
-DR_NO_REMAP.
‘Writing R Extensions’ has been revised to describe the remapped
entry points, for with the Rf_ prefix remains optional when used
from C code (but is recommended for new C code).
• R CMD check --as-cran notes bad parts in the DESCRIPTION file's
URL fields.
• R CMD check now reports more warnings on long-deprecated/obsolete
Fortran features reported by gfortran -Wall. For hints on how to
modernize these, see
<https://fortranwiki.org/fortran/show/Modernizing+Old+Fortran>.
• Since almost all supported R versions now use UTF-8, R CMD check
no longer by default reports on marked UTF-8 or Latin-1 strings
in character data. Set environment variable
_R_CHECK_PACKAGE_DATASETS_SUPPRESS_NOTES_ to a false value for
the previous behaviour.
• tools::checkDocFiles() notes more cases of usage documentation
without corresponding \alias.
• R CMD check with a true value for environment variable
_R_CHECK_BASHISMS_ checks more thoroughly, including for bash
scripts and bashisms in components of autoconf-generated
configure scripts.
• R CMD check gains option --run-demo to check demo scripts
analogously to tests. This includes a check for undeclared
package dependencies: it can also be enabled separately by
setting the environment variable _R_CHECK_PACKAGES_USED_IN_DEMO_
to a true value (as done by R CMD check --as-cran).
• R CMD build now supports --compression=zstd on platforms with
sufficient support for zstd.
• tools::texi2pdf(..., texinputs=<paths>) now _pre_pends the
specified <paths> to TEXINPUTS. When building R itself
(doc/NEWS.pdf and base vignettes) or package manuals using R CMD
Rd2pdf, it is ensured that this R's Rd.sty takes precedence over
any other (incompatible) versions in default “texmf trees”.
• tools::Rd2latex() no longer outputs an \inputencoding{utf8} line
by default; such a declaration is obsolete since LaTeX
2018-04-01.
BUG FIXES:
• update_pkg_po() now copies .mo files to the translation package
even if a DESCRIPTION file exists, thanks to Michael Chirico
fixing PR#18694.
• Auto-generated citation() entries no longer include (additional)
URLs in the note field (PR#18547).
• as.data.frame.list() gets a new option new.names and now
preserves NA names, thus fixing the format() method for data
frames, and also bug PR#18745. Relatedly, the format() method
gets an option cut.names.
• stem() formats correctly also in cases where rounding up, e.g.,
from 9.96 to 10 needs more digits; thanks to Ella Kaye and Kelly
Bodwin, fixing PR#8934 during ‘R Dev Day’ at useR!2024.
Additionally, stem(x) now works normally also when length(x) ==
1.
• tools' toTitleCase() now works better, fixing PR#18674, thanks to
Shannon Pileggi, Sarah Zeller, Reiko Okamoto, and Hugo Gruson's
‘R Dev Day’ effort.
• Printing matrices (typically with many rows and or columns) now
also omits columns when desirable according to option max.print,
or argument max, respectively. This is primarily the work of
Lorena Abad, Ekaterina Akimova, Hanne Oberman, Abhishek Ulayil,
and Lionel Henry at the ‘R Dev Day’, thus fixing PR#15027.
• Sys.setLanguage() now warns about _some_ failures to change the
language.
• Printing ls.str() now shows "<missing>" even when R's language
setting is not English.
• xyTable() now handles and reports NAs fixing PR#18654. Thanks to
Heather Turner and Zhian Kamvar for report and patch.
• as(*, "raw") now works as documented, thanks to Mikael Jagan's
PR#18795.
• Informational messages of e.g., print(1:1e4, max=1000), now
correctly mention max in addition to getOption("max.print").
• rowSums(A, dims = dd), colMeans(..), etc, give a more helpful
error message when dd is not of length one, thanks to Michael
Chirico's PR#18811.
• seq.Date() no longer explicitly coerces results from integer to
double, analogously with seq.default(), seq.int() and
seq.POSIXt(), resolving a _modified_ PR#18782.
• axisTicks(usr, ...) documentation clarification for log = TRUE,
fixing bug PR#18821 thanks to Duncan Murdoch.
• debug() and debugonce(fun) now also accept a string fun when it
names an S4 generic, fixing PR#18822 thanks to Mikael Jagan.
• debugonce(<S4-simple-body>, signature=*) now works correctly when
“called twice”, fixing PR#18824 thanks to Mikael Jagan.
• format(dtime, digits=* / format=*) is more consistent when the
POSIXt date-time object dtime has fractional (non integer)
seconds. Fixes PR#17350, thanks to new contributions by LatinR's
‘R Dev Day’ participants, Heather Turner and Dirk Eddelbuettel;
also fixes more cases, notably when format contains %OS<nodigit>.
• options(scipen = NULL) and other invalid values now signal an
error instead of invalidating ops relying on a finite integer
value. Values outside the range -9 .. 9999 are now warned about
and set to a boundary or to the default 0, e.g., in case of an
NA. This also fixes PR#16322.
• cbind() could segfault with NULL inputs. (Seen when R was built
with gcc-14, LTO and C99 inlining semantics.)
• Fix segfault on quartz() from grid.glyph() call with glyphInfo()
that describes non-existent font (PR#18784). Thanks to Tomek
Gieorgijewski.
• format() etc, using decimal.mark = s, by default getting s <-
getOption("OutDec"), signals a warning (to become an error in the
future) when s is not a string with exactly one character.
• When s <- getOption("OutDec") is not a string of one character, a
warning is signalled now whenever it is used in internal C code,
notably when calling the default methods of format().
• pwilcox() and qwilcox() now check for user interrupt less
frequently.
• summary(<stl>) (which prints directly) finally gets the same
digits default as the formatting printing of default summary()
method results, and it is documented explicitly.
• options(show.error.locations = TRUE) once again shows the most
recent known location when an error is reported. Setting its
value to "bottom" is no longer supported. Numerical values are
converted to logical.
• C API function R_GetCurrentSrcref(skip) now returns srcref
entries correctly. (Note that there is also a change to the
interpretation of skip; see the C-LEVEL API entry above.)
• tools::Rd2latex() now removes leading and trailing spaces from
\alias entries as documented, fixing indexing and linking hiccups
in some PDF manuals.
• R CMD Rd2pdf can now render the package manual from a --latex
installation also when the help contains figures.
• The argument of as.environment() is now named x, not object, as
was always documented and shown when printing it; thanks to Gael
Millot's PR#18849.
• When R CMD check aims at getting the time+date from a world
clock, it is more robust against unexpected non-error results,
thanks to Michael Chirico's PR#18852.
• The tools::parseLatex() parser made several parsing errors
(PR#18855).
• Error messages produced by tools::parseLatex() are now more
readable (PR#18855).
• R CMD build <pkg> excludes more file patterns when it tars the
<pkg> directory, fixing both PR#18432 and PR#18434, for vim and
GNU Global emacs users, thanks to Dirk Eddelbuettel's patch.
• quantile()'s default method gets an option fuzz to protect
against floating point inaccuracy before rounding, thus fixing
PR#15811 and, en passant, PR#17683.
• Printing arrays now also omits columns, rows and slices when
desirable according to option max.print, or argument max,
respectively, addressing most of the remaining part of PR#15027,
thanks to Sherry Zhang's patch.
• drop.terms(y ~ w, 1) and similar now work, thanks to Benjamin
Sommer's report in PR#18861 and collaboration with Heather Turner
improving reformulate().
• Many arguments which should be length-1 logical are checked more
thoroughly. The most commonly seen errors are in unlink(,
recursive), tempdir() and the na.rm arguments of max(), min(),
sum(), ....
grep(), strsplit() and similar took non-TRUE/FALSE values of
their logical arguments as FALSE, but these were almost always
mismatches to unnamed arguments and are now reported as NA.
• vignette("reshape") is now also available on Windows.
• trace(coerce, ..) now works correctly, fixing PR#18823 thanks to
Mikael Jagan.
• R CMD check now also reports bad symbols in package shared
objects linked in from local static libraries (PR#18789).
• factanal() now works correctly also, e.g., for GPArotation,
oblimin() rotations, fixing PR#18417, thanks to Coen Bernaards
and others.
• Setting attributes on primitive functions is deprecated now and
already an error in the development version of R. Changing the
environment of a primitive does no longer happen and signals a
warning.
CHANGES IN R 4.4.3:
INSTALLATION:
• R can be installed using C23 (for example with -std=gnu23 or
-std=gnu2x) with recent compilers including gcc 12-14, Apple
clang 15-16, LLVM clang 17-20 and Intel icx 2024.2.
It can be installed with the upcoming (at the time of writing)
gcc 15, which defaults to C23.
C-LEVEL FACILITIES:
• The functions R_strtod and R_atof now allow hexadecimal constants
without an exponent, for compatibility with their C99 versions
(PR#18805).
UTILITIES:
• R CMD build and R CMD check now allow reference output for demo
scripts (demo/<demo>.Rout.save files) to be shipped with the
package, as proposed by Torsten Hothorn in PR#18816.
BUG FIXES:
• kappa(A, exact=TRUE) for singular A returns Inf more generally,
fixing PR#18817 reported by Mikael Jagan.
• Fixed URLs of the sun spots (sunspot.month etc) data sets and
mention future changes due to recalibration.
• The parser now accepts hexadecimal constants with a decimal point
without an exponent (taken as p0) as documented in
?NumericConstants (PR#18819).
• rbind() now works correctly when inputs include a raw vector and
a logical, integer or double vector - previously the inclusion of
the latter was garbled.
• smooth.spline() checks validity of its arguments df.offset and
penalty: it could segfault if they were NULL.
• isGeneric(<primitive>, fdef=*, getName=TRUE) now also returns the
name instead of just TRUE, fixing PR#18829 reported by Mikael
Jagan.
• isGeneric(fdef = print) now works, fixing PR#18369 thanks to
Mikael Jagan.
• sort(x, method = "qsort") made illegal accesses when x has length
0.
• dir.create() is protected against being passed an empty string as
its path argument.
• Silent integer overflow could occur in the ‘exact’ computations
for fisher.test() for unrealistic inputs: this is now an error.
• Some invalid C-level memory accesses are avoided for loglin(,
margin = NULL).
loglin(, param = TRUE) no longer gives an error in corner cases
such as a one-dimensional input.
• dev.capabilities() $ events now reports "Idle" if the device
provides it, fixing PR#18836, thanks to Trevor Davis.
• arima(.., seasonal = <wrong-vector>) correctly errors now, ditto
for arima0(), thanks to Norbert Kuder's report on the R-devel
list.
• binomial(<link>)$linkinv(eta) and .. $mu.eta(eta) now also work
for "logit" link when is.integer(eta).
• as.roman(x) now should work platform independently, also for,
e.g., x = "IIIII" (= V) and x = "IIIIII" (= VI).
• R CMD Rd2pdf works again on an installed package directory
containing LaTeX help (from option --latex), thanks to a report
by Peter Ruckdeschel.
CHANGES IN R 4.4.2:
C-LEVEL FACILITIES:
• The S-compatibility macros F77_COM and F77_COMDECL defined in
header R_ext/RS.h are deprecated and will be removed shortly. We
could find no record of their use.
BUG FIXES:
• Mathlib function lgammacor(x) no longer warns about underflow to
zero for large x.
• Text widths and heights were incorrectly reported by the Quartz
device if the drawing context didn't exist yet (typically when
drawing off-screen to a window that is yet to appear, see
PR#18591).
• The Quartz device could segfault in cases where paths with spaces
are used in the new glyph drawing API. Thanks to Tomek
Gieorgijewski (PR#18758).
• On macOS in R CRAN builds, it is again possible to read
little-endian UTF-16 text with a BOM from a connection using
encoding="UTF-16". Users building R from source should avoid
using the system libiconv in macOS 14.1 and later.
• methods' internal .requirePackage() now re-enables primitive
method dispatch when needed; thanks to Ivan Krylov for
demystifying CRAN package check failures on the R-devel mailing
list.
CHANGES IN R 4.4.1:
C-LEVEL FACILITIES:
• Functions R_atof and R_strtod declared in header R_ext/Utils.h
are now documented in ‘Writing R Extensions’ and so formally part
of the API.
• The non-API entry points Rf_setSVector, Rf_StringFalse,
Rf_StringTrue and Rf_isBlankString have been added to those
reported by R CMD check.
• The new function Rf_allocLang is now available. This provides an
alternative to the idiom of calling Rf_allocList followed by
SET_TYPEOF.
UTILITIES:
• R CMD check now reports as warnings what gfortran calls ‘Fortran
2018 deleted features’, all of which have long been marked as
‘obsolescent’ and some of which were deleted in Fortran 2008 or
earlier. Fortran compilers are no longer required to support
these.
BUG FIXES:
• as.numeric(), scan(), type.convert() and other places which use
the internal C function R_strtod now require a _non-empty_ digit
sequence in a decimal or binary exponent. This aligns with the
C/POSIX standard for strtod and with ?NumericConstants.
• as.data.frame(m, make.names=NA) now works correctly for a matrix
m with NA's in row names.
• The error message from <POSIXlt>[["hour"]] and similar now
mentions *[[, "hour"]], as wished for in PR#17409 and proposed by
Michael Chirico.
• qbinom() and potentially qpois(), qnbinom(), no longer sometimes
fail accurate inversion (of pbinom(), etc), thanks to Christopher
Chang's report and patch in PR#18711.
• The internal help server on Windows can again serve requests sent
in quick succession, fixing a regression in R 4.4.0.
• debugcall(<S3Generic>()) now also works when a corresponding
S4-generic version is in the methods cache (PR#18143).
• Package tools' toTitleCase(ch0) now returns character(0) when ch0
is of zero length; fixing PR#18724, reported by David Hugh Jones.
• R CMD check is no longer broken (without a check result and no
explanation in 00check.log) for a package which declares an
invalid VignetteBuilder in DESCRIPTION but has no vignettes.
CHANGES IN R 4.4.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• Startup banners, R --version, sessionInfo() and R CMD check no
longer report (64-bit) as part of the platform as this is almost
universal - the increasingly rare 32-bit platforms will still
report (32-bit).
On Windows, ditto for window titles.
• is.atomic(NULL) now returns FALSE, as NULL is not an atomic
vector. Strict back-compatibility would replace is.atomic(foo)
by (is.null(foo) || is.atomic(foo)) but should happen only
sparingly.
NEW FEATURES:
• The confint() methods for "glm" and "nls" objects have been
copied to the stats package. Previously, they were stubs which
called versions in package MASS. The MASS namespace is no longer
loaded if you invoke (say) confint(glmfit). Further, the "glm"
method for profile() and the plot() and pairs() methods for class
"profile" have been copied from MASS to stats. (profile.nls()
and plot.profile.nls() were already in stats.)
• The confint() and profile methods for "glm" objects have gained a
possibility to do profiling based on the Rao Score statistic in
addition to the default Likelihood Ratio. This is controlled by a
new test = argument.
• The pairs() method for "profile" objects has been extended with a
which = argument to allow plotting only a subset of the
parameters.
• The "glm" method for anova() computes test statistics and
p-values by default, using a chi-squared test or an F test
depending on whether the dispersion is fixed or free. Test
statistics can be suppressed by giving argument test a false
logical value.
• In setRepositories() the repositories can be set using their
names via name = instead of index ind =.
• methods() and .S3methods() gain a all.names option for the (rare)
case where functions starting with a . should be included.
• Serializations can now be interrupted (e.g., by Ctrl-C on a
Unix-alike) if they take too long, e.g., from save.image(),
thanks to suggestions by Ivan Krylov and others on R-devel.
• New startup option --max-connections to set the maximum number of
simultaneous connections for the session. Defaults to 128 as
before: allowed values up to 4096 (but resource limits may in
practice restrict to smaller values).
• R on Windows (since Windows 10 2004) now uses the new Segment
Heap allocator. This may improve performance of some
memory-intensive applications.
• When R packages are built, typically by R CMD build <pkg>, the
new --user=<build_user> option overrides the (internally
determined) user name, currently Sys.info()["user"] or LOGNAME.
This is a (modified) fulfillment of Will Landau's suggestion in
PR#17530.
• tools::testInstalledBasic() gets new optional arguments outDir
and testSrcdir, e.g., allowing to use it in a <builddir> !=
<srcdir> setup, and in standard “binary” Windows installation
*if* a source tests/ folder is present.
• range(<DT_with_Inf>, finite = TRUE) now work for objects of class
"Date", "POSIXct", and "POSIXlt" with infinite entries,
analogously to range.default(), as proposed by Davis Vaughan on
R-devel. Other range()-methods can make use of new function
.rangeNum().
• New .internalGenerics object complementing .S3PrimitiveGenerics,
for documentation and low-level book-keeping.
• grid() now invisibly returns the x- and y- coordinates at which
the grid-lines were drawn.
• norm(., type) now also works for complex matrices.
• kappa(., exact = TRUE, norm = *) now works for all norms and also
for complex matrices. In symmetric / triangular cases, the new
argument uplo = "U" | "L" allows the upper or lower triangular
part to be specified.
• memDecompress(type = "unknown") recognizes compression in the
default ‘zlib’ format as used by memCompress(type = "gzip").
• memCompress() and memDecompress() will use the libdeflate library
(<https://github.com/ebiggers/libdeflate>) if installed. This
uses the same type of compression for type = "gzip" but is 1.5-2x
faster than the system libz library on some common platforms: the
speed-up may depend on the library version.
• diff() for objects of class "Date", "POSIXct", and "POSIXlt"
accepts a units argument passed via ....
• Dynamic help now does a much better job of rendering package
DESCRIPTION metadata.
• Rprof() gains an event argument and support for elapsed (real)
time profiling on Unix (PR#18076).
• filled.contour() gains a key.border argument.
• tools::update_pkg_po() gets arguments pot_make and mo_make for
_not_ re-making the corresponding files, and additionally a
verbose argument.
• Hexadecimal string colour specifications are now accepted in
short form, so, for example, we can use "#123", which is
equivalent to "#112233".
Thanks to MikeFC for the original idea and Ella Kaye, Malcolm
Barrett, George Stagg, and Hanne Oberman for the patch.
• Plain-text help shows \var markup by angle brackets.
• The new experimental primitive function declare() is intended to
eventually allow information about R code to be communicated to
the interpreter, compiler, and code analysis tools. The syntax
for declarations is still being developed.
• Functions psmirnov(), qsmirnov() and rsmirnov() in package stats
have had argument two.sided renamed to alternative, to take into
account that the permutation distributions of the one-sided
statistics can be different in the case of ties. Consequence of
PR#18582.
• sort() is now an implicit S4 generic in methods.
• Formatting and printing, format(z), print(z), of complex vectors
z no longer zap relatively small real or imaginary parts to zero,
fixing PR#16752. This is an API change, as it was documented
previously to round real and imaginary parts together on purpose,
producing nicer looking output. As mentioned, e.g. in the PR,
this change is compatible with many other “R-like” programming
environments.
We have simplified the internal code and now basically format the
real and imaginary parts independently of each other.
• New experimental functions Tailcall() and Exec() to support
writing stack-space-efficient recursive functions.
• Where characters are attempted to be plotted by pdf(),
postscript() and xfig() which are not in the selected 8-bit
character set (most often Latin-1) and the R session is using a
UTF-8 locale, the warning messages will show the UTF-8 character
rather than its bytes and one dot will be substituted per
character rather than per byte. (Platforms whose iconv() does
transliteration silently plot the transliteration.)
In a UTF-8 locale some transliterations are now done with a
warning (e.g., dashes and Unicode minus to hyphen, ligatures are
expanded, permille (‰) is replaced by o/oo), although the OS may
have got there first. These are warnings as they will continue
to be replaced by dots in earlier versions of R.
• The matrix multiplication functions crossprod() and tcrossprod()
are now also primitive and S3 generic, as %*% had become in R
4.3.0.
• source() and example() have a new optional argument catch.aborts
which allows continued evaluation of the R code after an error.
• The non-Quartz tiff() devices allow additional types of
compression if supported by the platform's libtiff library.
• The list of base and recommended package names is now provided by
tools::standard_package_names().
• cairo_pdf() and cairo_ps() default to onefile = TRUE to closer
match pdf() and postscript().
• New option catch.script.errors provides a documented way to catch
errors and then continue in non-interactive use.
• L %||% R newly in base is an expressive idiom for the phrases
if(!is.null(L)) L else R or if(is.null(L)) R else L.
• The return value from warnings() now always inherits from
"warnings" as documented, now also in the case of no warnings
where it previously returned NULL.
• as.complex("1i") now returns 0 + 1i instead of NA with a warning.
• z <- c(NA, 1i) now keeps the imaginary part Im(z[1]) == 0, no
longer coercing to NA_complex_. Similarly, cumsum(z) correctly
sums real and imaginary parts separately, i.e., without
“crosstalk” in case of NAs.
• On Alpine Linux iconv() now maps "latin2", "latin-2", "latin9"
and "latin-9" to encoding names the OS knows about
(case-insensitively).
• iconv(sub = "Unicode") now always zero-pads to four (hex) digits,
rather than to 4 or 8. (This seems to have become the convention
once Unicode restricted the number of Unicode points to 2^21 - 1
and so will never need more than 6 digits.)
• NCOL(NULL) now returns 0 instead of 1, for consistency with
cbind().
• The information for the Euro glyph missing from the Adobe .afm
files for the Courier, Helvetica and Times families has been
copied from their URW equivalents - this will improve vertical
centring in the pdf() and postscript() devices.
• The included BLAS sources have been updated to those shipped with
LAPACK version 3.12.0. The changes are almost entirely cosmetic.
• The included LAPACK sources have been updated to version 3.12.0
and some further double-complex routines added.
• There are new font families for the 2014--5 URW 2.0 fonts (see
?pdf) which are included in recent versions of Ghostscript.
These have font widths for most Greek glyphs and a few others
which were missing from the original versions (whose font
families remain available for reproducibility, although
Ghostscript-based viewers will render using the 2.0 versions).
• Improve the large-n efficiency of as.matrix(<dist>), thanks an R
contributors effort, notably by Tim Taylor and Heather Turner,
see PR#18660.
• The default and numeric methods of all.equal() get a check.class
option.
• zapsmall() gets new optional arguments, function mFUN and min.d,
for extra flexibility; fulfills a wish in PR#18199. Also, it is
now an implicit S4 generic in package methods.
• The Rd filter for aspell() gains an ignore argument.
• New generic function sort_by(), primarily useful for the
data.frame method which can be used to sort rows of a data frame
by one or more columns.
• The licence headers for the RPC code in src/extra/xdr have been
updated to use the GPL-compatible licence published by Oracle
America in 2010.
• New function pkg2HTML() in tools to create single-page HTML
reference manuals for R packages.
• The byte code evaluator now uses less C stack space for recursive
calls to byte-compiled functions. It also makes more of an effort
to avoid allocations for scalar return values.
• New completion option backtick (disabled by default) allows
non-syntactic completions to be wrapped in backquotes. This is
currently only useful for Jupyter notebooks via the IRkernel
package, and may cause problems for other backends.
• The numeric version creators now stop on invalid non-character
version specifications.
INSTALLATION:
• The parser has been updated to work with bison 3.8.2, which is
now used for the pre-generated parsers in gram.c, file.c, and
gramRd.c. A few parser error messages have changed, which may
affect code that relies on exact messages.
INSTALLATION on a UNIX-ALIKE:
• System valgrind headers are now required to use configure option
--with-valgrind-instrumentation with value 1 or 2.
• configure will warn if it encounters a 32-bit build, as that is
nowadays almost untested.
• Environment variable R_SYSTEM_ABI is no longer used and so no
longer recorded in etc/Renviron (it was not on Windows and was
only ever used when preparing package tools).
• If the libdeflate library and headers are available, libdeflate
rather than libz is used to (de)compress R objects in lazy-load
databases. Typically tasks spend up to 5% of their time on such
operations, although creating lazy-data databases is one of the
exceptions.
This can be suppressed if the library is available by the
configure option --without-libdeflate-compression.
• configure option --enable-lto=check has not worked reliably since
2019 and has been removed.
• The minimum autoconf requirement for a maintainer build has been
increased to autoconf 2.71.
It is intended to increase this to 2.72 for R 4.5.0: the
distributed configure file was generated using 2.72.
• The minimum version requirement for an external LAPACK has been
reduced to 3.9.0.
• No default C++ compiler is set if no C++17 compiler is detected:
there is no longer an automatic fallback to C++14 or C++11.
Compilers from the last five years should have sufficient
support: for others macros CXX and CXXSTD can be set in file
config.site to provide a fallback if needed.
The Objective-C++ compiler now by default uses the standard
selected by R for C++ (currently C++17) rather than the default
standard for the C++ compiler (which on macOS is still C++98).
INSTALLATION on macOS:
• A new configure option --with-newAccelerate makes use of Apple's
‘new’ BLAS / LAPACK interfaces in their Accelerate framework.
Those interfaces are only available in macOS 13.3 or later, and
building requires SDK 13.3 or later (from the Command Line Tools
or Xcode 14.3 or later).
By default the option uses new Accelerate for BLAS calls: to also
use it for LAPACK use option --with-newAccelerate=lapack. The
later interfaces provide LAPACK 3.9.1 rather than 3.2.1: 3.9.1 is
from 2021-04 and does not include the improved algorithms
introduced in LAPACK 3.10.0 (including for BLAS calls).
INSTALLATION on WINDOWS:
• The makefiles and installer scripts for Windows have been
tailored to Rtools44, an update of the Rtools43 toolchain. It is
based on GCC 13 and newer versions of MinGW-W64, binutils and
libraries (targeting 64-bit Intel CPUs). R-devel can no longer
be built using Rtools43 without changes.
• Rtools44 has experimental support for 64-bit ARM (aarch64) CPUs
_via_ the LLVM 17 toolchain using lld, clang/flang-new and
libc++.
UTILITIES:
• R CMD check notes when S4-style exports are used without
declaring a strong dependence on package methods.
• tools::checkRd() (used by R CMD check) detects more problems with
\Sexpr-based dynamic content, including bad nesting of \Sexprs
and invalid arguments.
• tools::checkRd() now reports Rd titles and section names ending
in a period; this is ignored by R CMD check unless environment
variable _R_CHECK_RD_CHECKRD_MINLEVEL_ is set to -5 or smaller.
• R CMD check now notes Rd files without an \alias, as long
documented in ‘Writing R Extensions’ §1.3.1. The check for a
missing \description has been moved from tools::checkRd() to
tools::checkRdContents().
• R CMD check now visits inst/NEWS.Rd and OS-specific man
subdirectories when checking Rd files.
• tools::checkDocFiles() and tools::checkRdContents() now also
check internal Rd files by default, but “specially” (ignoring
missing documentation of arguments).
• R CMD Rdiff gets option --useEx.
• R CMD check now warns on non-portable uses of Fortran KIND such
as INTEGER(KIND=4) and REAL(KIND=8).
To see the failing lines set environment variable
_R_CHECK_FORTRAN_KIND_DETAILS_ to a true value.
• When checking Rd files, R CMD check now notes some of the “lost
braces” that tools::checkRd() finds. Typical problems are Rd
macros missing the initial backslash (e.g., code{...}), in-text
set notation (e.g., {1, 2}, where the braces need escaping), and
\itemize lists with \describe-style entries of the form
\item{label}{description}.
• R CMD INSTALL (and hence check) will compile C++ code with
-DR_NO_REMAP if environment variable _R_CXX_USE_NO_REMAP_ is set
to a true value. It is planned that this will in future become
the default for compiling C++.
• The new built-in Rd macro \dontdiff{} can be used to mark example
code whose output should be ignored when comparing check output
to reference output (tests/Examples/<pkg>-Ex.Rout.save). The
\dontdiff tag, like \donttest, is _not_ shown on the rendered
help page, so provides a clean alternative to ##
IGNORE_RDIFF_(BEGIN|END) comments.
• R CMD build when there is no NAMESPACE, now uses the recommended
exportPattern("^[^.]"), instead of exporting everything.
• R CMD check now warns about non-ASCII characters in the NAMESPACE
file (in addition to R files). Such packages are not portable and
may fail to install on some platforms.
C-LEVEL FACILITIES:
• Headers R_ext/Applic.h and R-ext/Linpack.h used to include
R_ext/BLAS.h although this was undocumented and unneeded by their
documented entry points. They no longer do so.
• New function R_missing(), factored out from do_missing(), used to
fix PR#18579.
• SEXP type S4SXP has been renamed to OBJSXP to support
experimenting with alternative object systems. The S4SXP value
can still be used in C code but is now deprecated. Based on
contributions from the R Consortium's Object-Oriented Programming
Working Group.
• New function pow1p(x,y) for accurate (1+x)^y.
• mkCharLenCE was incorrectly documented to take a size_t length
but was implemented with int (and character strings in R are
limited to 2^31 - 1 bytes).
DEPRECATED AND DEFUNCT:
• data() no longer handles zipped data from long-defunct (since R
2.13.0) --use-zip-data installations.
• The legacy graphics devices pictex() and xfig() are now
deprecated. They do not support recent graphics enhancements and
their font handling is rudimentary. The intention is to retain
them for historical interest as long as they remain somewhat
functional.
• Support for encoding = "MacRoman" has been removed from the pdf()
and postscript() devices - this was a legacy encoding supporting
classic macOS up to 2001 and no longer has universal libiconv
support.
• is.R() is deprecated as no other S dialect is known to be in use
(and this could only identify historical dialects, not future
ones).
Further information on calls can be obtained by setting the
environment variable _R_DEPRECATED_IS_R_ to error which turns the
deprecation warning into an error and so by default gives a
traceback. (This is done by R CMD check --as-cran.)
• UseMethod() no longer forwards local variables assigned in the
generic function into method call environments before evaluating
the method body. This makes method calls behave more like
standard function calls and makes method code easier to analyze
correctly.
• The twelve as.data.frame.<class>() methods which were deprecated
only via _R_CHECK_AS_DATA_FRAME_EXPLICIT_METHOD_ and in R CMD
check --as-cran are formally deprecated now in favour of calling
as.data.frame() or as.data.frame.vector(). The deprecation
“check” now works also when as.data.frame() is S4 generic thanks
to Ivan Krylov.
• The default method for the directional comparison operators <, >,
<=, and >= now signals an error when one of the operands is a
language object, i.e. a symbol or a call.
• For terms.formula(), deprecate abb and neg.out arguments
_formally_ in addition to just documenting it.
BUG FIXES:
• The methods package is more robust to not being attached to the
search path. More work needs to be done.
• pairwise.t.test() misbehaved when subgroups had 0 DF for
variance, even with pool.sd = TRUE. (PR#18594 by Jack Berry).
• Probability distribution functions [dpq]<distrib>(x, *), but also
bessel[IKJY](x, .) now consistently preserve attributes(x) when
length(x) == 0, e.g., for a 2 x 0 matrix, thanks to Karolis
Koncevičius' report PR#18509.
• Group “Summary” computations such as sum(1:3, 4, na.rm = 5, NA,
7, na.rm = LL) now give an error instead of either 17 or NN for
LL true or false, as proposed by Ivan Krylov on the R-devel
mailing list. (This also means it is now an error to specify
na.rm more than once.)
• as.complex(x) now returns complex(real = x, imaginary = 0) for
_all_ numerical and logical x, notably also for NA or
NA_integer_.
• Directories are now omitted by file.copy(, recursive = FALSE) and
in file.append() (PR#17337).
• gsub() and sub() are now more robust to integer overflow when
reporting errors caused by too large input strings (PR#18346).
• Top-level handlers are now more robust to attempts to remove a
handler whilst handlers are running (PR#18508).
• The handling of Alt+F4 in dialogs created on Windows using
GraphApp has been fixed (PR#13870).
• density() more consistently computes grid values for the
FFT-based convolution, following Robert Schlicht's analysis and
proposal in PR#18337, correcting density values typically by a
factor of about 0.999. Argument old.coords = TRUE provides back
compatibility.
• palette.colors() gains a name argument that defaults to FALSE
controlling whether the vector of colours that is returned has
names (where possible). PR#18529.
• tools::xgettext() no longer extracts the (non-translatable) class
names from warningCondition and errorCondition calls.
• S3method(<gen>, <class>, <func>) in the NAMESPACE file now works
(again) when <func> is visible from the namespace, e.g.,
imported, or in base.
• getParseData(f) now also works for a function defined in the
first of several <pkg>/R/*.R source files, thanks to Kirill
Müller's report and Duncan Murdoch's patch in PR#16756.
• Rd \Sexpr macros with nested #ifdef conditionals were not
processed.
• A non-blocking connection with non-default encoding (such as a
socket) now correctly returns from readLines() after new data has
arrived also when its EOF had been reached previously. Thanks to
Peter Meilstrup's report on R-devel and Ivan Krylov's report and
patch proposal in PR#18555.
• tools::checkRdContents() failed to detect empty argument
descriptions when they spanned multiple lines, including those
generated by prompt(). These cases are now noted by R CMD check.
• Plain-text help no longer outputs spurious colons in the
arguments list (for multi-line \item labels in the Rd source).
• kappa() and rcond() work correctly in more cases; kappa(., norm =
"2") now warns that it computes the 1-norm with (default) exact =
FALSE; prompted by Mikael Jagan's quite comprehensive PR#18543.
• Rd skeletons generated by prompt() or promptData() now use a
dummy title (so R CMD build works). tools::checkRdContents() has
been updated to detect such template leftovers, including from
promptPackage().
• When S4 method dispatch fails because no method was found, the
error message now includes the signature argument names; thanks
to Michael Chirico's proposal on the R-devel list.
• withAutoprint({ .. }) now preserves srcrefs previously lost,
thanks to Andrew Simmons' report plus fix in PR#18572.
• transform.data.frame() no longer adjusts names; in particular,
untransformed variables are kept as-is, including those with
syntactically invalid names (PR#17890).
• The keep.source option for Rd \Sexpr blocks is no longer ignored.
• The formula methods for t.test() and wilcox.test() now catch when
paired is passed, addressing PR#14359; use Pair(x1, x2) ~ 1 for a
paired test.
• The level reported in the browser prompt was often too large. It
now shows the number of browser contexts on the stack.
• For cbind() and rbind(), the optional deparse.level argument is
now properly passed to methods, thanks to Mikael Jagan's PR#18579
and comments there.
• Some error and warning messages for large (‘long vector’)
matrix(v, nr, nc) and dim(m) <- d are now correct about sizes,
using long long formatting, fixing PR#18612 (and more) reported
by Mikael Jagan.
• readChar(useBytes = TRUE) now terminates strings even when the
underlying connection uses extra spaces in the input buffer.
This fixes problems with extra garbage seen with gzip
connections, PR#18605.
• Named capture in PCRE regular expressions now works also with
more than 127 named groups (PR#18588).
• Datetime functions are now robust against long jumps when dealing
with internal time zone changes. This avoids confusing warnings
about an invalid time zone, previously triggered by turning
warnings into errors or handling them via tryCatch (PR#17966,
PR#17780).
• Datetime functions now restore even an empty TZ environment
variable after internal time zone changes (PR#17724). This makes
results of datetime functions with this (typically unintentional)
setting more predictable.
• drop.terms(*) now drops response as by default, keep.response =
FALSE, fixing PR#18564 thanks to Mikael Jagan.
• dummy.coef(.) now also works for lm()-models with character
categorical predictor variables rather than factor ones, fixing
PR#18635 reported by Jinsong Zhao.
• formals(f) <- formals(f) now also works for a function w/o
arguments and atomic _constant_ body(f).
• Correct as.function(<invalid list>, .)'s error message.
• removeSource() is yet more thorough in finding and removing
"srcref" and the other source references from parsed R language
chunks, fixing PR#18638 thanks to Andrew Simmons.
• dgeom() is more accurate now, notably when its result is very
small, fixing PR#18642 thanks to the proposal of Morten Welinder,
also improving other instances where C level binom_raw(x, n, ..)
has x == 0 or x== n.
• warning() with options(warn = 1) has improved output for
multi-line messages.
• axis.Date() and axis.POSIXct() now respect the par("lab") setting
for the number of pretty() intervals.
• Comparisons for language objects (which are based on deparsing)
are now more careful about using accurate deparsed results
(PR#18676).
• Plain-text help (Rd2txt) now correctly preserves blank lines
following single-line \dontrun code.
• <POSIXlt>[*] no longer sets wrong "balanced" attribute, fixing
PR#18681 thanks to Mikael Jagan.
• str(<classed-call>) now deparses the call as expected, fixing
PR#18684, reported by Dave Slager.
• In Rd examples, code following the closing brace of a \dontrun,
\dontshow or \donttest tag on the same line is no longer skipped
when R CMD check runs the examples.
• as.data.frame(matrix(*, ncol=0)) now gets valid names() and
colnames(); reported by Davis Vaughan on the R-devel list.
• Internal Mathlib function stirlerr(n) is now almost fully
(52-bit) accurate for all n >= ~5.9 and more accurate also in the
range 1 -- 5.9. This entails small (“after 12th decimal”)
changes in density functions, e.g., dgamma() in _some_ regions of
their support. The fix was partly prompted by Morten Welinder's
PR#18640.
• Numbers like 9876543.2 are now considered non-integer by Mathlib
internal R_nonint(), amending original fix of PR#15734.
• Rd comment lines no longer cause broken paragraphs in the
rendered PDF and plain-text help. In code blocks, pure comment
lines (starting with %) no longer produce an empty line.
• xtabs(Freq ~ .) now consistently defaults to na.action = na.pass,
using na.rm = FALSE (added as an argument) when summing over Freq
(PR#17770).
• tools::testInstalledPackage() is no longer silent about failures
from running examples or tests and its return code no longer
ignores failures from checking vignettes.
CHANGES IN R 4.3.3:
NEW FEATURES:
• iconv() now fixes up variant encoding names such as "utf8"
case-insensitively.
DEPRECATED AND DEFUNCT:
• The legacy encoding = "MacRoman" is deprecated in pdf() and
postscript(): support was incomplete in earlier versions of R.
BUG FIXES:
• Arguments are now properly forwarded to methods on S4 generics
with ... in the middle of their formal arguments. This was broken
for the case when a method introduced an argument but did not
include ... in its own formals. Thanks to Hervé Pagès for the
report PR#18538.
• Some invalid file arguments to pictex(), postscript() and xfig()
opened a file called NA rather than throw an error. These
included postscript(NULL) (which some people expected to work
like pdf(NULL)).
• Passing filename = NA to svg(), cairo_pdf(), cairo_ps() or the
Cairo-based bitmap devices opened a file called NA: it now throws
an error.
• quartz(file = NA) opened a file called NA, including when used as
a Quartz-based bitmap device. It now gives an error.
• rank(<long vector>) now works, fixing PR#18617, thanks to Ilia
Kats.
• seq.int() did not adequately check its length.out argument.
• match(<POSIXct>, .) is correct again for differing time zones,
ditto for "POSIXlt", fixing PR#18618 reported by Bastian Klein.
• drop.terms(*, dropx = <0-length>) now works, fixing PR#18563 as
proposed by Mikael Jagan.
• drop.terms(*) keeps + offset(.) terms when it should, PR#18565,
and drop.terms() no longer makes up a response, PR#18566, fixing
both bugs thanks to Mikael Jagan.
• getS3method("t", "test") no longer finds the t.test() function,
fixing PR#18627.
• pdf() and postscript() support for the documented Adobe encodings
"Greek" and "Cyrilllic" was missing (although the corresponding
Windows' codepages could be used).
• Computations of glyph metric information for pdf() and
postscript() did not take into account that transliteration could
replace one character by two or more (only seen on macOS 14) and
typically warned that the information was not known.
• rank(x) no longer overflows during integer addition, when
computing rank average for largish but not-yet long vector x,
fixing PR#18630, thanks to Ilia Kats.
• list.files() on Windows now returns also files with names longer
that 260 bytes (the Windows limit is 260 characters).
Previously, some file names particularly with ‘East Asian’
characters were omitted.
• cov2cor(<0 x 0>) now works, fixing PR#18423 thanks to Mikael
Jagan and Elin Waring.
• cov2cor(<negative diagonal>) and similar now give one warning
instead of two, with better wording, fixing PR#18424 thanks to
Mikael Jagan.
• tools:: startDynamicHelp() now ensures port is in proper range,
fixing PR#18645.
• pbeta(x, a,b) is correct now for x=0 or 1 in the boundary cases
where a or b or both are 0, fixing PR#18672 thanks to Michael
Fay.
• pmatch(x, table) for large table, also called for data frame row
selection, dfrm[nm, ], is now interruptible, fixing PR#18656.
• predict(<rank-deficient lm>, newdata=*) fix computing of nbasis,
see Russ Lenth's comment 29 in PR#16158.
• Added a work-around for a bug in macOS 14.3.1 and higher which
prevents R plots in the Quartz Cocoa device from updating on
screen.
CHANGES IN R 4.3.2:
NEW FEATURES:
• The default initialization of the "repos" option from the
repositories file at startup can be skipped by setting
environment variable R_REPOSITORIES to NULL such that
getOption("repos") is empty if not set elsewhere.
• qr.X() is now an implicit S4 generic in methods.
• iconv(to = "ASCII//TRANSLIT") is emulated using substitution on
platforms which do not support it (notably Alpine Linux). This
should give a human-readable conversion in ASCII on all platforms
(rather than NA_character_).
• trans3d() gains options continuous and verbose addressing the
problem of possible “wrap around” when projecting too long
curves, as reported by Achim Zeileis in PR#18537.
• tools::showNonASCII() has been rewritten to work better on macOS
14 (which has a changed implementation of iconv()).
• tiff(type = "quartz") (the default on macOS) now warns if
compression is specified: it continues to be ignored.
INSTALLATION on a UNIX-ALIKE:
• There is some support for building with Intel's LLVM-based
compilers on x86_64 Linux, such as (C) icx, (C++) ipcx and
(Fortran) ifx from oneAPI 2023.x.y.
• There is support for using LLVM's flang-new as the Fortran
compiler from LLVM 16.0.x (preferably 17.0.0 or later).
UTILITIES:
• R CMD check reports the use of the Fortran 90 random number
generator RANDOM_NUMBER() and the subroutines to initialize it.
‘Writing R Extensions’ has example code to use R's RNGs from
Fortran.
BUG FIXES:
• substr(x, n, L) <- cc now works (more) correctly for multibyte
UTF-8 strings x when L > nchar(x), thanks to a report and patch
by ‘Architect 95’.
• contrib.url(character()) now returns 0-length character() as
documented, which also avoids spurious warnings from
available.packages() et al. in the edge case of an empty vector
of repository URLs.
• readChar(., 4e8) no longer fails, thanks to Kodi Arfer's report
(PR#18557).
• lapply(<list>, as.data.frame) no longer warns falsely for some
base vector components.
• Communication between parent and child processes in the multicore
part of parallel could fail on platforms that do not support an
arbitrarily large payload in system functions read()/write() on
pipes (seen on macOS where a restriction to INT_MAX bytes is
documented, without doing a partial read unlike Linux). The
payload is now split into 1Gb chunks to avoid that problem.
(PR#18571)
• qqplot(x,y, conf.level=.) gives better confidence bounds when
length(x) != length(y), thanks to Alexander Ploner's report and
patch proposal (PR#18557).
• norm(<0-length>, "2") now gives zero instead of an error, as all
the other norm types, thanks to Mikael Jagan's PR#18542.
• Build-stage Rd macros \packageAuthor and \packageMaintainer now
process Authors@R, fixing NA results when the package DESCRIPTION
omits Author and Maintainer fields.
• Formatting and printing complex numbers could give things like
0.1683-0i because of rounding error: -0i is now replaced by +0i.
• postscript() refused to accept a title comment containing the
letter “W” (PR#18599).
• isoreg(c(1,Inf)) signals an error instead of segfaulting, fixing
PR#18603.
• tiff(type = "Xlib") was only outputting the last page of
multi-page plots.
• tools::latexToUtf8() again knows about \~{n} and other letters
with tilde, fixing a regression in R 4.3.0, and about \^{i} as an
alternative to \^{\i} (similarly with other accents).
Furthermore, LaTeX codes for accented I letters are now correctly
converted, also fixing related mistakes in
tools::encoded_text_to_latex().
• tar(*, tar = "internal") no longer creates out-of-spec tar files
in the very rare case of user or group names longer than 32
bytes, fixing PR#17871 with thanks to Ivan Krylov.
• When using the “internal” timezone datetime code, adding a
fraction of a second no longer adds one second, fixing PR#16856
from a patch by Ivan Krylov.
• tools::checkRd() no longer produces spurious notes about
“unnecessary braces” from multi-line Rd results of \Sexpr macros.
CHANGES IN R 4.3.1:
C-LEVEL FACILITIES:
• The C-level API version of R's integrate(), Rdqags() in Applic.h,
now returns the correct number of integrand evaluations neval,
fixing PR#18515 reported and diagnosed by Stephen Wade.
• The C prototypes for LAPACK calls dspgv and dtptrs in
R_ext/Lapack.h had one too many and one too few character length
arguments - but this has not caused any known issues. To get the
corrected prototypes, include
#include <Rconfig.h> // for PR18534fixed
#ifdef PR18534fixed
# define usePR18534fix 1
#endif
#include <R_ext/Lapack.h>
in your C/C++ code (PR#18534).
INSTALLATION:
• Many of the checks of esoteric Internet operations and those
using unreliable external sites have been moved to a new target
that is not run by default and primarily intended for the core
developers. To run them use
cd tests; make test-Internet-dev
BUG FIXES:
• .S3methods(), typically called from methods(), again marks
methods from package base as visible.
Also, the visibility of non-base methods is again determined by
the method's presence in search().
• tools::Rdiff() is now more robust against invalid strings, fixing
installation tests on Windows without Rtools installed
(PR#18530).
• Fix (new) bug in hcl.colors(2, *), by Achim Zeileis (PR#18523).
• head(., <illegal>) and tail(..) now produce more useful "Error in
...." error messages, fixing PR#18362.
• Package code syntax on Windows is checked in UTF-8 when UTF-8 is
the native encoding.
• na.contiguous(x) now also returns the first run, when it is at
the beginning and there is a later one of the same length;
reported to R-devel, including a fix, by Georgi Boshnakov.
Further, by default, it modifies only an existing attr(*,"tsp")
but otherwise no longer sets one.
• chol(<not pos.def>, pivot = <T|F>) now gives a correct error or
warning message (depending on pivot), thanks to Mikael Jagan's
(PR#18541).
CHANGES IN R 4.3.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• Calling && or || with LHS or (if evaluated) RHS of length greater
than one is now always an error, with a report of the form
'length = 4' in coercion to 'logical(1)'
Environment variable _R_CHECK_LENGTH_1_LOGIC2_ no longer has any
effect.
NEW FEATURES:
• The included BLAS sources have been updated to those shipped with
LAPACK version 3.10.1. (This caused some platform-dependent
changes to package check output.) And then to the sources from
LAPACK version 3.11.0 (with changes only to double complex
subroutines).
• The included LAPACK sources have been updated to include the four
Fortran 90 routines rather than their Fortran 77 predecessors.
This may give some different signs in SVDs or
eigendecompositions.. (This completes the transition to LAPACK
3.10.x begun in R 4.2.0.)
• The LAPACK sources have been updated to version 3.11.0. (No new
subroutines have been added, so this almost entirely bug fixes:
Those fixes do affect some computations with NaNs, including R's
NA.)
• The parser now signals _classed_ errors, notably in case of the
pipe operator |>. The error object and message now give line and
column numbers, mostly as proposed and provided by Duncan Murdoch
in PR#18328.
• toeplitz() is now generalized for asymmetric cases, with a
toeplitz2() variant.
• xy.coords() and xyz.coords() and consequently, e.g., plot(x,y,
log = "y") now signal a _classed_ warning about negative values
of y (where log(.) is NA). Such a warning can be specifically
suppressed or caught otherwise.
• Regular expression functions now check more thoroughly whether
their inputs are valid strings (in their encoding, e.g. in
UTF-8).
• The performance of grep(), sub(), gsub() and strsplit() has been
improved, particularly with perl = TRUE and fixed = TRUE. Use of
useBytes = TRUE for performance reasons should no longer be
needed and is discouraged: it may lead to incorrect results.
• apropos() gains an argument dot_internals which is used by the
completion (help(rcompgen)) engine to also see base internals
such as .POSIXct().
• Support in tools::Rdiff() for comparing uncompressed PDF files is
further reduced - see its help page.
• qqplot(x, y, ...) gains conf.level and conf.args arguments for
computing and plotting a confidence band for the treatment
function transforming the distribution of x into the distribution
of y (Switzer, 1976, _Biometrika_). Contributed by Torsten
Hothorn.
• Performance of package_dependencies() has been improved for cases
when the number of dependencies is large.
• Strings newly created by gsub(), sub() and strsplit(), when any
of the inputs is marked as "bytes", are also marked as "bytes".
This reduces the risk of creating invalid strings and accidental
substitution of bytes deemed invalid.
• Support for readLines(encoding = "bytes") has been added to allow
processing special text files byte-by-byte, without creating
invalid strings.
• iconv(from = "") now takes into account any declared encoding of
the input elements and uses it in preference to the native
encoding. This reduces the risk of accidental creation of
invalid strings, particularly when different elements of the
input have different encoding (including "bytes").
• Package repositories in getOption("repos") are now initialized
from the repositories file when utils is loaded (if not already
set, e.g., in .Rprofile). (From a report and patch proposal by
Gabriel Becker in PR#18405.)
• compactPDF() gets a verbose option.
• type.convert() and hence read.table() get new option tryLogical =
TRUE with back compatible default. When set to false, converts
"F" or "T" columns to character.
• Added new unit prefixes "R" and "Q" for abbreviating
(unrealistically large) sizes beyond 10^{27} in standard = "SI",
thanks to Henrik Bengtsson's PR#18435.
• as.data.frame()'s default method now also works fine with atomic
objects inheriting from classes such as "roman", "octmode" and
"hexmode", thus fulfilling the wish of PR#18421, by Benjamin
Feakins.
• The as.data.frame.vector() utility now errors for wrong-length
row.names. It warned for almost six years, with “Will be an
error!”.
• sessionInfo() now also contains La_version() and reports codepage
and timezone when relevant, in both print() and toLatex() methods
which also get new option tzone for displaying timezone
information when locale = FALSE.
• New function R_compiled_by() reports the C and Fortran compilers
used to build R, if known.
• predict(<lm>, newdata = *) no longer unnecessarily creates an
offset of all 0s.
• solve() for complex inputs now uses argument tol and by default
checks for ‘computational singularity’ (as it long has done for
numeric inputs).
• predict(<rank-deficient lm>, newdata=*) now obeys a new argument
rankdeficient, with new default "warnif", warning only if there
are non-estimable cases in newdata. Other options include
rankdeficient = "NA", predicting NA for non-estimable newdata
cases. This addresses PR#15072 by Russ Lenth and is based on his
original proposal and discussions in PR#16158 also by David Firth
and Elin Waring. Still somewhat experimental.
• Rgui console implementation now works better with the NVDA screen
reader when the full blinking cursor is selected. The underlying
improvements in cursor handling may help also other screen
readers on Windows.
• The drop-field control in GraphApp can now be left with the TAB
key and all controls can be navigated in the reverse order using
the Shift+TAB key, improving accessibility of the Rgui
configuration editor.
• qnorm(<very large negative>, log.p=TRUE) is now fully accurate
(instead of to “only” minimally five digits).
• demo(error.catching) now also shows off withWarnings() and
tryCatchWEMs().
• As an experimental feature the placeholder _ can now also be used
in the rhs of a forward pipe |> expression as the first argument
in an extraction call, such as _$coef. More generally, it can be
used as the head of a chain of extractions, such as _$coef[[2]].
• Spaces in the environment variable used to choose the R session's
temporary directory (TMPDIR, TMP and TEMP are tried in turn) are
now fatal. (On Windows the ‘short path’ version of the path is
tried and used if that does not contain a space.)
• all.equal.numeric() gets a new optional switch giveErr to return
the numeric error as attribute. Relatedly,
stopifnot(all.equal<some>(a, b, ..)) is as “smart” now, as
stopifnot(all.equal(....)) has been already, thus allowing
customized all.equal<Some>() wrappers.
• R on Windows is now able to work with path names longer than 260
characters when these are enabled in the system (requires at
least Windows 10 version 1607). Packages should be updated to
work with long paths as well, instead of assuming PATH_MAX to be
the maximum length. Custom front-ends and applications embedding
R need to update their manifests if they wish to allow this
feature. See
<https://blog.r-project.org/2023/03/07/path-length-limit-on-windows>
for more information.
• ‘Object not found’ and ‘Missing argument’ errors now give a more
accurate error context. Patch provided by Lionel Henry in
PR#18241.
• The @ operator is now an S3 generic. Based on contributions by
Tomasz Kalinowski in PR#18482.
• New generic chooseOpsMethod() provides a mechanism for objects to
resolve cases where two suitable methods are found for an Ops
Group Generic. This supports experimenting with alternative
object systems. Based on contributions by Tomasz Kalinowski in
PR#18484.
• inherits(x, what) now accepts values other than a simple
character vector for argument what. A new generic, nameOfClass(),
is called to resolve the class name from what. This supports
experimenting with alternative object systems. Based on
contributions by Tomasz Kalinowski in PR#18485.
• Detection of BLAS/LAPACK in use (sessionInfo()) with FlexiBLAS
now reports the current backend.
• The "data.frame" method for subset() now warns about extraneous
arguments, typically catching the use of = instead of == in the
subset expression.
• Calling a:b when numeric a or b is longer than one may now be
made into an error by setting environment variable
_R_CHECK_LENGTH_COLON_ to a true value, along the proposal in
PR#18419 by Henrik Bengtsson.
• density(x, weights = *) now warns if automatic bandwidth
selection happens without using weights; new optional warnWbw may
suppress the warning. Prompted by Christoph Dalitz' PR#18490 and
its discussants.
• rm(list = *) is faster and more readable thanks to Kevin Ushey's
PR#18492.
• The plot.lm() function no longer produces a normal Q-Q plot for
GLMs. Instead it plots a half-normal Q-Q plot of the absolute
value of the standardized deviance residuals.
• The print() method for class "summary.glm" no longer shows
summary statistics for the deviance residuals by default. Its
optional argument show.residuals can be used to show them if
required.
• The tapply() function now accepts a data frame as its X argument,
and allows INDEX to be a formula in that case. by.data.frame()
similarly allows INDICES to be a formula.
• The performance of df[j] <- value (including for missing j) and
write.table(df) has been improved for data frames df with a large
number of columns. (Thanks to Gabriel Becker's PR#18500,
PR#18503 and discussants, prompted by a report from Toby Dylan
Hocking on the R-devel mailing list.)
• The matrix multiply operator %*% is now an S3 generic, belonging
to new group generic matrixOps. From Tomasz Kalinowski's
contribution in PR#18483.
• New function array2DF() to convert arrays to data frames,
particularly useful for the list arrays created by tapply().
DATES and TIMES:
• On platforms where (non-UTC) datetimes before 1902 (or before
1900 as with system functions on recent macOS) are guessed by
extrapolating time zones from 1902-2037, there is a warning at
the first use of extrapolation in a session. (As all time zones
post 2037 are extrapolation, we do not warn on those.)
• (Platforms using --with-internal-tzone, including Windows and by
default macOS). How years are printed in dates or date-times can
be controlled by environment variable R_PAD_YEARS_BY_ZERO. The
default remains to pad to 4 digits by zeroes, but setting value
no gives no padding (as used by default by glibc).
• strftime() tries harder to determine the offset for the "%z"
format, and succeeds on the mainstream R platforms.
• strftime() has a limit of 2048 bytes on the string produced -
attempting to exceed this is an error. (Previously it silently
truncated at 255 bytes.)
• sessionInfo() records (and by default prints) the system time
zone as part of the locale information. Also, the source
(system/internal) of the date-time conversion and printing
functions.
• Objects of class "POSIXlt" created in this version of R always
have 11 components: component zone is always set, and component
gmtoff is set for times in UTC and usually set on the (almost
all) platforms which have C-level support, otherwise is NA.
• There are comprehensive validity checks on the structure of
objects of class "POSIXlt" when converting (including formatting
and printing). (This avoids mis-conversions of hand-crafted
objects.)
• There is some support for using the native date-time routines on
macOS: this is only viable on recent versions (e.g. 12.6 and 13)
and does get wrong some historical changes (before 1900, during
WWII). Use of --with-internal-tzone remains the default.
• as.POSIXct(<numeric>) and as.POSIXlt(.) (without specifying
origin) now work. So does as.Date(<numeric>).
• as.Date.POSIXct(., tz) now treats several tz values, notably
"GMT" as equivalent to "UTC", proposed and improved by Michael
Chirico and Joshua Ulrich in PR#17674.
• Experimental balancePOSIXlt() utility allows using “ragged” and
or out-of-range "POSIXlt" objects more correctly, e.g., in
subsetting and subassignments. Such objects are now documented.
Complemented by the low-level unCfillPOSIXlt() utility.
More experimentally, a "POSIXlt" object may have an attribute
"balanced" indicating if it is known to be filled or fully
balanced.
• Functions axis.Date() and axis.POSIXct() are rewritten to gain
better default tick locations and better default formats via the
corresponding pretty() methods. Thanks to Swetlana Herbrandt.
• The mapping of Windows' names for time zones to IANA's ‘Olson’
names has been updated. When ICU is available (it is by
default), it is used to get a mapping for the current region set
in Windows. This can be overridden by setting environment
variable TZ to the desired Olson name - see OlsonNames() for
those currently available.
GRAPHICS:
• The graphics engine version, R_GE_version, has been bumped to 16
and so packages that provide graphics devices should be
reinstalled.
• The grDevices and grid packages have new functions for rendering
typeset glyphs, primarily: grDevices::glyphInfo() and
grid::grid.glyph().
Rendering of typeset glyphs is only supported so far on the
Cairo-based graphics devices and on the pdf() and quartz()
devices.
• The defined behaviour for "clear" and "source" compositing
operators (via grid::grid.group()) has been changed (to align
better with simple interpretation of original Porter-Duff
definitions).
• Support for gradients, patterns, clipping paths, masks, groups,
compositing operators, and affine transformations has been added
to the quartz() device.
INSTALLATION on a UNIX-ALIKE:
• A system installation of generic LAPACK 3.10.0 or later will be
preferred to the version in the R sources.
configure option --with-lapack=no (equivalently --without-lapack)
forces compilation of the internal LAPACK sources.
If --with-lapack is not specified, a system liblapack is looked
for and used if it reports version 3.10.0 or later and does not
contain BLAS routines.
Packages using LAPACK will need to be reinstalled if this changes
to using an external library.
• On aarch64 Linux platforms using GCC, configure now defaults to
-fPIC (instead of -fpic), as desired in PR#18326.
• configure now checks conversion of datetimes between POSIXlt and
POSIXct around year 2020. Failure (which has been seen on
platforms missing tzdata) is fatal.
• If configure option --with-valgrind-instrumentation is given
value 1 or 2, option --with-system-valgrind-headers is now the
default and ignored (with a warning). It is highly recommended
that the system headers are installed alongside valgrind: they
are part of its packaging on some Linux distributions and
packaged separately (e.g. in the valgrind-devel RPM) on others.
configure will give a warning if they are not found.
The system headers will be required in a future release of R to
build with valgrind instrumentation.
• libcurl 8.x is now accepted by configure: despite a change in
major version number it changes neither API nor ABI.
INSTALLATION on WINDOWS:
• The makefiles and installer scripts for Windows have been
tailored to Rtools43, an update of the Rtools42 toolchain. It is
based on GCC 12 and newer versions of MinGW-W64, binutils and
libraries. At this time R-devel can still be built using
Rtools42 without changes, but when R-devel is installed via the
installer, it will by default look for Rtools43.
• Old make targets rsync-extsoft and 32-bit ones that are no longer
needed have been removed.
• Default builds (including for packages) no longer select C99.
Thus the C standard used is the default for the compiler, which
for the toolchain in Rtools43 is C17. (This is consistent with
Unix builds.)
PACKAGE INSTALLATION:
• The default C++ standard has been changed to C++17 where
available (which it is on all currently checked platforms): if
not C++14 or C++11 is used if available otherwise C++ is not
supported.
• USE_FC_LEN_T is the default: this uses the correct
(compiler-dependent) prototypes for Fortran BLAS/LAPACK routines
called from C/C++, and requires adjustment of many such calls -
see ‘Writing R Extensions’ §6.6.1.
• There is initial support for C++23 as several compilers are now
supporting -std=c++23 or -std=c++2b or similar. As for C++20,
there no additional configure checks for C++23 features beyond a
check that the compiler reports a __cplusplus value greater than
that in the C++20 standard. C++ feature tests should be used.
• There is support for a package to indicate the version of the C
standard which should be used to compile it, and for the
installing user to specify this. In most cases R defaults to the
C compiler's default standard which is C17 (a `bug-fix' of C11) -
earlier versions of R or compilers may have defaulted to C99.
Current options are:
USE_C17 Use a standard that is at most C17. The intention is to
allow legacy packages to still be installed when later C
standards become the default, including packages using new
keywords as identifiers or with K&R-style function
declarations. This will use C17 if available, falling back
to C11.
USE_C90 Use the C90 (aka C89) standard. (As that standard did
not require compilers to identify that version, all we can
verify is that the compiler does not claim to be using a
later standard. It may accept C99 features - for example
clang accepts // to make comments.)
USE_C99 Use the C99 standard. This should be rarely needed - it
avoids the few new features of C11/C17 which can be useful if
a package assumes them if C17 is specified and they are not
implemented.
USE_C23 Use C23 (or in future, later). Compiler/library support
for C23 is still being implemented, but LLVM clang from
15.0.0 and GCC from 13 have quite extensive support.
These can be specified as part of the SystemRequirements field in
the package's DESCRIPTION file or _via_ options --use-C17 and so
on of R CMD INSTALL and R CMD SHLIB.
For further details see “Writing R Extensions” §1.2.5.
• (Windows) A src/Makefile.ucrt or src/Makefile.win file is now
included after <R_HOME>/etc<R_ARCH>/Makeconf and so no longer
needs to include that file itself. Installation of a package
with such a file now uses a site Makevars file in the same way as
a package with a src/Makevars.win file would.
• configure is now passed crucial variables such as CC and CFLAGS
in its environment, as many packages were not setting them (as
documented in ‘Writing R Extensions’ §1.2).
This has most effect where configure is used to compile parts of
the package - most often by cmake or libtool which obfuscate the
actual compile commands used.
Also used for configure.win and configure.ucrt on Windows.
FORTRAN FLAGS:
• The flag -fno-optimize-sibling-calls is no longer forced for
gfortran 7 and later. It should no longer be needed now using
‘hidden’ character-length arguments when calling BLAS/LAPACK
routines from C/C++ is the default even for packages. (Unless
perhaps packages call Fortran code from C/C++ without using R's
headers and without allowing for these arguments.)
C-LEVEL FACILITIES:
• The deprecated S-compatibility macros DOUBLE_* in
R_ext/Constants.h (included by R.h) have been removed.
• The deprecated legacy typedefs of Sint and Sfloat in header R.h
are no longer defined, and that header no longer includes header
limits.h from C nor climits from C++.
• New macro CAD5R() is provided in Rinternals.h and used in a few
places in the R sources.
• ALTREP now supports VECSXP vectors. Contributed by Gabor Csardi
in PR#17620.
• The Rcomplex definition (in header R_ext/Complex.h) has been
extended to prevent possible mis-compilation when interfacing
with Fortran (PR#18430). The new definition causes compiler
warnings with static initializers such as {1, 2}, which can be
changed to {.r=1, .i=2}.
Using the new definition from C++ depends on compiler extensions
supporting C features that have not been incorporated into the
C++ standards but are available in g++ and clang++: this may
result in C++ compiler warnings but these have been worked around
for recent versions of common compilers (GCC, Apple/LLVM clang,
Intel).
It is intended to change the inclusion of header R_ext/Complex.h
by other R headers, so C/C++ code files which make use of
Rcomplex should include that header explicitly.
UTILITIES:
• R CMD check does more checking of package .Rd files, warning
about invalid email addresses and (some) invalid URIs and noting
empty \item labels in description lists.
• R CMD check now also reports problems when reading package news
in md (file NEWS.md) and (optionally) plain text (file NEWS)
formats.
• _R_CHECK_TIMINGS_ defaults to a value from the environment even
for R CMD check --as-cran; this allows for exceptionally fast or
slow platforms.
It now applies to checking PDF and HTML versions of the manuals,
and ‘checking CRAN incoming feasibility’.
• R CMD check can optionally (but included in --as-cran) check
whether HTML math rendering _via_ KaTeX works for the package .Rd
files.
• Non-interactive debugger invocations can be trapped by setting
the environment variable _R_CHECK_BROWSER_NONINTERACTIVE_ to a
true value. This is enabled by R CMD check --as-cran to detect
the use of leftover browser() statements in the package.
• The use of sprintf and vsprintf from C/C++ has been deprecated in
macOS 13 and is a known security risk. R CMD check now reports
(on all platforms) if their use is found in compiled code:
replace by snprintf or vsnprintf respectively. [*NB:* whether
such calls get compiled into the package is platform-dependent.]
• Where recorded at installation, R CMD check reports the C and
Fortran compilers used to build R.
It reports the OS in use (if known, as given by osVersion) as
well as that R was built for.
It notes if a C++ standard was specified which is older than the
current default: many packages have used C++11 to mean ‘not
C++98’ - as C++11 is the minimum supported since R 4.0.0, that
specification can probably be removed.
• R CMD INSTALL reports the compilers (and on macOS, the SDK) used,
and this is copied to the output of R CMD check.
Where a C++ standard is specified, it is reported.
• R CMD check's ‘checking compilation flags in Makevars’ has been
relaxed to accept the use of flags such as -std=f2008 in
PKG_FFLAGS.
• tools::buildVignettes() has a new argument skip, which is used by
R CMD check to skip (and note) vignettes with unavailable
\VignetteDepends (PR#18318).
• New generic .AtNames() added to enable class-specific completions
after @. The formerly internal function findMatches() is now
exported, mainly for use in methods for .DollarNames() and
.AtNames().
DEPRECATED AND DEFUNCT:
• default.stringsAsFactors() is defunct.
• Calling as.data.frame.<class>() directly (for 12 atomic classes)
is going to be formally deprecated, currently activated by
setting the environment variable
_R_CHECK_AS_DATA_FRAME_EXPLICIT_METHOD_ to non-empty, which also
happens in R CMD check --as-cran.
BUG FIXES:
• Hashed environments with sizes less than 5 can now grow.
(Reported to R-devel by Duncan Garmonsway.)
• as.character(<Rd>, deparse = TRUE) failed to re-escape curly
braces in LaTeX-like text. (Reported by Hadley Wickham in
PR#18324.)
• library() now passes its lib.loc argument when requiring Depends
packages; reported (with fix) in PR#18331 by Mikael Jagan.
• R CMD Stangle: improved message about ‘Output’ files.
• head(x, n) and tail(x, n) now signal an error if n is not
numeric, instead of incidentally “working” sometimes returning
all of x. Reported and discussed by Colin Fay, in PR#18357.
• The "lm" method for summary() now gives the correct F-statistic
when the model contains an offset. Reported in PR#18008.
• C() and `contrasts<-`() now preserve factor level names when
given a function object (as opposed a function name which did
preserve names). Reported in PR#17616.
• c(a = 1, 2)[[]] no longer matches 2 but rather signals a
_classed_ error. Reported and analysed by Davis Vaughan in
PR#18367, a duplicate of PR#18004, by Jan Meis et al. For
consistency, NULL[[]] is also erroneous now. x[[]] <- v gives an
error of the same class "MissingSubscriptError".
• The relist() function of utils now supports NULL elements in the
skeleton (PR#15854).
• ordered(levels = *) (missing x) now works analogously to factor(,
ordered=TRUE); reported (with fix) by Achim Zeileis in PR#18389.
• User-defined Rd macro definitions can now span multiple lines,
thanks to a patch from Duncan Murdoch. Previously, the Rd parser
silently ignored everything after the first line.
• Plain-text help (tools::Rd2txt()) now preserves an initial blank
line for text following description list items.
• tools::Rd2HTML() and tools::Rd2latex() no longer split \arguments
and \value lists at Rd comments.
• tools::Rd2latex() now correctly handles optional text outside
\items of argument lists as well as bracketed text at the
beginning of sections, e.g., \value{[NULL]}.
• as.character(<POSIXt>) now behaves more in line with the methods
for atomic vectors such as numbers, and is no longer influenced
by options(). Ditto for as.character(<Date>). The
as.character() method gets arguments digits and OutDec with
defaults _not_ depending on options(). Use of as.character(*,
format = .) now warns.
• Similarly, the as.character.hexmode() and *.octmode() methods
also behave as good citizen methods and back compatibility option
keepStr = TRUE.
• The as.POSIXlt(<POSIXlt>) and as.POSIXct(<POSIXct>) default
methods now do obey their tz argument, also in this case.
• as.POSIXlt(<Date>) now does apply a tz (time zone) argument, as
does as.POSIXct(); partly suggested by Roland Fuß on the R-devel
mailing list.
• as.Date.POSIXlt(x) now also works when the list components are of
unequal length, aka “partially filled” or “ragged”.
• expand.model.frame() looked up variables in the wrong environment
when applied to models fitted without data. Reported in
PR#18414.
• time() now (also) uses the ts.eps = getOption("ts.eps") argument
and thus by default rounds values very close to the start (or
end) of a year. Based on a proposal by Andreï V. Kostyrka on
R-help.
• Printing of a factanal() result with just one factor and sort =
TRUE now works regularly, fixing PR#17863 by Timothy Bates,
thanks to the ‘R Contributors’ working group.
• Printing 0-length objects of class "factor", "roman", "hexmode",
"octmode", "person", "bibentry", or "citation" now prints
something better, one of which fixes PR#18422, reported by
Benjamin Feakins.
• Sys.timezone() queries timedatectl only if systemd is loaded;
addressing a report by Jan Gorecki in PR#17421.
• The formula method of cor.test() had scoping problems when
environment(formula) was not the calling environment; reported
with a patch proposal by Mao Kobayashi in PR#18439.
• attach() of an environment with active bindings now preserves the
active bindings. Reported by Kevin Ushey in PR#18425.
• BLAS detection now works also with system-provided libraries not
available as regular files. This fixes detection of the
Accelerate framework on macOS since Big Sur. Reported by David
Novgorodsky.
• download.file() gives a helpful error message in case of an
invalid download.file.method option, thanks to Colin Fay's report
in PR#18455.
• Sporadic crashes of Rterm when using completion have been fixed.
• Rprof() is now more reliable. A livelock in thread
initialization with too short sampling interval has been fixed on
macOS. A deadlock in using the C runtime has been fixed on
Windows. A potential deadlock has been prevented on Unix.
• Cursor placement in Rgui now works even after a fixed-width font
is selected.
• Mandatory options (options()) are now set on startup so that
saving and restoring them always works (PR#18372).
• Package installation, R CMD INSTALL or install.packages(*), now
parses each of the <pkg>/R/*.R files individually instead of
first concatenating and then parse()ing the large resulting file.
This allows parser or syntax errors to be diagnosed with correct
file names and line numbers, thanks to Simon Dedman's report and
Bill Dunlap's patch in PR#17859.
This _does_ require syntactically self contained R source files
now, fixing another inadvertent bug.
• predict.lm(<model with offset>) now finds the offset in the
correct environment, thanks to André Gillibert's report and patch
in PR#18456.
• getInitial(<formula>) now finds the selfStart model in the
correct environment. (Reported by Ivan Krylov in PR#18368.)
• Fix for possible segfault when using recently-added graphics
features, such as gradients, clipping paths, masks, and groups
with pdf(file=NULL).
• class(m) <- class(m) no longer changes a matrix m by adding a
class _attribute_.
• packageDate(pkg) now only warns once if there is no pkg.
• When ts() creates a multivariate time series, "mts", it also
inherits from "array" now, and is.mts() is documented _and_
stricter.
• Rd2txt() now preserves line breaks of \verb Rd content and from
duplicated \cr. The former also fixes the rendering of verbatim
output from Rd \Sexpr in plain-text help.
• uniroot(f, interval) should no longer wrongly converge _outside_
the interval in some cases where abs(f(x)) == Inf for an x at the
interval boundary, thanks to posts by Ben Bolker and Serguei
Sokol on R-devel.
• Vectorized alpha handling in palette functions such as in gray(),
rainbow(), or hcl.colors() works correctly now, thanks to Achim
Zeileis' report and patch in PR#18476.
• Formatting and print()ing of bibentry objects has dropped the
deprecated citation.bibtex.max argument, such that the bibtex
argument's default for print.bibentry() depends directly on the
citation.bibtex.max option, whereas in format.bibentry() the
option no longer applies.
• Attempting to use a character string naming a foreign function
entry point in a foreign function call in a package will now
signal an error if the packages has called R_forceSymbols to
specify that symbols must be used.
• An error in table() could permanently set options(warn=2)
promoting all subsequent warnings to errors.
• The sigma() function gave misleading results for binary GLMs. A
new method for objects of class "glm" returns the square root of
the estimate of the dispersion parameter using the same
calculation as summary.glm().
• bs() and ns() in the (typical) case of automatic knot
construction, when some of the supposedly inner knots coincide
with boundary knots, now moves them inside (with a warning),
building on PR#18442 by Ben Bolker.
• R CMD on Windows now skips the site profile with --no-site-file
and --vanilla even when R_PROFILE is set (PR#18512, from Kevin
Ushey).
CHANGES IN R 4.2.3:
C-LEVEL FACILITIES:
• The definition of DL_FUNC in R_ext/Rdynload.h has been changed to
be fully C-compliant. This means that functions loaded _via_ for
example R_GetCCallable need to be cast to an appropriate type if
they have any arguments.
• .Machine has a new element sizeof.time_t to identify old systems
with a 32-bit type and hence a limited range of date-times (and
limited support for dates millions of years from present).
PACKAGE INSTALLATION:
• (Windows) The default C++ standard had accidentally been left at
C++11 when it was changed to C++14 on Unix.
BUG FIXES:
• As "POSIXlt" objects may be “partially filled” and their list
components meant to be recycled, length() now is the length of
the longest component.
• as.POSIXlt.Date() could underflow for dates in the far past (more
than half a million years BCE).
• as.Date.POSIXlt(x) would return "1970-01-01" instead of NA in R
4.2.2, e.g., for
x <- as.POSIXlt(c("2019-01-30","2001-1-1"))
x$mon <- c(0L, NA); as.Date(x)
• R CMD check failed to apply enabled _R_CHECK_SUGGESTS_ONLY_ to
examples and vignettes (regression in R 4.2.0).
• R CMD check did not re-build vignettes in separate processes by
default (regression in R 4.2.0).
• Running examples from HTML documentation now restores previous
knitr settings and options (PR#18420).
• Quartz: fonts are now located using Core Graphics API instead of
deprecated ATS which is no longer supported in the macOS 13 SDK
(PR#18426). This also addresses an issue where the currently
used font in the Quartz device context was not correctly
retained.
• (Windows) Math symbols in text drawing functions are again
rendered correctly (PR#18440). This fixes a regression in R
4.2.1 caused by a fix in PR#18382 which uncovered an issue in
GraphApp due to which the symbol charset was not used with TT
Symbol font face.
• (Windows) Installing a package with a src/Makefile.{win,ucrt}
file includes ~/.R/Makevars.win64 in the search for user
makevars, as documented in “R Installation and Administration”
and done for packages with a src/Makevars.{win,ucrt} file.
• format(<POSIXlt_w/_unbalanced_sec>, "....%OS<n>") with n > 0 no
longer accidentally uses the unbalanced seconds, thanks to
Suharto Anggono's report (including patch) in PR#18448.
• solve.default(a, b) works around issues with some versions of
LAPACK when a contains NA or NaN values.
• When UseMethod() cannot dispatch, it no longer segfaults
producing the error message in case of a long class(), thanks to
Joris Vankerschaver's report (including patch) in PR#18447.
• When example(foo, ..) produces graphics on an interactive device
it needs to open itself, it now leaves devAskNewPage() unchanged
even when it was FALSE, thus fixing a 14 years old ‘FIXME’.
• packageDescription() again catches errors from encoding
conversions. This also fixes broken packageVersion() in C locale
on systems where iconv does not support transliteration.
CHANGES IN R 4.2.2:
NEW FEATURES:
• tools::Rdiff(useDiff = TRUE) checks for the presence of an
external diff command and switches to useDiff = FALSE if none is
found. This allows R CMD Rdiff to always work.
• On Windows, environment variable R_LIBCURL_SSL_REVOKE_BEST_EFFORT
can be used to switch to only ‘best-effort’ SSL certificate
revocation checks with the default "libcurl" download method.
This reduces security, but may be needed for downloads to work
with MITM proxies (PR#18379).
• (macOS) The run-time check for libraries from XQuartz for X11 and
Tcl/Tk no longer uses otool from the Apple Developer Tools
(PR#18400).
• The LaTeX style for producing the PDF manuals, Rd.sty, now loads
the standard amsmath, amsfonts and amssymb packages for greater
coverage of math commands in the Rd \eqn and \deqn macros. The
\mathscr LaTeX command is also provided (via the mathrsfs
package, if available, or the amsfonts bundle otherwise),
fulfilling the wish of PR#18398.
• (Windows) The default format of readClipboard() and
writeClipboard() has been changed to 13 (CF_UNICODETEXT).
INSTALLATION on a UNIX-ALIKE:
• The PDF manuals (if built) can be compacted by the new target
make compact-pdf (at the top level or in directory doc/manual).
• There is now configure support for LLVM clang 15 on Linux, which
defaults to position-independent (PIE) executables whereas
gfortran does not.
• Many small changes to ease compilation (and suppress warnings)
with LLVM clang 15.
BUG FIXES:
• Rscript -e would fail if stdin were closed (Reported by Henrik
Bengtsson.)
• qt(*, log.p=TRUE) in outer tails no longer produces NaN in its
final steps, thus fixing PR#18360.
• tools::Rd2latex() now escapes hashes and ampersands when writing
URLs, fixing LaTeX errors with such URLs in \tabular.
• When isGeneric(f, fdef=*) is used with mismatching names, the
warning is better understandable; reported (with fix) in PR#18370
by Gabe Becker.
• poly(x, n) now works again (and is now documented) when x is a
"Date" or "POSIXct" object, or of another class while fulfilling
mode(x) == "numeric". This also enables poly(x, *, raw=TRUE) for
such variables. Reported by Michael Chirico to R-devel.
• write.table(), write.csv() and write.csv2() restore their
numerical precision (internal equivalent of digits = 15) after an
interrupt (PR#18384).
• One can now read also byte FF from a clipboard connection
(PR#18385).
• source("") and source(character()) now give more helpful error
messages.
• R CMD check --as-cran set _R_CHECK_TIMINGS_ too late to have the
intended effect.
• as.POSIXlt(x) now also works with very large dates x, fixing
PR#18401 reported by Hannes Mühleisen.
• Files can now be extracted even from very large zip archives
(PR#18390, thanks to Martin Jakt).
• Non-finite objects of class "POSIXlt" are now correctly coerced
to classes "Date" and "POSIXct"; following up on the extension to
format() them correctly.
• Added methods for is.finite(), is.infinite() and is.nan() for
"POSIXlt" date-time objects.
BUG FIXES on Windows:
• Non-ASCII characters are now properly displayed on Windows in
windows created using GraphApp via e.g. winDialogString thanks to
a workaround for an at least surprising Windows behavior with
UTF-8 as the system encoding (PR#18382).
• Find and replace operations work again in the script editor in
Rgui on Windows.
• Computation of window size based on requested client size in
GraphApp when running in a multi-byte locale on Windows has been
fixed (regression in R 4.2.0 for users of systems where R 4.1
used a single-byte locale). Rgui again respects the number of
console rows and columns given in Rconsole file.
• Rterm support for Alt+xxx sequences has been fixed to produce the
corresponding character (only) once. This fixes pasting text with
tilde on Italian keyboard (PR#18391).
CHANGES IN R 4.2.1:
NEW FEATURES:
• New function utils::findCRANmirror() to find out if a CRAN mirror
has been selected, otherwise fallback to the main site. This
behaves in the same way as tools::CRAN_package_db() and is
intended for packages wishing to access CRAN for purposes other
than installing packages.
The need for this was shown by a day when the main CRAN website
was offline and a dozen or so packages which had its URL
hardcoded failed their checks.
INSTALLATION on a UNIX-ALIKE:
• The libraries searched for by --with-blas (without a value) now
include BLIS (after OpenBLAS but before ATLAS). And on macOS,
the Accelerate framework (after ATLAS). (This is patterned after
the AX_BLAS macro from the Autoconf Archive.)
• The included LAPACK sources have been updated to 3.10.1.
UTILITIES:
• The (full path to) the command tidy to be used for HTML
validation can be set by environment variable R_TIDYCMD.
• Setting environment variable _R_CHECK_RD_VALIDATE_RD2HTML_ to a
false value will override R CMD check --as-cran and turn off HTML
validation. This provides a way to circumvent a problematic
tidy.
The 2006 version that ships with macOS is always skipped.
C-LEVEL FACILITIES:
• The undocumented legacy declarations of Sint, Sfloat, SINT_MAX
and SINT_MIN in header R.h are deprecated.
BUG FIXES:
• fisher.test(d) no longer segfaults for “large” d; fixing PR#18336
by preventing/detecting an integer overflow reliably.
• tar(., files=*) now produces correctly the warning about invalid
UID or GID of files, fixing PR#18344, reported by Martin Morgan.
• tk_choose.files() with multi = FALSE misbehaved on paths
containing spaces (PR#18334) (regression introduced in R 4.0.0).
• sort(x, partial = ind, *) now works correctly notably for the
non-default na.last = FALSE or TRUE, fixing PR#18335 reported by
James Edwards.
• Environment variable _R_CHECK_XREFS_REPOSITORIES_ is only used
for checking .Rd cross-references in R CMD check (as documented)
and not for other uses looking for a CRAN mirror.
• The search for a CRAN mirror when checking packages now uses
getOption("repos") if that specifies a CRAN mirror, even when it
does not also specify all three Bioconductor repositories (as was
previously required).
• The HTML code generated by tools::Rd2HTML() has been improved to
pass tidy 5.8.0.
BUG FIXES on Windows:
• Writing to a clipboard connection works again, fixing a
regression in R 4.2.0 (PR#18332). Re-using a closed clipboard
connection no longer issues a spurious warning about an ignored
encoding argument.
• C function getlocale no longer attempts to query an unsupported
category from the OS, even when requested at R level, which may
cause crashes when R 4.2.0 (which uses UCRT) is embedded
(reported by Kevin Ushey).
• Accent keys now work in GraphApp Unicode windows, which are used
by Rgui whenever running in a multibyte locale (so also in UTF-8,
hence fixing a regression in R 4.2.0 for users of systems where R
4.1 used a single-byte locale).
• Completion in Rgui now works also with non-ASCII characters.
• Rgui no longer truncates usage information with --help.
• Text injection from external applications via SendInput now works
in GraphApp Unicode windows, fixing a regression in R 4.2.0 for
Rgui users of systems where R 4.1 used a single-byte locale but R
4.2.0 uses UTF-8.
• Performance of txtProgressBar() in Rgui when running in a
multi-byte locale has been improved (fixing a performance
regression in R 4.2.0 for users of systems where R 4.1 used a
single-byte locale).
• The script editor in Rgui now works also on systems using UTF-8
as the native encoding. Users of the script editor have to
convert their scripts with non-ASCII characters to UTF-8 before
reading them in R 4.2.1 or newer (on recent Windows where UTF-8
is used). This fixes a regression in R 4.2.0, which prevented
some operations with scripts when they contained non-ASCII
characters.
CHANGES IN R 4.2.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• The formula method of aggregate() now matches the generic in
naming its first argument x (resolving PR#18299 by Thomas
Soeiro).
This means that calling aggregate() with a formula as a named
first argument requires name formula in earlier versions of R and
name x now, so portable code should not name the argument (code
in many packages did).
• Calling && or || with either argument of length greater than one
now gives a warning (which it is intended will become an error).
• Calling if() or while() with a condition of length greater than
one gives an error rather than a warning. Consequently,
environment variable _R_CHECK_LENGTH_1_CONDITION_ no longer has
any effect.
• Windows users should consult the WINDOWS section below for some
profound changes including
• Support for 32-bit builds has been dropped.
• UTF-8 locales are used where available.
• The default locations for the R installation and personal
library folder have been changed.
Thanks to Tomas Kalibera for months of work on the Windows port
for this release.
NEW FEATURES:
• matrix(x, n, m) now warns in more cases where length(x) differs
from n * m, as suggested by Abby Spurdle and Wolfgang Huber in
Feb 2021 on the R-devel mailing list.
This warning can be turned into an error by setting environment
variable _R_CHECK_MATRIX_DATA_ to TRUE: R CMD check --as-cran
does so unless it is already set.
• Function file_test() in package utils gains tests for symlinks,
readability and writability.
• capabilities("libxml") is now false.
The description of capabilities("http/ftp") now reflects that it
refers to the default method, no longer the internal one.
• simplify2array() gains an except argument for controlling the
exceptions used by sapply().
• Environment variables R_LIBS_USER and R_LIBS_SITE are both now
set to the R system default if unset or empty, and can be set to
NULL to indicate an empty list of user or site library
directories.
• The warning for axis()(-like) calls in cases of relatively small
ranges (typically in log-scale situations) is slightly improved
_and_ suppressed from explicit calls to .axisPars() as has always
been the intention.
• The contrasts setter function `contrasts<-` gains an explicit
default how.many = NULL rather than just using missing(how.many).
• grid.pretty() gains a new optional argument n = 5.
• There is a new function .pretty() with option bounds as a
technical-utility version of pretty(). It and pretty() gain a
new argument f.min with a better than back-compatible default.
• Function grDevices::axisTicks() and related functions such as
graphics::axis() work better, notably for the log scale; partly
because of the pretty() improvements, but also because care is
taken e.g., when ylim is finite but diff(ylim) is infinite.
• nclass.FD() gains a digits option.
• The R Mathlib internal C function bd0() (called indirectly from a
dozen probability density and distribution functions such as
dpois(), dbinom(), dgamma(), pgamma() _etc_) has been
complemented by a more sophisticated and (mostly) more accurate C
function ebd0(), currently called only by internal dpois_raw()
improving accuracy for R level dpois() and potentially others
calling it such as dnbinom(), dgamma() or pgamma(). (Thanks to
Morten Welinder's PR#15628.)
• write.ftable() gains sep = " " argument as suggested by Thomas
Soeiro.
• The names of the locale categories supported by R's
Sys.getlocale() and Sys.setlocale() are now provided by variable
.LC.categories in the base namespace.
• The Date and POSIXt methods for hist() and the histogram method
for plot() now also use the new default col = "lightgray" in
consistency with the corresponding change to hist()'s default for
R 4.0.0.
• hist.default() gains new fuzz argument, and the histogram plot
method no longer uses fractional axis ticks when displaying
counts ("Frequency").
• mapply() and hence Map() now also obey the “max-or-0-if-any”
recycling rule, such that, e.g., Map(`+`, 1:3, 1[0]) is valid
now.
• as.character(<obj>) for "hexmode" or "octmode" objects now
fulfils the important basic rule as.character(x)[j] ===
as.character(x[j]).
• The set utility functions, notably intersect() have been tweaked
to be more consistent and symmetric in their two set arguments,
also preserving a common mode.
• substr(ch, start,end) <- new now e.g., preserves names(ch); ditto
for substring(), thanks to a patch from Brodie Gaslam.
• plot(<lm>) gains a extend.ylim.f argument, in partial response to
PR#15285; further PR#17784 is fixed thanks to several
contributors and a patch by Elin Waring. The Cook's dist
contours get customizable via cook.col and cook.lty with a
different default color and their legend is nicer by default and
customizable via cook.legendChanges.
• Attempting to subset an object that is not subsettable now
signals an error of class notSubsettableError. The
non-subsettable object is contained in the object field of the
error condition.
• Subscript-out-of-bounds errors are now signaled as errors of
class subscriptOutOfBoundsError.
• Stack-overflow errors are now signaled as errors inheriting from
class stackOverflowError. See ?stackOverflowError for more
details.
• New partly experimental Sys.setLanguage() utility, solving the
main problem of PR#18055.
• gettext() and gettextf() get a new option trim = TRUE which when
set to false allows translations for strings such as "Execution
halted\n" typical for C code.
• An experimental implementation of hash tables is now available.
See ?hashtab for more details.
• identical() gains a extptr.as.ref argument for requesting that
external pointer objects be compared as reference objects.
• reorder() gets an argument decreasing which it passes to sort()
for level creation; based on the wish and patch by Thomas Soeiro
in PR#18243.
• as.vector() gains a data.frame method which returns a simple
named list, also clearing a long-standing ‘FIXME’ to enable
as.vector(<data.frame>, mode="list"). This breaks code relying
on as.vector(<data.frame>) to return the unchanged data frame.
• legend() is now vectorized for arguments cex, x.intersp, and
text.width. The latter can now also be specified as a vector
(one element for each column of the legend) or as NA for
computing a proper column wise maximum value of strwidth(legend).
The argument y.intersp can be specified as a vector with one
entry for each row of the legend.
legend() also gains new arguments title.cex and title.font.
Thanks to Swetlana Herbrandt.
• Deparsing no longer remaps attribute names dim, dimnames, levels,
names and tsp to historical S-compatible names (which structure()
maps back).
• sample() and sample.int() have additional sanity checks on their
size and n arguments.
all.equal.numeric() gains a sanity check on its tolerance
argument - calling all.equal(a, b, c) for three numeric vectors
is a surprisingly common error.
mean(na.rm =), rank(na.last =), barplot(legend.text =),
boxplot(), contour(drawlabels =), polygon(border =) and
methods::is(class2 =) have more robust sanity checks on their
arguments.
R CMD Rd2pdf (used by R CMD check) has a more robust sanity check
on the format of \alias{} commands.
• psigamma(x, deriv) for negative x now also works for deriv = 4
and 5; their underlying C level dpsifn() is documented in
‘Writing R Extensions’.
• The HTML help system now uses HTML5 (wish of PR#18149).
• ks.test() now provides exact p-values also with ties and MC
p-values in the two-sample (Smirnov) case. By Torsten Hothorn.
• ks.test() gains a formula interface, with y ~ 1 for the
one-sample (Kolmogorov) test and y ~ group for the two-sample
(Smirnov) test. Contributed by Torsten Hothorn.
• The return value from ks.test() now has class c("ks.test",
"htest") - packages using try() need to take care to use
inherits() and not == on the class.
• New functions psmirnov(), qsmirnov() and rsmirnov() in package
stats implementing the asymptotic and exact distributions of the
two-sample Smirnov statistic.
• iconv() now allows sub = "c99" to use C99-style escapes for UTF-8
inputs which cannot be converted to encoding to.
• In a forward pipe |> expression it is now possible to use a named
argument with the placeholder _ in the rhs call to specify where
the lhs is to be inserted. The placeholder can only appear once
on the rhs.
• The included LAPACK sources have been updated to version 3.10.0,
except for the four Fortran 77 routines which 3.10.0 has
re-implemented in Fortran 90 (where the older versions have been
retained as the R build process does not support Fortran 90).
• path.expand() and most other uses of tilde expansion now warn if
a path would be too long if expanded. (An exception is
file.exists(), which silently returns false.)
• trunc(<Date>, *) now supports units = "months" or "years" for
consistency with the POSIXt method, thanks to Dirk Eddelbuettel's
proposal in PR#18099.
• list2DF() now checks that its arguments are of the same length,
rather than use recycling.
• The HTML help system has several new features: LaTeX-like math
can be typeset using either KaTeX or MathJax, usage and example
code is highlighted using Prism, and for dynamic help the output
of examples and demos can be shown within the browser if the
knitr package is installed. These features can be disabled by
setting the environment variable _R_HELP_ENABLE_ENHANCED_HTML_ to
a false value.
GRAPHICS:
• The graphics engine version, R_GE_version, has been bumped to 15
and so packages that provide graphics devices should be
reinstalled.
• The grid package now allows the user to specify a “vector” of
pattern fills. The fill argument to gpar() accepts a list of
gradients and/or patterns and the functions linearGradient(),
radialGradient(), and pattern() have a new group argument.
Points grobs (data symbols) can now also have a pattern fill.
The grobCoords() function now returns a more informative and
complex result.
• The grid package has new functions for drawing isolated groups:
grid.group(), grid.define(), and grid.use(). These functions add
compositing operators and affine transformations to R's graphics
capabilities.
The grid package also has new functions for stroking and filling
paths: grid.stroke(), grid.fill(), and grid.fillStroke().
A new function as.path() allows the user to specify the fill rule
for a path that is to be used for clipping, stroking, or filling;
available options are "winding" and "evenodd". A new function
as.mask() allows the user to specify the type of a mask;
available options are "alpha" and "luminance".
These new features are only supported so far (at most) on the
Cairo-based graphics devices and on the pdf() device.
• dev.capabilities() reports on device support for the new
features.
• par() now warns about unnamed non-character arguments to prevent
misuse such as {usr <- par("usr"); par(usr)}.
WINDOWS:
• R uses UTF-8 as the native encoding on recent Windows systems (at
least Windows 10 version 1903, Windows Server 2022 or Windows
Server 1903). As a part of this change, R uses UCRT as the C
runtime. UCRT should be installed manually on systems older than
Windows 10 or Windows Server 2016 before installing R.
• The default personal library on Windows, folder R\win-library\x.y
where x.y stands for R release x.y.z, is now a subdirectory of
Local Application Data directory (usually a hidden directory
C:\Users\username\AppData\Local). Use shell.exec(.libPaths()[1])
from R to open the personal library in Explorer when it is first
in the list (PR#17842).
• R uses a new 64-bit Tcl/Tk bundle. The previous 32-bit/64-bit
bundle had a different layout and can no longer be used.
• Make files and installer scripts for Windows have been tailored
to Rtools42, the newly recommended 64-bit gcc 10.3 MinGW-W64 UCRT
toolchain.
• Rtools42 by default uses the Windows security features ASLR and
DEP; hence CRAN builds of R and packages also do.
• R now supports files Makevars.ucrt, Makefile.ucrt, configure.ucrt
and cleanup.ucrt in packages, which are used in preference to the
.win variants. This allows keeping the .win files around to
support older versions of R. This feature will be removed in the
future once support for older versions of R would no longer be
needed.
• R.version gains a new field crt (only on Windows) to denote the C
runtime. The value is "ucrt".
• On Windows, download.file(method = "auto") and url(method =
"default") now follow Unix in using "libcurl" for all except
file:// URIs.
• Rtools42 includes an unpatched Msys2 build of GNU tar. Paths
including drive letters can be made to work by adding
--force-local to environment variable TAR_OPTIONS. (Rtools40 and
earlier included a patched version which defaulted to this
option.)
• Installer builds of R automatically find the Rtools42 software
collection as well as the compiler toolchain. No PATH setting is
required from the user.
• The default installation directory of R for a user-only
installation has been changed to the User Program Files directory
(usually a hidden directory
C:\Users\username\AppData\Local\Programs) to follow Windows
conventions. Use shell.exec(R.home()) from R to open the R
installation directory in Explorer (PR#17842).
• R now supports installation-time patching of packages. Patches
may be installed from a supplied URL or a local directory or
disabled. Patches are included into the installed packages for
reference. This experimental feature may be removed in the
future.
• libcurl is now required for building from source.
• The clipboard connection now works also with text in other than
the current native encoding (PR#18267, with Hiroaki Yutani).
Text is always pasted to the clipboard in UTF16-LE and the
encoding argument is ignored.
• The internal case-changing functions are now used by default on
Windows - this circumvents problems (for example with E acute) of
the UCRT Windows' runtime.
• R on Windows now uses the system memory allocator. Doug Lea's
allocator was used since R 1.2.0 to mitigate performance
limitations seen with system allocators on earlier versions of
Windows.
• memory.limit() and memory.size() are now stubs on Windows (as on
Unix-alikes).
• Applications embedding R on Windows can now use additional
callbacks, which have so far only been available only on Unix
(PR#18286).
INSTALLATION:
• Facilities for accessing ftp:// sites are no longer tested
(except _pro tem_ for curlGetHeaders()) as modern browsers have
removed support.
• R can now be built with DEFS = -DSTRICT_R_HEADERS .
PACKAGE INSTALLATION:
• R CMD INSTALL no longer tangles vignettes. This completes an R
CMD build change in R 3.0.0 and affects packages built before R
3.0.2. Such packages should be re-made with R CMD build to have
the tangled R code of vignettes shipped with the tarball.
• USE_FC_LEN_T will become the default: this uses the correct
prototypes for Fortran BLAS/LAPACK routines called from C/C++,
and requires adjustment of most such calls - see ‘Writing R
Extensions’ §6.6.1. (This has been supported since R 3.6.2.)
• Package installation speed for packages installed with
keep.source has been improved. This resolve the issue reported by
Ofek Shilon in PR#18236.
UTILITIES:
• R CMD check can optionally report files/directories left behind
in home, /tmp (even though TMPDIR is set) and other directories.
See the “R Internals” manual for details.
• R CMD check now reports byte-compilation errors during
installation. These are not usually fatal but may result in
parts of the package not being byte-compiled.
• _R_CHECK_DEPENDS_ONLY_ can be applied selectively to examples,
tests and/or vignettes in R CMD check: see the “R Internals”
manual.
• _R_CHECK_SRC_MINUS_W_IMPLICIT_ now defaults to true: recent
versions of Apple clang on macOS have made implicit function
declarations in C into a compilation error.
• R CMD check --as-cran makes use of the environment variable
AUTORECONF. See the “R Internals” manual §8 for further details.
• R CMD check --use-valgrind also uses valgrind when re-building
vignettes as some non-Sweave vignettes unhelpfully comment out
all their code when R CMD check runs vignettes.
• Errors in re-building vignettes (unless there are LaTeX errors)
are reported by R CMD check as ERROR rather than WARNING when
running vignettes has been skipped (as it frequently is in CRAN
checks and by --as-cran).
• R CMD Rd2pdf gains a --quiet option that is used by R CMD build
when building the PDF package manual.
• R CMD Rd2pdf now always runs LaTeX in batch mode, consistent with
Texinfo >= 6.7. The --batch option is ignored.
• R CMD build and R CMD check now include the Rd file name and line
numbers in the error message of an \Sexpr evaluation failure.
• For packages using the \doi Rd macro (now an install-time \Sexpr)
but no other dynamic Rd content, R CMD build now produces a
smaller tarball and is considerably faster - skipping temporary
package installation.
• R CMD check can optionally (but included in --as-cran) validate
the HTML produced from the packages .Rd files. See
<https://blog.r-project.org/2022/04/08/enhancements-to-html-documentation/>:
this needs a fairly recent version of HTML Tidy to be available.
C-LEVEL FACILITIES:
• The non-API header R_ext/R-ftp-http.h is no longer provided, as
the entry points it covered are now all defunct.
• A number of non-API declarations and macro definitions have been
moved from the installed header Rinternals.h to the internal
header Defn.h. Packages that only use entry points and
definitions documented to be part of the API as specified in
‘Writing R Extensions’ §6 should not be affected.
• The macro USE_RINTERNALS no longer has any effect when compiling
package code. Packages which also use R_NO_REMAP will need to
ensure that the remapped names are used for calls to API
functions that were formerly also made available as macros.
• The deprecated legacy S-compatibility macros PROBLEM, MESSAGE,
ERROR, WARN, WARNING, RECOVER, ... are no longer defined in
R_ext/RS.h (included by R.h). Replace these by calls to Rf_error
and Rf_warning (defined in header R_ext/Error.h included by R.h).
Header R_ext/RS.h no longer includes R_ext/Error.h.
• Header R_ext/Constants.h (included by R.h) when included from C++
now includes the C++ header cfloat rather than the C header
float.h (now possible as C++11 is required).
• The legacy S-compatibility macros DOUBLE_* in R_ext/Constants.h
(included by R.h) are deprecated.
• The deprecated S-compatibility macros SINGLE_* in
R_ext/Constants.h (included by R.h) have been removed.
• R_Calloc, R_Free and R_Realloc are preferred to their unprefixed
forms and error messages now use the prefix. These forms were
introduced in R 3.4.0 and are available even when
STRICT_R_HEADERS is defined.
• rmultinom has been documented in ‘Writing R Extensions’ §6 so is
now part of the R API.
• Similarly, Rtanpi, called from R level tanpi() is now part of the
R API.
• The long-deprecated, undocumented and non-API entry point call_R
is no longer declared in R_ext/RS.h (included by R.h).
• The header S.h which has been unsupported since Jan 2016 has been
removed. Use R.h instead.
DEPRECATED AND DEFUNCT:
• The (non-default and deprecated) method = "internal" for
download.file() and url() no longer supports http:// nor ftp://
URIs. (It is used only for file:// URIs.)
On Windows, download.file(method = "wininet") no longer supports
ftp:// URIs. (It is no longer the default method, which is
"libcurl" and does.)
On Windows, the deprecated method = "wininet" now gives a warning
for http:// and https:// URIs for both download.file() and url().
(It is no longer the default method.)
• On Windows, the command-line option --max-mem-size and
environment variable R_MAX_MEM_SIZE are defunct. The memory
allocation limit was important for 32-bit builds, but these are
no longer supported.
• default.stringsAsFactors() is now formally deprecated, where that
was only mentioned on its regular help page, previously. So it
now gives a warning if called.
• unix.time() is defunct now; it had been deprecated since R 3.4.0.
BUG FIXES:
• Setting digits = 0 in format(), print.default() (and hence
typically print()) or options() is again invalid. Its behaviour
was platform-dependent, and it is unclear what “zero significant
digits” should mean (PR#18098).
• Messages from C code in the cairo section of package grDevices
are now also offered for translation, thanks to Michael Chirico's
PR#18123.
• mean(x) with finite x now is finite also without "long.double"
capability.
• R CMD Rd2pdf no longer leaves an empty build directory behind
when it aborts due to an already existing output file. (Thanks
to Sebastian Meyer's PR#18141.)
• density(x, weights = w, na.rm = TRUE) when anyNA(x) is true, now
removes weights “in parallel” to x, fixing PR#18151, reported by
Matthias Gondan. Additionally, it gets a subdensity option.
• Conversion of \Sexpr[]{<expR>} to LaTeX or HTML no longer
produces long blocks of empty lines when <expR> itself contains
several lines all producing empty output. Thanks to a report and
patch by Ivan Krylov posted to R-devel.
• R CMD build no longer fails if a package vignette uses child
documents and inst/doc exists. (Thanks to Sebastian Meyer's
PR#18156.)
• When an R documentation (‘help’ source) file man/foo.Rd in a
package has \donttest{..} examples with a syntax error, it is now
signalled as ERROR and with correct line numbers relating to the
*-Ex.R file, thanks to Duncan Murdoch and Sebastian Meyer's
reports and patch proposals in PR#17501.
• Improved determination of the correct translation domain in
non-base packages, addressing the combination of PR#18092 and
PR#17998 (#c6) with reports and _augmented_ patch #2904 by
Suharto Anggono.
Note that "R-base" is no longer the default domain e.g., for
top-level calls to gettext(); rather translation needs explicit
domain = * specification in such cases.
• identical(attrib.as.set=FALSE) now works correctly with data
frames with default row names (Thanks to Charlie Gao's PR#18179).
• txtProgressBar() now enforces a non-zero width for argument char,
without which no progress can be visible.
• dimnames(table(d)) is more consistent in the case where d is a
list with a single component, thanks to Thomas Soeiro's report to
R-devel.
Further, table(d1, d2) now gives an error when d1 and d2 are data
frames as suggested by Thomas in PR#18224.
• Fix for drawing semi-transparent lines and fills on the native
Windows graphics device (PR#18219 and PR#16694). Thanks to Nick
Ray for helpful diagnosis on Bugzilla.
• The deparser now wraps sub-expressions such as if(A) .. with
parentheses when needed; thanks to Duncan Murdoch's PR#18232 and
Lionel Henry's patches there.
• remove.packages() no longer tries to uninstall Priority: base
packages, thanks to a report and suggestions by Colin Fay in
PR#18227.
• win.metafile() now has xpinch and ypinch arguments so that the
user can override Windows' (potentially wrong) guess at device
dimensions.
• x[i] and x[[i]] for non-integer i should now behave in all cases
as always documented: the index used is equivalent to
as.integer(i) unless that would overflow where trunc(i) is used
instead; thanks to Suharto Anggono's report and patch proposals
in PR#17977.
• asOneSidedFormula() now associates the resulting formula with the
global environment rather than the evaluation environment created
for the call.
• <bibentry>$name now matches the field name case-insensitively,
consistent with bibentry() creation and the replacement method.
• cbind() failed to detect some length mismatches with a mixture of
time-series and non-time-series inputs.
• The default LaTeX style file Sweave.sty used by the RweaveLatex
driver no longer loads the obsolete ae package; thanks to a
report by Thomas Soeiro in PR#18271. Furthermore, it now skips
\usepackage[T1]{fontenc} for engines other than pdfTeX (if
detected) or if the new [nofontenc] option is used.
• smooth.spline() now stores its logical cv argument more safely,
fixing a rare bug when printing, and also stores n.
• smooth.spline(x,y,*) now computes the cv.crit statistic
correctly, also when is.unsorted(x), fixing PR#18294.
• The data.frame method of rbind() now warns when binding
not-wholly-recycling vectors, by analogy to the default method
(for matrices).
• setAs() finds the correct class for name to when multiple
packages define a class with that name. Thanks to Gabor Csardi
for the report.
• Fix for detaching a package when two classes of the same name are
present in method signatures for the same generic. Thanks to
Gabor Csardi for the report.
• match.arg("", c("", "a", "B")) gives a better error message, in
part from PR#17959, thanks to Elin Waring.
• R CMD Sweave --clean no longer removes pre-existing files or
subdirectories (PR#18242).
• The quartz() device no longer splits polylines into subpaths.
That has caused narrowly-spaced lines with many points to always
look solid even when dashed line type was used due to dash phase
restarts.
• Deparsing constructs such as quote(1 + `!`(2) + 3) works again as
before R 3.5.0, thanks to the report and patch in PR#18284 by
Suharto Anggono.
• as.list(f) for a factor f now keeps names(f), fixing PR#18309.
• qbeta(.001, .9, .009) and analogous qf() calls now return a
correct value instead of NaN or wrongly 1, all with a warning;
thanks to the report by Ludger Goeminne in PR#18302.
• plot.lm() failed to produce the plot of residuals vs. factor
levels (i.e., which=5 when leverages are constant) for models
with character predictors (PR#17840).
• interaction.plot(..., xtick = TRUE) misplaced the x-axis line
(PR#18305).
• Not strictly fixing a bug, format()ing and print()ing of
non-finite Date and POSIXt values NaN and +/-Inf no longer show
as NA but the respective string, e.g., Inf, for consistency with
numeric vector's behaviour, fulfilling the wish of PR#18308.
• R CMD check no longer runs test scripts generated from
corresponding .Rin files twice and now signals an ERROR if
processing an .Rin script fails.
• tools::Rd2txt() used for plain-text help pages now renders \hrefs
(if tools::Rd2txt_options(showURLs = TRUE)) and \urls with
percent-encoding and standards-compliant delimiting style (angle
brackets and no URL: prefix). \email is now rendered with a
mailto: prefix.
CHANGES IN R 4.1.3:
NEW FEATURES:
• The default version of Bioconductor has been changed to 3.14.
(This is used by setRepositories and the menus in GUIs.)
UTILITIES:
• R CMD check --as-cran has a workaround for a bug in versions of
file up to at least 5.41 which mis-identify DBF files last
changed in 2022 as executables.
C-LEVEL FACILITIES:
• The legacy S-compatibility macros SINGLE_* in R_ext/Constants.h
(included by R.h) are deprecated and will be removed in R 4.2.0.
BUG FIXES:
• Initialization of self-starting nls() models with initialization
functions following the pre-R-4.1.0 API (without the ...
argument) works again for now, with a deprecation warning.
• Fixed quoting of ~autodetect~ in Java setting defaults to avoid
inadvertent user lookup due to leading ~, reported in PR#18231 by
Harold Gutch.
• substr(., start, stop) <- v now treats _negative_ stop values
correctly. Reported with a patch in PR#18228 by Brodie Gaslam.
• Subscripting an array x without dimnames by a
length(dim(x))-column character matrix gave "random" non-sense,
now an error; reported in PR#18244 by Mikael Jagan.
• ...names() now matches names(list(...)) closely, fixing PR#18247.
• all.equal(*, scale = s) now works as intended when length(s) > 1,
partly thanks to Michael Chirico's PR#18272.
• print(x) for long vectors x now also works for named atomic
vectors or lists and prints the correct number when reaching the
getOption("max.print") limit; partly thanks to a report and
proposal by Hugh Parsonage to the R-devel list.
• all.equal(<selfStart>, *) no longer signals a deprecation
warning.
• reformulate(*, response=r) gives a helpful error message now when
length(r) > 1, thanks to Bill Dunlap's PR#18281.
• Modifying globalCallingHandlers inside withCallingHandlers() now
works or fails correctly, thanks to Henrik Bengtsson's PR#18257.
• hist(<Date>, breaks = "days") and hist(<POSIXt>, breaks = "secs")
no longer fail for inputs of length 1.
• qbeta(.001, .9, .009) and similar cases now converge correctly
thanks to Ben Bolker's report in PR#17746.
• window(x, start, end) no longer wrongly signals “'start' cannot
be after 'end'”, fixing PR#17527 and PR#18291.
• data() now checks that its (rarely used) list argument is a
character vector - a couple of packages passed other types and
gave incorrect results.
• which() now checks its arr.ind argument is TRUE rather coercing
to logical and taking the first element - which gave incorrect
results in package code.
• model.weights() and model.offset() more carefully extract their
model components, thanks to Ben Bolker and Tim Taylor's R-devel
post.
• list.files(recursive = TRUE) now shows all broken symlinks
(previously, some of them may have been omitted, PR#18296).
CHANGES IN R 4.1.2:
C-LEVEL FACILITIES:
• The workaround in headers R.h and Rmath.h (using namespace std;)
for the Oracle Developer Studio compiler is no longer needed now
C++11 is required so has been removed. A couple more usages of
log() (which should have been std::log()) with an int argument
are reported on Solaris.
• The undocumented limit of 4095 bytes on messages from the
S-compatibility macros PROBLEM and MESSAGE is now documented and
longer messages will be silently truncated rather than
potentially causing segfaults.
• If the R_NO_SEGV_HANDLER environment variable is non-empty, the
signal handler for SEGV/ILL/BUS signals (which offers recovery
user interface) is not set. This allows more reliable debugging
of crashes that involve the console.
DEPRECATED AND DEFUNCT:
• The legacy S-compatibility macros PROBLEM, MESSAGE, ERROR, WARN,
WARNING, RECOVER, ... are deprecated and will be hidden in R
4.2.0. R's native interface of Rf_error and Rf_warning has long
been preferred.
BUG FIXES:
• .mapply(F, dots, .) no longer segfaults when dots is not a list
and uses match.fun(F) as always documented; reported by Andrew
Simmons in PR#18164.
• hist(<Date>, ...) and hist(<POSIXt>, ...) no longer pass
arguments for rect() (such as col and density) to axis().
(Thanks to Sebastian Meyer's PR#18171.)
• \Sexpr{ch} now preserves Encoding(ch). (Thanks to report and
patch by Jeroen Ooms in PR#18152.)
• Setting the RNG to "Marsaglia-Multicarry" e.g., by RNGkind(), now
warns in more places, thanks to André Gillibert's report and
patch in PR#18168.
• gray(numeric(), alpha=1/2) no longer segfaults, fixing PR#18183,
reported by Till Krenz.
• Fixed dnbinom(x, size=<very_small>, .., log=TRUE) regression,
reported by Martin Morgan.
• as.Date.POSIXlt(x) now keeps names(x), thanks to Davis Vaughan's
report and patch in PR#18188.
• model.response() now strips an "AsIs" class typically, thanks to
Duncan Murdoch's report and other discussants in PR#18190.
• try() is considerably faster in case of an error and long call,
as e.g., from some do.call(). Thanks to Alexander Kaever's
suggestion posted to R-devel.
• qqline(y = <object>) such as y=I(.), now works, see also
PR#18190.
• Non-integer mgp par() settings are now handled correctly in
axis() and mtext(), thanks to Mikael Jagan and Duncan Murdoch's
report and suggestion in PR#18194.
• formatC(x) returns length zero character() now, rather than ""
when x is of length zero, as documented, thanks to Davis
Vaughan's post to R-devel.
• removeSource(fn) now retains (other) attributes(fn).
CHANGES IN R 4.1.1:
NEW FEATURES:
• require(<pkg>, quietly = TRUE) is quieter and in particular does
not warn if the package is not found.
DEPRECATED AND DEFUNCT:
• Use of ftp:// URIs should be regarded as deprecated, with
on-going support confined to method = "libcurl" and not routinely
tested. (Nowadays no major browser supports them.)
• The non-default method = "internal" is deprecated for http:// and
ftp:// URIs for both download.file and url.
• On Windows, method = "wininet" is deprecated for http://,
https:// and ftp:// URIs for both download.file and url. (A
warning is only given for ftp://.)
For ftp:// URIs the default method is now "libcurl" if available
(which it is on CRAN builds).
method = "wininet" remains the default for http:// and https://
URIs but if libcurl is available, using method = "libcurl" is
preferred.
INSTALLATION:
• make check now works also without a LaTeX installation. (Thanks
to Sebastian Meyer's PR#18103.)
BUG FIXES:
• make check-devel works again in an R build configured with
--without-recommended-packages.
• qnbinom(p, size, mu) for large size/mu is correct now in a range
of cases (PR#18095); similarly for the (size, prob)
parametrization of the negative binomial. Also qpois() and
qbinom() are better and or faster for extreme cases. The
underlying C code has been modularized and is common to all four
cases of discrete distributions.
• gap.axis is now part of the axis() arguments which are passed
from bxp(), and hence boxplot(). (Thanks to Martin Smith's
report and suggestions in PR#18109.)
• .First and .Last can again be set from the site profile.
• seq.int(from, to, *) and seq.default(..) now work better in large
range cases where from-to is infinite where the two boundaries
are finite.
• all.equal(x,y) now returns TRUE correctly also when several
entries of abs(x) and abs(y) are close to .Machine$double.xmax,
the largest finite numeric.
• model.frame() now clears the object bit when removing the class
attribute of a value via na.action (PR#18100).
• charClass() now works with multi-character strings on Windows
(PR#18104, fixed by Bill Dunlap).
• encodeString() on Solaris now works again in Latin-1 encoding on
characters represented differently in UTF-8. Support for
surrogate pairs on Solaris has been improved.
• file.show() on Windows now works with non-ASCII path names
representable in the current native encoding (PR#18132).
• Embedded R on Windows can now find R home directory via the
registry even when installed only for the current user
(PR#18135).
• pretty(x) with finite x now returns finite values also in the
case where the extreme x values are close in size to the maximal
representable number .Machine$double.xmax.
Also, it's been tweaked for very small ranges and when a boundary
is close (or equal) to zero; e.g., pretty(c(0,1e-317)) no longer
has negative numbers, currently still warning about a very small
range, and pretty(2^-(1024 - 2^-1/(c(24,10)))) is more accurate.
• The error message for not finding vignette files when weaving has
correct file sizes now. (Thanks to Sebastian Meyer's PR#18154.)
• dnbinom(20, <large>, 1) now correctly gives 0, and similar cases
are more accurate with underflow precaution. (Reported by
Francisco Vera Alcivar in PR#18072.)
CHANGES IN R 4.1.0:
FUTURE DIRECTIONS:
• It is planned that the 4.1.x series will be the last to support
32-bit Windows, with production of binary packages for that
series continuing until early 2023.
SIGNIFICANT USER-VISIBLE CHANGES:
• Data set esoph in package datasets now provides the correct
numbers of controls; previously it had the numbers of cases added
to these. (Reported by Alexander Fowler in PR#17964.)
NEW FEATURES:
• www.omegahat.net is no longer one of the repositories known by
default to setRepositories(). (Nowadays it only provides source
packages and is often unavailable.)
• Function package_dependencies() (in package tools) can now use
different dependency types for direct and recursive dependencies.
• The checking of the size of tarball in R CMD check --as-cran
<pkg> may be tweaked via the new environment variable
_R_CHECK_CRAN_INCOMING_TARBALL_THRESHOLD_, as suggested in
PR#17777 by Jan Gorecki.
• Using c() to combine a factor with other factors now gives a
factor, an ordered factor when combining ordered factors with
identical levels.
• apply() gains a simplify argument to allow disabling of
simplification of results.
• The format() method for class "ftable" gets a new option justify.
(Suggested by Thomas Soeiro.)
• New ...names() utility. (Proposed by Neal Fultz in PR#17705.)
• type.convert() now warns when its as.is argument is not
specified, as the help file always said it _should_. In that
case, the default is changed to TRUE in line with its change in
read.table() (related to stringsAsFactors) in R 4.0.0.
• When printing list arrays, classed objects are now shown _via_
their format() value if this is a short enough character string,
or by giving the first elements of their class vector and their
length.
• capabilities() gets new entry "Rprof" which is TRUE when R has
been configured with the equivalent of --enable-R-profiling (as
it is by default). (Related to Michael Orlitzky's report
PR#17836.)
• str(xS4) now also shows extraneous attributes of an S4 object
xS4.
• Rudimentary support for vi-style tags in rtags() and R CMD rtags
has been added. (Based on a patch from Neal Fultz in PR#17214.)
• checkRdContents() is now exported from tools; it and also
checkDocFiles() have a new option chkInternal allowing to check
Rd files marked with keyword "internal" as well. The latter can
be activated for R CMD check via environment variable
_R_CHECK_RD_INTERNAL_TOO_.
• New functions numToBits() and numToInts() extend the raw
conversion utilities to (double precision) numeric.
• Functions URLencode() and URLdecode() in package utils now work
on vectors of URIs. (Based on patch from Bob Rudis submitted
with PR#17873.)
• path.expand() can expand ~user on most Unix-alikes even when
readline is not in use. It tries harder to expand ~, for example
should environment variable HOME be unset.
• For HTML help (both dynamic and static), Rd file links to help
pages in external packages are now treated as references to
topics rather than file names, and fall back to a file link only
if the topic is not found in the target package. The earlier rule
which prioritized file names over topics can be restored by
setting the environment variable _R_HELP_LINKS_TO_TOPICS_ to a
false value.
• c() now removes NULL arguments before dispatching to methods,
thus simplifying the implementation of c() methods, _but_ for
back compatibility keeps NULL when it is the first argument.
(From a report and patch proposal by Lionel Henry in PR#17900.)
• Vectorize()'s result function's environment no longer keeps
unneeded objects.
• Function ...elt() now propagates visibility consistently with
..n. (Thanks to Lionel Henry's PR#17905.)
• capture.output() no longer uses non-standard evaluation to
evaluate its arguments. This makes evaluation of functions like
parent.frame() more consistent. (Thanks to Lionel Henry's
PR#17907.)
• packBits(bits, type="double") now works as inverse of
numToBits(). (Thanks to Bill Dunlap's proposal in PR#17914.)
• curlGetHeaders() has two new arguments, timeout to specify the
timeout for that call (overriding getOption("timeout")) and TLS
to specify the minimum TLS protocol version to be used for
https:// URIs (_inter alia_ providing a means to check for sites
using deprecated TLS versions 1.0 and 1.1).
• For nls(), an optional constant scaleOffset may be added to the
denominator of the relative offset convergence test for cases
where the fit of a model is expected to be exact, thanks to a
proposal by John Nash. nls(*, trace=TRUE) now also shows the
convergence criterion.
• Numeric differentiation _via_ numericDeriv() gets new optional
arguments eps and central, the latter for taking central divided
differences. The latter can be activated for nls() via
nls.control(nDcentral = TRUE).
• nls() now passes the trace and control arguments to getInitial(),
notably for all self-starting models, so these can also be fit in
zero-noise situations via a scaleOffset. For this reason, the
initial function of a selfStart model must now have ... in its
argument list.
• bquote(splice = TRUE) can now splice expression vectors with
attributes: this makes it possible to splice the result of
parse(keep.source = TRUE). (Report and patch provided by Lionel
Henry in PR#17869.)
• textConnection() gets an optional name argument.
• get(), exists(), and get0() now signal an error if the first
argument has length greater than 1. Previously additional
elements were silently ignored. (Suggested by Antoine Fabri on
R-devel.)
• R now provides a shorthand notation for creating functions, e.g.
\(x) x + 1 is parsed as function(x) x + 1.
• R now provides a simple native forward pipe syntax |>. The
simple form of the forward pipe inserts the left-hand side as the
first argument in the right-hand side call. The pipe
implementation as a syntax transformation was motivated by
suggestions from Jim Hester and Lionel Henry.
• all.equal(f, g) for functions now by default also compares their
environment(.)s, notably via new all.equal method for class
function. Comparison of nls() fits, e.g., may now need
all.equal(m1, m2, check.environment = FALSE).
• .libPaths() gets a new option include.site, allowing to _not_
include the site library. (Thanks to Dario Strbenac's suggestion
and Gabe Becker's PR#18016.)
• Lithuanian translations are now available. (Thanks to Rimantas
Žakauskas.)
• names() now works for DOTSXP objects. On the other hand, in
R-lang, the R language manual, we now warn against relying on the
structure or even existence of such dot-dot-dot objects.
• all.equal() no longer gives an error on DOTSXP objects.
• capabilities("cairo") now applies only to the file-based devices
as it is now possible (if very unusual) to build R with Cairo
support for those but not for X11().
• There is optional support for tracing the progress of
loadNamespace() - see its help.
• (Not Windows.) l10n_info() reports an additional element, the
name of the encoding as reported by the OS (which may differ from
the encoding part (if any) of the result from
Sys.getlocale("LC_CTYPE")).
• New function gregexec() which generalizes regexec() to find _all_
disjoint matches and all substrings corresponding to
parenthesized subexpressions of the given regular expression.
(Contributed by Brodie Gaslam.)
• New function charClass() in package utils to query the
wide-character classification functions in use (such as
iswprint).
• The names of quantile()'s result no longer depend on the global
getOption("digits"), but quantile() gets a new optional argument
digits = 7 instead.
• grep(), sub(), regexp and variants work considerably faster for
long factors with few levels. (Thanks to Michael Chirico's
PR#18063.)
• Provide grouping of x11() graphics windows within a window
manager such as Gnome or Unity; thanks to a patch by Ivan Krylov
posted to R-devel.
• The split() method for class data.frame now allows the f argument
to be specified as a formula.
• sprintf now warns on arguments unused by the format string.
• New palettes "Rocket" and "Mako" for hcl.colors() (approximating
palettes of the same name from the viridisLite package).
Contributed by Achim Zeileis.
• The base environment and its namespace are now locked (so one can
no longer add bindings to these or remove from these).
• Rterm handling of multi-byte characters has been improved,
allowing use of such characters when supported by the current
locale.
• Rterm now accepts ALT+ +xxxxxxxx sequences to enter Unicode
characters as hex digits.
• Environment variable LC_ALL on Windows now takes precedence over
LC_CTYPE and variables for other supported categories, matching
the POSIX behaviour.
• duplicated() and anyDuplicated() are now optimized for integer
and real vectors that are known to be sorted via the ALTREP
framework. Contributed by Gabriel Becker via PR#17993.
GRAPHICS:
• The graphics engine version, R_GE_version, has been bumped to 14
and so packages that provide graphics devices should be
reinstalled.
• Graphics devices should now specify deviceVersion to indicate
what version of the graphics engine they support.
• Graphics devices can now specify deviceClip. If TRUE, the
graphics engine will never perform any clipping of output itself.
The clipping that the graphics engine does perform (for both
canClip = TRUE and canClip = FALSE) has been improved to avoid
producing unnecessary artifacts in clipped output.
• The grid package now allows gpar(fill) to be a linearGradient(),
a radialGradient(), or a pattern(). The viewport(clip) can now
also be a grob, which defines a clipping path, and there is a new
viewport(mask) that can also be a grob, which defines a mask.
These new features are only supported so far on the Cairo-based
graphics devices and on the pdf() device.
• (Not Windows.) A warning is given when a Cairo-based type is
specified for a png(), jpeg(), tiff() or bmp() device but Cairo
is unsupported (so type = "Xlib" is tried instead).
• grSoftVersion() now reports the versions of FreeType and
FontConfig if they are used directly (not _via_ Pango), as is
most commonly done on macOS.
C-LEVEL FACILITIES:
• The _standalone_ libRmath math library and R's C API now provide
log1pexp() again as documented, and gain log1mexp().
INSTALLATION on a UNIX-ALIKE:
• configure checks for a program pkgconf if program pkg-config is
not found. These are now only looked for on the path (like
almost all other programs) so if needed specify a full path to
the command in PKG_CONFIG, for example in file config.site.
• C99 function iswblank is required - it was last seen missing ca
2003 so the workaround has been removed.
• There are new configure options --with-internal-iswxxxxx,
--with-internal-towlower and --with-internal-wcwidth which allows
the system functions for wide-character classification,
case-switching and width (wcwidth and wcswidth) to be replaced by
internal ones. The first has long been used on macOS, AIX (and
Windows) but this enables it to be unselected there and selected
for other platforms (it is the new default on Solaris). The
second is new in this version of R and is selected by default on
macOS and Solaris. The third has long been the default and
remains so as it contains customizations for East Asian
languages.
System versions of these functions are often minimally
implemented (sometimes only for ASCII characters) and may not
cover the full range of Unicode points: for example Solaris (and
Windows) only cover the Basic Multilingual Plane.
• Cairo installations without X11 are more likely to be detected by
configure, when the file-based Cairo graphics devices will be
available but not X11(type = "cairo").
• There is a new configure option --with-static-cairo which is the
default on macOS. This should be used when only static cairo
(and where relevant, Pango) libraries are available.
• Cairo-based graphics devices on platforms without Pango but with
FreeType/FontConfig will make use of the latter for font
selection.
LINK-TIME OPTIMIZATION on a UNIX-ALIKE:
• Configuring with flag --enable-lto=R now also uses LTO when
installing the recommended packages.
• R CMD INSTALL and R CMD SHLIB have a new flag --use-LTO to use
LTO when compiling code, for use with R configured with
--enable-lto=R. For R configured with --enable-lto, they have
the new flag --no-use-LTO.
Packages can opt in or out of LTO compilation _via_ a UseLTO
field in the DESCRIPTION file. (As usual this can be overridden
by the command-line flags.)
BUILDING R on Windows:
• for GCC >= 8, FC_LEN_T is defined in config.h and hence character
lengths are passed from C to Fortran in _inter alia_ BLAS and
LAPACK calls.
• There is a new text file src/gnuwin32/README.compilation, which
outlines how C/Fortran code compilation is organized and
documents new features:
• R can be built with Link-Time Optimization with a suitable
compiler - doing so with GCC 9.2 showed several
inconsistencies which have been corrected.
• There is support for cross-compiling the C and Fortran code
in R and standard packages on suitable (Linux) platforms.
This is mainly intended to allow developers to test later
versions of compilers - for example using GCC 9.2 or 10.x has
detected issues that GCC 8.3 in Rtools40 does not.
• There is experimental support for cross-building R packages
with C, C++ and/or Fortran code.
• The R installer can now be optionally built to support a single
architecture (only 64-bit or only 32-bit).
PACKAGE INSTALLATION:
• The default C++ standard has been changed to C++14 where
available (which it is on all currently checked platforms): if
not (as before) C++11 is used if available otherwise C++ is not
supported.
Packages which specify C++11 will still be installed using C++11.
C++14 compilers may give deprecation warnings, most often for
std::random_shuffle (deprecated in C++14 and removed in C++17).
Either specify C++11 (see ‘Writing R Extensions’) or modernize
the code and if needed specify C++14. The latter has been
supported since R 3.4.0 so the package's DESCRIPTION would need
to include something like
Depends: R (>= 3.4)
PACKAGE INSTALLATION on Windows:
• R CMD INSTALL and R CMD SHLIB make use of their flag --use-LTO
when the LTO_OPT make macro is set in file etc/${R_ARCH}/Makeconf
or in a personal/site Makevars file. (For details see ‘Writing R
Extensions’ §4.5.)
This provides a valuable check on code consistency. It does work
with GCC 8.3 as in Rtools40, but that does not detect everything
the CRAN checks with current GCC do.
PACKAGE INSTALLATION on macOS:
• The default personal library directory on builds with
--enable-aqua (including CRAN builds) now differs by CPU type,
one of
~/Library/R/x86_64/x.y/library
~/Library/R/arm64/x.y/library
This uses the CPU type R (and hence the packages) were built for,
so when a x86_64 build of R is run under Rosetta emulation on an
arm64 Mac, the first is used.
UTILITIES:
• R CMD check can now scan package functions for bogus return
statements, which were possibly intended as return() calls (wish
of PR#17180, patch by Sebastian Meyer). This check can be
activated via the new environment variable
_R_CHECK_BOGUS_RETURN_, true for --as-cran.
• R CMD build omits tarballs and binaries of previous builds from
the top-level package directory. (PR#17828, patch by Sebastian
Meyer.)
• R CMD check now runs sanity checks on the use of LazyData, for
example that a data directory is present and that
LazyDataCompression is not specified without LazyData and has a
documented value. For packages with large LazyData databases
without specifying LazyDataCompression, there is a reference to
the code given in ‘Writing R Extensions’ §1.1.6 to test the
choice of compression (as in all the CRAN packages tested a
non-default method was preferred).
• R CMD build removes LazyData and LazyDataCompression fields from
the DESCRIPTION file of packages without a data directory.
ENCODING-RELATED CHANGES:
• The parser now treats \Unnnnnnnn escapes larger than the upper
limit for Unicode points (\U10FFFF) as an error as they cannot be
represented by valid UTF-8.
Where such escapes are used for outputting non-printable
(including unassigned) characters, 6 hex digits are used (rather
than 8 with leading zeros). For clarity, braces are used, for
example \U{0effff}.
• The parser now looks for non-ASCII spaces on Solaris (as
previously on most other OSes).
• There are warnings (including from the parser) on the use of
unpaired surrogate Unicode points such as \uD834. (These cannot
be converted to valid UTF-8.)
• Functions nchar(), tolower(), toupper() and chartr() and those
using regular expressions have more support for inputs with a
marked Latin-1 encoding.
• The character-classification functions used (by default) to
replace the system iswxxxxx functions on Windows, macOS and AIX
have been updated to Unicode 13.0.0.
The character-width tables have been updated to include new
assignments in Unicode 13.0.0. This included treating all
control characters as having zero width.
• The code for evaluating default (extended) regular expressions
now uses the same character-classification functions as the rest
of R (previously they differed on Windows, macOS and AIX).
• There is a build-time option to replace the system's
wide-character wctrans C function by tables shipped with R: use
configure option --with-internal-towlower or (on Windows)
-DUSE_RI18N_CASE in CFLAGS when building R. This may be needed
to allow tolower() and toupper() to work with Unicode characters
beyond the Basic Multilingual Plane where not supported by system
functions (e.g. on Solaris where it is the new default).
• R is more careful when truncating UTF-8 and other multi-byte
strings that are too long to be printed, passed to the system or
libraries or placed into an internal buffer. Truncation will no
longer produce incomplete multibyte characters.
DEPRECATED AND DEFUNCT:
• Function plclust() from the package stats and
package.dependencies(), pkgDepends(), getDepList(),
installFoundDepends(), and vignetteDepends() from package tools
are defunct.
• Defunct functions checkNEWS() and readNEWS() from package tools
and CRAN.packages() from utils have been removed.
• R CMD config CXXCPP is defunct (it was deprecated in R 3.6.2).
• parallel::detectCores() drops support for IRIX (retired in 2013).
• The LINPACK argument to chol.default(), chol2inv(),
solve.default() and svd() has been defunct since R 3.1.0. It was
silently ignored up to R 4.0.3 but now gives an error.
• Subsetting/indexing, such as ddd[*] or ddd$x on a DOTSXP
(dot-dot-dot) object ddd has been disabled; it worked by accident
only and was undocumented.
BUG FIXES:
• Many more C-level allocations (mainly by malloc and strdup) are
checked for success with suitable alternative actions.
• Bug fix for replayPlot(); this was turning off graphics engine
display list recording if a recorded plot was replayed in the
same session. The impact of the bug became visible if resize the
device after replay OR if attempted another savePlot() after
replay (empty display list means empty screen on resize or empty
saved plot).
• R CMD check etc now warn when a package exports non-existing S4
classes or methods, also in case of no “methods” presence.
(Reported by Alex Bertram; reproducible example and patch by
Sebastian Meyer in PR#16662.)
• boxplot() now also accepts calls for labels such as ylab, the
same as plot(). (Reported by Marius Hofert.)
• The help page for xtabs() now correctly states that addNA is
setting na.action = na.pass among others. (Reported as PR#17770
by Thomas Soeiro.)
• The R CMD check <pkg> gives a longer and more comprehensible
message when DESCRIPTION misses dependencies, e.g., in Imports:.
(Thanks to the contributors of PR#17179.)
• update.default() now calls the generic update() on the formula to
work correctly for models with extended formulas. (As reported
and suggested by Neal Fultz in PR#17865.)
• The horizontal position of leaves in a dendrogram is now correct
also with center = FALSE. (PR#14938, patch from Sebastian
Meyer.)
• all.equal.POSIXt() no longer warns about and subsequently ignores
inconsistent "tzone" attributes, but describes the difference in
its return value (PR#17277). This check can be disabled _via_
the new argument check.tzone = FALSE as suggested by Sebastian
Meyer.
• as.POSIXct() now populates the "tzone" attribute from its tz
argument when x is a logical vector consisting entirely of NA
values.
• x[[2^31]] <- v now works. (Thanks to the report and patch by
Suharto Anggono in PR#17330.)
• In log-scale graphics, axis() ticks and label positions are now
computed more carefully and symmetrically in their range,
typically providing _more_ ticks, fulfilling wishes in PR#17936.
The change really corresponds to an improved axisTicks() (package
grDevices), potentially influencing grid and lattice, for
example.
• qnorm(<very large negative>, log.p=TRUE) is now correct to at
least five digits where it was catastrophically wrong,
previously.
• sum(df) and similar "Summary"- and "Math"-group member functions
now work for data frames df with logical columns, notably also of
zero rows. (Reported to R-devel by Martin “b706”.)
• unsplit() had trouble with tibbles due to unsound use of rep(NA,
len)-indexing, which should use NA_integer_ (Reported to R-devel
by Mario Annau.)
• pnorm(x, log.p = TRUE) underflows to -Inf slightly later.
• show(<hidden S4 generic>) prints better and without quotes for
non-hidden S4 generics.
• read.table() and relatives treated an "NA" column name as missing
when check.names = FALSE PR#18007.
• Parsing strings containing UTF-16 surrogate pairs such as
"\uD834\uDD1E" works better on some (uncommon) platforms.
sprintf("%X", utf8ToInt("\uD834\uDD1E")) should now give "1D11E"
on all platforms.
• identical(x,y) is no longer true for differing DOTSXP objects,
fixing PR#18032.
• str() now works correctly for DOTSXP and related exotics, even
when these are doomed.
Additionally, it no longer fails for lists with a class and
“irregular” method definitions such that e.g. lapply(*) will
necessarily fail, as currently for different igraph objects.
• Message translation domains, e.g., for errors and warnings, are
now correctly determined also when e.g., a base function is
called from “top-level” function (i.e., defined in globalenv()),
thanks to a patch from Joris Goosen fixing PR#17998.
• Too long lines in environment files (e.g., Renviron) no longer
crash R. This limit has been increased to 100,000 bytes.
(PR#18001.)
• There is a further workaround for FreeType giving incorrect
italic font faces with cairo-based graphics devices on macOS.
• add_datalist(*, force = TRUE) (from package tools) now actually
updates an existing data/datalist file for new content. (Thanks
to a report and patch by Sebastian Meyer in PR#18048.)
• cut.Date() and cut.POSIXt() could produce an empty last interval
for breaks = "months" or breaks = "years". (Reported as PR#18053
by Christopher Carbone.)
• Detection of the encoding of ‘regular’ macOS locales such as
en_US (which is UTF-8) had been broken by a macOS change:
fortunately these are now rarely used with en_US.UTF-8 being
preferred.
• sub() and gsub(pattern, repl, x, *) now keep attributes of x such
as names() also when pattern is NA (PR#18079).
• Time differences ("difftime" objects) get a replacement and a
rep() method to keep "units" consistent. (Thanks to a report and
patch by Nicolas Bennett in PR#18066.)
• The \RdOpts macro, setting defaults for \Sexpr options in an Rd
file, had been ineffective since R 2.12.0: it now works again.
(Thanks to a report and patch by Sebastian Meyer in PR#18073.)
• mclapply and pvec no longer accidentally terminate parallel
processes started before by mcparallel or related calls in
package parallel (PR#18078).
• grep and other functions for evaluating (extended) regular
expressions handle in Unicode also strings not explicitly flagged
UTF-8, but flagged native when running in UTF-8 locale.
• Fixed a crash in fifo implementation on Windows (PR#18031).
• Binary mode in fifo on Windows is now properly detected from
argument open (PR#15600, PR#18031).
CHANGES IN R 4.0.5:
BUG FIXES:
• The change to the internal table in R 4.0.4 for iswprint has been
reverted: it contained some errors in printability of ‘East
Asian’ characters.
• For packages using LazyData, R CMD build ignored the
--resave-data option and the BuildResaveData field of the
DESCRIPTION file (in R versions 4.0.0 to 4.0.4).
CHANGES IN R 4.0.4:
NEW FEATURES:
• File share/texmf/tex/latex/jss.cls has been updated to work with
LaTeX versions since Oct 2020.
• Unicode character width tables (as used by nchar(, type = "w"))
have been updated to Unicode 12.1 by Brodie Gaslam (PR#17781),
including many emoji.
• The internal table for iswprint (used on Windows, macOS and AIX)
has been updated to include many recent Unicode characters.
INSTALLATION on a UNIX-ALIKE:
• If an external BLAS is specified by --with-blas=foo or _via_
environment variable BLAS_LIBS is not found, this is now a
configuration error. The previous behaviour was not clear from
the documentation: it was to continue the search as if
--with-blas=yes was specified.
BUG FIXES:
• all.equal(x,y) now “sees” the two different NAs in factors,
thanks to Bill Dunlap and others in PR#17897.
• (~ NULL)[1] and similar formula subsetting now works, thanks to a
report and patch by Henrik Bengtsson in PR#17935. Additionally,
subsetting leaving an empty formula now works too, thanks to
suggestions by Suharto Anggono.
• .traceback(n) keeps source references again, as before R 4.0.0,
fixing a regression; introduced by the PR#17580, reported
including two patch proposals by Brodie Gaslam.
• unlist(plst, recursive=FALSE) no longer drops content for
pairlists with list components, thanks to the report and patch by
Suharto Anggono in PR#17950.
• iconvlist() now also works on MUSL based (Linux) systems, from a
report and patch suggestion by Wesley Chan in PR#17970.
• round() and signif() no longer tolerate wrong argument names,
notably in 1-argument calls; reported by Shane Mueller on R-devel
(mailing list); later reported as PR#17976.
• .Machine has longdouble.* elements only if
capabilities("long.double") is true, as documented. (Previously
they were included if the platform had long double identical to
double, as ARM does.)
• p.adjust(numeric(), n=0) now works, fixing PR#18002.
• identical(x,y) no longer prints "Unknown Type .." for typeof(x)
== "..." objects.
• Fix (auto-)print()ing of named complex vectors, see PR#17868 and
PR#18019.
• all.equal(<language>, <...>) now works, fixing PR#18029.
• as.data.frame.list(L, row.names=NULL) now behaves in line with
data.frame(), disregarding names of components of L, fixing
PR#18034, reported by Kevin Tappe.
• checkRdaFiles(ff)$version is now correct also when ff contains
files of different versions, thanks to a report and patch from
Sebastian Meyer in PR#18041.
• macOS: Quartz device live drawing could fail (no plot is shown)
if the system changes the drawing context after view update
(often the case since macOS Big Sur). System log may show
"CGContextDelegateCreateForContext: invalid context" error.
CHANGES IN R 4.0.3:
NEW FEATURES:
• On platforms using configure option --with-internal-tzcode,
additional values "internal" and (on macOS only) "macOS" are
accepted for the environment variable TZDIR. (See ?TZDIR.)
On macOS, "macOS" is used by default if the system timezone
database is a newer version than that in the R installation.
• When install.packages(type = "source") fails to find a package in
a repository it mentions package versions which are excluded by
their R version requirement and links to hints on why a package
might not be found.
• The default value for options("timeout") can be set from
environment variable R_DEFAULT_INTERNET_TIMEOUT, still defaulting
to 60 (seconds) if that is not set or invalid.
This may be needed when child R processes are doing downloads,
for example during the installation of source packages which
download jars or other forms of data.
LINK-TIME OPTIMIZATION on a UNIX-ALIKE:
• There is now support for parallelized Link-Time Optimization
(LTO) with GCC and for ‘thin’ LTO with clang _via_ setting the
LTO macro.
• There is support for setting a different LTO flag for the Fortran
compiler, including to empty when mixing clang and gfortran (as
on macOS). See file config.site.
• There is a new LTO_LD macro to set linker options for LTO
compilation, for example to select an alternative linker or to
parallelize thin LTO.
DEPRECATED AND DEFUNCT:
• The LINPACK argument to chol.default(), chol2inv(),
solve.default() and svd() has been defunct since R 3.1.0. Using
it now gives a warning which will become an error in R 4.1.0.
BUG FIXES:
• The code mitigating stack overflow with PCRE regexps on very long
strings is enabled for PCRE2 < 10.30 also when JIT is enabled,
since stack overflows have been seen in that case.
• Fix to correctly show the group labels in dotchart() (which where
lost in the ylab improvement for R 4.0.0).
• addmargins(*, ..) now also works when fn() is a local function,
thanks to bug report and patch PR#17124 from Alex Bertram.
• rank(x) and hence sort(x) now work when x is an object (as per
is.object(x)) of type "raw" _and_ provides a valid `[` method,
e.g., for gmp::as.bigz(.) numbers.
• chisq.test(*, simulate.p.value=TRUE) and r2dtable() now work
correctly for large table entries (in the millions). Reported by
Sebastian Meyer and investigated by more helpers in PR#16184.
• Low-level socket read/write operations have been fixed to
correctly signal communication errors. Previously, such errors
could lead to a segfault due to invalid memory access. Reported
and debugged by Dmitriy Selivanov in PR#17850.
• quantile(x, pr) works more consistently for pr values slightly
outside [0,1], thanks to Suharto Anggono's PR#17891.
Further, quantile(x, prN, names=FALSE) now works even when prN
contains NAs, thanks to Anggono's PR#17892. Ditto for ordered
factors or Date objects when type = 1 or 3, thanks to PR#17899.
• Internet access based on libcurl, including curlGetHeaders(), was
not respecting the "timeout" option. If this causes
unanticipated timeouts, consider increasing the default by
setting R_DEFAULT_INTERNET_TIMEOUT.
• as.Date(<char>) now also works with an initial "", thanks to
Michael Chirico's PR#17909.
• isS3stdGeneric(f) now detects an S3 generic also when it is
trace()d, thanks to Gabe Becker's PR#17917.
• R_allocLD() has been fixed to return memory aligned for long
double type PR#16534.
• fisher.test() no longer segfaults when called again after its
internal stack has been exceeded PR#17904.
• Accessing a long vector represented by a compact integer sequence
no longer segfaults (reported and debugged by Hugh Parsonage).
• duplicated() now works also for strings with multiple encodings
inside a single vector PR#17809.
• phyper(11, 15, 0, 12, log.p=TRUE) no longer gives NaN; reported
as PR#17271 by Alexey Stukalov.
• Fix incorrect calculation in logLik.nls() PR#16100, patch from
Sebastian Meyer.
• A very old bug could cause a segfault in model.matrix() when
terms involved logical variables. Part of PR#17879.
• model.frame.default() allowed data = 1, leading to involuntary
variable capture (rest of PR#17879).
• tar() no longer skips non-directory files, thanks to a patch by
Sebastian Meyer, fixing the remaining part of PR#16716.
CHANGES IN R 4.0.2:
UTILITIES:
• R CMD check skips vignette re-building (with a warning) if the
VignetteBuilder package(s) are not available.
BUG FIXES:
• Paths with non-ASCII characters caused problems for package
loading on Windows PR#17833.
• Using tcltk widgets no longer crashes R on Windows.
• source(*, echo=TRUE) no longer fails in some cases with empty
lines; reported by Bill Dunlap in PR#17769.
• on.exit() now correctly matches named arguments, thanks to
PR#17815 (including patch) by Brodie Gaslam.
• regexpr(*, perl=TRUE) no longer returns incorrect positions into
text containing characters outside of the Unicode Basic
Multilingual Plane on Windows.
CHANGES IN R 4.0.1:
NEW FEATURES:
• paste() and paste0() gain a new optional argument recycle0. When
set to true, zero-length arguments are recycled leading to
character(0) after the sep-concatenation, i.e., to the empty
string "" if collapse is a string and to the zero-length value
character(0) when collapse = NULL.
A package whose code uses this should depend on R (>= 4.0.1).
• The summary(<warnings>) method now maps the counts correctly to
the warning messages.
BUG FIXES:
• aov(frml, ...) now also works where the formula deparses to more
than 500 characters, thanks to a report and patch proposal by Jan
Hauffa.
• Fix a dozen places (code, examples) as Sys.setlocale() returns
the new rather than the previous setting.
• Fix for adding two complex grid units via sum(). Thanks to Gu
Zuguang for the report and Thomas Lin Pedersen for the patch.
• Fix parallel::mclapply(..., mc.preschedule=FALSE) to handle raw
vector results correctly. PR#17779
• Computing the base value, i.e., 2, “everywhere”, now uses
FLT_RADIX, as the original machar code looped indefinitely on the
ppc64 architecture for the longdouble case.
• In R 4.0.0, sort.list(x) when is.object(x) was true, e.g., for x
<- I(letters), was accidentally using method = "radix".
Consequently, e.g., merge(<data.frame>) was much slower than
previously; reported in PR#17794.
• plot(y ~ x, ylab = quote(y[i])) now works, as e.g., for xlab;
related to PR#10525.
• parallel::detect.cores(all.tests = TRUE) tries a matching OS name
before the other tests (which were intended only for unknown
OSes).
• Parse data for raw strings is now recorded correctly. Reported by
Gabor Csardi.
CHANGES IN R 4.0.0:
SIGNIFICANT USER-VISIBLE CHANGES:
• Packages need to be (re-)installed under this version (4.0.0) of
R.
• matrix objects now also inherit from class "array", so e.g.,
class(diag(1)) is c("matrix", "array"). This invalidates code
incorrectly assuming that class(matrix_obj)) has length one.
S3 methods for class "array" are now dispatched for matrix
objects.
• There is a new syntax for specifying _raw_ character constants
similar to the one used in C++: r"(...)" with ... any character
sequence not containing the sequence )". This makes it easier to
write strings that contain backslashes or both single and double
quotes. For more details see ?Quotes.
• R now uses a stringsAsFactors = FALSE default, and hence by
default no longer converts strings to factors in calls to
data.frame() and read.table().
A large number of packages relied on the previous behaviour and
so have needed/will need updating.
• The plot() S3 generic function is now in package base rather than
package graphics, as it is reasonable to have methods that do not
use the graphics package. The generic is currently re-exported
from the graphics namespace to allow packages importing it from
there to continue working, but this may change in future.
Packages which define S4 generics for plot() should be
re-installed and package code using such generics from other
packages needs to ensure that they are imported rather than rely
on their being looked for on the search path (as in a namespace,
the base namespace has precedence over the search path).
REFERENCE COUNTING:
• Reference counting is now used instead of the NAMED mechanism for
determining when objects can be safely mutated in base C code.
This reduces the need for copying in some cases and should allow
further optimizations in the future. It should help make the
internal code easier to maintain.
This change is expected to have almost no impact on packages
using supported coding practices in their C/C++ code.
MIGRATION TO PCRE2:
• This version of R is built against the PCRE2 library for
Perl-like regular expressions, if available. (On non-Windows
platforms PCRE1 can optionally be used if PCRE2 is not available
at build time.) The version of PCRE in use can be obtained _via_
extSoftVersion(): PCRE1 (formerly known as ‘PCRE’) has versions
<= 8, PCRE2 versions >= 10.
• Making PCRE2 available when building R from source is strongly
recommended (preferably version 10.30 or later) as PCRE1 is no
longer developed: version 8.44 is ‘likely to be the final
release’.
• PCRE2 reports errors for some regular expressions that were
accepted by PCRE1. A hyphen now has to be escaped in a character
class to be interpreted as a literal (unless first or last in the
class definition). \R, \B and \X are no longer allowed in
character classes (PCRE1 treated these as literals).
• Option PCRE_study is no longer used with PCRE2, and is reported
as FALSE when that is in use.
NEW FEATURES:
• assertError() and assertWarning() (in package tools) can now
check for _specific_ error or warning classes _via_ the new
optional second argument classes (which is not back compatible
with previous use of an unnamed second argument).
• DF2formula(), the utility for the data frame method of formula(),
now works without parsing and explicit evaluation, starting from
Suharto Anggono's suggestion in PR#17555.
• approxfun() and approx() gain a new argument na.rm defaulting to
true. If set to false, missing y values now propagate into the
interpolated values.
• Long vectors are now supported as the seq argument of a for()
loop.
• str(x) gets a new deparse.lines option with a default to speed it
up when x is a large call object.
• The internal traceback object produced when an error is signalled
(.Traceback), now contains the calls rather than the _deparse()d_
calls, deferring the deparsing to the user-level functions
.traceback() and traceback(). This fulfils the wish of PR#17580,
reported including two patch proposals by Brodie Gaslam.
• data.matrix() now converts character columns to factors and from
this to integers.
• package.skeleton() now explicitly lists all exports in the
NAMESPACE file.
• New function .S3method() to register S3 methods in R scripts.
• file.path() has some support for file paths not in the session
encoding, e.g. with UTF-8 inputs in a non-UTF-8 locale the output
is marked as UTF-8.
• Most functions with file-path inputs will give an explicit error
if a file-path input in a marked encoding cannot be translated
(to the native encoding or in some cases on Windows to UTF-8),
rather than translate to a different file path using escapes.
Some (such as dir.exists(), file.exists(), file.access(),
file.info(), list.files(), normalizePath() and path.expand())
treat this like any other non-existent file, often with a
warning.
• There is a new help document accessed by help("file path
encoding") detailing how file paths with marked encodings are
handled.
• New function list2DF() for creating data frames from lists of
variables.
• iconv() has a new option sub = "Unicode" to translate UTF-8 input
invalid in the to encoding using <U+xxxx> escapes.
• There is a new function infoRDS() providing information about the
serialization format of a serialized object.
• S3 method lookup now by default skips the elements of the search
path between the global and base environments.
• Added an argument add_datalist(*, small.size = 0) to allow the
creation of a data/datalist file even when the total size of the
data sets is small.
• The backquote function bquote() has a new argument splice to
enable splicing a computed list of values into an expression,
like ,@ in LISP's backquote.
• The formula interface to t.test() and wilcox.test() has been
extended to handle one-sample and paired tests.
• The palette() function has a new default set of colours (which
are less saturated and have better accessibility properties).
There are also some new built-in palettes, which are listed by
the new palette.pals() function. These include the old default
palette under the name "R3". Finally, the new palette.colors()
function allows a subset of colours to be selected from any of
the built-in palettes.
• n2mfrow() gains an option asp = 1 to specify the aspect ratio,
fulfilling the wish and extending the proposal of Michael Chirico
in PR#17648.
• For head(x, n) and tail() the default and other S3 methods
notably for _vector_ n, e.g. to get a “corner” of a matrix, has
been extended to array's of higher dimension thanks to the patch
proposal by Gabe Becker in PR#17652. Consequently, optional
argument addrownums is deprecated and replaced by the (more
general) argument keepnums. An invalid second argument n now
leads to typically more easily readable error messages.
• New function .class2() provides the full character vector of
class names used for S3 method dispatch.
• Printing methods(..) now uses a new format() method.
• sort.list(x) now works for non-atomic objects x and method =
"auto" (the default) or "radix" in cases order(x) works,
typically via a xtfrm() method.
• Where they are available, writeBin() allows long vectors.
• New function deparse1() produces one string, wrapping deparse(),
to be used typically in deparse1(substitute(*)), e.g., to fix
PR#17671.
• wilcox.test() enhancements: In the (non-paired) two-sample case,
Inf values are treated as very large for robustness consistency.
If exact computations are used, the result now has "exact" in the
method element of its return value. New arguments tol.root and
digits.rank where the latter may be used for stability to treat
very close numbers as ties.
• readBin() and writeBin() now report an error for an invalid
endian value. The affected code needs to be fixed with care as
the old undocumented behavior was to swap endianness in such
cases.
• sequence() is now an S3 generic with an internally implemented
default method, and gains arguments to generate more complex
sequences. Based on code from the S4Vectors Bioconductor package
and the advice of Hervé Pagès.
• print()'s default method and many other methods (by calling the
default eventually and passing ...) now make use of a new
optional width argument, avoiding the need for the user to set
and reset options("width").
• memDecompress() supports the RFC 1952 format (e.g. in-memory
copies of gzip-compressed files) as well as RFC 1950.
• memCompress() and memDecompress() support long raw vectors for
types "gzip" and "zx".
• sweep() and slice.index() can now use names of dimnames for their
MARGIN argument (apply has had this for almost a decade).
• New function proportions() and marginSums(). These should replace
the unfortunately named prop.table() and margin.table(). They are
drop-in replacements, but also add named-margin functionality.
The old function names are retained as aliases for
back-compatibility.
• Functions rbinom(), rgeom(), rhyper(), rpois(), rnbinom(),
rsignrank() and rwilcox() which have returned integer since R
3.0.0 and hence NA when the numbers would have been outside the
integer range, now return double vectors (without NAs, typically)
in these cases.
• matplot(x,y) (and hence matlines() and matpoints()) now call the
corresponding methods of plot() and lines(), e.g, when x is a
"Date" or "POSIXct" object; prompted by Spencer Graves'
suggestion.
• stopifnot() now allows customizing error messages via argument
names, thanks to a patch proposal by Neal Fultz in PR#17688.
• unlink() gains a new argument expand to disable wildcard and
tilde expansion. Elements of x of value "~" are now ignored.
• mle() in the stats4 package has had its interface extended so
that arguments to the negative log-likelihood function can be one
or more vectors, with similar conventions applying to bounds,
start values, and parameter values to be kept fixed. This
required a minor extension to class "mle", so saved objects from
earlier versions may need to be recomputed.
• The default for pdf() is now useDingbats = FALSE.
• The default fill colour for hist() and boxplot() is now col =
"lightgray".
• The default order of the levels on the y-axis for spineplot() and
cdplot() has been reversed.
• If the R_ALWAYS_INSTALL_TESTS environment variable is set to a
true value, R CMD INSTALL behaves as if the --install-tests
option is always specified. Thanks to Reinhold Koch for the
suggestion.
• New function R_user_dir() in package tools suggests paths
appropriate for storing R-related user-specific data,
configuration and cache files.
• capabilities() gains a new logical option Xchk to avoid warnings
about X11-related capabilities.
• The internal implementation of grid units has changed, but the
only visible effects at user-level should be
• a slightly different print format for some units (especially
unit arithmetic),
• faster performance (for unit operations) and
• two new functions unitType() and unit.psum().
Based on code contributed by Thomas Lin Pedersen.
• When internal dispatch for rep.int() and rep_len() fails, there
is an attempt to dispatch on the equivalent call to rep().
• Object .Machine now contains new longdouble.* entries (when R
uses long doubles internally).
• news() has been enhanced to cover the news on R 3.x and 2.x.
• For consistency, N <- NULL; N[[1]] <- val now turns N into a list
also when val) has length one. This enables dimnames(r1)[[1]] <-
"R1" for a 1-row matrix r1, fixing PR#17719 reported by Serguei
Sokol.
• deparse(..), dump(..), and dput(x, control = "all") now include
control option "digits17" which typically ensures 1:1
invertibility. New option control = "exact" ensures numeric
exact invertibility via "hexNumeric".
• When loading data sets via read.table(), data() now uses
LC_COLLATE=C to ensure locale-independent results for possible
string-to-factor conversions.
• A server socket connection, a new connection type representing a
listening server socket, is created via serverSocket() and can
accept multiple socket connections via socketAccept().
• New function socketTimeout() changes the connection timeout of a
socket connection.
• The time needed to start a homogeneous PSOCK cluster on localhost
with many nodes has been significantly reduced (package
parallel).
• New globalCallingHandlers() function to establish global
condition handlers. This allows registering default handlers for
specific condition classes. Developed in collaboration with
Lionel Henry.
• New function tryInvokeRestart() to invoke a specified restart if
one is available and return without signaling an error if no such
restart is found. Contributed by Lionel Henry in PR#17598.
• str(x) now shows the length of attributes in some cases for a
data frame x.
• Rprof() gains a new argument filter.callframes to request that
intervening call frames due to lazy evaluation or explicit eval()
calls be omitted from the recorded profile data. Contributed by
Lionel Henry in PR#17595.
• The handling of ${FOO-bar} and ${FOO:-bar} in Renviron files now
follows POSIX shells (at least on a Unix-alike), so the first
treats empty environment variables as set and the second does
not. Previously both ignored empty variables. There are several
uses of the first form in etc/Renviron.
• New classes argument for suppressWarnings() and
suppressMessages() to selectively suppress only warnings or
messages that inherit from particular classes. Based on patch
from Lionel Henry submitted with PR#17619.
• New function activeBindingFunction() retrieves the function of an
active binding.
• New "cairoFT" and "pango" components in the output of
grSoftVersion().
• New argument symbolfamily in cairo-based graphics devices and new
function cairoSymbolFont() that can be used to provide the value
for that argument.
Windows:
• Rterm now works also when invoked from MSYS2 terminals. Line
editing is possible when command winpty is installed.
• normalizePath() now resolves symbolic links and normalizes case
of long names of path elements in case-insensitive folders
(PR#17165).
• md5sum() supports UTF-8 file names with characters that cannot be
translated to the native encoding (PR#17633).
• Rterm gains a new option --workspace to specify the workspace to
be restored. This allows equals to be part of the name when
opening _via_ Windows file associations (reported by Christian
Asseburg).
• Rterm now accepts ALT+xxx sequences also with NumLock on. Tilde
can be pasted with an Italian keyboard (PR#17679).
• R falls back to copying when junction creation fails during
package checking (patch from Duncan Murdoch).
DEPRECATED AND DEFUNCT:
• Make macro F77_VISIBILITY has been removed and replaced by
F_VISIBILITY.
• Make macros F77, FCPIFCPLAGS and SHLIB_OPENMP_FCFLAGS have been
removed and replaced by FC, FPICFLAGS and SHLIB_OPENMP_FFLAGS
respectively. (Most make programs will set F77 to the value of
FC, which is set for package compilation. But portable code
should not rely on this.)
• The deprecated support for specifying C++98 for package
installation has been removed.
• R CMD config no longer knows about the unused settings F77 and
FCPIFCPLAGS, nor CXX98 and similar.
• Either PCRE2 or PCRE1 >= 8.32 (Nov 2012) is required: the
deprecated provision for 8.20-8.31 has been removed.
• Defunct functions mem.limits(), .readRDS(), .saveRDS(),
.find.package(), and .path.package() from package base and
allGenerics(), getAccess(), getAllMethods(), getClassName(),
getClassPackage(), getExtends(), getProperties(), getPrototype(),
getSubclasses(), getVirtual(), mlistMetaName(),
removeMethodsObject(), seemsS4Object(), traceOff(), and traceOn()
from methods have been removed.
C-LEVEL FACILITIES:
• installChar is now remapped in Rinternals.h to installTrChar, of
which it has been a wrapper since R 3.6.0. Neither are part of
the API, but packages using installChar can replace it if they
depend on R >= 3.6.2.
• Header R_ext/Print.h defines R_USE_C99_IN_CXX and hence exposes
Rvprintf and REvprintf if used with a C++11 (or later) compiler.
• There are new Fortran subroutines dblepr1, realpr1 and intpr1 to
print a scalar variable (gfortran 10 enforces the distinction
between scalars and length-one arrays). Also labelpr to print
just a label.
• R_withCallingErrorHandler is now available for establishing a
calling handler in C code for conditions inheriting from class
error.
INSTALLATION on a UNIX-ALIKE:
• User-set DEFS (e.g., in config.site) is now used for compiling
packages (including base packages).
• There is a new variant option --enable-lto=check for checking
consistency of BLAS/LAPACK/LINPACK calls - see ‘Writing R
Extensions’.
• A C++ compiler default is set only if the C++11 standard is
supported: it no longer falls back to C++98.
• PCRE2 is used if available. To make use of PCRE1 if PCRE2 is
unavailable, configure with option --with-pcre1.
• The minimum required version of libcurl is now 7.28.0 (Oct 2012).
• New make target distcheck checks
• R can be rebuilt from the tarball created by make dist,
• the build from the tarball passes make check-all,
• the build installs and uninstalls,
• the source files are properly cleaned by make distclean.
UTILITIES:
• R --help now mentions the option --no-echo (renamed from --slave)
and its previously undocumented short form -s.
• R CMD check now optionally checks configure and cleanup scripts
for non-Bourne-shell code (‘bashisms’).
• R CMD check --as-cran now runs \donttest examples (which are run
by example()) instead of instructing the tester to do so. This
can be temporarily circumvented during development by setting
environment variable _R_CHECK_DONTTEST_EXAMPLES_ to a false
value.
PACKAGE INSTALLATION:
• There is the beginnings of support for the recently approved
C++20 standard, specified analogously to C++14 and C++17. There
is currently only limited support for this in compilers, with
flags such as -std=c++20 and -std=c++2a. For the time being the
configure test is of accepting one of these flags and compiling
C++17 code.
BUG FIXES:
• formula(x) with length(x) > 1 character vectors, is deprecated
now. Such use has been rare, and has ‘worked’ as expected in
some cases only. In other cases, wrong x have silently been
truncated, not detecting previous errors.
• Long-standing issue where the X11 device could lose events
shortly after startup has been addressed (PR#16702).
• The data.frame method for rbind() no longer drops <NA> levels
from factor columns by default (PR#17562).
• available.packages() and hence install.packages() now pass their
... argument to download.file(), fulfilling the wish of PR#17532;
subsequently, available.packages() gets new argument quiet,
solving PR#17573.
• stopifnot() gets new argument exprObject to allow an R object of
class expression (or other ‘language’) to work more consistently,
thanks to suggestions by Suharto Anggono.
• conformMethod() now works correctly in cases containing a “&&
logic” bug, reported by Henrik Bengtsson. It now creates methods
with "missing" entries in the signature. Consequently,
rematchDefinition() is amended to use appropriate .local() calls
with named arguments where needed.
• format.default(*, scientific = FALSE) now corresponds to a
practically most extreme options(scipen = n) setting rather than
arbitrary n = 100.
• format(as.symbol("foo")) now works (returning "foo").
• postscript(.., title = *) now signals an error when the title
string contains a character which would produce corrupt
PostScript, thanks to PR#17607 by Daisuko Ogawa.
• Certain Ops (notably comparison such as ==) now also work for
0-length data frames, after reports by Hilmar Berger.
• methods(class = class(glm(..))) now warns more usefully and only
once.
• write.dcf() no longer mangles field names (PR#17589).
• Primitive replacement functions no longer mutate a referenced
first argument when used outside of a complex assignment context.
• A better error message for contour(*, levels = Inf).
• The return value of contourLines() is no longer invisible().
• The Fortran code for calculating the coefficients component in
lm.influence() was very inefficient. It has (for now) been
replaced with much faster R code (PR#17624).
• cm.colors(n) _etc_ no longer append the code for alpha = 1, "FF",
to all colors. Hence all eight *.colors() functions and
rainbow() behave consistently and have the same non-explicit
default (PR#17659).
• dnorm had a problematic corner case with sd == -Inf or negative
sd which was not flagged as an error in all cases. Thanks to
Stephen D. Weigand for reporting and Wang Jiefei for analyzing
this; similar change has been made in dlnorm().
• The optional iter.smooth argument of plot.lm(), (the plot()
method for lm and glm fits) now defaults to 0 for all glm fits.
Especially for binary observations with high or low fitted
probabilities, this effectively deleted all observations of 1 or
0. Also, the type of residuals used in the glm case has been
switched to "pearson" since deviance residuals do not in general
have approximately zero mean.
• In plot.lm, Cook's distance was computed from unweighted
residuals, leading to inconsistencies. Replaced with usual
weighted version. (PR#16056)
• Time-series ts(*, start, end, frequency) with fractional
frequency are supported more consistently; thanks to a report
from Johann Kleinbub and analysis and patch by Duncan Murdoch in
PR#17669.
• In case of errors mcmapply() now preserves attributes of returned
"try-error" objects and avoids simplification, overriding
SIMPLIFY to FALSE. (PR#17653)
• as.difftime() gets new optional tz = "UTC" argument which should
fix behaviour during daylight-savings-changeover days, fixing
PR#16764, thanks to proposals and analysis by Johannes Ranke and
Kirill Müller.
• round() does a better job of rounding _“to nearest”_ by
_measuring_ and _“to even”_; thanks to a careful algorithm
originally prompted by the report from Adam Wheeler and then
others, in PR#17668.
round(x, dig) for _negative_ digits is much more rational now,
notably for large |dig|.
• Inheritance information on S4 classes is maintained more
consistently, particularly in the case of class unions (in part
due to PR#17596 and a report from Ezra Tucker).
• is() behaves more robustly when its argument class2 is a
classRepresentation object.
• The warning message when attempting to export an nonexistent
class is now more readable; thanks to Thierry Onkelinx for
recognizing the problem.
• choose() misbehaved in corner cases where it switched n - k for k
and n was only _nearly_ integer (report from Erik Scott Wright).
• mle() in the stats4 package had problems combining use of box
constraints and fixed starting values (in particular, confidence
intervals were affected).
• Operator ? now has lower precedence than = to work as documented,
so = behaves like <- in help expressions (PR#16710).
• smoothEnds(x) now returns integer type in _both_ cases when x is
integer, thanks to a report and proposal by Bill Dunlap PR#17693.
• The methods package does a better job of tracking inheritance
relationships across packages.
• norm(diag(c(1, NA)), "2") now works.
• subset() had problems with 0-col dataframes (reported by Bill
Dunlap, PR#17721).
• Several cases of integer overflow detected by the ‘undefined
behaviour sanitizer’ of clang 10 have been circumvented. One in
rhyper() may change the generated value for large input values.
• dotchart() now places the y-axis label (ylab) much better, not
overplotting labels, thanks to a report and suggestion by Alexey
Shipunov.
• A rare C-level array overflow in chull() has been worked around.
• Some invalid specifications of the day-of-the-year (_via_ %j,
e.g. day 366 in 2017) or week plus day-of-the-week are now
detected by strptime(). They now return NA but give a warning as
they may have given random results or corrupted memory in earlier
versions of R.
• socketConnection(server = FALSE) now respects the connection
timeout also on Linux.
• socketConnection(server = FALSE) no longer leaks a connection
that is available right away without waiting (e.g. on localhost).
• Socket connections are now robust against spurious readability
and spurious availability of an incoming connection.
• blocking = FALSE is now respected also on the server side of a
socket connection, allowing non-blocking read operations.
• anova.glm() and anova.glmlist() computed incorrect score (Rao)
tests in no-intercept cases. (André Gillibert, PR#17735)
• summaryRprof() now should work correctly for the Rprof(*,
memory.profiling=TRUE) case with small chunk size (and "tseries"
or similar) thanks to a patch proposal by Benjamin Tyner, in
PR#15886.
• xgettext() ignores strings passed to ngettext(), since the latter
is handled by xngettext(). Thanks to Daniele Medri for the report
and all the recent work he has done on the Italian translations.
• data(package = "P") for P in base and stats no longer reports the
data sets from package datasets (which it did for back
compatibility for 16 years), fixing PR#17730.
• x[[Inf]] (returning NULL) no longer leads to undefined behavior,
thanks to a report by Kirill Müller in PR#17756. Further,
x[[-Inf]] and x[[-n]] now give more helpful error messages.
• Gamma() family sometimes had trouble storing link name PR#15891
BUG FIXES (Windows):
• Sys.glob() now supports all characters from the Unicode Basic
Multilingual Plane, no longer corrupting some (less commonly
used) characters (PR#17638).
• Rterm now correctly displays multi-byte-coded characters
representable in the current native encoding (at least on Windows
10 they were sometimes omitted, PR#17632).
• scan() issues with UTF-8 data when running in a DBCS locale have
been resolved (PR#16520, PR#16584).
• Rterm now accepts enhanced/arrow keys also with ConPTY.
• R can now be started _via_ the launcher icon in a user documents
directory whose path is not representable in the system encoding.
• socketConnection(server = FALSE) now returns instantly also on
Windows when connection failure is signalled.
• Problems with UTF-16 surrogate pairs have been fixed in several
functions, including tolower() and toupper() (PR#17645).
CHANGES in previous versions:
• Older news can be found in text format in files NEWS.0, NEWS.1,
NEWS.2 and NEWS.3 in the doc directory. News in HTML format for R
versions 3.x and from 2.10.0 to 2.15.3 are available at
doc/html/NEWS.3.html and doc/html/NEWS.2.html.
|