summaryrefslogtreecommitdiffstats
path: root/ChangeLog
blob: bfcc34517fe7641b368ef729cea58391054ff709 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3146
3147
3148
3149
3150
3151
3152
3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
3311
3312
3313
3314
3315
3316
3317
3318
3319
3320
3321
3322
3323
3324
3325
3326
3327
3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
3384
3385
3386
3387
3388
3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
3403
3404
3405
3406
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420
3421
3422
3423
3424
3425
3426
3427
3428
3429
3430
3431
3432
3433
3434
3435
3436
3437
3438
3439
3440
3441
3442
3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
3501
3502
3503
3504
3505
3506
3507
3508
3509
3510
3511
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529
3530
3531
3532
3533
3534
3535
3536
3537
3538
3539
3540
3541
3542
3543
3544
3545
3546
3547
3548
3549
3550
3551
3552
3553
3554
3555
3556
3557
3558
3559
3560
3561
3562
3563
3564
3565
3566
3567
3568
3569
3570
3571
3572
3573
3574
3575
3576
3577
3578
3579
3580
3581
3582
3583
3584
3585
3586
3587
3588
3589
3590
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
3606
3607
3608
3609
3610
3611
3612
3613
3614
3615
3616
3617
3618
3619
3620
3621
3622
3623
3624
3625
3626
3627
3628
3629
3630
3631
3632
3633
3634
3635
3636
3637
3638
3639
3640
3641
3642
3643
3644
3645
3646
3647
3648
3649
3650
3651
3652
3653
3654
3655
3656
3657
3658
3659
3660
3661
3662
3663
3664
3665
3666
3667
3668
3669
3670
3671
3672
3673
3674
3675
3676
3677
3678
3679
3680
3681
3682
3683
3684
3685
3686
3687
3688
3689
3690
3691
3692
3693
3694
3695
3696
3697
3698
3699
3700
3701
3702
3703
3704
3705
3706
3707
3708
3709
3710
3711
3712
3713
3714
3715
3716
3717
3718
3719
3720
3721
3722
3723
3724
3725
3726
3727
3728
3729
3730
3731
3732
3733
3734
3735
3736
3737
3738
3739
3740
3741
3742
3743
3744
3745
3746
3747
3748
3749
3750
3751
3752
3753
3754
3755
3756
3757
3758
3759
3760
3761
3762
3763
3764
3765
3766
3767
3768
3769
3770
3771
3772
3773
3774
3775
3776
3777
3778
3779
3780
3781
3782
3783
3784
3785
3786
3787
3788
3789
3790
3791
3792
3793
3794
3795
3796
3797
3798
3799
3800
3801
3802
3803
3804
3805
3806
3807
3808
3809
3810
3811
3812
3813
3814
3815
3816
3817
3818
3819
3820
3821
3822
3823
3824
3825
3826
3827
3828
3829
3830
3831
3832
3833
3834
3835
3836
3837
3838
3839
3840
3841
3842
3843
3844
3845
3846
3847
3848
3849
3850
3851
3852
3853
3854
3855
3856
3857
3858
3859
3860
3861
3862
3863
3864
3865
3866
3867
3868
3869
3870
3871
3872
3873
3874
3875
3876
3877
3878
3879
3880
3881
3882
3883
3884
3885
3886
3887
3888
3889
3890
3891
3892
3893
3894
3895
3896
3897
3898
3899
3900
3901
3902
3903
3904
3905
3906
3907
3908
3909
3910
3911
3912
3913
3914
3915
3916
3917
3918
3919
3920
3921
3922
3923
3924
3925
3926
3927
3928
3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
3939
3940
3941
3942
3943
3944
3945
3946
3947
3948
3949
3950
3951
3952
3953
3954
3955
3956
3957
3958
3959
3960
3961
3962
3963
3964
3965
3966
3967
3968
3969
3970
3971
3972
3973
3974
3975
3976
3977
3978
3979
3980
3981
3982
3983
3984
3985
3986
3987
3988
3989
3990
3991
3992
3993
3994
3995
3996
3997
3998
3999
4000
4001
4002
4003
4004
4005
4006
4007
4008
4009
4010
4011
4012
4013
4014
4015
4016
4017
4018
4019
4020
4021
4022
4023
4024
4025
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036
4037
4038
4039
4040
4041
4042
4043
4044
4045
4046
4047
4048
4049
4050
4051
4052
4053
4054
4055
4056
4057
4058
4059
4060
4061
4062
4063
4064
4065
4066
4067
4068
4069
4070
4071
4072
4073
4074
4075
4076
4077
4078
4079
4080
4081
4082
4083
4084
4085
4086
4087
4088
4089
4090
4091
4092
4093
4094
4095
4096
4097
4098
4099
4100
4101
4102
4103
4104
4105
4106
4107
4108
4109
4110
4111
4112
4113
4114
4115
4116
4117
4118
4119
4120
4121
4122
4123
4124
4125
4126
4127
4128
4129
4130
4131
4132
4133
4134
4135
4136
4137
4138
4139
4140
4141
4142
4143
4144
4145
4146
4147
4148
4149
4150
4151
4152
4153
4154
4155
4156
4157
4158
4159
4160
4161
4162
4163
4164
4165
4166
4167
4168
4169
4170
4171
4172
4173
4174
4175
4176
4177
4178
4179
4180
4181
4182
4183
4184
4185
4186
4187
4188
4189
4190
4191
4192
4193
4194
4195
4196
4197
4198
4199
4200
4201
4202
4203
4204
4205
4206
4207
4208
4209
4210
4211
4212
4213
4214
4215
4216
4217
4218
4219
4220
4221
4222
4223
4224
4225
4226
4227
4228
4229
4230
4231
4232
4233
4234
4235
4236
4237
4238
4239
4240
4241
4242
4243
4244
4245
4246
4247
4248
4249
4250
4251
4252
4253
4254
4255
4256
4257
4258
4259
4260
4261
4262
4263
4264
4265
4266
4267
4268
4269
4270
4271
4272
4273
4274
4275
4276
4277
4278
4279
4280
4281
4282
4283
4284
4285
4286
4287
4288
4289
4290
4291
4292
4293
4294
4295
4296
4297
4298
4299
4300
4301
4302
4303
4304
4305
4306
4307
4308
4309
4310
4311
4312
4313
4314
4315
4316
4317
4318
4319
4320
4321
4322
4323
4324
4325
4326
4327
4328
4329
4330
4331
4332
4333
4334
4335
4336
4337
4338
4339
4340
4341
4342
4343
4344
4345
4346
4347
4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
4362
4363
4364
4365
4366
4367
4368
4369
4370
4371
4372
4373
4374
4375
4376
4377
4378
4379
4380
4381
4382
4383
4384
4385
4386
4387
4388
4389
4390
4391
4392
4393
4394
4395
4396
4397
4398
4399
4400
4401
4402
4403
4404
4405
4406
4407
4408
4409
4410
4411
4412
4413
4414
4415
4416
4417
4418
4419
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
4433
4434
4435
4436
4437
4438
4439
4440
4441
4442
4443
4444
4445
4446
4447
4448
4449
4450
4451
4452
4453
4454
4455
4456
4457
4458
4459
4460
4461
4462
4463
4464
4465
4466
4467
4468
4469
4470
4471
4472
4473
4474
4475
4476
4477
4478
4479
4480
4481
4482
4483
4484
4485
4486
4487
4488
4489
4490
4491
4492
4493
4494
4495
4496
4497
4498
4499
4500
4501
4502
4503
4504
4505
4506
4507
4508
4509
4510
4511
4512
4513
4514
4515
4516
4517
4518
4519
4520
4521
4522
4523
4524
4525
4526
4527
4528
4529
4530
4531
4532
4533
4534
4535
4536
4537
4538
4539
4540
4541
4542
4543
4544
4545
4546
4547
4548
4549
4550
4551
4552
4553
4554
4555
4556
4557
4558
4559
4560
4561
4562
4563
4564
4565
4566
4567
4568
4569
4570
4571
4572
4573
4574
4575
4576
4577
4578
4579
4580
4581
4582
4583
4584
4585
4586
4587
4588
4589
4590
4591
4592
4593
4594
4595
4596
4597
4598
4599
4600
4601
4602
4603
4604
4605
4606
4607
4608
4609
4610
4611
4612
4613
4614
4615
4616
4617
4618
4619
4620
4621
4622
4623
4624
4625
4626
4627
4628
4629
4630
4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
4643
4644
4645
4646
4647
4648
4649
4650
4651
4652
4653
4654
4655
4656
4657
4658
4659
4660
4661
4662
4663
4664
4665
4666
4667
4668
4669
4670
4671
4672
4673
4674
4675
4676
4677
4678
4679
4680
4681
4682
4683
4684
4685
4686
4687
4688
4689
4690
4691
4692
4693
4694
4695
4696
4697
4698
4699
4700
4701
4702
4703
4704
4705
4706
4707
4708
4709
4710
4711
4712
4713
4714
4715
4716
4717
4718
4719
4720
4721
4722
4723
4724
4725
4726
4727
4728
4729
4730
4731
4732
4733
4734
4735
4736
4737
4738
4739
4740
4741
4742
4743
4744
4745
4746
4747
4748
4749
4750
4751
4752
4753
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763
4764
4765
4766
4767
4768
4769
4770
4771
4772
4773
4774
4775
4776
4777
4778
4779
4780
4781
4782
4783
4784
4785
4786
4787
4788
4789
4790
4791
4792
4793
4794
4795
4796
4797
4798
4799
4800
4801
4802
4803
4804
4805
4806
4807
4808
4809
4810
4811
4812
4813
4814
4815
4816
4817
4818
4819
4820
4821
4822
4823
4824
4825
4826
4827
4828
4829
4830
4831
4832
4833
4834
4835
4836
4837
4838
4839
4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
4850
4851
4852
4853
4854
4855
4856
4857
4858
4859
4860
4861
4862
4863
4864
4865
4866
4867
4868
4869
4870
4871
4872
4873
4874
4875
4876
4877
4878
4879
4880
4881
4882
4883
4884
4885
4886
4887
4888
4889
4890
4891
4892
4893
4894
4895
4896
4897
4898
4899
4900
4901
4902
4903
4904
4905
4906
4907
4908
4909
4910
4911
4912
4913
4914
4915
4916
4917
4918
4919
4920
4921
4922
4923
4924
4925
4926
4927
4928
4929
4930
4931
4932
4933
4934
4935
4936
4937
4938
4939
4940
4941
4942
4943
4944
4945
4946
4947
4948
4949
4950
4951
4952
4953
4954
4955
4956
4957
4958
4959
4960
4961
4962
4963
4964
4965
4966
4967
4968
4969
4970
4971
4972
4973
4974
4975
4976
4977
4978
4979
4980
4981
4982
4983
4984
4985
4986
4987
4988
4989
4990
4991
4992
4993
4994
4995
4996
4997
4998
4999
5000
5001
5002
5003
5004
5005
5006
5007
5008
5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
5030
5031
5032
5033
5034
5035
5036
5037
5038
5039
5040
5041
5042
5043
5044
5045
5046
5047
5048
5049
5050
5051
5052
5053
5054
5055
5056
5057
5058
5059
5060
5061
5062
5063
5064
5065
5066
5067
5068
5069
5070
5071
5072
5073
5074
5075
5076
5077
5078
5079
5080
5081
5082
5083
5084
5085
5086
5087
5088
5089
5090
5091
5092
5093
5094
5095
5096
5097
5098
5099
5100
5101
5102
5103
5104
5105
5106
5107
5108
5109
5110
5111
5112
5113
5114
5115
5116
5117
5118
5119
5120
5121
5122
5123
5124
5125
5126
5127
5128
5129
5130
5131
5132
5133
5134
5135
5136
5137
5138
5139
5140
5141
5142
5143
5144
5145
5146
5147
5148
5149
5150
5151
5152
5153
5154
5155
5156
5157
5158
5159
5160
5161
5162
5163
5164
5165
5166
5167
5168
5169
5170
5171
5172
5173
5174
5175
5176
5177
5178
5179
5180
5181
5182
5183
5184
5185
5186
5187
5188
5189
5190
5191
5192
5193
5194
5195
5196
5197
5198
5199
5200
5201
5202
5203
5204
5205
5206
5207
5208
5209
5210
5211
5212
5213
5214
5215
5216
5217
5218
5219
5220
5221
5222
5223
5224
5225
5226
5227
5228
5229
5230
5231
5232
5233
5234
5235
5236
5237
5238
5239
5240
5241
5242
5243
5244
5245
5246
5247
5248
5249
5250
5251
5252
5253
5254
5255
5256
5257
5258
5259
5260
5261
5262
5263
5264
5265
5266
5267
5268
5269
5270
5271
5272
5273
5274
5275
5276
5277
5278
5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
5296
5297
5298
5299
5300
5301
5302
5303
5304
5305
5306
5307
5308
5309
5310
5311
5312
5313
5314
5315
5316
5317
5318
5319
5320
5321
5322
5323
5324
5325
5326
5327
5328
5329
5330
5331
5332
5333
5334
5335
5336
5337
5338
5339
5340
5341
5342
5343
5344
5345
5346
5347
5348
5349
5350
5351
5352
5353
5354
5355
5356
5357
5358
5359
5360
5361
5362
5363
5364
5365
5366
5367
5368
5369
5370
5371
5372
5373
5374
5375
5376
5377
5378
5379
5380
5381
5382
5383
5384
5385
5386
5387
5388
5389
5390
5391
5392
5393
5394
5395
5396
5397
5398
5399
5400
5401
5402
5403
5404
5405
5406
5407
5408
5409
5410
5411
5412
5413
5414
5415
5416
5417
5418
5419
5420
5421
5422
5423
5424
5425
5426
5427
5428
5429
5430
5431
5432
5433
5434
5435
5436
5437
5438
5439
5440
5441
5442
5443
5444
5445
5446
5447
5448
5449
5450
5451
5452
5453
5454
5455
5456
5457
5458
5459
5460
5461
5462
5463
5464
5465
5466
5467
5468
5469
5470
5471
5472
5473
5474
5475
5476
5477
5478
5479
5480
5481
5482
5483
5484
5485
5486
5487
5488
5489
5490
5491
5492
5493
5494
5495
5496
5497
5498
5499
5500
5501
5502
5503
5504
5505
5506
5507
5508
5509
5510
5511
5512
5513
5514
5515
5516
5517
5518
5519
5520
5521
5522
5523
5524
5525
5526
5527
5528
5529
5530
5531
5532
5533
5534
5535
5536
5537
5538
5539
5540
5541
5542
5543
5544
5545
5546
5547
5548
5549
5550
5551
5552
5553
5554
5555
5556
5557
5558
5559
5560
5561
5562
5563
5564
5565
5566
5567
5568
5569
5570
5571
5572
5573
5574
5575
5576
5577
5578
5579
5580
5581
5582
5583
5584
5585
5586
5587
5588
5589
5590
5591
5592
5593
5594
5595
5596
5597
5598
5599
5600
5601
5602
5603
5604
5605
5606
5607
5608
5609
5610
5611
5612
5613
5614
5615
5616
5617
5618
5619
5620
5621
5622
5623
5624
5625
5626
5627
5628
5629
5630
5631
5632
5633
5634
5635
5636
5637
5638
5639
5640
5641
5642
5643
5644
5645
5646
5647
5648
5649
5650
5651
5652
5653
5654
5655
5656
5657
5658
5659
5660
5661
5662
5663
5664
5665
5666
5667
5668
5669
5670
5671
5672
5673
5674
5675
5676
5677
5678
5679
5680
5681
5682
5683
5684
5685
5686
5687
5688
5689
5690
5691
5692
5693
5694
5695
5696
5697
5698
5699
5700
5701
5702
5703
5704
5705
5706
5707
5708
5709
5710
5711
5712
5713
5714
5715
5716
5717
5718
5719
5720
5721
5722
5723
5724
5725
5726
5727
5728
5729
5730
5731
5732
5733
5734
5735
5736
5737
5738
5739
5740
5741
5742
5743
5744
5745
5746
5747
5748
5749
5750
5751
5752
5753
5754
5755
5756
5757
5758
5759
5760
5761
5762
5763
5764
5765
5766
5767
5768
5769
5770
5771
5772
5773
5774
5775
5776
5777
5778
5779
5780
5781
5782
5783
5784
5785
5786
5787
5788
5789
5790
5791
5792
5793
5794
5795
5796
5797
5798
5799
5800
5801
5802
5803
5804
5805
5806
5807
5808
5809
5810
5811
5812
5813
5814
5815
5816
5817
5818
5819
5820
5821
5822
5823
5824
5825
5826
5827
5828
5829
5830
5831
5832
5833
5834
5835
5836
5837
5838
5839
5840
5841
5842
5843
5844
5845
5846
5847
5848
5849
5850
5851
5852
5853
5854
5855
5856
5857
5858
5859
5860
5861
5862
5863
5864
5865
5866
5867
5868
5869
5870
5871
5872
5873
5874
5875
5876
5877
5878
5879
5880
5881
5882
5883
5884
5885
5886
5887
5888
5889
5890
5891
5892
5893
5894
5895
5896
5897
5898
5899
5900
5901
5902
5903
5904
5905
5906
5907
5908
5909
5910
5911
5912
5913
5914
5915
5916
5917
5918
5919
5920
5921
5922
5923
5924
5925
5926
5927
5928
5929
5930
5931
5932
5933
5934
5935
5936
5937
5938
5939
5940
5941
5942
5943
5944
5945
5946
5947
5948
5949
5950
5951
5952
5953
5954
5955
5956
5957
5958
5959
5960
5961
5962
5963
5964
5965
5966
5967
5968
5969
5970
5971
5972
5973
5974
5975
5976
5977
5978
5979
5980
5981
5982
5983
5984
5985
5986
5987
5988
5989
5990
5991
5992
5993
5994
5995
5996
5997
5998
5999
6000
6001
6002
6003
6004
6005
6006
6007
6008
6009
6010
6011
6012
6013
6014
6015
6016
6017
6018
6019
6020
6021
6022
6023
6024
6025
6026
6027
6028
6029
6030
6031
6032
6033
6034
6035
6036
6037
6038
6039
6040
6041
6042
6043
6044
6045
6046
6047
6048
6049
6050
6051
6052
6053
6054
6055
6056
6057
6058
6059
6060
6061
6062
6063
6064
6065
6066
6067
6068
6069
6070
6071
6072
6073
6074
6075
6076
6077
6078
6079
6080
6081
6082
6083
6084
6085
6086
6087
6088
6089
6090
6091
6092
6093
6094
6095
6096
6097
6098
6099
6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
6113
6114
6115
6116
6117
6118
6119
6120
6121
6122
6123
6124
6125
6126
6127
6128
6129
6130
6131
6132
6133
6134
6135
6136
6137
6138
6139
6140
6141
6142
6143
6144
6145
6146
6147
6148
6149
6150
6151
6152
6153
6154
6155
6156
6157
6158
6159
6160
6161
6162
6163
6164
6165
6166
6167
6168
6169
6170
6171
6172
6173
6174
6175
6176
6177
6178
6179
6180
6181
6182
6183
6184
6185
6186
6187
6188
6189
6190
6191
6192
6193
6194
6195
6196
6197
6198
6199
6200
6201
6202
6203
6204
6205
6206
6207
6208
6209
6210
6211
6212
6213
6214
6215
6216
6217
6218
6219
6220
6221
6222
6223
6224
6225
6226
6227
6228
6229
6230
6231
6232
6233
6234
6235
6236
6237
6238
6239
6240
6241
6242
6243
6244
6245
6246
6247
6248
6249
6250
6251
6252
6253
6254
6255
6256
6257
6258
6259
6260
6261
6262
6263
6264
6265
6266
6267
6268
6269
6270
6271
6272
6273
6274
6275
6276
6277
6278
6279
6280
6281
6282
6283
6284
6285
6286
6287
6288
6289
6290
6291
6292
6293
6294
6295
6296
6297
6298
6299
6300
6301
6302
6303
6304
6305
6306
6307
6308
6309
6310
6311
6312
6313
6314
6315
6316
6317
6318
6319
6320
6321
6322
6323
6324
6325
6326
6327
6328
6329
6330
6331
6332
6333
6334
6335
6336
6337
6338
6339
6340
6341
6342
6343
6344
6345
6346
6347
6348
6349
6350
6351
6352
6353
6354
6355
6356
6357
6358
6359
6360
6361
6362
6363
6364
6365
6366
6367
6368
6369
6370
6371
6372
6373
6374
6375
6376
6377
6378
6379
6380
6381
6382
6383
6384
6385
6386
6387
6388
6389
6390
6391
6392
6393
6394
6395
6396
6397
6398
6399
6400
6401
6402
6403
6404
6405
6406
6407
6408
6409
6410
6411
6412
6413
6414
6415
6416
6417
6418
6419
6420
6421
6422
6423
6424
6425
6426
6427
6428
6429
6430
6431
6432
6433
6434
6435
6436
6437
6438
6439
6440
6441
6442
6443
6444
6445
6446
6447
6448
6449
6450
6451
6452
6453
6454
6455
6456
6457
6458
6459
6460
6461
6462
6463
6464
6465
6466
6467
6468
6469
6470
6471
6472
6473
6474
6475
6476
6477
6478
6479
6480
6481
6482
6483
6484
6485
6486
6487
6488
6489
6490
6491
6492
6493
6494
6495
6496
6497
6498
6499
6500
6501
6502
6503
6504
6505
6506
6507
6508
6509
6510
6511
6512
6513
6514
6515
6516
6517
6518
6519
6520
6521
6522
6523
6524
6525
6526
6527
6528
6529
6530
6531
6532
6533
6534
6535
6536
6537
6538
6539
6540
6541
6542
6543
6544
6545
6546
6547
6548
6549
6550
6551
6552
6553
6554
6555
6556
6557
6558
6559
6560
6561
6562
6563
6564
6565
6566
6567
6568
6569
6570
6571
6572
6573
6574
6575
6576
6577
6578
6579
6580
6581
6582
6583
6584
6585
6586
6587
6588
6589
6590
6591
6592
6593
6594
6595
6596
6597
6598
6599
6600
6601
6602
6603
6604
6605
6606
6607
6608
6609
6610
6611
6612
6613
6614
6615
6616
6617
6618
6619
6620
6621
6622
6623
6624
6625
6626
6627
6628
6629
6630
6631
6632
6633
6634
6635
6636
6637
6638
6639
6640
6641
6642
6643
6644
6645
6646
6647
6648
6649
6650
6651
6652
6653
6654
6655
6656
6657
6658
6659
6660
6661
6662
6663
6664
6665
6666
6667
6668
6669
6670
6671
6672
6673
6674
6675
6676
6677
6678
6679
6680
6681
6682
6683
6684
6685
6686
6687
6688
6689
6690
6691
6692
6693
6694
6695
6696
6697
6698
6699
6700
6701
6702
6703
6704
6705
6706
6707
6708
6709
6710
6711
6712
6713
6714
6715
6716
6717
6718
6719
6720
6721
6722
6723
6724
6725
6726
6727
6728
6729
6730
6731
6732
6733
6734
6735
6736
6737
6738
6739
6740
6741
6742
6743
6744
6745
6746
6747
6748
6749
6750
6751
6752
6753
6754
6755
6756
6757
6758
6759
6760
6761
6762
6763
6764
6765
6766
6767
6768
6769
6770
6771
6772
6773
6774
6775
6776
6777
6778
6779
6780
6781
6782
6783
6784
6785
6786
6787
6788
6789
6790
6791
6792
6793
6794
6795
6796
6797
6798
6799
6800
6801
6802
6803
6804
6805
6806
6807
6808
6809
6810
6811
6812
6813
6814
6815
6816
6817
6818
6819
6820
6821
6822
6823
6824
6825
6826
6827
6828
6829
6830
6831
6832
6833
6834
6835
6836
6837
6838
6839
6840
6841
6842
6843
6844
6845
6846
6847
6848
6849
6850
6851
6852
6853
6854
6855
6856
6857
6858
6859
6860
6861
6862
6863
6864
6865
6866
6867
6868
6869
6870
6871
6872
6873
6874
6875
6876
6877
6878
6879
6880
6881
6882
6883
6884
6885
6886
6887
6888
6889
6890
6891
6892
6893
6894
6895
6896
6897
6898
6899
6900
6901
6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913
6914
6915
6916
6917
6918
6919
6920
6921
6922
6923
6924
6925
6926
6927
6928
6929
6930
6931
6932
6933
6934
6935
6936
6937
6938
6939
6940
6941
6942
6943
6944
6945
6946
6947
6948
6949
6950
6951
6952
6953
6954
6955
6956
6957
6958
6959
6960
6961
6962
6963
6964
6965
6966
6967
6968
6969
6970
6971
6972
6973
6974
6975
6976
6977
6978
6979
6980
6981
6982
6983
6984
6985
6986
6987
6988
6989
6990
6991
6992
6993
6994
6995
6996
6997
6998
6999
7000
7001
7002
7003
7004
7005
7006
7007
7008
7009
7010
7011
7012
7013
7014
7015
7016
7017
7018
7019
7020
7021
7022
7023
7024
7025
7026
7027
7028
7029
7030
7031
7032
7033
7034
7035
7036
7037
7038
7039
7040
7041
7042
7043
7044
7045
7046
7047
7048
7049
7050
7051
7052
7053
7054
7055
7056
7057
7058
7059
7060
7061
7062
7063
7064
7065
7066
7067
7068
7069
7070
7071
7072
7073
7074
7075
7076
7077
7078
7079
7080
7081
7082
7083
7084
7085
7086
7087
7088
7089
7090
7091
7092
7093
7094
7095
7096
7097
7098
7099
7100
7101
7102
7103
7104
7105
7106
7107
7108
7109
7110
7111
7112
7113
7114
7115
7116
7117
7118
7119
7120
7121
7122
7123
7124
7125
7126
7127
7128
7129
7130
7131
7132
7133
7134
7135
7136
7137
7138
7139
7140
7141
7142
7143
7144
7145
7146
7147
7148
7149
7150
7151
7152
7153
7154
7155
7156
7157
7158
7159
7160
7161
7162
7163
7164
7165
7166
7167
7168
7169
7170
7171
7172
7173
7174
7175
7176
7177
7178
7179
7180
7181
7182
7183
7184
7185
7186
7187
7188
7189
7190
7191
7192
7193
7194
7195
7196
7197
7198
7199
7200
7201
7202
7203
7204
7205
7206
7207
7208
7209
7210
7211
7212
7213
7214
7215
7216
7217
7218
7219
7220
7221
7222
7223
7224
7225
7226
7227
7228
7229
7230
7231
7232
7233
7234
7235
7236
7237
7238
7239
7240
7241
7242
7243
7244
7245
7246
7247
7248
7249
7250
7251
7252
7253
7254
7255
7256
7257
7258
7259
7260
7261
7262
7263
7264
7265
7266
7267
7268
7269
7270
7271
7272
7273
7274
7275
7276
7277
7278
7279
7280
7281
7282
7283
7284
7285
7286
7287
7288
7289
7290
7291
7292
7293
7294
7295
7296
7297
7298
7299
7300
7301
7302
7303
7304
7305
7306
7307
7308
7309
7310
7311
7312
7313
7314
7315
7316
7317
7318
7319
7320
7321
7322
7323
7324
7325
7326
7327
7328
7329
7330
7331
7332
7333
7334
7335
7336
7337
7338
7339
7340
7341
7342
7343
7344
7345
7346
7347
7348
7349
7350
7351
7352
7353
7354
7355
7356
7357
7358
7359
7360
7361
7362
7363
7364
7365
7366
7367
7368
7369
7370
7371
7372
7373
7374
7375
7376
7377
7378
7379
7380
7381
7382
7383
7384
7385
7386
7387
7388
7389
7390
7391
7392
7393
7394
7395
7396
7397
7398
7399
7400
7401
7402
7403
7404
7405
7406
7407
7408
7409
7410
7411
7412
7413
7414
7415
7416
7417
7418
7419
7420
7421
7422
7423
7424
7425
7426
7427
7428
7429
7430
7431
7432
7433
7434
7435
7436
7437
7438
7439
7440
7441
7442
7443
7444
7445
7446
7447
7448
7449
7450
7451
7452
7453
7454
7455
7456
7457
7458
7459
7460
7461
7462
7463
7464
7465
7466
7467
7468
7469
7470
7471
7472
7473
7474
7475
7476
7477
7478
7479
7480
7481
7482
7483
7484
7485
7486
7487
7488
7489
7490
7491
7492
7493
7494
7495
7496
7497
7498
7499
7500
7501
7502
7503
7504
7505
7506
7507
7508
7509
7510
7511
7512
7513
7514
7515
7516
7517
7518
7519
7520
7521
7522
7523
7524
7525
7526
7527
7528
7529
7530
7531
7532
7533
7534
7535
7536
7537
7538
7539
7540
7541
7542
7543
7544
7545
7546
7547
7548
7549
7550
7551
7552
7553
7554
7555
7556
7557
7558
7559
7560
7561
7562
7563
7564
7565
7566
7567
7568
7569
7570
7571
7572
7573
7574
7575
7576
7577
7578
7579
7580
7581
7582
7583
7584
7585
7586
7587
7588
7589
7590
7591
7592
7593
7594
7595
7596
7597
7598
7599
7600
7601
7602
7603
7604
7605
7606
7607
7608
7609
7610
7611
7612
7613
7614
7615
7616
7617
7618
7619
7620
7621
7622
7623
7624
7625
7626
7627
7628
7629
7630
7631
7632
7633
7634
7635
7636
7637
7638
7639
7640
7641
7642
7643
7644
7645
7646
7647
7648
7649
7650
7651
7652
7653
7654
7655
7656
7657
7658
7659
7660
7661
7662
7663
7664
7665
7666
7667
7668
7669
7670
7671
7672
7673
7674
7675
7676
7677
7678
7679
7680
7681
7682
7683
7684
7685
7686
7687
7688
7689
7690
7691
7692
7693
7694
7695
7696
7697
7698
7699
7700
7701
7702
7703
7704
7705
7706
7707
7708
7709
7710
7711
7712
7713
7714
7715
7716
7717
7718
7719
7720
7721
7722
7723
7724
7725
7726
7727
7728
7729
7730
7731
7732
7733
7734
7735
7736
7737
7738
7739
7740
7741
7742
7743
7744
7745
7746
7747
7748
7749
7750
7751
7752
7753
7754
7755
7756
7757
7758
7759
7760
7761
7762
7763
7764
7765
7766
7767
7768
7769
7770
7771
7772
7773
7774
7775
7776
7777
7778
7779
7780
7781
7782
7783
7784
7785
7786
7787
7788
7789
7790
7791
7792
7793
7794
7795
7796
7797
7798
7799
7800
7801
7802
7803
7804
7805
7806
7807
7808
7809
7810
7811
7812
7813
7814
7815
7816
7817
7818
7819
7820
7821
7822
7823
7824
7825
7826
7827
7828
7829
7830
7831
7832
7833
7834
7835
7836
7837
7838
7839
7840
7841
7842
7843
7844
7845
7846
7847
7848
7849
7850
7851
7852
7853
7854
7855
7856
7857
7858
7859
7860
7861
7862
7863
7864
7865
7866
7867
7868
7869
7870
7871
7872
7873
7874
7875
7876
7877
7878
7879
7880
7881
7882
7883
7884
7885
7886
7887
7888
7889
7890
7891
7892
7893
7894
7895
7896
7897
7898
7899
7900
7901
7902
7903
7904
7905
7906
7907
7908
7909
7910
7911
7912
7913
7914
7915
7916
7917
7918
7919
7920
7921
7922
7923
7924
7925
7926
7927
7928
7929
7930
7931
7932
7933
7934
7935
7936
7937
7938
7939
7940
7941
7942
7943
7944
7945
7946
7947
7948
7949
7950
7951
7952
7953
7954
7955
7956
7957
7958
7959
7960
7961
7962
7963
7964
7965
7966
7967
7968
7969
7970
7971
7972
7973
7974
7975
7976
7977
7978
7979
7980
7981
7982
7983
7984
7985
7986
7987
7988
7989
7990
7991
7992
7993
7994
7995
7996
7997
7998
7999
8000
8001
8002
8003
8004
8005
8006
8007
8008
8009
8010
8011
8012
8013
8014
8015
8016
8017
8018
8019
8020
8021
8022
8023
8024
8025
8026
8027
8028
8029
8030
8031
8032
8033
8034
8035
8036
8037
8038
8039
8040
8041
8042
8043
8044
8045
8046
8047
8048
8049
8050
8051
8052
8053
8054
8055
8056
8057
8058
8059
8060
8061
8062
8063
8064
8065
8066
8067
8068
8069
8070
8071
8072
8073
8074
8075
8076
8077
8078
8079
8080
8081
8082
8083
8084
8085
8086
8087
8088
8089
8090
8091
8092
8093
8094
8095
8096
8097
8098
8099
8100
8101
8102
8103
8104
8105
8106
8107
8108
8109
8110
8111
8112
8113
8114
8115
8116
8117
8118
8119
8120
8121
8122
8123
8124
8125
8126
8127
8128
8129
8130
8131
8132
8133
8134
8135
8136
8137
8138
8139
8140
8141
8142
8143
8144
8145
8146
8147
8148
8149
8150
8151
8152
8153
8154
8155
8156
8157
8158
8159
8160
8161
8162
8163
8164
8165
8166
8167
8168
8169
8170
8171
8172
8173
8174
8175
8176
8177
8178
8179
8180
8181
8182
8183
8184
8185
8186
8187
8188
8189
8190
8191
8192
8193
8194
8195
8196
8197
8198
8199
8200
8201
8202
8203
8204
8205
8206
8207
8208
8209
8210
8211
8212
8213
8214
8215
8216
8217
8218
8219
8220
8221
8222
8223
8224
8225
8226
8227
8228
8229
8230
8231
8232
8233
8234
8235
8236
8237
8238
8239
8240
8241
8242
8243
8244
8245
8246
8247
8248
8249
8250
8251
8252
8253
8254
8255
8256
8257
8258
8259
8260
8261
8262
8263
8264
8265
8266
8267
8268
8269
8270
8271
8272
8273
8274
8275
8276
8277
8278
8279
8280
8281
8282
8283
8284
8285
8286
8287
8288
8289
8290
8291
8292
8293
8294
8295
8296
8297
8298
8299
8300
8301
8302
8303
8304
8305
8306
8307
8308
8309
8310
8311
8312
8313
8314
8315
8316
8317
8318
8319
8320
8321
8322
8323
8324
8325
8326
8327
8328
8329
8330
8331
8332
8333
8334
8335
8336
8337
8338
8339
8340
8341
8342
8343
8344
8345
8346
8347
8348
8349
8350
8351
8352
8353
8354
8355
8356
8357
8358
8359
8360
8361
8362
8363
8364
8365
8366
8367
8368
8369
8370
8371
8372
8373
8374
8375
8376
8377
8378
8379
8380
8381
8382
8383
8384
8385
8386
8387
8388
8389
8390
8391
8392
8393
8394
8395
8396
8397
8398
8399
8400
8401
8402
8403
8404
8405
8406
8407
8408
8409
8410
8411
8412
8413
8414
8415
8416
8417
8418
8419
8420
8421
8422
8423
8424
8425
8426
8427
8428
8429
8430
8431
8432
8433
8434
8435
8436
8437
8438
8439
8440
8441
8442
8443
8444
8445
8446
8447
8448
8449
8450
8451
8452
8453
8454
8455
8456
8457
8458
8459
8460
8461
8462
8463
8464
8465
8466
8467
8468
8469
8470
8471
8472
8473
8474
8475
8476
8477
8478
8479
8480
8481
8482
8483
8484
8485
8486
8487
8488
8489
8490
8491
8492
8493
8494
8495
8496
8497
8498
8499
8500
8501
8502
8503
8504
8505
8506
8507
8508
8509
8510
8511
8512
8513
8514
8515
8516
8517
8518
8519
8520
8521
8522
8523
8524
8525
8526
8527
8528
8529
8530
8531
8532
8533
8534
8535
8536
8537
8538
8539
8540
8541
8542
8543
8544
8545
8546
8547
8548
8549
8550
8551
8552
8553
8554
8555
8556
8557
8558
8559
8560
8561
8562
8563
8564
8565
8566
8567
8568
8569
8570
8571
8572
8573
8574
8575
8576
8577
8578
8579
8580
8581
8582
8583
8584
8585
8586
8587
8588
8589
8590
8591
8592
8593
8594
8595
8596
8597
8598
8599
8600
8601
8602
8603
8604
8605
8606
8607
8608
8609
8610
8611
8612
8613
8614
8615
8616
8617
8618
8619
8620
8621
8622
8623
8624
8625
8626
8627
8628
8629
8630
8631
8632
8633
8634
8635
8636
8637
8638
8639
8640
8641
8642
8643
8644
8645
8646
8647
8648
8649
8650
8651
8652
8653
8654
8655
8656
8657
8658
8659
8660
8661
8662
8663
8664
8665
8666
8667
8668
8669
8670
8671
8672
8673
8674
8675
8676
8677
8678
8679
8680
8681
8682
8683
8684
8685
8686
8687
8688
8689
8690
8691
8692
8693
8694
8695
8696
8697
8698
8699
8700
8701
8702
8703
8704
8705
8706
8707
8708
8709
8710
8711
8712
8713
8714
8715
8716
8717
8718
8719
8720
8721
8722
8723
8724
8725
8726
8727
8728
8729
8730
8731
8732
8733
8734
8735
8736
8737
8738
8739
8740
8741
8742
8743
8744
8745
8746
8747
8748
8749
8750
8751
8752
8753
8754
8755
8756
8757
8758
8759
8760
8761
8762
8763
8764
8765
8766
8767
8768
8769
8770
8771
8772
8773
8774
8775
8776
8777
8778
8779
8780
8781
8782
8783
8784
8785
8786
8787
8788
8789
8790
8791
8792
8793
8794
8795
8796
8797
8798
8799
8800
8801
8802
8803
8804
8805
8806
8807
8808
8809
8810
8811
8812
8813
8814
8815
8816
8817
8818
8819
8820
8821
8822
8823
8824
8825
8826
8827
8828
8829
8830
8831
8832
8833
8834
8835
8836
8837
8838
8839
8840
8841
8842
8843
8844
8845
8846
8847
8848
8849
8850
8851
8852
8853
8854
8855
8856
8857
8858
8859
8860
8861
8862
8863
8864
8865
8866
8867
8868
8869
8870
8871
8872
8873
8874
8875
8876
8877
8878
8879
8880
8881
8882
8883
8884
8885
8886
8887
8888
8889
8890
8891
8892
8893
8894
8895
8896
8897
8898
8899
8900
8901
8902
8903
8904
8905
8906
8907
8908
8909
8910
8911
8912
8913
8914
8915
8916
8917
8918
8919
8920
8921
8922
8923
8924
8925
8926
8927
8928
8929
8930
8931
8932
8933
8934
8935
8936
8937
8938
8939
8940
8941
8942
8943
8944
8945
8946
8947
8948
8949
8950
8951
8952
8953
8954
8955
8956
8957
8958
8959
8960
8961
8962
8963
8964
8965
8966
8967
8968
8969
8970
8971
8972
8973
8974
8975
8976
8977
8978
8979
8980
8981
8982
8983
8984
8985
8986
8987
8988
8989
8990
8991
8992
8993
8994
8995
8996
8997
8998
8999
9000
9001
9002
9003
9004
9005
9006
9007
9008
9009
9010
9011
9012
9013
9014
9015
9016
9017
9018
9019
9020
9021
9022
9023
9024
9025
9026
9027
9028
9029
9030
9031
9032
9033
9034
9035
9036
9037
9038
9039
9040
9041
9042
9043
9044
9045
9046
9047
9048
9049
9050
9051
9052
9053
9054
9055
9056
9057
9058
9059
9060
9061
9062
9063
9064
9065
9066
9067
9068
9069
9070
9071
9072
9073
9074
9075
9076
9077
9078
9079
9080
9081
9082
9083
9084
9085
9086
9087
9088
9089
9090
9091
9092
9093
9094
9095
9096
9097
9098
9099
9100
9101
9102
9103
9104
9105
9106
9107
9108
9109
9110
9111
9112
9113
9114
9115
9116
9117
9118
9119
9120
9121
9122
9123
9124
9125
9126
9127
9128
9129
9130
9131
9132
9133
9134
9135
9136
9137
9138
9139
9140
9141
9142
9143
9144
9145
9146
9147
9148
9149
9150
9151
9152
9153
9154
9155
9156
9157
9158
9159
9160
9161
9162
9163
9164
9165
9166
9167
9168
9169
9170
9171
9172
9173
9174
9175
9176
9177
9178
9179
9180
9181
9182
9183
9184
9185
9186
9187
9188
9189
9190
9191
9192
9193
9194
9195
9196
9197
9198
9199
9200
9201
9202
9203
9204
9205
9206
9207
9208
9209
9210
9211
9212
9213
9214
9215
9216
9217
9218
9219
9220
9221
9222
9223
9224
9225
9226
9227
9228
9229
9230
9231
9232
9233
9234
9235
9236
9237
9238
9239
9240
9241
9242
9243
9244
9245
9246
9247
9248
9249
9250
9251
9252
9253
9254
9255
9256
9257
9258
9259
9260
9261
9262
9263
9264
9265
9266
9267
9268
9269
9270
9271
9272
9273
9274
9275
9276
9277
9278
9279
9280
9281
9282
9283
9284
9285
9286
9287
9288
9289
9290
9291
9292
9293
9294
9295
9296
9297
9298
9299
9300
9301
9302
9303
9304
9305
9306
9307
9308
9309
9310
9311
9312
9313
9314
9315
9316
9317
9318
9319
9320
9321
9322
9323
9324
9325
9326
9327
9328
9329
9330
9331
9332
9333
9334
9335
9336
9337
9338
9339
9340
9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
9376
9377
9378
9379
9380
9381
9382
9383
9384
9385
9386
9387
9388
9389
9390
9391
9392
9393
9394
9395
9396
9397
9398
9399
9400
9401
9402
9403
9404
9405
9406
9407
9408
9409
9410
9411
9412
9413
9414
9415
9416
9417
9418
9419
9420
9421
9422
9423
9424
9425
9426
9427
9428
9429
9430
9431
9432
9433
9434
9435
9436
9437
9438
9439
9440
9441
9442
9443
9444
9445
9446
9447
9448
9449
9450
9451
9452
9453
9454
9455
9456
9457
9458
9459
9460
9461
9462
9463
9464
9465
9466
9467
9468
9469
9470
9471
9472
9473
9474
9475
9476
9477
9478
9479
9480
9481
9482
9483
9484
9485
9486
9487
9488
9489
9490
9491
9492
9493
9494
9495
9496
9497
9498
9499
9500
9501
9502
9503
9504
9505
9506
9507
9508
9509
9510
9511
9512
9513
9514
9515
9516
9517
9518
9519
9520
9521
9522
9523
9524
9525
9526
9527
9528
9529
9530
9531
9532
9533
9534
9535
9536
9537
9538
9539
9540
9541
9542
9543
9544
9545
9546
9547
9548
9549
9550
9551
9552
9553
9554
9555
9556
9557
9558
9559
9560
9561
9562
9563
9564
9565
9566
9567
9568
9569
9570
9571
9572
9573
9574
9575
9576
9577
9578
9579
9580
9581
9582
9583
9584
9585
9586
9587
9588
9589
9590
9591
9592
9593
9594
9595
9596
9597
9598
9599
9600
9601
9602
9603
9604
9605
9606
9607
9608
9609
9610
9611
9612
9613
9614
9615
9616
9617
9618
9619
9620
9621
9622
9623
9624
9625
9626
9627
9628
9629
9630
9631
9632
9633
9634
9635
9636
9637
9638
9639
9640
9641
9642
9643
9644
9645
9646
9647
9648
9649
9650
9651
9652
9653
9654
9655
9656
9657
9658
9659
9660
9661
9662
9663
9664
9665
9666
9667
9668
9669
9670
9671
9672
9673
9674
9675
9676
9677
9678
9679
9680
9681
9682
9683
9684
9685
9686
9687
9688
9689
9690
9691
9692
9693
9694
9695
9696
9697
9698
9699
9700
9701
9702
9703
9704
9705
9706
9707
9708
9709
9710
9711
9712
9713
9714
9715
9716
9717
9718
9719
9720
9721
9722
9723
9724
9725
9726
9727
9728
9729
9730
9731
9732
9733
9734
9735
9736
9737
9738
9739
9740
9741
9742
9743
9744
9745
9746
9747
9748
9749
9750
9751
9752
9753
9754
9755
9756
9757
9758
9759
9760
9761
9762
9763
9764
9765
9766
9767
9768
9769
9770
9771
9772
9773
9774
9775
9776
9777
9778
9779
9780
9781
9782
9783
9784
9785
9786
9787
9788
9789
9790
9791
9792
9793
9794
9795
9796
9797
9798
9799
9800
9801
9802
9803
9804
9805
9806
9807
9808
9809
9810
9811
9812
9813
9814
9815
9816
9817
9818
9819
9820
9821
9822
9823
9824
9825
9826
9827
9828
9829
9830
9831
9832
9833
9834
9835
9836
9837
9838
9839
9840
9841
9842
9843
9844
9845
9846
9847
9848
9849
9850
9851
9852
9853
9854
9855
9856
9857
9858
9859
9860
9861
9862
9863
9864
9865
9866
9867
9868
9869
9870
9871
9872
9873
9874
9875
9876
9877
9878
9879
9880
9881
9882
9883
9884
9885
9886
9887
9888
9889
9890
9891
9892
9893
9894
9895
9896
9897
9898
9899
9900
9901
9902
9903
9904
9905
9906
9907
9908
9909
9910
9911
9912
9913
9914
9915
9916
9917
9918
9919
9920
9921
9922
9923
9924
9925
9926
9927
9928
9929
9930
9931
9932
9933
9934
9935
9936
9937
9938
9939
9940
9941
9942
9943
9944
9945
9946
9947
9948
9949
9950
9951
9952
9953
9954
9955
9956
9957
9958
9959
9960
9961
9962
9963
9964
9965
9966
9967
9968
9969
9970
9971
9972
9973
9974
9975
9976
9977
9978
9979
9980
9981
9982
9983
9984
9985
9986
9987
9988
9989
9990
9991
9992
9993
9994
9995
9996
9997
9998
9999
10000
10001
10002
10003
10004
10005
10006
10007
10008
10009
10010
10011
10012
10013
10014
10015
10016
10017
10018
10019
10020
10021
10022
10023
10024
10025
10026
10027
10028
10029
10030
10031
10032
10033
10034
10035
10036
10037
10038
10039
10040
10041
10042
10043
10044
10045
10046
10047
10048
10049
10050
10051
10052
10053
10054
10055
10056
10057
10058
10059
10060
10061
10062
10063
10064
10065
10066
10067
10068
10069
10070
10071
10072
10073
10074
10075
10076
10077
10078
10079
10080
10081
10082
10083
10084
10085
10086
10087
10088
10089
10090
10091
10092
10093
10094
10095
10096
10097
10098
10099
10100
10101
10102
10103
10104
10105
10106
10107
10108
10109
10110
10111
10112
10113
10114
10115
10116
10117
10118
10119
10120
10121
10122
10123
10124
10125
10126
10127
10128
10129
10130
10131
10132
10133
10134
10135
10136
10137
10138
10139
10140
10141
10142
10143
10144
10145
10146
10147
10148
10149
10150
10151
10152
10153
10154
10155
10156
10157
10158
10159
10160
10161
10162
10163
10164
10165
10166
10167
10168
10169
10170
10171
10172
10173
10174
10175
10176
10177
10178
10179
10180
10181
10182
10183
10184
10185
10186
10187
10188
10189
10190
10191
10192
10193
10194
10195
10196
10197
10198
10199
10200
10201
10202
10203
10204
10205
10206
10207
10208
10209
10210
10211
10212
10213
10214
10215
10216
10217
10218
10219
10220
10221
10222
10223
10224
10225
10226
10227
10228
10229
10230
10231
10232
10233
10234
10235
10236
10237
10238
10239
10240
10241
10242
10243
10244
10245
10246
10247
10248
10249
10250
10251
10252
10253
10254
10255
10256
10257
10258
10259
10260
10261
10262
10263
10264
10265
10266
10267
10268
10269
10270
10271
10272
10273
10274
10275
10276
10277
10278
10279
10280
10281
10282
10283
10284
10285
10286
10287
10288
10289
10290
10291
10292
10293
10294
10295
10296
10297
10298
10299
10300
10301
10302
10303
10304
10305
10306
10307
10308
10309
10310
10311
10312
10313
10314
10315
10316
10317
10318
10319
10320
10321
10322
10323
10324
10325
10326
10327
10328
10329
10330
10331
10332
10333
10334
10335
10336
10337
10338
10339
10340
10341
10342
10343
10344
10345
10346
10347
10348
10349
10350
10351
10352
10353
10354
10355
10356
10357
10358
10359
10360
10361
10362
10363
10364
10365
10366
10367
10368
10369
10370
10371
10372
10373
10374
10375
10376
10377
10378
10379
10380
10381
10382
10383
10384
10385
10386
10387
10388
10389
10390
10391
10392
10393
10394
10395
10396
10397
10398
10399
10400
10401
10402
10403
10404
10405
10406
10407
10408
10409
10410
10411
10412
10413
10414
10415
10416
10417
10418
10419
10420
10421
10422
10423
10424
10425
10426
10427
10428
10429
10430
10431
10432
10433
10434
10435
10436
10437
10438
10439
10440
10441
10442
10443
10444
10445
10446
10447
10448
10449
10450
10451
10452
10453
10454
10455
10456
10457
10458
10459
10460
10461
10462
10463
10464
10465
10466
10467
10468
10469
10470
10471
10472
10473
10474
10475
10476
10477
10478
10479
10480
10481
10482
10483
10484
10485
10486
10487
10488
10489
10490
10491
10492
10493
10494
10495
10496
10497
10498
10499
10500
10501
10502
10503
10504
10505
10506
10507
10508
10509
10510
10511
10512
10513
10514
10515
10516
10517
10518
10519
10520
10521
10522
10523
10524
10525
10526
10527
10528
10529
10530
10531
10532
10533
10534
10535
10536
10537
10538
10539
10540
10541
10542
10543
10544
10545
10546
10547
10548
10549
10550
10551
10552
10553
10554
10555
10556
10557
10558
10559
10560
10561
10562
10563
10564
10565
10566
10567
10568
10569
10570
10571
10572
10573
10574
10575
10576
10577
10578
10579
10580
10581
10582
10583
10584
10585
10586
10587
10588
10589
10590
10591
10592
10593
10594
10595
10596
10597
10598
10599
10600
10601
10602
10603
10604
10605
10606
10607
10608
10609
10610
10611
10612
10613
10614
10615
10616
10617
10618
10619
10620
10621
10622
10623
10624
10625
10626
10627
10628
10629
10630
10631
10632
10633
10634
10635
10636
10637
10638
10639
10640
10641
10642
10643
10644
10645
10646
10647
10648
10649
10650
10651
10652
10653
10654
10655
10656
10657
10658
10659
10660
10661
10662
10663
10664
10665
10666
10667
10668
10669
10670
10671
10672
10673
10674
10675
10676
10677
10678
10679
10680
10681
10682
10683
10684
10685
10686
10687
10688
10689
10690
10691
10692
10693
10694
10695
10696
10697
10698
10699
10700
10701
10702
10703
10704
10705
10706
10707
10708
10709
10710
10711
10712
10713
10714
10715
10716
10717
10718
10719
10720
10721
10722
10723
10724
10725
10726
10727
10728
10729
10730
10731
10732
10733
10734
10735
10736
10737
10738
10739
10740
10741
10742
10743
10744
10745
10746
10747
10748
10749
10750
10751
10752
10753
10754
10755
10756
10757
10758
10759
10760
10761
10762
10763
10764
10765
10766
10767
10768
10769
10770
10771
10772
10773
10774
10775
10776
10777
10778
10779
10780
10781
10782
10783
10784
10785
10786
10787
10788
10789
10790
10791
10792
10793
10794
10795
10796
10797
10798
10799
10800
10801
10802
10803
10804
10805
10806
10807
10808
10809
10810
10811
10812
10813
10814
10815
10816
10817
10818
10819
10820
10821
10822
10823
10824
10825
10826
10827
10828
10829
10830
10831
10832
10833
10834
10835
10836
10837
10838
10839
10840
10841
10842
10843
10844
10845
10846
10847
10848
10849
10850
10851
10852
10853
10854
10855
10856
10857
10858
10859
10860
10861
10862
10863
10864
10865
10866
10867
10868
10869
10870
10871
10872
10873
10874
10875
10876
10877
10878
10879
10880
10881
10882
10883
10884
10885
10886
10887
10888
10889
10890
10891
10892
10893
10894
10895
10896
10897
10898
10899
10900
10901
10902
10903
10904
10905
10906
10907
10908
10909
10910
10911
10912
10913
10914
10915
10916
10917
10918
10919
10920
10921
10922
10923
10924
10925
10926
10927
10928
10929
10930
10931
10932
10933
10934
10935
10936
10937
10938
10939
10940
10941
10942
10943
10944
10945
10946
10947
10948
10949
10950
10951
10952
10953
10954
10955
10956
10957
10958
10959
10960
10961
10962
10963
10964
10965
10966
10967
10968
10969
10970
10971
10972
10973
10974
10975
10976
10977
10978
10979
10980
10981
10982
10983
10984
10985
10986
10987
10988
10989
10990
10991
10992
10993
10994
10995
10996
10997
10998
10999
11000
11001
11002
11003
11004
11005
11006
11007
11008
11009
11010
11011
11012
11013
11014
11015
11016
11017
11018
11019
11020
11021
11022
11023
11024
11025
11026
11027
11028
11029
11030
11031
11032
11033
11034
11035
11036
11037
11038
11039
11040
11041
11042
11043
11044
11045
11046
11047
11048
11049
11050
11051
11052
11053
11054
11055
11056
11057
11058
11059
11060
11061
11062
11063
11064
11065
11066
11067
11068
11069
11070
11071
11072
11073
11074
11075
11076
11077
11078
11079
11080
11081
11082
11083
11084
11085
11086
11087
11088
11089
11090
11091
11092
11093
11094
11095
11096
11097
11098
11099
11100
11101
11102
11103
11104
11105
11106
11107
11108
11109
11110
11111
11112
11113
11114
11115
11116
11117
11118
11119
11120
11121
11122
11123
11124
11125
11126
11127
11128
11129
11130
11131
11132
11133
11134
11135
11136
11137
11138
11139
11140
11141
11142
11143
11144
11145
11146
11147
11148
11149
11150
11151
11152
11153
11154
11155
11156
11157
11158
11159
11160
11161
11162
11163
11164
11165
11166
11167
11168
11169
11170
11171
11172
11173
11174
11175
11176
11177
11178
11179
11180
11181
11182
11183
11184
11185
11186
11187
11188
11189
11190
11191
11192
11193
11194
11195
11196
11197
11198
11199
11200
11201
11202
11203
11204
11205
11206
11207
11208
11209
11210
11211
11212
11213
11214
11215
11216
11217
11218
11219
11220
11221
11222
11223
11224
11225
11226
11227
11228
11229
11230
11231
11232
11233
11234
11235
11236
11237
11238
11239
11240
11241
11242
11243
11244
11245
11246
11247
11248
11249
11250
11251
11252
11253
11254
11255
11256
11257
11258
11259
11260
11261
11262
11263
11264
11265
11266
11267
11268
11269
11270
11271
11272
11273
11274
11275
11276
11277
11278
11279
11280
11281
11282
11283
11284
11285
11286
11287
11288
11289
11290
11291
11292
11293
11294
11295
11296
11297
11298
11299
11300
11301
11302
11303
11304
11305
11306
11307
11308
11309
11310
11311
11312
11313
11314
11315
11316
11317
11318
11319
11320
11321
11322
11323
11324
11325
11326
11327
11328
11329
11330
11331
11332
11333
11334
11335
11336
11337
11338
11339
11340
11341
11342
11343
11344
11345
11346
11347
11348
11349
11350
11351
11352
11353
11354
11355
11356
11357
11358
11359
11360
11361
11362
11363
11364
11365
11366
11367
11368
11369
11370
11371
11372
11373
11374
11375
11376
11377
11378
11379
11380
11381
11382
11383
11384
11385
11386
11387
11388
11389
11390
11391
11392
11393
11394
11395
11396
11397
11398
11399
11400
11401
11402
11403
11404
11405
11406
11407
11408
11409
11410
11411
11412
11413
11414
11415
11416
11417
11418
11419
11420
11421
11422
11423
11424
11425
11426
11427
11428
11429
11430
11431
11432
11433
11434
11435
11436
11437
11438
11439
11440
11441
11442
11443
11444
11445
11446
11447
11448
11449
11450
11451
11452
11453
11454
11455
11456
11457
11458
11459
11460
11461
11462
11463
11464
11465
11466
11467
11468
11469
11470
11471
11472
11473
11474
11475
11476
11477
11478
11479
11480
11481
11482
11483
11484
11485
11486
11487
11488
11489
11490
11491
11492
11493
11494
11495
11496
11497
11498
11499
11500
11501
11502
11503
11504
11505
11506
11507
11508
11509
11510
11511
11512
11513
11514
11515
11516
11517
11518
11519
11520
11521
11522
11523
11524
11525
11526
11527
11528
11529
11530
11531
11532
11533
11534
11535
11536
11537
11538
11539
11540
11541
11542
11543
11544
11545
11546
11547
11548
11549
11550
11551
11552
11553
11554
11555
11556
11557
11558
11559
11560
11561
11562
11563
11564
11565
11566
11567
11568
11569
11570
11571
11572
11573
11574
11575
11576
11577
11578
11579
11580
11581
11582
11583
11584
11585
11586
11587
11588
11589
11590
11591
11592
11593
11594
11595
11596
11597
11598
11599
11600
11601
11602
11603
11604
11605
11606
11607
11608
11609
11610
11611
11612
11613
11614
11615
11616
11617
11618
11619
11620
11621
11622
11623
11624
11625
11626
11627
11628
11629
11630
11631
11632
11633
11634
11635
11636
11637
11638
11639
11640
11641
11642
11643
11644
11645
11646
11647
11648
11649
11650
11651
11652
11653
11654
11655
11656
11657
11658
11659
11660
11661
11662
11663
11664
11665
11666
11667
11668
11669
11670
11671
11672
11673
11674
11675
11676
11677
11678
11679
11680
11681
11682
11683
11684
11685
11686
11687
11688
11689
11690
11691
11692
11693
11694
11695
11696
11697
11698
11699
11700
11701
11702
11703
11704
11705
11706
11707
11708
11709
11710
11711
11712
11713
11714
11715
11716
11717
11718
11719
11720
11721
11722
11723
11724
11725
11726
11727
11728
11729
11730
11731
11732
11733
11734
11735
11736
11737
11738
11739
11740
11741
11742
11743
11744
11745
11746
11747
11748
11749
11750
11751
11752
11753
11754
11755
11756
11757
11758
11759
11760
11761
11762
11763
11764
11765
11766
11767
11768
11769
11770
11771
11772
11773
11774
11775
11776
11777
11778
11779
11780
11781
11782
11783
11784
11785
11786
11787
11788
11789
11790
11791
11792
11793
11794
11795
11796
11797
11798
11799
11800
11801
11802
11803
11804
11805
11806
11807
11808
11809
11810
11811
11812
11813
11814
11815
11816
11817
11818
11819
11820
11821
11822
11823
11824
11825
11826
11827
11828
11829
11830
11831
11832
11833
11834
11835
11836
11837
11838
11839
11840
11841
11842
11843
11844
11845
11846
11847
11848
11849
11850
11851
11852
11853
11854
11855
11856
11857
11858
11859
11860
11861
11862
11863
11864
11865
11866
11867
11868
11869
11870
11871
11872
11873
11874
11875
11876
11877
11878
11879
11880
11881
11882
11883
11884
11885
11886
11887
11888
11889
11890
11891
11892
11893
11894
11895
11896
11897
11898
11899
11900
11901
11902
11903
11904
11905
11906
11907
11908
11909
11910
11911
11912
11913
11914
11915
11916
11917
11918
11919
11920
11921
11922
11923
11924
11925
11926
11927
11928
11929
11930
11931
11932
11933
11934
11935
11936
11937
11938
11939
11940
11941
11942
11943
11944
11945
11946
11947
11948
11949
11950
11951
11952
11953
11954
11955
11956
11957
11958
11959
11960
11961
11962
11963
11964
11965
11966
11967
11968
11969
11970
11971
11972
11973
11974
11975
11976
11977
11978
11979
11980
11981
11982
11983
11984
11985
11986
11987
11988
11989
11990
11991
11992
11993
11994
11995
11996
11997
11998
11999
12000
12001
12002
12003
12004
12005
12006
12007
12008
12009
12010
12011
12012
12013
12014
12015
12016
12017
12018
12019
12020
12021
12022
12023
12024
12025
12026
12027
12028
12029
12030
12031
12032
12033
12034
12035
12036
12037
12038
12039
12040
12041
12042
12043
12044
12045
12046
12047
12048
12049
12050
12051
12052
12053
12054
12055
12056
12057
12058
12059
12060
12061
12062
12063
12064
12065
12066
12067
12068
12069
12070
12071
12072
12073
12074
12075
12076
12077
12078
12079
12080
12081
12082
12083
12084
12085
12086
12087
12088
12089
12090
12091
12092
12093
12094
12095
12096
12097
12098
12099
12100
12101
12102
12103
12104
12105
12106
12107
12108
12109
12110
12111
12112
12113
12114
12115
12116
12117
12118
12119
12120
12121
12122
12123
12124
12125
12126
12127
12128
12129
12130
12131
12132
12133
12134
12135
12136
12137
12138
12139
12140
12141
12142
12143
12144
12145
12146
12147
12148
12149
12150
12151
12152
12153
12154
12155
12156
12157
12158
12159
12160
12161
12162
12163
12164
12165
12166
12167
12168
12169
12170
12171
12172
12173
12174
12175
12176
12177
12178
12179
12180
12181
12182
12183
12184
12185
12186
12187
12188
12189
12190
12191
12192
12193
12194
12195
12196
12197
12198
12199
12200
12201
12202
12203
12204
12205
12206
12207
12208
12209
12210
12211
12212
12213
12214
12215
12216
12217
12218
12219
12220
12221
12222
12223
12224
12225
12226
12227
12228
12229
12230
12231
12232
12233
12234
12235
12236
12237
12238
12239
12240
12241
12242
12243
12244
12245
12246
12247
12248
12249
12250
12251
12252
12253
12254
12255
12256
12257
12258
12259
12260
12261
12262
12263
12264
12265
12266
12267
12268
12269
12270
12271
12272
12273
12274
12275
12276
12277
12278
12279
12280
12281
12282
12283
12284
12285
12286
12287
12288
12289
12290
12291
12292
12293
12294
12295
12296
12297
12298
12299
12300
12301
12302
12303
12304
12305
12306
12307
12308
12309
12310
12311
12312
12313
12314
12315
12316
12317
12318
12319
12320
12321
12322
12323
12324
12325
12326
12327
12328
12329
12330
12331
12332
12333
12334
12335
12336
12337
12338
12339
12340
12341
12342
12343
12344
12345
12346
12347
12348
12349
12350
12351
12352
12353
12354
12355
12356
12357
12358
12359
12360
12361
12362
12363
12364
12365
12366
12367
12368
12369
12370
12371
12372
12373
12374
12375
12376
12377
12378
12379
12380
12381
12382
12383
12384
12385
12386
12387
12388
12389
12390
12391
12392
12393
12394
12395
12396
12397
12398
12399
12400
12401
12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
12414
12415
12416
12417
12418
12419
12420
12421
12422
12423
12424
12425
12426
12427
12428
12429
12430
12431
12432
12433
12434
12435
12436
12437
12438
12439
12440
12441
12442
12443
12444
12445
12446
12447
12448
12449
12450
12451
12452
12453
12454
12455
12456
12457
12458
12459
12460
12461
12462
12463
12464
12465
12466
12467
12468
12469
12470
12471
12472
12473
12474
12475
12476
12477
12478
12479
12480
12481
12482
12483
12484
12485
12486
12487
12488
12489
12490
12491
12492
12493
12494
12495
12496
12497
12498
12499
12500
12501
12502
12503
12504
12505
12506
12507
12508
12509
12510
12511
12512
12513
12514
12515
12516
12517
12518
12519
12520
12521
12522
12523
12524
12525
12526
12527
12528
12529
12530
12531
12532
12533
12534
12535
12536
12537
12538
12539
12540
12541
12542
12543
12544
12545
12546
12547
12548
12549
12550
12551
12552
12553
12554
12555
12556
12557
12558
12559
12560
12561
12562
12563
12564
12565
12566
12567
12568
12569
12570
12571
12572
12573
12574
12575
12576
12577
12578
12579
12580
12581
12582
12583
12584
12585
12586
12587
12588
12589
12590
12591
12592
12593
12594
12595
12596
12597
12598
12599
12600
12601
12602
12603
12604
12605
12606
12607
12608
12609
12610
12611
12612
12613
12614
12615
12616
12617
12618
12619
12620
12621
12622
12623
12624
12625
12626
12627
12628
12629
12630
12631
12632
12633
12634
12635
12636
12637
12638
12639
12640
12641
12642
12643
12644
12645
12646
12647
12648
12649
12650
12651
12652
12653
12654
12655
12656
12657
12658
12659
12660
12661
12662
12663
12664
12665
12666
12667
12668
12669
12670
12671
12672
12673
12674
12675
12676
12677
12678
12679
12680
12681
12682
12683
12684
12685
12686
12687
12688
12689
12690
12691
12692
12693
12694
12695
12696
12697
12698
12699
12700
12701
12702
12703
12704
12705
12706
12707
12708
12709
12710
12711
12712
12713
12714
12715
12716
12717
12718
12719
12720
12721
12722
12723
12724
12725
12726
12727
12728
12729
12730
12731
12732
12733
12734
12735
12736
12737
12738
12739
12740
12741
12742
12743
12744
12745
12746
12747
12748
12749
12750
12751
12752
12753
12754
12755
12756
12757
12758
12759
12760
12761
12762
12763
12764
12765
12766
12767
12768
12769
12770
12771
12772
12773
12774
12775
12776
12777
12778
12779
12780
12781
12782
12783
12784
12785
12786
12787
12788
12789
12790
12791
12792
12793
12794
12795
12796
12797
12798
12799
12800
12801
12802
12803
12804
12805
12806
12807
12808
12809
12810
12811
12812
12813
12814
12815
12816
12817
12818
12819
12820
12821
12822
12823
12824
12825
12826
12827
12828
12829
12830
12831
12832
12833
12834
12835
12836
12837
12838
12839
12840
12841
12842
12843
12844
12845
12846
12847
12848
12849
12850
12851
12852
12853
12854
12855
12856
12857
12858
12859
12860
12861
12862
12863
12864
12865
12866
12867
12868
12869
12870
12871
12872
12873
12874
12875
12876
12877
12878
12879
12880
12881
12882
12883
12884
12885
12886
12887
12888
12889
12890
12891
12892
12893
12894
12895
12896
12897
12898
12899
12900
12901
12902
12903
12904
12905
12906
12907
12908
12909
12910
12911
12912
12913
12914
12915
12916
12917
12918
12919
12920
12921
12922
12923
12924
12925
12926
12927
12928
12929
12930
12931
12932
12933
12934
12935
12936
12937
12938
12939
12940
12941
12942
12943
12944
12945
12946
12947
12948
12949
12950
12951
12952
12953
12954
12955
12956
12957
12958
12959
12960
12961
12962
12963
12964
12965
12966
12967
12968
12969
12970
12971
12972
12973
12974
12975
12976
12977
12978
12979
12980
12981
12982
12983
12984
12985
12986
12987
12988
12989
12990
12991
12992
12993
12994
12995
12996
12997
12998
12999
13000
13001
13002
13003
13004
13005
13006
13007
13008
13009
13010
13011
13012
13013
13014
13015
13016
13017
13018
13019
13020
13021
13022
13023
13024
13025
13026
13027
13028
13029
13030
13031
13032
13033
13034
13035
13036
13037
13038
13039
13040
13041
13042
13043
13044
13045
13046
13047
13048
13049
13050
13051
13052
13053
13054
13055
13056
13057
13058
13059
13060
13061
13062
13063
13064
13065
13066
13067
13068
13069
13070
13071
13072
13073
13074
13075
13076
13077
13078
13079
13080
13081
13082
13083
13084
13085
13086
13087
13088
13089
13090
13091
13092
13093
13094
13095
13096
13097
13098
13099
13100
13101
13102
13103
13104
13105
13106
13107
13108
13109
13110
13111
13112
13113
13114
13115
13116
13117
13118
13119
13120
13121
13122
13123
13124
13125
13126
13127
13128
13129
13130
13131
13132
13133
13134
13135
13136
13137
13138
13139
13140
13141
13142
13143
13144
13145
13146
13147
13148
13149
13150
13151
13152
13153
13154
13155
13156
13157
13158
13159
13160
13161
13162
13163
13164
13165
13166
13167
13168
13169
13170
13171
13172
13173
13174
13175
13176
13177
13178
13179
13180
13181
13182
13183
13184
13185
13186
13187
13188
13189
13190
13191
13192
13193
13194
13195
13196
13197
13198
13199
13200
13201
13202
13203
13204
13205
13206
13207
13208
13209
13210
13211
13212
13213
13214
13215
13216
13217
13218
13219
13220
13221
13222
13223
13224
13225
13226
13227
13228
13229
13230
13231
13232
13233
13234
13235
13236
13237
13238
13239
13240
13241
13242
13243
13244
13245
13246
13247
13248
13249
13250
13251
13252
13253
13254
13255
13256
13257
13258
13259
13260
13261
13262
13263
13264
13265
13266
13267
13268
13269
13270
13271
13272
13273
13274
13275
13276
13277
13278
13279
13280
13281
13282
13283
13284
13285
13286
13287
13288
13289
13290
13291
13292
13293
13294
13295
13296
13297
13298
13299
13300
13301
13302
13303
13304
13305
13306
13307
13308
13309
13310
13311
13312
13313
13314
13315
13316
13317
13318
13319
13320
13321
13322
13323
13324
13325
13326
13327
13328
13329
13330
13331
13332
13333
13334
13335
13336
13337
13338
13339
13340
13341
13342
13343
13344
13345
13346
13347
13348
13349
13350
13351
13352
13353
13354
13355
13356
13357
13358
13359
13360
13361
13362
13363
13364
13365
13366
13367
13368
13369
13370
13371
13372
13373
13374
13375
13376
13377
13378
13379
13380
13381
13382
13383
13384
13385
13386
13387
13388
13389
13390
13391
13392
13393
13394
13395
13396
13397
13398
13399
13400
13401
13402
13403
13404
13405
13406
13407
13408
13409
13410
13411
13412
13413
13414
13415
13416
13417
13418
13419
13420
13421
13422
13423
13424
13425
13426
13427
13428
13429
13430
13431
13432
13433
13434
13435
13436
13437
13438
13439
13440
13441
13442
13443
13444
13445
13446
13447
13448
13449
13450
13451
13452
13453
13454
13455
13456
13457
13458
13459
13460
13461
13462
13463
13464
13465
13466
13467
13468
13469
13470
13471
13472
13473
13474
13475
13476
13477
13478
13479
13480
13481
13482
13483
13484
13485
13486
13487
13488
13489
13490
13491
13492
13493
13494
13495
13496
13497
13498
13499
13500
13501
13502
13503
13504
13505
13506
13507
13508
13509
13510
13511
13512
13513
13514
13515
13516
13517
13518
13519
13520
13521
13522
13523
13524
13525
13526
13527
13528
13529
13530
13531
13532
13533
13534
13535
13536
13537
13538
13539
13540
13541
13542
13543
13544
13545
13546
13547
13548
13549
13550
13551
13552
13553
13554
13555
13556
13557
13558
13559
13560
13561
13562
13563
13564
13565
13566
13567
13568
13569
13570
13571
13572
13573
13574
13575
13576
13577
13578
13579
13580
13581
13582
13583
13584
13585
13586
13587
13588
13589
13590
13591
13592
13593
13594
13595
13596
13597
13598
13599
13600
13601
13602
13603
13604
13605
13606
13607
13608
13609
13610
13611
13612
13613
13614
13615
13616
13617
13618
13619
13620
13621
13622
13623
13624
13625
13626
13627
13628
13629
13630
13631
13632
13633
13634
13635
13636
13637
13638
13639
13640
13641
13642
13643
13644
13645
13646
13647
13648
13649
13650
13651
13652
13653
13654
13655
13656
13657
13658
13659
13660
13661
13662
13663
13664
13665
13666
13667
13668
13669
13670
13671
13672
13673
13674
13675
13676
13677
13678
13679
13680
13681
13682
13683
13684
13685
13686
13687
13688
13689
13690
13691
13692
13693
13694
13695
13696
13697
13698
13699
13700
13701
13702
13703
13704
13705
13706
13707
13708
13709
13710
13711
13712
13713
13714
13715
13716
13717
13718
13719
13720
13721
13722
13723
13724
13725
13726
13727
13728
13729
13730
13731
13732
13733
13734
13735
13736
13737
13738
13739
13740
13741
13742
13743
13744
13745
13746
13747
13748
13749
13750
13751
13752
13753
13754
13755
13756
13757
13758
13759
13760
13761
13762
13763
13764
13765
13766
13767
13768
13769
13770
13771
13772
13773
13774
13775
13776
13777
13778
13779
13780
13781
13782
13783
13784
13785
13786
13787
13788
13789
13790
13791
13792
13793
13794
13795
13796
13797
13798
13799
13800
13801
13802
13803
13804
13805
13806
13807
13808
13809
13810
13811
13812
13813
13814
13815
13816
13817
13818
13819
13820
13821
13822
13823
13824
13825
13826
13827
13828
13829
13830
13831
13832
13833
13834
13835
13836
13837
13838
13839
13840
13841
13842
13843
13844
13845
13846
13847
13848
13849
13850
13851
13852
13853
13854
13855
13856
13857
13858
13859
13860
13861
13862
13863
13864
13865
13866
13867
13868
13869
13870
13871
13872
13873
13874
13875
13876
13877
13878
13879
13880
13881
13882
13883
13884
13885
13886
13887
13888
13889
13890
13891
13892
13893
13894
13895
13896
13897
13898
13899
13900
13901
13902
13903
13904
13905
13906
13907
13908
13909
13910
13911
13912
13913
13914
13915
13916
13917
13918
13919
13920
13921
13922
13923
13924
13925
13926
13927
13928
13929
13930
13931
13932
13933
13934
13935
13936
13937
13938
13939
13940
13941
13942
13943
13944
13945
13946
13947
13948
13949
13950
13951
13952
13953
13954
13955
13956
13957
13958
13959
13960
13961
13962
13963
13964
13965
13966
13967
13968
13969
13970
13971
13972
13973
13974
13975
13976
13977
13978
13979
13980
13981
13982
13983
13984
13985
13986
13987
13988
13989
13990
13991
13992
13993
13994
13995
13996
13997
13998
13999
14000
14001
14002
14003
14004
14005
14006
14007
14008
14009
14010
14011
14012
14013
14014
14015
14016
14017
14018
14019
14020
14021
14022
14023
14024
14025
14026
14027
14028
14029
14030
14031
14032
14033
14034
14035
14036
14037
14038
14039
14040
14041
14042
14043
14044
14045
14046
14047
14048
14049
14050
14051
14052
14053
14054
14055
14056
14057
14058
14059
14060
14061
14062
14063
14064
14065
14066
14067
14068
14069
14070
14071
14072
14073
14074
14075
14076
14077
14078
14079
14080
14081
14082
14083
14084
14085
14086
14087
14088
14089
14090
14091
14092
14093
14094
14095
14096
14097
14098
14099
14100
14101
14102
14103
14104
14105
14106
14107
14108
14109
14110
14111
14112
14113
14114
14115
14116
14117
14118
14119
14120
14121
14122
14123
14124
14125
14126
14127
14128
14129
14130
14131
14132
14133
14134
14135
14136
14137
14138
14139
14140
14141
14142
14143
14144
14145
14146
14147
14148
14149
14150
14151
14152
14153
14154
14155
14156
14157
14158
14159
14160
14161
14162
14163
14164
14165
14166
14167
14168
14169
14170
14171
14172
14173
14174
14175
14176
14177
14178
14179
14180
14181
14182
14183
14184
14185
14186
14187
14188
14189
14190
14191
14192
14193
14194
14195
14196
14197
14198
14199
14200
14201
14202
14203
14204
14205
14206
14207
14208
14209
14210
14211
14212
14213
14214
14215
14216
14217
14218
14219
14220
14221
14222
14223
14224
14225
14226
14227
14228
14229
14230
14231
14232
14233
14234
14235
14236
14237
14238
14239
14240
14241
14242
14243
14244
14245
14246
14247
14248
14249
14250
14251
14252
14253
14254
14255
14256
14257
14258
14259
14260
14261
14262
14263
14264
14265
14266
14267
14268
14269
14270
14271
14272
14273
14274
14275
14276
14277
14278
14279
14280
14281
14282
14283
14284
14285
14286
14287
14288
14289
14290
14291
14292
14293
14294
14295
14296
14297
14298
14299
14300
14301
14302
14303
14304
14305
14306
14307
14308
14309
14310
14311
14312
14313
14314
14315
14316
14317
14318
14319
14320
14321
14322
14323
14324
14325
14326
14327
14328
14329
14330
14331
14332
14333
14334
14335
14336
14337
14338
14339
14340
14341
14342
14343
14344
14345
14346
14347
14348
14349
14350
14351
14352
14353
14354
14355
14356
14357
14358
14359
14360
14361
14362
14363
14364
14365
14366
14367
14368
14369
14370
14371
14372
14373
14374
14375
14376
14377
14378
14379
14380
14381
14382
14383
14384
14385
14386
14387
14388
14389
14390
14391
14392
14393
14394
14395
14396
14397
14398
14399
14400
14401
14402
14403
14404
14405
14406
14407
14408
14409
14410
14411
14412
14413
14414
14415
14416
14417
14418
14419
14420
14421
14422
14423
14424
14425
14426
14427
14428
14429
14430
14431
14432
14433
14434
14435
14436
14437
14438
14439
14440
14441
14442
14443
14444
14445
14446
14447
14448
14449
14450
14451
14452
14453
14454
14455
14456
14457
14458
14459
14460
14461
14462
14463
14464
14465
14466
14467
14468
14469
14470
14471
14472
14473
14474
14475
14476
14477
14478
14479
14480
14481
14482
14483
14484
14485
14486
14487
14488
14489
14490
14491
14492
14493
14494
14495
14496
14497
14498
14499
14500
14501
14502
14503
14504
14505
14506
14507
14508
14509
14510
14511
14512
14513
14514
14515
14516
14517
14518
14519
14520
14521
14522
14523
14524
14525
14526
14527
14528
14529
14530
14531
14532
14533
14534
14535
14536
14537
14538
14539
14540
14541
14542
14543
14544
14545
14546
14547
14548
14549
14550
14551
14552
14553
14554
14555
14556
14557
14558
14559
14560
14561
14562
14563
14564
14565
14566
14567
14568
14569
14570
14571
14572
14573
14574
14575
14576
14577
14578
14579
14580
14581
14582
14583
14584
14585
14586
14587
14588
14589
14590
14591
14592
14593
14594
14595
14596
14597
14598
14599
14600
14601
14602
14603
14604
14605
14606
14607
14608
14609
14610
14611
14612
14613
14614
14615
14616
14617
14618
14619
14620
14621
14622
14623
14624
14625
14626
14627
14628
14629
14630
14631
14632
14633
14634
14635
14636
14637
14638
14639
14640
14641
14642
14643
14644
14645
14646
14647
14648
14649
14650
14651
14652
14653
14654
14655
14656
14657
14658
14659
14660
14661
14662
14663
14664
14665
14666
14667
14668
14669
14670
14671
14672
14673
14674
14675
14676
14677
14678
14679
14680
14681
14682
14683
14684
14685
14686
14687
14688
14689
14690
14691
14692
14693
14694
14695
14696
14697
14698
14699
14700
14701
14702
14703
14704
14705
14706
14707
14708
14709
14710
14711
14712
14713
14714
14715
14716
14717
14718
14719
14720
14721
14722
14723
14724
14725
14726
14727
14728
14729
14730
14731
14732
14733
14734
14735
14736
14737
14738
14739
14740
14741
14742
14743
14744
14745
14746
14747
14748
14749
14750
14751
14752
14753
14754
14755
14756
14757
14758
14759
14760
14761
14762
14763
14764
14765
14766
14767
14768
14769
14770
14771
14772
14773
14774
14775
14776
14777
14778
14779
14780
14781
14782
14783
14784
14785
14786
14787
14788
14789
14790
14791
14792
14793
14794
14795
14796
14797
14798
14799
14800
14801
14802
14803
14804
14805
14806
14807
14808
14809
14810
14811
14812
14813
14814
14815
14816
14817
14818
14819
14820
14821
14822
14823
14824
14825
14826
14827
14828
14829
14830
14831
14832
14833
14834
14835
14836
14837
14838
14839
14840
14841
14842
14843
14844
14845
14846
14847
14848
14849
14850
14851
14852
14853
14854
14855
14856
14857
14858
14859
14860
14861
14862
14863
14864
14865
14866
14867
14868
14869
14870
14871
14872
14873
14874
14875
14876
14877
14878
14879
14880
14881
14882
14883
14884
14885
14886
14887
14888
14889
14890
14891
14892
14893
14894
14895
14896
14897
14898
14899
14900
14901
14902
14903
14904
14905
14906
14907
14908
14909
14910
14911
14912
14913
14914
14915
14916
14917
14918
14919
14920
14921
14922
14923
14924
14925
14926
14927
14928
14929
14930
14931
14932
14933
14934
14935
14936
14937
14938
14939
14940
14941
14942
14943
14944
14945
14946
14947
14948
14949
14950
14951
14952
14953
14954
14955
14956
14957
14958
14959
14960
14961
14962
14963
14964
14965
14966
14967
14968
14969
14970
14971
14972
14973
14974
14975
14976
14977
14978
14979
14980
14981
14982
14983
14984
14985
14986
14987
14988
14989
14990
14991
14992
14993
14994
14995
14996
14997
14998
14999
15000
15001
15002
15003
15004
15005
15006
15007
15008
15009
15010
15011
15012
15013
15014
15015
15016
15017
15018
15019
15020
15021
15022
15023
15024
15025
15026
15027
15028
15029
15030
15031
15032
15033
15034
15035
15036
15037
15038
15039
15040
15041
15042
15043
15044
15045
15046
15047
15048
15049
15050
15051
15052
15053
15054
15055
15056
15057
15058
15059
15060
15061
15062
15063
15064
15065
15066
15067
15068
15069
15070
15071
15072
15073
15074
15075
15076
15077
15078
15079
15080
15081
15082
15083
15084
15085
15086
15087
15088
15089
15090
15091
15092
15093
15094
15095
15096
15097
15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
15137
15138
15139
15140
15141
15142
15143
15144
15145
15146
15147
15148
15149
15150
15151
15152
15153
15154
15155
15156
15157
15158
15159
15160
15161
15162
15163
15164
15165
15166
15167
15168
15169
15170
15171
15172
15173
15174
15175
15176
15177
15178
15179
15180
15181
15182
15183
15184
15185
15186
15187
15188
15189
15190
15191
15192
15193
15194
15195
15196
15197
15198
15199
15200
15201
15202
15203
15204
15205
15206
15207
15208
15209
15210
15211
15212
15213
15214
15215
15216
15217
15218
15219
15220
15221
15222
15223
15224
15225
15226
15227
15228
15229
15230
15231
15232
15233
15234
15235
15236
15237
15238
15239
15240
15241
15242
15243
15244
15245
15246
15247
15248
15249
15250
15251
15252
15253
15254
15255
15256
15257
15258
15259
15260
15261
15262
15263
15264
15265
15266
15267
15268
15269
15270
15271
15272
15273
15274
15275
15276
15277
15278
15279
15280
15281
15282
15283
15284
15285
15286
15287
15288
15289
15290
15291
15292
15293
15294
15295
15296
15297
15298
15299
15300
15301
15302
15303
15304
15305
15306
15307
15308
15309
15310
15311
15312
15313
15314
15315
15316
15317
15318
15319
15320
15321
15322
15323
15324
15325
15326
15327
15328
15329
15330
15331
15332
15333
15334
15335
15336
15337
15338
15339
15340
15341
15342
15343
15344
15345
15346
15347
15348
15349
15350
15351
15352
15353
15354
15355
15356
15357
15358
15359
15360
15361
15362
15363
15364
15365
15366
15367
15368
15369
15370
15371
15372
15373
15374
15375
15376
15377
15378
15379
15380
15381
15382
15383
15384
15385
15386
15387
15388
15389
15390
15391
15392
15393
15394
15395
15396
15397
15398
15399
15400
15401
15402
15403
15404
15405
15406
15407
15408
15409
15410
15411
15412
15413
15414
15415
15416
15417
15418
15419
15420
15421
15422
15423
15424
15425
15426
15427
15428
15429
15430
15431
15432
15433
15434
15435
15436
15437
15438
15439
15440
15441
15442
15443
15444
15445
15446
15447
15448
15449
15450
15451
15452
15453
15454
15455
15456
15457
15458
15459
15460
15461
15462
15463
15464
15465
15466
15467
15468
15469
15470
15471
15472
15473
15474
15475
15476
15477
15478
15479
15480
15481
15482
15483
15484
15485
15486
15487
15488
15489
15490
15491
15492
15493
15494
15495
15496
15497
15498
15499
15500
15501
15502
15503
15504
15505
15506
15507
15508
15509
15510
15511
15512
15513
15514
15515
15516
15517
15518
15519
15520
15521
15522
15523
15524
15525
15526
15527
15528
15529
15530
15531
15532
15533
15534
15535
15536
15537
15538
15539
15540
15541
15542
15543
15544
15545
15546
15547
15548
15549
15550
15551
15552
15553
15554
15555
15556
15557
15558
15559
15560
15561
15562
15563
15564
15565
15566
15567
15568
15569
15570
15571
15572
15573
15574
15575
15576
15577
15578
15579
15580
15581
15582
15583
15584
15585
15586
15587
15588
15589
15590
15591
15592
15593
15594
15595
15596
15597
15598
15599
15600
15601
15602
15603
15604
15605
15606
15607
15608
15609
15610
15611
15612
15613
15614
15615
15616
15617
15618
15619
15620
15621
15622
15623
15624
15625
15626
15627
15628
15629
15630
15631
15632
15633
15634
15635
15636
15637
15638
15639
15640
15641
15642
15643
15644
15645
15646
15647
15648
15649
15650
15651
15652
15653
15654
15655
15656
15657
15658
15659
15660
15661
15662
15663
15664
15665
15666
15667
15668
15669
15670
15671
15672
15673
15674
15675
15676
15677
15678
15679
15680
15681
15682
15683
15684
15685
15686
15687
15688
15689
15690
15691
15692
15693
15694
15695
15696
15697
15698
15699
15700
15701
15702
15703
15704
15705
15706
15707
15708
15709
15710
15711
15712
15713
15714
15715
15716
15717
15718
15719
15720
15721
15722
15723
15724
15725
15726
15727
15728
15729
15730
15731
15732
15733
15734
15735
15736
15737
15738
15739
15740
15741
15742
15743
15744
15745
15746
15747
15748
15749
15750
15751
15752
15753
15754
15755
15756
15757
15758
15759
15760
15761
15762
15763
15764
15765
15766
15767
15768
15769
15770
15771
15772
15773
15774
15775
15776
15777
15778
15779
15780
15781
15782
15783
15784
15785
15786
15787
15788
15789
15790
15791
15792
15793
15794
15795
15796
15797
15798
15799
15800
15801
15802
15803
15804
15805
15806
15807
15808
15809
15810
15811
15812
15813
15814
15815
15816
15817
15818
15819
15820
15821
15822
15823
15824
15825
15826
15827
15828
15829
15830
15831
15832
15833
15834
15835
15836
15837
15838
15839
15840
15841
15842
15843
15844
15845
15846
15847
15848
15849
15850
15851
15852
15853
15854
15855
15856
15857
15858
15859
15860
15861
15862
15863
15864
15865
15866
15867
15868
15869
15870
15871
15872
15873
15874
15875
15876
15877
15878
15879
15880
15881
15882
15883
15884
15885
15886
15887
15888
15889
15890
15891
15892
15893
15894
15895
15896
15897
15898
15899
15900
15901
15902
15903
15904
15905
15906
15907
15908
15909
15910
15911
15912
15913
15914
15915
15916
15917
15918
15919
15920
15921
15922
15923
15924
15925
15926
15927
15928
15929
15930
15931
15932
15933
15934
15935
15936
15937
15938
15939
15940
15941
15942
15943
15944
15945
15946
15947
15948
15949
15950
15951
15952
15953
15954
15955
15956
15957
15958
15959
15960
15961
15962
15963
15964
15965
15966
15967
15968
15969
15970
15971
15972
15973
15974
15975
15976
15977
15978
15979
15980
15981
15982
15983
15984
15985
15986
15987
15988
15989
15990
15991
15992
15993
15994
15995
15996
15997
15998
15999
16000
16001
16002
16003
16004
16005
16006
16007
16008
16009
16010
16011
16012
16013
16014
16015
16016
16017
16018
16019
16020
16021
16022
16023
16024
16025
16026
16027
16028
16029
16030
16031
16032
16033
16034
16035
16036
16037
16038
16039
16040
16041
16042
16043
16044
16045
16046
16047
16048
16049
16050
16051
16052
16053
16054
16055
16056
16057
16058
16059
16060
16061
16062
16063
16064
16065
16066
16067
16068
16069
16070
16071
16072
16073
16074
16075
16076
16077
16078
16079
16080
16081
16082
16083
16084
16085
16086
16087
16088
16089
16090
16091
16092
16093
16094
16095
16096
16097
16098
16099
16100
16101
16102
16103
16104
16105
16106
16107
16108
16109
16110
16111
16112
16113
16114
16115
16116
16117
16118
16119
16120
16121
16122
16123
16124
16125
16126
16127
16128
16129
16130
16131
16132
16133
16134
16135
16136
16137
16138
16139
16140
16141
16142
16143
16144
16145
16146
16147
16148
16149
16150
16151
16152
16153
16154
16155
16156
16157
16158
16159
16160
16161
16162
16163
16164
16165
16166
16167
16168
16169
16170
16171
16172
16173
16174
16175
16176
16177
16178
16179
16180
16181
16182
16183
16184
16185
16186
16187
16188
16189
16190
16191
16192
16193
16194
16195
16196
16197
16198
16199
16200
16201
16202
16203
16204
16205
16206
16207
16208
16209
16210
16211
16212
16213
16214
16215
16216
16217
16218
16219
16220
16221
16222
16223
16224
16225
16226
16227
16228
16229
16230
16231
16232
16233
16234
16235
16236
16237
16238
16239
16240
16241
16242
16243
16244
16245
16246
16247
16248
16249
16250
16251
16252
16253
16254
16255
16256
16257
16258
16259
16260
16261
16262
16263
16264
16265
16266
16267
16268
16269
16270
16271
16272
16273
16274
16275
16276
16277
16278
16279
16280
16281
16282
16283
16284
16285
16286
16287
16288
16289
16290
16291
16292
16293
16294
16295
16296
16297
16298
16299
16300
16301
16302
16303
16304
16305
16306
16307
16308
16309
16310
16311
16312
16313
16314
16315
16316
16317
16318
16319
16320
16321
16322
16323
16324
16325
16326
16327
16328
16329
16330
16331
16332
16333
16334
16335
16336
16337
16338
16339
16340
16341
16342
16343
16344
16345
16346
16347
16348
16349
16350
16351
16352
16353
16354
16355
16356
16357
16358
16359
16360
16361
16362
16363
16364
16365
16366
16367
16368
16369
16370
16371
16372
16373
16374
16375
16376
16377
16378
16379
16380
16381
16382
16383
16384
16385
16386
16387
16388
16389
16390
16391
16392
16393
16394
16395
16396
16397
16398
16399
16400
16401
16402
16403
16404
16405
16406
16407
16408
16409
16410
16411
16412
16413
16414
16415
16416
16417
16418
16419
16420
16421
16422
16423
16424
16425
16426
16427
16428
16429
16430
16431
16432
16433
16434
16435
16436
16437
16438
16439
16440
16441
16442
16443
16444
16445
16446
16447
16448
16449
16450
16451
16452
16453
16454
16455
16456
16457
16458
16459
16460
16461
16462
16463
16464
16465
16466
16467
16468
16469
16470
16471
16472
16473
16474
16475
16476
16477
16478
16479
16480
16481
16482
16483
16484
16485
16486
16487
16488
16489
16490
16491
16492
16493
16494
16495
16496
16497
16498
16499
16500
16501
16502
16503
16504
16505
16506
16507
16508
16509
16510
16511
16512
16513
16514
16515
16516
16517
16518
16519
16520
16521
16522
16523
16524
16525
16526
16527
16528
16529
16530
16531
16532
16533
16534
16535
16536
16537
16538
16539
16540
16541
16542
16543
16544
16545
16546
16547
16548
16549
16550
16551
16552
16553
16554
16555
16556
16557
16558
16559
16560
16561
16562
16563
16564
16565
16566
16567
16568
16569
16570
16571
16572
16573
16574
16575
16576
16577
16578
16579
16580
16581
16582
16583
16584
16585
16586
16587
16588
16589
16590
16591
16592
16593
16594
16595
16596
16597
16598
16599
16600
16601
16602
16603
16604
16605
16606
16607
16608
16609
16610
16611
16612
16613
16614
16615
16616
16617
16618
16619
16620
16621
16622
16623
16624
16625
16626
16627
16628
16629
16630
16631
16632
16633
16634
16635
16636
16637
16638
16639
16640
16641
16642
16643
16644
16645
16646
16647
16648
16649
16650
16651
16652
16653
16654
16655
16656
16657
16658
16659
16660
16661
16662
16663
16664
16665
16666
16667
16668
16669
16670
16671
16672
16673
16674
16675
16676
16677
16678
16679
16680
16681
16682
16683
16684
16685
16686
16687
16688
16689
16690
16691
16692
16693
16694
16695
16696
16697
16698
16699
16700
16701
16702
16703
16704
16705
16706
16707
16708
16709
16710
16711
16712
16713
16714
16715
16716
16717
16718
16719
16720
16721
16722
16723
16724
16725
16726
16727
16728
16729
16730
16731
16732
16733
16734
16735
16736
16737
16738
16739
16740
16741
16742
16743
16744
16745
16746
16747
16748
16749
16750
16751
16752
16753
16754
16755
16756
16757
16758
16759
16760
16761
16762
16763
16764
16765
16766
16767
16768
16769
16770
16771
16772
16773
16774
16775
16776
16777
16778
16779
16780
16781
16782
16783
16784
16785
16786
16787
16788
16789
16790
16791
16792
16793
16794
16795
16796
16797
16798
16799
16800
16801
16802
16803
16804
16805
16806
16807
16808
16809
16810
16811
16812
16813
16814
16815
16816
16817
16818
16819
16820
16821
16822
16823
16824
16825
16826
16827
16828
16829
16830
16831
16832
16833
16834
16835
16836
16837
16838
16839
16840
16841
16842
16843
16844
16845
16846
16847
16848
16849
16850
16851
16852
16853
16854
16855
16856
16857
16858
16859
16860
16861
16862
16863
16864
16865
16866
16867
16868
16869
16870
16871
16872
16873
16874
16875
16876
16877
16878
16879
16880
16881
16882
16883
16884
16885
16886
16887
16888
16889
16890
16891
16892
16893
16894
16895
16896
16897
16898
16899
16900
16901
16902
16903
16904
16905
16906
16907
16908
16909
16910
16911
16912
16913
16914
16915
16916
16917
16918
16919
16920
16921
16922
16923
16924
16925
16926
16927
16928
16929
16930
16931
16932
16933
16934
16935
16936
16937
16938
16939
16940
16941
16942
16943
16944
16945
16946
16947
16948
16949
16950
16951
16952
16953
16954
16955
16956
16957
16958
16959
16960
16961
16962
16963
16964
16965
16966
16967
16968
16969
16970
16971
16972
16973
16974
16975
16976
16977
16978
16979
16980
16981
16982
16983
16984
16985
16986
16987
16988
16989
16990
16991
16992
16993
16994
16995
16996
16997
16998
16999
17000
17001
17002
17003
17004
17005
17006
17007
17008
17009
17010
17011
17012
17013
17014
17015
17016
17017
17018
17019
17020
17021
17022
17023
17024
17025
17026
17027
17028
17029
17030
17031
17032
17033
17034
17035
17036
17037
17038
17039
17040
17041
17042
17043
17044
17045
17046
17047
17048
17049
17050
17051
17052
17053
17054
17055
17056
17057
17058
17059
17060
17061
17062
17063
17064
17065
17066
17067
17068
17069
17070
17071
17072
17073
17074
17075
17076
17077
17078
17079
17080
17081
17082
17083
17084
17085
17086
17087
17088
17089
17090
17091
17092
17093
17094
17095
17096
17097
17098
17099
17100
17101
17102
17103
17104
17105
17106
17107
17108
17109
17110
17111
17112
17113
17114
17115
17116
17117
17118
17119
17120
17121
17122
17123
17124
17125
17126
17127
17128
17129
17130
17131
17132
17133
17134
17135
17136
17137
17138
17139
17140
17141
17142
17143
17144
17145
17146
17147
17148
17149
17150
17151
17152
17153
17154
17155
17156
17157
17158
17159
17160
17161
17162
17163
17164
17165
17166
17167
17168
17169
17170
17171
17172
17173
17174
17175
17176
17177
17178
17179
17180
17181
17182
17183
17184
17185
17186
17187
17188
17189
17190
17191
17192
17193
17194
17195
17196
17197
17198
17199
17200
17201
17202
17203
17204
17205
17206
17207
17208
17209
17210
17211
17212
17213
17214
17215
17216
17217
17218
17219
17220
17221
17222
17223
17224
17225
17226
17227
17228
17229
17230
17231
17232
17233
17234
17235
17236
17237
17238
17239
17240
17241
17242
17243
17244
17245
17246
17247
17248
17249
17250
17251
17252
17253
17254
17255
17256
17257
17258
17259
17260
17261
17262
17263
17264
17265
17266
17267
17268
17269
17270
17271
17272
17273
17274
17275
17276
17277
17278
17279
17280
17281
17282
17283
17284
17285
17286
17287
17288
17289
17290
17291
17292
17293
17294
17295
17296
17297
17298
17299
17300
17301
17302
17303
17304
17305
17306
17307
17308
17309
17310
17311
17312
17313
17314
17315
17316
17317
17318
17319
17320
17321
17322
17323
17324
17325
17326
17327
17328
17329
17330
17331
17332
17333
17334
17335
17336
17337
17338
17339
17340
17341
17342
17343
17344
17345
17346
17347
17348
17349
17350
17351
17352
17353
17354
17355
17356
17357
17358
17359
17360
17361
17362
17363
17364
17365
17366
17367
17368
17369
17370
17371
17372
17373
17374
17375
17376
17377
17378
17379
17380
17381
17382
17383
17384
17385
17386
17387
17388
17389
17390
17391
17392
17393
17394
17395
17396
17397
17398
17399
17400
17401
17402
17403
17404
17405
17406
17407
17408
17409
17410
17411
17412
17413
17414
17415
17416
17417
17418
17419
17420
17421
17422
17423
17424
17425
17426
17427
17428
17429
17430
17431
17432
17433
17434
17435
17436
17437
17438
17439
17440
17441
17442
17443
17444
17445
17446
17447
17448
17449
17450
17451
17452
17453
17454
17455
17456
17457
17458
17459
17460
17461
17462
17463
17464
17465
17466
17467
17468
17469
17470
17471
17472
17473
17474
17475
17476
17477
17478
17479
17480
17481
17482
17483
17484
17485
17486
17487
17488
17489
17490
17491
17492
17493
17494
17495
17496
17497
17498
17499
17500
17501
17502
17503
17504
17505
17506
17507
17508
17509
17510
17511
17512
17513
17514
17515
17516
17517
17518
17519
17520
17521
17522
17523
17524
17525
17526
17527
17528
17529
17530
17531
17532
17533
17534
17535
17536
17537
17538
17539
17540
17541
17542
17543
17544
17545
17546
17547
17548
17549
17550
17551
17552
17553
17554
17555
17556
17557
17558
17559
17560
17561
17562
17563
17564
17565
17566
17567
17568
17569
17570
17571
17572
17573
17574
17575
17576
17577
17578
17579
17580
17581
17582
17583
17584
17585
17586
17587
17588
17589
17590
17591
17592
17593
17594
17595
17596
17597
17598
17599
17600
17601
17602
17603
17604
17605
17606
17607
17608
17609
17610
17611
17612
17613
17614
17615
17616
17617
17618
17619
17620
17621
17622
17623
17624
17625
17626
17627
17628
17629
17630
17631
17632
17633
17634
17635
17636
17637
17638
17639
17640
17641
17642
17643
17644
17645
17646
17647
17648
17649
17650
17651
17652
17653
17654
17655
17656
17657
17658
17659
17660
17661
17662
17663
17664
17665
17666
17667
17668
17669
17670
17671
17672
17673
17674
17675
17676
17677
17678
17679
17680
17681
17682
17683
17684
17685
17686
17687
17688
17689
17690
17691
17692
17693
17694
17695
17696
17697
17698
17699
17700
17701
17702
17703
17704
17705
17706
17707
17708
17709
17710
17711
17712
17713
17714
17715
17716
17717
17718
17719
17720
17721
17722
17723
17724
17725
17726
17727
17728
17729
17730
17731
17732
17733
17734
17735
17736
17737
17738
17739
17740
17741
17742
17743
17744
17745
17746
17747
17748
17749
17750
17751
17752
17753
17754
17755
17756
17757
17758
17759
17760
17761
17762
17763
17764
17765
17766
17767
17768
17769
17770
17771
17772
17773
17774
17775
17776
17777
17778
17779
17780
17781
17782
17783
17784
17785
17786
17787
17788
17789
17790
17791
17792
17793
17794
17795
17796
17797
17798
17799
17800
17801
17802
17803
17804
17805
17806
17807
17808
17809
17810
17811
17812
17813
17814
17815
17816
17817
17818
17819
17820
17821
17822
17823
17824
17825
17826
17827
17828
17829
17830
17831
17832
17833
17834
17835
17836
17837
17838
17839
17840
17841
17842
17843
17844
17845
17846
17847
17848
17849
17850
17851
17852
17853
17854
17855
17856
17857
17858
17859
17860
17861
17862
17863
17864
17865
17866
17867
17868
17869
17870
17871
17872
17873
17874
17875
17876
17877
17878
17879
17880
17881
17882
17883
17884
17885
17886
17887
17888
17889
17890
17891
17892
17893
17894
17895
17896
17897
17898
17899
17900
17901
17902
17903
17904
17905
17906
17907
17908
17909
17910
17911
17912
17913
17914
17915
17916
17917
17918
17919
17920
17921
17922
17923
17924
17925
17926
17927
17928
17929
17930
17931
17932
17933
17934
17935
17936
17937
17938
17939
17940
17941
17942
17943
17944
17945
17946
17947
17948
17949
17950
17951
17952
17953
17954
17955
17956
17957
17958
17959
17960
17961
17962
17963
17964
17965
17966
17967
17968
17969
17970
17971
17972
17973
17974
17975
17976
17977
17978
17979
17980
17981
17982
17983
17984
17985
17986
17987
17988
17989
17990
17991
17992
17993
17994
17995
17996
17997
17998
17999
18000
18001
18002
18003
18004
18005
18006
18007
18008
18009
18010
18011
18012
18013
18014
18015
18016
18017
18018
18019
18020
18021
18022
18023
18024
18025
18026
18027
18028
18029
18030
18031
18032
18033
18034
18035
18036
18037
18038
18039
18040
18041
18042
18043
18044
18045
18046
18047
18048
18049
18050
18051
18052
18053
18054
18055
18056
18057
18058
18059
18060
18061
18062
18063
18064
18065
18066
18067
18068
18069
18070
18071
18072
18073
18074
18075
18076
18077
18078
18079
18080
18081
18082
18083
18084
18085
18086
18087
18088
18089
18090
18091
18092
18093
18094
18095
18096
18097
18098
18099
18100
18101
18102
18103
18104
18105
18106
18107
18108
18109
18110
18111
18112
18113
18114
18115
18116
18117
18118
18119
18120
18121
18122
18123
18124
18125
18126
18127
18128
18129
18130
18131
18132
18133
18134
18135
18136
18137
18138
18139
18140
18141
18142
18143
18144
18145
18146
18147
18148
18149
18150
18151
18152
18153
18154
18155
18156
18157
18158
18159
18160
18161
18162
18163
18164
18165
18166
18167
18168
18169
18170
18171
18172
18173
18174
18175
18176
18177
18178
18179
18180
18181
18182
18183
18184
18185
18186
18187
18188
18189
18190
18191
18192
18193
18194
18195
18196
18197
18198
18199
18200
18201
18202
18203
18204
18205
18206
18207
18208
18209
18210
18211
18212
18213
18214
18215
18216
18217
18218
18219
18220
18221
18222
18223
18224
18225
18226
18227
18228
18229
18230
18231
18232
18233
18234
18235
18236
18237
18238
18239
18240
18241
18242
18243
18244
18245
18246
18247
18248
18249
18250
18251
18252
18253
18254
18255
18256
18257
18258
18259
18260
18261
18262
18263
18264
18265
18266
18267
18268
18269
18270
18271
18272
18273
18274
18275
18276
18277
18278
18279
18280
18281
18282
18283
18284
18285
18286
18287
18288
18289
18290
18291
18292
18293
18294
18295
18296
18297
18298
18299
18300
18301
18302
18303
18304
18305
18306
18307
18308
18309
18310
18311
18312
18313
18314
18315
18316
18317
18318
18319
18320
18321
18322
18323
18324
18325
18326
18327
18328
18329
18330
18331
18332
18333
18334
18335
18336
18337
18338
18339
18340
18341
18342
18343
18344
18345
18346
18347
18348
18349
18350
18351
18352
18353
18354
18355
18356
18357
18358
18359
18360
18361
18362
18363
18364
18365
18366
18367
18368
18369
18370
18371
18372
18373
18374
18375
18376
18377
18378
18379
18380
18381
18382
18383
18384
18385
18386
18387
18388
18389
18390
18391
18392
18393
18394
18395
18396
18397
18398
18399
18400
18401
18402
18403
18404
18405
18406
18407
18408
18409
18410
18411
18412
18413
18414
18415
18416
18417
18418
18419
18420
18421
18422
18423
18424
18425
18426
18427
18428
18429
18430
18431
18432
18433
18434
18435
18436
18437
18438
18439
18440
18441
18442
18443
18444
18445
18446
18447
18448
18449
18450
18451
18452
18453
18454
18455
18456
18457
18458
18459
18460
18461
18462
18463
18464
18465
18466
18467
18468
18469
18470
18471
18472
18473
18474
18475
18476
18477
18478
18479
18480
18481
18482
18483
18484
18485
18486
18487
18488
18489
18490
18491
18492
18493
18494
18495
18496
18497
18498
18499
18500
18501
18502
18503
18504
18505
18506
18507
18508
18509
18510
18511
18512
18513
18514
18515
18516
18517
18518
18519
18520
18521
18522
18523
18524
18525
18526
18527
18528
18529
18530
18531
18532
18533
18534
18535
18536
18537
18538
18539
18540
18541
18542
18543
18544
18545
18546
18547
18548
18549
18550
18551
18552
18553
18554
18555
18556
18557
18558
18559
18560
18561
18562
18563
18564
18565
18566
18567
18568
18569
18570
18571
18572
18573
18574
18575
18576
18577
18578
18579
18580
18581
18582
18583
18584
18585
18586
18587
18588
18589
18590
18591
18592
18593
18594
18595
18596
18597
18598
18599
18600
18601
18602
18603
18604
18605
18606
18607
18608
18609
18610
18611
18612
18613
18614
18615
18616
18617
18618
18619
18620
18621
18622
18623
18624
18625
18626
18627
18628
18629
18630
18631
18632
18633
18634
18635
18636
18637
18638
18639
18640
18641
18642
18643
18644
18645
18646
18647
18648
18649
18650
18651
18652
18653
18654
18655
18656
18657
18658
18659
18660
18661
18662
18663
18664
18665
2023-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Offer advice to users of PDF who want a table of contents
	at the front of the document.

	* doc/groff.texi (ms Document Structure): Move mention of
	pdfjam(1) from here...
	(ms TOC): ...to here, and identify alternatives, including
	gropdf(1)'s `pdfswitchtopage` macro.

	* doc/ms.ms (General structure of an ms document):
	(Creating a table of contents): Similar.

	Fixes <https://savannah.gnu.org/bugs/?64278>.  Thanks to Michał
	Kruszewski for the report.

2023-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Migrate terminology to "scaling unit".

	...from "scaling indicator".

	Fixes <https://savannah.gnu.org/bugs/?60957>.  Thanks to Ingo
	Schwarze for the discussion.

2023-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Revise discussion of fonts.

	* doc/groff.texi:
	- Rename node/section "Fonts and Symbols" to "Using Fonts".  Add
	  giant new introduction, properly establishing terminology.
	- Rename node/section "Changing Fonts" to "Selecting Fonts".
	  Shift location of `.fn` and `.sty` register documentation.
	  Rewrite presentation of `ft` and `\f`.  Discuss typeface
	  selection by mounting position and font (or style) name
	  together; since arguments to these formatter instructions are
	  always interpreted as mounting positions first, it doesn't
	  make much sense to me to present them separately, and the new
	  introduction provides the necessary background.  Tighten
	  example.  Document that current and previous font selections
	  are environment properties.
	- Add several concept index entries.
	- Do more migration from "symbol" and "glyph" names to "special
	  character" names.

	* man/groff.7 (Using fonts): Introduce new section, synced with
	the renamed node from our Texinfo manual above.

	Fixes <https://savannah.gnu.org/bugs/?62973>.

2023-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Revise "Page Layout" material.

	* doc/groff.texi:
	- Recast generally.
	- Describe behavior of `pl` in more detail.
	- Migrate terminology from "scaling indicator" to "scaling
	  unit".
	- Stop discussing page margins in the context of the `pl`
	  request.
	- Move concept index entries regarding margins from here to
	  "Traps".
	- Move discussion of `pn` request to precede `tl` request.
	- Add concept index entries.
	- Recast description of `tl` request.  Migrate terminology from
	  "justification" to "alignment".
	- Recast description of `lt` request.  Describe behavior in more
	  detail.
	- Recast description of `pc` request.
	- Add example of `lt` and `tl` usage.  Add forward reference to
	  "Traps", mentioning page header and footer traps.

	Fixes <https://savannah.gnu.org/bugs/?55124>.  Thanks to Dave
	Kemper for the report.

2023-05-22  Dave Kemper <saint.snit@gmail.com>

	[docs]: Correct minor punctuation, grammar, and spelling issues.

	Also remove a couple instances of unnecessarily telling the
	reader to note something.

	* doc/groff.texi:
	* man/groff.7.man:
	* man/groff_char.7.man:
	* man/groff_diff.7.man:
	* man/roff.7.man:
	* src/roff/nroff/nroff.1.man: Do it.

	Fixes <https://savannah.gnu.org/bugs/?64230>.  [I threw in a few
	more fixes.  --GBR]

2023-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Attempt to further clarify end-of-sentence detection.

	* doc/groff.texi (Sentences):
	* man/roff.7 (Concepts): Do it.

	Fixes <https://savannah.gnu.org/bugs/?64091>.  Thanks to Ingo
	Schwarze and Dave Kemper for the report.

2023-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Minimally document `tag`, `taga` requests.

	* doc/groff.texi (Postprocessor Access):
	* man/groff.7 (Request short reference): Do it.

	Fixes <https://savannah.gnu.org/bugs/?62695>.

2023-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Fix typos.

	* doc/groff.texi (ms basic information):
	* doc/ms.ms (Basic information): Do it.

	Fixes <https://savannah.gnu.org/bugs/?64032>.  Thanks to an
	anonymous reporter.

2023-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Operators in Conditionals):
	* man/groff.7.in (Conditional expressions): Clarify how the
	output comparison operator is recognized.

	Fixes <https://savannah.gnu.org/bugs/?63812>.  Thanks to John
	Gardner for the report.

2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	Use a better type for symbol hashes.

	* bootstrap.conf: Add "stdint" module to ensure that the
	`uintptr_t` type is available.
	* src/include/symbol.h: Include <stdint.h> for `uintptr_t`.
	(class symbol):
	(symbol::hash): Change return type from `unsigned long`, which
	causes build failures on 64-bit MinGW, to `uintptr_t`.
	(symbol::hash): Use a C++ type cast, not a C-style one.

	Thanks to Bruno Haible for reporting the build failure in the
	64-bit MinGW environment, and for suggesting a remedy.

2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[groff]: Revise a test to be more revealing.

	* src/roff/groff/tests/initialization_is_quiet.sh: Stop using
	"set -e".  Instead use `fail` variable and `wail` function (and
	lowercase names for our internal variables) like many of our
	other tests.  If the "unset" shell built-in fails, skip the
	test (prompted by /usr/xpg4/bin/sh on Solaris).  Attempt every
	groff locale, with and without compatibility mode initially
	enabled, instead of stopping at the first failure.  Report
	standard error and standard output content separately.  Use
	groff's `-a` flag to prepare the standard output, for
	readability.
	* PROBLEMS: Document that this test might be skipped rather than
	failing on Solaris.  (What actually happens depends on which
	shell you run it with, and we advise a variety of approaches.)

	Thanks to Bruno Haible for feedback regarding mysterious
	failures of this test on GNU/Hurd and NetBSD systems.

2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* bootstrap.conf (gnulib_modules): Add "stdbool-c99" per
	recommendation from Bruno Haible.

	Fixes build problem on Solaris using Sun compiler.

2023-03-06  Bruno Haible <bruno@clisp.org>

	* Makefile.am (AR): Remove hardcoded value. Let Automake use the
	value from config.status.

	{Fixes build problem on 64-bit AIX.  Problem appears to date
	back to commit 5fec19d453, 2014-08-15. --GBR}

2023-03-06  Bruno Haible <bruno@clisp.org>

	* arch/misc/misc.am (shdeps.sed): Rename target from this...
	($(SH_DEPS_SED_SCRIPT)): ...to this, to work better with make(1)
	on FreeBSD, NetBSD, and AIX.

2023-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Discard now-unneeded Autoconf macro and variables.

	* configure.ac: Stop calling `GROFF_POPPLER`.  Stop populating
	the Automake conditional `HAVE_PDFTOOLS`.  Eliminate chatter
	about their availability in the configuration report.
	* m4/groff.m4 (GROFF_POPPLER): Delete.

2023-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS_NOTICE): Adapt wording of notice
	to presence and identity of Ghostscript interpreter command.
	Clarify that it is gropdf(1) specifically that traverses the
	Ghostscript search path reported by its "-h" option.

	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
	Deri James for the ongoing discussion.

2023-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[devpdf]: Revise tests.

	* font/devpdf/tests/check-default-foundry.sh.in: Test only the
	base 14 fonts of the PDF standard unconditionally.  Test the
	remainder from the set of 35 commonly distributed only if a
	Ghostscript interpreter was detected at configuration time,
	because the latter fonts _must_ be embedded in PDF documents.
	If they're not present, skip the test rather than failing it.
	* font/devpdf/tests/check-urw-foundry.sh.in: Skip test if no URW
	fonts detected at configuration time, rather than failing it.
	* m4/groff.m4 (GROFF_GROPDF_PROGRAM_NOTICE)
	(GROFF_URW_FONTS_NOTICE): Drop warnings of expected test
	failures.  The tests no longer fail in the anticipated
	circumstances.

2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[devpdf]: Generate tests from template files, so we can populate
	the test scripts with information determined at configuration.
	The default foundry test depends on $GHOSTSCRIPT, and the URW
	foundry test on $urwfontsdir.

	* font/devpdf/tests/check-default-foundry.sh:
	* font/devpdf/tests/check-urw-foundry.sh: Rename these...
	* font/devpdf/tests/check-default-foundry.sh.in:
	* font/devpdf/tests/check-urw-foundry.sh.in: ...to these.

	* font/devpdf/devpdf.am (font_devpdf_default_test)
	(font_devpdf_urw_test): New variables store names of generated
	test scripts.
	(font/devpdf/tests/check-default-foundry.sh):
	(font/devpdf/tests/check-urw-foundry.sh): New targets produce
	test scripts from corresponding .in files.

2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[devpdf]: Trivially refactor.  Rename sed-substitutum [Lat.]
	from "@GROFF_GHOSTSCRIPT_INTERPRETERS@" to "@GHOSTSCRIPT@" for
	clarity and brevity; this is a scalar value containing the
	Autoconf-determined name of the Ghostscript interpreter.  It is
	not the same as the replacement that occurs in contrib/pdfmark.

	* font/devpdf/devpdf.am:
	* font/devpdf/util/BuildFoundries.pl: Do it.

2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Stop scraping output of Ghostscript executable with
	"-h" option to attempt to find URW fonts.  Fonts that ship with
	Ghostscript are regarded as the "default" foundry, not the URW
	foundry (though they often ultimately originate with URW fonts).
	They are often missing Adobe Font Metric (AFM) files, so it is
	impossible for groff to generate font description files for them
	at build time.

	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): Drop `AC_REQUIRE` on
	`GROFF_AWK_PATH`.  Drop awk-based scraping of Ghostscript "-h"
	output.  Annotate need for sync between this list of
	characteristic font file names and the one in BuildFoundries.

	Thanks to Deri James for the ongoing discussions.

2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Drop now-redundant explicit
	`GROFF_URW_FONTS_CHECK`.  `GROFF_GROPDF_DEPENDENCIES_CHECK`
	`AC_REQUIRE`s it as of commit ec001d2a23, 18 February.

2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): When looking for a
	characteristic URW font by its file name, also check for
	"URWGothic-Book" with no file extension.  Avoids false negatives
	in URW Type 1 font detection when using Ghostscript 9.53.3.
	Thanks to Deri James for suggesting the test procedure that
	uncovered this flaw.

2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am (uninstall_groffdirs): Remove "html.mono" and
	"html.node" directories corresponding to HTML version of our
	Texinfo manual.
	* doc/doc.am (uninstall-html): Uninstall HTML version of our
	Texinfo manual more reliably.

	Fixes a regression introduced by me in commit c2698aade, 6 April
	{my claim "we're only deleting files with this command, not
	directories" was not correct}.

2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[doc]: Handle output formats of our Texinfo manual more
	consistently.

	* doc/doc.am (install-doc): Add dependency on (Automake
	standard) target 'install-dvi'.
	(maintainer-clean-local): Remove our Texinfo manual in plain
	text format.
	(install-data-local): Add dependency on new target
	'install-txt'.
	(install-txt): Install our Texinfo manual in plain text format.
	(uninstall-local): Add dependency on new target 'uninstall-txt'.
	(uninstall-txt): Uninstall our Texinfo manual in plain text
	format.

	Thanks to T. Kurt Bond for noticing the discrepancy.

2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (install-pdf-local, install-html-local): Enable
	rules to work in out-of-tree builds.

2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (uninstall-hook): Drop dependency on
	"uninstall_mom"; this is not the appropriate place to declare
	it, and "uninstall_groffdirs" already depends on it in mom's
	Automake file.

2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Have more tests report output.

	* src/roff/groff/tests/ab_works.sh:
	* src/roff/groff/tests/handle_special_input_code_points.sh:
	* src/roff/groff/tests/initialization_is_quiet.sh:
	* src/roff/groff/tests/msoquiet_works.sh:
	* src/roff/groff/tests/soquiet_works.sh:
	* tmac/tests/an-ext_MR-works.sh:
	* tmac/tests/an_MR-works.sh: Do it.

2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Prevent failures when $GROFF_ENCODING is set.

	* src/roff/groff/tests/ab_works.sh:
	* src/roff/groff/tests/handle_special_input_code_points.sh:
	* src/roff/groff/tests/initialization_is_quiet.sh:
	* src/roff/groff/tests/msoquiet_works.sh:
	* src/roff/groff/tests/soquiet_works.sh:
	* tmac/tests/an-ext_MR-works.sh:
	* tmac/tests/an_MR-works.sh:
	* tmac/tests/an_font-remapping-does-not-affect-titles.sh: Unset
	$GROFF_ENCODING before running test because preconv(1) confounds
	these tests.

	Thanks to Alexis for reporting this problem.

2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Rename test.

	* tmac/tests/s_no-excess-space-around-displays.tmac: Rename...
	* tmac/tests/s_no-excess-space-around-displays.sh: ...to this.
	* tmac/tmac.am (tmac_TESTS): Update.

2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gropdf]: Revise tests to run unconditionally, rather than
	configuring them away at build time, which can cause a
	distribution archive to be incorrectly structured.  Update
	configuration notices when optional dependencies are absent.

	* font/devpdf/devpdf.am (font_devpdf_TESTS): Remove `USE_GROPDF`
	and `HAVE_URW_FONTS` conditionals.
	* m4/groff.m4 (GROFF_GROPDF_PROGRAM_NOTICE):
	(GROFF_URW_FONTS_NOTICE): Warn reader that a gropdf test failure
	is to be expected.

	Fixes <https://savannah.gnu.org/bugs/?63824> (2/2).

2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Revise tests to check for requisite programs at test
	time and skip if not found, rather than configuring them away at
	build time, which can cause a distribution archive to be
	incorrectly structured.

	* m4/groff.m4: Annotate requisite program list since we're
	violating the DRY principle.
	* src/roff/groff/groff.am (groff_TESTS): Populate
	unconditionally.

	* src/roff/groff/tests/html_works_with_grn_and_eqn.sh:
	* src/roff/groff/tests/smoke-test_html_device.sh: Check for
	requisite programs and skip test if any are not found.

	Fixes <https://savannah.gnu.org/bugs/?63824> (1/2).

2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man pages]: Define page-local `MR` fallback.

	[man pages]: Provide page-local fallback definition of new `MR`
	macro.  I didn't think I was going to have to do this, but the
	premier site on the web for viewing Linux man pages, Michael
	Kerrisk's man7.org, has been pulling snapshots of the pages
	themselves without upgrading the underlying macros, and so man
	page cross references set with `MR` are getting lost in its
	presentations.  (I acknowledge: Ingo Schwarze warned me
	something like this could happen.)  This definition is intended
	as a stopgap measure only.  I want to revert this after groff
	1.23 is released and has spread to some reasonable degree.

	* contrib/chem/chem.1.man:
	* contrib/eqn2graph/eqn2graph.1.man:
	* contrib/gdiffmk/gdiffmk.1.man:
	* contrib/glilypond/glilypond.1.man:
	* contrib/gperl/gperl.1.man:
	* contrib/gpinyin/gpinyin.1.man:
	* contrib/grap2graph/grap2graph.1.man:
	* contrib/hdtbl/groff_hdtbl.7.man:
	* contrib/mm/groff_mm.7.man:
	* contrib/mm/groff_mmse.7.man:
	* contrib/mm/mmroff.1.man:
	* contrib/mom/groff_mom.7.man:
	* contrib/pdfmark/pdfroff.1.man:
	* contrib/pic2graph/pic2graph.1.man:
	* contrib/rfc1345/groff_rfc1345.7.man:
	* man/groff.7.man:
	* man/groff_char.7.man:
	* man/groff_diff.7.man:
	* man/groff_font.5.man:
	* man/groff_out.5.man:
	* man/groff_tmac.5.man:
	* man/roff.7.man:
	* src/devices/grodvi/grodvi.1.man:
	* src/devices/grohtml/grohtml.1.man:
	* src/devices/grolbp/grolbp.1.man:
	* src/devices/grolj4/grolj4.1.man:
	* src/devices/gropdf/gropdf.1.man:
	* src/devices/gropdf/pdfmom.1.man:
	* src/devices/grops/grops.1.man:
	* src/devices/grotty/grotty.1.man:
	* src/devices/xditview/gxditview.1.man:
	* src/preproc/eqn/eqn.1.man:
	* src/preproc/eqn/neqn.1.man:
	* src/preproc/grn/grn.1.man:
	* src/preproc/pic/pic.1.man:
	* src/preproc/preconv/preconv.1.man:
	* src/preproc/refer/refer.1.man:
	* src/preproc/soelim/soelim.1.man:
	* src/preproc/tbl/tbl.1.man:
	* src/roff/groff/groff.1.man:
	* src/roff/nroff/nroff.1.man:
	* src/roff/troff/troff.1.man:
	* src/utils/addftinfo/addftinfo.1.man:
	* src/utils/afmtodit/afmtodit.1.man:
	* src/utils/grog/grog.1.man:
	* src/utils/hpftodit/hpftodit.1.man:
	* src/utils/indxbib/indxbib.1.man:
	* src/utils/lkbib/lkbib.1.man:
	* src/utils/lookbib/lookbib.1.man:
	* src/utils/pfbtops/pfbtops.1.man:
	* src/utils/tfmtodit/tfmtodit.1.man:
	* src/utils/xtotroff/xtotroff.1.man:
	* tmac/groff_man.7.man.in:
	* tmac/groff_me.7.man:
	* tmac/groff_ms.7.man:
	* tmac/groff_trace.7.man:
	* tmac/groff_www.7.man: Do it.

	Fixes <https://savannah.gnu.org/bugs/?63825>.  Thanks greatly to
	Alexis for identifying an issue with mandoc(1)'s handling of an
	earlier iteration of this fallback, and to John Gardner for
	identifying a method of detecting mandoc as the renderer at
	formatting time.

2023-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Improve
	portability of script by using shell constructs instead of the
	nonstandard GNU coreutils 'seq' utility.  Resolves test failure
	on Solaris 10.
	* HACKING: Document this problem.

2023-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_MAKE_DEFINES_RM): Test the make(1) in the
	environment variable $MAKE if defined, not a literal "make".
	Required on (some) Solaris 10 configurations where traditional
	make(1) is not installed but GNU make is installed as "gmake".

2023-02-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/latin2_works.sh: Fix missing backslash in printf.
	Solaris printf(1) was sensitive to this error; macOS and GNU
	printf were not.  Fixes a test failure on Solaris 11.

2023-02-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/regression_savannah_58153.sh: Improve
	portability.  Avoid the unpredictability of implementations when
	putting backslashes inside a groff-piped printf shell command
	inside a here document inside a command substitution by changing
	the groff escape character to something meaningless to the shell
	and to printf ('@').  Fixes a test failure on Solaris 11.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/Foundry.in: Recognize URW foundry replacements for
	Helvetica Bold-Oblique and Helvetica Oblique under the file
	names "NimbusSans-BoldItalic.t1" and "NimbusSans-Italic.t1",
	respectively.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (uninstall-pdf): Clean more fastidiously; try to
	remove the configured `pdfdocdir` in the event it is empty, but
	do not fail if it isn't.  (It can be a directory shared with
	other groff components; we don't know in what order the
	uninstall targets will serialize, but the last one run should
	succeed.)

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Detangle "pdfroff" and "gropdf" configuration (2/2).

	* m4/groff.m4: Give pdfroff its own Autoconf macros to handle
	dependency checking, build objectives, and user notice.
	(GROFF_PDFROFF_DEPENDENCIES_CHECK): New macro requires
	`GROFF_AWK_PATH` and `GROFF_GHOSTSCRIPT_PATH`, determines
	whether pdfroff can be used at build time, and (if not)
	constructs part of message to be shown to user explaining why.
	(GROFF_PDFROFF_PROGRAM_NOTICE): New macro requires
	`GROFF_PDFROFF_DEPENDENCIES_CHECK` and emits message if needed.
	(GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE): Drop mention of impact
	on pdfroff since its dedicated notice covers this now.
	* configure.ac: Call the new macros at appropriate times.
	Produce a new Automake macro, `USE_PDFROFF`, to replace
	inapposite use of `USE_GROPDF` in pdfmark.am.
	* contrib/pdfmark/pdfmark.am: Use `USE_PDFROFF` instead of
	`USE_GROPDF`.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Detangle "pdfroff" and "gropdf" configuration (1/2).

	* m4/groff.m4 (GROFF_GROPDF_DEPENDENCIES_CHECK): Add
	`AC_REQUIRE`ment on `GROFF_URW_FONTS_CHECK`.  Per discussion
	with Deri James, if _either_ Ghostscript or the URW fonts are
	avilable, gropdf will be fully functional, consequent to commit
	d5515, 22 June.  Drop dependency on awk; it is used only at
	configuration time (in an Autoconf macro) and since Savannah
	#62775 was resolved (19 September), it has not been strictly
	necessary.  (It is useful for searching more locations for URW
	fonts, but several others are searched even if it is absent.)
	Stop populating notice text here, instead moving it...
	(GROFF_GROPDF_PROGRAM_NOTICE): ...here, since it no longer needs
	to be dynamically constructed.

	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
	Deri James for the continued discussion.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Rename `GROFF_CHECK_GROPDF_PROGRAMS` macro to
	`GROFF_GROPDF_DEPENDENCIES_CHECK` to generalize for greater
	accuracy in forthcoming change.

	* configure.ac:
	* m4/groff.m4: Do it.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gropdf]: Don't run automated tests if 'gropdf' will be
	operating with reduced function.  If neither Ghostscript nor the
	URW fonts are available at configuration time, there is no point
	testing for successful build-time population of the font
	descriptions for the default and URW foundries.

	* font/devpdf/devpdf.am (font_devpdf_TESTS) [USE_GROPDF]: Run
	"check-default-foundry" only if gropdf is fully functional.
	(font_devpdf_TESTS) [USE_GROPDF && HAVE_URW_FONTS]: Run
	"check-urw-foundry" only if the URW fonts were found.

	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
	Deri James for the continued discussion.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gropdf]: Rename tests to more accurately characterize their
	purpose.

	* font/devpdf/tests/basic-fonts-present.sh:
	* font/devpdf/tests/urw-fonts-present.sh: Rename these...
	* font/devpdf/tests/check-default-foundry.sh:
	* font/devpdf/tests/check-urw-foundry.sh: ...to these.
	* font/devpdf/devpdf.am (font_devpdf_TESTS): Reflect rename.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gropdf]: Revise tests to be foundry-focussed.

	* font/devpdf/tests/basic-fonts-present.sh: Stop trying to match
	font descriptions in the "devps" directory with ones in
	"devpdf"; instead, test whether "BuildFoundries" did its job.
	Test for font descriptions corresponding to the full 35
	PostScript Level 2 font repertoire, plus groff's "EURO".
	* font/devpdf/tests/urw-fonts-present.sh: Drop stale comment and
	rename variable for better parallelism with the other test
	above.

	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
	Deri James for the continued discussion.

2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Tweak fix to Savannah #63768.

	* tmac/an.tmac (MR): Ensure `an*url` always has a value,
	defaulting to "format 1" (man:page(section)).  Resequence the
	macOS URL formats to sort the contemporary one before the
	others.
	* tmac/man.local: Reflect resequencing of integer assignments to
	formats.  Clarify historicity of annotations.

	Continues <https://savannah.gnu.org/bugs/?63768>.  Thanks to
	John Gardner for further discussion.

2023-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Port a test to Solaris 11 sed.

	* tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Put
	newlines after opening braces in sed scripts.  macOS and GNU sed
	tolerate their absence, but this sed does not.
	* HACKING: Document this problem.

2023-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.am (groff_TESTS) [!USE_GROHTML]: Don't
	test the 'grohtml' driver if we know it won't work.

2023-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/\
	device_control_escapes_express_basic_latin.sh: Use printf(1),
	which is often a shell built-in command, more consistently.
	Double backslashes intended as literals in the format string,
	and single-quote format strings using them.  Fixes test failure
	seen on Solaris 11 with GNU Bash 4.4 and ksh 93u+ (2012-08-01).

2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an_use-input-traps-correctly.sh: Explicitly test
	`SM` and `SB` with 'ps' output device.  If one set
	GROFF_TYPESETTER=utf8 in the test environment, these test cases
	would fail.  Thanks to John Gardner for the report.

2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Add Automake conditional, `HAVE_GHOSTSCRIPT`, so
	that we can populate the list of PDF device font tests
	dynamically.  Call new macro
	`GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE`.  Call
	`GROFF_GHOSTSCRIPT_VERSION_NOTICE` after it, but before
	`GROFF_URW_FONTS_NOTICE`.
	* m4/groff.m4 (GROFF_AWK_NOTICE): New macro produces warning if
	no awk could be found.  This reduces gropdf functionality, but
	so do missing URW fonts, so we report this problem separately.
	Report the names under which we sought it, since there's a
	configure script option for that.
	(GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE): New macro explains
	consequences of missing optional dependency on Ghostscript
	program: reduced grohtml functionality, nonfunctional pdfroff.
	Report the names under which we sought it, since there's a
	configure script option for that.
	(GROFF_CHECK_GROPDF_PROGRAMS): Better characterize gropdf's
	reduced function, pointing out the ways in which it would be
	more useful if the dependencies were met.  Also simplify the
	computational grammar.
	(GROFF_URW_FONTS_NOTICE): Identify 'U' as the foundry name
	gropdf uses for the URW fonts.  Confirm continuing availability
	of most recent URW fonts release; bump date.
	* font/devpdf/devpdf.am: Test availability of "basic" (PDF base
	14) fonts (plus groff's "EURO") if either Ghostscript or URW
	fonts are available.  Test availability of URW fonts (35) only
	if Ghostscript _and_ the URW fonts were found at configuration
	time.

	Fixes <https://savannah.gnu.org/bugs/?63808>.  Thanks to Deri
	James for the report and extremely helpful pseudocode.

2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK,
	GROFF_URW_FONTS_NOTICE): Add macro dependency on
	`GROFF_GHOSTSCRIPT_PATH`, which should have been there already.
	(GROFF_GROHTML_PROGRAM_NOTICE): Add macro dependency on
	`GROFF_CHECK_GROHTML_PROGRAMS`, which should have been there
	already.

	(GROFF_CHECK_GROHTML_PROGRAMS, GROFF_PNMTOOLS_CAN_BE_QUIET):
	Move `AC_REQUIRE` expansions to precede shell variable
	assignments (after checking that the required macros don't
	clobber the assignments we're making).

2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/tests/basic-fonts-present.sh: Revise test again,
	per feedback from Deri James.  Even without Ghostscript or URW
	fonts available, gropdf can generate valid PDF documents; it
	simply can't embed fonts in general (without further
	arrangements made on the host system), which means it is
	restricted to the PDF base 14 fonts.  That's enough for many
	purposes, including generating our compiled man pages document
	{with minor degradations to the typeface lists in gropdf(1) and
	grops(1)}.  Drop the 'gs' command check, which also didn't check
	for the name of the Ghostscript interpreter determined by the
	"configure" script.  Replace dynamically generated font list
	with a static one (the base 14 fonts plus groff's EURO).

2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/tests/basic-fonts-present.sh: Revise test.
	Improve explanation of why we're looking for the gs(1) command
	in a font availability test.  Prefix diagnostic output with name
	of test script.  Perform a search for the 'ps' device font
	descriptions that will work in more build scenarios (i.e., don't
	assume an out-of-tree build taking place in an immediate
	subdirectory of the source).  Distinguish failure to find the
	font descriptions from a failure to locate the 'gs' command,
	skipping the test in both scenarios.  Reduce noise in output.
	* m4/groff.m4 (GROFF_CHECK_GROPDF_PROGRAMS): Revise warning
	issued when awk and Ghostscript are unavailable; gropdf will not
	be completely inoperative.  Characterize its reduced function.

	Thanks to Deri James in <https://lists.gnu.org/archive/html/\
	groff-commit/2023-02/msg00089.html> for prompting me to take a
	another look at this.

2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/latin2_works.sh:
	* tmac/tests/latin5_works.sh:
	* tmac/tests/latin9_works.sh: Port to work around macOS's
	apparently POSIX non-conforming 'od' command.  Use single-byte
	octal output format instead of "character", and update test
	expectations accordingly.  Apparently gratuitously, macOS also
	puts more spaces after the octal address field when using this
	output format.
	* HACKING: Document, and elaborate upon, this problem.

2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Port a test to work with macOS sed.

	* tmac/tests/doc_heading-font-remapping-works.sh: Put semicolons
	between commands and closing braces in sed script.  Put each of
	multiple closing braces on a separate input line, because macOS
	doesn't accept them otherwise.  Resolves test failure observed
	on macOS.
	* HACKING: Document the closing brace sequence problem.

2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Port a test to work with macOS sed.

	* tmac/tests/an_TS-adds-no-vertical-space.sh: Put semicolons
	between commands and closing braces in sed script.  Separate
	command stream into multiple '-e' expressions, breaking them
	after branch and label commands.  Resolves test failure observed
	on macOS.
	* HACKING: Document the above problems.

2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/\
	some_escapes_accept_newline_delimiters.sh: Weaken regexes in two
	test cases to accommodate excessive output from macOS's 'od'
	command.  Resolves test failure seen on macOS.
	* HACKING: Add section "Writing Tests" and document the above
	since this is the second time I've cracked my shin on this.

2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/tests/basic-fonts-present.sh: Skip test if 'gs'
	command not available.  The test is to ensure that gropdf will
	produce sound documents using the base fonts from PostScript,
	but since gropdf requires Ghostscript to do this (as noted in
	our "./configure" messages), it makes no sense to validate font
	availability if the program is absent.  Resolves test failure
	seen on macOS with minimal dependencies installed.

2023-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Filling and Adjustment): Say more
	about the consequences of a break.

	Fixes <https://savannah.gnu.org/bugs/?63777>.  Thanks to Dave
	Kemper for the report.

2023-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Re-re-christen 'ESCAPE_AMPERSAND' ('\&').  Now call it a
	{non-transparent} "dummy character".  Also rechristen
	'ESCAPE_RIGHT_PARENTHESIS', ('\)') as the "transparent dummy
	character"; it has no impact on sentence-ending detection.

	* doc/groff.texi:
	* doc/meref.me.in:
	* man/groff.7.man:
	* man/groff_diff.7.man:
	* man/roff.7.man:
	* src/preproc/refer/refer.1.man:
	* tmac/groff_man.7.man.in: Do it.

	Fixes <https://savannah.gnu.org/bugs/?62816>.  Thanks to Dave
	Kemper for the report and to the groff mailing list for the
	vigorous discussion.  I don't expect my solution to please
	everyone.

2023-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Add internal register `an*MR-URL-format` to
	select from a few known formats of man page hyperlink.  There
	are three known on macOS, and one used everywhere else.
	* tmac/man.local: Document this feature so macOS users can enjoy
	the OSC 8 hyperlink feature if their terminal application
	supports it.

	I hope that this feature will be a temporary measure while macOS
	implements support for the man page URL format used everywhere
	else in the world.

	Fixes <https://savannah.gnu.org/bugs/?63768>.  Thanks to John
	Gardner for the report, research, consultation, and testing.

2023-02-11  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[BuildFoundries]: Fails if neither ghostcript nor URW fonts
	are installed.

	* font/devpdf/util/BuildFoundries.pl: When the change to hold
	paths in an array, rather than a delimited string (see commit
	4ae4aeb6555f4f16c28fcb03eb1f56577826054c), the FindGSpath
	subroutine should return a pointer to an empty array when the
	call to ghostscript fails, rather than return an empty string,
	as was done previously.

	See <https://lists.gnu.org/archive/html/groff/2023-02/\
	msg00042.html>; thanks to Bruno Haible for the report.

2023-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Switch to using system's assert.h header file.  It is futile to
	attempt to preserve compatibility with ISO C90 systems by
	providing a bespoke predicate-reporting assert() (a C99 feature)
	when gnulib, which we require, itself demands C99.  This ensures
	that `static_assert` remains defined so that gnulib can use it.
	Thanks to Bruno Haible for the consultation.
	<https://lists.gnu.org/archive/html/groff/2023-02/msg00034.html>

	* src/include/assert.h: Delete.

	* src/devices/grodvi/dvi.cpp:
	* src/devices/grolbp/lbp.cpp:
	* src/devices/grolj4/lj4.cpp:
	* src/include/itable.h:
	* src/include/stringclass.h:
	* src/libs/libbib/linear.cpp:
	* src/libs/libbib/search.cpp:
	* src/libs/libdriver/printer.cpp:
	* src/libs/libgroff/assert.cpp:
	* src/libs/libgroff/color.cpp:
	* src/libs/libgroff/errarg.cpp:
	* src/libs/libgroff/font.cpp:
	* src/libs/libgroff/nametoindex.cpp:
	* src/libs/libgroff/prime.cpp:
	* src/libs/libgroff/relocate.cpp:
	* src/libs/libgroff/searchpath.cpp:
	* src/preproc/eqn/box.cpp:
	* src/preproc/eqn/delim.cpp:
	* src/preproc/eqn/pile.cpp:
	* src/preproc/eqn/script.cpp:
	* src/preproc/html/pre-html.cpp:
	* src/preproc/pic/pic.h:
	* src/preproc/preconv/preconv.cpp:
	* src/preproc/soelim/soelim.cpp:
	* src/roff/groff/groff.cpp:
	* src/roff/troff/troff.h:
	* src/utils/hpftodit/hpftodit.cpp:
	* src/utils/indxbib/indxbib.cpp:
	* src/utils/lkbib/lkbib.cpp:
	* src/utils/lookbib/lookbib.cpp:
	* src/utils/tfmtodit/tfmtodit.cpp: Respell "assert.h" inclusion
	with angle brackets instead of quotation marks.

	Fixes <https://savannah.gnu.org/bugs/?63078>.

2023-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (token::next): Use correct kind of
	null object in comparison.  Fixes latent bug that would be
	exposed if we were to migrate from zero literals to `nullptr`.

2023-02-09  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf] Parse multiple entries in 'papersize' as specified in
	the groff_font man page. Reported by Ben Wong and fix based on
	his patch, thanks.

	* src/devices/gropdf/gropdf.pl: Parse papersize string for
	possible multiple (space separated) entries. First valid entry
	wins.

	Fixes https://savannah.gnu.org/bugs/?63757

2023-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	Correct numerous typos and solecisms throughout the source tree.

	* ChangeLog:
	* ChangeLog.115:
	* ChangeLog.116:
	* ChangeLog.117:
	* ChangeLog.118:
	* ChangeLog.119:
	* ChangeLog.121:
	* ChangeLog.122:
	* Makefile.am:
	* NEWS:
	* PROBLEMS:
	* README:
	* contrib/chem/chem.am:
	* contrib/chem/chem.pl:
	* contrib/glilypond/README.txt:
	* contrib/glilypond/glilypond.pl:
	* contrib/hdtbl/groff_hdtbl.7.man:
	* contrib/mm/ChangeLog:
	* contrib/mm/m.tmac:
	* contrib/pdfmark/pdfmark.ms:
	* doc/automake.mom:
	* doc/groff.texi:
	* doc/me-revisions:
	* doc/webpage.ms:
	* m4/lib-link.m4:
	* man/groff.7.man:
	* man/groff_diff.7.man:
	* man/roff.7.man:
	* src/devices/grohtml/post-html.cpp:
	* src/devices/grolbp/lbp.h:
	* src/devices/gropdf/TODO:
	* src/devices/gropdf/gropdf.1.man:
	* src/devices/gropdf/gropdf.pl:
	* src/devices/xditview/ChangeLog:
	* src/devices/xditview/xditview.c:
	* src/libs/libdriver/input.cpp:
	* src/libs/libgroff/glyphuni.cpp:
	* src/preproc/eqn/eqn.1.man:
	* src/preproc/grn/gprint.h:
	* src/preproc/grn/main.cpp:
	* src/preproc/html/pre-html.cpp:
	* src/preproc/preconv/preconv.cpp:
	* src/preproc/tbl/table.cpp:
	* src/roff/groff/pipeline.c:
	* src/roff/groff/tests/substring_works.sh:
	* src/roff/groff/tests/
	use_point_size_escape_with_single_digit_arg.sh:
	* src/roff/troff/div.cpp:
	* src/roff/troff/input.cpp:
	* src/roff/troff/troff.1.man:
	* src/utils/grog/grog.pl:
	* src/utils/indxbib/indxbib.cpp:
	* src/utils/tfmtodit/tfmtodit.1.man:
	* tmac/doc-old.tmac:
	* tmac/doc.tmac:
	* tmac/groff_man.7.man.in:
	* tmac/hyphen.fr: Do it.

	Fixes <https://savannah.gnu.org/bugs/?63589>.  Thanks to Bjarni
	Ingi Gislason for the report.

2023-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Drop XFAIL test.  It was written with an unclear
	understanding of how DWB (AT&T) and Heirloom Doctools troff
	behaved.  The individual checks might come back, modified.

	* src/preproc/tbl/tests/table-lacks-spurious-top-border.sh:
	Delete.

	* src/preproc/tbl/tbl.am (tbl_TESTS): Drop it.
	(tbl_XFAIL_TESTS, XFAIL_TESTS): Drop now empty assignment and
	unnecessary update, respectively.

2023-02-04  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	Update gnulib submodule

	gnulib now points on sha1 4e9fcc7b84fcac07a3e5a3cd5f66d1ff320dc8e8

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix bugs using boxes or vertical rules at table edges on
	nroff devices, particularly when combined with region or column
	expansion.

	* src/preproc/tbl/table.h (class table): Add `GAP_EXPAND`
	enumeration constant.  James Clark seems to have designed GNU
	tbl carefully to avoid distinguishing region expansion from
	column expansion in a categorical way, but I needed a way for
	formatting-time logic to know which was in use.  (Column
	expansion, the "x" modifier, expands columns--i.e., text.
	Region expansion expands [or compresses] the _gaps_ between
	columns.)
	* src/preproc/tbl/main.cpp (process_options): Set `GAP_EXPAND`
	flag in table if "expand" region option seen.
	* src/preproc/tbl/table.cpp: Add new macro `LEFTOVER_FACTOR_REG`
	to name a new roff register for the remainder of gap-expansion
	space when the amount of space available for expansion is
	divided by the number of gaps.
	(table::compute_overall_width): If _not_ expanding a table in
	either respect and in nroff mode, reduce line length by 1n for
	each of any left and right border (because the vertical lines
	eat character cells).  This prevents bordered or boxed tables
	from being overset even when they use neither expansion feature.
	(table::compute_separation_factor): If gap-expanding a table,
	store any remainder from the division used to compute the
	separation factor into the new `LEFTOVER_FACTOR_REG`.
	(table::compute_column_positions): Insert that remainder into
	the gap before the last (rightmost) column of the table.  This
	_could_ be done more elegantly by spreading each en in a
	symmetric way across a subset of the gaps.  (It is necessarily a
	subset by the pigeonhole principle.)  But it didn't seem worth
	the effort for a feature (region expansion) that few users
	employ.  (Usually what you want is the "x" column modifier.)
	Alternatively, "forget it, Jake--it's a terminal emulator".

	* src/preproc/tbl/tbl.am (tbl_XFAIL_TESTS): Remove now-passing
	tests.

	Fixes <https://savannah.gnu.org/bugs/?63640> and
	<https://savannah.gnu.org/bugs/?63749>.

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::compute_column_positions):
	Stop multiplying the gaps at the left and right edges of a table
	{which occur when it is boxed or has a leading and/or trailing
	vertical line} by the column separation factor.  Only interior
	column gaps should be spread.  This change prevents tables using
	the "expand" region option from being overset (exceeding the
	line length), but might not (yet) fully expand to that length on
	low-resolution devices due to integer roundoff.

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::compute_total_separation)
	(table::compute_separation_factor, table::compute_widths): Add
	comments to generated roff output to assist the mystified user.

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Refactor.

	* src/preproc/tbl/table.cpp:
	* src/preproc/tbl/table.h: Rename `compute_expand_width` to
	`compute_overall_width`, since this member function is used on
	_all_ tables, not just those undergoing column or gap expansion.
	For instance, in a post-groff 1.22.4 development, it throws a
	diagnostic if an unexpanded table overruns the line length.
	* src/preproc/tbl/table.cpp (table::compute_widths): Update call
	site of `compute_overall_width`.
	* src/preproc/tbl/table.cpp: Split the roff register behind the
	`EXPAND_REG` C++ preprocessor macro into two, adding
	`AVAILABLE_WIDTH_REG`.  Annotate the distinction.
	(compute_overall_width): Annotate.  Move and conditionalize
	logic so as not to produce as much unnecessary roff output.

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (main): Avoid reading from invalid
	memory upon failure to open an input file.

	Fixes <https://savannah.gnu.org/bugs/?63751>.

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/lex.cpp (get_delimited_text): Avoid reading
	from invalid memory when throwing diagnostic.  Duplicate
	`filename` string, then free it on all paths out of function.

	Fixes <https://savannah.gnu.org/bugs/?63214>.

2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Add more tests.

	* src/preproc/tbl/tests/boxes-and-vertical-rules.sh:
	* src/preproc/tbl/tests/expand-region-option-works.sh:
	* src/preproc/tbl/tests/x-column-modifier-works.sh: Do it.

	* src/preproc/tbl/tbl.am (tbl_TESTS): Run tests.
	(tbl_XFAIL_TESTS): Add; future changes will resolve these.

2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::compute_column_positions):
	If a table has "left separation" (it is boxed, or has a vertical
	rule on the left-hand side), increase the first column's start
	register value by 1n, for symmetry with the right-hand size.

	* src/preproc/tbl/tests/check-horizontal-line-length.sh:
	* src/preproc/tbl/tests/check-line-intersections.sh:
	* src/preproc/tbl/tests/check-vertical-line-length.sh: Update
	output expectations.

	* src/preproc/tbl/tbl.am (tbl_XFAIL_TESTS): Remove now-passing
	test.

	See <https://savannah.gnu.org/bugs/?61597> for background.

2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::compute_total_separation):
	Trivially refactor; rename loop indices so it's obvious which
	dimension of a matrix they're referring to.

2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::determine_row_type)
	(table::compute_widths, table::do_row): Boolify some local ints.

2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Refactor handling of vertical lines in format.  Validate
	input more strictly.  Add diagnostics when vertical lines are
	redundant with box borders.

	* src/preproc/tbl/main.cpp (process_format): Shift diagnostic
	about excess vertical lines in a sequence at the beginning of a
	row description to later, after the first proper column
	descriptor has been interpreted.  Normalize a sequence of more
	than two consecutive vertical lines to 2 when they occur at the
	beginning of a row description.  Unconditionally update
	`list->vline` and reset `vline_count` once we start looking for
	modifiers, since we know we've finished any sequence of vertical
	lines, and at the end of a row definition.  Rename and retype
	loop variable int `success` to Boolean
	`is_valid_modifier_sequence`.  Drop now-invalid assertion.
	* src/preproc/tbl/table.cpp (table::add_vlines): Throw new
	diagnostics when vertical lines are redundant with box borders.
	Add assertion to ensure we got a valid vertical line value (0,
	1, or 2) from `process_format`.  Throw these only once per table
	format, not for every row.

2023-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (process_table): Trivially refactor.
	Rename `form` to `fmt` to imply "format", not "form".

2023-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (process_format): Throw error
	diagnostic if more than 2 vertical lines are specified at the
	beginning of a row definition.

	Fixes <https://savannah.gnu.org/bugs/?63731>.

2023-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (process_format): Recast diagnostic
	message to refer to character by its Unicode name and generalize
	to accurately cover additional circumstance of excess '|'
	symbols at end of row definition.

2023-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/ms.ms: Remove redundant initializations.

2023-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/ms.ms: Define appropriate hyphen-minus mapping on 'cp1047'
	output device.

2023-01-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (TE): Enable no-space mode after outputting the
	display distance vertically, replacing any inter-paragraph
	distance that might follow.

2023-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix misleading diagnostic message.

	* src/preproc/html/pre-html.cpp (main): The suggestion should be
	to re-run the formatter (groff, troff), not "pre-grohtml", with
	a different output driver since the document may be malformed.

2023-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (process_format): Fix code hygiene
	nit: nullify `list` pointer after freeing its target.

2023-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Really fix Savannah #63449.

	* src/preproc/tbl/main.cpp (process_format): "Or" on the
	`HAS_TOP_VLINE` flag if the format specification begins with a
	"|"; the beginning is a separate state in the FSM used to parse
	the description.  I missed it in commit 0e93ab4102, 1 December.

	Fixes <https://savannah.gnu.org/bugs/?63449>.

2023-01-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/tests/\
	do-not-overdraw-page-top-in-nroff-mode.sh: Correct erroneous
	check of test output, and add two more test cases.

2023-01-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Move the saving of the hyphenation mode from
	the "top level" to...
	(mY): ...this new macro.
	(SY, mQ, MR): Call `mY` before disabling hyphenation.

	Problem introduced by me in commit 096c2f0567, 16 February.
	"an-ext.tmac" gets sourced by "an.tmac" before any
	command-line setting of the `HY` register is handled, so (for
	groff) the stored hyphenation mode was the default for the
	language, not reflecting user disablement.  The synopsis macros,
	which do not have an alternate implementation in "an.tmac" for
	leverage of groff features, were causing hyphenation to be
	resurrected (after `YS`) even if the user had disabled it.
	Saving the hyphenation mode anew upon entry to these macros is
	arguably inefficient, but it is more correct since a man page
	could conceivably manipulate the automatic hyphenation mode
	{even if that's not recommended outside of tbl(1) text blocks}.

2023-01-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add regression test for hyphenation getting wrongly
	restored by `YS`, `ME`, `UE`, and `MR` macros.

	* tmac/tests/an_HY-register-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (Sh, Ss): Narrow scope of font remappings
	lexically and restrict remapping to the heading font family (if
	any) to avoid undesired remapping of fonts in page headers if,
	say, a (sub)section heading begins just prior to a page
	break--which is ugly anyway and should be avoided, but the
	package has no keep macros and solving that problem in an
	automatic way promises to be complex.

2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (MT, UR): Throw style warning if macro called
	without (exactly one) argument.

2022-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/groff-man-pages.pdf): Set (sub)section
	headings in Helvetica bold in compiled man pages, as a test and
	demonstration of the `HF` feature's application to both man(7)
	and mdoc(7) documents.

2022-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `HF` string.

	* tmac/doc.tmac (initialization): Add logic supporting `HF`
	string just as our man(7) implementation does.  If the font name
	ends with `B` (as the default does), set
	`doc-remap-I-style-in-headings` register and extract font
	family, which can be empty (as is the default).
	* tmac/mdoc/doc-common (Sh, Ss): If
	`doc-remap-I-style-in-headings` register set, perform (and
	unwind) font remapping of italic to bold-italic face.
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Define `doc-Sh-font` in terms of `HF`.

	* tmac/tests/doc_heading-font-remapping-works.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	* tmac/groff_mdoc.7.man (Options): Document it.
	* NEWS: Update item.

	Fixes last part of <https://savannah.gnu.org/bugs/?63046>.

2022-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Revise "fallback" character definitions in several
	respects for Unicode characters from General Punctuation block.

	* tmac/fallbacks.tmac: Comment out fallbacks for U+200B, U+2010,
	U+2011, and U+201[89CD], due to ineffectuality or apparent groff
	bugs.  Redefine U+2012 fallback to include hair space (\^)
	around synthetic figure dash.  Redefine U+2016 to use `\[ba]`
	special characters instead of ordinary `|` characters to dodge
	possible character translations by user.

	Fixes part of <https://savannah.gnu.org/bugs/?63354>.  Thanks to
	Dave Kemper for the (multifarious) discussion.

2022-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Invoking groff, Built-in Registers):
	* man/groff.7.man (Writable predefined registers):
	* src/roff/groff/groff.1.man (Environment):
	* src/roff/troff/troff.1.man (Environment): Replace erroneous
	reference to ctime(3) with localtime(3).

	Fixes <https://savannah.gnu.org/bugs/?63509>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-12-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Fix potential problem(s) in trap handler.

	* src/roff/groff/tests/smoke-test_html_device.sh: Move call of
	`cleanup` function from end of script to after the tests that
	generate temporary files have been run, and before script
	possibly exits with status 77 to skip some checks.  Within trap
	handler, mask trapped signals while running handler.
	(cleanup): Reset trap dispositions to default after removing
	files; once the temporary files are gone, we no longer need a
	trap handler.  One might already be running however, and this
	ensures that its "suicide" ("kill -s INT $$") will succeed.

2022-12-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `FT` register.

	* tmac/doc.tmac (initialization): Add logic supporting `FT`
	register just as our man(7) implementation does.
	* tmac/mdoc/doc-common (doc-set-up-titles): Plant footer trap in
	validated user-requested location.
	* tmac/groff_mdoc.7.man (Options): Document it.
	* NEWS: Update item.

	Fixes part of <https://savannah.gnu.org/bugs/?63046>.

2022-12-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Fix code style nit: use `as` requests to
	avoid overlong input lines.

2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac: Inform user we're ignoring their "-rD1" setting
	if also formatting HTML; parallels groff man(7) behavior.

2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac: Trivially refactor.  Relocate handling of `D`
	command-line register to prepare for greater synchronization
	with groff man(7).

2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp: Trivially refactor.  Rename
	{portion of} internal register to include an interword hyphen
	for readability.

2022-12-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Change default line length to 6.5 inches.

	* tmac/s.tmac (par@load-init): Do it.

	* doc/groff.texi (ms Document Control Settings):
	* doc/ms.ms (Document control settings):
	* tmac/groff_ms.7.man (Document control settings): Document it.

	* tmac/tests/s_honor-MINGW-when-two-columns.sh:
	* tmac/tests/s_mark-column-start-correctly.sh: Update test
	expectations.

	* NEWS: Add item.

2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TH): Relocate `an-break-body-text` trap to be
	one half-inch above footer (instead of twice the footer
	distance).  I reason that anyone who customizes `FT` is doing so
	to overprint some kind of material at the bottoms of pages, or
	simply to make the margin larger.  (One then wonders why we
	don't have an `HD` register for the top.)  Also remove register
	when done with it.
	* tmac/groff_man.7.man.in (Options) <FT>: Document this.

2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TH): Trivially refactor.  Rename
	`an-footer-location` to `an*footer-location` and set page traps
	in order descending the page.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `X` register.

	* tmac/doc.tmac (initialization): Add logic supporting `X`
	register just as our man(7) implementation does.
	* tmac/groff_mdoc.7.man (Options): Document it.
	* NEWS: Update item.

	Fixes part of <https://savannah.gnu.org/bugs/?63046>.

2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Add unit test for `X` register.

	* tmac/tests/doc_X-register-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac (Nm): Fix `if` -> `ie` typo/thinko.

	Fixes <https://savannah.gnu.org/bugs/?63527>.  Thanks to John
	Gardner for the report.

2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/doc_Nm-works.sh: Add more checks.

2022-12-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/smoke-test_html_device.sh: Add checks for
	inlining of images when tbl(1) or eqn(1) used.

2022-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac (reload-man): Unplant `doc-break-body-text`
	trap, added in commit 892703b17e, 6 September.  Its survival
	into man(7) pages didn't seem to cause any problems but I have
	no confidence that will remain true forever.

2022-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (initialization): Fix problem with `FT` register
	validation.  Small but valid values were being rejected due to
	inappropriate use of scaling operator.  Also throw user a bone
	by expressing what size '1v' is for the output device, in basic
	units.

2022-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man, mdoc]: Fix Savannah #63500.  Support use of `P` (initial
	page number) register when batch rendering, regardless of
	switching macro packages between man(7) and mdoc(7) or setting
	of `C` (continuous numbering) register.  (`P` without `C` means
	"start numbering each rendered document at \n[P]".)

	* tmac/an.tmac (an-end): Call `an*break-page-with-new-number`
	instead of invoking `bp`.
	(an*break-page-with-new-number): If `P` is set and `C` is not,
	use value of `P` as the next page number.
	(TH): If `C` register is set, remove `P` register after ending a
	previous document.
	(initialization): If `P` is set, assign the page number using
	the `pn` request if the transition to the first formatted page
	has not yet occurred; otherwise update page number register `%`
	directly.  Also ignore it with diagnostic if `ps4html` register
	{for grohtml's internal use} is set.  Add explanatory comment.

	* tmac/mdoc/doc-common (Dd): If `C` register is set, remove `P`
	register after ending a previous document.
	(doc-end-macro): Call `doc-break-page-with-new-number` instead
	of invoking `bp`.
	(doc-break-page-with-new-number): If `P` is set and `C` is not,
	use value of `P` as the next page number.
	* tmac/doc.tmac (initialization): If `P` is set, assign the page
	number using the `pn` request if the transition to the first
	formatted page has not yet occurred; otherwise update page
	number register `%` directly.  Also ignore it with diagnostic if
	`ps4html` register (for grohtml's internal use) is set.  Add
	explanatory comment.

	Fixes <https://savannah.gnu.org/bugs/?63500>.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `P` register.

	* tmac/doc.tmac (initialization): Add logic supporting `P`
	register just as our man(7) implementation does.
	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
	nroff): Document it.
	* NEWS: Update item.

	Fixes part of <https://savannah.gnu.org/bugs/?63046>.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Add unit tests for man/mdoc `P` register.

	* tmac/tests/an_P-register-works.sh:
	* tmac/tests/andoc_P-register-works.sh:
	* tmac/tests/doc_P-register-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run tests.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man, mdoc]: Refactor.  Rename a Boolean register to more
	clearly communicate its purpose.  This also reverses its sense.

	* tmac/an.tmac (TH): Rename `an-is-first-page-of-document` to
	`an*need-titles-reset`.  Drop redundant store.  Reverse sense of
	test.
	(initialization): Initialize it to zero.

	* tmac/mdoc/doc-common (Dd): Rename
	`doc-is-first-page-of-document` to `doc-need-titles-reset`.
	Drop redundant store.  Reverse sense of test.
	(initialization): Initialize it to zero.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Add future regression test for header/footer
	mishandling that wasn't already covered (not a live bug; was
	exposed by attempted refactoring).

	* tmac/tests/andoc_check-an-to-doc-transition.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man, mdoc]: Trivially refactor.

	* tmac/an.tmac (an-start-new-document): Rename this...
	(an*break-page-with-new-number): ...to reflect its reduced
	responsibility.

	* tmac/mdoc/doc-common (doc-start-new-document): Rename this...
	(doc-break-page-with-new-number): ...to reflect its reduced
	responsibility.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man, mdoc]: Refactor to separate page number management from
	header trap management.

	* tmac/an.tmac (an-start-new-document): Stop removing
	`an-header` trap.
	(TH): Clear the trap here even if not continuously rendering,
	and call `an-start-new-document`.

	* tmac/mdoc/doc-common (doc-start-new-document): Stop removing
	`doc-header` trap.
	(Dd): Clear the trap here even if not continuously rendering,
	and call `doc-start-new-document`.

2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common: Refactor for better parallelism with our
	man(7) implementation and to prepare for a synchronized change
	to both.
	(Dd): Move open-coded (inlined) operations from here...
	(doc-start-new-document): ...to this new macro.
	(doc-end-macro): Drop unnecessary register assignment.  `Dd`
	takes care of it if there is a subsequent mdoc(7) document.

2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix off-by-one error in generated diagnostic message.

	* src/preproc/tbl/table.cpp: Define new preprocessor macro,
	`PREVIOUS_PAGE_REG`.
	(table::init_output): Compute value for register named using
	`PREVIOUS_PAGE_REG`, use it in diagnostic, and then remove it.
	Also fix verb tense in message.

2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Expose the fact of a table's boxedness via a troff
	register so that macro packages can make more intelligent
	decisions about space requirements (since box borders occupy
	significant space on nroff devices).

	* src/preproc/tbl/table.cpp: Define new preprocessor macro,
	`IS_BOXED_REG`.
	(table::do_top): Initialize "boxedness" register.

2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (TH): Clarify computation and diagnostic message.

2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix Savannah #61878.

	* src/preproc/tbl/table.cpp: Define new preprocessor macro,
	`STARTING_PAGE_REG`.
	(table::define_bottom_macro): Have the formatter issue a warning
	if an unkept, boxed table ends on a different page than it
	began.
	(table::do_top): Save current page number when table begins.

	Fixes <https://savannah.gnu.org/bugs/?61878>.

2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #61878.

	* src/preproc/tbl/tests/\
	warn-on-long-boxed-unkept-table.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp: Write comments to generated output;
	these correspond to functions in this file and to major
	operations of table construction.
	(init_output, compute_widths, define_bottom_macro, do_row)
	(do_top, do_bottom): Do it.

2022-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Trivially refactor.  Rename class `constant_int_reg` to
	`readonly_register`.  Say "readonly" instead of "const" to
	try to avoid confusion with C++ constness.  Drop "int" because
	integer-valued registers are the norm, not the exception.

	* src/roff/troff/column.cpp (init_column_requests):
	* src/roff/troff/div.cpp (init_div_requests):
	* src/roff/troff/input.cpp (top level, init_input_requests):
	* src/roff/troff/node.cpp (init_node_requests):
	* src/roff/troff/reg.h: Do it.

2022-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Trivially refactor.  Rename class `constant_reg` to
	`readonly_text_register`.  Say "readonly" instead of "const" to
	try to avoid confusion with C++ constness.  Say "text" because
	this class is _mostly_ used for interpolation of string-valued
	registers like the version registers `.x`, `.y` and `.Y`.
	Nevertheless there are some abuses (apparently because the
	constructors for register classes don't accept integer
	parameters for initialization--why?).

	* src/roff/troff/input.cpp (top level)
	(readonly_text_register::readonly_text_register)
	(readonly_text_register::get_string)
	(main, init_registers, init_requests): Do it.

2022-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Trivially refactor.  Rename `number_reg_dictionary` to
	`register_dictionary`.  It's shorter _and_ non-abbreviated _and_
	matches our documentation.

	* src/roff/troff/column.cpp (init_column_requests):
	* src/roff/troff/div.cpp (page_number, init_div_requests):
	* src/roff/troff/env.cpp (print_env, init_env_requests)
	(init_hyphen_requests):
	* src/roff/troff/input.cpp (length_request)
	(interpolate_number_format, do_register, do_if_request, main)
	(init_registers, init_input_requests):
	* src/roff/troff/node.cpp (get_register, init_node_requests):
	* src/roff/troff/reg.cpp (top level, define_number_reg)
	(inline_define_reg, alter_format, remove_reg, alias_reg)
	(rename_reg, print_number_regs):
	* src/roff/troff/reg.h: Do it.

2022-12-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add regression test.

	* tmac/tests/an_link-trailing-text-hugs-previous.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/fallbacks.tmac: Really use troff-mode fallbacks only on
	typesetting devices; because this macro file is loaded so early,
	we cannot rely on ".if t".  Thanks to Dave Kemper for the
	discussion in Savannah #63354.

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Use more mnemonic register names, thanks to
	the recent freeing up of some name space.
	- mJ -> mH: saved automatic hyphenation mode
	- mX -> mE: formatting in EX/EE context (Boolean)

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdf.tmac: Drop deletion of unused string `PDFHREF.TEXT`.

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (an-end, AT, UC, DT, PD, SH, IP, BI, BR, IB, IR)
	(RB, RI, OP, an*end-hyperlink, MR): Refactor; "nop"ify macros
	that produce formatted output or call other macros using string
	interpolations--except where we can't: see Savannah #63470.

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (R): Drop macro definition, which implements a
	hack for people who try to use "R" as a font style macro.  This
	doesn't seem to happen much in actual practice (though perhaps
	the diagnostic this hack produces is responsible for suppression
	of the mistake).  Retaining it interferes with the
	"nop"-ification of this macro file.
	* NEWS: Add item.

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Use truly traditional hyphenation mode on
	non-groff-compatible formatters.

2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Update test coverage and expectations.

	* tmac/tests/an_ME-punct-hyphenates.sh: Test both "an.tmac" and
	"an-ext.tmac" implementations of `ME`.
	* tmac/tests/an_UE-punct-hyphenates.sh: Test both "an.tmac" and
	"an-ext.tmac" implementations of `UE`.
	* tmac/tests/an_UE-breaks-before-long-URIs.sh: Update test
	expectations.  I appear to have inadvertently fixed some
	inelegant rendering.

2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Rename to reflect code reorganization.

	* tmac/tests/an-ext_ME-punct-hyphenates.sh:
	* tmac/tests/an-ext_MT-body-hyphenates.sh:
	* tmac/tests/an-ext_UE-breaks-before-long-URIs.sh:
	* tmac/tests/an-ext_UE-punct-hyphenates.sh:
	* tmac/tests/an-ext_UR-body-hyphenates.sh: Rename these...
	* tmac/tests/an_ME-punct-hyphenates.sh:
	* tmac/tests/an_MT-body-hyphenates.sh:
	* tmac/tests/an_UE-breaks-before-long-URIs.sh:
	* tmac/tests/an_UE-punct-hyphenates.sh:
	* tmac/tests/an_UR-body-hyphenates.sh: ...to these.

	* tmac/tmac.am (tmac_TESTS): Reflect renames.

2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Remove groff-feature-dependent code for
	hyperlink management, greatly reducing the size of the file,
	which we permissively license and encourage people to copy
	around.  Drop register definitions corresponding to
	groff-specific output device names.  Drop definition and use of
	`mL` and `mR` strings for angle brackets; no observable change
	on non-groff formatters.  Recognize `mG` register to enable
	testing of these macros even if the formatter is groff.
	(mV): Radically simplify.  This internal "back-end" for `MT` and
	`UR` now just stores its argument in a string, `m1`.
	(mQ): Radically simplify.  This internal "back-end" for `ME` and
	`UE` now just disables automatic hyphenation, formats the saved
	`m1` string between angle brackets, suffixes it with the
	optional argument, and restores automatic hyphenation.
	(UR, MT): Call `mV` with one argument, not nine.
	(UE, ME): Call `mQ` with one argument, not nine.

	* tmac/tests/an-ext_MR-works.sh: Add test of this file's
	simplified `MR` implementation.
	* tmac/tests/an-ext_MT-works.sh:
	* tmac/tests/an-ext_UR-works.sh: Move tests of groff-specific
	hyperlink output from here...
	* tmac/tests/an_MT-works.sh:
	* tmac/tests/an_UR-works.sh: ...to these new files.
	* tmac/tests/an_MR-works.sh:
	* tmac/tests/an_MT-works.sh:
	* tmac/tests/an_UR-works.sh: Add tests for valid HTML formatting
	of hyperlinks, which experience shows is a bit fragile in the
	face of diversion manipulation and output line continuation.

	* tmac/tmac.am (tmac_TESTS): Run new tests.

2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Support `mG` register: clear it to force the
	loading of this file's macros even if they have an
	implementation in tmac/an.tmac and the formatter claims groff
	compatibility.  This is to ease these macros' testing under
	groff and keep the implementations here simple.
	* tmac/an.tmac: Initialize `mG` register to 1 if not set on
	command line.

2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Initialize `mX` register.

2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Define `mC` string (constant-width typeface
	used by `EX`/`EE` macros) as `R` in nroff mode.  Thanks to
	Russ Allbery for prompting me to think more about the
	limitations of Solaris troff.  Implementations do varying
	things with the "previous" font restored by `\fP` or an
	unargumented `.ft` if a requested font is not found.

2022-11-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix Savannah #63449.

	* src/preproc/tbl/table.h (class table): Add new enumeration
	constants for use with `flags` member variable: `HAS_TOP_VLINE`
	and `HAS_TOP_HLINE`, which track properties of the table.
	Unlike others, these have no correspondence to table region
	options.
	* src/preproc/tbl/main.cpp (process_format): Add new local
	Boolean to track whether we're interpreting a format for the
	first row.  Use this to "or" on the `HAS_TOP_VLINE` or
	`HAS_TOP_HLINE` flags if "|" or [_-] are encountered in the
	first row's format, as appropriate.
	(process_data): "Or" on `HAS_TOP_HLINE` if a single or double
	horizontal line is used as the first row's data.
	* src/preproc/tbl/table.cpp (do_top): On nroff mode devices, add
	one vee of space above the table if we're going to be drawing an
	unintersected vertical rule above the table's top.

	Fixes <https://savannah.gnu.org/bugs/?63449>.

2022-11-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #63449.

	* src/preproc/tbl/tests/\
	do-not-overdraw-page-top-in-nroff-mode.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (struct input_entry_format)
	(input_entry_format::input_entry_format)
	free_input_entry_format_list, process_format): Trivially
	refactor.  Rename `pre_vline` to `vline_count`.

2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp
	(vertical_rule::contribute_to_bottom_macro, table::print)
	(table::init_output, table::divide_span)
	(table::compute_expand_width, table::define_bottom_macro)
	(table::do_bottom): Produce roff output that is more readable,
	for maintainability.  Indent control lines inside macro
	definitions.  Standardize form of `if`, `ie`, and `el` requests.
	Some output will not be indented because it is produced within
	narrowly-scoped C++ functions (set_troff_location,
	table::print_single_hline, table::print_double_hline,
	table::do_row), I haven't verified that each one is called from
	a consistent troff indentation level, and I'm not sure it's a
	win to parameterize those functions in the indentation level.

2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix Savannah #61909.

	* src/preproc/tbl/table.cpp (SAVED_INTER_WORD_SPACE_SIZE)
	(SAVED_INTER_SENTENCE_SPACE_SIZE): Add new preprocessor macros.
	(block_entry::do_divert): Restore saved inter-word and
	inter-sentence space when formatting a text entry.
	(table::init_output): When a table region begions, save the
	values of inter-word and inter-sentence space.  Add request to
	the reset macro to restore saved inter-word and inter-sentence
	space when leaving table region.
	(table::do_top): Set inter-sentence space to be equal to
	inter-word space.  This way spaces are "literal" in ordinary
	table extries (but not text blocks).

	Fixes <https://savannah.gnu.org/bugs/?61909>.

2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #61909.

	* src/preproc/tbl/tests/\
	save-and-restore-inter-sentence-space.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Suppress line numbering when formatting tables, and
	restore it afterward.

	* src/preproc/tbl/table.cpp: Revert much of commit b69062693's
	{2011-07-20} changes to this file.  They were too complex for me
	to understand, and permitted Savannah #60140 to persist (or
	caused it).
	(ROW_START_LINE_REG, ROW_SAVE_LINE_REG, ROW_MAX_LINE_REG)
	(REPEATED_NM_SET_MACRO, REPEATED_NM_SUS_MACRO): Drop
	preprocessor macros.
	(SAVED_NUMBERING_LINENO, SAVED_NUMBERING_SUPPRESSION_COUNT): Add
	new preprocessor macros.
	(table::init_output, table::print_single_hline)
	(table::print_double_hline, table::define_bottom_macro)
	(table::do_row, table::do_top, table::do_bottom): Drop old
	logic.

	(table::init_output): When the table begins, save the current
	line number register `ln` and the count of remaining lines to be
	suppressed (the new `.nn` register).  Then suppress numbering
	for the next 2 billion+ lines of output, with a groveling
	apology to the elegance police.
	(table::do_bottom): Restore saved value of `.nn`.  If numbering
	was active (even if suppressed), restore it with `nm` request.
	If it wasn't, disable it, in case it was turned on inside the
	table region.

	Fixes <https://savannah.gnu.org/bugs/?60140>.  Thanks to Hans
	Bezemer for noting the practical significance of this bug.

2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #60140.

	* src/preproc/tbl/tests/save-and-restore-line-numbering.sh: Do
	it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-11-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Implement new `.nn` register to report the remaining
	count of lines to have their numbering suppressed.

	* src/roff/troff/env.h (class environment): Declare new member
	function `get_no_number_count()`.
	* src/roff/troff/env.cpp (get_no_number_count): Define new
	member function, returning value of member variable
	`no_number_count`.
	(init_env_requests): Define new ".nn" register and attach it to
	`get_no_number_count()`.

	* doc/groff.texi (Miscellaneous): Document it.  Include example
	of use to determine whether current output line will be
	numbered.  Also clarify meaning of register; `.nn` is not
	decremented except when output line numbering is enabled.
	* man/groff.7.man (Read-only registers): Document it.

	* src/roff/groff/tests/dot-nn_register_works.sh: Test it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	* NEWS: Add item.

	See <https://lists.gnu.org/archive/html/groff/2022-11/\
	msg00153.html>.

2022-11-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/fallbacks.tmac: Comment out four of the fallback
	character definitions for (preconv'd) Unicode character input
	added to address Savannah #58930 (corresponding to \[dg], \[dd],
	\[%0], and \[rn]; they are failing for not yet understood
	reasons involving "macros" attached to groff character info
	structs, and the semantics of what it means for a character to
	"exist" per the 'c' conditional operator.  Fixes regression when
	using "tty-char.tmac" (which nroff loads by default).  Problem
	introduced by me in commit 132182bd71, 23 October.  The hope is
	to resolve this issue post-groff 1.23.0.  Thanks to Dave Kemper
	for the report and discussion in Savannah #63332.

2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (SY, YS, mV): Remove `mA`, `mI`, and `mT`
	registers when done with them.

2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/node.h (character_exists):
	* src/roff/troff/node.cpp (character_exists): Boolify.

2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[doc]: Add make(1) dependency.

	* doc/doc.am (doc/groff-man-pages.pdf): Add dependency on our
	FreeEuro font since we embed it.

2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Refactor generation of "freeeuro.pfa" to make more
	economical use of existing infrastructure, per a suggestion from
	Deri James.  This also puts the file where gropdf's "download"
	file can find it when running it in a separate build directory.
	We use it to generate "groff-man-pages.pdf".

	* font/devps/freeeuro.pfa: Rename this...
	* font/devps/freeeuro.ps: ...to this.  We can now use the suffix
	rule that also applies to "symbolsl.ps" and "zapfdr.ps".

	* font/devps/devps.am (DEVPSFONTFILES): Move "freeeuro.pfa" from
	here...
	(DEVPSFONTFILES_GENERATED): ...to here.
	(EXTRA_DIST): Ship the "new" "freeeuro.ps" file.

2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devps/psstrip.sed: Stop stripping comment lines in
	general instead of preserving only ones that use the form in the
	Document Structuring Conventions.  This way we won't strip
	copyright notices, like Werner Lemberg's in the FreeEuro font.
	Thanks to Deri James for pointing this out.

2022-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	tmac/an-ext.tmac: Refactor to reduce code size.

	* tmac/an-ext.tmac: Refactor to reduce code size.  `UE` and `ME`
	have nearly identical implementations so...

	(mQ): Define new macro to perform the requisite actions, and...

	(UE, ME): Make these into wrappers calling mQ.

2022-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add unit tests for `MT/ME` and `UR/UE`.

	* tmac/tests/an-ext_MT-works.sh:
	* tmac/tests/an-ext_UR-works.sh: Do it.

	* tmac/tmac.am (tmac_TESTS): Run tests.

2022-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl: Throw warning if paper format is
	unrecognized.

2022-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (Msg): Align more closely with
	diagnostic message format prescribed by GNU Coding Standards:
	emit space (only) prior to message severity.

2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/meref.me.in: Drop unnecessary initialization parameters
	from document.  The line and title length do not need to be set
	in troff mode; the document lays out fine for a variety of paper
	formats if these are not forced to 6.5 inches.  Also drop
	redundant initialization of `pp` register.

2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Fix Savannah #63377.

	* tmac/doc.tmac (Nm): Properly leverage new
	`doc-in-name-section` variable.  Set page topic `doc-topic-name`
	to the first encountered argumentful `Nm` call in the "Name"
	section while handling other "Name" section concerns, instead of
	later after deciding we're not in the "Synopsis" section.
	Problem caused by me when fixing antediluvian mdoc bug in commit
	0d85615c62, 5 November.

	Fixes <https://savannah.gnu.org/bugs/?63377>.  Thanks to John
	Gardner for the report.

2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Add tests for `Nm` macro.

	* tmac/tests/doc_Nm-works.sh: Do it.  Test regression reported
	in Savannah #63377.  Also ensure that we handle the case where
	multiple `Nm` items are declared in the "Name" section (as might
	happen in library man pages).
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/papersize.tmac: Improve integration with mm(7) macro
	package.  If a paper format has been selected, set `W` register
	to new line length (if not already set on command line).
	Similarly, set `O` register to 1 inch for the symmetric
	horizontal margins otherwise assumed by this macro file.  This
	means that "groff -mm" and "groff -dpaper=letter -mm" are _not_
	synonymous (when groff is configured to use U.S. letter as the
	default paper format), because groff mm(7) uses a page offset of
	0.963 inches on typesetters for compatibility with DWB mm.
	* NEWS: Add item.

	See discussion in <https://lists.gnu.org/archive/html/\
	groff/2022-11/msg00081.html> and (some) follow-ups.

2022-11-16  Deri James  <deri@chuzzlewit.myzen.co.uk>

	* src/devices/gropdf/gropdf.pl: If the argument to the paper
	format option '-p' matches a recognized format but includes a
	trailing 'L' or 'l' ("legalL" or "a4l", for example), rotate the
	document's MediaBox.

2022-11-16  Deri James  <deri@chuzzlewit.myzen.co.uk>

	* src/devices/gropdf/gropdf.pl: Fix incorrect hotspot placement
	if page is in landscape orientation.
	(FixRect): Perform coordinate transform if page is rotated.
	(Rotate): New function performs relevant trigonometry.

	Fixes <https://savannah.gnu.org/bugs/?63380>.  Thanks to Blake
	McBride for the report.

2022-11-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Integrate better with papersize.tmac by no longer
	forcing line (and title) length to 6 inches for typesetters on
	initialization.  Gather default line length from output device
	description, possibly modified later (by other macro file or
	input).  No change to terminal ("nroff mode") output.
	* NEWS: Add item.

2022-11-16  Peter Schaffter <peter@schaffter.ca>

	* tmac/papersize.tmac: If a paper format has been selected,
	smuggle right margin setting to mom(7) if not overridden by the
	user.  See discussion in <https://lists.gnu.org/archive/html/\
	groff/2022-11/msg00081.html> and (some) follow-ups.

2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/groff-man-pages.pdf)
	(doc/groff-man-pages.utf8.txt): Add dependencies on new
	`TMAC_PACKAGE_MAN` and `TMAC_PACKAGE_MDOC` convenience macros.

2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am (TMAC_PACKAGE_MAN, TMAC_PACKAGE_MDOC): Define
	convenience macros for in-tree documents to depend on.

2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Trivially refactor.  Rename `an-section` to
	`an*section`.

2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grolbp/lbp.cpp (usage): Tweak usage message.  The
	output driver should be perfectly capable of handling output
	from non-GNU (but device-independent) troffs.

2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/ps.cpp (usage): Employ more informative
	metasyntactic variable names in usage message.  Also summarize
	program's function and direct reader to man page if help
	explicitly requested (inferred from identity of output stream).

2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Trivially refactor for congruence with
	documentary terminology.  Rename strings and macros.
	- an-title                 -> an*topic
	- an-abbreviate-page-title -> an*abbreviate-page-topic
	- an-title-abbv            -> an*topic-abbv
	- an-title-string          -> an*topic-string
	- an-title-length          -> an*topic-length
	- an-title-length-prev     -> an*topic-length-prev
	- an-title-new-length      -> an*topic-new-length
	- an-page-title-style      -> an*topic-style
	(TH): Recast diagnostic message to refer to "section", not
	"volume" title.

2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Refactor to reduce code size.  `UR` and `MT`
	have identical implementations so...
	(mV): Define new macro to perform the requisite actions, and...
	(UR, MT): Make these into wrappers calling mV.

2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (UR, MT): Fix problem with incorrect line
	lengths and occasional "can't adjust" warnings when using
	hyperlinks.  Reduce the line length within the diversion by the
	amount of indentation used in the context.  Without this, lines
	were getting set too short.  (You might think they'd be too
	long, but when creating a new environment, the _formatter's_
	default line length is used; that's 65n on terminal devices.)

2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add test to ensure that link text (when the hyperlink
	itself is not formatted because the device supports
	hyperlinking) uses the correct line length and is adjusted.

	* tmac/tests/an_adjust-link-text-correctly.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run tests.

2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am: Refactor.
	(MOSTLYCLEANFILES): Populate macro incrementally, adjacent to
	the targets that build the files to be cleaned.  This will
	enable cleaner refactoring in the future.
	(DEFAULT_BASE35_FONTS): Add new macro storing the targets of the
	PostScript Level 2 standard base 35 font descriptions.
	(devpdffont_DATA): Populate using `DEFAULT_BASE35_FONTS`.
	(URW_BASE35_FONTS): Add new macro, empty if [!HAVE_URW_FONTS];
	and [HAVE_URW_FONTS] otherwise naming the `U` foundry font
	description counterparts of the `DEFAULT_BASE35_FONTS`.
	(devpdffont_DATA): Append `URW_BASE35_FONTS`.
	($(DEFAULT_BASE35_FONTS) $(URW_BASE35_FONTS)): Assert dependency
	on "font/devpdf/download".  This isn't literally true, but
	BuildFoundries generates all of these together, so if the
	"font/devpdf/download" target rule runs successfully, the font
	description files named in these macro expansions will be
	generated too.

2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Add new command-line option to
	specify the generated font description's "spacewidth" parameter;
	in commit bf7f6862c3, 2021-09-24, I made libgroff complain if
	this directive is missing (since any font, even a "special" one,
	can be selected as current and the formatter's behavior when
	encountering an input space should be well-defined under that
	circumstance).  Adding this option enables a well-formed font
	description to be produced.
	* src/utils/afmtodit/afmtodit.pl (usage):
	* src/utils/afmtodit/afmtodit.1.man (Synopsis, Options):
	Document it.
	* NEWS: Add item.

2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Use our own fatal exit
	function instead of Perl's "die".
	(croak): New subroutine emits argument as part of diagnostic
	message and exits with status 1.
	(usage): Exit with status 2, not 1, on usage errors.

	* NEWS: Document new exit behavior.

2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am (font/devpdf/download): Improve
	comprehensibility of comments in generated "download" file.
	Stop bracketing path element separator with spaces.

2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Stop
	capitalizing beginning of diagnostic message (per GNU Coding
	Standards).  Drop ellipsis from end since no further diagnostics
	relevant to that message are expected.  Trim trailing slashes
	from font path elements.

2022-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devps/devps.am: Refactor.  Turn two identical target
	rules into a (BSD-make-style, old-fashioned) pattern rule.

2022-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Rechristen self "GNU roff".

2022-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/pic/pic.ypp: Slightly refactor.  Rename parameter
	`form` (format) to `fmt` to make its nature as an abbreviation
	clear.
	(format_number, do_sprintf): Reorder null pointer equality
	comparisons to avoid inadvertent lvalue assignment.
	(do_sprintf): Declare lists of valid format conversion
	specifiers and modifiers explicitly instead of as happenstance
	literals.  Recast diagnostic messages to refer to "invalid", not
	"bad" input; refer to input keyword correctly as "sprintf" (not
	"snprintf"); and report the identity of the invalid conversion
	specifier we reject.

2022-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac (Fl, doc-flag-recursion, doc-print-recursive)
	(doc-print-prefixes, Ar, Nm, Pa, Xr, doc-do-func, Fn)
	(doc-do-func-args, Fo): Remove now-relic resets of type size to
	previous value.  Since commit 5125754cdf, 23 February, no mdoc
	macro ever changes the type size.

2022-11-08  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Cater for invalid entries in download file.

	* src/devices/gropdf/gropdf.pl: Test if path in the "download"
	file points to a readable file.  Also change order so that the
	first valid entry is used as the font to embed.  This replaces
	previous order where last found entry is used.

	Fixes <https://savannah.gnu.org/bugs/?62950>.

2022-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Set page topic in roman in "Name" section.

	* tmac/doc.tmac (Nm): If in the "Name" section of the page, set
	argument(s) with the `No` (normal formatting) macro instead of
	handling them...normally.  Since `Nm`'s usual behavior is to set
	the next argument in boldface, in this circumstance it is set in
	roman.  Aligns page rendering with man(7) and fixes a bug
	documented in the 4.3BSD-Reno mdoc.samples(7) page (1990-06-22),
	upon which the groff_mdoc(7) page is based.
	* tmac/groff_mdoc.7.man (Bugs): De-document bug.

	Fixes part of <https://savannah.gnu.org/bugs/?62926>.

2022-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common: Add internal register
	`doc-in-name-section` to keep track of whether a macro is called
	within the "Name" section of the document, to prepare a means of
	fixing a long-standing bug with `Nm`.
	(Sh): Canonicalize capitalization of section heading sooner.
	Set or clear `doc-in-name-section` based on result.
	(Rd): Add new register to dump.
	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
	Handle new register.

2022-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Use font CR, not CB, for `Cm` ("command modifier") and
	`Fl` ("flag") macros on typesetters.

	* tmac/mdoc/doc-ditroff (doc-Cm-font, doc-Fl-Font): Switch to
	Courier roman from Courier bold.  This congrues better with
	other `Li` literals, which were not in boldface.

2022-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-nroff (doc-Li-Font): Switch from roman to bold.
	On typesetters, the use of Courier (roman) plainly distinguishes
	unquoted literals from their context.  On terminals there was no
	such visible distinction.  Fortunately, in groff_mdoc(7) itself,
	this does not result in a blinding blitz of boldface because the
	`Ql` (quoted literal) macro is so often used, and it maintains
	the roman style.  This change further aligns groff mdoc(7) with
	groff man(7) style conventions.  (Also see how we handle
	literals for typesetters and terminals in the "ms.ms" document.)

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Make `Sx` macro perform quotation, not italicization.
	It's thorougly inconsistent with English composition practices
	to refer to (sub)section headings within a document as if they
	were major works.

	* tmac/doc.tmac (Sx): Implement.
	* tmac/mdoc/doc-ditroff (doc-Sx-font):
	* tmac/mdoc/doc-nroff (doc-Sx-font): Delete.
	* tmac/groff_mdoc.7.man (Section Cross References): Rename...
	((Sub)section cross references): ...to this.  Recognize
	existence of `Ss` macro, curiously overlooked before.
	* NEWS: Add item.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Drop now-unused `doc-pageref` string.  It was nowhere
	interpolated outside of state management macros.

	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
	* tmac/mdoc/doc-common: Do it.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (doc-header, doc-footer): Revise for
	clarity and to use correct typefaces for titles.
	(doc-header): Add new strings to ease title construction.
	`doc-xref` stores the fully formatted page topic and section
	number, e.g., "troff(1)"; `doc-abbv` stores the its potentially
	abbreviated form when it is too long to fit.
	(doc-footer): Use `doc-xref` as above.  Stop setting the `Os`
	and `Dd` parameters in the ("semantic"?) font used for the
	page's section number (probably unnoticed all these years
	because the font used to render that was (Times) roman).

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac:
	* tmac/mdoc/doc-common: Rename strings for clarity.
	- doc-document-title -> doc-page-topic
	- doc-document-title-saved -> doc-page-topic-saved
	* tmac/mdoc/doc-common: Use new name.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff (doc-page-topic-font):
	* tmac/mdoc/doc-nroff (doc-page-topic-font): Set man page topic
	names in italics.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Rename strings for clarity.
	- doc-caption-font -> doc-page-topic-font
	- doc-caption-font2 -> doc-page-section-font
	* tmac/mdoc/doc-common (doc-header, doc-footer): Use new names.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac: Delete suppression of `Pa` font selection in a
	"Files" section.  This special handling was not documented.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff (doc-Pa-font): Set file specifications
	in italics on typesetters.  (Terminals already use italics.)

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff (doc-Xr-font):
	* tmac/mdoc/doc-nroff (doc-Xr-font): Set man page topic cross
	references in italics.

2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Rename `doc-Tn-font-shape` to
	`doc-Tn-font` for better parallelism with other font selection
	strings for mdoc macros, since the `Tn` macro no longer
	manipulates the type size.
	* tmac/doc.tmac (Tn): Use new name.

2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Debugging): Fix misleading claim.  The
	arguments to the `tm`, `tmc`, and `tm1` requests are not read in
	copy mode.  For example, you don't need to double backslashes to
	get them to interpolate registers or strings.

2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (an-end):
	* tmac/mdoc/doc-common (doc-end-macro): Ensure that document
	footer appears in continuous rendering mode even when a final
	pending output line in the document is 1v from the page bottom.
	Replace `fl` call with `br`, which IMO has clearer semantics.
	Extend page length by 1v before doing so if the current vertical
	position is within 1v of the page bottom.

	Thanks to Alex Colomar for the report.

2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man, mdoc]: Regression-test special case of continuous
	rendering when the last pending output line in the document is
	1v from the (notional) page bottom.

	* tmac/tests/an_output-footer-when-continuously-rendering.sh:
	* tmac/tests/doc_output-footer-when-continuously-rendering.sh:
	Do it.
	* tmac/tmac.am (tmac_TESTS): Run tests.

2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TE): Update diagnostic to mention another
	failure mode: a man page that is simply a `so` request requires
	soelim(1) to be run if the sourced page uses tbl(1).

2022-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/xditview/xditview.am
	($(GXDITVIEW_GROFF_VERSION_H)): Run `$(MKDIR_P)` and `printf` as
	separate rule commands in order to use them with `$(AM_V_at)`
	and `$(AM_V_GEN)`, respectively.  Prevents noise from build.

	Fixes <https://savannah.gnu.org/bugs/?63302>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[eqn]: Fix Savannah #63299.

	* src/preproc/eqn/main.cpp: Revise input file line number
	handling.
	(read_line): Stop dealing with `current_lineno` here; it's now
	up to its caller (`do_file()`) to manipulate the line number.
	(do_file): When reading new file, initialize `current_lineno` to
	1 instead of 0.  Reset it to zero when encountering EOF (so that
	diagnostics will not include a line number at all).  When
	performing nested call to `read_line()` to gather '.EN' from
	input, increment the line number.  Write correct line number in
	output groff `lf` requests; in groff, its first argument assigns
	the number of the _next_ input line.  Increment line number at
	end of outer `read_line()` loop.

	Fixes <https://savannah.gnu.org/bugs/?63299>.  Thanks to Alex
	Colomar for the report.

2022-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[eqn]: Regression-test Savannah #63299.

	* src/preproc/eqn/tests/\
	diagnostics-report-correct-line-numbers.sh: Do it.
	* src/preproc/eqn/eqn.am (eqn_TESTS, TESTS, EXTRA_DIST): Run
	test.

2022-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (fail, warn, construct_command)
	(version): Restore trailing newlines to `print`ed output.  They
	went missing when I removed the assignment of the output record
	separator in commit 6f2e367836, 24 October.  Thanks to Dave
	Kemper for catching this.

2022-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.cpp: Trivially refactor.  Rename
	`default_encoding` to `fallback_encoding` for clarity.  Update
	comments and debugging diagnostic messages accordingly.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grolj4]: Absorb lj4_font(5) man page into grolj4(1).

	* src/devices/grolj4/lj4_font.5.man: Delete, moving content...
	* src/devices/grolj4/grolj4.1.man (Fonts): ...hither.

	* doc/doc.am (GROFF_MAN_PAGES1):
	* src/devices/grolj4/grolj4.am (man5_MANS, EXTRA_DIST): Stop
	formatting and shipping removed page.

	* src/roff/groff/groff.1.man:
	* src/utils/hpftodit/hpftodit.1.man: Drop references to page.

	Fixes <https://savannah.gnu.org/bugs/?61819>.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `SN` register to configure subsection heading
	indentation.

	* tmac/doc.tmac: Recognize `SN` register if set on command line
	and use groff man(7)-compatible default if it is not.
	* tmac/mdoc/doc-common (Ss): Use this register instead of a
	literal.
	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
	nroff): Document it.
	* NEWS: Update item.

	Fixes part of <https://savannah.gnu.org/bugs/?62926>.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `IN` register to configure paragraph
	indentation.

	* tmac/doc.tmac: Recognize `IN` register if set on command line
	and use groff man(7)-compatible defaults if it is not.
	* tmac/mdoc/doc-common (Sh): Use this register instead of
	`doc-paragraph-indentation`.
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Stop setting pargraph indentation
	defaults here.
	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
	nroff): Document it.
	* NEWS: Update item.

	* tmac/tests/doc_Mt-works.sh:
	* tmac/tests/doc_indents-correctly.sh: Update test expectations.

	Fixes part of <https://savannah.gnu.org/bugs/?62926>.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (Sh): Fix code style nit.  Set paragraph
	indentation absolutely rather than incrementally.  mdoc(7)
	doesn't have relative inset macros like man(7)'s `RS`/`RE`, so
	the relative measurement could mislead the reader.  (The
	section heading itself uses an indentation of 0.)

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Fix Debian #1022179.

	* tmac/mdoc/doc-common (Ss): Indent entire subsection heading by
	3 ens, even if it breaks across output lines.  (Change and
	restore indentation explicitly instead of using a temporary
	indent to achieve this.  Also indent absolutely by 3n instead of
	retreating by one quarter inch.)

	Fixes <https://bugs.debian.org/1022179>.  Thanks to наб for the
	report.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/doc_indents-correctly.sh: Add regression test for
	Debian #1022179.

	* tmac/tmac.am (tmac_TESTS): Run test.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Fix misleading register name.

	* tmac/mdoc/doc-common (Sh):
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Rename `doc-subheader-indent` to
	`doc-paragraph-indentation`, because the latter is what it's
	used for.

2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_POPPLER): Improve shell code portability.
	Per the GNU Autoconf manual, "The -a, -o, '(', and ')' operands
	are not present in all implementations, and have been marked
	obsolete by Posix 2008.  ...portable uses of test should never
	have more than four arguments, and scripts should use shell
	constructs like '&&' and '||' instead."

2022-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.cpp: Alter usage message handling.
	(usage): Summarize purpose of program and steer reader to man
	page (only) if help was explicitly requested, and exit
	successfully from here...
	(main): ...instead of calling scope.

2022-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.cpp (usage): Use more
	communicative metasyntactic variable names.
	* src/preproc/preconv/preconv.1.man (Synopsis, Options): Align
	with updated usage message.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp: Alter usage message handling.
	(usage): Summarize purpose of program and steer reader to man
	page (only) if help was explicitly requested, and exit
	successfully from here...
	(main): ...instead of calling scope.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grolbp/lbp.cpp: Alter usage message handling.
	(usage): Summarize purpose of program and steer reader to man
	page (only) if help was explicitly requested, and exit
	successfully from here...
	(main): ...instead of calling scope.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grolbp/lbp.cpp (main): Handle `getopt_long()`
	return value more idiomatically.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grolbp/lbp.cpp: Fix code style nits.
	(main): Use standard C library symbols `EXIT_SUCCESS` and
	`EXIT_FAILURE` instead of integer literals as arguments to
	`exit()`.  Add assertion.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tty.cpp: Alter usage message handling.
	(usage): Summarize purpose of program and steer reader to man
	page (only) if help was explicitly requested, and exit
	successfully from here...
	(main): ...instead of calling scope.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tty.cpp: Fix code style nits.
	(main): Use standard C library symbols `EXIT_SUCCESS` and
	`EXIT_FAILURE` instead of integer literals as arguments to
	`exit()`.  Replace `assert(0)` call with communicative
	predicate.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp: Alter usage message handling.
	(synopsis, help): Coalesce these two functions...
	(usage): ...into this one.  Summarize purpose of program and
	steer reader to man page only if help was explicitly requested,
	rather than blitzing user with text upon a usage error.  Also
	drop option summary from usage message, as it duplicates
	groff(1).

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Alter usage message handling.
	(help): Rename this subroutine...
	(usage): ...to this.  Summarize purpose of program and steer
	reader to man page only if help was explicitly requested, rather
	than blitzing user with text upon a usage error.  Also drop
	option summary from usage message, as it duplicates grog(1).

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Drop relic code and comments.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Migrate expansion of Perl interpreter in shebang.
	Use the same technique as afmtodit, mmroff, gropdf, and pdfmom.

	* src/utils/grog/grog.am (grog): Replace "@PERL@" instead of
	'^\(#! \).*perl'.
	* src/utils/grog/grog.pl: Use "@PERL@" in shebang.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[afmtodit]: Give program a usage message.

	* src/utils/afmtodit/afmtodit.pl: Add new scalar `want_help` of
	Boolean sense.  Recognize new long option `--help`, attached to
	`$want_help`.  Stop stripping off directory name components from
	program name when emitting diagnostics.  No other groff program
	does this (well, gropdf did until recently), and it might save
	users some confusion if they're working with multiple copies of
	afmtodit.
	(usage): New subroutine reports usage message.  If help was
	explicitly requested, summarize purpose of program and steer
	reader to man page.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[afmtodit]: Migrate expansion of Perl interpreter in shebang.
	Use the same technique as mmroff, gropdf, and pdfmom.

	* src/utils/afmtodit/afmtodit.am (afmtodit): Replace "@PERL@"
	instead of "/usr/bin/perl".
	* src/utils/afmtodit/afmtodit.pl: Use "@PERL@" in shebang.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gropdf] Give program a usage message.

	* src/devices/gropdf/gropdf.pl: Add new scalar `want_help` of
	Boolean sense.  Recognize new long option `--help`, attached to
	`$want_help`.
	(usage): New subroutine reports usage message.  If help was
	explicitly requested, summarize purpose of program and steer
	reader to man page.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/xditview/xditview.c (Syntax): "#if 0" out
	reference to `-noPolyText` option, whose effect is likewise
	bracketed in another file.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (enable_warning, disable_warning):
	Recast diagnostic messages for clarity.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pfbtops]: Fix code style and diagnostic nits.

	* src/utils/pfbtops/pfbtops.c (error): Exit with `EXIT_FAILURE`
	status (from standard C library) instead of status 2.
	(main): Exit with `EXIT_SUCCESS` status when writing version or
	help information.  Exit with status 2 when dying due to usage
	error.  Use `fprintf()` and `strerror()` to construct error
	message when dying due to inability to open input file instead
	of using `perror()`, which anonymizes its caller and thus should
	never be used in serious work.  Avoid it like `gets()`.
	* NEWS: Add item for exit status changes.

	Continues the long process of fixing Savannah #52463.

2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man pages]: Don't document macro package compatibility wrapper
	directory if it's not used.

	* Makefile.am (.man): Use sed to replace
	'@COMPATIBILITY_WRAPPERS@' in man page text with value of
	`compatibility_wrappers` shell variable.  Document its purpose.
	* src/preproc/eqn/eqn.1.man (Description):
	* src/preproc/grn/grn.1.man (Options):
	* src/roff/groff/groff.1.man (Installation directories):
	* src/roff/troff/troff.1.man (Environment): Mention
	`@SYSTEMMACRODIR@` only if `@COMPATIBILITY_WRAPPERS@` expands to
	something other than "no" (it could be "yes" or "manual").

	Thanks to Alexander Kanavin and Jeremy Puhlman for the report.

2022-10-21  Robert Yang <liezhi.yang@windriver.com>

	* font/devpdf/util/BuildFoundries.pl:
	* src/devices/gropdf/gropdf.pl:
	* src/devices/gropdf/pdfmom.pl: Replace use of '-w' in shebang
	line with "use warnings;".

2022-10-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/fallbacks.tmac: Define fallback characters for many code
	points from the Unicode General Punctuation Block.  This is to
	ease migration from other documentation formats; in many cases
	there are more idiomatic *roff ways of getting results that
	typeset better and are amenable to fine tuning.  For instance,
	Unicode defines spaces and dashes of various discrete widths;
	when typesetting with *roff, you can have a space or dash (among
	other things) of any length achievable by the output device.
	* tmac/ps.tmac: Migrate non-breaking hyphen fallback character
	definition from here to the foregoing.

	Fixes <https://savannah.gnu.org/?58930>.  Thanks to Dave Kemper
	for the report and discussion.

2022-10-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac:
	* tmac/s.tmac: Escape newlines when opening conditional blocks.

	Fixes <https://savannah.gnu.org/?63197>.  Thanks to Bjarni Ingi
	Gislason for the report and Dave Kemper for the quick fix.

2022-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grodvi/dvi.cpp (usage):
	* src/devices/grohtml/post-html.cpp (usage):
	* src/devices/grolbp/lbp.cpp (usage):
	* src/devices/grolj4/lj4.cpp (usage):
	* src/devices/grops/ps.cpp (usage):
	* src/devices/grotty/tty.cpp (usage):
	* src/devices/xditview/xditview.cpp (usage):
	* src/preproc/eqn/main.cpp (usage):
	* src/preproc/grn/main.cpp (usage):
	* src/preproc/html/pre-html.cpp (usage):
	* src/preproc/pic/main.cpp (usage):
	* src/preproc/preconv/preconv.cpp (usage):
	* src/preproc/refer/refer.cpp (usage):
	* src/preproc/soelim/soelim.cpp (usage):
	* src/preproc/tbl/main.cpp (usage):
	* src/roff/groff/groff.cpp (synopsis, help):
	* src/roff/nroff/nroff.sh:
	* src/roff/troff/input.cpp (usage):
	* src/utils/addftinfo/addftinfo.cpp (usage):
	* src/utils/hpftodit/hpftodit.cpp (usage):
	* src/utils/indxbib/indxbib.cpp (usage):
	* src/utils/lkbib/lkbib.cpp (usage):
	* src/utils/lookbib/lookbib.cpp (usage):
	* src/utils/pfbtops/pfbtops.c (usage):
	* src/utils/tfmtodit/tfmtodit.cpp (usage):
	* src/utils/xtotroff/xtotroff.c (usage): Update usage message.
	Present different modes of operation on separate output lines.
	Sort options in English lexicographic order.  Document help
	option(s) as last mode of operation.

2022-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl: Revise handling of argument 0.
	Rename scalar `progname` to `prog` for brevity (and preparation
	for writing a usage message).  Also stop stripping off directory
	name components from it.  No other groff program does this, and
	it might save users some confusion if they're working with
	multiple copies of gropdf.

2022-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	Migrate terminology from "paper size" to "paper format" or
	"paper dimensions" as appropriate in documentation and
	diagnostic messages.  "Format" implies an orientation (which can
	be overridden in many cases) whereas size does not.  When only
	the magnitudes of measurements are at issue (mainly for internal
	purposes), use the term "dimensions".

	* NEWS:
	* PROBLEMS:
	* doc/groff.texi:
	* m4/groff.m4 (GROFF_PAGE):
	* man/groff_font.5.man:
	* man/groff_tmac.5.man:
	* src/devices/grodvi/dvi.cpp (main):
	* src/devices/grolbp/grolbp.1.man:
	* src/devices/grolbp/lbp.cpp (main):
	* src/devices/grolj4/grolj4.1.man:
	* src/devices/grolj4/lj4.cpp (lj4_printer::lj4_printer, main):
	* src/devices/grolj4/lj4_font.5.man:
	* src/devices/gropdf/gropdf.1.man:
	* src/devices/grops/grops.1.man:
	* src/devices/grops/ps.cpp (main):
	* src/roff/groff/groff.1.man:
	* tmac/papersize.tmac: Do it.

2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff (doc-left-parenthesis)
	(doc-right-parenthesis, doc-left-bracket, doc-right-bracket):
	Drop thin and hair space escape sequences from these string
	definitions.  (Also, doc-right-bracket was inconsistent with
	doc-left-bracket, the former inserting horizontal motion only
	before the bracket character.)  Eliminates excess space when
	using Pq, Po, Pc and Bq, Bo, Bc macros and formatting for
	typesetters, and aligns output with behavior of `Pq` and `Bq` as
	documented in groff_mdoc(7).

	Fixes <https://bugs.debian.org/1021795>.  Thanks to наб for the
	report.

2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff: Use groff-canonical typeface names in
	font selection escape sequences.  Migrate 'C' to 'CR' and 'CO'
	to 'CI'.  (Admittedly, "Courier oblique" is more pedantically
	correct than "Courier italic".  But the iron ball of Unix troff
	history and its style trio [later quartet] of "R", "I", "B"
	{then "BI"} will not be ignored.)

2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff: Drop nilpotent type size escape
	sequences from string definitions.

2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	Document a CSTR #54 erratum regarding \n(st and \n(sb.

	* doc/groff.texi (Page Motions):
	* man/groff.7.man (Writable registers):
	* man/groff_diff.7.man (New registers): Do it.

	* PROBLEMS: Further clarify.  Note DWB and Heirloom behavior.

2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/main.cpp (read_line): Fix switched test
	consequents when updating `current_lineno`.

2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/xtotroff/xtotroff.c (main): Annotate "xtotroff" as a
	GNU program in version information.

2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/xditview/xditview.am
	($(GXDITVIEW_GROFF_VERSION_H): Perform correct substitution to
	get groff version string into `Version_string` C symbol.
	Continues commit c73decb58f, 9 October.

2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.1.man (Files): Fix ordering error.

	Fixes <https://savannah.gnu.org/bugs/?63228>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-10-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/lex.cpp (get_delimited_text): Clear line
	number when hitting EOF.
	* src/preproc/eqn/main.cpp: Revise end-of-file handling.  Clear
	line number upon reaching EOF so that we don't report a nonsense
	value one greater than the number of lines in the input file.
	(read_line): Boolify.  Make static (local linkage only), since
	it has no external callers.  Introduce new Boolean variable
	`is_end_of_file`.  Clear `current_lineno` if EOF, and increment
	it otherwise.
	(do_file, main): Clarify diagnostic messages.

2022-10-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[eqn]: Improve diagnostics involving unprintable characters.

	* src/preproc/eqn/main.cpp (input_char_description): New
	function constructs a human-readable string describing
	characters.
	(read_line, inline_equation, main): Call new function and adjust
	diagnostic message wording to accommodate the phrase it returns.

	Fixes <https://savannah.gnu.org/bugs/?63218>.

2022-10-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[eqn]: Improve diagnostics.

	* src/preproc/eqn/lex.cpp (file_input::~file_input):
	* src/preproc/eqn/main.cpp (main): Die if `fclose()` fails and
	report underlying system error.
	(inline_equation): Identify inline equation context.

2022-10-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (2c, 1c): Throw diagnostic if changing columnation
	with a footnote pending.  This isn't necessarily an error per
	se, but in many cases it will flag an undesirable page layout
	due to the limited flexibility of me(7)'s footnote support at
	present.  See <https://savannah.gnu.org/bugs/?63176>.

2022-10-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/main.cpp: Fix code style nits.
	(usage): Align output with man page.  Document separate
	invocation modes separately.
	(main): Use standard C library symbols `EXIT_SUCCESS` and
	`EXIT_FAILURE` with `exit()` calls instead of integer literals.
	Replace `assert(0)` call with communicative predicate.  Check
	return value of `fclose()`, and exit with fatal error if it
	fails.  Distinguish `ferror()` status and `fflush(stdout)`
	failures when cleaning up before exit.

2022-10-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_color_draw_node): Clarify
	diagnostic.

2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/dvi.tmac: Always render \[aq] as a neutral apostrophe.
	Thanks to the TC fonts, we can do this even when the default CM
	text fonts are in use.

	Fixes <https://savannah.gnu.org/bugs/?63200>.

2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/ec.tmac: Remove apparently unnecessary remappings of
	styles (and reassertion of style slots in the font mounting
	position list, albeit in an unusual order (RBI instead of RIB)).
	This code frustrated the rendering of man pages with post-1.22.4
	groff for the 'dvi' output device when using EC fonts.  Instead
	remap the T and H family typefaces in all four styles
	explicitly.  (The CW and CWI faces were already handled.)  Also
	add remappings of groff+PostScriptish font names "CB" and "CBI"
	to CW EC faces of normal weight, corresponding to dvi.tmac; see
	commits 529e2ca0c4, 2002-03-23 and c9741da6c0, 2021-05-06.

	Fixes <https://savannah.gnu.org/bugs/?63194>.

2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an_works-with-ec.sh: Add regression test for
	Savannah #63194.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/ec_works.sh: Add unit test to validate use of EC
	fonts when "-mec" option given.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/latin2.tmac:
	* tmac/latin5.tmac:
	* tmac/latin9.tmac: Perform the character remapping shenanigans
	of the fix for Savannah #63112 only if the output device is
	"latin1" (a terminal using an 8-bit character encoding).  Only
	then can we be sure that Latin-1 glyphs will be unavailable when
	other encodings are used and that `\N` escape sequences will
	identify correct glyph indices in a font (because there is no
	font per se accessible to groff--simply a terminal implementing
	a character encoding).

2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (GetType1): Clarify diagnostic.
	When failing to open a font file for embedding in a PDF, mention
	this context.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.tables: Update against Unicode 15.
	No substantive changes.

	Fixes <https://savannah.gnu.org/bugs/?63188>.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: If URW fonts were located, add the directory
	where they were found to the configuration report.

	Attempts to fix <https://savannah.gnu.org/bugs/?62860> (2/2).

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4: Try to make gropdf's search for URW font files
	more deterministic.  To disambiguate cases where multiple--not
	necessarily identical--copies may be found on the system, search
	_only_ in the directory given to the `--with-urw-fonts-dir`
	configure option, if present.  This populates the "Foundry" file
	generated by the build, causing gropdf to search there first.
	(GROFF_URW_FONTS_PATH): Stop `AC_SUBST`ing `urwfontsdir` here.
	(GROFF_URW_FONTS_CHECK): `AC_REQUIRE` `GROFF_URW_FONTS_PATH` to
	be run first.  If `urwfontsdir` is not null, search only there
	for URW fonts.  Assign `urwfontsdir` the value of the directory
	in which the fonts are found.  Assign it an empty value if none
	are found.  Either way, `AC_SUBST` the variable.

	Attempts to fix <https://savannah.gnu.org/bugs/?62860> (1/2).

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (LoadFont): Clarify diagnostic.
	gropdf opens "fonts" in two distinct ways.  On the one hand, it
	opens groff font description files for essentially all
	nontrivial output.  On the other, it may open actual Type 1 font
	files for embedding in a PDF.  Make failure of the former case
	less confusable with the latter.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Document new XN/XH and related macros.

	* doc/groff.texi (Creating a table of contents):
	* doc/ms.ms (Creating a table of contents):
	* tmac/groff_ms.7.man (Creating a table of contents): Do it.

	Fixes <https://savannah.gnu.org/bugs/?63110>.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gxditview]: Support `-version`, `--version` option.  As a C
	program, gxditview had no access to the (C++) libgroff
	`Version_string` symbol, so construct a header file to store
	this datum at build time.  If groff gets other user-facing C
	programs, we should consider generating this header in
	src/include instead.

	* src/devices/xditview/xditview.am: Generate "groff_version.h"
	file.
	(GXDITVIEW_GROFF_VERSION_H): Define new macro.
	($(GXDITVIEW_GROFF_VERSION_H)): Define target to generate file.
	(XDITVIEW_GENHDRS): Add $(GXDITVIEW_GROFF_VERSION_H).

	* src/devices/xditview/xditview.c: Include new header file.
	(Syntax): Report newly supported options.
	(main): Recognize and handle new options.

	* src/devices/xditview/gxditview.1.man (Synopsis): Document
	them.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[gxditview]: Update usage message production and contents.

	* src/devices/xditview/xditview.c: Use C99 Boolean type.
	(Syntax): Accept additional Boolean argument indicating whether
	the usage message is to be issued due to an error.  Write
	message to stderr if so, and stdout otherwise.  Stop presuming
	length of output line; guessing where to wrap is unreliable due
	to variable terminal width and length of argv[0].  Write one
	line per invocation mode of the program.  Stop duplicatively
	documenting standard X Toolkit options.  Exit with standard C
	library `EXIT_FAILURE` status if there was an error, and
	`EXIT_SUCCESS` otherwise.
	(main): Refactor to prepare for `--version` support.

	* src/devices/xditview/gxditview.1.man (Synopsis): Sync list of
	options with usage message.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Recognize "--version" as
	synonym for "-v".  To achieve this, use Getopt::Long instead of
	Getopt::Std.
	* src/utils/afmtodit/afmtodit.1.man (Synopsis, Options):
	Document it.

2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/pdfmom.pl: Recognize "--version" as synonym
	for "-v".
	* src/devices/gropdf/pdfmom.1.man (Synopsis, Description):
	Document it.

2022-10-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (version): Identify as a GNU program.

2022-10-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grolj4/grolj4.1.man (Typefaces): Add new
	subsection.

	Fixes <https://savannah.gnu.org/bugs/?60929>.  Thanks to T. Kurt
	Bond for the report.

2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/meref.me.in (Columnated Output): Document persistence of
	`$s` register value across columnation mode changes.

	Fixes <https://savannah.gnu.org/bugs/?62717>.  Thanks to Dave
	Kemper for the report.

2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/meref.me.in: Annotate empty default arguments more
	consistently.

	Fixes <https://savannah.gnu.org/bugs/?62801>.  Thanks to Dave
	Kemper for the report.

2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/meref.me.in: Fix documentation error.
	(Summary) <\_>: Describe as "underrule", not "underscore".
	These are distinct: the latter is a glyph; the former is drawn
	by typesetters and rendered with SGR attributes on terminals.

2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* NEWS: Advise users of changes to "name" directive handling in
	font description files.

	Fixes <https://savannah.gnu.org/bugs/?61423>.  Thanks to Dave
	Kemper for the report.

2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/number.cpp: Refactor and fix code style nits.
	Boolify and rename static (local) functions.
	- parse_expr   -> is_valid_expression
	- start_number -> is_valid_expression_start
	- parse_term   -> is_valid_term
	Rename preprocessor macro `SCALE_INDICATOR_CHARS` to
	`SCALING_UNITS`.
	(is_valid_expression, is_valid_term): Rename parameters and
	demote them from `int` to `bool`.
	- scaling_indicator -> scaling_unit (no demotion)
	- parenthesised     -> is_parenthesized
	- rigid             -> is_mandatory
	(is_valid_expression_start, is_valid_expression, is_valid_term):
	Return Boolean rather than integer literals.
	(get_vunits, get_hunits, get_number_rigidly, get_number)
	(get_integer): Update call sites of renamed functions.  Replace
	Boolean-valued integer literals used as Booleans with Boolean
	literals and annotate their purposes.  (See <https://\
	stackoverflow.com/questions/38076786/\
	why-doesnt-c-support-named-parameters>.)
	(get_vunits, get_hunits, get_number, get_integer): Replace `0`
	in assertions with a communicative predicate.  In all of these
	it's an unhandled `switch()` case.

2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_expr_test, do_zero_width): Use
	better terminology in diagnostic messages.

2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Fix Savannah #63151.

	* src/roff/troff/input.cpp (read_draw_node): Throw "delim"
	warning diagnostic when a drawing escape sequence ends the line
	without a closing delimiter.

	Fixes <https://savannah.gnu.org/bugs/?63151>.

2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/fallbacks.tmac: Define fallbacks for characters in ISO
	Latin-{2,5,9} but not in Latin-1.

	Fixes <https://bugs.debian.org/782903>.  Thanks to Rafal Pietrak
	for the report.

2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Fix Savannah #63149.

	* src/roff/troff/reg.cpp (alter_format): Throw comprehensible
	diagnostic when input delete character encountered in register
	format.

	Fixes <https://savannah.gnu.org/bugs/?63149>.

2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Describe an input delete character comprehensibly.

	* src/roff/troff/input.cpp (token::description): The delete
	character (ISO 127 decimal, EBCDIC 7) is a valid `TOKEN_CHAR`
	but is not printable.  Don't attempt to output it literally in
	diagnostics; describe it in a phrase instead.

2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Apply consistent terminology.

	* src/roff/troff/input.cpp: Rename functions to better align
	with our documentation, and decouple their names from an
	assumption of diagnostic severity.  Also give them imperative
	names since they are called for their side effects, not their
	return values.
	- empty_name_warning -> diagnose_missing_identifier
	- non_empty_name_warning -> diagnose_invalid_identifier
	(diagnose_missing_identifier): Refer to absent operand as
	"identifier", not "name", in diagnostic messages since the
	latter (strictly) refers to the request/macro/string/diversion
	name space, and this function is also used to gather register
	identifiers.

2022-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Fix Savannah #63112 (3/3).

	* tmac/latin2.tmac: Replace characters that ISO Latin-1 has but
	Latin-2 doesn't.  Map characters that ISO Latin-2 has and
	Latin-1 doesn't to their numeric code points.

2022-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Regression-test Savannah #63112 (3/3).

	* tmac/tests/latin2_works: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Fix Savannah #63112 (2/3).

	* tmac/latin5.tmac: Replace characters that ISO Latin-1 has but
	Latin-5 doesn't.  Map characters that ISO Latin-5 has and
	Latin-1 doesn't to their numeric code points.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Regression-test Savannah #63112 (2/3).

	* tmac/tests/latin5_works: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Fix Savannah #63112 (1/3).

	* tmac/latin9.tmac: Replace characters that ISO Latin-1 has but
	Latin-9 doesn't.  Map characters that ISO Latin-9 has and
	Latin-1 doesn't to their numeric code points.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Regression-test Savannah #63112 (1/3).

	* tmac/tests/latin9_works: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp: Refactor to parallelize logic in
	similar routines; namely, those handling escape sequences that
	accept newlines as argument delimiters.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp: Fix inconsistencies in handling of
	escape sequences that accept newlines as delimiters.  Some threw
	spurious warnings as in Savannah #63011; others failed to treat
	a newline-terminated escape sequence also as the ending of an
	input line.
	(do_name_test, do_zero_width): Suppress spurious warning.
	(do_zero_width, do_width, do_special): Synthesize newline to
	terminate input line.

2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/\
	some_escapes_accept_newline_delimiters.sh: Add test cases for
	`\A` and test formatted output of escape sequences, not just the
	absence of diagnostics from permitted use of newlines as
	argument delimiters.

2022-09-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libdriver/input.cpp (do_file): Make use of
	positioning commands before the first page is started fatal
	errors; they suggest ill-formed input.  The 'p' command
	clobbers the vertical position anyway.  (See
	https://bugs.debian.org/421437 for discussion.)

2022-09-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdf.tmac: Add inclusion guard; if a `pdfmark` macro is
	already defined, skip inclusion of this file.  Unfortunately
	there are multiple name collisions with pdfmark.tmac.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp:
	* src/roff/troff/request.h: Trivially refactor.  Boolify
	`interpolate_macro` and `request::invoke`.  Also rename
	parameter `no_next` to `do_not_want_next_token`, exposing
	potentially confusing interface design.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (spring_trap, interpolate_string)
	(interpolate_string_with_args): Improve error diagnostics: when
	a sprung trap or an interpolation fails because it's being
	attempted on a request, say so explicitly and _name_ it.  If the
	argument to the trap-planting request or to a string
	interpolation escape sequence is itself an interpolation, this
	name might not be obvious.  Consider:
	  .wh \n[pos] \*[mac]
	  .em \*[mac]
	  .itc 1 \*[mac]
	  \*[\*[mac]]
	Supplying this information requires no additional overhead.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (interpolate_string): Trivially
	refactor.  Rename function parameter from `s` to `nm` to more
	obviously align with `interpolate_string_with_args()`.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_zero_width, token::description)
	(interpolate_string, interpolate_string_with_args)
	(token::get_char): Revise diagnostic messages to stop presuming
	the identity of the escape character.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (set_escape_char): Recast error
	message to describe attempted operation and tell the user what
	we're doing about being instructed to use an invalid escape
	character.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_size): Be more helpful to
	ambiguous type size escape sequence users; offer advice in
	terms of the current escape character.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (main): Fix SEGV when exiting
	gxditview.  The `postdriver` pointer always referred to
	allocated memory except when the `-X` option was given; it was
	then assigned the address of a #defined string literal.  It was
	thus statically allocated and an error to attempt to `free()`
	it.  Duplicate the string on the heap instead so that we can
	clean up uniformly regardless of postprocessor.  Problem caused
	by me when introducing `xexit()` in commit 6769e56aab, 20 June.

2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (@o, n2, sk (f, ++): Consistently call `@err`
	macro with `do`.

2022-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Initialize new register `_f`, the value of `$m`
	{column count} of the previous pending footnote, to zero,
	meaning there is no previous pending footnote.
	(@o): Emit diagnostic when flushing footnotes into a different
	column layout than the pending footnote last added.  Set `_f` to
	zero.
	((f): Emit diagnostic when enqueueing footnote using a different
	column layout than the previous pending footnote used.  Set `_f`
	to `$m`.

	Fixes <https://savannah.gnu.org/bugs/?58736>.  Thanks to Dave
	Kemper for the report and discussion.

2022-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Explicitly initialize and annotate internal
	register `?f`.

2022-09-08  Nikita Ivanov <nikita.vyach.ivanov@gmail.com>

	* tmac/ps.tmac: Fallback definitions for glyphs that usually
	come from special fonts should use `schar` instead of `fchar`.
	{Define fallback special characters using `schar` instead of
	`fchar` for glyphs that we do not expect to find in text fonts;
	that is, they don't have bold, italic, and bold-italic stylistic
	variants.  This means all special character definitions in the
	file except for rules, ligatures, and digraphs.  Problem dates
	back to a series of commits from March 2002 to February 2003,
	straddling the introduction of the `schar` request in November
	2002. --GBR}

	Fixes <https://savannah.gnu.org/bugs/?62955>.

2022-09-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Slightly simplify new `XN` macro feature to align it more
	closely with Berkeley TOC macro behavior; don't prepend the
	table of contents entry with the section number (`\*[SN]`).  If
	desired, a document can define `XN-REPLACEMENT`.  This does not
	regress "pdfmark.ms" because it uses an alternative, older
	implementation of these features from "spdf.tmac".

	* tmac/s.tmac (XH-UPDATE-TOC): Update comments.
	(XN-REPLACEMENT): Do it.

2022-09-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdf.tmac (pdf*href-I): Call `pdf:error` macro by its
	correct name.  Both this macro file and
	contrib/pdfmark/pdfmark.tmac seem to want to use the 'pdf'
	prefix for their macro names, with much confusing overlap.
	Problem dates back to commit 87046b2948, 2011-07-26.

2022-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): If Ghostscript or awk are
	unavailable, skip only the prepopulation of the URW font search
	path instead of the entire check.  This way we still locate the
	URW fonts if they are in one of several standard locations.

	Fixes <https://savannah.gnu.org/bugs/?62775>.

2022-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Trivially refactor.

	* src/roff/troff/input.cpp (do_name_test): Boolify and rename
	local variables to..."impredicate" their names.
	  - bad_char -> got_bad_char
	  - some_char -> got_some_char

2022-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grodvi, ...]: Trivially refactor.

	Tidy up #includes of the "assert.h" header, which we locally
	provide to ensure a C99-conformant implementation.  Drop
	inclusion of header from files that don't directly need it, add
	it where they do, and spell the inclusion consistently with
	double quotes to cue the reader of its local status.

	* src/devices/grodvi/dvi.cpp:
	* src/devices/grolj4/lj4.cpp:
	* src/libs/libdriver/printer.cpp:
	* src/preproc/eqn/box.cpp:
	* src/preproc/eqn/delim.cpp:
	* src/preproc/eqn/pile.cpp:
	* src/preproc/eqn/script.cpp: Add inclusion.

	* src/include/driver.h:
	* src/libs/libgroff/fontfile.cpp:
	* src/preproc/eqn/eqn.h:
	* src/preproc/html/pushback.cpp:
	* src/preproc/refer/refer.h:
	* src/preproc/tbl/table.h:
	* src/utils/addftinfo/addftinfo.cpp: Drop inclusion.

	* src/include/itable.h:
	* src/include/stringclass.h:
	* src/libs/libbib/linear.cpp:
	* src/libs/libbib/search.cpp:
	* src/libs/libgroff/color.cpp:
	* src/libs/libgroff/font.cpp:
	* src/libs/libgroff/nametoindex.cpp:
	* src/libs/libgroff/prime.cpp:
	* src/libs/libgroff/searchpath.cpp:
	* src/preproc/html/pre-html.cpp:
	* src/preproc/preconv/preconv.cpp:
	* src/preproc/soelim/soelim.cpp:
	* src/utils/indxbib/indxbib.cpp:
	* src/utils/lkbib/lkbib.cpp:
	* src/utils/lookbib/lookbib.cpp: Respell inclusion.

	Fixes <https://savannah.gnu.org/bugs/?63079>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff, ...]: Trivially refactor.

	Boolify and rename internal library function from
	`invalid_input_char` to `is_invalid_input_char`.

	* src/include/lib.h: Do it.

	* src/libs/libgroff/font.cpp (text_file::next_line):
	* src/preproc/eqn/lex.cpp (file_input::read_line):
	* src/preproc/eqn/main.cpp (read_line, main):
	* src/preproc/pic/lex.cpp (file_input::read_line,
	simple_file_input::get, simple_file_input::peek):
	* src/preproc/pic/main.cpp (top_input::get, top_input::peek)
	(do_file):
	* src/preproc/refer/command.cpp (input_stack::push_file):
	* src/preproc/refer/refer.cpp (do_file, do_bib):
	* src/roff/troff/env.cpp (environment::make_tag):
	* src/roff/troff/input.cpp (file_iterator::fill)
	(file_iterator::peek, get_char_for_escape_parameter)
	(transparent_translate, read_request, asciify)
	(input_char_description, read_string, transparent_file,
	set_string): Update call sites.

2022-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Tweak diagnostic messages.

	* src/roff/troff/input.cpp (token::description)
	(input_char_description): Consistently use articles in
	descriptive noun phrases.

2022-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Tweak diagnostic messages.

	* src/roff/troff/input.cpp (non_empty_name_warning): Say
	"identifier", not "name", in diagnostic message; it can be
	thrown for attempted assignments to invalid register
	identifiers, and some of our documentation refers to identifiers
	in the name space shared by requests, macros, strings, and
	diversions as "names".

	* src/roff/troff/env.cpp (hyphen_trie::read_patterns_file):
	* src/roff/troff/input.cpp (get_char_for_escape_parameter)
	(token::usable_as_delimiter, non_empty_name_warning)
	(pipe_source, psbb_locator::psbb_locator, open_request)
	(opena_request, define_class, pipe_output, system_request):
	Consistently say "_is_ not allowed".  The zero copula poses too
	great a risk of incomprehension IMO.

2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Add internal string `doc-Lk-font` to manage the typeface
	in which to render URIs.

	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Add it.  Use roman instead of (Courier)
	bold.  This is more consistent with man(7)'s `UR` and less with
	mandoc(1).

	* tmac/doc.tmac (Lk): Use it instead of `doc-Sy-font`.

2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Fix Savannah #59738.

	* tmac/doc.tmac (Lk): Process further macro arguments more like
	other macros do, calling `doc-print-recursive`.  This permits
	recognition of end-of-sentence punctuation in the argument list.

	Fixes <https://savannah.gnu.org/bugs/?59738>.

2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Regression-test Savannah #59738.

	* tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh: Do
	it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Fix code style nit.  Rename `doc-arg-limit` to
	`doc-arg-count`.  This register doesn't track any sort of limit
	on the number of arguments you can give to an mdoc(7) macro, or
	anything like that.  It is simply a count of the number of
	arguments visible to the currently operating macro.

	* tmac/doc.tmac:
	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff:
	* tmac/mdoc/doc-syms: Do it.

2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Fix errors in documentation regarding which escape
	sequences accept newlines as argument delimiters, and other
	inaccuracies.

	* doc/groff.texi (Escape Sequences): Cover general cases before
	exceptional ones.  Leaders can be used as argument delimiters.
	Call out letters and numerals as (usually) usable as well.
	Correct an almost completely inaccurate list of escape sequences
	that accept a newline as an argument delimiter: \A, \b, \o, \w,
	\X, and \Z do; \B does not.  Correct example of use of newline
	as delimiter with \o escape sequence.  Stop referring to the
	decimal point as an "operator".  Drop "newline" from a list of
	prohibited delimiters by several escape sequences since it has
	already been discussed.

	* man/groff.7.man (Escape sequences): Replace weaksauce cross
	reference to our Texinfo manual with a proper discussion of
	acceptable delimiters in escape sequences, synced with the
	foregoing change.  Stop using quotation marks around escape
	sequences, except for "\ " which obviously needs it.

	Fixes <https://savannah.gnu.org/bugs/?63002>.  Thanks to Dave
	Kemper for the report.

2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Don't throw a spurious warning when using newline as
	delimiter with the few escape sequences that permit this.

	* src/roff/troff/input.cpp (do_overstrike, do_bracket, do_width)
	(do_special): Do it.

	Fixes <https://savannah.gnu.org/bugs/?63011>.  Thanks to Bjarni
	Ingi Gislason for the report and Dave Kemper for the discussion.

2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Add regression test for Savannah #63011.

	* src/roff/groff/tests/\
	some_escapes_accept_newline_delimiters.sh: Do it.
	* src/roff/groff/groff.am (groff_TESTS): Run it.

2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_special): Fix code style nit;
	align function definition with declaration (internal linkage).

2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/ps.cpp (ps_printer::special)
	(resource_manager::process_file): Fix code style nit.  Mark
	static structs initialized within functions and never modified
	thereafter as `const`.  This attempts to work around an apparent
	false positive from AddressSanitizer.  If it doesn't pacify
	ASAN, please explain to me how constant structure members
	initialized to string literals and pointers to functions within
	the translation unit can ever be null.  If that is infeasible,
	please report a bug to your compiler vendor.

	Fixes (addresses, at any rate) https://savannah.gnu.org/bugs/\
	?61643>.  Thanks to Bjarni Ingi Gislason for the report.

2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Refactor: relocate most rendering option handling to
	"doc.tmac" from "doc-ditroff" and "doc-nroff", cutting down on a
	lot of duplication.  The `S` register retains separate handling.

	* tmac/doc.tmac:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Do it.

2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff (doc-setup-page-layout):  In troff mode,
	if the user does not define the `LL` register, use the device's
	default line length, not 6.5 inches.  If the user does not
	define the `LT` register, make the default line length for
	titles the same as the regular line length, not 6.5 inches
	independently of it.  This is consistent with man(7)'s handling
	of `LL` and `LT`.

2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `AD` string to set default adjustment mode.

	* tmac/mdoc/doc-common (Sh): Set adjustment mode to
	user-specified default, not troff's default (and not only in
	troff mode).

	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Process `AD` string setting from command
	line as man(7) does.

	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
	nroff): Document it.

	* NEWS: Add and update items.

	Fixes part of <https://savannah.gnu.org/bugs/?63046>.

2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac (doc-tag-list): Fix code style nit: don't give
	`ad` request a numeric argument.  Say `l` instead of `0`.

2022-09-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Align inter-paragraph spacing with man(7).

	* tmac/mdoc/doc-common: Use `doc-paragraph-space` when spacing
	prior to section and subsection headings instead of spacing by
	the 1v default.
	* tmac/mdoc/doc-ditroff: Align inter-paragraph distance amount
	in troff mode with man(7), reducing to 0.4v from 0.5v.

2022-09-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-nroff: Map monospaced fonts (CR, CB, CI, CBI) to
	standard styles as man(7) has done for 15 years.  This silences
	warnings from the formatter when a man page attempts to use
	fonts from the Courier family in tbl(1) tables, which is about
	the only place a reasonable man page attempts such a thing.

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Stop prefixing center header with name of operating
	system.  This was hard-coded to "BSD" and stuck on all mdoc(7)
	pages using a default manual section number, regardless of host
	operating system.  Bad idea.  Further, the argument to the `Os`
	call, if any, or a default, is always disclosed in the left
	footer.

	* tmac/mdoc/doc-common: Do it.
	(Dt): Initialize `doc-volume` as empty and annotate it;
	calling the macro with a numeric second argument overrides the
	fallback default of "LOCAL".  A slash is no longer needed to
	separate a recognized architecture string from the OS name, so
	drop it.

	* tmac/tests/doc_smoke-test.sh: Update test expectations.

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Drop dead code.  The register
	`doc-volume-operating-system-ateol`, introduced in groff 1.18
	{July 2002}, was being tested but never set to a nonzero value.
	In fact, it seems never to have been.

	* tmac/mdoc/doc-common: Get rid of it...
	(Dt): ...and the dependent block.

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Make `Ux` render "Unix" in mixed case.

	* tmac/mdoc/doc-syms (Ux): Do it.  Also remove local string
	after we're done with it.

	Continues work begun prior to groff 1.22.4 release.

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Align spacing around headers with man(7).

	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
	* tmac/mdoc/doc-common (Rd):
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Stop defining, saving, and restoring
	`doc-header-space`.

	* tmac/mdoc/doc-common (doc-header): When starting new document
	and not continuously rendering, space by one half-inch instead
	of by the now-defunct `doc-header-space` amount (which,
	strictly, should not have applied to this measurement).  If
	continuously rendering, extend page length by 1v to accommodate
	header line.  After formatting header, if not continuously
	rendering, space to 1 inch below first text baseline.

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Support `C` register for consecutive page numbering.

	* tmac/mdoc/doc-common (Dd): Reset page number to 1 upon new
	document only if not consecutively numbering.

	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Process `C` register setting from command
	line as man(7) does.

	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
	nroff): Document it.

	Fixes part of <https://savannah.gnu.org/bugs/?63046>.

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Align trap management more closely with man(7).

	* tmac/mdoc/doc-common: Call new macro (see below)
	`doc-set-up-continuous-rendering` when initializing, if that
	mode is configured.
	(doc-ne): New macro replaces `ne` request
	in continuous rendering mode.  It extends the page length by the
	amount in the argument or by 1v if none given.
	(doc-bp): New macro replaces `bp` request in continuous
	rendering mode, setting the page length to the vertical drawing
	position.
	(doc-set-up-continuous-rendering): New macro renames requests to
	emplace the foregoing.
	(Dd): Interpret this macro call strictly as starting a new
	mdoc(7) document.  (andoc.tmac already makes this assumption,
	and has for over 20 years.  groff_mdoc(7) and mandoc_mdoc(7)
	also prescribe the sequence `Dd`, `Dt`, `Os`.)  We require this
	invariant even more rigidly now because it's the only way we can
	be sure that we can process multiple documents while rendering
	headers and footers with information corresponding to the
	appropriate document.  (man(7)'s `TH` has an advantage here in
	that calling it is "atomic": from its arguments alone you can
	obtain everything you need to know to format the header and
	footer.  In mdoc(7), permuting the initialization macro order
	reliably produces chaos.)  Break the page (if necessary)
	_before_ processing any arguments (instead of after), to flush
	the previous page's footer.  Stop calling `doc-set-up-titles`
	here; we don't have enough information to do that yet.  Also
	stop writing the PDF bookmark here, because `doc-document-title`
	and `doc-section` will not reflect the new page content yet.
	(Os): Once the `doc-operating-system` string content has been
	determined, call `doc-set-up-titles`, write the PDF bookmark for
	the page, and call `doc-header`, causing the page header to be
	formatted.  These changes further imply a stronger requirement
	on initialization macro ordering being canonical.

	Fixes <https://savannah.gnu.org/bugs/?62774> (7/7).

2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Trivially refactor.  Relocate string and macro
	definition within file.  mdoc(7) mandates that the document
	setup macros `Dd`, `Dt`, and `Os` be called in that order;
	arrange their definitions accordingly, for maintainability.

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Refactor.  Rename strings and macro for clarity.  These
	things don't only affect headers.
	- doc-header-string ->       doc-pageref
	- doc-header-string-saved -> doc-pageref-saved
	- doc-setup-header ->        doc-set-up-titles

	* tmac/doc.tmac:
	* tmac/mdoc/doc-common: Do it.

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Refactor.  There is no difference in
	`doc-header-string` and `doc-setup-header` between the files
	"doc-ditroff" and "doc-nroff", so define them only once, in
	"doc-common".

	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Do it.

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Align footer management more closely with man(7).

	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
	* tmac/mdoc/doc-common (Rd):
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Stop defining, saving, and restoring
	`doc-footer-space`.

	* tmac/mdoc/doc-common (doc-break-body-text): New macro, called
	only when not continuously rendering, schedules a page break.
	(doc-footer): Stop vertically spacing by `doc-footer-space`,
	instead relying upon a trap to move us here.

	* tmac/mdoc/doc-ditroff (doc-setup-header):
	* tmac/mdoc/doc-nroff (doc-setup-header): Set traps at the end
	of the page where man(7) does by default; break the body text at
	1 inch from the page bottom, and write the footer at ½ inch.

	* tmac/mdoc/doc-nroff (doc-setup-header): Add 1/6 em "thin
	space" between man page name and parenthesized section, for
	precise parity with doc-ditroff implementation.  (`\|` does not
	take up any character cells on nroff devices.)

	Fixes <https://savannah.gnu.org/bugs/?62774> (6/7).

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (Dt, Dd): Emit diagnostic warnings if
	macros called with no arguments.

	Fixes <https://savannah.gnu.org/bugs/?62774> (5/7).

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Fix code style nit: stop using Control+G as an escape
	sequence argument delimiter.  This is not necessary in groff and
	hasn't been for at least thirty years.  See the node/section
	"Implementation Differences" of our Texinfo manual.  Our mdoc
	implementation does not operate in compatibility mode, so using
	control characters like this obfuscates input to no advantage.

	* tmac/doc.tmac:
	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff:
	* tmac/mdoc/doc-syms: Do it.

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (doc-footer): Pull more footer concerns
	into this macro.  Don't bail out if continuously rendering;
	instead, format the appropriate footer text if we are.  For now,
	break the page only if we are not continuously rendering.
	(doc-end-macro): Call `doc-footer` instead of formatting footer
	here.

	Fixes <https://savannah.gnu.org/bugs/?62774> (4/7).

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (doc-end-macro): When continuously
	rendering, set the page reference (e.g., "ls(1)") in the right
	footer instead of repeating the left footer.  Thanks to Ingo
	Schwarze for the discussion.

	* tmac/tests/doc_smoke-test.sh: Update expectations of footer
	regression test.

	Fixes part of <https://savannah.gnu.org/bugs/?62926>.

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (doc-end-macro): Reset strings to reduce
	info leaks from one man page to the next.

	Fixes <https://savannah.gnu.org/bugs/?62774> (3/7).

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (Dt): Stop reinitializing `doc-volume`
	and `doc-section`.  This is the job of package initialization
	{and, soon, the end-of-input macro}.

	Fixes <https://savannah.gnu.org/bugs/?62774> (2/7).

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common: Populate default date string
	`doc-date-string` with "UNDATED".
	(Dd, Dt, Os): Make more orthogonal: stop touching
	`doc-topic-name`.  It is "doc.tmac"'s job to initialize it and
	the `Nm` macro's job to update it.
	(Dd): Do nothing if given no arguments.  (You can still blank
	out the document date with an explicitly empty argument:
	  .Dd ""
	.)

	Fixes <https://savannah.gnu.org/bugs/?62774> (1/7).

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common: Change `doc-default-operating-system`
	string from "BSD" to "GNU", per discussion with Ingo Schwarze.
	See <https://lists.gnu.org/archive/html/groff/2022-07/\
	msg00280.html>.

	* tmac/tests/doc_smoke-test.sh: Update expectations of footer
	regression test.

2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common (Dt): Delete lingering and useless
	definition of `doc-command-name` string.  Thanks to Steffen
	Nurpmeso for the report.  See commit e9e92ee008, 27 August.

2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/pic/pic.ypp (not_lower_than): Emit deprecation
	warning for use of 'rand()' with a (non-empty) argument.  The
	man page has declared it thus for over 30 years, at least since
	groff 1.02 (June 1991).

2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/pic/pic.ypp (object_spec): Emit deprecation
	diagnostic for "plot" command.  The man page has declared it
	thus for over 30 years, at least since groff 1.02 (June 1991).

2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/pic/pic.ypp (placeless_element): Explicitly say
	that an unsafe command is being ignored in diagnostic.

2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/main.cpp (main): Drop man page reference from
	deprecation diagnostics.  The man page might be installed with a
	prefix determined at configuration time, and that's too much
	trouble to mess with for construction of a message.  Trust the
	user of these ancient options to try reading the man page with
	the same name as the command.

2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Revise discussion of measurements.

	* doc/groff.texi: Drop Texinfo @codequote* command brackets
	around revised sections; relevant nodes have been reviewed for
	correct glyph usage.  Move concept index entries for obsolescent
	term "machine units" to same location as "basic units".
	Bump document date.
	(Measurements): Rewrite presentation.  We have already
	introduced page geometry concepts, including the concept of
	basic units.
	(Motion Quanta): New subsection node; introduce this concept
	much sooner, right after measurement units.  Relocate
	documentation of `.H` and `.V` registers from a miscellaneous
	read-only register list here.  Introduce example of rounding to
	horizontal motion quantum.
	(Default Units): Revise discussion.  Stop abusing @result
	notation in example.
	(Built-In Registers): Relocate `.H` and `.V` as above.

	* man/groff.7.man: Sync with Texinfo content updates.

	Fixes <https://savannah.gnu.org/bugs/?61432>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	Drop groff_filenames(5) document.  It says nothing accurate that
	is not covered elsewhere.

	* contrib/groff_filenames: Delete.
	* doc/doc.am (GROFF_MAN_PAGES): Drop.
	* src/roff/groff/groff.1.man: Drop cross reference to it.
	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?61818>.

2022-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/tbl.1.man (Table data): Generalize discussion
	of roff control line use in tables.
	(Examples): Illustrate how to embed a comment in a table.

2022-08-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* NEWS: man(7)'s `TS` no longer adds vertical space.  See commit
	7ec36dc9b9, 30 July.

2022-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/main.cpp (main): Issue deprecation warning
	upon use of '-p' or '-s' options.  The eqn(1) man page has
	documented these as deprecated since at least groff 1.02 (June
	1991).  Don't count on them sticking around another 30 years.

2022-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/main.cpp (main): Clarify error diagnostics
	regarding invalid option arguments.  Identify the option being
	handled at the time and characterize the argument as "invalid",
	not "bad".

2022-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[eqn]: Drop support for undocumented '-D' option.  It has been
	undocumented, and issued a warning of its obsolescence upon use,
	for 30 years, since groff 1.06 (September 1992).  That's plenty
	long enough for a deprecation cycle.

	* src/preproc/eqn/main.cpp (main): Do it.
	* NEWS: Add item.

2022-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: (EX, EE): Always break line, even if call invalid.

	* tmac/an.tmac (EX, EE):
	* tmac/an-ext.tmac (EX, EE): Do it.  Ingo Schwarze pointed out
	that page authors will expect breaking semantics from these
	macros even if using them in an ill-formed way.  In a
	well-formed document, the breaks are redundant but harmless (the
	later `nf` and `fi` requests, respectively, also cause breaks).

2022-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Trivially refactor.

	* tmac/doc.tmac:
	* tmac/mdoc/doc-common: Rename string `doc-command-name` to
	`doc-topic-name`; the former is misleading for man pages not in
	sections 1, 6, or 8.

2022-08-25  Bjarni Ingi Gislason <bjarniig@vortex.is>

	* man/groff_char.7.man: Fix bad example syntax.

	Fixes <https://savannah.gnu.org/bugs/?62959>.

2022-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Trivially refactor.

	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Stop using "Null" as an empty string
	indicator when comparing a string interpolation to an empty
	parameter will serve just as well; it is also more idiomatic.
	The string in question, `doc-section`, is never formatted if it
	is empty anyway; the very tests at issue, which populate
	`doc-header-string`, ensure this.

2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (environment::set_family): Throw error
	if user requests a font family that (when combined with the
	current style) can't be resolved to a real font name.  Fixes a
	regression introduced by me in commit d8cb8cf9d8, 2021-09-15,
	arising from a revision of font selection logic in node.cpp to
	enable a bunch of _other_ font error diagnostics.

	Fixes <https://savannah.gnu.org/bugs/?62941>.  Thanks to Dave
	Kemper for the report and two useful end points for a bisection.

2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (environment::set_family): Add some
	paranoia.  Add `assert()`s on the previous font mounting
	position still being valid and the font family dictionary lookup
	not returning a null pointer.  Add an early return for the
	latter case (which should be impossible).

2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/node.cpp (font_family::make_definite):
	Refactor.  Rename parameter from inscrutable `i` to
	`mounting_position`.  Add `assert()` to enforce invariant: we're
	passed a mounting position that is nonnegative.  Use `pos` as
	short alias of parameter once we're into the function body.
	Relocate conditional branches to front-load early returns as
	well as those requiring little code to handle.  This reduces the
	average indentation level of the function, a readability win.

2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Restore robustness to `EE` misuse.

	* tmac/an.tmac: Add `an*is-in-example` register to track state
	of within-exampleness.  Not doing so can cause a spurious use of
	`EE` to wrongly set the inter-paragraph distance to zero.
	(TH): Initialize register.
	(EX): Test register; if set, ignore macro call and, if
	`CHECKSTYLE` warnings are on, throw diagnostic.  Set register.
	(EE): Test register; if clear, ignore macro call and, if
	`CHECKSTYLE` warnings are on, throw diagnostic.  Clear register.

	* tmac/an-ext.tmac (EX, EE): Similar, using `mX` register.
	Because AT&T troff had no `return` request, invert the sense of
	the tests and put the entire macro bodies inside conditionals.

	This regressed post-1.22.4.  Thanks to Ingo Schwarze for the
	report and a proposed patch.

2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Refactor.  Rename `mX` to `mZ` so we can use
	`mX` for an "in-example" state register in a future commit.
	Rename `mE` to `mF` to store the current font's mounting
	position.  Bizarrely, `mF` was not already used for this
	purpose.

2022-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
	Trivially refactor.  Use separate string constant for invariant
	material.  (This will make it easier to, for example, store the
	diagnostic level strings in an array that can be indexed by
	their corresponding `enum` type.)

2022-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (fatal_with_file_and_line)
	(error_with_file_and_line, debug_with_file_and_line): Align more
	closely with GNU Coding Standards regarding diagnostics: don't
	suffix the colon after the program name with a space when
	location information follows.

2022-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grohtml/grohtml.1.man: Fix erroneous claim.
	Images are not generated when "baseline rules" or "box rules"
	are encountered in the input.  These are troff special
	characters; the former is converted to an underscore and the
	latter to U+2502, "box drawings light vertical".  This remains
	true even if a series of them is drawn with the `\l` escape
	sequence.  (I also checked vertical line drawing with `\L`.
	grohtml's handling of that provoked a rather wet eructation from
	my lower esophageal sphincter--the output is assuredly not
	correct.  But it's still not an image.)

2022-08-22  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Bug #62934 - after glyph remapped mark it as used

	When many glyphs are remapped from code points above 255
	such as writing documents in cyrillic with the U-TR fonts,
	gropdf starts reusing code points in the range 128-255.
	If subsequently one of those code points is actually required,
	such as \(em (code 138), and it has been replaced by a
	cyrillic, then it needs to be mapped to another free code.

	To determine if a particular code point is free each glyph
	has a USED flag. The bug was caused because after remapping
	\(em to the next free glyph the USED flag was not set. So the
	next new cyrillic character to be entered was given the same
	code point as had been allocated to \(em.

	* src/devices/gropdf/gropdf.pl: Set the USED flag on remapped
	glyphs.

	Fixes <https://savannah.gnu.org/bugs/?62934>.

	Thanks to Nikita Ivanov for spotting the problem and testing
	the fix.

2022-08-20  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Bug #62923 - problem using aliased glyphs

	With a large font if 2 characters above the 255 code
	point limit are aliased, the aliased glyph has incorrect meta
	data.

	* src/devices/gropdf/gropdf.pl: Instead of duplicating a pointer
	to the font metadata, duplicate the data itself. Then, if the
	glyph is remapped to a code point under 256, the metadata is
	preserved.

	Fixes <https://savannah.gnu.org/bugs/?62923>.  Thanks to Nikita
	Ivanov for the report.

2022-08-18  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Improve parsing of troff font files.

	* src/devices/gropdf/gropdf.pl: Allow the glyph code number
	to be octal or hex as well as a decimal number. If entity_name
	is missing use name instead.

2022-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Support pic(1) "flyback" feature.

	* tmac/s.tmac (PF): Add macro; it does what `PE` formerly did,
	minus vertical spacing.
	(PE): Call `PF` and vertically space as before.

	* doc/groff.texi (ms Insertions):
	* doc/ms.ms (Tables, figures, equations, and references):
	* tmac/groff_ms.7.man (Tables, figures, equations, and
	references): Document it.

	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?60558>.

2022-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (@PS): Validate better; check for 2 arguments
	exactly.

2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pic]: Recognize `.PY` as synonym of `.PF`.

	* src/preproc/pic/main.cpp:
	* src/preproc/pic/pic.h: Add new Boolean variable,
	`want_alternate_flyback` to record `.PY` usage.

	* src/preproc/pic/main.cpp (top_input::get, top_input::peek):
	Recognize it.  Update diagnostic messages to mention it.
	(main): Define `PY` troff macro as empty if not defined.

	* src/preproc/pic/troff.cpp (troff_output::finish_picture):
	Don't advance the vertical position if `want_alternate_flyback`.
	Write out the `PY` macro call if it was on the input.

	* src/preproc/pic/pic.1.man: Document it.

	* tmac/pic.tmac (PY): Define the same as `PF`.

	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?62901>.

2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pic]: Refactor `flyback_flag`.

	* src/preproc/pic/main.cpp:
	* src/preproc/pic/pic.h:
	* src/preproc/pic/troff.cpp: Rename to `want_flyback`.

	* src/preproc/pic/main.cpp:
	* src/preproc/pic/pic.h: Demote type from `int` to `bool`.

	* src/preproc/pic/main.cpp (top_input::get, top_input::peek):
	Use parentheses to clarify operation precedence.

2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/eqn.1.man: Expand to include lists of
	recognized primitives and predefined macros.

2022-08-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* NEWS: Add item for new groff mm `V` register support.

2022-08-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/lex.cpp (do_delim): Recognize "delim on" even
	in compatibility mode, enabling tbl to toggle eqn delimiter
	recognition when it is run in compatibility mode as well.
	* src/preproc/eqn/eqn.1.man (Controlling delimiters): Update.
	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?62852>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-08-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TH): Fix spurious complaint from `CHECKSTYLE`
	feature when a custom manual section title is declared for a
	standard section number.  Thanks to Quentin Monnet for the
	report.

2022-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdfpic.tmac: Finish incomplete string renames.  Continues
	0fd6ab6b4c, 21 January.
		pdfpic*file-name -> pdfpic*file-name-base
		pspic-args -> pdfpic*pspic-args

2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TS): Stop inserting space before tables.  Unlike
	ms(7), man(7) has no concept of "displays" and thus none of
	"display distance".  It is up to the page author to use
	paragraphing macros around tables if vertical space is desired.
	And not up to us to impose it.

	Fixes <https://savannah.gnu.org/bugs/?62841>.

2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Regression-test Savannah #62841.

	* tmac/tests/an_TS-adds-no-vertical-space.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::do_bottom): Avoid
	overprinting a double-boxed table's bottom border on nroff
	devices.

2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Expand regression test for Savannah #49390.  Check for
	overlap of double box borders, too.

	* src/preproc/tbl/tests/\
	do-not-overlap-bottom-border-in-nroff.sh: Do it.

2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix Savannah #49390.

	* src/preproc/tbl/table.cpp (table::do_bottom): Avoid
	overprinting a boxed table's bottom border on nroff devices.

	Fixes <https://savannah.gnu.org/bugs/?49390>.  Thanks to Osamu
	Sayama for the report.

2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #49390.

	* src/preproc/tbl/tests/\
	do-not-overlap-bottom-border-in-nroff.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-07-28  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Improve slant application to lowercase Greek letters.
	<https://lists.gnu.org/archive/html/groff/2022-07/msg00210.html>

	* tmac/pdf.tmac: Slant only if the glyph is sourced from a
	special font, not a regular (text) font containing Greek glyphs.

2022-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Add italic correction support to `I` and `BI`
	macros.  Call `par*define-font-macro` with newly recognized
	third argument indicating that italic corrections should be
	applied.
	(par*define-font-macro): Apply the corrections if directed.

2022-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (input_char_description): Clear
	static buffer on every entry to the function so that calling it
	twice in succession where the second call populates the buffer
	with less data than the first doesn't leave garbage characters
	in a diagnostic message.  Problem appears to date back to 1991
	or earlier.

	Fixes <https://savannah.gnu.org/bugs/?62813>.

2022-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (token::usable_as_delimiter):
	(do_non_interpreted, interpolate_arg): Recast diagnostic
	messages for clarity.

2022-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Initialize section number registers. Fixes
	warnings when starting section numbering at a depth greater than
	1.

	Fixes <https://savannah.gnu.org/bugs/?62812>.

2022-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PAGE): Use 'grep -q' instead of redirecting
	standard output to null device.  The '-q' option was
	standardized in POSIX Issue 5 (1997) or earlier.  Also drop the
	redirection of the standard error stream; we have already
	checked the file named in "$descfile" for existence and
	readability.  grep should thus not emit diagnostic messages.

2022-07-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PAGE): Macro used awk(1) without
	`AC_REQUIRE`-ing a relevant macro or checking for its existence.
	Fortunately, sed is powerful enough for our needs.  Remove
	dependency on awk.  Cope with "search" directive in resolv.conf
	having multiple arguments.  Match "domain" directive in same
	file instead of "dom", which I cannot find attested (this logic
	dates to 1991).  Rename `dom` shell variable to `domains` for
	clarity, since its multiplicity could be greater than 1.

2022-07-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PAGE): Refactor: drop AC_DEFINE of
	`PAGEA4`.  This symbol appears to be a relic; it is nowhere
	tested or dereferenced.

2022-07-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tty-char.tmac: Drop definition of \[sd] special
	character.  This was superseded by commit 78e666246c, 8 May,
	which defined a fallback for the character in tty.tmac instead.
	Thanks to Dave Kemper for the catch.

2022-07-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
	Skip test if "pdfinfo" command not available.

2022-07-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Add sanity checks for font description file generation
	for PDF output device, prompted by discussion with Ingo
	Schwarze.  See <https://lists.gnu.org/archive/html/groff/\
	2022-06/msg00094.html>.

	* font/devpdf/tests/basic-fonts-present.sh:
	* font/devpdf/tests/urw-fonts-present.sh: Add files.

	* font/devpdf/devpdf.am (font_devpdf_TESTS): Add the former test
	unconditionally, and the latter only if `HAVE_URW_FONTS`.

2022-07-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am: Refactor to simplify.  Now that
	symbol.map lives in the "devpdf/generate" directory along with
	the other map files, it doesn't need a dedicated Makefile target
	to produce it.
	(DEVPDFFONTMAP_1, DEVPDFFONTMAP_2): Coalesce and rename to...
	(devpdffontmapdata): ...this.
	(font/devpdf/map/symbol.map:): Drop target.
	(devpdffontmap_DATA, font/devpdf/download): Update dependencies.

2022-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Recast
	diagnostic message so that the user understands the consequence
	of failure to locate a Type 1 font file (that isn't one of the
	base 14 PostScript level 1 fonts): the font will be unavailable
	for the "pdf" output device.

2022-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Separate
	lists of Type 1 font names with spaces as well as commas, for
	better diagnostic message readability.  Also begin message in
	lowercase (per GNU Coding Standards).

2022-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Verify that
	`$foundrypath->[$j]` is defined before operating on it.

2022-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[afmtodit]: Clarify diagnostic message.

	* src/utils/afmtodit/afmtodit.pl: When we have excess Adobe
	Glyph List mappings for a groff special character identifier
	{making the reverse mapping from groff special character to font
	glyph name ambiguous}, report that we're ignoring the excess.
	Use "print STDERR" instead of Perl "warn" built-in since we want
	diagnostic messages to start with the name of the program
	emitting them.

2022-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Name and place PS->groff glyph name maps consistently.

	* font/devps/symbolmap: Rename from this...
	* font/devps/generate/symbol.map: ...to this.

	* font/devpdf/devpdf.am (font/devpdf/map/symbolmap): Rename
	target...
	(font/devpdf/map/symbol.map): ...to this.
	(font/devpdf/map/symbol.map): Copy "devps" version of file from
	its new location in the "generate" subdirectory.

	* font/devpdf/Foundry.in: Reflect rename.

	* font/devps/generate/Makefile (symbolmap): Rename target...
	($(srcdir)/symbol.map): ...to this.

	* font/devps/devps.am (DEVPSGENFILES, EXTRA_DIST):
	* font/devps/generate/Makefile (S, EURO $(SPECIALFONTS), clean):
	* src/utils/afmtodit/afmtodit.1.man: Reflect rename and
	relocation.

	* font/devps/generate/dingbats.rmap: Rename from this...
	* font/devps/generate/dingbats-reversed.map: ...to this.

	* font/devps/devps.am (DEVPSGENFILES):
	* font/devps/generate/Makefile (ZDR):
	* src/utils/afmtodit/afmtodit.1.man: Reflect rename.

	* font/devps/generate/lgreekmap: Rename from this...
	* font/devps/generate/slanted-symbol.map: ...to this.

	* font/devps/devps.am (DEVPSGENFILES):
	* font/devps/generate/Makefile (SS):
	* src/utils/afmtodit/afmtodit.1.man: Reflect rename.

	* font/devps/generate/textmap: Rename from this...
	* font/devps/generate/text.map: ...to this.

	* font/devpdf/Foundry.in:
	* font/devpdf/devpdf.am (DEVPDFFONTMAP_1):
	* font/devps/devps.am (DEVPSGENFILES):
	* font/devps/generate/Makefile (TEXTMAP):
	* src/devices/gropdf/gropdf.1.man:
	* src/devices/grops/grops.1.man:
	* src/utils/afmtodit/afmtodit.1.man: Reflect rename.

2022-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/ms.ps): Add dependency on "eqn", and call
	groff with "-e" option.
	* src/utils/grog/tests/smoke-test.sh: Update expected "grog"
	output for the ms.ms document.

2022-07-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/ms.ps): Add dependency on "tbl".

2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/node.cpp (suppress_node::tprint): Add source
	file line number after its name when emitting "grohtml-info", to
	aid debugging.

2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/node.cpp (get_register, get_string): Reorder
	null pointer inequality comparisons; they don't need to be in a
	funny order because it's pretty hard to mistype `!=` as an
	assignment operator.  Annotate them as null pointers to ease any
	future migration to ISO C++11.  Use primitive type constructor
	instead of C-style cast operator; this seems more idiomatic.

2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (generateImages): Flush the
	standard error stream after writing to it in a loop.

2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (RP): Recognize new optional arguments
	`no-renumber` and `no-repeat-info`, the latter as a synonym for
	the existing `no`.  The former suppresses the page number
	manipulation that normally occurs.  Drop now-unnecessary `pn 0`
	request.
	(top level, cov*first-page-init, RP, cov*print): Rename
	`cov*rp-format` to `cov*use-rp-format` for clarity.
	(cov*break-page): New macro breaks the cover page at the end,
	resetting next page number to 1 only if desired by user.
	(cov*print, cov*rp-print): Call `cov*break-page` instead of
	invoking `bp`.

	* doc/groff.texi (Document Description Macros) <RP>:
	* doc/ms.ms (Document description macros) <RP>:
	* tmac/groff_ms.7.man (Document description macros) <RP>:
	Document them.

	* NEWS: Add item.

2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Rename register `cov*rp-no` to
	`cov*rp-no-repeat-info`.

2022-07-08  Deri James  <deri@chuzzlewit.myzen.co.uk>

	* font/devpdf/util/BuildFoundries.pl (LocateFile): Some systems
	store .afm files in a parallel directory to the Type 1 files,
	restore original path after checking for parallel directory.

2022-07-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am (font/devpdf/download): Call
	"BuildFoundries" with new `--strict` option so that the build
	fails if the AFM files for the URW fonts can't be found.

2022-07-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl: Add Boolean-valued scalar
	`beStrict` (defaults false) and new command-line option
	`--strict` to make it true.
	(LoadFoundry): Check return value of subroutine `LocateAF`.
	Emit diagnostic if it is null, as a warning if not "strict", and
	fatal if so.

2022-07-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries): Add
	dependency on "afmtodit" since "BuildFoundries" calls this
	program when generating groff font description files from URW
	fonts.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Fix Savannah #62690.

	* tmac/s.tmac (P1, SC, UC, P2): Drop undocumented support for
	document-private macros used by Kernighan & Cherry's
	"Typesetting Mathematics -- User's Guide (Second Edition)".

	Fixes <https://savannah.gnu.org/bugs/?62690>.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Fix Savannah #62688.

	* tmac/s.tmac (DE): Set no-space mode when ending displays.
	(@EN): Set no-space mode after outputting the display distance
	so that it doesn't combine with inter-paragraph space.

	Fixes <https://savannah.gnu.org/bugs/?62688>.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Regression-test Savannah #62688.

	* tmac/tests/s_no-excess-space-around-displays.tmac: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Fix Savannah #62687.

	* tmac/s.tmac (@MC): Honor `MINGW` register even when setting
	only two columns, as clearly implied by our documentation.

	Fixes <https://savannah.gnu.org/bugs/?62687>.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Regression-test Savannah #62687.

	* tmac/tests/s_honor-MINGW-when-two-columns.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Fix Savannah #62686.

	* tmac/s.tmac (@MC): Set no-space mode before doing a paragraph
	reset, not after: we don't want vertical space at the top of the
	first column when entering multi-column mode, because then it
	doesn't align with the tops of subsequent columns.

	Fixes <https://savannah.gnu.org/bugs/?62686>.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Regression-test Savannah #62686.

	* tmac/tests/s_mark-column-start-correctly.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (IX): Drop.
	* NEWS: Add item.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Add "sorry" implementations for documented but
	unsupported Unix Version 7 ms macros.  This way it's easier to
	tell when a historical document needs one and this case is
	distinguishable from a document-private macro warned about with
	"groff -w mac".

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (UX): Drop undocumented support for this macro.
	This implementation isn't consistent with historical ones, which
	identified the trademark holder.  But doing that is a problem,
	so just stop trying to cope.  Also, spelling Unix in full caps
	was an imposition by the AT&T legal department on the CSRC.

	"The name Unix is a trademark, originally owned by Bell Labs and
	subsequently traded off like a baseball card among a number of
	companies." -- Ben Klemens

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Replace incomplete documentation of unimplemented macros.

	* doc/groff.texi (Missing ms Macros):
	* doc/ms.ms (AT&T ms macros not appearing in groff ms): Drop,
	replacing with...

	* doc/groff.texi (Unix Version 7 ms Macros Not Implemented by
	groff ms):
	* doc/ms.ms (Unix Version 7 ms macros not implemented by groff
	ms):
	* tmac/groff_ms.7.man (Unix Version 7 macros not implemented by
	groff ms): ...these.

2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_translate): Throw an error
	diagnostic when the user attempts to translate space characters.
	{By contrast, translating _to_ [unbreakable, unadjustable]
	spaces is an old troff hack often seen as ".tr ~ ", and largely
	superseded by groff's "\~" escape sequence, now widely supported
	by other troffs.}

	Fixes <https://savannah.gnu.org/bugs/?60803>.  Thanks to T. Kurt
	Bond and Oliver Corff for the report.

2022-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/pipeline.c: Refactor.  Drop function rename via
	preprocessor macro usage.  Declare and define `c_error` by its
	correct name.
	(run_pipeline): Update call sites.  Stop flushing standard error
	stream after calling libgroff's `error` function (which
	`c_error` wraps); libgroff already guarantees this operation.

2022-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (abort_request): Flush the standard
	error stream before exiting, to improve chances of user seeing
	any message as arguments to the `ab` request.

2022-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp
	(char_buffer::run_output_filter): Die if platform supports
	neither `fork()` nor `spawn()` for child process creation.

2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (cleanup): Add function to tidy
	memory before exiting.
	(main): Register aforementioned function with `atexit()`.  Die
	if registration fails.

2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (do_file): Die if `fclose()`
	fails; such a situation suggests a pretty hosed environment.

2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (checkImageDir): If `mkdir()`
	fails, use `strerror()` to report the underlying problem.

2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp: Refactor.  Drop unnecessary
	prototype for static function.  Use idiomatic C++98 null pointer
	constant.  Annotate it as null pointer to ease any future
	migration to ISO C++11.  Boolify.  Use C++98 bool data type
	instead of preprocessor macros `TRUE` and `FALSE`.  Demote some
	global Boolean variables from `int` to `bool` and rename some to
	be more clear: `show_progress` -> `want_progress_report`;
	`debugging`; `eqn_flag` -> `need_eqn`.
	(make_message): Rename this...
	(make_string): ...to this.  Align more closely with contemporary
	version of example from Linux man-pages printf(3) page.  Use
	`vsnprintf()` to determine size of memory buffer needed prior to
	allocation instead of iteratively growing it until it is large
	enough.  Always die if `vsnprintf()` fails: this function now
	always returns a valid pointer if it returns at all.
	(makeFileName, setupAntiAlias, imageList::createPage,
	imageList::createImage): Update call sites to use
	`make_string()`.
	(char_buffer::can_see): Demote return type from `int` to `bool`.
	(char_buffer::skip_spaces): Drop unused member function.
	(char_buffer::read_file, makeTempFiles): Demote return type from
	`int` to `void`.  Stop returning after calling functions that
	don't return.
	(char_buffer::read_file): Call `sys_fatal()` if `fread()`
	returns an error, similarly to other calls into the standard C
	library that this file makes.  Improve check for error from
	`fread()` by not regarding a return value of zero when the
	end-of-file indicator is set as an error condition.
	(makeFileName, checkImageDir, char_buffer::run_output_filter,
	scanArguments): Call `fatal()` instead of `error()` and then
	`exit(1)`.
	(makeFileName, scanArguments): Dismiss Shlemiel the Painter:
	save return value of `strlen()` and call `strcpy()` multiple
	times instead of mixing `strcpy()` and `strcat()`; the latter
	approach rescans the string unnecessarily.
	(char_buffer::run_output_filter): Stop passing unnecessary null
	pointer argument to diagnostic message functions.  Stop calling
	`fflush()` after libgroff diagnostic function, which always
	{ultimately} flushes the standard error stream itself.
	(makeTempFiles, do_file, main): Boolify.
	(makeTempFiles, do_file): Reorder null pointer equality
	comparisons to avoid inadvertent lvalue assignment.
	(scanArguments, main): Use `EXIT_SUCCESS` and `EXIT_FAILURE`
	constants from C library instead of integer literals for exit
	status.
	(do_file): Demote return type from `int` to `bool`.  Return
	Boolean literals.  Drop conditional with empty consequent.
	(main): Declare local variables closer to the points of use.
	Stop trying to be a register allocator: stop reusing loop index
	variable `i` as integer storage for another (albeit related)
	purpose; introduce `operand_index` instead.  Clarify logic by
	splitting combined initialization and comparison operations, and
	by testing function return value directly instead of storing it
	in a pointless temporary.  Use `EXIT_SUCCESS` and `EXIT_FAILURE`
	constants from C library instead of integer literals for exit
	status.

2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (run_commands): Trivially refactor.
	Rename variable for clarity; add comment.

2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp
	(char_buffer::run_output_filter): Return wait status of child
	process.
	(char_buffer::run_output_filter, main): Rename local variable
	`status` to `wstatus` to recognize distinction between exit
	status (a 7-bit quantity) and wait status (a wider type).
	(main): Issue fatal diagnostic if child process exited with
	nonzero status.  Since the child's output to the standard error
	stream is lost, advise re-running with different output driver
	to see them.  This unhappy shortcoming is filed as Savannah
	#62673.  Explicitly return zero otherwise.

	Fixes <https://savannah.gnu.org/bugs/?60782>.

2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/ab_works.sh: Add regression test for
	Savannah #60782.

2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Trivially refactor.

	* src/roff/troff/input.cpp (token::next): Rename statement label
	to use documentary terminology.
	* src/roff/troff/node.cpp (make_composite_node)
	(make_glyph_node): Make functions static since nothing outside
	this translation unit calls them.
	* src/roff/troff/node.cpp (make_glyph_node): Refactor optional
	argument and its usage.  Put it down, flip it, and reverse it.
	That is, demote its type from `int` to `bool`, invert its sense,
	and rename it since it affects warning, not error, diagnostics.
	(character_exists): Update only call site of `make_glyph_node()`
	that uses non-default argument value.

2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Adjust diagnostic message text to clarify and better
	match terminology used in documentation.

	* src/roff/troff/input.cpp (set_escape_char, do_overstrike)
	(do_bracket, do_name_test, do_width, do_special):
	* src/roff/troff/node.cpp (suppress_node::tprint): Migrate from
	"escape" to "escape sequence".

	* src/roff/troff/node.cpp (make_composite_node)
	(make_glyph_node): Clarify what went wrong.

	* src/roff/troff/input.cpp (token::get_char)
	(check_missing_character): Migrate from "normal character" to
	"ordinary character" (see groff_char(7)).

2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Rename a function for clarity.

	* src/roff/troff/input.cpp (add_to_node_list): Rename this...
	(add_to_zero_width_node_list): ...to this.
	(do_zero_width): Update call site.
	* src/roff/troff/token.h: Update declaration.

2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (handle_unknown_desc_command):
	Refactor to skip unnecessary string comparisons.  We explicitly
	return in the final case instead of falling off the end of this
	void function for consistency if additional cases are added.

2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (handle_unknown_desc_command):
	Partially revert commit 64dc40d23a, 19 June.  I forgot to save
	and restore the previous values of the globals
	`current_filename` and `current_lineno`, and, noticing that this
	function has 3 return paths, decided that it's cheaper just to
	go back to `error_with_file_and_line()`.

2022-06-21  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Add more search paths to the Foundry file.

	* font/devpdf/Foundry.in: Use the directory specified with the
	config flag --with-urw-fonts-dir to populate the default foundry
	as well as the U foundry. Important to populate the download
	file with font files to embed the fonts not part of the base
	pdf fonts or if user wants all fonts embedded.

2022-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (UR, MT): Fix problem with hyphenation
	occurring before the end of the line when the line length was
	not the device default (common for man pages at the terminal)
	and hyperlinks were enabled.  The issue is that the new
	environment we created inherits the default environment's line
	length (its state at troff initialization, prior to macro
	package loading and configuration).  This latent issue was
	exposed by post-groff 1.22.4 changes to enable the hyphenation
	of link text and add the hyperlink feature.  Fix it by copying
	the line length at the time the macro is called, which is
	necessarily after man(7) sets up the line length, to the new
	environment.

2022-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/psrm.cpp (resource_manager::output_prolog):
	(resource_manager::supply_resource):
	(resource_manager::read_download_file): Update diagnostic
	message language and report underlying problem encountered by
	system when failing to open files.  This will probably be the
	text for ENOENT in most cases, but should help avoid frustration
	in those where it isn't.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/psrm.cpp
	(resource_manager::read_download_file): Align diagnostic message
	wording with gropdf in the same circumstance.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Throw warning in font category when a font selection
	escape sequence is used after the output line continuation
	escape sequence on an input line, because it is ignored.

	* src/roff/troff/env.cpp (environment::set_font): Do it.

	* doc/groff.texi (Warnings):
	* src/roff/troff/troff.1.man (Warnings): Document it.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (font_change): Boolify.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (LoadFont): Revise error message
	when a font can't be found for embedding.  User failure to add
	an entry for locating the font file seems a more likely scenario
	than outright corruption of the file.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (font_change): Warn upon selection of a
	nonexistent font name.

	Fixes <https://savannah.gnu.org/bugs/?62656>.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Revise `environment::set_font` to return Boolean value
	indicating success of font selection operation.

	* src/roff/troff/env.cpp (environment::set_font):
	* src/roff/troff/env.h (environment::set_font): Do it.

	This prepares the way for a fix for Savannah #62656.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp: Use single exit path, freeing
	memory allocated for strings.
	(xexit): Add `exit()` wrapper; free allocated memory.
	(main): Use it in all three exit paths.

2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp: Refactor to be more meticulous with
	memory.  Add globals `saved_path`, `groff_bin_path`, and
	`groff_font` to store pointers into the process environment
	returned by `putenv()`; once used, they need to remain valid for
	the lifetime of the program.
	(xstrdup): Add `strdup()` wrapper: dies if `strdup()` fails.
	(main): Split nested `strsave()` and `xputenv()` (until recently
	`putenv()`) calls.  Free duplicate strings prior to exit.

2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (main): Rename temporary variable to
	avoid shadowing one in enclosing scope, which can lead to
	cut-and-paste errors (ask me how I know).

2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp: Slightly refactor to indirect
	`putenv` calls through an error-checking wrapper.
	(xputenv): Add new function to die if `putenv()` fails.
	(main): Update call sites to use it.

2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[groff]: Add information to diagnostic messages.

	* src/roff/groff/groff.cpp (main): Report underlying system
	error if `putenv()` fails.
	(handle_unknown_desc_command): Set globals `current_filename`
	and `current_lineno` from `filename` and `lineno` arguments
	passed to us to we can use the simpler interface of `error()`
	rather than `error_with_file_and_line()`.

2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Update return type of `font::load_desc` function to
	enable more informative diagnostics from callers.

	* src/include/font.h (font::load_desc): Change return type from
	`bool` to `const char` pointer.
	* src/libs/libgroff/font.cpp (font::load_desc): Return null
	pointer literal on failed `open()` or validation failures.
	Return filespec on success.

	* src/libs/libdriver/input.cpp (do_file):
	* src/preproc/grn/main.cpp (getres):
	* src/roff/groff/groff.cpp (main):
	* src/roff/troff/input.cpp (main): Compare `font::load_desc()`
	return value to null pointer literal instead of treating it as a
	Boolean.

	* src/roff/groff/groff.cpp (main): Report full filespec of
	troublesome "DESC" file when complaining of missing "postpro"
	directive.

2022-06-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp: Add new Boolean global,
	`need_postdriver`, and initialize it true.
	(main): Make `need_postdriver` false if the `-X` or `-Z` options
	are given.  Test it later.  This prevents groff from exiting
	with a fatal error if an output driver is not available, but
	also not required.  Also reorder null pointer equality
	comparison to avoid inadvertent lvalue assignment.

	Fixes <https://savannah.gnu.org/bugs/?62640>.

2022-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (help): Revise usage message for
	expressiveness and clarity.

2022-06-21  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Correct display of pathnames used.

	* font/devpdf/util/BuildFoundries.pl: Convert array to
	string of pathnames.

2022-06-21  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Fix to gropdf.

	* src/devices/gropdf/gropdf.pl: If pdfbookmark was called
	within 5p of top of page (e.g. straight after a .bp when
	\n[nl] was zero) the click destination would be off by a
	page.

2022-06-19  Ingo Schwarze <schwarze@openbsd.org>

	* font/devpdf/devpdf.am: Always build PDF font description
	files.

	Build font/devpdf/download and the various TR, TB, CR etc.
	files in the same directory even when they are not required
	by the build because USE_GROPDF is unset, usually because
	ghostscript is either unavailable or deliberately disabled
	by the person running the build.  These files need to be
	built and installed anyway, and can be used on the target
	system when the required infrastructure is available at run
	time.

2022-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Revise introduction of vertical spacing concept to avoid
	render inference that the formatter will compute a vertical
	spacing appropriate to the type size automagically--it will not.

	Fixes <https://savannah.gnu.org/bugs/?62617>.  Thanks to Dave
	Kemper for the report.

2022-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Revise discussion of end-of-sentence detection.

	* doc/groff.texi (Filling):
	* man/roff.7.man (Concepts): Do it.  "Spaces" is a now a term
	with a much more restricted usage.  Emphasize the input context,
	now explicitly identified as plain text files with Unix line
	endings.

	Fixes (one hopes) <https://savannah.gnu.org/bugs/?62593>.
	Thanks to Ingo Schwarze for the report and Dave Kemper for the
	discussion.

2022-06-10  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Changes to BuildFoundries.

	* font/devpdf/util/BuildFoundries.pl: Collect search paths into
	an array rather than a colon delimited string, this allows
	the @PATH_SEPARATOR@ character (':' or ';') to be used to
	delimit paths yielded by the command 'gs -h' but still use ':'
	to delimit paths in the Foundry file. This means the same
	Foundry file can be used on all systems.

	* font/devpdf/Foundry.in: Add more likely paths to find the URW
	fonts.

2022-06-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Weaken dependency on TeX, instead using it (to generate
	the DVI and PDF forms of our Texinfo manual) only if it is
	available.

	* m4/groff.m4 (GROFF_USE_TEX_CHECK): Check for presence of 'tex'
	executable in path.  Set shell variable `groff_use_tex` to "yes"
	if present, and "no" otherwise.  This check runs only if the
	'makeinfo' and 'texi2dvi' version checks have already passed.

	* configure.ac: Run the new check.  Set Automake conditional
	`USE_TEX` only if shell variable `groff_use_tex` is "yes".
	Report whether "groff.dvi" and "groff.pdf" are (re-)buildable.

	* doc/doc.am: Parameterize names of groff.{dvi,pdf} targets as
	Make macros `GROFF_DVI` and `GROFF_PDF`.  Define them only if
	`USE_TEX`.  Do _not_ update `EXTRA_DIST` macro; leave the
	literal file names there because we require that distribution
	archives contain these files.
	(.texi.dvi, .texi.pdf): Update suffix rules to check `USE_TEX`
	and fail, complaining of missing 'tex' program, if these targets
	are attempted without it being true.  Only manually specifying
	the file names as targets to 'make' or attempting to generate a
	distribution archive without TeX present should cause these
	errors.

	* INSTALL.REPO: Update dependency information.

	Fixes <https://savannah.gnu.org/bugs/?62592>.  Thanks to Deri
	James for the report.

2022-06-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (.texi.dvi, .texi.pdf, $(DOC_GNU_EPS)): Quote names
	of programs when aborting because they're missing.

2022-06-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PROG_MAKEINFO, GROFF_PROG_TEXI2DVI):
	Largely revert commit d5013ededc, 21 May: run checks for
	'makeinfo' and 'texi2dvi' programs regardless of presence of
	".tarball-version" file.  Their presence is a necessary (but not
	sufficient) condition for refresh of formatted forms of our
	Texinfo manual if the source is modified.

	Begins addressing <https://savannah.gnu.org/bugs/?62592>.

2022-06-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Rename some groff Autoconf macros to better match
	Autoconf's own naming conventions.

	* m4/groff.m4 (GROFF_MAKEINFO): Rename to...
	(GROFF_PROG_MAKEINFO): ...this.
	(GROFF_TEXI2DVI): Rename to...
	(GROFF_PROG_TEXI2DVI): ...this.

	* configure.ac:
	* m4/groff.m4 (GROFF_TEXI2DVI): Update call sites.

2022-06-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (SH, SS, B, I, SM, SB): Set input trap with `it`
	instead of `itc` for better Unix Version 7 man(7) compatibility.

	Fixes <https://savannah.gnu.org/bugs/?51468>.  Also see
	discussion at
	https://lists.gnu.org/archive/html/groff/2022-06/msg00020.html
	et sequentia (amid a vigorous bikeshedding of `\&`'s name).

2022-06-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Regression-test use of input traps.

	* tmac/tests/an_use-input-traps-correctly.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-06-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (LoadDesc): Validate device
	description file for essential directives and acceptable values
	as grops(1) does.

2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff, grohtml, grops, grotty]: Update wording of diagnostic
	messages to refer to "motion quantum" rather than "resolution"
	where appropriate.

	* src/devices/grohtml/post-html.cpp
	(html_printer::html_printer):
	* src/devices/grops/ps.cpp (ps_printer::ps_printer):
	* src/devices/grotty/tty.cpp (tty_printer::set_char)
	(tty_printer::add_char, tty_printer::end_page):
	* src/roff/troff/env.cpp (line_length, title_length): Do it.

2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl: Do more "DESC" file validation.
	(LoadDesc): Bomb out gracefully if any of "unitwidth", "res", or
	"sizescale" missing from "DESC" file.  This prevents Perl
	warnings about use of uninitialized values, and undoubtedly
	mangled output.

2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl: Revise diagnostic message
	handling.
	(top level): Add new scalar `progname` to house executable name.
	(Msg): Output messages in format recommended by GNU Coding
	Standards manual.  Identify who's talking (Savannah #52463).
	Rename `lev` scalar to `fatal` since it is used only as a
	Boolean for immediately exiting with failure status.  Report
	diagnostic severity as part of message.
	(Warn, Die): Add new subroutines through which all diagnostics
	are now emitted.
	(top level): Migrate a use of Perl `die` builtin to our `Die`.
	(top level, ToPoints, LoadDownload, LoadDesc, do_x, GetPoints,
	LoadSWF, LoadPDF, LoadStream, BuildStream, ParsePDFHash,
	LoadFont, GetType1, GetChunk, RemapChr, do_N): Migrate `Msg(0,
	...)` calls to `Warn` and `Msg(1, ...)` to `Die`.  Begin
	messages in lowercase (GNU Coding Standards).  Recast a few
	messages for clarity.

	Continues the long process of fixing Savannah #52463.

2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (Load_Config): Drop unused
	subroutine and its commented-out call site, which came in that
	way in July 2011.

2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (LoadFont): Warn if a font to be
	embedded in PDF output cannot be located in the "download" file.

	Fixes <https://savannah.gnu.org/bugs/?62572>.  Thanks to Deri
	James.

2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/a4.tmac: Drop file from distribution.  It has been
	superseded by papersize.tmac for nearly 20 years.
	* tmac/tmac.am (TMACNORMALFILES): Delete reference.
	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?62569>.

2022-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Parameterize X11-related man pages, so they don't get
	spuriously generated (and not cleaned) when building with X11
	support disabled.

	* Makefile.am (.man): Fix logic nit: drop unnecessary removal of
	target before clobbering it with sed.
	* src/devices/xditview/xditview.am (GXDITVIEW_MAN1): Add new
	macro, expanding to nothing if `WITHOUT_X11` and to the target
	name otherwise.
	(man1_MANS): Append `GXDITVIEW_MAN1` expansion, not a literal.
	* src/devices/xditview/xditview.am (XTOTROFF_MAN1): Add new
	macro, expanding to nothing if `WITHOUT_X11` and to the target
	name otherwise.
	(man1_MANS): Append `XTOTROFF_MAN1` expansion, not a literal.
	* doc/doc.am (GROFF_MAN_PAGES1): Append foregoing expansions
	instead of literals.

2022-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Add `AM_CONDITIONAL`: `HAVE_URW_FONTS`, so our
	Automake files can more easily cope with their absence.
	* font/devpdf/Foundry.in: Add easily matched phrases to
	comments, to clearly delimit the URW foundry portion of the file
	so it can be omitted if those fonts are absent.
	* font/devpdf/devpdf.am (font/devpdf/Foundry): Generate file
	differently depending on `HAVE_URW_FONTS`; keep the existing
	procedure if true, and delete the URW section from the generated
	file otherwise, avoiding diagnostic messages from afmtodit(1)
	and our BuildFoundries script.

	Fixes <https://savannah.gnu.org/bugs/?62570>.

2022-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries):
	Generate script using the `PATH_SEPARATOR` Automake macro.
	* font/devpdf/util/BuildFoundries.pl: Add `pathsep` scalar to
	house the build-time path separator.
	(LocateFile): Use it.
	(LoadFoundry, CheckFoundry): Stop using spaces as part of the
	path separation delimiter.  It is not idiomatic.

2022-06-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Explicitly identify poppler tools in report.

2022-06-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl: Trivially refactor.  Drop
	unused hash `foundry`.  Drop scalar `warn` that was set and
	updated but never tested.

2022-06-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl: Alter script to write to
	the standard output stream instead of (re)writing a file named
	"download" in the current working directory.  This recovers from
	a problem I introduced in commit 6e62be835d, 2 May, as an
	unforeseen side effect of improving build parallelism so that
	the "download" file wouldn't be read until it was fully
	populated.  As a side benefit, this approach is more Unixy, and
	less dependent on $PWD.
	(top level): Stop calling `WriteDownload` with an argument.
	(LoadFoundry): Close only the file handle of interest when done,
	not all of them (including `STDOUT`, which we now need).
	(CheckFoundry): Same--just for cleanliness, since at present
	running the script in 'check' mode doesn't write to any streams.
	(WriteDownload): Stop taking an argument and manipulating file
	handles.  Write download file to standard output.
	(LoadDownload, WriteDownload): Drop `top` scalar, used as a
	mutex to serialize read and write access to "download" file; it
	is no longer needed since the "download" file is now only read.

2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Rename shell variables and Autoconf/Automake macros of
	Boolean sense to have names more like logical predicates and
	avoid doofy "DONT" nomenclature.

	* m4/groff.m4 (GROFF_MAKE_RM): Rename shell variable
	`groff_is_rm_defined` to `groff_make_defines_rm` (purely for
	clarity; it already had a good name).
	(GROFF_MAKE_RM): Rename this...
	(GROFF_MAKE_DEFINES_RM): to this, to make parallelism obvious,
	and enabling...
	* configure.ac: ...rename of `MAKE_DONT_HAVE_RM` to
	`MAKE_DEFINES_RM` with sense of test reversed.  Also interpolate
	`GROFF_MAKE_DEFINES_RM` instead of `GROFF_MAKE_RM`.  This in
	turn enables...
	* Makefile.am: ...revision of conditional from
	`MAKE_DONT_HAVE_RM` to "!`MAKE_DEFINES_RM`".

2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS_PATH)
	(GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_APPDEFDIR_OPTION)
	(GROFF_UCHARDET): Recast help strings to more closely parallel
	structure and style of Autoconf's own help strings.
	(GROFF_WITH_COMPATIBILITY_WRAPPERS): Recast to tighten wording.

2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac:
	* m4/groff.m4 (GROFF_APPDEFDIR_OPTION, GROFF_APPDEFDIR_DEFAULT)
	(GROFF_APPDEFDIR_CHECK): Rename m4 macros and shell variable
	from "*appres*" to "*appdef*.  Update interpolation sites.

	* configure.ac:
	* m4/groff.m4 (GROFF_APPDEFDIR_CHECK): Further rename this...
	(GROFF_APPDEFDIR_NOTICE): ...to this, for consistency with other
	post-report output macros.

	* Makefile.am:
	* PROBLEMS:
	* doc/automake.mom:
	* src/devices/xditview/xditview.am: Update interpolation sites
	of `appresdir`.

	* Makefile.am:
	* src/devices/xditview/gxditview.1.man:
	* src/roff/groff/groff.1.man: Update interpolation sites of
	`APPRESDIR`.

	* NEWS: Add item.

2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_X11, GROFF_UCHARDET): Drop redundant
	messages (which are easily overlooked amid the torrent of
	"checking" output anyway).  Discovery failures of X11 and the
	uchardet library are already parts of the configuration report
	at or near the end of output.

2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PNMTOPS_NOSETPAGE): Partially revert change
	from 21 May and document why in a comment.

2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/troffrc: Skip loading of "papersize.tmac" if not in troff
	mode.

	Fixes <https://savannah.gnu.org/bugs/?62238>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Report use of "g" prefix for commands and macro
	package compatibility wrappers.
	* m4/groff.m4 (GROFF_G): Fix code style nits.  Update
	indentation to match recent practice.

2022-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Fix code style nits and tweak report.  Stop
	superfluously using braces for shell parameter expansions that
	don't require them.  The shell is not make(1).  Say
	"installation _directory_ prefix" since another kind of prefix
	can be used by groff (the "g" in front of command and macro
	package names shared with AT&T troff).

2022-05-31  Dave Kemper <saint.snit@gmail.com>

	* doc/groff.texi: Fix content and style nits.
	  - Remove redundancy ("fixed-width... character that can't be
	    adjusted").
	  - Fix incorrect word ("environment value" -> "environment
	    variable").
	  - Add or change the placement of a couple tie{}s to comport
	    with style-guide recommendation.
	  - Grammarify.
	  - Clarify and tighten wording.

	Fixes <https://savannah.gnu.org/bugs/?62551>.

2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/node.cpp (font_position): If mounting a font
	fails and a third argument was given (to the `fp` request),
	report its value in the diagnostic message.  This could reveal a
	prohibited attempt at directory traversal.  See commit
	a891161bc9, 7 November.

2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/fontfile.cpp (font::open_file): Refactor.
	Move more logic, including memory allocation, inside conditional
	that accepts only file names without '/' characters, skipping
	unnecessary work in the alternative.  Annotate use of zero
	literals as null pointers to ease any future migration to ISO
	C++11.  Add 'const' qualifier to variable that doesn't require
	modification (and which is used in the LHS of an equality
	comparison, so that clumsy operator misuse will provoke a
	compiler warning).

	Fixes <https://savannah.gnu.org/bugs/?62532>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: In configuration report, say that we're
	reporting compiler options along with the compiler executable.
	Fix leftover test(1) comparison with garbage, overlooked in
	commit faa22d89d2, 20 May.

2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/meintro_fr.ps): Build with '-t' option.

	Fixes <https://savannah.gnu.org/bugs/?62542>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-05-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.1.man (Options) <-l>: Handle case where
	no default print spooler is configured, and report formatter
	behavior correctly if it isn't.

	Fixes <https://savannah.gnu.org/bugs/?62535>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-05-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am (.man): Process '@PSPRINT@' substitutions with
	"makevarescape.sed".

2022-05-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PROG_YACC, GROFF_MAKEINFO, GROFF_TEXI2DVI):
	Fix logic error in detection of build scenario: the presence of
	a ".git" directory is not an indicator that we're not building
	from a distribution archive, because we might be building from a
	snapshot archive (which also lacks it).  Instead, perform checks
	required only by builds from Git checkouts and snapshot archives
	if the ".tarball-version" file is not present.

2022-05-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am (EXTRA_DIST): Ship "HACKING" file.

2022-05-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* bootstrap.conf: Add "pkg-config" to `buildreq`.  Not having it
	causes pretty horrible macro expansion problems and diagnostics
	when 'autoreconf' is run; they're still pretty bad even if you
	use `AC_REQUIRE` and `m4_pattern_forbid`.  So just demand it.

2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devps/S:
	* font/devps/symbolmap: Drop excess mapping of `*U` special
	character.  groff maps it to the Adobe Glyph List name
	'Upsilon1'.  (The AGL 'Upsilon' is a homoglyph of the Latin
	capital 'Y'.)
	* PROBLEMS: De-document build-time warning, now resolved.

2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.tables: Regenerate using Unicode
	14.0.  No substantive changes.

2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/make-afmtodit-tables: Refactor.  Drop
	unused variable `prog`.  Use value of `CPP` from environment (if
	defined) and use parameter expansion to apply a default if null
	or not set.  Use for loop to eliminate duplicative if statement.
	Test input files for readability, not just existence.  Use more
	portable test(1) and shell syntax.  Swap usage error and fatal
	error exit statuses; using "1" for failure and "2" for usage
	errors is more common in shell scripts I've seen.  Update usage
	message to put non-literal parameter in full caps, and clarify
	its name.  Update comment blocks written to generated files to
	further clarify data provenance.

2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PRINT): Refactor.  Stop performing checks
	for spooler options if none is available.  Stop redundantly
	reporting command name used for spooling PostScript files.  If
	an option is required for spooling DVI files, report it alone
	instead of repeating the command name as well.

2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Fix insensitivity of groff(1) man page to configured spooler.

	* Makefile.am (.man): Replace `@PSPRINT@` in man page sources
	with name of configured print spooler command.
	* src/roff/groff/groff.1.man (Options) <-l>: Use configured
	print spooler command instead of literal 'lpr'.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_UCHARDET_CHECK): Fix grammar nit in failure
	message when user demands uchardet support but the library
	cannot be located.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_CHECK_GROHTML_PROGRAMS): Fix logic error in
	computation of verb to be used in notice message.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PROG_YACC, GROFF_URW_FONTS_CHECK)
	(GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_UCHARDET_NOTICE):
	Improve shell code portability.  Per the GNU Autoconf manual,
	"The -a, -o, '(', and ')' operands are not present in all
	implementations, and have been marked obsolete by Posix 2008.
	...portable uses of test should never have more than four
	arguments, and scripts should use shell constructs like '&&' and
	'||' instead."

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.1.man (Installation directories): Don't
	output a tagged paragraph for the X11 application defaults
	directory if the build symbol '@APPRESDIR@' is not defined (that
	is, we didn't build with X11 support).

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Fix code style
	nits.  Use lowercase for shell variables we define.  Don't quote
	literal operands to test(1) that don't contain syntactically
	shell-significant characters.  Update indentation to match
	recent practice.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS_NOTICE): Don't emit the notice if
	Ghostscript isn't available, since it was a prerequisite for
	the `GROFF_URW_FONTS_CHECK` macro in the first place.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Add print spooler determination to configuration
	report.

	* m4/groff.m4 (GROFF_PRINT): Add shell variable
	`groff_have_spooler` to house the name of the print spooler
	{"lp" or "lpr"} or the word "no".
	* configure.ac: Report determined spooler, or its absence.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Skip
	seekability check of the standard input stream if there is no
	controlling terminal.

	Fixes <https://savannah.gnu.org/bugs/?62506>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_CHECK_GROHTML_PROGRAMS): Migrate from
	`AC_FOREACH` to `m4_foreach` to avoid obsolescence warning from
	GNU Autoconf 2.70 or later.

	Fixes <https://savannah.gnu.org/bugs/?61059>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man: Rename "pilot" list macros for man(7) from
	`BL`/`EL` to `LS`/`LE`, per suggestion from Alejandro Colomar.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_MAKEINFO, GROFF_TEXI2DVI): Check for
	makeinfo(1) and texi2dvi(1) programs only if building from Git,
	not a distribution archive.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/meintro_fr.ps): Call groff with `-K utf8`
	instead of `-k`, in case the "configure" script didn't find
	uchardet (and preconv(1) thus can't auto-detect an encoding).

	Fixes <https://savannah.gnu.org/bugs/?59463>.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Skip
	a check if /dev/stdin is not a character special device.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PDFTOOLS): Rename this...
	(GROFF_POPPLER): ...to this.
	* configure.ac: Update call site.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_UCHARDET_CHECK): Rename this...
	(GROFF_UCHARDET_NOTICE): ...to this.
	* configure.ac: Update call site.

	* m4/groff.m4 (GROFF_UCHARDET_NOTICE): Tighten wording of
	message reported to user.

	Fixes <https://savannah.gnu.org/bugs/?59481>.  Thanks to Dave
	Kemper for the report.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PNMTOOLS_CAN_BE_QUIET)
	(GROFF_PNMTOPS_NOSETPAGE): Skip check if prerequisite not met.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): Rename this...
	(GROFF_URW_FONTS_NOTICE): ...to this.
	(GROFF_URW_FONTS): ...and this...
	(GROFF_URW_FONTS_CHECK): ...to this.
	(GROFF_URW_FONTS_NOTICE): Give lengthy notice message a one-line
	summary.
	* configure.ac: Update call sites.

2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS): Refactor.  If our prerequisites
	are not met (availability of 'awk' and 'gs'), don't even run the
	check logic or print a "checking" message.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	Handle missing programs required to construct files needed at
	runtime by gropdf more gracefully.  Rename and refactor
	configuration-time logic to be more understandable.

	* configure.ac:
	* m4/groff.m4: Rename `GROFF_PDFDOC_PROGRAMS` macro to
	`GROFF_CHECK_GROPDF_PROGRAMS`.  Rename shell variable
	`make_pdfdoc` to `use_gropdf`.  Set it explicitly to "no" or
	"yes" instead of null or not null.

	* configure.ac:
	* m4/groff.m4:
	* doc/doc.am: Rename `BUILD_PDFDOC` to `USE_GROPDF`.

	* configure.ac: Call `GROFF_GROPDF_PROGRAM_NOTICE`.

	* doc/doc.am: Bracket definition of `PROCESSEDDOCFILES_PDF`
	macro and `$(PROCESSEDDOCFILES_PDF)` dependency declaration in
	Automake `if USE_GROPDF` conditional.  This prevents attempts
	to build PDF documents using groff that are doomed to fail.

	* m4/groff.m4: Refactor gropdf runtime-dependency program check.
	Split into two macros: one (`GROFF_CHECK_GROPDF_PROGRAMS`)
	performs the check, the other (`GROFF_GROPDF_PROGRAM_NOTICE`)
	issues a notice at the end of the configuration process if at
	least one program was not found.  Rename `docnote` shell
	variable to `gropdf_notice`.  Tighten wording of notice.  Drop
	unused `make_install_pdfdoc` and `make_uninstall_pdfdoc` shell
	variables.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	Handle missing programs required at runtime by grohtml more
	gracefully.  Rename and refactor configuration-time logic to be
	more understandable.

	* configure.ac:
	* m4/groff.m4: Rename `GROFF_HTML_PROGRAMS` macro to
	`GROFF_CHECK_GROHTML_PROGRAMS`.  Rename shell variable
	`make_htmldoc` to `use_grohtml`.  Set it explicitly to "no" or
	"yes" instead of null or not null.

	* configure.ac:
	* m4/groff.m4:
	* doc/doc.am: Rename `BUILD_HTML` to `USE_GROHTML`.

	* configure.ac: Call `GROFF_GROHTML_PROGRAM_NOTICE`.

	* doc/doc.am: Bracket definition of `PROCESSEDDOCFILES_HTML`
	macro and `$(PROCESSEDDOCFILES_HTML)` dependency declaration
	in Automake `if USE_GROHTML` conditional.  This prevents an
	attempt to build an HTML version of the "pic.ms" document that
	is doomed to fail (noisily).

	* m4/groff.m4: Refactor grohtml runtime-dependency program
	check.  Split into two macros: one
	{`GROFF_CHECK_GROHTML_PROGRAMS`} performs the check, the other
	{`GROFF_GROHTML_PROGRAM_NOTICE`} issues a notice at the end of
	the configuration process if at least one program was not found.
	Rename `html_docnote` shell variable to `grohtml_notice`.
	Tighten wording of notice.  Drop unused `make_install_htmldoc`
	and `make_uninstall_htmldoc` shell variables.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_NOTICE): Add newline at
	end of buggy Ghostscript notification, so that the multiple
	possible lengthy notices after the configuration report have
	blank lines separating them.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	Check for m4 program at configuration time.

	* m4/groff.m4 (GROFF_PROG_M4): Define new macro to perform the
	check and error out if the program is missing.
	* configure.ac: Call the new macro.
	* tmac/tmac.am (tmac/groff_man.7.man)
	(tmac/groff_man_style.7.man): Use the new implicitly AC_SUBST-ed
	variable `M4` to run the program.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_PROG_YACC): Update wording of error
	message: we search for "yacc", so report it as missing if it is
	not found (along with "byacc" and "bison").

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Fix shell style nits.  Get rid of string
	{non-}nullity tests and comparisons involving concatenation with
	garbage (usually "x").  See 13 November entry regarding m4.  Use
	idiomatic shell "brace style" for control structures.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	Trivially refactor libgroff allocator configuration.

	* m4/groff.m4 (GROFF_USE_GROFF_ALLOCATOR): Update description of
	configuration flag to clarify that it's implemented in a
	library.  Rename shell variable to prefix it with "groff_",
	putting it in an ad hoc name space as with other variables.  If
	feature disabled, set variable to literal "no".
	* configure.ac: Use renamed variable and interpolate it directly
	into configuration report, simplifying shell logic.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Revise configuration report for intelligibility.
	Add report of C++ compiler and flags used: we compile much more
	C++ than C code so this seems appropriate.  Report Perl
	interpreter version so that we can collect build reports and
	turn the ratchet past Perl 5.6.1 at some point.  Fix X11
	"resources" misnomer (application defaults are what is meant).
	Rephrase generally.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am (EXTRA_DIST): Ship "ChangeLog.122" in distribution
	archive.  Overlooked in commit c11995df16, 19 February 2021.

2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
	Fix portability problem: POSIX says that "od -c" (and "od -t c")
	are supposed to emit printing characters as defined by the
	underlying locale, but GNU coreutils od doesn't do this and
	macOS od does.  Set `LC_ALL` to "C" when running it to force
	3-digit octal reporting of characters with their eighth bit set.

	Fixes <https://savannah.gnu.org/bugs/?62357>.  Thanks to John
	Gardner for the report.  Also see <https://pubs.opengroup.org/\
	onlinepubs/9699919799/utilities/od.html>.

2022-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* INSTALL.extra (In Case of Trouble): Add advice on using the
	test suite, particularly if it fails.

	Fixes <https://savannah.gnu.org/bugs/?62478> (one hopes).

2022-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Input Line Traps):  Expand discussion.  The
	`it` and `itc` requests count neither input lines (strictly) nor
	text lines.  Instead, they count input lines that _directly
	produce formatted output_ (and, in the case of `itc`, are not
	"interrupted" or continued with the `\c` escape sequence).  This
	is useful--empty requests and requests that don't put nodes on
	the output don't break things--but does demand some explanation.
	Clarify and provide example.
	* man/groff.7.man (Escape sequence short reference) <it>: Sync.

2022-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (environment::choose_breakpoint): Tweak
	diagnostic message ("can't" -> "cannot").
	* doc/groff.texi (Breaking): Update example.

2022-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Copy Mode):
	* man/groff.7.man (Copy mode): Fix omission; `\?` is interpreted
	in copy mode.

2022-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (PT): Unclutter name space; remove
	`pg*saved-page-number-format` string when we're done with it.

2022-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Add unit tests, including one XFAIL for bad behavior.

	* src/preproc/tbl/tests/check-horizontal-line-length.sh:
	* src/preproc/tbl/tests/check-line-intersections.sh:
	* src/preproc/tbl/tests/check-vertical-line-length.sh:
	* src/preproc/tbl/tests/table-lacks-spurious-top-border.sh: Do
	it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run tests.
	(tbl_XFAIL_TESTS, XFAIL_TESTS): Expect one test failure.

2022-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tty.cpp (tty_printer::add_char): Modify
	diagnostic message: what gets written "above [the] first line"
	might not be a character (glyph) per se, but a line (rule) from
	a drawing command, and in fact the occurrence of these from
	boxed tables is the most common cause of this message I've seen.

2022-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Do more input validation.

	* src/devices/grotty/tty.cpp (tty_printer::draw): Throw warning
	if an unsupported geometric primitive is encountered.
	(tty_printer::line): Throw warning if a line is diagonal.  Die
	if length of a horizontal or vertical line is not a multiple of
	the appropriate motion quantum of the device (troff should never
	emit such nonsense, and currently doesn't appear to).

2022-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/tbl.1.man (Miscellaneous): Document GNU tbl's
	use of `#T` and `T.` registers.

2022-05-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_color_draw_node): Tweak
	diagnostic message to better distinguish drawing commands and
	device control commands.

2022-05-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Mitigate double-free problem exposed by malformed
	input.

	* src/roff/troff/mtsm.h (struct statem): Place member variable
	`issue_no` behind `DEBUGGING` preprocessor symbol, omitting it
	from production and ordinary development builds.
	* src/roff/troff/mtsm.cpp (no_of_statems): Place global variable
	behind `DEBUGGING` preprocessor symbol, omitting it from
	production and ordinary development builds.
	(statem::statem): Make constructor trivial if `DEBUGGING` not
	defined in preprocessor; it manipulates only `issue_no` and
	`no_of_statems`, which are synchronized.
	(statem::statem {copy}): Gate assignment of `issue_no` member
	variable from copy constructor behind `DEBUGGING` preprocessor
	symbol.
	(statem::flush, mtsm::inherit): Gate debugging output, already
	runtime-gated on `debug_state` symbol, of `issue_no` member
	variable, so that we don't reference it when it is not declared.

	See <https://savannah.gnu.org/bugs/?62040>.

2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Rename a test artifact; it's a bibliographic database
	file, not a refer(1) command file.

	* src/preproc/refer/tests/artifacts/62124.ref: Rename this...
	* src/preproc/refer/tests/artifacts/62124.bib: ...to this.
	* src/preproc/refer/refer.am (EXTRA_DIST):
	* src/preproc/refer/tests/report-correct-line-numbers.sh: Use
	new name.

2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/command.cpp (process_commands): Begin
	migration to use existing global variables for location reports
	in diagnostic messages.  Save current file name and line number
	before calling `command_loop()` and restore them afterward.
	Also decrement line counter before entering that loop because it
	would be too far advanced by one due to the final newline on a
	parsed input line.

2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.cpp (main): Report system error on
	`fflush()` failure.  POSIX Issue 5 a.k.a. SUSv2 (1997) specifies
	several possible `errno` values this C standard library function
	can set; see
	<https://pubs.opengroup.org/onlinepubs/007908799/xsh/fflush.html>.

2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Refactor: drop unused version of function (taking only
	a `const char *` parameter).

	* src/preproc/refer/command.cpp (process_commands): Drop
	definition.
	* src/preproc/refer/command.h (process_commands): Drop
	declaration.

2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.cpp (do_file): Fix another off-by-one
	line number reporting bug exposed by fix for Savannah #62391.

2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/tests/report-correct-line-numbers.sh: Add
	more regression tests.

2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Trivially refactor: boolify.

	* src/preproc/refer/command.cpp (input_stack::push_file): Demote
	and rename local variable from `int` to `bool`.
	(bol): Renamed from this...
	(is_at_beginning_of_line): ...to this.

2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Trivially refactor.

	* src/preproc/refer/command.cpp (input_stack::push_file):
	* src/preproc/refer/refer.cpp (do_file): Drop unnecessary
	construction of integer from integer (return type of `getc()`)
	in argument to error diagnostic functions; parallelizes with
	other diagnostic function calls.

2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/command.cpp: Refactor to simplify.
	(get_location): Demote return type from `int` to `void`.  The
	function only ever returned a `1` literal.
	(input_stack::error): Update call site to stop uselessly testing
	return value of `get_location()`.

2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (dist-info-bits, install_infodoc, dist-gnueps): Fix
	logic error.  When checking both source and build trees for
	files to copy, break after successfully copying the files, not
	after the first iteration of the loop unconditionally.  This
	caused the Info documents not to be installed from out-of-tree
	builds, and potentially would prevent them and doc/gnu.eps from
	being included in the distribution archive if for some reason
	they didn't build and that build failure were not treated as an
	error.  Problems introduced by me in commits e78bd20d54, 27
	March, and d79c3f3a4a, 11 November.

2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_APPRESDIR_OPTION): Update comments and
	human-readable output to (1) stop claiming that existing
	gxditview application defaults in the installation directory
	will be backed up; this is no longer true as of commit
	c66cb7725f, 3 April; and (2) refer to these files as
	"application defaults", not "resources".  (X11 application
	defaults are client-side and mandatory [for Xt-based programs];
	X resources are stored server-side and need not be configured to
	determine an X client's geometry and rendering.)

2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devX100-12/devX100-12.am (devX100_12_fontdir):
	* font/devX100/devX100.am (devX100_fontdir):
	* font/devX75-12/devX75-12.am (devX75_12_fontdir):
	* font/devX75/devX75.am (devX75_fontdir): Define macros without
	an extra "font/" layer in the directory hierarchy.

	Fixes problem introduced by me in commit 3c82cbbfe5, 27
	February.

2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries): Spell
	dependency on `$(SH_DEPS_SED_SCRIPT)` using that macro expansion
	instead of a literal file name.  See doc/automake.mom.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/eqn.am (MAINTAINERCLEANFILES):
	* src/preproc/pic/pic.am (MAINTAINERCLEANFILES):
	* src/preproc/refer/refer.am (MAINTAINERCLEANFILES): Preserve
	byacc/bison output artifacts unless "maintainer-clean"ing.  Per
	the GNU Automake manual, "The intermediate files generated by
	yacc (or lex) will be included in any distribution that is made.
	That way the user doesn’t need to have yacc or lex."

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am: Stop manually handling "test-groff".  Per the
	GNU Automake manual, "If configure built it, then distclean
	should delete it."  This is taken care of automatically if we
	don't interfere.
	(BUILT_SOURCES, MOSTLYCLEANFILES): Drop "test-groff".

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/eqn.am (neqn): Produce temporary file first
	and set its permissions before moving it into place.  If
	anything in the future ever has a dependency on it, this avoids
	a race where the file exists, satisfying a dependency, but
	execution is attempted before its `x` permission bit is set.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Ensure that we install *.me source files, but don't
	include them in the distribution archive.

	* doc/doc.am (dist_otherdoc_DATA): Move `$(GENERATEDDOCFILES)`
	from here...
	(nodist_otherdoc_DATA): ...to here.
	(.PRECIOUS): Add `$(GENERATEDDOCFILES)` so that make(1) doesn't
	automatically remove "intermediate" objects in the .me.in -> .me
	-> .ps chain.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Handle "gnu.eps" file better.

	* doc/doc.am (GENERATEDDOCFILES): Remove `$(DOC_GNU_EPS)`.
	(EXTRA_DIST): Ship `$(DOC_GNU_EPS)` in distribution archive.
	($(DOC_GNU_EPS)): Simplify rule commands; stop trying to copy
	the file around since it will either be (1) in the distribution
	archive from which a build is performed; or (2) missing because
	a build is being done from Git, in which case we expect the PNM
	tools to be available.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (clean_otherdoc): Drop target: it doesn't seem to
	accomplish anything.
	(clean_infodoc): Drop target, moving its rules into...
	(maintainer-clean-local): ...this.  Drop deps, both gone now.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (distclean-local): Drop target: stop cleaning
	generated forms of our Texinfo manual with the "distclean"
	target.  They ship with the distribution archive and should
	remain in the tree even if the user needs to re-./configure.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Fix problems exposed by high build parallelism.

	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries)
	(font/devpdf/DESC, font/devpdf/Foundry): Drop
	unnecessary removal of target prior to creating it.
	(font/devpdf/Foundry): Add creation of destination build
	directory as other targets do.
	(font/devpdf/download): Create dedicated target instead of
	lumping its generation under the stamp file.  Add missing
	dependencies on `$(DEVPDFFONTMAP_1)`, `$(DEVPDFFONTMAP_2)`,
	`font/devpdf/Foundry` and `font/devpdf/enc/text.enc`.  Remove
	now-unnecessarily complicated "forgery" of "GEN" line in quiet
	builds.  Tweak format of comment written to "download" file to
	make field identities clearer.  Construct output (with multiple
	shell commands) in temporary file so it is not read prematurely
	by the "BuildFoundries" script.  Move target into place as the
	last step.
	(font/devpdf/stamp): Relocate target to follow its dependencies.
	Add dependency on "font/devpdf/download".

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Tweak diagnostic messages in BuildFoundries script.

	* font/devpdf/util/BuildFoundries.pl (LoadFoundry)
	(WriteDownload, CheckFoundry): Recast for specificity and
	consistent style.
	(Die): Stop reporting line number with fatal errors; none of the
	call sites are parsing input.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Fix off-by-one error in line number for some
	diagnostics.

	* src/preproc/refer/command.cpp (input_item::get_location):
	Decrement reported line number by one after looping over input
	so that we report the line number as it was before the last
	newline character seen.  This off-by-one error was partially
	masked by...
	* src/preproc/refer/refer.cpp (do_file): ...initialization of
	`current_lineno` to zero.  However, for syntax problems (as
	opposed to the semantic problems of refer(1) command
	processing), this could result in complaints about the line
	number before they occurred, even on "line zero".  Initialize
	the variable to 1.

	Fixes <https://savannah.gnu.org/bugs/?62391>.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/tests/report-correct-line-numbers.sh: Add
	regression test for Savannah #62391.

2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/tfmtodit/tfmtodit.cpp (usage): Tweak usage message.
	Condense `-v` and `--version` into a single output line with
	brace and pipe notation, which we do not use in our man pages,
	but consistently do in our usage messages.  Use lowercase for
	option arguments since they are separated from option flag
	letters by space.  Call `fprintf()` once instead of 3 times.

2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.cpp (main): Tweak wording of
	diagnostic messages to refer to options consistently and to
	characterize input as "invalid" rather than "bad".
	(usage): Document --version option.  Use more informative
	metasyntactic variable names.  Organize usage message
	consistently with our others, and stop wrapping the output
	lines: we know neither the width of the terminal nor the length
	of the `program_name` string we're interpolating.  See commit
	b4de44f0, 19 July 2021.

2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (string_iterator::backtrace): Fix
	spurious output when `mac.filename` is empty.  Provoked by:
	  $ printf '\\(' | troff -b

2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.cpp: Trivially refactor.  Demote
	global variable `recognize_R1_R2` from integer to Boolean.
	(main, do_bib): Give expressions to `assert()` meaningful
	content.
	(is_list): Demote return type from `int` to `bool`.
	(do_file): Demote and rename integer local variables
	`start_of_line` to Boolean `at_start_of_line`.
	(is_list, do_file): Reorder equality comparisons to avoid
	inadvertent lvalue assignment.

2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Reduce and rationalize in-tree document dependencies.
	This eliminates spurious rebuilds of numerous documents
	{including the 380+-page groff-man-pages collections}.  It also
	fixes missing dependencies when using the build's groff to
	generate PostScript documents.

	* .gitignore: Drop old name of devpdf stamp file.
	* doc/.gitignore: Drop now-unused "example.stamp" file.
	* doc/doc.am (PROCESSEDDOCFILES_HTML, PROCESSEDDOCFILES_PDF)
	(PROCESSEDDOCFILES_TXT): Add new macros grouping targets by the
	format/output driver used to produce them, to better organize
	dependencies for their generation.
	(PROCESSEDDOCFILES): Redefine as simply the expansions of the
	foregeoing.
	(PROCESSEDFILES_DEPS_HTML, PROCESSEDFILES_DEPS_HTML,
	PROCESSEDFILES_DEPS_PDF, PROCESSEDFILES_DEPS_TXT): Add new
	macros defining prerequisites for production of the
	corresponding output document formats.
	($(PROCESSEDDOCFILES_HTML), $(PROCESSEDDOCFILES_PDF),
	$(PROCESSEDDOCFILES_PS), $(PROCESSEDDOCFILES_TXT)): Declare the
	dependencies using expansions of the foregoing macros.
	(MOSTLYCLEANFILES): Drop "doc/automake.pdf", now part of
	`PROCESSEDDOCFILES_PDF`.
	(doc/automake.pdf): Drop dependencies already supplied by
	`PROCESSEDFILES_DEPS_PDF`.
	(HTMLDOCFILES): Drop macro.  "doc/pic.html" is now in the
	expansion of `PROCESSEDDOCFILES_HTML`.
	(htmlpic_DATA): Redefine as expansion of
	`PROCESSEDDOCFILES_HTML` instead of `HTMLDOCFILES`.
	(PROCESSEDEXAMPLEFILES_HTML) [BUILD_HTML]: Define as
	"doc/webpage.html", otherwise as empty.
	(PROCESSEDEXAMPLEFILES_PS): Contain "doc/webpage.ps" and
	"doc/grnexampl.ps".
	(PROCESSEDEXAMPLEFILES): Redefine as expansions of
	`PROCESSEDEXAMPLEFILES_HTML` and `PROCESSEDEXAMPLEFILES_PS`.
	($(PROCESSEDEXAMPLEFILES_HTML), $(PROCESSEDEXAMPLEFILES_PS)):
	Declare dependencies using `PROCESSEDFILES_DEPS_HTML` and
	`PROCESSEDFILES_DEPS_PS`, respectively.
	(HTMLEXAMPLEFILES): Drop macro.  "doc/webpage.html" is now in
	the expansion of `PROCESSEDDOCFILES_HTML`.
	(nodist_htmlexamples_DATA): Drop macro, no longer needed.
	($(PROCESSEDDOCFILES_PS)): Relocated and redefined above.
	($(PROCESSEDEXAMPLEFILES) $(PROCESSEDDOCFILES)): Drop overbroad
	dependency declarations in favor of the above.
	(MOSTLYCLEANFILES, doc/examples.stamp): Drop generation and
	removal of unnecessary stamp file.
	(doc/pic.html, doc/webpage.html): Add explicit dependency on
	required preprocessors.  Drop redundant and spurious
	dependencies.
	* font/devhtml/devhtml.am (MOSTLYCLEANFILES)
	(font/devhtml/stamp): Generate and remove stamp file to enable
	reliable target dependencies for build-time generation of HTML
	documents by groff.
	* font/devpdf/devpdf.am (MOSTLYCLEANFILES, font/devpdf/stamp):
	Rename stamp file from "font/devpdf/build_font_files".
	(font/devpdf/stamp): Drop unnecessary dependency on "afmtodit".
	* font/devps/devps.am (MOSTLYCLEANFILES, font/devps/stamp):
	Generate and remove stamp file to enable reliable target
	dependencies for build-time generation of PostScript documents
	by groff.
	* font/devutf8/devutf8.am (MOSTLYCLEANFILES)
	(font/devutf8/stamp): Generate and remove stamp file to enable
	reliable target dependencies for build-time generation of
	UTF-8-encoded text documents by groff.

	Fixes <https://savannah.gnu.org/bugs/?62084>; thanks to
	Sergei Trofimovich for the report.  Also fixes
	<https://savannah.gnu.org/bugs/?62297>; thanks to Bjarni Ingi
	Gislason for the report.

2022-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Fix code style nits in Automake files.

	* doc/doc.am: Put spaces around (Auto)make variable assignments,
	for consistency with the rest of this .am file, and our others.
	* font/devpdf/devpdf.am (font/devpdf/build_font_files): Use
	shell '>' operator instead of touch(1).
	* font/devhtml/devhtml.am (font/devhtml/DESC):
	* font/devps/devps.am (font/devps/DESC): Construct target in
	temporary file, since doing so is a multi-step process, moving
	it to the target name when it is complete and usable by
	dependencies.

2022-04-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.cpp (main): When complaining of
	unrecognized option, report the entire option string (after
	the leading dash), not just its first character.

2022-04-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/error.cpp: Trivially refactor.  Explicitly
	compare pointer lvalues to null pointers instead of punningly
	treating them as Booleans.  Annotate use of zero literals as
	null pointers to ease any future migration to ISO C++11.

2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (an*abbreviate-inner-footer): Clean up better
	before early returns.  Remove temporary registers.

2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/fallbacks.tmac: Add fallbacks for U+02C6 MODIFIER LETTER
	CIRCUMFLEX ACCENT and U+02DC SMALL TILDE to Basic Latin
	characters.

2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Fix portability problem.  Don't pass echo(1) arguments
	containing backslashes because implementations handle them
	differently.  Use printf(1) instead.  Thanks to Bertrand
	Garrigues for reporting the problem and confirming the fix on
	his build host.

	* tmac/tests/e_chapter-titles-work.sh:
	* tmac/tests/e_ld-works.sh:
	* tmac/tests/localization-works.sh: Do it.

2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/gropdf/gropdf.pl (ppsz): Recognize "com10" (U.S.
	commercial envelope) paper format.

	Addresses the original issue reported in
	<https://bugs.debian.org/1009248>.  We have however broadened
	its scope; see <https://savannah.gnu.org/bugs/?62344>.

2022-04-27  Dave Kemper <saint.snit@gmail.com>

	* src/devices/gropdf/gropdf.pl (ppsz): Recognize ISO B-series
	paper formats using strings of the form "b0-b6", not "isob0-b6",
	for consistency with libgroff and papersize.tmac.

	Fixes <http://savannah.gnu.org/bugs/?62346>.

2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor to simplify.  Ingo's removal of the
	"--with-doc" "configure" option, among other changes, clears the
	way to remove many phony targets and simplify dependencies
	involving generation of the 5 formats of our Texinfo manual.
	(build_infodoc, doc, doc_all, doc_txt, dvi, doc_dvi, pdf,
	doc_pdf, html, doc_html): Drop phony targets.
	(all): Depend directly on doc/groff.{info,txt,html,dvi,pdf}.
	* NEWS: Add item since "make doc" is no longer necessary and
	will do nothing.

2022-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Handle `\R` sequences in text blocks robustly.

	* src/preproc/tbl/table.cpp (table::add_entry): Fix SEGV when
	repeating glyph table entry syntax (`\Rx`) used in a text block.
	Lift extraction of entry string to be done unconditionally,
	rather than in 5 different special cases.  This frees us up to
	rewrite the entry if necessary, changing '\R' to '\&' inside a
	text block.  Recast diagnostic to describe the problem
	clearly--"bad repeated character" suggests that something is
	wrong with the "argument" to `\R`, when really the problem is
	the _context_.

	Fixes <http://savannah.gnu.org/bugs/?62366>.

2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #62366.

	* src/preproc/tbl/tests/\
	do-not-segv-when-backslash-R-in-text-block.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/string.cpp (string::extract): Check return
	value of `malloc()` for nullity, and only poke into the buffer
	returned if it is valid.  Discovered while troubleshooting
	Savannah #62366.

2022-04-23  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	gnulib: replace non-recursive-gnulib-prefix-hack with
	automake-subdir option

	'non-recursive-gnulib-prefix-hack' is deprecated by gnulib's
	commit f8eed11b15e9141d061900e4068ea1f3ba9b63f6 and replaced by
	'--automake-subdir'.

	* bootstrap.conf:
	(gnulib_modules): Remove option
	'non-recursive-gnulib-prefix-hack'.
	(gnulib_tool_option_extras): Add option '--automake-subdir'.
	(bootstrap_post_import_hook): Remove the invocation of
	'build-aux/prefix-gnulib-mk'.

	* doc/automake.mom: update documentation accordingly.

	Fixes <http://savannah.gnu.org/bugs/?61708> and
	<https://savannah.gnu.org/bugs/?62205> , issues reported and fix
	suggested by Bjarni Ingi Gislason <bjarniig@rhi.hi.is>.  Fix
	also suggested by Werner LEMBERG <wl@gnu.org> (see
	<https://repo.or.cz/ttfautohint.git/commit/a938fc63cb55ef48393a924d7083b13c1352d294>).

2022-04-23  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	Update gnulib submodule

	* gnulib now points on c8b8f3bbcde37a53cd226f4c9cebd0dde6aca37f

	* bootstrap: merge the latest version from gnulib/build-aux
	{groff's bootstrap has a patch for OS X}.

	* bootstrap.conf: update copyright date.

2022-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (XH-UPDATE-TOC): Modify Keith Marshall's new XN/XH
	feature to indent TOC entries by section heading depth.  The
	increment is 2 ens per depth level.

2022-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (XA): Drop apparently useless `ll` request.  It
	doesn't do anything according to my tests.

2022-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/label.ypp: Drop redundant declaration of
	`yyparse`.  Both byacc 20140715 and GNU Bison 3.3.2 supply the
	the function prototype themselves.  Addresses
	"-Wredundant-decls" warning from GCC.

	Fixes <https://savannah.gnu.org/bugs/?43569>.

2022-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/hdb.cpp (DBGetType): Lower fatal diagnostics
	to errors when encounting invalid element type characters.
	Return a value interpreted by our caller as an error indication
	instead.  Helps compilers determine that we're not implicitly
	falling through our cases.  Addresses "-Wimplicit-fallthrough"
	warnings from GCC.

	Fixes https://savannah.gnu.org/bugs/?54702>.

2022-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/hdb.cpp (DBRead): Add more validity checking.
	Verify that the number of conversions returned by fscanf() is as
	expected instead of throwing this information away--abort
	processing ("giving up" like pic(1) does) if it does not.
	Consistently report this abandonment in diagnostic messages.
	Similarly validate pointer returned by fgets().  Soften handling
	of invalid text condition from fatal error, introduced in
	commit eb4f0675e, 16 August, to a normal one with abandonment of
	Gremlin file.  Addresses "-Wunused-result" warnings from GCC.

2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/main.cpp (conv): Throw an error diagnostic
	when failing to open a Gremlin picture file.

2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix extraneous space in output after `ME` or `UE` when
	mandoc wrapper is used.

	* tmac/an-ext.tmac (UE, ME): Double backslashes in macro
	definitions when interpolating `.$` register (just like we tell
	everyone else to do).  This one was interesting to track down.
	When using just `-man`, the problem never manifested; only with
	`-mandoc`.  The difference is that with the former, the `.$`
	register is initialized to zero; with the latter, because `TH`
	is aliased to another macro (then unaliased), `.$` has the
	argument count to the `TH` macro, not to the macros actually
	being called.  This caused the wrong branch of a conditional to
	be taken and put an extra space node on the output.

	Fixes <https://savannah.gnu.org/bugs/?62044>.

2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/cp1047.tmac:
	* tmac/latin1.tmac:
	* tmac/latin2.tmac:
	* tmac/latin5.tmac:
	* tmac/latin9.tmac: Stop remapping input soft hyphen characters
	with `tr` requests in character encoding macro files.  The
	formatter does this for us now.

2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Translate 8-bit NBSP and SHY on input.

	* src/roff/troff/input.h: Define constant integers for "input"
	no-break spaces and soft hyphens for EBCDIC and non-EBCDIC
	(presumably ASCII/ISO 8859/Unicode) systems.

	* src/roff/troff/input.cpp (token::next): Translate the input
	character codes for NBSP to \~ and SHY to \%.

	Fixes <https://savannah.gnu.org/bugs/?58962>.  Thanks to Dave
	Kemper for the report, code review, and his suggestion to push
	more work to compile time.

2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[groff]: Regression-test Savannah #58962.

	* src/roff/groff/handle_special_input_code_points.diff: Do it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_if_request): Clarify diagnostic;
	at the point it is thrown, we know not merely that we're in a
	conditional expression, but processing an output comparison
	operator.

2022-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi:
	* doc/ms.ms:
	* man/groff.7.man: Characterize "roff language" in the singular,
	not the plural, emphasizing the similarity of extant specimens.

	* doc/groff.texi (Conventions Used in This Manual): Add
	paragraph discussing denotations of "groff" and "roff".

	Fixes <https://savannah.gnu.org/bugs/?62233>.  Thanks to John
	Gardner and Dave Kemper for the discussion.

2022-04-12  Ingo Schwarze <schwarze@openbsd.org>

	Delete the harmful, ill-designed, buggy, and essentially
	unmaintained and untested --with-doc option of the configure
	script.

	* configure.ac: Delete five AM_CONDITIONAL variables, one
	autoconf(1) macro call, and some related diagnostic output.
	* doc/doc.am: Delete two BUILD_EXAMPLES and one BUILD_OTHERDOC
	conditional and use BUILD_HTML instead of BUILD_HTMLEXAMPLES.
	* m4/groff.m4: Delete the GROFF_DOC_CHECK macro and simplify the
	macros GROFF_HTML_PROGRAMS, GROFF_INSTALL_INFO, GROFF_MAKEINFO,
	and GROFF_PDFDOC_PROGRAMS.  This also deletes more than thirty
	configuration variables.
	* Makefile.am: Delete comments about 16 variables that are no
	longer set.
	* NEWS: Add details regarding the rationale.

2022-04-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.cpp (unicode_entity): Convert
	input U+00A0 to \~ as troff would, not to \[u00A0].

	Fixes <https://savannah.gnu.org/bugs/?62300>.

2022-04-11  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf] fails to deal with 255th glyph in font.

	* src/devices/gropdf/gropdf.pl: a pdf font can only contain 255
	glyphs. The array which holds the glyph names also holds the
	start position (zero) as first element, it is legal for it to
	contain 256 elements, so truncate to 256 (not 255).

	Fixes <https://savannah.gnu.org/bugs/?62294>.

2022-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[localization]: Define hyphenation mode registers for Japanese
	and Chinese.  They are set to zero but must be defined so that
	macro packages can rely on their existence without causing 'reg'
	warnings.

	* tmac/ja.tmac:
	* tmac/zh.tmac: Do it.

2022-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Add test for multi-lingual man(7) scenario.

	* tmac/tests/localization-works.sh: Test two more cases.  Ensure
	that the 'trap bit' (hyphenation value 2, which has nothing to
	do with any language) is preserved when switching locales back
	from a CJK language, since those languages' modes
	unconditionally clear it.  We test Japanese and Chinese; we have
	no localization macro file for Korean at this time.

2022-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Slightly refactor `an*abbreviate-inner-footer`.

	* tmac/an.tmac (an*abbreviate-inner-footer): Discard
	unnecessary string.

2022-04-09  Ingo Schwarze <schwarze@openbsd.org>

	Fix the configuration of texi2dvi.

	* m4/groff.m4: Set groff_have_texi2dvi if texi2dvi(1) is
	available and usable, even if the availability was specified by
	the user by manually providing the configure variable
	PROG_TEXI2DVI, and not only if it was autodetected.
	Also, set the PROG_TEXI2DVI Makefile variable to the name of
	the texi2dvi program specified by the user or autodetected,
	and not to the string "found", such that this Makefile variable
	can be used for invoking the program.
	* doc/doc.am: Call the texi2dvi program specified by the user
	or autodetected rather than hardcoding "texi2dvi".  This lets
	the groff build succeed on systems where the first texi2dvi
	in the $PATH is an old version unfit for groff's purposes.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Abbreviate long `TH` arguments more carefully.

	* tmac/an.tmac: Do it.
	(an*scan-string-for-backslash): Add new helper macro.
	(an*abbreviate-inner-footer): Rewrite.  Use the foregoing and a
	different technique to compute available space and shorten the
	string.

	Fixes <https://savannah.gnu.org/bugs/?62257>.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add regression test for Savannah #62257.

	* tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh:
	Do it.
	* tmac/tmac.am (tmac_TESTS): Run it.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Trivially refactor.  Rename strings `an-ifoot`
	to `an*ifoot` and `an-outer-footer-text` to `an*ofoot`.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Refactor.  Abbreviate page title and inner
	footer only once per document instead of once per page.
	Exception: the legacy macros `AT` and `UC` change the inner
	footer, so re-abbreviate it if they are called.
	(TH, AT, UC): Call abbreviation macros from here...
	(an-header, an-footer): ...instead of here.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Refactor: initialize header/footer environment
	only once.  Also rename it to `an*env-header-and-footer`.
	(TH): Do it here...
	(an-header, an-footer): ...instead of here.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Trivially refactor.
	(an*prepare-page-title): Rename this...
	(an*abbreviate-page-title): ...to this.
	(an-prepare-inner-footer): And this...
	(an*abbreviate-inner-footer): ...to this.
	(an-header, an-footer): Update call sites.

2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/other.cpp (hmotion_box::output): Fix typo in
	generated MathML diagnostic message.

2022-04-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (EXTRA_DIST): Add "groff.dvi" and "groff.pdf" to
	ensure that the GNU-released groff distribution archive contains
	our Texinfo manual in these formats.  (This doesn't increase the
	build-dependency requirements unless you want to "make dist", in
	which case it _should_.)

2022-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Add nroff mode fallback for `UL` macro.

	* tmac/s.tmac (UL): On nroff devices, bracket the first argument
	with \(ul (underline rule) special character escape sequences.
	{In plain language, '.UL "like this"' renders "_like this_".}
	See corresponding 12 February change to "tmac/e.tmac".

2022-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Drop unnecessary `-I` options to groff.
	(DOC_GROFF): There is no need to look at the top of the build
	directory for any file inclusions.
	(doc/webpage.html): There is no need to look in `doc_builddir`
	for file inclusions, since that is the current working directory
	when "webpage.ms" is processed.

2022-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Trivially refactor.  Use `RM` macro idiomatically.
	Automake ensures that it is defined to call an `rm` command with
	the `-f` option, and this in turn ignores failures to delete
	nonexistent files, so...
	(uninstall_doc_examples, uninstall-pdf): Stop adding superfluous
	`-f` flag.
	(clean_infodoc uninstall-pdf, uninstall-html): Stop prefixing
	command with `-` to ignore error exit status.
	(uninstall-html): Drop superfluous `-r` flag; we're only
	deleting files with this command, not directories.

2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Trivially refactor shell style in rule commands.
	The placement of `&&` was inconsistent.  Always begin a
	continued rule line with it, and don't give it its own
	indentation level.  In general, operators adjacent to line
	continuations should _follow_ the continuations because they are
	easier for humans to spot at the (possibly indented) beginning
	of a physical line.

2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am: Rename `TFLAG` macro, which means "tmac flag", to
	`MFLAG`, because it expands to `-M` options to groff, not the
	`-T` option, which can be bewildering.
	* doc/doc.am (DOC_GROFF): Update expansion site.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Rename `DOC_GROFF_ONLY` to `DOC_GROFF`.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor.  Drop ghastly hack used to get file
	names into troff diagnostics when reading from standard input.
	We've refactored so that it no longer does, making the hack
	unnecessary.  For the same reason, no users of the `DOC_GROFF`
	macro remain, so delete it.  Add comments to explain what
	`DOC_SED` and `DOC_GROFF_ONLY` are for.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor.
	(doc/pic.html, doc/webpage.html): Drop indirection of source
	document through `DOC_SED` macro.  It was not necessary since
	neither of these documents are parameterized in configuration
	options (that is, they don't contain @VERSION@ or @g@).

2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Trivially refactor.
	(doc/webpage.html): Tidy up dependency list.  Create directory
	using the same macro interpolation we use to change into it.

2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor and fix error in builds in remote
	out-of-source-tree builds exposed by pending commit and `make
	distcheck`.  The images generated for the pic.html and
	webpage.html files were being built in the wrong directory, and
	subsequently not found by an install rule.
	(imagedir): Add comment explaining purpose of macro.  It should
	_not_ be used with any file specifications relative to the
	source or build trees--it is for installation directories only.
	(htmldocimagedir, exampleimagedir): Drop macros.

	(doc/pic.html, doc/webpage.html): Replace interpolations of
	`imagedir` with literal "img", since these files are being
	generated within the build tree: the directory name is known.

	(mostlyclean_doc, install_doc_htmldoc, install_doc_examples):
	Replace interpolations of `htmldocimagedir` relative to
	`doc_builddir` with "img" literals.

	(install_doc_htmldoc, uninstall_doc_htmldoc): Interpolate
	concatenation of `htmldocdir` and `imagedir` instead of
	`htmldocimagedir` (relative to `DESTDIR`).
	(install_doc_examples, uninstall_doc_examples): Interpolate
	concatenation of `exampledir` and `imagedir` instead of
	`exampleimagedir` (relative to `DESTDIR`).

2022-04-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor.  Relocate "doc/grnexampl.ps" target to
	group it with other me(7) documents.  Put addition of
	"doc/examples.stamp" to `MOSTLYCLEANFILES` adjacent to its
	target rule.  Relocate same rule so that it precedes the target
	depending on it (make(1) might not benefit from this, but human
	readers can).

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor.
	(DOC_GROFF_ONLY): Drop preprocessor options from groff command.
	This macro is now, simply, a way to run the in-tree groff: no
	assumptions about preprocessors, macro packages, or output
	device are made.
	(doc/pic.html, doc/webpage.html): Add only necessary
	preprocessor options after expansion of `DOC_GROFF_ONLY`.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor.  Add explicit dependencies of compiled
	man page documents on preprocessors needed to generate them.  In
	their target rules, explicitly use groff's preprocessor options,
	freeing us up to simplify the `DOC_GROFF_ONLY` macro.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Rationalize dependencies.  Drop dependency of
	`PROCESSEDEXAMPLEFILES` and `PROCESSEDDOCFILES` on expansion of
	`hdtbltmac_DATA`, because nothing in this directory uses the
	hdtbl package.  Move dep of same expansions on "gnu.eps" to
	"doc/webpage.html", which actually uses it.  Put the numerous
	dependencies of "doc/pic.html" and "doc/webpage.html" in a
	parallel ordering so that they are easier for humans to
	evaluate.  These targets' dependencies on `bin_PROGRAMS` and
	`prefixexecbin_PROGRAMS` are overkill and should be reviewed at
	a later date.

2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Refactor use of target and suffix rules.
	(doc/meintro.me, doc/meintro_fr.me, doc/meref.me): Add target
	rules, with lengthy, exasperated comment about lack of feature
	parity in various make(1) implementations.
	(doc/meintro_fr.ps): Add target rule, as this seems to be the
	only way to keep GNU Make from ignoring a '_fr.me._fr.ps' suffix
	rule in favor of '.me.ps', which doesn't call preconv (and
	doesn't need to--and moreover we don't want to build English
	me(7) documents with the `-mfr` option).  Depend on `preconv`.
	(doc/webpage.ps): Convert from suffix rule to target rule.
	(doc/ms.ps, doc/pic.ps, doc/webpage.ps): Add target rules and
	dependencies.
	(.ms.ps): Add commented-out suffix rule (since nothing uses it,
	but might in the future).
	(doc/meintro_fr.ps, .me.ps, doc/pic.ps, doc/webpage.ps): Migrate
	expansions of `DOC_GROFF` to `DOC_GROFF_ONLY` to prepare for a
	forthcoming simplification.

2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Clean generated doc files better.  doc/me*.me were
	getting left behind in the build tree.
	(MOSTLYCLEANFILES): Add `GENERATEDDOCFILES`.  This includes
	`DOC_GNU_EPS`, so...
	(clean_maintdoc): Drop phony target that manually removes it.
	(maintainer-clean-local): Drop dependency on foregoing.

2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/xditview/xditview.am (install_xditview)
	[!WITHOUT_X11]: Stop backing up existing "GXditview" and
	"GXditview-color" application defaults files.  There is no
	symmetric restoration of them in the uninstall target, and it
	seems like unjustifiable complexity to add such.  These are
	groff-specific file names, installed (by default) to /usr,
	not /etc, so they are not going to be "configuration files" in
	Debian-based systems, for example (and likely not elsewhere).
	There are other ways to supersede application defaults for
	programs using the X Toolkit Intrinsics.

2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Stop treating "gnu.eps" as an "example" file; it
	is also used by pdfmark's cover.ms, which is ordinary
	documentation.  We therefore must not omit it when building.
	(install-data-hook): Add dependency on new phony target,
	"install_doc_gnu_eps".
	(install_doc_examples): Move installation of "gnu.eps" from
	here...
	(install_doc_gnu_eps): ...to here.  Also refactor the loop we
	use to locate the file to follow a more idiomatic pattern.

2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (dist-info-bits, install_infodoc, dist-gnueps): Fix
	code style nit: use consistent "brace style" in conditionals and
	loops.

2022-04-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (mostlyclean_doc): When cleaning, try harder to
	remove the image directory created by the "pic.html" and
	"webpage.html" targets.

2022-04-02  Ingo Schwarze <schwarze@openbsd.org>

	* doc/doc.am: Stop installing doc/meintro.me.in,
	doc/meintro_fr.me.in, and doc/meref.me.in.

2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/webpage.ms: Die horribly if `PSPIC` call fails.

2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pspic.tmac (pspic*error-hook): Define (as empty).
	* man/groff_tmac.5.man (Auxiliary packages) <pspic>: Document.
	* NEWS: Add item.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/webpage.ps): Relocate target rule.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
	* tmac/tests/pdfpic_falls-back-to-PSPIC.sh: Remove output file
	even when skipping test.  Quote `fail` variable when checking it
	with `test -z`.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_tmac.7.man (Auxiliary packages): Tweak sboxes
	documentation to imply ms dependency.

	Fixes <https://savannah.gnu.org/bugs/?62062>.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (an*bookmark): Trivially refactor.  Now that
	we're no longer doing arithmetic on our first argument, simplify
	our definition.  Made possible by commit 3baf0e2f3, 23 February.

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.cpp (detect_file_encoding): Demote
	an error diagnostic to a debugging message.  libuchardet has no
	man page, and inspecting the source of the
	`uchardet_handle_data` function we find that it effectively
	returns a Boolean value (if the result of a
	`reinterpret_cast`(!) is not `NS_OK`).  This is useless
	information for a user-facing tool.  We're designed to muddle on
	regardless (see preconv(1)).

2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grodvi/dvi.cpp (dvi_printer::set_color)
	(draw_dvi_printer::fill_next):
	* src/devices/grops/ps.cpp (output::put_color):
	* src/libs/libgroff/color.cpp (color::print_color): Construct
	doubles instead of casting to them.

2022-03-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[doc]: Refactor handling of "gnu.eps" file.

	* doc/doc.am: Put "gnu.eps" in a Make macro, `DOC_GNU_EPS`.
	($(PROCESSEDEXAMPLEFILES) $(PROCESSEDDOCFILES),
	doc/webpage.html, install_doc_examples): Migrate dependency to
	`DOC_GNU_EPS`.
	(doc/webpage.ps): Add (missing) dependency on `DOC_GNU_EPS`.
	(DOC_GROFF_ONLY): Drop `-I` flag; it's not necessary given the
	following.
	(.ms.ps): Drop `-mwww` argument from suffix rule.  A truly
	generic ms document won't need it.
	(doc/webpage.ps): Add target rule.  Include `-mwww` argument.
	(doc/webpage.ps, doc/webpage.html): Pass `-I` option to
	`DOC_GROFF` and `DOC_GROFF_ONLY` (respectively) to enable
	location of "gnu.eps" file.  Search the build and source trees'
	"doc" directories because the file can be generated as part of
	the build or can come with the distribution archive.
	(EXTRA_DIST): Drop redundant inclusion of "doc/gnu.xpm".
	(clean_maintdoc): Add phony target to dispose of `DOC_GNU_EPS`.
	(maintainer-clean-local): Depend on "clean_maintdoc".

	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
	* tmac/tests/pdfpic_falls-back-to-PSPIC.sh: Update tests to look
	for "gnu.eps" in "doc" directory of build tree.  Give generated
	files distinguishable names so their tests can run concurrently.

2022-03-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Add new macro `PROCESSEDDOCFILES_PS` to isolate
	names of targets in PostScript format.  Expand this macro in
	definition of `PROCESSEDDOCFILES` and use it to move PostScript
	font description file dependencies of the latter and
	`PROCESSEDEXAMPLEFILES` to the former.  (At present, the
	dependency might seem superfluous, since those files are in the
	source distribution, but it's conceivable that in the near
	future, they will be produced at build time from Adobe font
	metric files; see font/devps/generate/Makefile).  The "pic.html"
	and "webpage.html" targets already had such a dependency because
	of the way grohtml (pre-grohtml) works.

2022-03-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* INSTALL.extra: Add a section on uninstalling.

2022-03-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Create target rule for "doc/grnexampl.ps" instead
	of relying on a suffix rule.  Explicitly depend on grn and eqn
	executables.  Produce output using their groff flags, "-ge".

2022-03-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdfpic.tmac (PDFPIC): Fix breakage when no temporary
	directory environment variables are defined: actually use string
	interpolation syntax in comparand to output comparison
	operator.  Problem introduced by me in commits adc1999af and
	24900cf6d, 15 February.

2022-03-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devX100-12/devX100-12.am:
	* font/devX100/devX100.am:
	* font/devX75-12/devX75-12.am:
	* font/devX75/devX75.am: Fix in-tree build; expand `fontdir`
	instead of `abs_top_builddir` Make macro when defining Automake
	variable for generated artifacts.  Problem introduced by me in
	commit 3c82cbbfe, 27 February.  Thanks to Robert Goulding for
	the report.

2022-03-22  Ingo Schwarze <schwarze@openbsd.org>

	* doc/doc.am: delete redundant "SUFFIXES +=" line

2022-03-22  Ingo Schwarze <schwarze@openbsd.org>

	* doc/doc.am: fix non-portable syntax in the meintro_fr.ps
	target: This rule requires DOC_GROFF and hence $<, so turn it
	into a suffix rule.

2022-03-22  Ingo Schwarze <schwarze@openbsd.org>

	* doc/doc.am: fix non-portable syntax in the doc/me*.me targets:
	POSIX does not define the meaning of $< in non-suffix rules, so
	use the portable $? instead.  This is adequate here because each
	of these three rules has exactly one prerequisite.

2022-03-22  Ingo Schwarze <schwarze@openbsd.org>

	* doc/doc.am: fix non-portable syntax in the groff-man-pages.*
	targets by using DOC_GROFF_ONLY rather than DOC_GROFF in order
	to not use $< outside a suffix rule; DOC_GROFF functionality is
	not needed here in the first place.

2022-03-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac:
	* tmac/doc.tmac: Stop remapping input hyphens on `utf8` device.

2022-03-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac: Stop remapping ` and ' on `utf8` output device.
	Aligns mdoc(7) with commit 697e6db7f, 19 October 2020 (for
	man(7)).

2022-03-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Fix bug introduced in commit
	0d451902c, 10 March.  Don't store a newline in the version
	string.  Put `\n` in its interpolation context as necessary.

2022-03-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	Install ptx.tmac.

	* tmac/tmac.am (TMACNORMALFILES): Add it.
	* NEWS: Report availability.

	Fixes <https://savannah.gnu.org/bugs/?62201>.  Thanks to Ralph
	Corderoy for the report.

2022-03-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	Drop ditroff(7) document.  It says nothing that is not covered
	elsewhere.

	* man/ditroff.7.man: Delete.
	* doc/doc.am (GROFF_MAN_PAGES):
	* man/man.am (man7_MANS, EXTRA_DIST): Stop processing, shipping.
	* src/roff/groff/groff.1.man: Drop cross reference to it.
	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?61817>.

2022-03-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[preconv]: Trivially refactor.

	* src/preproc/preconv/preconv.cpp: Use diagnostic message
	functions from libgroff where possible.  Explain in a comment
	why we don't use `debug()`.  Boolify and rename some variables,
	and use Boolean literals to assign to them.
	  debug_flag         -> is_debugging
	  invalid_warning    -> emit_invalid_utf8_warning
	  incomplete_warning -> emit_incomplete_utf8_warning
	Rename `expected_bytes` to `expected_byte_count`.  Except for
	the debugging flag, these are all members of `struct
	conversion`.
	(get_tag_lines): Migrate to `warning()`.
	(detect_file_encoding): Migrate to `error()` and `fatal()`, as
	appropriate.
	(utf8::invalid, utf8::incomplete, get_tag_lines): Don't break a
	line in the middle of a diagnostic; doing so frustrates grepping
	and necessarily makes an assumption about the terminal width.

2022-03-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Trivially refactor.

	* src/roff/troff/input.cpp: Rename global variable
	`have_string_arg` to `have_multiple_params` and demote it from
	an integer to a Boolean.  Assign Boolean literals to it.
	(read_long_escape_parameters, get_copy, token::next): Do it.

2022-03-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix Savannah #62191.

	* src/preproc/tbl/main.cpp (table_input::get): Increment input
	line counter when encountering an escaped newline; this fixes
	inaccurate diagnostics from the formatter at any point in a
	document after a line-continued row of table data.  Also drop a
	"perhaps" comment.  I tested the surmise (setting the FSM state
	to "START"), and it results in bad formatting.

	Fixes <https://savannah.gnu.org/bugs/?62191>.  Problem appears
	to date back to groff 1.02 (June 1991) at the latest.

2022-03-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #62191.

	* src/preproc/tbl/tests/count-continued-input-lines.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2022-03-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Environments): Clarify environment handling.
	* man/groff.7.man (Environments): Add new section.

	Fixes <https://savannah.gnu.org/bugs/?62036>.  Thanks to Dave
	Kemper for the report and a suggested patch.

2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (initialization): Define `@b` as empty if
	formatting for HTML, because no page breaks occur in that
	format.

	Fixes <https://savannah.gnu.org/bugs/?62039>.

2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grodvi/dvi.cpp (usage): Align usage message with
	man page; disclose `-l` option.

2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grodvi/dvi.cpp (main):
	* src/devices/grops/ps.cpp (main): Update diagnostic:
	characterize bad `-w` argument as "invalid", not "bad", and
	explicitly report it as ignored.

	* src/devices/grodvi/dvi.cpp (main): Report invalid parameter
	in `-w` diagnostic.

2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grodvi/dvi.cpp (dvi_printer::set_color)
	(draw_dvi_printer::fill_next):
	* src/devices/grops/ps.cpp (output::put_color):
	* src/libs/libgroff/color.cpp (color::print_color): Explicitly
	cast `enum` divisors to `double`; quietens
	`-Wdeprecated-enum-float-conversion` warnings.

	Fixes <https://savannah.gnu.org/bugs/?61964>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Recover more quickly from missing `EE` calls.
	(initialization): Define new strings, `an*body-family` and
	`an*example-family` to house the font families used in these
	rendering contexts.
	(TH, SH, SS): Restore the font family to `an*body-family`.
	(TH): Set font style to roman as well.
	(EX): Change to `an*example-family` instead of literal "C".

	Fixes <https://savannah.gnu.org/bugs/?62187>.

2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Test register for existence before using it to
	set hyphenation mode.  A site troffrc or other local
	customization might remove the register (which is guaranteed to
	be set under the stock configuration) and, perversely, Heirloom
	Doctools troff interprets a `do` request, instead of ignoring it
	as a historical troff implementation would, so if they borrow
	our me(7) changes, the register would be unset, interpolate
	zero, and hyphenation would wind up disabled.

	Fixes <https://savannah.gnu.org/bugs/?62181>.  Thanks to Dave
	Kemper for the report.

2022-03-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Rename test to apply naming scheme.

	* tmac/tests/pdfpic_falls_back_to_PSPIC.sh: Rename this...
	* tmac/tests/pdfpic_falls-back-to-PSPIC.sh: ...to this.
	* tmac/tmac.am (tmac_TESTS): Use new name.

2022-03-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/ps.cpp (usage): Align usage message with man
	page synopsis.

2022-03-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Input Line Traps): Fix error; input traps do
	_not_ ignore control lines.  Error appears to have crept in with
	the first version of our Texinfo manual, shipped with groff 1.14
	{December 1999}.

2022-03-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devps/devps.am: Rename targets.
	(fonts):
	(devps_fonts): Rename these...
	(maintainer-font-descriptions):
	(devps_font-descriptions): ...to these.  Add comments explaining
	what they're for and why they aren't used in a build.

	* font/devps/generate/Makefile: Add `outdir` variable to store
	destination directory of font description files, and update all
	targets that write artifacts to use this directory.  This makes
	the targets "phony", which I don't regard as a problem since the
	generated artifacts are kept under source control, and this
	isn't really a user-facing script (even though it gets
	installed).  I think there is a good chance that this will
	become a shell script, because to avoid regressions we need to
	generate the font descriptions using both the 229-glyph and
	314-glyph versions of the Adobe fonts' AFM files (so that we get
	wider glyph coverage _and_ more kerning pair data) and we need
	to add kerning information for the ellipsis (Savannah #58897).
	(symbolsl.afm): Revise generation process to be sensitive to
	failure.

2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devps/symbolsl.afm: New file.
	* font/devps/devps.am (EXTRA_DIST): We have long shipped
	"symbol.afm" with the distribution archive--I don't see why we
	don't ship "symbolsl.afm" and "zapfdr.afm" as well (metrics for
	`SS`, the slanted symbol font, and ZDR, reversed Zapf Dingbats).
	Like the Type 1 font descriptions themselves, this file is
	updated only in "maintainer mode", not as part of the build.
	Moreover, these fonts are not part of the PostScript level 2
	base 35 fonts so their AFM files are unlikely to be readily
	available elsewhere.

2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Trivially refactor.  Store the
	program's version string in scalar `afmtodit_version` and use
	that in the usage message and comment embedded in the output.

2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Fix code style nits.  Migrate
	to the shebang line style we use in more recently modified Perl
	scripts.  Replace `-w` with `use warnings;`.  Shorten an output
	comment since the groff version string can grow long (see commit
	1264531310, 14 January 2018).

2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Stop writing full file name to
	the generated font description file as the "name" (i.e., don't
	include directory components).

	Fixes <https://savannah.gnu.org/bugs/?62150>.  Thanks to Dave
	Kemper for the discussion and code review.

2022-03-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.1.man:
	* src/utils/afmtodit/afmtodit.pl: Update and align man page
	synopsis, option descriptions, and command usage output.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/X.tmac: Redirect `fchar` requests for \[lq] and \[rq] to
	\[dq] since the X11 Type 1-based text fonts encode ISO 8859-1
	{Latin-1} and don't have typopgrapher's quotes.  Drop `fchar`
	request for \[aq], which _is_ represented, per recent changes.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* /font/devX100-12/CB:
	* /font/devX100-12/CBI:
	* /font/devX100-12/CI:
	* /font/devX100-12/CR:
	* /font/devX100-12/HB:
	* /font/devX100-12/HBI:
	* /font/devX100-12/HI:
	* /font/devX100-12/HR:
	* /font/devX100-12/NB:
	* /font/devX100-12/NBI:
	* /font/devX100-12/NI:
	* /font/devX100-12/NR:
	* /font/devX100-12/TB:
	* /font/devX100-12/TBI:
	* /font/devX100-12/TI:
	* /font/devX100-12/TR:
	* /font/devX100/CB:
	* /font/devX100/CBI:
	* /font/devX100/CI:
	* /font/devX100/CR:
	* /font/devX100/HB:
	* /font/devX100/HBI:
	* /font/devX100/HI:
	* /font/devX100/HR:
	* /font/devX100/NB:
	* /font/devX100/NBI:
	* /font/devX100/NI:
	* /font/devX100/NR:
	* /font/devX100/TB:
	* /font/devX100/TBI:
	* /font/devX100/TI:
	* /font/devX100/TR:
	* /font/devX75-12/CB:
	* /font/devX75-12/CBI:
	* /font/devX75-12/CI:
	* /font/devX75-12/CR:
	* /font/devX75-12/HB:
	* /font/devX75-12/HBI:
	* /font/devX75-12/HI:
	* /font/devX75-12/HR:
	* /font/devX75-12/NB:
	* /font/devX75-12/NBI:
	* /font/devX75-12/NI:
	* /font/devX75-12/NR:
	* /font/devX75-12/TB:
	* /font/devX75-12/TBI:
	* /font/devX75-12/TI:
	* /font/devX75-12/TR:
	* /font/devX75/CB:
	* /font/devX75/CBI:
	* /font/devX75/CI:
	* /font/devX75/CR:
	* /font/devX75/HB:
	* /font/devX75/HBI:
	* /font/devX75/HI:
	* /font/devX75/HR:
	* /font/devX75/NB:
	* /font/devX75/NBI:
	* /font/devX75/NI:
	* /font/devX75/NR:
	* /font/devX75/TB:
	* /font/devX75/TBI:
	* /font/devX75/TI:
	* /font/devX75/TR: Regenerate font descriptions with xtotroff,
	using updated ISO-8859_1 map.  \[aq] and \[oq] are now aliases
	of "'" and \[ga] is an alias of "`".  This change probably
	should have been made when the X11 fonts were corrected in
	XFree86 4.0 (March 2000).  See
	<https://www.cl.cam.ac.uk/~mgk25/ucs/quotes.html>.

	Fixes <https://bugs.debian.org/243238>.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libxutil/DviChar.c (ISO_8859_1_map): Fix incorrect
	assignment of Latin-1 grave accent to \[oq] special character;
	reassign it to the neutral apostrophe.  Map \[aq] to neutral
	apostrophe.  Map \[ga] to '`'.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/xtotroff/xtotroff.1.man (Options) <-d>: Document new
	option.
	* src/utils/xtotroff/xtotroff.c (usage): Align with man page.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Filling and Adjustment):
	Explicitly identify the page offset as an output line property
	that is not determined until a break occurs.

	(Line Layout) <po>: Correct error; the page offset for terminal
	devices is set by "tty.tmac", not "troffrc".  (The manual has
	been wrong for a long time; we've had it in tty.tmac since James
	Clark put it there in 1992.)  Recast and tighten wording.  Drop
	the word "horizontal"; there is no vertical page offset (as
	such) in *roff.  Replace hand-waving about unexpected results
	with a description of the formatter's behavior.  Document
	request behavior without an argument before getting into the
	weeds (and CSTR #54 errata).  Migrate terminology from "scaling
	indicator" to "scaling unit".

	Fixes <https://savannah.gnu.org/bugs/?58035>.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Expressions): Expand '|' operator explanation.
	Split discussion of its application into horizontal and vertical
	contexts.  Add example of vertical usage.

	Fixes <https://savannah.gnu.org/bugs/?60820>.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp: Trivially refactor.  Drop `#define`
	that was working around a GCC 2.95-era libstdc++ problem.
	Shorten long line.
	(get_char_for_escape_parameter): Demote parameter from `int` to
	`bool` and use Boolean literal for default argument.  Annotate a
	null pointer constant.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Rename some internal functions.

	* src/roff/troff/input.cpp: Do it.
	(read_escape_name):
	(read_long_escape_name):
	(read_two_char_escape_name):
	(get_char_for_escape_name):
	(read_increment_and_escape_name): Rename these...
	(read_escape_parameter):
	(read_long_escape_parameters):
	(get_char_for_escape_parameter):
	(read_two_char_escape_parameter):
	(read_increment_and_escape_parameter): ...to these.
	(read_two_char_escape_parameter, read_long_escape_parameters,
	read_escape_parameter, read_increment_and_escape_parameter,
	get_copy, token::next): Update call sites.

2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (get_char_for_escape_name): Recast
	diagnostic messages to more accurately refer to escape
	"sequence" rather than "name".  "Name" is a confusing term here,
	given that it also applies to a group of objects sharing a name
	space (natch): requests, macros, strings, and diversions.
	Further, the "escape name" cited by these diagnostics is not the
	escape function selector; that is, the character after the
	escape character which determines how the escape sequence is to
	be interpreted.  These diagnostics are only thrown after that
	function is known, however, when parsing of an escape sequence
	parameter is attempted.
	(input_char_description): Drop leading articles ("a") from
	input character descriptions, to economize in diagnostic
	messages this function helps produce.
	(non_empty_name_warning): Use zero copula for economy.

	* src/roff/troff/input.cpp (empty_name_warning, read_size)
	(token::get_char, check_missing_character):
	* src/roff/troff/number.cpp (start_number, parse_term): Recast
	messages to more consistently use the form "expected X, got Y"
	where feasible.

	* src/roff/troff/number.cpp (start_number): Say "numeric
	expression missing" instead of "missing number"; we don't
	require a terminal symbol in the expression grammar here.  Also
	use `tok.description()` where we can, and remove assumption that
	the escape character is the default.

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (AT, UC, HP): Add deprecation warnings.  For the
	last, only do so if we're not inside a synopsis (SY/YS), since
	our definition of `SY` calls `HP` internally.  (This does seem
	hypocritical.  Perhaps if we knew the correct CSS incantation
	to speak in grohtml, we could un-deprecate `HP`.)

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.an (M4CHECK): Rename stamp file to make its purpose
	clearer.

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Tweak customization management.

	* tmac/an.tmac: Load "man.local" with `msoquiet` request, so
	people can get rid of the file if they don't need it.
	(PT, BT): Define these macros only if not already defined.  This
	is slightly less paranoid but far more ergonomic, given
	interactions with the andoc wrapper.  Now user-defined page
	header traps (PT) defined in man.local can take effect on the
	first page rendered.

	* tmac/groff_man.7.man.in (Hooks): Document how to remove page
	headers and/or footers entirely.

	Fixes <https://savannah.gnu.org/bugs/?61954>.

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer,mm]: Add and use `ref*reset` macro to clean up between
	bibilography entries.

	* tmac/refer.tmac (]-): Move string clean up logic from here...
	(ref*reset): ...to this new macro.  Now we can also use it...

	* contrib/mm/refer-mm.tmac (ref*][-first-pass): ...here.

	Problem appears to date back to refer-mm.tmac's introduction in
	January 2011.  Thanks to Bjarni Ingi Gislason for the root-cause
	analysis and proposed fix, to which I applied the DRY principle
	and added a reset of `ref*string` as well.

	Fixes <https://savannah.gnu.org/bugs/?60657>.

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mm]: Regression-test Savannah #60657.

	* contrib/mm/tests/remove-stale-bib-entry-data.sh: Do it.
	* contrib/mm/tests/artifacts/60657.ref: Add new file.
	* contrib/mm/mm.am (mm_TESTS): Run test.
	(EXTRA_DIST): Ship test artifact in distribution archive.

	Thanks to Bjarni Ingi Gislason for the straightforward
	bug reproducer.

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Report correct line number in bibliography file
	diagnostics.

	* src/preproc/refer/refer.cpp (do_bib): Set line number to 1
	upon successfully opening a bibliography file.

	Problem appears to date back to groff 1.02 (June 1991) at the
	latest.

	Fixes <https://savannah.gnu.org/bugs/?62142>.

2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[refer]: Regression-test Savannah #62124.

	* src/preproc/refer/tests/report-correct-line-numbers.sh: Do it.
	* src/preproc/refer/tests/artifacts/62124.ref: Add new file.
	* src/preproc/refer/refer.am (refer_TESTS): Run test.
	(EXTRA_DIST): Ship test artifact in distribution archive.

2022-03-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/div.cpp
	(top_level_diversion::transparent_output):
	* src/roff/troff/input.cpp (transparent_translate): Suppress two
	troublesome (i.e., more or less spurious) error diagnostics
	about transparent output/throughput unless the environment
	variable `GROFF_ENABLE_TRANSPARENCY_WARNINGS` is present.  This
	is a bit of a bodge until we get diversion sanitization worked
	out.  See Savannah #61407.

2022-03-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[preconv]: Stop assuming that the default input stream, or an
	explicit '-' operand, is the only unseekable stream.  Check
	instead.

	* src/preproc/preconv/preconv.cpp (do_file): Add new Boolean
	`is_seekable`.  Test the input stream with `fseek()` per a
	suggestion from Ingo Schwarze.  Report unseekability in debug
	output and skip coding tag and uchardet tests altogether
	{precisely paralleling our description in the preconv(1) man
	page}.  Also update debugging output to say "<standard input>"
	instead of "-".

	Fixes <https://savannah.gnu.org/bugs/?62131>.

2022-03-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[preconv]: Regression-test Savannah #62131.

	* src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Do
	it.
	* src/preproc/preconv/preconv.am (preconv_TESTS): Run test.

2022-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (process_format): Update diagnostic
	to recognize that a font mounting position is also an acceptable
	argument to the 'f' column modifier.

2022-02-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	Refactor X11 font description generation.  Integrate it with our
	"new" (post-2014) Automake-based build system.

	* src/utils/xtotroff/Makefile.in: Delete relic of old build
	system.  Also, it had a bug: it generated X11 output device
	'DESC' files with a "unitwidth 10" directive even for the "-12"
	devices, which is not correct (the in-tree DESC files we've been
	shipping for years were nevertheless correct, apparently fixed
	by hand by James Clark in groff 1.07 [March 1993]).

	* src/utils/xtotroff/xtotroff.am: Define `xtotroff` variable for
	use by X11 font description generation targets below.

	* font/devX100-12/devX100-12.am:
	* font/devX100/devX100.am:
	* font/devX75-12/devX75-12.am:
	* font/devX75/devX75.am: Add new (phony) targets, variously
	named "devX{100,100_12,75,75_12}", to generate the corresponding
	output device's DESC file and run xtotroff(1) to generate its
	font description files.  Be sure to set the correct "unitwidth"
	for the "-12" devices.  Add new dependency-only rule
	"maintainer-font-descriptions" depending on these new targets
	for convenience (and future expansion to devps and devlj4).

	* FOR-RELEASE: Document existence of
	"maintainer-font-descriptions" Make target and when to run it.

	Running this target with the aforementioned bug fix, overwriting
	the in-tree DESC and font description files using data gathered
	from a running X server, results in no changes whatsoever.  Say
	what you will about X11 core font technology--it's stable.

2022-02-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	Rename and ship "FontMap-X11".  xtotroff(1) is not very useful
	without a font name mapping file to read.  To date it has been
	available only in the source distribution.  Remedy that.  The
	file is placed directly in the groff font directory alongside
	the device directories because it applies to four different
	devices, and four copies of this data are not required.

	* src/devices/xditview/FontMap: Rename to...
	* src/devices/xditview/FontMap-X11: ...this.

	* LICENSES:
	* src/devices/xditview/xditview.am (EXTRA_DIST): Reflect rename.

	* src/devices/xditview/xditview.am (install_xditview
	  [!WITHOUT_X11], uninstall_xtdiview): (Un-)install it.

	* src/utils/xtotroff/xtotroff.1.man (Files): Add section
	documenting the presence and purpose of this file.

2022-02-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[xtotroff]: Add `-d` option to produce font description files in
	specified directory.

	* src/utils/xtotroff/xtotroff.c: Do it.  Add global `destdir`
	pointer.
	(xtotroff_exit): Add new function to clean up storage allocated
	by `strdup()` (below) for destination directory.
	(MapFont): Introduce new variable `file_name`, into which we
	assemble a destination file name from `destdir` (if not null)
	and the troff font name.  Handle memory allocation failure (by
	carefully dying).  Free allocated storage on success and failure
	paths out of the function.
	(usage): Document new `-d` option.
	(main): Instruct `getopt_long` to expect a `-d` flag with an
	argument.  Use `strdup()` to make a copy of any such option
	argument.  Call `xtotroff_exit()` instead of `exit()`.

	* src/utils/xtotroff/xtotroff.1.man: Document new `-d` option.

2022-02-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[xtotroff]: Trivially refactor.

	* src/utils/xtotroff/xtotroff.c: Boolify.  Include `stdbool.h`
	and `errno.h` headers.
	(charExists, CanonicalizeFontName, FontNamesAmbiguous, MapFont):
	Boolify.  Demote return type from `int` to `bool` and return
	Boolean instead of integer literals.
	(FontNamesAmbiguous, main): Reorder equality comparisons with
	simple left-hand sides to avoid inadvertent lvalue assignments.
	(FontNamesAmbiguous, MapFont): Refer to font name as "invalid",
	not "bad", in diagnostic messages.
	(MapFont, main): Use `strerror()` instead of `perror()` so that
	diagnostics include the program name and an indication of
	problem severity.
	(MapFont): Compare `FILE` stream pointer to `NULL` instead of
	treating it as a Boolean.
	(main): Use `EXIT_SUCCESS` and `EXIT_FAILURE` constants from C
	library instead of integer literals for exit status.

2022-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pic]: Fix "unused result" compiler warning.

	* src/preproc/pic/pic.ypp (placeless_element) <SH>: Check return
	value of `system()` to quieten `-Wunused-result` warning; if it
	is less than zero, report it to the standard error stream.

2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/safer.tmac: Drop file from distribution.  It contained
	only comments.
	* tmac/tmac.am (TMACNORMALFILES): Delete reference.
	* NEWS: Add item.  Suggest two workarounds for its absence.

	Fixes <https://savannah.gnu.org/bugs/?61831>.

2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac (initialization): Drop definition of
	`doc-curr-size` register.  It is no longer needed since nothing
	internal to the package now changes the type size.

	* tmac/doc.tmac (Fl, doc-print-recursive, doc-print-prefixes)
	(doc-generic-macro, Ar, Cd, doc-do-func-decl, Fd, In, Nm, Pa)
	(Tn, doc-enclose-string, Ef, Bd, doc-save-global-vars)
	(doc-restore-global-vars, doc-diag-list, Xr, Dl, Vt, Ft, Fa)
	(doc-do-func, Fn, doc-do-func-args, Fo, Fc, %A, %B, %C, %D, %I)
	(%J, %N, %O, %P, %Q, %R, %T, %U, %V, doc-do-reference, Hf, An)
	Lk):
	* tmac/mdoc/doc-common (Sh, Ss, Rd):
	* tmac/mdoc/doc-syms (Ux, Bx, At, Dx, Fx, Nx, Ox, Bsx, St, Lb):
	Drop interpolations of the string and comments documenting that
	each macro has a side effect on the type size.

2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/doc.tmac (Tn):
	* tmac/mdoc/doc-syms (Ux, Bx): Stop interpolating string
	`doc-Tn-font-size` to set macro arguments at a smaller type
	size.  This leaves the string without a purpose, so...

	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Drop definitions of `doc-Tn-font-size`.

	* tmac/mdoc/doc-syms: Drop interpolations of that string from
	numerous other string definitions.

	Fixes <https://savannah.gnu.org/bugs/?60616>.

2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	Revert addition of man(7) `BD` register.  This feature, which I
	introduced in commit ea3b27102f (31 January) doesn't work
	because pdf.tmac normalizes the bookmark depth.  Embedding a man
	page in a larger PDF document with appropriately nested
	bookmarks is a project that will have to await another day (or
	perhaps already has tools to implement it).

	* tmac/an.tmac: Do it.
	* tmac/groff_man.7.man.in: De-document it.

2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdf.tmac: Add string containing the name of the macro
	package for use in diagnostic messages.
	(pdf:warn, pdf:error): Use it.

	Continues the long process of fixing Savannah #52463.

2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man,mdoc,me]: Revise hyphenation localization.

	* tmac/an.tmac (an*reset-hyphenation-mode): New macro sets the
	hyphenation mode appropriate to the locale depending on the
	values of `cR` (continuous rendering mode) and `HY` (hyphenation
	enablement); the latter is now interpreted as a Boolean.  Define
	new register `an*hyphenation-mode` reflecting these conditions.
	(TH): Call the foregoing instead of invoking `hy` request.
	(MR): Restore hyphenation mode to `an*hyphenation-mode`.
	(initialization): Simplify; if not defined, set `HY` to 1.

	* tmac/e.tmac (ld): Set the hyphenation mode here instead of in
	initialization (which already calls this macro).  Set the mode
	to 6 for the benefit of anyone borrowing our me(7) changes, but
	then immediately change to the mode determined by the
	localization file.

	* tmac/mdoc/doc-common (doc-hyphen-flags): Set a hyphenation
	mode appropriate to the locale, depending on the values of `cR`
	and `HY`.
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff: Simplify initialization; if not defined,
	set `HY` to 1.

	* tmac/cs.tmac:
	* tmac/de.tmac:
	* tmac/en.tmac:
	* tmac/fr.tmac:
	* tmac/it.tmac:
	* tmac/sv.tmac: Before switching locales, set a flag if
	troublesome value 2 of the hyphenation mode is set so that we
	can preserve it.  Shift man(7) and me(7) logic to follow setup
	of the new hyphenation mode; for the former, call the new
	`an*reset-hyphenation-mode`.

	* tmac/groff_man.7.man.in:
	* tmac/groff_mdoc.7.man: Document updated meaning of `HY`
	register.

	* NEWS: Add item noting change of man(7) `HY`'s meaning.  Update
	existing item regarding mdoc(7)'s support for it (groff 1.22.4
	mdoc(7) didn't recognize the register at all).

	Fixes <https://savannah.gnu.org/bugs/?61734> (for real this
	time?).

2022-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Regression-test Savannah #61734.

	* tmac/tests/an_reset-hyphenation-correctly.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_char.7.man (History): Add new section.
	(See also): Add cross reference to 1976 edition of CSTR #54.

2022-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man.in (Document structure macros) <EX, EE>
	[style]: Add material cautioning writers against asoociating
	the disablement of filling with some sort of "literal mode".
	Document still-operational status of inter-sentence space
	supplementation.
	(Notes) [style]: Describe an alternative (and macro
	call-symmetrical) means of using `RS` and `RE` with `TP`.

2022-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Add phony targets "man-all" and "man-clean" to
	{re-}generate and delete all man pages, respectively.

	Arguably fixes <https://savannah.gnu.org/bugs/?61167>.

2022-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am (.man): Prefix hyphenation control escape
	sequences to more configuration-time interpolations to prevent
	their hyphenation: @DEVICE@, @g@, @INDEX_SUFFIX@, @PAGE@,
	@TMAC_{AN,M,S}_PREFIX@, @TMAC_MDIR@.

2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Refactor `EX` and `EE` macros.

	* tmac/an-ext.tmac: Add new `mC` string to store the font name
	to be used for example regions.  In AT&T device-independent
	troff, "CW" was a common name, so use that.  It is however a
	terrible fit for groff's font family and style-combination
	functionality, and is inflexible in the face of font selection
	requests and escape sequences within the example region.  (One
	either needs to know the names of the fonts available on the
	output device, or suffer the indignity of mixed constant-width
	and proportional typefaces.)  Relatedly, drop groff-specific
	font remapping requests.
	(EX, EE): Ignore definition if GNU troff is the formatter.  Drop
	font family manipulation.  Drop specialized logic for groff's
	DVI output device.

	* tmac/an.tmac (initialization): Resurrect font remapping
	requests here.
	(EX, EE): Add new definitions, saving and restoring more state
	and remapping DVI output device fonts to reflect the absence of
	CWB and CWBI faces.

2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Slightly refactor.  Stop using groff's `HY`
	register to restore the hyphenation mode, since I plan to change
	its semantics to a Boolean value (see Savannah #61734).
	Introduce new register `mJ` to store "1" (if not groff) and the
	current hyphenation mode otherwise.  Explain why in a comment.
	(YS, UE, ME, MR): Restore hyphenation mode using `mJ` instead of
	`HY`.

2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: Trivially refactor.  Use a better idiom
	{seen in James Clark's changes to BSD me(7)} for conditionally
	defining a (simple) macro.

2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tty.cpp (tty_printer::special): Warn upon
	encountering unrecognized device control commands using the
	'tty:' tag.

2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Remove 'sgr' device control command.

	* src/devices/grotty/tty.cpp (tty_printer::special): Do it.
	* src/devices/grotty/grotty.1.man (Device control commands):
	{De-}document it.
	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?61561>.

2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdfpic.tmac: Add support for Cygwin/MinGW temporary
	directory conventions.

2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdfpic.tmac: Search for temporary directories as groff(1)
	does, instead of going straight to /tmp.
	(pdfpic@get-temporary-directory): New function checks each of
	its arguments for validity as a temporary directory; if one is
	found, its name is left in `pdfpic*temporary-directory`.
	(pdfpic@cleanup): Remove strings `pdfpic*temporary-directory`
	and `pdfpic*temporary-file`.
	(PDFPIC): Call `pdfpic@get-temporary-directory`, using the
	contents of the environment variables $GROFF_TMPDIR and $TMPDIR,
	and then /tmp, in that order.  Store the temporary file name in
	string `pdfpic*temporary-file`.  Use this string in subsequent
	`sy` and `so` requests.

	Fixes <https://savannah.gnu.org/bugs/?62055> for Unix systems.

2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Add test for PDFPIC fallback to PSPIC.

	* tmac/tests/pdfpic_falls_back_to_PSPIC.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Tweak PDFPIC test input.

	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
	Eliminate unnecessary blank lines from input.  Also call gs(1)
	with '-q' in addition to '-o'.  (Why does the latter not imply
	the former?!)  Thanks to Deri James for the advice.

2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdfpic.tmac: Slightly refactor.
	(pdfpic@cleanup, PDFPIC): Rename `pdfpic*file-name` to
	`pdfpic*file-name-base` since it is not used as a complete file
	name (but rather a basis for an ".eps" extension).
	(PDFPIC): When testing PDF file extension, include the "."; a
	file name like "mxyzptlkpdf" is too dubious to accept.  Also
	explicitly compare `systat` register as equal or not equal to
	zero, since its truth value is inverted from the expectations of
	*roff expressions.

2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdfpic.tmac (PDFPIC): Refactor PDFPIC_NOSPACE handling.
	Stop shelling out to create, and then sourcing, a temporary file
	just to obtain the value of an environment variable.  groff
	already has the `\V` escape sequence for that purpose (it's even
	safe!).  Check that the value of $GROFF_PDFPIC_NOSPACE is a
	valid numeric expression before assigning it to a register.
	Trivially, use '=' instead of '==' as an equality operator.
	*roff languages do not use '=' as an assignment operator, and I
	believe the '==' synonym to be a sop to C programmers.

2022-02-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Stop attempting to adjust pargraph tag lines.

	* tmac/an.tmac (TP): Disable adjustment inside the diversion.
	(an-write-paragraph-tag): Restore adjustment outside of it.

	Fixes <https://savannah.gnu.org/bugs/?62051>.

2022-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (@z): Conceal bare tab after request name (exposed
	by no longer stripping the macro file).  See commit ad0575f20, 9
	December.

2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grops,troff]: Migrate to term "scaling unit" in diagnostics.

	* src/devices/grops/ps.cpp (ps_printer::do_import):
	* src/roff/troff/input.cpp (warnscale_request):
	* src/roff/troff/number.cpp (parse_term): Do it.

2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Add nroff mode fallback for `u` macro.

	* tmac/e.tmac (u): On nroff devices, bracket the first argument
	with \(ul (underline rule) special character escape sequences.
	{In plain language, '.u "like this"' renders "_like this_".}

	I regard this as a cosmetic and semantic improvement; since the
	quarter-em vertical motions used in troff mode were ignored in
	nroff mode, the effect was not underlining but a sort of
	strike-through, visible only at spaces in the argument.  The use
	of this macro was thus invisible in nroff output if no spaces
	were present in the argument.  This is probably the best we can
	do without a fatter interface to terminal device capabilities.

2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Simulate boxed text support on nroff devices with ISO 6429
	color escape sequences.

	* tmac/e.tmac (bx): Do it.  Add further fallback for non-groff
	formatters in nroff mode, bracketing the boxed argument with '|'
	glyphs.
	* doc/meref.me.in: Document it.

	Fixes <https://savannah.gnu.org/bugs/?62038>.

2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Rename registers `$v` -> `tv`, `$V` -> `dv`.

	* tmac/e.tmac: Do it.  Also include much commentary (including
	some from James Clark in 1992) attempting to illuminate the
	confusing history (and naming) of `$[rRvV]`.

	* doc/meref.me.in: Document it.  Introduce new terms
	"text vertical spacing" and "display vertical spacing" earlier
	and use them to condense and clarify discussions of their use.

	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?61710>.

2022-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Deferring Output): Add new node introducing
	and motivating environments, diversions, and traps.

2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Add more compatibility mode guards.

2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/pdf.tmac: Add compatibility mode guards so that we can
	run even if troff is given the -C option.  Resurrect your
	vintage 1975 Sixth Edition Unix manuals from '.deth' and format
	them in PDF today!

	Fixes <https://savannah.gnu.org/bugs/?61995>.

2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac: Prefix diagnostic with package file name
	literally.

2022-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Trivially refactor.

	* tmac/an.tmac (an*localize): Rename to...
	(an*localize-strings): ...this.
	(TH): Update call site.

2022-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Present several fundamental concepts.

	* doc/groff.texi (Page Geometry):
	* man/roff.7.man (Concepts): Add new node/section.
	  - page geometry
	  - basic units
	  - device resolution
	  - drawing position
	  - text baseline
	  - page offset
	  - vertical spacing
	  - page break

	Fixes the remainder of <https://savannah.gnu.org/bugs/?58035>.

2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Add page length insufficiency check.

	* tmac/e.tmac (@h): Port Keith Marshall's page length checker
	from ms(7).

	Fixes <https://savannah.gnu.org/bugs/?61034> and
	<https://savannah.gnu.org/bugs/?61428>.

2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Add test for insufficient page length error.

	* tmac/tests/e_rejects-too-short-page-lengths.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Slightly refactor.

	* tmac/e.tmac (@h): Use groff default scaling operator in
	conditional expression.  Add `do` requests so that the logic for
	checking the line length works in compatibility mode.  Also move
	misplaced parenthesis in conditional expression.

2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Refactor insufficient page length check.

	* tmac/s.tmac (pg@top): Drop extraneous closing parenthesis from
	numeric expression.  Change operator from '>' to '>='; a page
	length right at the boundary causes a spurious extra page break
	when a paragraphing macro is used to initialize the document.
	Condense diagnostic emission using the @error macro instead of
	duplicating it.  Change indentation to fit the style of the rest
	of the file (use hard tabs).  If aborting, truncate the page
	length to the current vertical position so that we don't
	uselessly output further vertical space.

2022-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Add test for insufficient page length error.

	* tmac/tests/s_rejects-too-short-page-lengths.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Vertically space delayed text like other annotations.

	* tmac/e.tmac ((d): Set vertical spacing using percentage in
	`$V` register.
	()d): Restore vertical spacing using percentage in `$v`
	register.

	Fixes <https://savannah.gnu.org/bugs/?61973>.

2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Expand '@PAGE@' when generating man pages.

	* Makefile.am (.man): Substitute the './configure'd paper format
	for @PAGE@.
	* src/roff/groff/groff.1.man: Use it.

2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Trivially refactor an-ext.tmac.

	* tmac/an-ext.tmac (EX, EE): Do a better job of keeping the
	name space promise made in comments at the top of the file.
	Rename `sP` register to `mP`.  Problem introduced by me in
	commit 69895ec20, 15 January 2020.  Also rename `la` and `ra`
	strings to `mL` and `mR`, respectively.  These (undocumented)
	string names date back to commit 259929625, 15 January 2007.

	* tmac/groff_man.7.man.in (Files) <an-ext.tmac>: Document the
	aforementioned promise.

2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Refactor PDF bookmark support.

	* tmac/an.tmac (an*bookmark): New internal macro calls
	`pdfbookmark` (only if the output device is 'pdf').
	(initialization): Migrate macro appendments to appropriate
	definitions.  Two cases...
	(SH, SS): ...were straightforward.
	(initialization): Another (for the man page title) was poorly
	placed when appended to the `TH` macro, skipping over the page
	header.  Move it instead...
	(PT): ...here.  But to keep this bookmark from being generated
	on every page of a document, we need a new variable
	`an*was-TH-bookmark-emitted` which is tested here and assigned
	once one bookmark corresponding to a `TH` call has been written.
	(TH): Initialize `an*was-TH-bookmark-emitted` to zero.
	(SS): Write the bookmark _before_ the subsection heading text.
	(initialization): Drop short-lived `BM` register.  It seems
	harmless to unconditionally include bookmarks in PDF output.  A
	PDF tool can strip them out if they're not desired, and viewers
	seem capable of minimizing or reducing the navigation pane (if
	they even offer one in the first place).

	* tmac/an.tmac (initialization): Rename new `BN` register to
	`BD`...
	* tmac/groff_man.7.man.in (Options) <BD>: ...and document it.
	Also document `PT`'s new bookmarking responsibility.

	Fixes <https://savannah.gnu.org/bugs/?58949> and
	<https://savannah.gnu.org/bugs/?58950>.

2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml,groff,nroff,troff]: Tweak usage message.

	* src/devices/grohtml/post-html.cpp (usage):
	* src/roff/groff/groff.cpp (synopsis):
	* src/roff/nroff/nroff.sh:
	* src/roff/troff/input.cpp (usage): Partly revert commit
	06ae7b0b8, 16 January.  Move an ellipsis back inside a bracketed
	operand (that is, an optional one).  On reflection, I think this
	notation makes it clearer that the command can be meaningfully
	run without operands.

2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/papersize.tmac: Slightly refactor.  Use new `stringdown`
	request instead of a combination of `tr`, `di`, `asciify`, and
	`chop`.

2022-01-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Slightly refactor.

	* tmac/an.tmac (an-prepare-page-title): Rename to...
	(an*prepare-page-title): ...this.  Also simplify numeric
	expression.  Add comment regarding necessity of correct
	environment.

	(an-header): Update call site of `an*prepare-page-title`.

	(TH): Move planting of `an-header` trap from out of the midst of
	footer trap management.  Add comments.

	(an-header): Move `pl` and `sp` requests from here...
	(PT): ...to here.  While it's conceptually nice to have these
	macros consist solely of `tl` requests, it doesn't yield enough
	power to those who want to redefine them.  Add comment.

	(an-footer, BT): ...simile.

2022-01-27  Dave Kemper <saint.snit@gmail.com>

	[man pages]: Add more references to pic(1)'s .PF.

	* contrib/chem/chem.1.man:
	* contrib/pic2graph/pic2graph.1.man:
	* src/utils/grog/grog.1.man: Do it.

	Fixes <https://savannah.gnu.org/bugs/?61949>.

2022-01-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	Implement PDF bookmark support for man pages.  Limitation: A
	{sub}section can only be bookmarked if it is specified in the
	arguments to the `SH` or `SS` requests, not on the next line in
	an input trap.  Thanks to Deri James for providing the
	fundamentals (blame me for any weird bits).

	* tmac/an.tmac (an-prepare-page-title): Define a new string,
	`an*page-ref-string`, which is the man page's own reference
	{such as "groff(1)"} without any abbreviation, ellipsis, or font
	selection or italic correction escape sequences.
	(SS): Define a new string, `an*subsection-heading`, storing the
	macro arguments (if any).  These could contain font selection
	escape sequences, for instance, a fact that becomes important
	later.
	(initialization):
	- Recognize `BM` register to enable PDF bookmarks (only on the
	  'pdf' output device); defaults on.  Recognize `BN` register to
	  set a base level/depth for the bookmarks; this is to ease
	  embedding of man pages in other PDF documents that already use
	  bookmarks.  The default is 0.  The registers are not yet
	  documented.
	- If the output device is 'pdf' and bookmarks are enabled, set
	  `PDFOUTLINE.FOLDLEVEL` and `PDFHREF.VIEW.LEADING` registers
	  {recognized by 'pdf.tmac'}.  Append to `TH`, `SH`, `SS` to get
	  the `an*page-ref-string`, `an-section-heading`, and
	  `an*subsection-heading` bookmarks in the document at the
	  applicable levels.

	* tmac/mdoc/doc-common: Add straw-man implementation--it doesn't
	support the `BM` and `BN` configuration parameters yet.  (This
	is enough to get bookmarks for the groff_mdoc(7) page to
	correctly appear in the new 'groff-man-pages.pdf' document.)
	(Dt, Sh, Ss): If the output device is 'pdf', place bookmarks in
	the document at levels 1, 2, and 3.

	Fixes <https://savannah.gnu.org/bugs/?58950>.

2022-01-26  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Allow multiline text in .pdfinfo

	* src/devices/gropdf/gropdf.pl: Use either '\\\\\\\\n' or
	'\[u000a]' as line separators in the string.

2022-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/trans.tmac: Further follow up commit c64fd60dff.  If the
	`andoc` wrapper is being used, perform man(7) localization (not
	just when `an` is loaded).

2022-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man pages]: Fix options used to generate compilations.

	* doc/doc.am (doc/groff-man-pages.pdf): Drop `-rU0` option (it's
	unnecessary since we don't yet have PDF hyperlink support in
	this document).  Add `-rC1` option to enable continuous page
	numbering.
	(doc/groff-man-pages.utf8.txt): Drop `-rC1 -rU1`.  Continuous
	page numbering is superfluous since page numbers are not shown
	in continuous rendering mode.  Stop turning on OSC 8 defaults;
	we don't know if the document will be viewed with a supporting
	pager+terminal combination, and further we don't yet have a
	mechanism for making `MR` man page cross references internal to
	the document when they indicate groff man pages.

2022-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man pages]: Ship compilations in UTF-8 text and PDF.

	Localization support and the resolution of Savannah #61266 have
	made it practical to batch-render all of groff's man pages as a
	single giant document.  Provide PDF and UTF-8 text (with ECMA-48
	escape sequences, but not the italic attribute or OSC 8
	sequences).

	Reasons for this addition include: {1} it is now possible,
	whereas I don't believe it was in any previous groff release;
	{2} many people still don't realize how much more pleasant
	reading typeset man pages can be (while a subjective assessment,
	I'm not alone[1]); {3} providing these forms permits full-text
	searching of groff's entire man page corpus via the PDF viewer
	or a pager like "less -R", the latter without sacrificing the
	style variations of the text that aid the reader to comprehend
	the material; {4} sentimentally, it honors the 50th anniversary
	of the first Unix manual (dated 3 November 1971)
	<https://www.bell-labs.com/usr/dmr/www/1stEdman.html>.

	* doc/doc.am (PROCESSEDDOCFILES): Add
	'doc/groff-man-pages.{pdf,utf8.txt}'.
	(GROFF_MAN_PAGES{1,2,3}): Add new macro storing names of all man
	pages generated in the build tree.  Motivate the reason for 3
	variables in a comment (it's due to groff locale switching).
	(GROFF_MAN_PAGES_ALL): Add convenience macro for use in
	dependency lists required by...
	('doc/groff-man-pages.{pdf,utf8.txt}'): ...these targets.
	Generate pages with the lint dial turned all the way up.

	Fixes <https://savannah.gnu.org/bugs/?61900>.

	[1] "The manual was intended to be typeset; some detail is
	sacrificed on terminals." (man(1), _Unix Time-Sharing System
	Programmer's Manual_, Eighth Edition, Volume 1, February 1985)

2022-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Commit c64fd60dff was not quite cooked.  The localized
	strings (in English) for the manual section titles need to be
	set at every document load (i.e., when `TH` is called), but only
	if the groff locale is "english".  When switching locales, these
	strings were getting "stuck" in their non-English translations
	even when returning to an English page.

	* tmac/an.tmac (an*localize): New macro initializes strings.
	(TH): Call `an*localize` if the locale is "english".
	(initialization): Drop initialization of section title strings.

	Continues fixing <https://savannah.gnu.org/bugs/?61734>.

2022-01-24  Deri James  <deri@chuzzlewit.myzen.co.uk>

	[gropdf]: Fix Savannah #61908

	* src/devices/gropdf/gropdf.pl: Adjust text position when
	given landscape media (i.e -P-l).

	Fixes <https://savannah.gnu.org/bugs/?61908>.

	Thanks to KUBO Koichi for finding the problem and supplying a
	patch.

2022-01-24  Deri James  <deri@chuzzlewit.myzen.co.uk>

	* src/devices/gropdf/gropdf.pl: A fix to importing pdf
	versions > 1.4.

2022-01-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Skip part of test if locale doesn't support UTF-8.

	* src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
	Skip test of 'utf8' output device if locale lacks UTF-8 support.
	But if the 'ascii' or 'latin1' test cases have already failed,
	report that instead.

	Fixes <https://savannah.gnu.org/bugs/?61891>.  Thanks to Bjarni
	Ingi Gislason for the report.

2022-01-23 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>

	[man pages]: Fix typos.

	Fixes <https://savannah.gnu.org/bugs/?61430>.

2022-01-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Fix style nits in test.

	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
	- Emit complaints about test environment to standard error.
	- Replace lingering literal file name with variable expansion.
	- Skip test if gs(1) fails, instead of reporting failure.
	- Begin continued lines with operators, for visibility.

2022-01-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix misspelled member variable.

	* src/devices/grohtml/post-html.cpp (class html_printer):
	Rename `supress_sub_sup` to `suppress_sub_sup`.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pdfpic]: Fix Savannah #58206.

	* tmac/pdfpic.tmac (PDFPIC): Scrub null bytes out of pdfinfo(1)
	output.  Thanks to an anonymous contributor for the patch (the
	commentary about it is mine, if someone wants an argument).

	Fixes <https://savannah.gnu.org/bugs/?58206>.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pdfpic]: Regression-test Savannah #58206.

	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh: Do
	it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pdfpic]: Refactor.

	Now that the package does not abort upon the first whiff of any
	trouble, avoid littering groff's name spaces.  Take this
	opportunity to rename registers and strings to have obvious
	meaning to even the casual reader.

	* tmac/pdfpic.tmac: Do it.
	(pdfpic@cleanup): New macro removes temporary strings and
	registers.
	(PDFPIC): Call the cleanup macro upon entry; this way, if we
	errored out from a previous call, we avoid confusion.  (We don't
	clean up upon an error return because the leftover objects might
	be useful for troubleshooting.)  Rename registers and strings,
	to get them under name space discipline and also to better
	suggest their purpose.
	- convert-pdf     -> pdfpic*do-conversion
	- pdf-offset-mode -> pdfpic*offset-mode
	- pspic-args      -> pdfpic*pspic-args
	- pdf-offset      -> pdfpic*indentation
	- is-pdf          -> pdfpic*file-extension
	- img-file        -> pdfpic*file-name
	- pdf-wid         -> pdfpic*width
	- pdf-ht          -> pdfpic*height
	- pdf-deswid      -> pdfpic*desired-width
	- pdf-desht       -> pdfpic*desired-height
	Call cleanup macro before returning upon successful operation.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pdfpic]: Improve robustness.

	* tmac/pdfpic.tmac (@abort): Rename to `pdfpic@error`.  This is
	an auxiliary package, and something else could very well step on
	the former name (or worse, we break it if we're loaded later).
	(pdfpic@error): Stop aborting; simply report an error.  It's up
	to the user how serious `PDFPIC` macro problems are.  As noted
	in a comment, the user can easily `am pdfpic@error` to tack an
	`ab` request onto the end of its definition.  Always report
	input file name and line number.  Replace "[PDFPIC]" prefix with
	the name of the macro file complaining, to make it easier for
	groff non-experts to find.
	(PDFPIC): Return upon errors.  Recast diagnostic messages.  Stop
	implying that we perform any sort of probing test of file type
	{there's no telling what pdfinfo(1) will say}.  Apply new
	'stringdown' request so that we accept '.pdf' file name
	extension in any lettercase.  Test file argument for existence
	before proceeding (acknowledge TOCTTOU exposure).  Skip file if
	pipeline returned a non-zero exit status or the registers into
	which we extract the height and width are undefined (indicating
	failure of a temporary file to be created or read).  Reject
	files with non-positive image width or height reported by
	pdfinfo.  Validate `width` and `height` arguments, if given,
	rejecting non-positive values.

	Fixes <https://savannah.gnu.org/bugs/?61892>.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mdoc]: Make `Pa` macro interpolate basic Latin tilde on all
	output devices.

	* tmac/doc.tmac (Pa): Do it.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix incorrect line numbers in diagnostics.  Line numbers
	for multiple format-time diagnostics emitted by tbl(1)-generated
	groff input were off by +5 lines.

	* src/preproc/tbl/table.cpp: Fix it.
	(NOP_NAME): Add new preprocessor symbol to construct name of
	"nop" macro to be used as end macro for `ig` requests inside
	macro definitions.
	(table::init_output, table::compute_expand_list,
	table::compute_separation_factor):
	- Move `entry_list->set_location()` calls to more auspicious
	  locations.
	- Replace "around line X" language in diagnostic messages with a
	  more idiomatic, and less embarrassing, simple report of an
	  integer.
	(table::init_output):
	- Add `entry_list->set_location()` call right before emitting
	  diagnostic about a table row not fitting on a page.
	- Turn off eqn(1) delimiters when emitting diagnostic about a
	  boxed table not fitting on a page (necessitating `.TS H`
	  support), using new NOP_NAME-based end macro to achieve this
	  inside a macro definition.
	(table::compute_expand_list): Suppress issue of too-wide table
	diagnostic when the `EXPAND` table flag is set (corresponding to
	the `expand` region option), because other code already emits
	diagnostics in this case.

	Fixes <https://savannah.gnu.org/bugs/?60598>.  Problem appears
	to date back to commit 3bc4a53a45, 2013-01-07.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Add unit test for format-time diagnostics.

	Ensure that the various format-time diagnostics that a
	tbl-preprocessed document can generate (1) occur when they are
	supposed to and (2) are appropriately suppressed by the
	"nowarn" and/or "nokeep" region options.  One of them is an
	error and cannot be suppressed by the former, but _can_ be by
	"nokeep", which is arguably a bug (Savannah #61878).

	* src/preproc/tbl/tests/format-time-diagnostics-work.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TEST): Run test.

2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Trivially refactor.

	* src/preproc/tbl/table.cpp (table::compute_expand_width):
	Declare and initialize variables closer to use.  Also, the width
	computed is compared to the line length and indentation, so use
	these well-established *roff terms in the diagnostic message.

2022-01-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix Savannah #61854.

	* src/preproc/tbl/table.cpp (compute_expand_width): To properly
	warn if a table is too wide to fit between the indentation and
	the right margin, we need to compute its column widths including
	those eligible for expansion via the 'x' column modifier; we
	cannot use the same expression that we do to determine the
	amount of space we have to distribute among the expanded
	columns.  Iterate through columns again (the function was
	already doing so twice), once to potentially produce the
	warning, and then as before to distribute any available width.
	In other words, warnings were only being emitted for too-wide
	tables where one or more columns used the 'x' modifier.

	Fixes <https://savannah.gnu.org/bugs/?61854>.

2022-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Don't add leaders that don't lead anywhere.

	* tmac/s.tmac (toc*end-entry): If no page number string
	`toc*num` is defined, don't interpolate its emptiness prefixed
	with a leader (and tab).  This makes "no" as the first argument
	to `XS` and `XA` work as documented, suppressing not only the
	page number but the leader after the entry.

	Fixes <https://savannah.gnu.org/bugs/?61853>.

2022-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Add regression test for Savannah #61853.

	* tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh: Do
	it.
	* tmac/tmac.am (tmac_TESTS): Run it.

2022-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Fix bad unit test.

	* tmac/tests/e_chapter-titles-work.sh: Fix missing shell test at
	end of script, which caused it to exit successfully regardless
	of any test failures.  Irritating.  This is among the fruits of
	the "never, ever use 'set -e'" tree.  (This religion has a thick
	bible: <https://mywiki.wooledge.org/BashFAQ/105>.)  Fortunately,
	all the tests pass legitimately.

2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[font]: For 'ascii' and 'latin1' devices, consistently define
	glyphs for ordinary characters before their special character
	aliases.  This parallels existing usage for the 'cp1047' device,
	and, I think, makes the file contents slightly more accessible.

	* font/devascii/R.proto:
	* font/devlatin1/R.proto: Do it.

2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Update diagnostic messages.

	* src/devices/grohtml/post-html.cpp (assert_state::add)
	(assert_state::compare, replace_negate_str)
	(assert_state::check_value_error, make_val): Make format of
	internal assertion system messages shorter and more mutually
	parallel.
	(html_printer::set_char, html_printer::set_numbered_char)
	(html_printer::set_char_and_width): Parallelize diagnostic
	messages with libdriver; see yesterday's commit.
	(main): Put information in argument to `assert()`; see commit
	11b43053, 24 November.

2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[nroff]: Emit usage message on usage errors.

	* src/roff/nroff/nroff.sh: Store the usage message in a shell
	variable instead of a here document, and sling it to the
	standard output or standard error streams, as appropriate.

2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml,groff,nroff,troff]: Tweak usage message.

	* src/devices/grohtml/post-html.cpp (usage):
	* src/roff/groff/groff.cpp (synopsis):
	* src/roff/nroff/nroff.sh:
	* src/roff/troff/input.cpp (usage): Stop putting an ellipsis
	inside a bracket expression (for file arguments); that suggests
	misleading complexity.

	* src/devices/grohtml/post-html.cpp (usage): Also don't set
	metasyntactic variable names in screaming capitals when they are
	separated from option letters by space and thus can't be
	confused with them.

2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libdriver]: Update diagnostic messages.

	* src/libs/libdriver/printer.cpp (printer::find_font): Describe
	the problem encountered instead of saying lamely "sorry, I can't
	continue".
	(printer::set_char_and_width, printer::set_numbered_char):
	Characterize input as "invalid", not "bad"; see commit bb7512b5,
	17 September.  When referring to font mounting position, say so.
	(printer::set_char_and_width): Describe required input character
	as "ordinary", not "ascii".  Apart from the incorrect casing,
	doing so better aligns with our terminology in groff_char(7),
	groff_out(5), our Texinfo manual, and other diagnostic messages;
	moreover, the use of "ascii" is potentially confusing to those
	whose environments use another encoding, like UTF-8 or IBM code
	page 1047.

	Fixes <https://savannah.gnu.org/bugs/?61829>.

2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Check basic Latin ("ASCII") glyph mappings.

	* src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
	Do it.
	* src/devices/grotty/grotty.am (grotty_TESTS): Run test.

2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[font,tmac]: Simplify Unicode character mapping process.

	* tmac/unicode.tmac: Drop.  It was originally added in 2005 to
	suppress horizontal spacing of glyphs in the range U+0483..9.
	Its purpose has wandered over the years; most recently to map
	the Basic Latin ("ASCII") hyphen-minus, apostrophe, and grave
	accent to special characters (and thus ultimately to the General
	Punctuation block).  But this is unnecessary since the font
	descriptions for devices with the `unicode` property can provide
	this information, and anyone who wants to alter the mappings can
	change either font description files, output device macro files,
	or troffrc; or add `char` requests to their macro packages or
	documents (in decreasing magnitude of ambition).

	* tmac/html.tmac:
	* tmac/tty.tmac: Stop sourcing unicode.tmac.

	* tmac/tmac.am (TMACNORMALFILES): Stop shipping it.

	* font/devutf8/NOTES: Drop remarks about mapping of \[a~],
	\[a^], and Basic Latin circumflex accent and tilde.  Not only do
	I disagree with the reasoning (whether these glyphs are "too
	small" depends on the font used by the terminal emulator, over
	which we have no control), but this mapping happens in a
	completely different part of the source tree,
	src/libs/libgroff/glyphuni.cpp.

	* font/devhtml/R.proto:
	* font/devutf8/R.proto: Add mappings for the five Basic Latin
	characters that map surprisingly (see groff_char(7)) and are not
	syntactically significant to troff.  Three of these are ported
	from unicode.tmac.
	(html): Don't migrate the hyphen-minus--yet.

2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tty-char.tmac: Drop redundant logic.  We don't need to
	source the `cp1047` or `latin1` files here; `troffrc` will
	already have loaded `tty` for us, which loads whichever applies.

2022-01-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Separate concerns better; stop re-generating plain
	text and HTML documents when the 'doc' target is updated; these
	are already handled by the 'build_infodoc' target.
	(build_infodoc): Use existing phony targets for plain text and
	HTML output files instead of repeating filename literals.
	(doc_all): Remove those same two phony targets from this one's
	dependencies.

2022-01-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp: Rename `eoi_macro_name` to
	`end_of_input_macro_name`.  It's long, yes, but better parallels
	`blank_line_macro_name` and `leading_spaces_macro_name`.  It is
	not used in lengthy expressions and furthermore clarifies the
	meaning of the nearby function name `eoi_macro` in one use.

2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.1.man (Limitations): Add
	subsection.

	Fixes <https://savannah.gnu.org/bugs/?55035>.

2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Be more careful with control characters when they are
	word-initial in filled text lines.  The idea is to prevent
	baffling surprises if a sentence is recast in a text editor, and
	a word beginning with a dot or neutral apostrophe is reflowed
	onto the beginning of the next input line--suddenly it is parsed
	as a control character.  Based on a patch by Bjarni Ingi
	Gislason.

	* contrib/hdtbl/groff_hdtbl.7.man:
	* doc/automake.mom:
	* doc/meintro.me.in:
	* doc/meintro_fr.me.in:
	* doc/pic.ms:
	* doc/webpage.ms:
	* src/devices/gropdf/gropdf.1.man: Do it.

	Fixes <https://savannah.gnu.org/bugs/?51312>.

2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Font Description File Format):
	* man/groff_font.5.man (Font description file format): Document
	restriction of kerning adjustment to glyph pairs from within a
	single font (since that is the scope of the font description).

	Fixes <https://savannah.gnu.org/bugs/?44715>.

2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* contrib/groff_filenames/groff_filenames.5.man: Remove
	superfluous paragraphing macro.

	Fixes <https://savannah.gnu.org/bugs/?55084>.  Thanks to Bjarni
	Ingi Gislason for the report and a suggested patch.

2022-01-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Operators in Conditionals): Update explanation
	of output-comparison conditional operator.

	Fixes <https://savannah.gnu.org/bugs/?60836>.

2022-01-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Use pnmtops(1)'s -quiet option if possible, to quieten
	build.

	* m4/groff.m4 (GROFF_PNMTOOLS_CAN_BE_QUIET): Add new macro to
	test pnmtops for support for (undocumented) '-quiet' option.

	* configure.ac: Perform the check.

	* doc/doc.am: Alter check of shell variable `pnmtops_nosetpage`
	{processed by AC_SUBST} to correctly match even if pnmtops
	accepts the '-quiet' option.

2022-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Manage hyphenation mode more carefully in localization
	packages.

	* tmac/{cs,de,it,sv}.tmac: Localize the man(7) package's HY
	register.

	* tmac/{cs,de,fr,it,sv}.tmac: When localizing the ms(7) package,
	use mode "2" instead of "3": the 'hy' request complains of
	contradictory hyphenation modes if "3" is used (the semantics of
	the hyphenation mode are complex and non-orthogonal; see
	groff(7) or our Texinfo manual).

	* tmac/{cs,de,en,fr,it,sv}.tmac: If the one language-independent
	hyphenation bit (don't hyphenate just prior to a page location
	trap) is set, preserve it; this way a system's troffrc or a
	macro package can set it and it will not get turned off by the
	localization package, which for best results should be loaded
	after any full-service package (and any auxiliary package
	requiring localized strings, though none are yet distributed
	with groff).

2022-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Add unit test for localization macro files.  Right now
	this just covers the hyphenation mode.

	* tmac/tests/localization-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[indxbib]: Document --version in usage message.

	* src/utils/indxbib/indxbib.cpp (usage): Document --version
	option.  Use more informative metasyntactic variable names.
	Organize usage message consistently with our others, and stop
	wrapping the output lines: we know neither the width of the
	terminal nor the length of the `program_name` string we're
	interpolating.  See commit b4de44f0, 19 July 2021.

2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libbib]: Refactor index header checking.

	* src/libs/libbib/index.cpp: Move more header validity checks...
	(index_search_item::load): ...from here...

	(index_search_item::check_header): ...to here.  Test all size
	values in header for negative values (never valid) before
	proceeding.  (These data could be changed to unsigned integer
	types in the file format, but that would require bumping the
	file version.  That in turn would make indexes generated with
	groff 1.23 unusable on systems running older groffs and, perhaps
	worse, would make groff 1.23 reject index files produced by
	older groffs.  On the other hand, the regeneration of index
	files should be, for those who use them, a common activity, and
	as long as the original database files are kept intact, it seems
	likely that most people, given modern machines, won't even
	notice a slowdown in document generation when refer(1) and
	friends fail to open the indices and fall back to full-text
	searches of the originals.  So we could still consider revising
	the file format before the groff 1.23 release.)

	* src/libs/libbib/index.cpp (index_search_item::load):
	Explicitly perform widening conversion from signed `off_t` value
	{from a stat(2) buffer} to an unsigned integer; quietens
	compiler warning about comparison between integers differing in
	signedness.

2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac (AC_CHECK_HEADERS): Expect stdbool.h, since we
	now use it in src/include/lib.h.

2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libbib, libgroff, indxbib]: Slightly refactor.

	Also, it's silly to test even numbers > 2 for primality.  Stop.

	* src/include/lib.h: Include `stdbool.h` since this header file
	is used for both C and C++ code.

	* src/include/lib.h (is_prime):
	* src/libs/libgroff/prime.cpp (is_prime): Boolify.  Return
	Boolean instead of integer literals and demote return type to
	`bool`.  Include `assert.h` and add assertion to reject
	mathematically offensive input.

	* src/libs/libbib/index.cpp
	(index_search_item::read_common_words_file): Test only odd
	numbers for primality.
	* src/utils/indxbib/indxbib.cpp (main): Same.  Since the number
	comes from user input, make it (a potential hash table size) odd
	first.

2022-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Internationalize and localize.

	* tmac/an.tmac (TH): Indirect predefined manual section titles
	through new strings `an*section[1-9]` so that they can be
	localized.
	(initialization): Give these strings English defaults.
	(TH): Move `ss` request from here...

	* tmac/en.tmac: ...to here.  It's not the man(7) package's
	business what the inter-word and inter-sentence spacing values
	are.  Also, having the correct[disputed] inter-sentence spacing
	value for English in its localization file restores it for the
	benefit of multi-lingual documents (mainly roff applications
	other than man(7)).

	* tmac/{cs,de,fr,it,sv}.tmac: Supply translations for the manual
	section titles; these were done by a monoglot American employing
	Google Translate, so those scandalized or running into howlingly
	wrong locutions are warmly invited to submit corrections.

	* tmac/trans.tmac: Load localized strings.

	Fixes <https://savannah.gnu.org/bugs/?61734>.

2022-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Handle auxiliary macro package
	arguments correctly.
	(process_arguments): Don't append the argument to the '-m'
	option to the command line; requested macro packages have
	dedicated logic.
	(construct_command): When iterating through requested package
	list, assume each element is an auxiliary package unless it
	matches an element in the list of main packages.  If the
	assumption holds, append the package name to a new list,
	`auxiliary_package_argument` (prefixed with '-m').  Push this
	list onto the command line after any main package.

	Also rename `$selected_main_package` to `$main_package` for
	brevity, and drop unused global lists `m` and
	`supplemental_package`.

	Fixes <https://savannah.gnu.org/bugs/?61758>.

2022-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/tests/smoke-test.sh: Add test cases for user
	specification of auxiliary macro packages.

2022-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Drop unnecessary code.  Apart from being superfluous, it
	prevented a user-defined value of the `sx` register from being
	applied to the first footnote marker interpolated, a subtlety
	that escaped my notice because the first footnotes in our
	"meref" and "meintro" documents are not numeric, but symbolic,
	and their markers occurred on lines with vertical space above
	and below.  (The bug was further masked by an otherwise
	redundant redefinition of the `*` string inside the `)f` macro.)

	* tmac/e.tmac ()f, +c): Stop redefining footnote marker string
	`*` after updating the automatic footnote number; its
	interpolation is already backslash-protected.
	()d, pd): Stop redefining delayed text marker string `#` for an
	analogous reason.
	(initialization): Drop unneeded `_*` and `_#` strings.

	Thanks to Robert Goulding for his feedback and patience.  See
	<https://savannah.gnu.org/bugs/?61025>.

2022-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/e_footnote-marks-work.sh: Enhance test.  Confirm
	that the automatic footnote number is reset to 1 by starting a
	new chapter with the `+c` macro.

2022-01-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Revise `n1` and `n2` interface and behavior.

	There were several bugs in the previous implementation.

	* tmac/e.tmac (po): Issue diagnostic if an attempt is made to
	set the page offset to a negative value.

	(n1): Accept new optional "C" argument to behave more (but not
	exactly) like roff(1), as the formerly-recognized "c" argument
	to `n2` did.  If present, the line length is reduced by the same
	amount (in new interface register `no`) as the line number field
	to preserve the overall line length.  Save the previous line
	length in internal register `_l` and set a flag, stored in `?N`,
	indicating this reduction.  Otherwise, the macro expects to be
	able to reduce the page offset to accommodate the line number.
	If it cannot (for example, with the zero page offset default
	used by nroff output devices), see above re: the `po` macro.

	(n2): Cache the last line number that may have been output,
	instead of the current one, so that we can operate on it
	consistently with user expectations.  Do this earlier, and
	rename this macro-local variable from `_ln` to `_n` so that we
	don't need groff's `do` request to operate on it.  Drop
	recognition of "c" as an optional second argument.  If turning
	off line numbering: if the line length was shortened (`?N`)
	restore the saved value and delete `_l` register; otherwise,
	reverse the change to the page offset.  Delete `_n` register.

	(initialization): Assign `\w'0000'u` to `no` register; this was
	previously hard-coded in `n1` and `n2`.  Initialize `?N` with 0.

	* doc/meref.me.in (roff Support): Update to reflect interface
	changes and describe behavior more accurately.

	* doc/meref.me.in (Summary):
	* tmac/groff_me.7.in (Registers): Document new `no` register and
	mark it as a groff extension.

	* NEWS: Add item documenting interface changes.

	Fixes <https://savannah.gnu.org/bugs/?61646>.  See the comments
	in the report for a lengthy enumeration of rendering problems
	exhibited by the previous implementation.

2022-01-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Add unit test for line numbering feature.

	* tmac/tests/e_line-numbering-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grohtml/post-html.cpp (style::style): Add
	initializer to argumentless constructor to avoid later read from
	uninitialized memory in `html_printer::do_font`.

	Fixes <https://savannah.gnu.org/bugs/?61748>.

2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	[groff]: Add regression test for Savannah #61748.

	* src/roff/groff/tests/html_works_with_grn_and_eqn.sh: Do it.
	* src/roff/groff/groff.am (groff_TESTS): Run it.

2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grohtml/post-html.cpp
	(html_printer::do_file_components): Emit fatal diagnostic if
	we're unable to `freopen()` standard output.  Quietens
	`-Wunused-result` warning from GCC 8.3.

2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grohtml/html.h (INT_HEXDIGITS): Add new constant
	to store the maximum possible quantity of digits in the
	hexadecimal representation of an `int`.

	* src/devices/grohtml/html-text.cpp (html_text::issue_tag):
	* src/devices/grohtml/post-html.cpp (html_printer::do_body):
	Guard against format string overflow by large integers in RGB
	color channel specifications; in a *printf format string, the
	precision (like the field width) is a _minimum_.  Quietens
	`-Wformat-overflow` warnings from GCC 8.3.

2021-12-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (get_image_generator): Clarify
	complex conditional expression.  Quietens `-Wparentheses`
	warning from GCC 8.3.

2021-12-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Rename new `$x` register to `sx`.  Since we expect the
	user to set this register directly, it should not be named with
	a leading '$' per the "me Reference Manual".

	* tmac/e.tmac (initialization, {, }): Do it.

	* tmac/groff_me.7.man:
	* doc/meref.me.in:
	* NEWS: Update documentation.

	* doc/meintro.me.in:
	* doc/meintro_fr.me.in:
	* doc/meref.me.in: Sync with new register name.

	See <https://savannah.gnu.org/bugs/?61025>.  Thanks to Dave
	Kemper for the discussion in
	<https://savannah.gnu.org/bugs/?61710>.

2021-12-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Slightly refactor.

	* src/roff/troff/div.cpp:
	* src/roff/troff/div.h:
	* src/roff/troff/input.cpp: Rename variables to reduce confusion
	between "end macros" and "end-of-input macros".  Call the latter
	"eoi" macros for brevity.

2021-12-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Fix code style nits.
	  - Use new terminology in diagnostic.  See commit 66ac1a8db9,
	    11 December.
	  - Drop unused '&&&' annotation for macro definitions.  This
	    was a BSD me(7) implementation detail wherein parts of the
	    package were broken out into module files, loaded if/when
	    their macros were called.  groff me(7) is monolithic, except
	    for devtag and refer(1) support.
	  - Remove '&&' end macro when we're done using it.

2021-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: (Re-)localize strings.

	* tmac/{cs,de,fr,it,sv}.tmac: Update package localizations to
	use new resources.  As a happy side effect (and with the new
	appendix string), the `+c` macro is now localized for Czech,
	German, and Swedish.

	* doc/meintro_fr.me.in (Les Parties du Document): Update example
	to reflect mixed-case default string used in chapter headings.

	* tmac/tests/e_ld-works.sh: Add tests for localization.

2021-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Internationalize strings.

	* tmac/e.tmac (initialization): Introduce internal
	`_mo1`..`_mo12`, `_dw1`..`_dw7`, and `_td_format` strings (with
	English defaults).  Define them outside of the new `ld` macro so
	that they can be overridden by localization packages.
	(ld) <dw, mo, td>: Populate via the above new strings.
	* tmac/trans.tmac: Stop defining `mo` and `dw`.  Instead, make
	them aliases of the new strings above.   Handle `wa` and `wc`
	similarly.

2021-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Add `ld` macro to re-init date/l10n stuff.

	* tmac/e.tmac (ld): New macro updates `y2` and `y4` registers
	and `wa`, `wc`, `mo`, `dw`, and `td` strings.

	* doc/meref.me.in (Miscellaneous, Predefined Strings):
	* tmac/groff_me.7.man (Macros): Document it.

	* tmac/tests/e_ld-works.sh: Add unit test.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?61670>.

2021-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/e_chapter-titles-work.sh: Add unit test for chapter
	heading feature.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Ease localization and customization by exposing
	strings for "Chapter" and "Appendix" instead of hard-coding
	these words into the `$c` macro.
	(initialization): Define new `wa` and `wc` strings.  Separate
	these and existing localization strings from `y2` and `y4`
	initialization since the latter don't involve natural languages.
	($c): Interpolate these strings in chapter and appendix headings
	and in calls to `$C` hook macro.  Set "Chapter" and "Appendix"
	in mixed case instead of full capitals, and set one
	adjustable nonbreaking word space `\~` between them and the
	chapter number instead of two unadjustable nonbreaking spaces.
	{These changes do slightly alter the default output of the
	package when the `+c` macro is used.}

	* doc/meref.me.in (Predefined Strings):
	* tmac/groff_me.7.man (Strings): Document new strings.

	* doc/meintro.me.in (Parts of the Basic Paper): Update example
	to reflect mixed-case default string.

	Fixes <https://savannah.gnu.org/bugs/?61661>.

2021-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (@p): Deactivate right alignment (the effect of
	groff's `rj` request) when starting a new paragraph.
	* doc/meref.me.in (Paragraphing) <lp>: Document this.

2021-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac ()c): Add bounds check to avoid attempting to set
	a negative indentation, provoking a troff warning.  Problem
	exposed by formatting "meintro_fr.me" document with default
	nroff mode line length.

2021-12-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Slightly refactor (boolify).

	* src/roff/troff/div.cpp:
	* src/roff/troff/div.h:
	* src/roff/troff/env.cpp:
	* src/roff/troff/input.cpp: Rename variables and demote from
	  `int` to `bool`.  Initialize and assign them using Boolean
	  literals.  The new names try harder to express a logical
	  predicate, and start with verbs to resist interpretation as
	  noun phrases.
	  - exit_started -> is_exit_underway
	  - done_end_macro -> is_end_macro_finished
	  - seen_last_page_ejector (demoted but not renamed)
	  - began_page_in_end_macro (demoted but not renamed)

2021-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Explain presence of undocumented `$r` and `$R`
	registers.

	Fixes <https://savannah.gnu.org/bugs/?61683>.

2021-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (bc): To get to the next column, space by the page
	length `.p`, not by the distance to the next trap (or 24 inches,
	as hard-coded in me(7) traditionally).  It is up to any sprung
	traps to issue further space requests or otherwise ensure a
	transition to the next column.

	See <https://savannah.gnu.org/bugs/?55081> for discussion.

2021-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac ({): Fix missing scaling unit in arithmetic
	expression: broke footnotes in troff mode.  Problem introduced
	by me in commit 6eafd208, 16 December.  Thanks to Robert
	Goulding for the (informal) report.

2021-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/{pic,webpage}.html): Quieten build.  Stop
	passing `-p` (progress) option to postprocessor, which produces
	TeX-like bracketed page numbers when images occur.

2021-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (.ms.html): Drop unused suffix rule.

2021-12-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am (tmac_XFAIL_TESTS): Mark test
	"e_footnotes-work-with-columns.sh" as expected to fail (as it
	does now, consequent to a reverted commit).

2021-12-16  Dave Kemper <saint.snit@gmail.com>

	* man/groff_tmac.5.man: Fix minor errors.

	Fixes <https://savannah.gnu.org/bugs/?61633>.

2021-12-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	Parameterize line height adjustment when super/subscripting.

	* tmac/e.tmac (initialization): Assign 0.2m to register `$x`.2m.
	({, <}: Apply adjustment, multiplied by -1 for superscripts.

	* doc/meref.me.in:
	* tmac/groff_me.7.man: Document it.

	* NEWS: Add item.

	* doc/meintro.me.in:
	* doc/meintro_fr.me.in:
	* doc/meref.me.in: Forego extra line height for more attractive
	typesetting.

	Fixes <https://savannah.gnu.org/bugs/?61025>.  Thanks to Robert
	Goulding for the suggestion.

2021-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac ($c): Draw the footnote separator no wider than
	the column width.

	Fixes <https://savannah.gnu.org/bugs/?61675>.

2021-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (2c): Accept an empty first argument, permitting
	the number of columns to be specified but preserving the default
	column separation.

	Fixes <https://savannah.gnu.org/bugs/?61671>.

2021-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (initialization): Initialize `$C` hook, preventing
	`mac` warnings from troff(1) if chapter title feature is used.

2021-12-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (i, bi): Add italic corrections.

2021-12-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Fix groff warnings and correctness issue.
	(n2): Prefix `ie` request with `do` because it uses the groff
	`\B` escape sequence.  Use braces to group multiple requests
	after an `el` request: `ie` and `el` count as two requests, not
	one.  Add comment regarding the unfortunate choice of brace
	style given *roff's syntactical constraints.
	(n2, (c): Conceal bare tab in request argument list (exposed by
	no longer stripping the macro file).

2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Revise diagnostic messages to follow GNU Coding Standards,
	identifying what is emitting them.

	* tmac/e.tmac (_e): New string holds "e.tmac".
	(@err): New macro constructs and issues diagnostics.  Add file
	name to messages when available.  Suppress line number when
	unavailable.
	(check_page_length, @z, @h, n2, sk, @p, @(, @), (c, )c, EQ, (f,
	++, @U): Call `@err` instead of invoking `tm` request.  Revise
	wording of messages in an attempt at clarity.

	Continues the long process of fixing Savannah #52463.

2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Slightly refactor footnote numbering.
	()f): Tighten code style and end string definition with comment.
	(+c, initialization): Drop unused auto-incrementation of
	footnote number register `$f`.  Add new string `_*` to use when
	{re-}initializing `*` outside of a footnote diversion, and
	interpolate the footnote number register instead of a literal.

2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/e_footnote-marks-work.sh: Add unit test.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Fix automatic numbering of delayed text.
	(initialization): Add `_#` string for use in multiple
	assignments of `#` string.
	(initialization, pd): Remove unused auto-incrementation from
	`$d` delayed text number register.
	()d): Increment `$d` register unconditionally, no longer
	conditionally on whether the delayed text marker string `#` has
	been interpolated.
	()d, pd): Update `#` string using new `_#` string.  Stop
	initializing the string with `\k` mark-setting escape sequence.

	* doc/meref.me (Annotations) <)d>: Document now-unconditional
	incrementation of `$d` register.

	Fixes <https://savannah.gnu.org/bugs/?61632>.

2021-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/e_delayed-text-marks-work.sh: Add test.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Rename internal register out of user name space.
	(@f): Rename `VL` to `__`; remove it immediately after using it.

2021-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/meref.me: Fix documentation error; the `$s` macro draws a
	horizontal line of 2 inches' length, not 1.5 inches.

	Fixes <https://savannah.gnu.org/bugs/?58682>.  Thanks to Dave
	Kemper for the report.

2021-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	Generate me(7) manual sources as part of the build.  We had been
	shipping 'me' sources with the string '@VERSION@' in them and
	only sed-replacing that to produce generated PostScript, but
	this replacement was not occurring for users who processed the
	documents themselves.

	* doc/meintro.me:
	* doc/meintro_fr.me:
	* doc/meref.me: Rename these to...
	* doc/meintro.me.in:
	* doc/meintro_fr.me.in:
	* doc/meref.me.in: ...these.

	* doc/doc.am (DOCFILES): Add the new *.in files.  Move the *.me
	files from here...
	(GENERATEDDOCFILES): ...to this new variable.
	(dist_otherdoc_DATA, EXTRA_DIST): Add `$(GENERATEDDOCFILES)`.
	(doc/me{intro{,_fr},ref}.me): Add new target rules.

	* src/utils/grog/tests/smoke-test.sh: Update test to look for
	the above source tree documents under their new names.

2021-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (.me.txt, .ms.txt): Drop unused suffix rules.

2021-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (DOC_SED): Add substitution of command prefix
	{"@g@"} so we can make accurate reference to groff commands with
	Unix counterparts in our documentation.

2021-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac: Add nroff mode string definitions for 4.4BSD
	compatibility.
	  - Define '{' and '}' (superscripting) strings as '[' and ']'.
	  - Define '<' and '>' (subscripting) strings as '\(la and
	    '\(ra' if available on the device, otherwise '<' and '>'.

	* tmac/tests/e_footnote-marks-work.sh: Update expected output.

	* doc/meref.me: Document it.

	Fixes <https://savannah.gnu.org/bugs/?61619>.

2021-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (doc/meintro_fr.ps): Add target rule (overriding
	suffix rule) to generate this file using `-mfr` (load the French
	localization macro file).

2021-11-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Drop redundant `do_divert()` declaration.

	* src/roff/troff/env.h: Do it.

	Fixes <https://savannah.gnu.org/bugs/?61433>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-11-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Remove `DEBUGGING` preprocessor cruft.

	* src/roff/troff/input.cpp:
	* src/roff/troff/mtsm.cpp: Stop defining `DEBUGGING`
	preprocessor macro (as empty).

	* src/roff/troff/input.cpp: Give `DEBUG_OPTION` an empty string
	value if the former is undefined, so the `getopt_long()` call
	will compile.

	Fixes <https://savannah.gnu.org/bugs/?61436>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-11-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Slightly refactor table format column modifier `p` and
	`v` validation.

	* src/preproc/tbl/main.cpp (process_format): Make code terser by
	introducing references to `list->point_size` and
	`list->vertical_spacing`.  Doing this requires a new scope
	{because a switch case isn't one} so add it, without updating
	indentation for this commit.  When complaining of out-of-range
	type size or vertical spacing, report the limit.

2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Improve diagnostic messages.

	Revise diagnostic messages generally to use terminology
	consistent with the recent rewrite of tbl(1), identify a
	contextual token when possible, and communicate more helpfully.

	* src/preproc/tbl/main.cpp (process_options): Tell the user
	which region option is missing a closing parenthesis or cannot
	accept an empty argument.  Refer to region options as such, not
	simply "options" (so they can't be confused with command-line
	options).  Say that input is "invalid" instead of "bad".
	(process_format): Say "table format specification" instead of
	just "format".  Say "column classifier" instead of "format".
	When a column modifier is missing an argument or a closing
	parenthesis, identify it and refer to it as a "column modifier"
	instead of omitting context.  Inform user that arguments to `p`
	and `v` column modifiers must be "(optionally signed) integer"s,
	not "numbers", lower these diagnostics' levels from error to
	warning, and indicate that the modifier is ignored.  Clarify
	diagnostic when extra characters trail `.` at the end of a table
	format line.
	(process_data): Say "table entry" instead of "data entry" when
	discarding an excess one.
	(process_table): Say we're giving up on "this table region", not
	this "table", particularly since any table continuations (.T&)
	are ignored.

2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix call to `getopt_long()`.

	* src/preproc/tbl/main.cpp (main): Stop telling `getopt_long()`
	to look for a `T` option.  Continues b4bbf32e, 16 October 2020.

2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Tweak usage message.

	* src/preproc/tbl/main.cpp (usage): Document `--version`.  Give
	version retrieval mode separate synopsis.  Use more normative
	synopsis syntax.

2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Fix code style nits.

	* src/preproc/tbl/main.cpp (process_input_file)
	(entry_format::debug_print, process_data, main): Replace
	`assert(0)` calls with communicative predicates.
	(struct input_entry_format, input_entry_format::debug_print,
	process_format): Boolify.  Demote and rename `int`s
	`last_column` and `equal` to `bool`s named `is_last_column` and
	`is_equal_width`.  Assign them Boolean literals.
	(process_format): Boolify.  Demote `have_expand`, `got_format`,
	and `got_period` from `int` to `bool`.  Use Boolean literals in
	assignments thereto.
	(process_options): Swap order of null pointer comparison when a
	typo or thinko could lead to lvalue assignment.
	(process_data): Boolify.  Demote `give_up` from `int` to `bool`.
	Demote and rename `int` `row_comment` to `bool`
	`seen_row_comment`.  Use Boolean literals in assignments
	thereto.
	(main): Use standard C library symbols `EXIT_SUCCESS` and
	`EXIT_FAILURE` with `exit()` calls instead of `0` and `1`.

2021-11-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Fix Savannah #61520.

	* src/utils/grog/grog.pl: Move hash `preprocessor_for_macro` to
	global scope since it is now mutable across `do_line` subroutine
	calls.
	(do_line): Adjust regex matching an end macro to work better.
	Check names of macros being defined by the document; if they
	start with '[' or ']', stop attempting to detect refer(1) usage,
	by deleting its key from the `preprocessor_for_macro` hash.

	Fixes <https://savannah.gnu.org/bugs/?61520>.

2021-11-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Add regression test for Savannah #61520.

	* src/utils/grog/tests/avoid-refer-fakeout.sh: Do it.
	* src/utils/grog/grog.am (grog_TESTS): Run test.

2021-11-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Page Motions):
	* man/groff.7.man (Escape short reference): Fix error: the `\r`,
	`\u`, and `\d` escape sequences move in ems, not vees, despite
	being vertical motions.  Add discussion and example.  Thanks to
	Bjarni Ingi Gislason for pointing out the problem in groff(7)
	and Tadziu Hoffman for his lucid explanation.

	Fixes <https://savannah.gnu.org/bugs/?61437>.  Thanks to Bjarni
	Ingi Gislason for the report and a suggested patch.

2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/include/error.h: Drop `extern` storage class from
	diagnostic function prototypes.  Drop parameter names from
	prototypes, in keeping with the Stroustrup-style C++ used in
	most of groff.

2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/font.cpp (font::load): Update diagnostic
	messages to say "kerning pair" instead of "kern pair".

2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_size): Update diagnostic
	messages to use more normative language: say "type size" instead
	of "point-size", and "escape sequence" instead of "escape".
	* src/roff/groff/tests/\
	use_point_size_escape_with_single_digit_arg.sh: Update expected
	diagnostic wording in text.

2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_size): Boolify.  Update
	prototype.  Demote return type from `int` to `bool`.  Use
	Boolean literals for return values.  Similarly demote local
	variable, rename it from `bad_digit` to
	`contains_invalid_digit`, and use Boolean literals with it.

2021-11-16  Deri James  <deri@chuzzlewit.myzen.co.uk>

	* src/devices/gropdf/gropdf.pl: Fixes to importing pdf versions
	> 1.4.

2021-11-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: If "nowarn", suppress table row warning.

	* src/preproc/tbl/table.cpp (table::init_output): Bracket the
	generated groff code that emits a warning if a table row
	overruns a page location trap (usually, is too long to
	vertically fit on the page) in a test for whether the "nowarn"
	region option was given, so that this warning is suppressed as
	well when that option is used.
	* src/preproc/tbl/tbl.1.man (Region options): Document new
	"nowarn" behavior.

	{"nokeep" also suppresses this warning, for a different reason;
	no diversion is created to hold the table row, so its vertical
	size does not exist to be compared to the distance to the next
	page trap.}

	Fixes <https://savannah.gnu.org/bugs/?61477>.

2021-11-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::do_vspan): Fix code style
	nits.  Swap order of null pointer and zero equality comparisons
	when a typo or thinko could lead to lvalue assignment.  Break a
	series of 6 and-ed assertion predicates into separate `assert()`
	calls--sure to be less maddening for anyone who has to debug
	such a contingency.  Clarify comment since C++98 didn't yet have
	`nullptr`.

2021-11-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[m4]: Clean up shell variable quoting and bracing.

	* m4/groff.m4 (GROFF_PROG_YACC, GROFF_MAKEINFO)
	(GROFF_BROKEN_SPOOLER_FLAGS, GROFF_TARGET_PATH_SEPARATOR): Stop
	bracing shell variable expansions that don't require it; the
	shell is not make(1).
	(GROFF_PROG_YACC, GROFF_MAKEINFO): Double-quote shell variable
	expansions that might produce whitespace.
	(GROFF_MAKEINFO): Drop unnecessary leading zeroes from version
	number component construction.  Drop unnecessary escaping of
	plus sign in expr(1) input.

2021-11-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[m4]: Clean up test(1) usage.

	Get rid of string (non-)nullity tests and comparisons involving
	concatenation with garbage (usually "x").  Even the GNU Autoconf
	manual's shell portability material doesn't recommend this.  It
	must be either a bodge cooked up by shell programmers who
	couldn't remember to quote variable expansions, or a workaround
	for shells of such poor quality that they defied the odds and
	decayed out of usage or got fixed.

	Instead, use double quotes (only where necessary).  Test for
	non-empty strings with "test -n" and empty strings with "test
	-z".  Stop quoting literal comparands that obviously have no
	shell metacharacters in them.

	* m4/groff.m4 (GROFF_PRINT, GROFF_PROG_YACC, GROFF_PERL)
	(GROFF_DOC_CHECK, GROFF_MAKEINFO, GROFF_TEXI2DVI)
	(GROFF_HTML_PROGRAMS, GROFF_PDFDOC_PROGRAMS, GROFF_PAGE)
	(GROFF_TMAC, GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_X11)
	(GROFF_APPRESDIR_DEFAULT, GROFF_APPRESDIR_CHECK)
	(GROFF_HAVE_TEST_EF_OPTION, GROFF_BASH, GROFF_UCHARDET)
	(GROFF_UCHARDET_CHECK, GROFF_PDFTOOLS)
	(GROFF_USE_GROFF_ALLOCATOR): Do it.

2021-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_TEXI2DVI): Add dependency on
	`GROFF_MAKEINFO` macro.  Rewrite to also test `MAKEINFO`
	variable, which is empty if the `makeinfo` command is not
	installed or too old.  Consequently ignore `texi2dvi` if is too
	old without having to do a version check (since it and
	`makeinfo` are distributed together, both being part of GNU
	Texinfo).

	* doc/doc.am (.texi.dvi, .texi.pdf): Update error message to
	indicate that `texi2dvi` is _either_ missing or too old.

2021-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_MAKEINFO): Stop throwing a warning if the
	installed `makeinfo` is old but the distributed Info manual is
	up to date.  This is not a configure-time problem; the user will
	be notified when they run 'make' if they modify doc/groff.texi,
	or if they run 'make doc' (which has required a TeX installation
	for years).  Empty the `MAKEINFO` variable immediately if a
	too-old version is detected.  Drop needless `AC_SUBST`itution of
	the detected `makeinfo` version.

2021-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_HTML_PROGRAMS): Clarify message; it is only
	groff-generated HTML that is disabled by the absence of the
	programs checked for.  (`makeinfo` can still generate our
	Texinfo manual in HTML format.)

2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[build]: Drop `BUILD_INFODOC` symbol.  Ship manual in GNU Info,
	text, and HTML forms in distribution archive.

	* Makefile.am (MAINTAINERCLEANFILES): Initialize.
	(MOSTLYCLEANADD): Drop unused variable.
	* configure.ac: Drop `AM_CONDITIONAL([BUILD_INFODOC]...`.
	* doc/doc.am (EXTRA_DIST): Rearrange shipment of our Texinfo
	manual source files to precede all of the generated forms, for
	clarity.  Drop all `BUILD_INFODOC` conditionals.  Make
	`build_infodoc` phony target depend on plain text, GNU Info, and
	HTML forms of Texinfo manual unconditionally.  Also drop unused
	variables `groffinfodir`, `groffpdfdir`, and `texi2dvi_missing`.
	(EXTRA_DIST, MAINTAINERCLEANFILES): Add Info form of manual.
	Drop glob pattern attempting to match the segments that
	`makeinfo` breaks it into.  It isn't necessary for
	MAINTAINERCLEANFILES.
	(EXTRA_DIST, MAINTAINERCLEANFILES): Add text form of manual.
	(EXTRA_DIST, MAINTAINERCLEANFILES): Add HTML form of manual.
	(dist-hook): Depend on new (phony) target `dist-info-bits`.
	(dist-info-bits): Look for the info document in the build
	directory, then the source directory.  (It could be in either
	place depending on whether the build from a Git working tree is
	being done in or out of a separate build directory.)  When
	found, copy the segments to the assembly area for the
	distribution archive.
	(install_infodoc): Refactor.  Remove any groff info files from
	the destination info directory using a shell glob directly
	instead of a partly redundant ls(1) command substitution.
	Similarly, use a shell glob to cp(1) the info files (including
	any matched segments) to the destination info directory before
	running `install-info`.  (In this process I learned that
	`install-info` doesn't "install" anything; instead, it
	{de-}registers info files with their top-level catalog.)

2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (.texi.txt, .texi.html): Reorder pattern rules to
	make it clearer which formats require only `makeinfo` and which
	require `texi2dvi`.  The latter imposes more build dependencies,
	including a full TeX installation.

2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[mom]: Build more quietly.

	* contrib/mom/mom.am (penguin.{ps,.pdf}): Make targets quiet by
	default; they are simple file copies.

2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Revise a test's setup.

	* src/roff/groff/tests/fp_should_not_traverse_directories.sh:
	Revise search for device/font description directory to work in
	within-source-tree builds and (for now) with the approach used
	by Automake's "distcheck" target.

2021-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Accept `\&` as an empty table entry.

	* src/preproc/tbl/table.cpp (table::add_entry): Suppress
	diagnostic about non-empty table entries classified as `_` or
	`=` if the entry consists of exactly `\&`.

	* src/preproc/tbl/tbl.1.man (Table data): Document this idiom.

2021-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Update diagnostic messages.

	* src/preproc/tbl/main.cpp (process_options, process_format):
	* src/preproc/tbl/table.cpp (table::add_entry): Align diagnostic
	text with terminology now used in tbl(1) man page.
	  - "global option" -> "region option"
	  - "specifier" -> "column modifier"
	  - "format" -> "column classifier"

2021-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Fix missing colon in diagnostic messages.

	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
	Restore missing colon to diagnostic text.  Problem introduced by
	me in commit 9a038161, 8 November.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff,grops]: Slightly refactor.

	* src/devices/grops/ps.cpp: Explicitly preprocessor-include
	"lib.h" since we use the `PI` symbol it defines.

	* src/include/lib.h: Add inclusion guard.  Wrap only `extern "C"
	and its braces in preprocessor conditionals, so that prototypes
	are present in the header even for C language code that
	#includes this header.  Add `static` storage class to `PI`
	symbol to avoid redefinition errors from the linker.

	* src/libs/libgroff/iftoa.c (if_to_a):
	* src/libs/libgroff/itoa.c (i_to_a, ui_to_a): Add `const` type
	qualifier to function definitions for agreement with prototypes
	in "lib.h".  Drop local copies of prototypes.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Centralize definitions of {U,}INT_DIGITS.

	* src/libs/libgroff/iftoa.c:
	* src/libs/libgroff/itoa.c: Move definitions of `INT_DIGITS` and
	`UINT_DIGITS` from here...
	* src/include/lib.h: ...to here.

	* src/libs/libgroff/iftoa.c:
	* src/libs/libgroff/itoa.c: Preprocessor-include "lib.h".  This
	revealed missing guards around `extern "C"` declarations, so...

	* src/include/lib.h: Add them where necessary.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (OP): Fix code style nits.  Don't quote macro
	arguments unnecessarily.  Use consistent backslashing.  Use
	groff font escape sequence syntax.  Use adjustable non-breaking
	space escape sequence instead of a non-adjustable one.
	Parenthesize numeric expression for better readability.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Make allocator replacement optional.  Switch it
	off by default, relying on C++ runtime new/delete support.

	* configure.ac: Call new `GROFF_USE_GROFF_ALLOCATOR` m4 macro.
	Use `AM_CONDITIONAL` to set Automake variable
	`USE_GROFF_ALLOCATOR` if appropriate.  Report whether the
	allocator is used in configure script output summary.
	* m4/groff.m4 (GROFF_USE_GROFF_ALLOCATOR): Define new macro to
	collect user preference.  The default is off.
	* src/libs/libgroff/libgroff.am (libgroff_a_SOURCES): Build and
	link new.cpp only if we are to `USE_GROFF_ALLOCATOR`.

	* NEWS: Add item.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_TMAC): Report a human-readable message if
	no system tmac prefix is found, instead of leaving the ellipsis
	hanging.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_TMAC): Use separate shell variable for
	`AC_MSG_RESULT()` content since the human-readable string we
	populate it with in the empty case is not appropriate for later
	`AC_SUBST()`-itution.  Problem introduced by me in commit
	19670348, 31 October.

2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am (MOSTLYCLEANFILES): Remove `$(TMACMDOCFILES)`.
	This variable, formerly named `TMACMDOCSTRIPFILES`, should not
	be used in a clean target because its contents are (no longer)
	generated files.  Problem introduced by me in commit 24602f42, 4
	July (only noticeable in within-source-tree builds).

2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff,pic]: Check `strdup()` return value.

	* src/libs/libgroff/font.cpp (struct text_file): Add `fatal()`
	member function.
	(text_file::fatal): Implement it.

	* src/libs/libgroff/font.cpp (font::load_desc):
	* src/preproc/pic/troff.cpp (troff_output::set_location): Die if
	`strdup()` returned a null pointer.

2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
	Revise to eliminate `fprintf()` calls, which might perform
	dynamic memory allocation, rendering this function unsafe to
	call after memory allocation failures.  Since this function is
	near the top of our diagnostic output call stack, that would be
	unfortunate.  `errprint()` does not use dynamic allocation, nor
	do the `i_to_a()` and `ui_to_a()` functions it calls to format
	integers.

2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* configure.ac: Add `strdup` to AC_CHECK_FUNCS since we are
	using it and the whole point of libgroff's `strsave()` was to
	get along without it.  But `strdup` has been standardized in
	POSIX for 20 years (SUSv3, POSIX:2001) and is on its way into
	ISO standard C (N2353) and C++ (P2391R0) as well.

2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/strsave.cpp (strsave): Call `strcpy()` only
	if `malloc()` did not return a null pointer.  Problem noted by
	Ingo Schwarze.

2021-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/fontfile.cpp (font::open_file): Don't open
	user-specified font file names with slashes in them; i.e., don't
	traverse directories outside the configured font path.  Also
	refuse to open the file if the `sprintf()` used to construct its
	file name doesn't write the expected quantity of bytes to the
	destination buffer.

	Fixes <https://savannah.gnu.org/bugs/?61424>.  Thanks to Ingo
	Schwarze for feedback.

2021-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Regression-test Savannah #61424.

	* src/roff/groff/tests/fp_should_not_traverse_directories.sh: Do
	it.
	* src/roff/groff/tests/artifacts/HONEYPOT: Add test artifact.
	* src/roff/groff/tests/artifacts/devascii/README: ...and this;
	we need a directory to make the test work but empty ones tend to
	look unintentional.
	* src/roff/groff/groff.am (groff_TESTS): Run test.
	(EXTRA_DIST): Ship artifacts.

2021-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Fix diagnostic error wording.

	* src/libs/libgroff/font.cpp (font::load): Fix diagnostic
	message; this is issued when an unrecognized directive is
	encountered, so it necessarily occurs _before_ any `charset` or
	`kernpairs` directive.  Give the user a hint accordingly.

2021-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix paragraph tag regressions.

	* tmac/an-ext.mac (UR, MR): Only create an environment and
	diversion if we're not already in one of the latter.  If we are
	{in groff man, this occurs only when collecting a `TP` paragraph
	tag}, then typeset the URI as part of the indented paragraph.
	(UE, ME): Pop the diversion and environment stacks only if we
	pushed them in the first place.  Eliminate spurious space in
	post-URI arguments by only typesetting excess macro parameters
	if there were any.

2021-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Regression-test Savannah #61425.

	* tmac/tests/an-ext_link-macros-work-in-paragraph-tags.sh: Do
	it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (DS): Drop a redundant unconditional break; every
	display macro we call in the event of a valid call already
	breaks the line, and it's polite to not break if we're given an
	invalid argument.  Emit a diagnostic error if the argument we're
	given is invalid, and immediately end the diversion we just
	opened.

2021-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (environment::set_font): Clarify
	diagnostic warning.

2021-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::add_entry): If we see a '\^'
	entry on the first row of a table, it's invalid, but we need to
	create an empty entry in its place.  Otherwise, someone can put
	another '\^' right below the one on the first row, creating a
	reference to a nonexistent table entry and provoking a SEGV.
	Issue an error diagnostic (distinct from the one in
	`do_vspan()`), create the entry, and skip `do_vspan()` (given a
	'^' in a first-row definition, it issues an error diagnostic and
	returns early, which suffices).  Problem appears to date back to
	groff 1.02 (June 1991) at the latest.

	Fixes <https://savannah.gnu.org/bugs/?61417>.

2021-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Regression-test Savannah #61417.

	* src/preproc/tbl/tests/\
	do-not-segv-on-invalid-vertical-span-entry.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix Savannah #61408.

	* tmac/an.tmac (an-prepare-inner-footer): Don't try to get a
	substring of an empty string; the man page author might not have
	specified a third argument to `TH` (or supplied an empty one).

	Fixes <https://savannah.gnu.org/bugs/?61408>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add regression test for Savannah #61408.

	* tmac/tests/an_inner-footer-abbreviation-works.sh: Do it.

2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Tweak computation in URI breaking.

	* tmac/an-ext.tmac (UE, ME): Stop adding the page offset `.o`
	when performing the available horizontal space computation for
	the typeset URI string.  This made no difference on nroff
	devices (grotty; even with `.po 15n`), but it caused the
	breaking decision to be too conservative on troff devices
	{grops}, forcing some URIs that would fit on the current line to
	the next one.

	* tmac/tests/an-ext_UE-breaks-before-long-URIs.sh: Add test of
	URI with no link text, which also has break points after every
	character, so that we detect even slight alterations.

2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Do more device and font description file validation,
	resolve an assertion failure arising from a negative declared
	device resolution, and correct a documentation error.

	* src/libs/libgroff/font.cpp (font::load): Include more
	information about invalid input in diagnostic messages.
	  - When a kern pair's amount is missing or invalid, report the
	    name of the kern pair.
	  - When someone tries to declare the first entry in the charset
	    section as an alias, report the glyph name.
	  - Identify the token for the unnamed character if an attempt
	    is made to alias it.
	  - When an out-of-range character type is applied to a glyph,
	    name the glyph.
	(font::load_desc): Same.
	  - Drop redundant zero initialization of `res`.
	  - Check all directives that take basic units for positive
	    values, adding `res`, `unitwidth`, `paperwidth`, and
	    `paperlength`.  Update this diagnostic to demand positive,
	    not nonnegative, values.
	  - When the font count is long in a `fonts` directive, report
	    how many font names were declared (and thus expected).  (If
	    the count is short, the next line is read for a font name,
	    like 'tcommand' in our devutf8/DESC.)
	  - When interpreting a `papersize` directive, throw an error
	    and return false if `res` has not yet been encountered,
	    since it is used in subsequent computations.
	  - When a paper format cannot be determined, report the
	    original declared value from the DESC file.  Use `strdup()`
	    to save it since it gets clobbered by the resolving process.
	    `free()` the saved string when we're done, regardless of
	    error condition.

	* doc/groff.texi (Device and Font Files):
	* man/groff_font.5.man (DESC file format): Document additional
	exception to order-indifference of directives: (at least one)
	`res` must precede `papersize`.

	Fixes <https://savannah.gnu.org/bugs/?61414>.

2021-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grohtml/post-html.cpp
	(html_printer::do_file_components): Add assertion.

2021-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/ps.cpp (usage): Document -p and --version
	options.

2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-nroff (doc-setup-page-layout): Set the title
	length to the device line length (register `.l`) if register
	`LT` is not defined.  This keeps the title length from being set
	to 78n when the line length is not, preventing the output from
	looking silly.

2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (main): Emit groff code to define
	macro `T&` as empty if it is not already defined.  (All of our
	full-service macro packages [except mdoc(7)] already do this, so
	there's no change in semantics; mom(7) even defines it as an
	empty _string_.)

2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/string_case_xform_requests.sh: Migrate
	test to POSIX shell, dropping use of process substitution (a
	Bashism).  Also rewrite to stop using a here document within a
	command substitution, mainly for paranoia.

	* src/roff/groff/tests/string_case_xform_requests.sh:
	* src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh: Update
	shebang lines to use /bin/sh as the interpreter.

2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/ps.cpp (encode_subfont): Update assertion to
	check for `sub` parameter being a null pointer rather than
	`sub->glyphs`; the latter is a member array of a `subencoding`
	struct so it can't be a null pointer.  (`glyphs` is an array of
	pointers to `const char`; the _elements_ of the array can [and
	are initialized to] be null pointers, but the address of the
	array itself will never be in a C/C++ implementation.)  Detected
	by Clang 13's "-Wtautological-pointer-compare".

2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/new.cpp (delete): Declare `throw()` (no
	exceptions thrown); quiets "-Wimplicit-exception-spec-mismatch"
	from Clang 13.

2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4: Fix messaging nits.
	(GROFF_MAKEINFO): Set `missing` to "missing 'makeinfo'" for
	consistency with other assignments to `missing`.
	(GROFF_TMAC): Utter an intelligible result in the configure
	check when no system macro files requiring groff wrapping are
	located.

2021-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Handle special character escape sequences that map to
	basic Latin glyphs in device control escape sequences
	consistently among output devices.

	* src/roff/troff/input.cpp (encode_char): Rearrange
	conditionals.  This is the logic that puts the "whatever" within
	a \X'whatever' escape sequence into GNU troff's intermediate
	output.  Handle adjustable and nonadjustable space escape
	sequences ("\~" and \ ") first.  Then, if the token is a special
	character escape sequence, retrieve its "contents" (glyph name).
	Move the basic Latin mapping for the seven glyph names '-',
	'aq', 'dq', 'ga', 'ha', 'rs', and 'ti' here, before checking
	whether the device description issued the
	'use_charnames_in_special' directive.  This way, the 'html' and
	'xhtml' output devices can straightforwardly embed these basic
	Latin characters in device control escapes (notably, "html:",
	for which the present convention is to follow the this tag
	immediately with a literal HTML URI, complete with `<a href>`
	element syntax).  If the special character is none of these and
	we should 'use_charnames_in_special', proceed as groff 1.22.4
	and earlier did.  This is a behavior change, as was my addition
	of this translation mechanism in the first place, so...

	* doc/groff.texi (Postprocessor Access): Document it.

	* src/roff/groff/tests/\
	device_control_escapes_express_basic_latin.sh: Test it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?61401>.

2021-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Map \[ti] correctly in device control escape sequences.

	* src/roff/troff/input.cpp (encode_char): Fix copy-and-paste
	error.  \[ti] should put '~', not '^', into a device control
	command.

	Fixes <https://savannah.gnu.org/bugs/?61403>; problem introduced
	by me in commit 9d61b3d1, 1 October.

2021-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Handle degenerate input quietly.

	* tmac/an.tmac (TH): Define new register `an-TH-was-called`.
	(an-end): Return immediately if that register is not defined;
	to format the default page footer we must have the information
	declared in a valid `TH` call.  (`TH` also initializes the type
	size and baseline spacing registers we use to prepare the page
	footer environment.)  If the register _is_ defined, remove it
	just prior to the end of this macro definition, in preparation
	for next page to be rendered.

	* tmac/tests/an_handle-degenerate-input-quietly.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/61402>, a regression from
	groff 1.22.4 (problem introduced by me in the course of many
	changes to trap management and header/footer handling to work
	nicely in batch rendering with -mandoc and mdoc(7) documents).

2021-10-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Warn if `TE` table macro called but `TW` register (set by
	tbl(1)) undefined.  Arrange it so that we warn only once per
	man(7) document, not per table region.

	* tmac/an.tmac (TH): Remove `TW` register when processing new
	document and clear `an-was-tbl-failure-reported` register.
	(TE): Check `TW` and `an-was-tbl-failure-reported` registers; if
	the former is undefined and the latter false, emit the message
	and set `an-was-tbl-failure-reported`.

	Addresses part of <https://savannah.gnu.org/bugs/?61379>.
	Thanks to Bjarni Ingi Gislason for the suggestion.

2021-10-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Improve portability.

	* src/devices/grotty/tests/osc8_works.sh: Fix typo in test.
	Multiple regex quantifiers after an atom were not flagged with a
	diagnostic by GNU grep 3.3, but were by BSD grep 2.5.1-FreeBSD.

	* src/roff/groff/tests/smoke-test_html_device.sh: Stop trying to
	set $LC_CTYPE to "C.UTF-8"; some systems don't support this
	expediency.  Skip the test if the tester hasn't configured the
	environment adequately.

	* tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Fix
	portability problems exposed by FreeBSD sed (which version is
	unclear).  {1} Use POSIX BREs, dropping use of '+' quantifier.
	{2} Add semicolons to terminate commands before braces on the
	same line.  Simplify surrounding test structure.
	* tmac/tests/e_footnotes-work-with-columns.sh: Fix same two sed
	problems.
	* tmac/tests/andoc_flush-between-packages.sh:
	* tmac/tests/doc_accept-mixed-case-section-headings.sh:
	* tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Fix same
	sed semicolon problem.

	* src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh: Rewrite
	test to stop using a here document (containing an unpaired
	single quote) inside a command substitution, which is broken in
	GNU Bash 3.2 and some other versions.  Instead construct the
	input with printf(1).  Also gets rid of a Bashism (process
	substitution) that Ingo pointed out years ago.
	* src/utils/grog/tests/recognize-perl-pod.sh: Same problem,
	different solution.  The Perl POD output is far too large to
	construct programmatically, so move it into an external file...
	* src/utils/grog/tests/foo.man: ...here.
	* src/utils/grog/grog.am (EXTRA_DIST): Ship new test artifact.

2021-10-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Make sed-based insertion of `lf` requests more
	portable: a dance is required to embed a literal newline inside
	a sed expression inside a shell command executed as part of a
	Make target rule.  We assume that neither the POSIX shell $''
	operator nor a working printf(1) is available.
	(DOC_GROFF): Define a shell variable containing a literal
	newline, evading make(1) and echo(1)'s valiant attempts to
	consume it.
	(doc/pic.html, doc/webpage.html): Repeat trick, slightly
	modified since the dependency needs to be manually identified.

	Solution adapted from the GNU Autoconf manual, "Newlines in Make
	Rules".

	Fixes <https://savannah.gnu.org/bugs/?61265>.  Thanks to John
	Gardner for the report.

2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TH): Stop populating `an-extra3` (the default
	center header) if the section argument is "3p".  "3p" does not
	always mean a Perl-related man page; Debian- and Arch
	Linux-based systems[1][2] (at least) have long used a "3perl"
	suffix, while OpenBSD appears to still use "3p" for Perl[3],
	which is also used by the POSIX man page distribution[4].
	Fortunately, Perl and POSIX are reliable at providing a fifth
	argument to `TH` anyway, so our fallback is as unnecessary as it
	is non-impartial.
	* tmac/groff_man.7.man.in (Document structure macros) <TH>:
	De-document the above behavior.

	[1] https://manpages.debian.org/bullseye/perl-doc/\
	Pod::Man.3perl.en.html
	[2] https://man.archlinux.org/man/Pod::Man.3perl
	[3] https://man.openbsd.org/man3p/Pod::Man.3p
	[4] https://man7.org/linux/man-pages/man3/system.3p.html

2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Abbreviate the inside footer if necessary.

	* tmac/an.tmac (an-prepare-inner-footer): Prevent the inside
	footer from overrunning the center footer.
	(BT): Use new string `an-ifoot` instead of `an-extra2` in page
	footers.

	Fixes <https://savannah.gnu.org/bugs/?61386>.

2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #61386.

	* tmac/tests/an_inner-footer-abbreviation-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_char.7.man (Description, Special character escape
	forms): Document the `\C` escape sequence.  Fix error: \[a] is
	_not_ "translated to \a, the uninterpreted leader escape
	sequence," but requests a glyph _named_ '\a' internally--it
	appears thus in diagnostic messages and, importantly, in the
	font description files defining special character glyph names.

2021-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac: Refactor to reduce repetition.
	(an-break-paragraph): New macro handles paragraph-breaking tasks
	previously duplicated.
	(SH, SS, P, TP, IP, HP): Call it rather than issuing its
	constituent requests.

2021-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (TP): Reset type size, vertical spacing, and font
	to defaults before setting the new paragraph.

	Fixes <https://savannah.gnu.org/bugs/?61380>.

2021-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Auto-increment): Fix error; the `\R` escape
	sequence does _not_ support an auto-incrementation amount.
	* man/groff_out.5.man (Command reference/Simple commands): Fix
	erroneous claim: 'N' is not a GNU roff extension; it appears on
	page 27 of CSTR#54 (1992).

2021-10-24  Keith Marshall  <keith.d.marshall@ntlworld.com>

	[ms]: Provide global default XH and XN implementations.

	cf. <https://savannah.gnu.org/bugs/?58946#comment13>

	* tmac/s.tmac (XH-INIT, XN-INIT, XH-UPDATE-TOC)
	(XH, XN, XH-REPLACEMENT, XN-REPLACEMENT): Implement them, and...
	* tmac/groff_ms.7.man: ...document them.

2021-10-24  Keith Marshall  <keith.d.marshall@ntlworld.com>

	[ms]: Fix misleading NH macro indentation.

	* tmac/s.tmac (@NH) [.T is html]: .if statement should exhibit
	same indentation as preceding .DEVTAG-NH statement, but is
	overindented; fix it.

2021-10-23  Keith Marshall  <keith.d.marshall@ntlworld.com>

	[ms]: Defend against uncontrolled page trap recursion.

	* tmac/s.tmac (pg@top) [HM+FM+.V>.p]: Diagnose insufficient page
	length, and abort; cf. <https://savannah.gnu.org/bugs/?61294>

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[groff]: Fix code style nits.

	* src/roff/groff/groff.cpp (main, help): Use standard C library
	preprocessor symbols `EXIT_SUCCESS` and `EXIT_FAILURE` instead
	of 0 and 1 literals, respectively.  See commit fa4c27e9, 7
	September.
	(main): Replace `assert(0)` with a communicative predicate.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tty.cpp (tty_printer::special_link):
	Eliminate casts by retyping `uri` and `pair` to pointers to
	`const char`s.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am: Build more quietly.
	(tmac/stamp-wrap): Prefix all rule commands with `$(AM_V_at)`;
	since this target is a stamp file instead of a useful artifact
	to be distributed, make its creation completely silent by
	default.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/troff.am: Build more robustly.
	(src/roff/troff/majorminor.cpp): Drop progress-reporting `echo`
	in favor of prefixing final rule command with `$(AM_V_GEN)`.
	Prefix earlier rule commands with `$(AM_V_at)`.  Use `printf`
	instead of `echo` to build the file, and create a temporary file
	at first so that we don't race with the compiler on parallelized
	builds.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/eqn.am (neqn): Simplify: drop removal of
	target prior to overwriting it; any system we can build groff on
	should have a shell that implements the clobbering semantics of
	the POSIX shell '>' operator.  (If this isn't true, we have
	_many_ other target rules in our build to which we must add
	prefatory `$(RM)`s, or I miss my guess.)

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/libgroff.am: Build more quietly and
	robustly.
	(src/libs/libgroff/version.cpp): Drop progress-reporting `echo`
	in favor of prefixing final rule command with `$(AM_V_GEN)`.
	Prefix earlier rule commands with `$(AM_V_at)`.  Use `printf`
	instead of `echo` to build the file, and create a temporary file
	at first so that we don't race with the compiler on parallelized
	builds.  Drop nilpotent sed transformation; this looks like a
	relic of past times when we'd drop a trailing ".0" from the
	version number stored in the C symbol `Version_string`.
	(charset.alias, ref-del.sed, ref-add.sed): Prefix rule command
	with `$(AM_V_GEN)`.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/xditview/xditview.am: Build more quietly.
	(src/devices/xditview/GXditview-ad.h): Drop progress-reporting
	`echo` in favor of prefixing rule command with `$(AM_V_GEN)`.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/devpdf.am: Build more quietly.
	(font/devpdf/enc/text.enc, font/devpdf/map/symbolmap,
	$(DEVPDFFONTMAP_1)): Prefix all rule commands with
	`$(AM_V_at)`; since these are all `mkdir`s and `cp`s, I reason
	that little can go wrong with them that won't be disclosed by
	these tools' own diagnostic messages, so they are insignificant
	from a perspective of build progress.

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Build more quietly.
	(doc/examples.stamp): Prefix all rule commands with
	`$(AM_V_at)`; since this target is a stamp file instead of
	a useful artifact to be distributed, make its creation
	completely silent by default.
	(doc/groff.info, .texi.txt): Prefix directory creation with
	`$(AM_V_at)` and `makeinfo` command with `$(AM_V_GEN)`.
	(.texi.dvi, .texi.pdf): Prefix directory creation with
	`$(AM_V_at)` and `makeinfo` command with `$(AM_V_GEN)`.  Send
	diagnostic message to standard error if `texi2dvi` is
	unavailable.
	(.texi.html): Prefix directory creation with
	`$(AM_V_at)`.  Two HTML versions are produced, in split and
	unsplit versions; prefix one `makeinfo` command with
	`$(AM_V_GEN)` and the other with `$(AM_V_at)` so that only one
	message is produced.
	(gnu.eps): Drop useless/noisy `echo` command.  Prefix copy
	operation with `$(AM_V_at)`.  Send diagnostic messages to
	standard error if there are problems with the Netpbm tools.

	(MOSTLYCLEANFILES): The `mostlyclean` target was leaving a file,
	`groff.info-3`, behind in the build tree.  At some point our
	Texinfo manual grew beyond earlier expectations.  Use a glob
	`[0-9]` instead (giving a hostage to fortune that `makeinfo`
	will never split our manual into more than nine chunks).

2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* arch/misc/misc.am:
	(arch_shdeps_sh): Pull file name into a new variable.
	(EXTRA_DIST, shdeps.sed): Use it.
	(shdeps.sed): Build more quietly; prefix with `$(AM_GEN_V)`.

2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[nroff]: Support groff's -R flag to run refer(1).

	There's no reason not to support calling `refer` with nroff-mode
	documents; typographically, it's less demanding than tbl(1).
	GNU troff(1) supports an incompatible `-R` flag to suppress the
	reading of troffrc{,-end} files, but this is likely not the `-R`
	that users will want--it is most useful for troubleshooting
	troff, and nroff already unconditionally loads a macro file
	{tty-char.tmac}.

	* src/roff/nroff/nroff.sh: Do it.

	* src/roff/nroff/nroff.1.man:
	* NEWS: Document it.

2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am (tmac/groff_man.7.man)
	(tmac/groff_man_style.7.man): Be quieter by default; use
	$(AM_V_GEN) more consistently with the rest of the build.

2021-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_error): Format diagnostic
	messages in closer alignment with GNU Coding Standards: don't
	introduce a space between the program name and the input file
	name.

	* src/roff/groff/tests/string_case_xform_errors.sh: Update
	expected output.

2021-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (distribute_space): Revert an
	`assert()` I added in commit b93eacd8d7 (5 September); we can
	indeed reach this code with a negative amount of desired space,
	and in fact the "show hyphenation points" trick
	<https://froude.eu/groff/examples/hyphenation-points.html>
	relies upon it.  Add explanatory comment.

	Fixes <https://savannah.gnu.org/bugs/?61348>.

2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* test-groff.in: Add support for sboxes.tmac.

2021-10-11  Paul Eggert <eggert@cs.ucla.edu>

	Include <config.h> before any standard headers.

	Gnulib requires that files that might use Gnulib features (which
	pretty much means every C or C++ source file) must include
	<config.h> first.  Arrange for that.  This will be needed once
	Groff updates to the latest Gnulib; see Bjarni Ingi Gislason's
	problem report in:
	<https://lists.gnu.org/r/bug-gnulib/2021-10/msg00008.html>

	The only exception I can see is src/utils/addftinfo/guess.cpp,
	which does not include any standard include file either directly
	or indirectly, and so need not include <config.h>.

	* src/devices/xditview/Dvi.c:
	* src/devices/xditview/font.c:
	* src/devices/xditview/lex.c:
	* src/devices/xditview/page.c:
	* src/devices/xditview/parse.c:
	* src/libs/libbib/map.c:
	* src/libs/libgroff/change_lf.cpp:
	* src/libs/libgroff/cmap.cpp:
	* src/libs/libgroff/cset.cpp:
	* src/libs/libgroff/fmod.c:
	* src/libs/libgroff/getcwd.c:
	* src/libs/libgroff/lf.cpp:
	* src/libs/libgroff/ptable.cpp:
	* src/libs/libgroff/quotearg.c:
	* src/libs/libxutil/DviChar.c:
	* src/libs/libxutil/XFontName.c:
	* src/libs/libxutil/xmalloc.c:
	* src/utils/indxbib/signal.c: Do it.

	[Fixes <https://savannah.gnu.org/bugs/?61315>. --GBR]

2021-10-10  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Handle pdfs > v1.4 loaded by \X'pdf: pdfpic'.

	* src/devices/gropdf/gropdf.pl: Improve loading of pdfs above
	version 1.4, i.e. handle compressed nodes in /ObjStm. Also
	improve code in \X'pdf: import'.

2021-10-10  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Add new background boxes to gropdf.

	* src/devices/gropdf/gropdf.pl: New \X'pdf: background' command.
	* tmac/pdf.tmac: Covenience command .pdfbackground added.
	* contrib/sboxes/: Files which demonstrate use of background
	boxes using -ms macros.

2021-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Fix portability problems in 2 tests.

	* src/roff/groff/tests/break_zero-length_output_line_sanely.sh:
	* tmac/tests/s_PN-works.sh: Migrate from `echo` to `printf` for
	test inputs containing backslashes to be interpreted literally.

	Fixes part of <https://savannah.gnu.org/bugs/?61302>.  Thanks to
	Deri James for identifying the problem.

2021-10-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Slightly refactor.

	* src/devices/grotty/tty.cpp: Boolify.  Demote numerous
	variables (and one return type) from `int` to `bool`, use
	Boolean instead of integer literals with them, and give the
	variables names resembling logical predicates.
	 - horizontal_tab_flag -> want_horizontal_tabs
	 - form_feed_flag -> want_form_feeds
	 - bold_flag_option -> want_emboldening_by_overstriking
	 - bold_flag -> do_bold
	 - underline_flag_option -> want_italics_by_underlining
	 - underline_flag -> do_underline
	 - overstrike_flag -> want_glyph_composition_by_overstriking
	 - draw_flag -> allow_drawing_commands
	 - italic_flag_option -> want_sgr_italics
	 - italic_flag -> do_sgr_italics
	 - reverse_flag_option -> want_reverse_video_for_italics
	 - reverse_flag -> do_reverse_video
	 - old_drawing_scheme -> use_overstriking_drawing_scheme
	(class tty_printer:printer): Similarly.
	 - is_underline -> is_underlining
	 - is_bold -> is_boldfacing
	 - cu_flag -> is_continuously_underlining
	(tty_printer::tty_color): Demote return type as above.  Invert
	its sense; rename `unknown_color` to `is_known_color`.
	(tty_printer::color_to_idx): Invert sense of test at
	`tty_color()` call site.

2021-10-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Finish documenting new `TC-MARGIN` register and
	`TC-LEADER` special character.

	Fixes <https://savannah.gnu.org/bugs/?61157>.

2021-10-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Slightly refactor.

	* src/devices/grotty/tty.cpp (tty_printer::special_link): Use
	consistent loop styles and drop unnecessary arithmetic.

2021-10-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix oversight and improve `MR` test.

	* tmac/an-ext.tmac (initialization): Enable `mY` register to
	indicate use of grotty(1) (and therefore OSC 8 support) if the
	"ascii", "cp1047", or "latin1" output devices are used, not just
	"utf8".

	* tmac/tests/an_MR-works.sh: Drop copy-and-paste cruft from a
	different test.  Update expected output and check for the
	presence of "link" device control subcommands, not just correct
	font selections.

2021-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add `MR` macro for man page cross references.

	* tmac/an.tmac (an-prepare-page-title): After a possibly
	abbreviated man page title is determined, redefine `an-pageref`
	to set the title portion in the font stored in the `MF` string
	and bracket it with italic corrections if that font is thought
	to be oblique.
	(MR): Add macro to format the text of a man page cross
	reference, and hyperlink it on HTML and terminal output devices
	if permitted by the `U` register.
	(initialization): Define `MF` string as `I` if not already set.
	Define `an-lic` and `an-ic` strings as either empty or as
	containing italic corrections.

	* tmac/an-ext.tmac (MR): If the formatter is not GNU troff,
	define macro to format the text of a man page cross reference.

	* tmac/groff_man.7.man.in: Document it.
	(Description): Add macro to summary table.
	(Description/Hyperlink macros): Document new feature.  Note
	origin in Plan 9 troff.  [style] Add examples of use.
	(Description/Font style macros): Drop man page cross references
	from list of items whose typeface conventions are disputed,
	since we have a semantic macro now and a configurable means of
	resolving the problem.
	(History): Add `MR` item.
	(Options) <MF>: Document new string.
	(Files) <an-ext.tmac>: Revise discussion to accommodate `MR`.
	(Authors): Add myself an author of extension macros.

	* tmac/tests/an_MR-works.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	* NEWS: Add item.

2021-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (SH, SS): Invoke `ne` request _before_ performing
	font remapping: any page-breaking decision will be taken before
	the remapping happens, and so won't be in effect across a page
	boundary, undesirably impacting header and footer text.

	Fixes <https://savannah.gnu.org/bugs/?61279>.

2021-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	Regression-test Savannah #61279.

	* tmac/tests/an_font-remapping-does-not-affect-titles.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (an-abbreviate-title): Rename to...
	(an-prepare-page-title): ...this.

2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Correct erroneous claim: the ".NH S" extension to ms(7)
	comes from 4.2BSD, not GNU.

2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/ms.ms (Creating a table of contents): Sync with recent
	additions to groff_ms(7), expand, and heavily revise.

2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[andoc,man,mdoc]: Fix Savannah #61266.  Resolve problems in
	batch rendering of man pages to PDF arising from entanglement
	of end-of-input traps, page location traps, continuous rendering
	mode, and andoc's reloading of the (m)an and (m)doc packages.

	* tmac/andoc.tmac (reload-doc, reload-man): Remove end-of-input
	traps alongside others.

	* tmac/an.tmac (an-end): Only perform flush and "manual" page
	footer placement if in continuous rendering mode, since this
	macro is not only called by a trap placed only in continuous
	rendering mode, but also by andoc when changing macro packages.
	Unconditionally remove the `an-header` trap since the next
	document might be using a different macro package.

	* tmac/mdoc/doc-common: In initialization, set flag indicating
	that manual header placement will be required.
	(Dt): Call `doc-setup-header` (which sets up several types of
	trap) unconditionally, and break the page if the vertical
	drawing position is anywhere but at the top.
	(Os): If the package has just been initialized, call
	`doc-header` to force the page header to be written.
	(doc-end-macro): Remove `doc-header` trap since the next
	document might be using a different macro package.  Break the
	page.  Set flag indicating that manual header placement will be
	required for the next document.

	* tmac/mdoc/doc-ditroff (doc-setup-header): Only set page
	location traps for the header and footer if not continuously
	rendering.
	* tmac/mdoc/doc-nroff (doc-setup-header): Stop calling
	`doc-header` here if continuously rendering.  Emit an
	unconditional break.  Except for the location of the footer
	trap, the `doc-setup-header` implementations are now identical.

	Refactoring is needed: some macros and registers have misleading
	names, there is some code duplication in mdoc, and some of the
	trap management problems are solved in slightly different ways
	in man(7) and mdoc(7), perhaps unnecessarily.  We also need some
	test scripts to protect us from regressions.  But this fixes the
	rendering problems.

	Fixes <https://savannah.gnu.org/bugs/?61266>.

2021-10-02  Keith Marshall  <keith.d.marshall@ntlworld.com>

	Correct manpage typo/inconsistency.

	* tmac/groff_ms.7.man (TC_LEADER, TC_MARGIN): Correct; should
	be...
	(TC\-LEADER, TC\-MARGIN): ...respectively, for consistency
	with...
	* tmac/s.tmac (TC-LEADER, TC-MARGIN): ...these.

2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (encode_char): Update diagnostic
	messages to not presume the identity of the escape character;
	continues 9be3f8e3 (4 June).

2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/tty.cpp (tty_printer:special_link): Tighten
	code slightly by taking advantage of preprocessor string literal
	concatenation.

2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix `U` enablement override so it actually works the way
	I had in mind.
	- The package proper enables it by default, but
	- the sample site configuration file switches it off, on the
	  assumption that distributors and users will know better than
	  we do when they get a capable pager in place, and
	- a register setting at the command line (or otherwise prior to
	  the loading of the macro package) is dispositive.

	* tmac/an-ext.tmac: Rename URI output device capability register
	from `U` to `mU`.
	(UR, UE, MT, ME): Test both `U` and `mU` before handling
	hyperlinks specially.
	* tmac/an.tmac: If `man.local` did not initialize `U`, switch it
	on.  The hope is that we can drop the stuff in `man.local`
	completely at some point.
	* tman/man.local: Only initialize `U` if it is not already
	defined.

2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Use OSC 8 hyperlinks.

	* tmac/an-ext.tmac: Add registers `mY` (output driver is
	"grotty") and `U` (generate hyperlinks).  `U` is intended to
	apply to hyperlinking support in general, not just grotty's OSC
	8 feature.  If the output driver is either grohtml or grotty,
	make `U` true (`man.local` is read subsequently and can override
	it).
	(UR, MT): Conditionalize diversion production on hyperlink
	support, not grohtml use per se.
	(UE, ME): Generate device control commands for `tty` device to
	emit hyperlinks.

	* tmac/groff_man.7.man.in (Options): Document -rU.
	(Files) [style]: Add example of `U` register enablement.

	* tmac/man.local: Disable `U` register by default, except on the
	`html` device.

	* NEWS: Add item.

2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grotty]: Add OSC 8 hyperlink support.

	* src/devices/grotty/tty.cpp: Do it.  Define `OSC` (Operating
	System Command) and `ST` (String Terminator) preprocessor
	symbols for these ECMA-48 (ISO 6429) character sequences.
	(tty_printer::simple_add_char): Add stripped-down alternative to
	`add_char()` member function for cases where we want to use many
	defaults because we're writing a terminal escape sequence, not
	rendering a glyph.  (A function like `add_char()` that takes 8
	arguments of varying types is a code smell--phew!)
	(tty_printer::special): Call `special_link()` member function if
	the device control command is `link`.
	(tty_printer::special_link): Add new member function to generate
	OSC 8 hyperlinks.

	* src/devices/grotty/grotty.1.man: Document it.  Observe in
	multiple places that disablement of SGR escape sequences
	disables OSC 8 too.

	* src/devices/grotty/tests/osc8_works.sh: Test it.
	* src/devices/grotty/grotty.am (TESTS, grotty_TESTS): Run test.
	(EXTRA_DIST): Ship test.

	* NEWS: Add item.

	Fixes <https://savannah.gnu.org/bugs/?60666>.  Thanks to Steffen
	Nurpmeso for supplying a proof-of-concept.  (I went with my own
	implementation, though, so blame me if it breaks.)

2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Convert special character glyphs corresponding to
	Unicode Basic Latin ("ASCII") code points to those code points
	when they occur in device escapes.  (They should be correct for
	IBM code page 1047 as well, but this is untested.)  This is
	necessary for encoding URLs in device control commands.  Special
	character identifiers are presumed to be the defaults documented
	in groff_char(7); this is a design gap that we should consider
	addressing.  (We don't have a way to ask "is this the special
	character corresponding to Unicode basic Latin code point X?")

	* src/roff/troff/input.cpp (encode_char): Do it.

2021-09-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man, mdoc]: Draw line after each page more consistently in
	continuous rendering mode.

	* tmac/an.tmac (an-bp): Move responsibility for line-drawing
	after each document from here...
	(an-end): ...to here.  Refactor; drop
	`an-do-draw-line-after-document` register in favor of testing
	`\n[.F]` for nullity; if it is not null, then another document
	is due to be processed (in fact, `.F` already contains its file
	name), and we need to draw a separating line.  If it is null, we
	have reached the end of input and none is necessary.

	* tmac/mdoc/doc-ditroff.tmac (doc-setup-page-layout):
	* tmac/mdoc/doc-nroff.tmac (doc-setup-page-layout): Save
	configured line length in new register `doc-line-length`.
	* tmac/mdoc/doc-common.tmac (doc-end-macro): Port the above
	man(7) feature to mdoc(7); draw a line of this length after each
	document if continuously rendering.

2021-10-01  Keith Marshall  <keith.d.marshall@ntlworld.com>

	[ms]: Update footnote handling documentation.

	* tmac/groff_ms.7.man: Make some linguistic style adjustments.
	(FP): Document it; see <https://savannah.gnu.org/bugs/?61022>.
	(FS-MARK): Likewise, document this recently added feature.

2021-10-01  Keith Marshall  <keith.d.marshall@ntlworld.com>

	[ms]: Support user-defined TOC leader style.

	* tmac/s.tmac (toc*leader-char): Rename it as...
	(TC-LEADER): ...this; within PX, leave it unchanged, if
	predefined.
	(TC-MARGIN): New numeric register; if predefined, leave it
	unchanged, otherwise define as \w'000'; use it instead of
	hard-wired definition, within PX; see
	<https://savannah.gnu.org/bugs/?61157>.

	* tmac/groff_ms.7.man (TC-LEADER, TC-MARGIN): Document them.

2021-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[pic]: Update input file name correctly.

	* src/preproc/pic/troff.cpp (troff_output::set_location): Copy
	the inbound file name argument with `strdup()` and store pointer
	to this copy in `last_filename` instead of aliasing argument.
	(troff_output::~troff_output): `free()` the memory allocated by
	`strdup()` in destructor.

	Fixes <https://savannah.gnu.org/bugs/?61206>.  Pointer
	assignment instead of a string copy was being performed, which
	means that after its initial assignment, `last_filename` always
	shared its value ultimately with the `current_filename` pointer
	{a libgroff symbol}, so `strcmp()` was always being performed on
	identical pointers.  Problem appears to date back 30+ years, to
	the dawn of our repo history.

2021-09-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devlj4/S: Make font name consistent with file name.

2021-09-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/font.cpp (font::load): Throw error if a font
	description file is missing a `spacewidth` directive, since it
	is now re-documented as mandatory.  Atypically, we don't return
	false in this scenario; instead we proceed with the existing
	logic to compute a space width for the font based on typical
	practices for Western alphabetic fonts (see, e.g.,
	<https://type.today/en/journal/spaces>.

	* font/devdvi/EX:
	* font/devdvi/MI:
	* font/devdvi/S:
	* font/devdvi/SA:
	* font/devps/EURO: Add `spacewidth` directive to font
	description files we ship that were missing it.  We use the same
	values that libgroff would have computed, so there should be no
	visible difference.

2021-09-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am: Mark `$(TEST_SUITE_LOG)` as `.PRECIOUS`.  This
	prevents the test suite log from being deleted if there are any
	failures.

	Fixes <https://savannah.gnu.org/bugs/?61213>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (do_line): Move first-macro-call test
	for `TH` to a more appropriate location.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Refactor to make it easier to generalize a per-package
	scoring mechanism.

	* src/utils/grog/grog.pl: Convert `inferred_main_package` from
	scalar to list.  Add scalar `selected_main_package` to store a
	"winner" from the list of main packages inferred.
	(push_main_package): Add subroutine to populate
	`inferred_main_package`.
	(do_line, infer_man_or_ms_package): Update to use
	`push_main_package`.
	(construct_command): Rewrite to select a main package from the
	list `inferred_main_package`, taking user-supplied arguments
	into account as an overriding factor.  Drop now-unused `msupp`
	list.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp (main): If the `-I` option is given,
	run the grn preprocessor and pass it an `-M` option with `-I`'s
	argument.

	* NEWS:
	* src/roff/groff/groff.1.man (Options): Document it.  Also
	document that `-I` options are passed to the output driver.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (do_line): Don't strip groff-style
	comments \# if AT&T compatibility mode is enabled.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Perform more font description file validation.  Our
	documentation said that the `name` directive was mandatory but
	we didn't actually enforce this.  Also be more specific in our
	complaints of ill-formedness.

	* src/libs/libgroff/font.cpp (font::load): Add local Boolean
	variable `saw_name_directive`.  Rename `had_charset` to
	`saw_charset_directive` for symmetry.  Emit distinct diagnostics
	for `spacewidth` and `slant` directives having a missing,
	non-numeric, or out-of-range argument.  Emit diagnostic if the
	file lacks a `name` directive.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Slightly refactor.

	* src/libs/libgroff/font.cpp (struct text_file): Rename member
	variable `size` to `linebufsize` for clarity (it's certainly not
	the size of the text file).
	(text_file::text_file): Initialize `linebufsize` in constructor.
	(text_file::next_line): Allocate new `buf` using `linebufsize`
	instead of magic number (which was also stored to `size`, making
	it only semi-magic, I guess).  Rename local variable `i` to
	`length` since it is in fact the length (in `char`s) of the
	string stored in `buf`.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Revisit fix for Savannah #61173.

	* src/libs/libgroff/font.cpp (text_file::text_file): Restore
	setting of `lineno` member variable to `0` in constructor
	initializer list, but...
	(text_file::next_line): ...unconditionally increment it every
	time through this member function's outer loop.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Align diagnostic message format with libgroff.

	* src/roff/troff/input.cpp (fatal_with_file_and_line): Report
	the program name if one is defined.
	(fatal_with_file_and_line, error_with_file_and_line,
	debug_with_file_and_line): Report the line number of the input
	file only if it is positive, so that other values can be used
	for "whole file" complaints.  See commit cd0457b6, 17 September.

2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop redundant diagnostic.

	* src/libs/libgroff/font.cpp (font::load): Drop redundant
	diagnostic; a missing `charset` directive is already checked for
	later, circa line 998.

2021-09-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Fix code style nits.

	* src/libs/libgroff/font.cpp (font::font): Use initializer list
	as much as possible in constructor.
	(font::unit_scale, font::get_width, font::get_height,
	font::get_depth, font::get_italic_correction,
	font::get_left_italic_correction,
	font::get_subscript_correction, font::get_character_type,
	font::get_code, font::get_special_device_encoding): These member
	functions rely on the font being either indexed or associated
	with an output device that uses the `unicode` directive in its
	`DESC` file.  The compiler doesn't know this, so annotate the
	`abort()` calls that conclude them.  Add an `assert()` before
	each one to more usefully describe the violated invariant in the
	event this unreachable code is somehow reached.
	(font::get_width): Annotate special meaning of zero zoom factor.

2021-09-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/include/font.h (UNDEFINED_GLYPH): Use idiomatic C++98 null
	pointer constant.

2021-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix compiler warning and dead store.

	* src/devices/grohtml/post-html.cpp (html_printer::special):
	Update call of `font::load_font()` to stop passing obsolete
	parameter (deleted by me in 2dff87d3, 17 September).  The value
	stored to the parameter by that function was never read anyway,
	so also get rid of the variable that contained it.

	Fixes <https://savannah.gnu.org/bugs/?61187>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Slightly refactor.

	* src/include/font.h (font::scan_papersize): Demote return type
	from `int` to `bool`.
	* src/libs/libgroff/font.cpp (font::scan_papersize): As above.
	Use Boolean instead of integer literals.  Also rename `FILE`
	stream pointer from `f` to `fp` and perform an explicit
	comparison against the idiomatic C++98 null pointer constant.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff, troff]: Slightly refactor device and font description
	file loading.  Remove dead code.

	* src/include/font.h (font::load_font): Drop second parameter.
	It was never used for its intended purpose.
	(load): Drop first parameter; likewise.
	* src/libs/libgroff/font.cpp (font::load, load): As above.

	* src/libs/libgroff/font.cpp (struct text_file): Rename
	`skip_comments` to `recognize_comments`.  Demote that and
	`silent` from `int` to `bool`.
	(text_file::text_file): Use Boolean rather than integer literals
	in constructor.
	(text_file::next_line, font::load): Apply above renaming.

	* src/libs/libgroff/font.cpp (font::load): Rename parameter from
	`head_only` to `load_header_only` to be more communicative.
	Drop test of font description file name being `DESC`; this code
	was not being reached.  Stop throwing errors from this function
	on failure to open the file; the caller will handle this when it
	sees our false return value.  Rename local variable `command` to
	`directive` for alignment with our documentation.  Replace "I
	dont think this should happen" test and comment with `assert()`.
	(struct table): Rename member from `command` to
	`numeric_directive` to indicate its specificity, tracking only a
	subset of valid `DESC` file directives.

	* src/libs/libgroff/font.cpp (font::load, font::load_desc):
	Remove redundant assignments to the member variable formerly
	known as `skip_comments`.

	* src/libs/libgroff/font.cpp (font::load_desc): Rename local
	variable `directive_found` to `numeric_directive_found` to
	clarify logic.

	* src/roff/troff/node.cpp (mount_font_no_translate): Simplify
	call of `font::load_font`.  The `not_found` in-out parameter
	which was so agonizingly passed up through layers of library
	calls was never actually read.  Drop code that has been `#if
	0`-ed out since 1993.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/font.cpp (font::load_desc): Clear line
	number before emitting whole-file validity diagnostics.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/font.cpp (font::load_desc): Emit correct
	line numbers when complaining of invalid `sizescale`, `hor`, or
	`vert` values in device description files.

	Fixes <https://savannah.gnu.org/bugs/?61174>.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Increase validation of device and font description
	files.

	* src/libs/libgroff/font.cpp (font::load): Validate the syntax
	and value of the `name` directive.
	(font::load_desc): Issue distinct diagnostics for a `fonts`
	directive that is missing arguments and for a first argument
	that can't be interpreted as a valid number.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Make error reporting more flexible.

	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
	Interpret a nonpositive line number specially: treat the
	diagnostic as applying to the entire file, and omit the line
	number.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Add information to diagnostics.

	* src/libs/libgroff/font.cpp (font::load): Drop unused argument
	from `error()` call.
	(font::load_desc): In another, add name of numeric directive
	that is given an unparsable number.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Tweak code style.

	* src/libs/libgroff/font.cpp (trim_args, font::load)
	(font::load_desc): Compare pointer explicitly to null pointer
	literal `0` instead of using logical complementation.
	(font::load, font::load_desc): Swap order of null pointer
	equality comparisons when a typo or thinko could lead to lvalue
	assignment.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Use idiomatic C++98 null pointer constant.

	* src/libs/libgroff/font.cpp (text_file::error)
	(glyph_to_unicode, font::get_special_device_encoding)
	(font::load):
	* src/libs/libgroff/fontfile.cpp (font::image_generator):
	* src/libs/libgroff/nametoindex.cpp (class charinfo)
	(character_indexer::named_char_glyph)
	(character_indexer::numbered_char_glyph):
	* src/libs/libgroff/string.cpp (string::clear):
	* src/libs/libgroff/tmpfile.cpp (temp_init::temp_init):
	* src/libs/libgroff/tmpname.cpp (gen_tempname): Use `0` literal
	instead of `NULL` to represent a null pointer; this was
	idiomatic in C++98 and is mostly the practice elsewhere in
	groff.  Also swap order of null pointer equality comparisons
	when a typo or thinko could lead to lvalue assignment.

	* src/roff/troff/input.cpp (input_stack::diversion_state)
	(input_stack::get_diversion_state, charinfo::contains)
	(glyph_to_name): Similar.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Slightly refactor.

	* src/libs/libgroff/font.cpp (font::load): Use same loop style
	as `font::load_desc()`.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Fix off-by-one error in font and device description
	file reader diagnostics.

	* src/libs/libgroff/font.cpp (text_file::text_file): All text
	files begin with line 1, not line 0.

	Fixes <https://savannah.gnu.org/bugs/?61173>.

2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Boolify more interfaces.

	* src/include/font.h (font::unit_scale):
	* src/libs/libgroff/font.cpp (font::unit_scale): Demote return
	type from `int` to `bool`.  Use Boolean literals instead of
	integers.

	* src/libs/libgroff/font.cpp (struct text_file): Rename `next`
	member function to `next_line`.  Demote its return type from
	`int` to `bool`.  Use Boolean literals instead of integers.

2021-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Boolify local variables.

	* src/libs/libgroff/font.cpp (font::load, font::load_desc):
	Demote local variables used as Booleans from `int` to `bool` and
	update literals used with them from integer to Boolean.

2021-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grn, groff, troff]: Communicate better when device DESC file
	can't be loaded.

	* src/libs/libgroff/font.cpp (font::load_desc): Stop writing
	diagnostic to standard error.
	* src/preproc/grn/main.cpp (getres):
	* src/roff/troff/troff.cpp (main): Replace "sorry, I can't
	continue" fatal diagnostic with a more informative message.
	Instead say which device's DESC file the program was trying to
	open, which might reveal a user's logic error or typo.
	* src/roff/groff/groff.cpp (main): Replace "invalid device" text
	of fatal diagnostic similarly.  I think it is more helpful to
	indicate the operation that failed rather than saying the device
	was invalid, particularly since there are other ways for a
	device description to be invalid even if a DESC file is found
	and loaded.

2021-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Throw warning diagnostic if device DESC file attempts
	to load unavailable fonts.

	* src/roff/troff/input.cpp (main): Take advantage of new Boolean
	return values of `mount_style()` and `mount_font()` to produce
	warning diagnostics if mounting a style or font as directed by
	the DESC file fails.  Explain in a comment why, at present, this
	style mount warning will never actually trip.

2021-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Lift font mounting diagnostic messages to be closer to
	their user-controlled contexts to provide more information.  In
	many cases no diagnostic was being thrown at all when an
	unavailable font was requested by name, which is the method most
	users prefer, and which meant that failures resulting from typos
	in font names for many requests (`uf`, `fschar`, `rfschar`,
	`special`, `fspecial`, `fzoom`, `bd`, `tkf`, `cs`) were going
	unreported.  Further, promote these font warnings to errors
	because the request will utterly fail to do what was requested
	with no reasonable fallback.  Possibly, they were formerly
	warnings because at the low level they were being emitted, they
	could also have originated from unavailable fonts encountered in
	device description files, and while that's bad news, it results
	in no formatting problems if it doesn't affect fonts that an
	input document actually uses.

	* src/roff/troff/node.cpp (struct font_lookup_info): New struct
	keeps the font name or position requested, and the position of
	successful font lookup.
	(font_lookup_info::font_lookup_info): Add constructor.
	(font_lookup_error): New function builds error message using a
	`font_lookup_info` struct and a message argument.
	(get_fontno): Rename to...
	(has_font): ...this.  Add argument to take a pointer to a
	`font_lookup_info` struct.  Return a `bool` indicating whether
	the lookup succeeded.  Place former `int` return value into the
	struct instead.  Populate the other struct members with the
	requested font name or position, as appropriate.
	(mount_font_no_translate): Stop throwing warning diagnostic here
	if a font cannot be loaded.  Instead, throw them...
	(font_position): ...here, and...
	(underline_font, define_font_special_character,
	remove_font_special_character, read_special_fonts,
	font_special_request, font_zoom_request, bold_font, track_kern,
	constant_space): ...here, using `font_lookup_info` structs and
	`has_font()`.
	(remove_font_special_character): Stop returning early if font
	lookup fails; it's gratuitously inconsistent with other similar
	functions (save one, which has a reason to be different).
	(define_font_special_character): Return early if font lookup
	fails and say why in a comment (we can't `skip_line()`).

	Fixes <https://savannah.gnu.org/bugs/?59522>.

2021-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* [libgroff, troff]: Further boolify.

	* src/include/font.h (load_font, font): Demote parameters from
	{pointer to} `int` to `bool` and update default literal from
	integer to Boolean (except for the pointer).  Update comment.
	* src/libs/libgroff/font.cpp (load_font, load): Similarly.

	* src/roff/troff/node.h (mount_font):
	* src/roff/troff/node.cpp (mount_font): Demote return type from
	`int` to `bool`.

	* src/roff/troff/node.h (mount_style):
	* src/roff/troff/node.cpp (mount_style): Promote return type
	from `void` to `bool`.

	* src/roff/troff/node.cpp (mount_font_no_translate): Demote
	return type and `check_only` parameter from `int` to `bool` and
	use Boolean rather than integer literals with them.
	(check_font): Update call site of `mount_font_no_translate` to
	use Boolean literal.
	(font_position): Indicate that "error" is ignored by casting
	return value of `mount_font` to void instead of using a comment.
	(style): Cast return value of `mount_style` to `void`.

2021-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* Makefile.am: Add `.DELETE_ON_ERROR` special target; both GNU
	and FreeBSD make(1)s support it so maybe it will be portable
	enough.  This avoids, among other problems, a target appearing
	falsely up-to-date (often as an empty file) when the troff
	process generating it experiences an assertion failure.

2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	Since June 1991 if not earlier, groff (technically, the refer,
	lookbib, and lkbib programs) has trusted the header contents of
	binary bibliographic index files (canonically generated with
	indxbib(1)) regarding the sizes of the data structures that
	follow in the file, a notorious class of security problem.  In
	July 2013, the Mayhem Team at Carnegie Mellon University
	reported to the Debian Bug Tracking System a problem with
	groff's refer(1) implementation dumping core when reading an
	index file prepared by a fuzzer.

	* src/libs/libbib/index.cpp (index_search_item::check_header):
	Add new member function to validate the header of an indexed
	bibliography file, returning a string describing in detail the
	first validity problem encountered.
	(index_search_item::load): Perform the foregoing check before
	using any of the size values taken from the header; they are
	relied upon for pointer arithmetic.  If in verification mode
	{using the undocumented `-V` flag to refer(1), lkbib(1), or
	lookbib(1)}, report the details of the problem encountered.
	Regardless of that mode, if there is a validity problem, report
	corruption of the index file and abandon it, forcing fallback to
	the text version of the corresponding bibliography file.

	Fixes <https://bugs.debian.org/716109>.

2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libbib/index.cpp
	(index_search_item::get_invalidity_reason): Don't complain about
	a last list element being nonnegative if the list size was zero
	in the first place, as can happen with an empty index.  More
	seriously from a language standpoint, avoid reading through a
	negative array index (this can escape a compiler's attention
	because we're reading from the midst of a heap-allocated or
	`mmap()`ed region, but it's still a code smell).

	Fixes <https://savannah.gnu.org/bugs/?61144>.

2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libbib/index.cpp (index_search_item::load)
	(index_search_item::get_invalidity_reason)
	(index_search_item::add_out_of_date_file): Clarify diagnostic
	messages.  Make it more obvious when we're complaining of a
	problem in an indexed bibliographic database file (rather than a
	plain text one).  Dial down the amount of Unix jargon a little.

2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libbib]: Partially boolify.

	* src/include/search.h:
	* src/libs/libbib/index.cpp:
	* src/preproc/refer/refer.cpp:
	* src/utils/lkbib/lkbib.cpp:
	* src/utils/lookbib/lookbib.cpp: Demote `verify_flag` from an
	`int` to a `bool`, rename it to `do_verify`, use Boolean
	instead of integer literals with it, and update call sites.

	* src/libs/libbib/index.cpp: Rename `do_verify()` member
	function to `get_invalidity_reason()` (it returns a string).
	Demote `load()` from `int` to `bool`; do the same for `verify()`
	and rename it to `is_valid()` as well.  Use Boolean instead of
	integer literals with them.
	(index_search_item::is_valid, make_index_search_item): Update
	call sites of renamed member functions.

2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libbib/map.c (mapread): Compare return value of
	`mmap()` to `MAP_FAILED` instead of `(char *)-1`.  `MAP_FAILED`
	is documented in POSIX Issue 5 a.k.a. SUSv2
	<https://pubs.opengroup.org/onlinepubs/007908799/xsh/mmap.html>
	{1997} and should be portable enough by now.

2021-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Clamp negative tab stop positions to zero instead of
	throwing an assertion failure.

	* src/roff/troff/env.cpp (tab_stops::distance_to_next_tab):
	Replace `assert` with clamping logic, ensuring that `lastpos`
	can never be negative.  While negative tab stop positions don't
	make much sense (they result in zero horizontal motion), user
	input like `.ta T -5` should never provoke an assertion failure.

	(set_tabs): Throw range warning in additional scenario, viz., if
	a repeating tab offset is negative.

	Fixes <https://bugs.debian.org/990406>.  Thanks to наб for the
	report.

2021-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Boolify `set_tabs` function.

	* src/roff/troff/env.cpp (set_tabs): Demote local variables from
	`int` to `bool` and give them predicate-like names.
	  - `first` -> `is_first_stop`
	  - `repeated` -> `is_repeating_stop`
	Use Boolean instead of integer literals in assignments to them.

2021-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Deprecate `OP` macro.

	* tmac/an-ext.tmac (OP): Move implementation from here...
	* tmac/an.tmac (OP): ...to here.  Throw deprecation warning.
	Throw style warning if wrong number of arguments given.

	* tmac/groff_man.7.man.in (Description): Drop from introductory
	macro summary.
	(Description/Command synopsis macros): Move discussion from
	here...
	(Description/Deprecated features): ...to here.  Explain why it's
	deprecated.

2021-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Make `ab` request quiet if given no arguments.  The
	`tm`, `tm1`, and `tmc` requests provide ample flexibility for
	constructing diagnostic messages prior to an error exit, and
	it's convenient to make `ab` itself quiet instead of saying
	"User Abort." as Unix Version 7 troff did.  Further, there is no
	standardization across troffs regarding what `ab` should emit if
	arguments are absent.

	* src/roff/troff/input.cpp (abort_request): Do it.

	* src/roff/groff/tests/ab_works.sh:
	* src/roff/groff/groff.am (groff_TESTS): Test it.

	* doc/groff.texi (Debugging, Implementation Differences):
	* man/groff.7.man (Requests/Request short reference):
	* man/groff_diff.7.man (Implementation differences): Document
	it.

	Fixes <https://savannah.gnu.org/bugs/?61070>.  Thanks to Dave
	Kemper for the discussion.

2021-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Update exit status literals.

	* src/roff/troff/div.cpp (top_level_diversion::begin_page):
	* src/roff/troff/input.cpp (exit_troff, abort_request, do_error)
	(fatal_with_file_and_line): Use standard C library preprocessor
	symbols `EXIT_SUCCESS` and `EXIT_FAILURE` instead of 0 and 1
	literals, respectively.

2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Drop unused member function.

	* src/roff/troff/token.h (class token): Drop unused `title`
	member function.  Its implementation was apparently removed in
	the prehistory of our Git repository: see James Clark's
	ChangeLog entry of 1990-09-06.

2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Remove workaround for Cfront 1.2 bug.

	* src/roff/troff/input.cpp (do_define_macro): Move `dot_symbol`
	from to file to function local scope as originally intended.

2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Rename parameter.

	* src/roff/troff/input.cpp (token::usable_as_delimiter): Rename
	parameter from `err` to `report_error` to be more communicative.

2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Boolify members of `token` class.

	* src/roff/troff/token.h (class token): Demote return type of
	several member functions from `int` to `bool` and rename them.
	  - `backspace` -> `is_backspace`
	  - `delimiter` -> `usable_as_delimiter`
	  - `dummy` -> `is_dummy`
	  - `eof` -> `is_eof`
	  - `horizontal_space` -> `is_horizontal_space`
	  - `hyphen_indicator` -> `is_hyphen_indicator`
	  - `leader` -> `is_leader`
	  - `left_brace` -> `is_left_brace`
	  - `newline` -> `is_newline`
	  - `page_ejector` -> `is_page_ejector`
	  - `right_brace` -> `is_right_brace`
	  - `space` -> `is_space`
	  - `special` -> `is_special`
	  - `stretchable_space` -> `is_stretchable_space`
	  - `tab` -> `is_tab`
	  - `transparent_dummy` -> `is_transparent_dummy`
	  - `transparent` -> `is_transparent`
	  - `unstretchable_space` -> `is_unstretchable_space`
	  - `white_space` -> `is_white_space`
	  - `zero_width_break` -> `is_zero_width_break`
	(class token): Drop 1991 comment anticipating that member
	function `nspaces` could return "2" for a "double space"; this
	was apparently never implemented.
	(class token): Drop parameter names from declarations; the
	prevailing style (familiar from Stroustrup) is not to use them.
	(token::is_special): Simplify implementation.

	* src/roff/troff/input.cpp (has_arg)
	(token::usable_as_delimiter): Update definitions of above member
	functions not defined in token.h.

	* src/roff/troff/div.cpp (begin_page, space_request, need_space)
	(output_saved_vertical_space, flush_output):
	* src/roff/troff/env.cpp (fill, no_fill, center)
	(right_justify, indent, temporary_indent, margin_character)
	(number_lines, do_break_request, hyphen_word):
	* src/roff/troff/input.cpp (next_file, do_overstrike)
	(do_bracket, do_name_test, do_expr_test, do_zero_width)
	(token::skip, has_arg, skip_line, empty_name_warning)
	(non_empty_name_warning, do_get_long_name, process_input_stack)
	(flush_pending_lines, decode_args, read_request)
	(do_define_string, do_define_character, remove_character)
	(do_define_macro, length_request, get_delim_number)
	(get_line_arg, read_size, get_delim_name, do_register, do_width)
	(read_title_parts, encode_char, do_special, device_request)
	(output_request, skip_alternative, begin_alternative)
	(nop_request, do_if_request, do_source, pipe_source)
	(ps_bbox_request, tag, taga, do_terminal, do_translate)
	(hyphenation_code, hyphenation_patterns_file_code, define_class)
	(get_optional_char, check_missing_character, abort_request)
	(copy_file, transparent_file, do_macro_source)
	(charinfo_to_node_list, read_draw_node, read_color_draw_node):
	* src/roff/troff/node.cpp (get_fontno)
	(remove_font_special_character, bold_font):
	* src/roff/troff/number.cpp (start_number, parse_term):
	* src/roff/troff/reg.cpp (define_number_reg, alter_format):
	Update call sites to use new names.

	* src/roff/troff/input.cpp (token::usable_as_delimiter)
	(read_draw_node): Return Boolean, not integer, literals.

2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Clamp line and title lengths to device horizontal
	resolution.

	* src/roff/troff/env.cpp (line_length, title_length): Do it.

	Fixes <https://savannah.gnu.org/bugs/?61116>.

2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (do_hyphenation_patterns_file):
	Refactor slightly.  Demote `append` from `int` to `bool`.
	(hyphenation_patterns_file, hyphenation_patterns_file_append):
	Update call sites to use Boolean, not integer, literals.

2021-09-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/hvunits.h:
	* src/roff/groff/number.cpp: Mark `H0`, `V0` objects as `const`.

2021-09-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (do_underline_special): Refactor
	slightly.
	  - Rename `underline_spaces` -> `do_underline_spaces`.
	  - Demote it from an `int` to a `bool`.
	  - Use ternary operator and explicit character literals when
	    writing device control command instead of doing arithmetic
	    on a character literal.
	  - Update call sites to use Boolean literals.
	  - Relocate function to avoid forward reference.
	  - Mark function as static to eliminate external linkage.
	    Remove now-unnecessary prototype.

2021-09-04  Keith Marshall  <keith.d.marshall@ntlworld.com>

	Add "ms" footnote marker placement hook.

	* tmac/s.tmac (FS-MARK): New macro; define as no-op, by default.
	(@FS): Invoke FS-MARK as first action, allowing caller to "hook" it.

2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (distribute_space): Refactor slightly.
	  - Rename `force_reverse` to `force_reverse_node_list`.
	  - Rename `reverse` to `do_reverse`.
	  - Demote both of the above from `int` to `bool`.
	  - Use Boolean literals with them.
	  - Add assertions to enforce positive values of `nspaces` and
	    `desired_space`.
	  - Remove now-redundant test for `nspaces` being positive.
	  - Add explanatory comments.
	(environment::wrap_up_field): Update call sites of
	`distribute_space` when non-default value of
	`force_reverse_node_list` is supplied.

2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Don't adjust nonadjustable lines.  This means that the
	direction from which an output line in adjustment mode "b" (or
	its "n" synonym) is filled with supplemental space is not
	changed if that output line does not require adjustment.  This
	will result in whitespace changes to documents using that
	adjustment mode, and these changes will be plainly visible on
	low-resolution output devices like terminals.

	To illustrate, in the following "A" means an output line
	requiring adjustment; "F" a line that is "full" and does not;
	and "L" and "R" indicate distribution of adjustment spaces from
	the left and right, respectively.

	groff 1.22.4    groff 1.23.0
	------------    ------------
	A    L          A    L
	A    R          A    R
	F    L          F    R
	A    R          A    L

	* src/roff/troff/env.cpp (distribute_space): Return early if
	either the amount of desired space to be distributed or the
	count of space nodes in the output line to distribute it among
	is zero.

	* tmac/tests/an_TH-repairs-ad-damage.sh: Update test to expect
	space to be distributed differently.

	Fixes <https://savannah.gnu.org/bugs/?61089> and
	<https://savannah.gnu.org/bugs/?60673>.

2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	Skip core-dump-checking test if a core file already exists.

	* src/roff/groff/tests/regression_savannah_59202.sh: Skip test
	if a core dump is already present.

2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #60189.

	* src/roff/groff/tests/break_zero-length_output_line_sanely.sh:
	Do it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2021-08-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Tweak diagnostic message.

	* src/roff/troff/env.cpp (environment::environment): Use
	terminology more rigorously in diagnostic.

2021-08-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Fix code style nit.

	* src/libs/libgroff/errarg.cpp (errprint): Replace `assert(0)`
	with a meaningful predicate.

2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Demote `need_space` to Boolean.

	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
	Demote local integer `need_space` and its assignments to `bool`.

2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Boolify `font::load()` and `font::load_desc()`
	return values.

	* src/include/font.h (font::load, font::load_desc):
	* src/libs/libgroff/font.cpp (font::load, font::load_desc): Do
	it.

2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (TRADITIONAL_CPP): Update `AC_MSG_CHECKING`
	argument to refer to "pre-ISO C90 syntax" instead of a
	"traditional" preprocessor.  Call `AC_MSG_ERROR` (aborting
	configuration) if the check (for pre-C90 transformation)
	succeeds.  We thus withdraw support for such superannuated
	{"Reiser"} C preprocessors.

2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Un-indirect token concatenation through macro.

	* src/include/itable.h:
	* src/include/ptable.h: Do it.

2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop support for `TRADITIONAL_CPP`.  This means a C
	preprocessor that does not support the ANSI C89/ISO C90
	token concatenation operator "##".

	* src/include/itable.h:
	* src/include/ptable.h: Do it.

	* Makefile.am: Undocument preprocessor symbol.

2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop `a_delete` preprocessor wrapper for the
	`delete` operator.  It has been rendered unnecessary by the
	removal of support for ancient C++ compilers.

	* src/include/lib.h (a_delete): Drop symbol definition.

	* src/devices/grohtml/output.cpp (word::~word):
	* src/devices/grohtml/post-html.cpp (char_block::char_block)
	(assert_state::~assert_state, assert_state::add)
	(assert_state::close, replace_negate_str):
	* src/devices/grops/ps.cpp (ps_font::ps_font)
	(subencoding::subencoding, ps_printer::define_encoding)
	(ps_printer::encode_fonts):
	* src/devices/grops/psrm.cpp (resource_manager::document_setup)
	(resource_manager::supply_resource):
	* src/devices/grotty/tty.cpp (tty_printer::tty_color)
	(tty_printer::tty_printer, tty_printer::color_to_idx)
	(tty_printer::add_char):
	* src/include/itable.h (ITABLE(T)::~ITABLE(T))
	(ITABLE(T)::define):
	* src/include/ptable.h (PTABLE(T)::~PTABLE(T))
	(PTABLE(T)::define):
	* src/libs/libbib/index.cpp
	(index_search_item::~index_search_item, make_index_search_item,
	index_search_item_iterator::index_search_item_iterator,
	index_search_item::get_tag, index_search_item::munge_filename,
	index_search_item::search):
	* src/libs/libbib/linear.cpp (bmpattern::~bmpattern)
	(file_buffer::file_buffer, file_buffer::load)
	(linear_searcher::linear_searcher)
	(linear_searcher::~linear_searcher):
	* src/libs/libbib/search.cpp
	(search_list_iterator::search_list_iterator)
	(search_item::search_item):
	* src/libs/libdriver/input.cpp (IntArray::~IntArray)
	(IntArray::append, StringBuf::~StringBuf, StringBuf::append)
	(get_integer_arg, parse_x_command, do_file):
	* src/libs/libdriver/printer.cpp (printer::printer)
	(printer::load_font, text_file::~text_file, text_file::next)
	(font::~font, font_widths_cache::~font_widths_cache)
	(font:alloc_ch_index, font::extend_ch, font::compact)
	(font::load_desc):
	* src/libs/libgroff/fontfile.cpp (font::open_file):
	* src/libs/libgroff/relocate.cpp (searchpath, searchpathext)
	(set_current_prefix):
	* src/libs/libgroff/searchpath.cpp (search_path::search_path)
	(search_path::command_line_dir, search_path::open_file)
	(search_path::open_file_cautious):
	* src/libs/libgroff/string.cpp (sfree, srealloc)
	(string::remove_spaces):
	* src/libs/libgroff/symbol.cpp (symbol::symbol, concat):
	* src/libs/libgroff/tmpfile.cpp (temp_init::temp_init)
	(xtmpfile_list_init::~xtmpfile_list_init, xtmpfile):
	* src/preproc/eqn/box.cpp (set_gfont, set_grfont, set_gbfont)
	(box_list::append, box_list::~box_list):
	* src/preproc/eqn/delim.cpp (make_delim_box)
	(delim_box::~delim_box):
	* src/preproc/eqn/eqn.ypp (number):
	* src/preproc/eqn/lex.ypp (file_input::~file_input)
	(argument_macro_input::~argument_macro_input):
	* src/preproc/eqn/pile.ypp (matrix_box::~matrix_box)
	(matrix_box::append):
	* src/preproc/eqn/special.cpp (special_box::~special_box):
	* src/preproc/eqn/text.ypp (set_char_type):
	* src/preproc/html/pre-html.cpp (get_line, scanArguments):
	* src/preproc/pic/object.cpp (output::~output)
	(output::set_args, text_item::~text_item)
	(object_spec::~object_spec, command_object::~command_object)
	(line_object::~line_object):
	* src/preproc/pic/pic.ypp (placeless_element, reset_variables)
	(print_args, text_expr, object_spec, text, sprintf_args, path):
	* src/preproc/refer/command.cpp (input_item::~input_item)
	(input_item::peek_char):
	* src/preproc/refer/label.ypp (lookup_label):
	* src/preproc/refer/refer.cpp (store_citation, store_reference):
	* src/preproc/tbl/main.cpp (format::add_rows, format::~format):
	* src/preproc/tbl/table.cpp (block_entry::~block_entry)
	(table::~table, table::allocate):
	* src/roff/groff/groff.cpp (possible_command::~possible_command)
	(possible_command::clear_name):
	* src/roff/troff/column.cpp
	((justification_spec::~justification_spec)
	(justification_spec::append):
	* src/roff/troff/dictionary.cpp (dictionary::lookup):
	* src/roff/troff/env.cpp (override_sizes, tab_stops::to_string)
	(hyphen_word, hyphen_trie::insert_hyphenation):
	* src/roff/troff/input.cpp (read_long_escape_name, token::next)
	(do_get_long_name, temp_iterator::~temp_iterator)
	(get_delim_name, pipe_source, read_string, pipe_output)
	(system_request, open_mac_file, do_macro_source)
	(do_register_assignment, do_string_assignment, read_draw_node)
	(copy_mode_error):
	* src/roff/troff/node.cpp (troff_output_file::set_font)
	(troff_output_file::~troff_output_file, draw_node::is_tag)
	(grow_font_table, font_family::~font_family)
	(font_family::make_definite):
	* src/utils/hpftodit/hpftodit.cpp (name_list::~name_list)
	(read_map):
	* src/utils/indxbib/indxbib.cpp (main, get_cwd):
	* src/utils/tfmtodit/tfmtodit.cpp (tfm::~tfm, tfm::load): Port
	uses of `a_delete` to `delete[]`.

2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop `ad_delete` preprocessor wrapper for the
	`delete` operator.  It has been rendered unnecessary by the
	removal of support for ancient C++ compilers.

	* src/include/lib.h (ad_delete): Drop symbol definition.

	* src/preproc/pic/object.cpp (graphic_object::print_text):
	* src/preproc/refer/ref.cpp (reference::reference)
	(reference::merge, reference::insert_field)
	(reference::delete_field):
	* src/preproc/tbl/main.cpp (format::add_rows): Port uses of
	`ad_delete` to `delete[]`.

2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_ARRAY_DELETE): Update `AC_MSG_CHECKING`
	argument to refer to "ISO C++98" instead of "ANSI".  Call
	`AC_MSG_ERROR` (aborting configuration) if the check fails.

2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop support for `ARRAY_DELETE_NEEDS_SIZE`.

	* src/include/lib.h [ARRAY_DELETE_NEEDS_SIZE]: Drop preprocessor
	conditional branch.  This abandons support for certain pre-ISO
	C++98 compilers.  (According to a now-removed comment, unsized
	array deletion was documented in "ARM", meaning _The C++
	Annotated Reference Manual_, published in 1989.)

	* Makefile.am: Undocument preprocessor symbol.

2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop redefinition of `INT_MIN`.

	* src/include/lib.h: Drop redefinition of `INT_MIN`.  It was
	motivated by a bug in the AT&T C++ compiler (cfront), version
	2.0, released in June 1989.  Implementations have had 30 years
	to get this right; assume that they have.

	* PROBLEMS: Drop corresponding item.

2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Drop long-dead `COOKIE_BUG` logic.

	* src/libs/libgroff/new.cpp (operator new, operator delete):
	Drop preprocessor conditional branches on the `COOKIE_BUG`
	symbol.  This was de-documented, and an autoconf check for its
	necessity removed, way back in groff 1.10 (November 1995).  It
	was relevant only to GCC from versions 2.0 to 2.2.2 (all 1992).

2021-08-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Refactor `font::scan_papersize()`.

	* src/libs/libgroff/font.cpp (font::scan_papersize): Ensure
	successful return value of `fgets()` before attempting to parse
	string for paper format.  Convert `test_file` to Boolean and
	rename to `attempt_file_open`.  Quiets GCC `-Wunused-result`
	warning.

2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Apply naming convention.

	* tmac/tests/e_footnotes_work_with_columns.sh: Rename from...
	* tmac/tests/e_footnotes-work-with-columns.sh: ...to this.
	* tmac/tmac.am (tmac_TESTS): Update.

2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an.tmac (IP): Make code more accessible by using a
	Boolean operator rather than an arithmetic one (assembly
	language programmers are comfortable with the interchangeability
	of subtraction and comparison, but not everyone is).

2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	groff(7): Document more escapes.

	* man/groff.7.man (Escape short reference): Document
	`\[charNNN]`, `\[uNNNN]`, `\[uNNNN_NNNN...]` escape sequences.
	Revise descriptions of `\O0` and `\O1` escape sequences.
	Document `\O2`, `\O3`, `\O4`, and `\O5` escape sequences.

2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	groff(7): Fix bug in `\?` escape rendering.

	* man/groff.7.man (ESC?): Fix bug in page-private macro: the
	question mark that ends this uniquely-syntaxed escape sequence
	was not shown with the mandatory escape character before it.
	Problem dates back at least to commit 41b0e794, 19 February
	2007, but possiby to f790bc7a9, 6 January 2002.

2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[docs]: Elaborate macro definition discussion.

	Fixes <https://savannah.gnu.org/bugs/?57944>.  Thanks to Dave
	Kemper for the report.

2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tests]: Make robust against $GROFF_TYPESETTER settings.

	* src/roff/groff/tests/\
	use_point_size_escape_with_single_digit_arg.sh:
	* src/roff/nroff/tests/verbose_option_works.sh:
	* tmac/tests/s_IP-indents-using-paragraph-type-size.sh: Export
	an empty $GROFF_TYPESETTER to the environment.

	Fixes <https://savannah.gnu.org/bugs/?60140>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Treat an empty $GROFF_TYPESETTER as unset.

	* src/libs/libgroff/device.cpp (device_init::device_init): Test
	both returned pointer from `getenv()` and, if that's not null,
	the first character of the string for nullity before assigning
	it to `device`.

	Fixes <https://savannah.gnu.org/bugs/?61068>.

2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff]: Rename font class member variable.

	* src/include/font.h (font class): Rename `unscaled_charwidths`
	member variable to `use_unscaled_charwidths`: since it is a
	Boolean, make it read more like a logical predicate.

	* src/libs/libgroff/font.cpp (font::get_width, font::load_desc):
	* src/libs/libgroff/fontfile.cpp (font class): Update
	initialization and assignments.

2021-08-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (get_copy): Demote integer arguments
	to Booleans and use Boolean literals for default values.  Rename
	`defining` to `is_defining`.
	(get_char_for_escape_name, do_define_macro): Update call sites
	that use non-default arguments to use Boolean literals and
	comments to document what's being requested.

2021-08-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (DOC_GROFF_ONLY): Stop running groff in unsafe
	mode; no documents (in _this_ directory) appear to require it.

2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grn]: Fix code style issues.

	* src/preproc/grn/hgraph.cpp:
	* src/preproc/grn/hpoint.cpp:
	* src/preproc/grn/main.cpp:
	* src/preproc/grn/hdb.cpp: Drop use of `register` storage class.

	Fixes <https://savannah.gnu.org/bugs/?57733>.  Thanks to Bjarni
	Ingi Gislason for the report and a suggested patch.

	* src/preproc/grn/hgraph.cpp (len, HGPrintElt, picurve):
	* src/preproc/grn/hdb.cpp (DBRead): Wrap long lines.

	* src/preproc/grn/hgraph.cpp: Rename function from
	`Paramaterize` to `Parameterize`.
	(HGCurve): Update call site.

	* src/preproc/grn/main.cpp (add_file): Drop redundant cast in
	`realloc()` call.
	(conv, interpret): Use standard English in diagnostic messages.

2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/hdb.cpp: Perform more input validation.
	Improve diagnostics by taking advantage of libgroff
	infrastructure and tracking the line number of the input file.
	Add global `lineno`.
	(DBRead): Increment `lineno` after reading newlines from input.
	Call `error_with_file_and_line()` instead of `error()`.  If
	input reports a negative length for the text (string) to follow
	in the file, exit with a fatal diagnostic.  Check for EOF while
	reading text string.
	(DBGetType): Convert `fprintf()` call for warning diagnostic to
	`warning_with_file_and_line()`.
	(DBRead, DBGetType): Add contextual information to diagnostic
	messages.

	Fixes <https://savannah.gnu.org/bugs/?61043>.  Thanks to
	Savannah user eqkws for the report.

2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/main.cpp (usage): Update usage message.

2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grn]: Add and use `malloc()` wrapper.

	* /src/preproc/grn/main.cpp (grnmalloc): New function takes
	argument of `size_t` type and constant string argument to
	describe what is being allocated.  Return non-null pointer from
	`malloc()`, otherwise call `fatal()`, describing what was being
	allocated and the problem reported by the system.

	* src/preproc/grn/hdb.cpp (DBCreateElt):
	* src/preproc/grn/hpoint.cpp (PTMakePoint):
	* /src/preproc/grn/main.cpp (main, interpret): Migrate
	`malloc()` callers to `grnmalloc()`.

2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/hdb.cpp (DBRead): Check return value of
	`sscanf()` and call `fatal()` if no conversions succeeded.  The
	blithe discard of a useful return value is bad enough, but this
	one took place inside a do-while such that it could loop
	forever trying fruitlessly to parse two doubles out of strings
	that didn't contain them (the loop never checked the EOF status
	of the file stream from which it was reading, and relied on
	`fgets()` to keep advancing the stream pointer).  Discovered
	while root-causing Savannah #61043.

2021-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	Resolve compiler warnings relating to format string security and
	ISO C++98 conformance.

	* src/preproc/eqn/delim.cpp (define_extensible_string):
	* src/preproc/pic/pic.ypp (do_sprintf): Use #pragma to silence
	GCC "format-nonliteral" warning and explain why our usage is
	safe in a comment.

	* src/preproc/preconv/preconv.cpp (detect_file_encoding): Use
	`l` modifier to `%u` `fprintf()` conversion instead of `z`, and
	cast return values of `size_t` to unsigned long; "ISO C++98
	does not support the ‘z’ gnu_printf length modifier" (it doesn't
	support `ll` either).  N.B. this is debugging output only.

	* src/roff/groff/groff.cpp (synopsis):
	* src/roff/troff/input.cpp (usage): Repeat variadic argument for
	`%s` conversion in `fprintf()` call because "ISO C++98 does not
	support %n$ operand number formats".

	* src/roff/troff/env.cpp: Initialize adjustment and hyphenation
	mode enums without commas at the end of the enumeration lists.

2021-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Clean up the interface between `an-footer` and `BT`, and
	HTML header and footer suppression generally.  Move
	responsibility for checking the `ps4html` register from the
	latter to the former.  This is not something a `BT` redefiner
	{see groff_man(7)} should have to worry about.

	* tmac/an.tmac (BT): Drop test of `ps4html` register and early
	return.
	(an-header, an-footer): Return immediately if
	`an-suppress-header-and-footer` is true.  Remove conditional on
	`an-is-output-html`.
	(initialization): Define `an-suppress-header-and-footer`
	register; true if `an-is-output-html` is true, or if `ps4html`
	is defined.

2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (get_resolution): Unbrace a
	single-statement `while` loop per prevailing coding style.  Add
	comments noting how we aren't parsing DESC files _precisely_ as
	our documentation specifies.

2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	Convert font class `int` members to `bool` where appropriate.

	* src/include/font.h (font class): Demote integers to Booleans
	and use Boolean literals where possible.  Rename some member
	variables to look like logical predicates.
	  - contains()
	  - is_special()
	  - has_ligature()
	  - tcommand -> has_tcommand
	  - unscaled_charwidths
	  - pass_filenames
	  - use_charnames_in_special
	  - is_unicode
	  - special (private)
	* src/libs/libgroff/font.cpp (font::font): Construct object
	using Boolean literal.
	(font::contains):
	(font::is_special):
	(font::has_ligature): Convert return type to `bool`.
	(font::load):
	(font::load_desc): Assign to member variables using Boolean
	literals.
	* src/libs/libgroff/fontfile.cpp: Initialize appropriate globals
	using `bool` type and Boolean literals.
	* src/roff/troff/troff.h:
	* src/roff/troff/input.cpp (main):
	* src/roff/troff/node.cpp (troff_output_file::put_char_width):
	Rename `tcommand_flag` to `device_has_tcommand` to suggest a
	logical predicate, and to emphasize the formatter's concern with
	what the output device can accept in the intermediate output
	language.
	* src/roff/troff/input.cpp: Initialize `device_has_tcommand`
	global using `bool` type and Boolean literal.

2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Clarify breadth of application of `ll` macro.

	* doc/meref.me: Document application of .ll macro only to the 3
	environments that me(7) uses, not any the user might create.
	* tmac/e.tmac (@C, xl, ll): Update comments.

	Fixes <https://savannah.gnu.org/bugs/?55060>.

2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #58736.

	* tmac/tests/e_footnotes_work_with_columns.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (bc): Fix problem with multiple columns on long
	pages.  Space to the next page location trap, not 24 inches.
	Thanks to Dave Kemper and Bjarni Ingi Gislason for help tracking
	this bug down.

	Fixes <https://savannah.gnu.org/bugs/?55081>.

2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #55081.

	* tmac/tests/e_columns-work-on-long-pages.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-08-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Localization): Add section.

2021-08-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/cs.tmac:
	* tmac/de.tmac:
	* tmac/fr.tmac:
	* tmac/it.tmac:
	* tmac/sv.tmac: Update ms package localization to use an
	appropriate hyphenation mode for the `HY` register (the
	mode for the pattern files, plus 2 as is traditional in ms).

2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac (1c): Place comment escape sequence immediately
	after macro argument.  (When redefining a request, one needs to
	remember that request arguments are not parsed exactly as macro
	arguments are.)  Quiets "-w tab" warning.

2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Fix misleading documentation claim; gremlin(1) pictures
	cannot be included directly; they must be preprocessed with
	grn(1).

	* doc/meref.me:
	* tmac/groff_me.7.man: Replace "gremlin" with "grn".

2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_me.7.man: Document `n1` and `n2` macros.

2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[me]: Fix PS/n1 combination diagnostic spew and apparent logic
	error.

	* tmac/e.tmac (@h): Place comment escape sequence immediately
	after macro argument.  (When redefining a request, one needs to
	remember that request arguments are not parsed exactly as macro
	arguments are.)
	(n2): Prefix with `do` requests using long register names.
	(n2): Add macro-local register `|l` to store length of first
	argument.  Don't attempt to extract a substring beyond the
	bounds of its source, which produces a warning diagnostic.
	(&&): Define no-op macro for use as end macro in nested macro
	definition.
	(PS): Fix unbalanced-else diagnostic by changing `if` to `ie`.
	(PS): Initialize `PS_nm_cnt` register to 0 instead of relying on
	implicit definition.
	(PS): Prefix with `do` definition of long macro name.
	(PS): Indent call of end macro.
	(PS): Add comment after escaped space.
	(PS, PF): Prefix with `do` call of long macro name.

	Fixes <https://savannah.gnu.org/bugs/?61019>.

2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (do_line): Recognize `n1` and `n2` as
	characteristic me(7) macros.

2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_me.7.man: Document GF, IE, IF, IS, and PF macros.

2021-08-08  Dave Kemper <saint.snit@gmail.com>

	* tmac/e.tmac: Rename `PE` to `PF` but remove vertical spacing.
	(PE): New `PE` calls `PF` and then spaces as old `PE` did.

	Fixes <https://savannah.gnu.org/bugs/?60479>.

2021-08-06  Dave Kemper <saint.snit@gmail.com>

	* doc/meref.me: Improve documentation of image-inclusion macros.

	Fixes <https://savannah.gnu.org/bugs/?60478>.

2021-08-06  Dave Kemper <saint.snit@gmail.com>

	GNU pic recognizes two possible endings of a pic block: .PE or
	.PF.  This fact was documented in doc/pic.ms but not in the pic
	man page.  The minimal pic implementation provided by pic.tmac
	also did not include a .PF definition.

	* src/preproc/pic/main.cpp (main): Add dummy definition of `PF`
	macro.
	* tmac/pic.tmac (PF): Add macro that performs indentation only.
	(PE): Call PF for indentation.

	* doc/pic.ms (Interface to [gt]roff/How Scaling is Handled):
	* src/preproc/pic/pic.1.man (Description, Options): Mention `PF`
	in addition to `PS` and `PE`.

	Fixes <https://savannah.gnu.org/bugs/?60504>.

2021-08-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/refer-ms.tmac:
	* tmac/s.tmac (fn@init, @PP): Rename strings
	`fn@sup-{start,end}` to `fn@mark-{start,end}`.  This makes it
	more clear that the strings are brackets for the footnote
	marker, and not so much to do with the note text.  Further, in
	nroff mode, they aren't superscripts at all, but bracket glyphs.

2021-08-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.1.man (Examples): Add section.

	Addresses part of <https://savannah.gnu.org/bugs/?57667>.

2021-08-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/refer-ms.tmac: Use `fn@sup-{start,end}` instead of
	`par@sup-{start,end}` when setting refer(1) citation labels.
	This improves the appearance of the default labels on nroff
	devices.  Continues commit caeede07, 1 May.

2021-08-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tman/an-ext.tmac (EX, EE): Stop manipulating hyphenation.
	It's redundant since disabling fill mode already prevents
	automatic breaking, and therefore automatic hyphenation.
	* tmac/groff_man.7.man.in (Description/Document structure
	macros) <EX, EE>: Update documentation.

2021-08-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Update authorship credits.  I appear
	to have removed or refactored all of the "device" (recte: macro
	package) inference logic adapted from Ralph Corderoy's grog.sh;
	see commit 3617f42048f54cc3f0adc282ee3b9e481c75ebd5, 13 June
	2014.

2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Refactor through relocation and
	renaming.  Move several global objects into subroutines.
	  - `@request` -> `&do_line`
	  - `@macro_ms`, `@macro_man`, `@macro_man_or_ms` ->
	    `&infer_man_or_ms_package`
	  - `@main_package` -> `&construct_command`
	Rename some objects for clarity.
	  - `%Groff` -> `%score`
	  - `@filespec` -> `$input_file`
	Delete unused object.
	  - `@standard_macro`
	Add comments.

2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (do_line): When matching macro/request
	names, accept any non-whitespace character (Perl: \S) instead of
	just a word-constituent character (Perl: \w), since roff
	identifiers can contain unusual characters (refer(1) and
	groff_me(7) illustrate some real-world cases).

2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Refactor macro package inference.
	  - Stop manually populating `Groff` hash.  (It's itching for a
	    rename.)
	  - Stop calling now-dead subroutine `infer_macro_packages`.
	(do_line): Always store the names of all macros called to the
	`Groff` hash, incrementing it.  Now it's a proper scoreboard.
	Populate `inferred_main_package` from here upon encountering
	characteristic (i.e., uniquely named) macros of each package.
	Bug fix: drop "SP" from list of characteristic mom(7) macros;
	it's shared with mm(7).
	(infer_man_or_ms_package): Update comment.  Return 0 (false) if
	document appears to be "raw", using no full-service macro
	package.
	(infer_macro_packages): Delete; do_line() does this work.

2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Refactor preprocessor inference.
	  - Add new list, `inferred_preprocessor`.
	  - Drop preprocessor-related keys from `Groff` hash.
	  - Drop scalar `inside_tbl_table`.
	(do_line): Set up hash `preprocessor_for_macro`.  Detect
	preprocessor macros the way the preprocessors do, explained in a
	comment.  Respect AT&T compatibility mode when doing so.  Build
	list of inferred preprocessors.  This replaces the extensive and
	gaseous series of `if` statements that manipulated the `Groff`
	hash.
	(infer_preprocessors): Completely replace.  Set up a hash
	`option_for_preprocessor` mapping preprocessor names to groff
	options (where applicable).  Append to `command` and
	`preprocessor` lists as appropriate.  Sort the preprocessor
	options so they don't move around in the argument list depending
	on the order of their macros' appearance in the input.

	* src/utils/grog/tests/smoke-test.sh: Update test cases to
	expect preprocessor options to show up in sorted order.

2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Drop dead code.  Delete global
	hash `preprocs_tmacs`, unused since commit b0de53c9, 30 June.

2021-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix code nit.

	* src/preproc/html/pre-html.cpp (get_image_generator):
	Type-qualify `keyword_len` as `const` to encourage the compiler
	to compute this value (the length of a string literal) at build
	time.

2021-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Slightly refactor.

	* src/roff/troff/node.cpp: Add static `image_filename_len` to
	store length of cached image file name, so we don't wastefully
	recompute its length every time one is re-used.
	(suppress_node::tprint): Compute image file name length only
	when saving a new image file name.  Use saved length in later
	expressions.
	(min): Drop unused inline function.

2021-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Fix regression (breaking important pdfmark/pdfroff
	features) caused by my commit
	e876d4bfd193abb9a7d1fb6e76519349bded482a, 27 July.  An empty
	image file name is in fact semantically valid when writing a
	bounding box; pdfmark uses such boxes to frame hyperlinks.
	Avoid null pointer dereference by initializing `image_filename`
	to an empty string literal.  Thanks to Tadziu Hoffman and Keith
	Marshall for their patient explanations.

2021-07-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Refactor some internal functions.

	* src/roff/troff/node.cpp: Rename two functions that have only
	one caller.
	  - get_reg_int -> get_register
	  - get_reg_str -> get_string
	We now have:
	(get_register, get_string): Use `assert()` aggressively because
	these are deeply internal and validation is imperative.  Get rid
	of diagnostic messages (one of which perpetuated the dubious
	"number register" nomenclature) accordingly.
	(fetch_register): Also rename `prev_value`, misleadingly
	specific and seemingly copy-and-pasted out of a context where an
	auto-increment or -decrement might have been applied.  It's just
	the `value`.
	(suppress_node::tprint): Update call site.

2021-07-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Refactor `get_value` member functions.  Given their
	names and popular "getter/setter" paradigms from many OO
	languages, the return type is misleading.  Change it from `int`
	to `bool` since it returns only a success/failure status and
	modifies an argument (passed by reference) to deliver the
	requested data.

	* src/roff/troff/reg.h (reg, variable_reg):
	* src/roff/troff/div.cpp (page_offset_reg, page_length_reg)
	(vertical_position_reg, high_water_mark_reg)
	(distance_to_next_trap_reg, page_number_reg, no_space_mode_reg):
	* src/roff/troff/env.cpp (int_env_reg, vunits_env_reg)
	(hunits_env_reg, horizontal_place_reg):
	* src/roff/troff/input.cpp (writable_lineno_reg):
	* src/roff/troff/reg.cpp (reg, number_reg, variable_reg): Update
	class and member function definitions to reflect the new type.
	Update member function definitions to return appropriate Boolean
	literals instead of 0 and 1.

2021-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix Savannah #60981.  Refactor device description
	file handling and make it more robust.  Make pre-grohtml's
	-F option work as documented and honor device description file
	semantics documented in groff_font(5).

	* src/preproc/html/pre-html.cpp: Store partial filespecs of HTML
	and PostScript device files in constant strings.
	(get_resolution): Initialize `res` to zero.  Only `free()` the
	pointer `pathp` if `open_file()` succeeded (populating it).
	Stop checking for valid `sscanf()` conversions of an integer to
	store in `res`, and don't return early.  Instead process the
	whole DESC file; per our Texinfo manual and groff_font(5),
	"Later entries in the file ... override previous values."
	(get_image_generator): Add new function, paralleling
	`get_resolution()`, replacing open-coded logic in `main()`.
	Only the body of the `while` loop significantly differs.
	Instead of using `sscanf`, process the input character by
	character matching the keyword and {1,} spaces or tabs
	after it.  Whatever follows in `linebuf` must be the program
	name.
	(imageList::createPage): Add `assert()` to cause failure if an
	empty image generator program gets this far, because it creates
	repeated messes if it does.  (Something isn't checking exit
	statuses.)
	(main): Condense `image_gen` collection to a function call, a
	null pointer check, and a fatal diagnostic.  Add a sanity check
	and a fatal diagnostic if the PostScript resolution is garbage.
	{It's initialized to -1 and `get_resolution()` will return 0 if
	it doesn't find one.}

	Fixes <https://savannah.gnu.org/bugs/?60981>.

2021-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Delete or rename `debug` symbols to avoid clash with
	new `debug` function in libgroff.

	* src/preproc/html/pre-html.cpp: Update a comment to refer to
	"debugging" mode.  Rename static global from `debug` to
	`debugging`.
	(html_system, imageList::createPage, imageList::createImage,
	print_args, char_buffer::do_html, char_buffer::do_image,
	scanArguments): Update uses of static global.

	* src/preproc/html/pushback.cpp:
	* src/preproc/html/pushback.h: Delete unused `debug` member
	variable.

2021-07-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh: Fix straggling use of `$1`, which
	might not have a clear meaning in some shells after being
	shifted (what if we just shifted the last argument?).  Also
	`continue` after processing a (groff) option argument, as we
	should make no attempt to parse it.

2021-07-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_suppress): Recast diagnostic
	messages for clarity, to communicate in terms of what the
	escape sequence _is_, and to quote literals expected as input.
	* src/roff/troff/node.cpp (suppress_node::tprint): Recast
	diagnostic to prevent misinterpretation of image "description"
	as being HTML IMG tag alt text or something like that.
	Unfortunately, the new language speaks in terms of internal
	implementation details ("grohtml-info"), but at least that way
	it's easier for a user to decide if they care about it.

2021-07-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Avoid using sprintf() with user-controlled format
	string.

	* src/preproc/html/pre-html.cpp (makeFileName): Add comment
	noting need for implementation synchrony between this function,
	which generates \O5 escape sequences, and troff's
	suppress_node::tprint member function, which interprets them.
	* src/roff/troff/node.cpp: Rename 2 static globals for clarity.
	  - `last_image_filename` -> `image_filename`
	  - `last_image_id` -> `subimage_counter`
	(suppress_node::tprint): Set up the buffer for image file name
	to be written using a constant rather than an embedded literal.
	Unconditionally initialize the buffer with a string terminator,
	so there is no chance of a read from uninitialized storage.
	Drop unused code involving `tem`.  Drop stale comments.  Clarify
	comment: an `image_filename` doesn't _always_ contain a format
	string, only sometimes.  Replace use of `sprintf` with manual
	construction of a new image filename string.  There are two
	cases, one where a format string {presently "%d"} is present,
	and one where it is not.  If it is present, locate it
	{`percent`}.  This means a limited/bounded image ("subimage") is
	being processed; increment the subimage counter.  Write a new
	image file name preserving the parts before and after "%d" (the
	"prefix" and "suffix", and replacing only the middle, using
	`sprintf` with the subimage counter and the (string literal)
	format.  Be mindful of string bounds and memory allocation,
	issuing diagnostics or aborting as necessary.  If the image file
	name does _not_ contain a format string, but needs only to be
	copied, do that (`strcpy`), again instead of using `sprintf`.

	Fixes <https://savannah.gnu.org/bugs/?60977>.

2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix Savannah #60971.

	* src/preproc/html/pre-html.cpp (makeFileName): Consistently put
	a dash at the end of `macroset_template` whether the image file
	name stem is user-supplied or the default.  Stop adding the dash
	before the image number in `image_template` instead.  This makes
	the image file name format reliable whether the image needs to
	be subdivided (eqn) or not (tbl).

	Fixes <https://savannah.gnu.org/bugs/?60971>.

2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Reduce noise to standard error stream.

	* src/preproc/html/pre-html.cpp (imageList::createImage): Fix
	apparent oversight: `EXE_EXT` was not being applied to the
	second of three commands being run in a pipeline (did Windows
	users notice?).  Also issue (undocumented!) `-quiet` option to
	`pnmtopng` to shut up its commentary about counting colors.

2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Stop discarding standard error output.

	* src/preproc/html/pre-html.cpp (html_system): Stop sending the
	standard error stream to /dev/null; this just makes debugging
	harder, and doesn't produce much more output for well-formed
	input documents.  Rename `save_stdout` to `saved_stdout`.

2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Fix misspelled variable.

	* src/preproc/html/pre-html.cpp: Rename `IMAGE_BOARDER_PIXELS`
	to `IMAGE_BORDER_PIXELS`.

2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[libgroff, troff]: Add debug diagnostic level.

	* src/include/error.h: Declare functions
	`debug_with_file_and_line` and `debug`.
	* src/libs/libgroff/error.cpp: Add `DEBUG` to enum `error_type`.
	(do_error_with_file_and_line): Add case for `DEBUG` in switch.
	(debug, debug_with_file_and_line): Add new functions.

	Do the same for troff since it has a private implementation of
	the diagnostic functions (thanks to `output_warning()`).

	* src/roff/troff/input.cpp: Add `DEBUG` to enum `error_type`.
	(do_error_with_file_and_line): Add case for `DEBUG` in switch.
	(debug, debug_with_file_and_line): Add new functions.

2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/hpftodit/hpftodit.cpp (hp_msl_to_ucode_name)
	(unicode_to_ucode_name): Hush "format nonliteral" compiler
	warnings by using a preprocessor-defined string literal as an
	sprintf() format string instead of a C++ variable that just
	compared identically to the same thing.

2021-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/hpftodit/hpftodit.cpp (show_symset): Prevent
	sprintf() from overunning a static buffer.  Thanks to Bjarni
	Ingi Gislason for the report.  Resize buffer to be large enough
	to accommodate a 64-bit unsigned int type formatted as decimal.
	Also add assert() before the sprintf() to abort if the int type
	is even larger than that.  Use "%u" conversion instead of "%d"
	since the quantity is unsigned.
	(hp_msl_to_ucode_name): Similar, but for a signed int.
	(unicode_to_ucode_name): Similar, but for a signed int formatted
	as (unsigned) hexadecimal.

	Fixes <https://savannah.gnu.org/bugs/?60964>.

2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh: Refactor, mostly by relocation.  Move
	locale character set inference logic so that we only run it if
	we have to (`-T` option was invalid or not given and
	`GROFF_TYPESETTER` was not set in the environment or invalid).
	Initialize `T` variable as empty.

2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh: Use Version 7 Unix sh-compatible form
	of parameter expansion; per the GNU Autoconf manual[1], "[o]ld
	BSD shells, including the Ultrix sh, don't accept the colon for
	any shell substitution, and complain and die."  This is also the
	form of such substitutions used elsewhere in the script, so they
	should be mutually consistent.

	[1] https://www.gnu.org/software/autoconf/manual/autoconf-2.60/\
	html_node/Shell-Substitutions.html

2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh: Slightly refactor.  Rename formerly
	unused loop index variable from `i` to `arg` to leverage it in a
	later diagnostic message without a separate definition.  Inside
	the loop, expand `arg` instead of positional parameter 1, the
	meaning of which is less obvious after the parameter list is
	shifted by the new `is_option_argument_pending` logic (commit
	2b955c57, 20 July).

2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.1.man (Options) <-S>: Fix error: `-S`
	sets safer mode (redundantly) but is not passed to pic and troff
	as was claimed.

2021-07-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/number.cpp (parse_term): Tweak diagnostic
	messages.  When a left operand to a binary operator is empty,
	report the operator in question (helpful for string
	interpolations in complex expressions).  When handling input
	scaling indicators, drop word "this" from "this context", since
	the parser's context might not be clear from a file name and
	line number.  Say "scaling indicator" instead of "scale
	indicator".
	(parse_expr, parse_term): Rename function parameter from
	`scale_indicator` to `scaling_indicator`.

2021-07-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (define_color): Tweak warning
	diagnostics for clarity.  Only one value is expected when
	defining a color in the `gray` color space.  Quote recognized
	color space names when complaining of an unknown one.

2021-07-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	[nroff]: Pass a supplied `-c` option to groff.  While at present
	this does little more than `-P-c` already achieves, that might
	not be true forever.  Further, there is a distinction between
	ignoring color-related requests in groff input documents and
	ignoring color-related commands in device-independent output.
	This distinction would make it unwise to adapt `-c` to any other
	purpose in nroff in the future.

	* NEWS: Update item from commit dd725dce, 10 February 2020.
	* src/roff/nroff/nroff.sh: Pass `-c` option to groff in addition
	to synthesizing a `-P-c` option (for grotty) when it is seen.
	* src/roff/nroff/nroff.1.man (Options): Document `-c` as an
	option recognized by troff(1).

2021-07-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[nroff]: Support space between option flags and their arguments.

	* src/roff/nroff/nroff.sh: Add new `is_option_argument_pending`
	flag to add an additional state to the option parser.  Set it if
	an argument-requiring option is encountered with no abutting
	argument.  If it is set when a new argument is encountered,
	absorb the argument into the groff option list and clear the
	flag.  Modernize script in a couple of other ways.
	  - Exit with status 2 upon usage errors so that this condition
	    is easily distinguished from a groff abort (which exits with
	    status 1).
	  - Test shell variables for non-nullity with test(1) -n
	    operator instead of a string comparison.
	* src/roff/nroff/tests/verbose_option_works.sh: Test correct
	construction of groff command using this input form.
	* src/roff/nroff/nroff.1.man (Options): Add spaces between
	option flags and option arguments.  Sync metasyntactic variable
	names with groff(1) while we're at it.
	(Description): Drop sentence warning of whitespace prohibition.
	(Exit status): Add new section.

	Fixes <https://savannah.gnu.org/bugs/?60943>.

2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (main): Emit error diagnostic if `-d`
	or `-r` option is given a malformed argument.  This prevents a
	string or register with an empty name from being created.

	Fixes <https://savannah.gnu.org/bugs/?60935>.

2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh:
	* src/roff/troff/input.cpp (usage): Use "dev" as metasyntactic
	variable name for -T option argument to achieve consistency with
	our other documentation.

2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	[groff]: Comment out vestiges of gideal support.  It would be
	lovely to have, but no free (and GPL-compatible) implementation
	has showed up after decades of waiting.  Production of the
	original was a Ph.D. thesis.  Excited by de Moivre's theorem?
	Take a stab at it.

	* src/roff/groff/groff.cpp (main): Comment out effect of `-J`
	option.  It remains recognized, but silently ignored (instead of
	attempting to execute a nonexistent preprocessor).
	(synopsis): Add comment reminding us to document the option if
	we ever get the support.
	(help): Comment out documentation of option.

2021-07-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[[gnt]roff]: Make usage messages more accurate.

	* src/roff/groff/groff.cpp (synopsis): Drop `-h` and `-v` from
	normal operation synopsis.  Sort options in en_US lexicographic
	order.  Tighten presentation of alternate usage forms.
	(help): Document longer forms of `-d` and `-r`.
	* src/roff/nroff/nroff.sh: Report `$prog` instead of "nroff"
	literal.  Refer to `-P` option argument as "arg" instead of
	"opt", for consistency with groff usage message.  Use opposite
	case from option letter for option argument.
	* src/roff/troff/input.cpp (usage): Put brackets around options.
	Sort options in en_US lexicographic order.  Drop `-v` from
	normal operation synopsis.  Use opposite case from option letter
	for option argument.  Put operand name in capitals.  Set valid
	usage forms on one physical line each (see 89648fb4, 5 June).
	Add synopsis line for alternate usage forms.

2021-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Refactor environment initialization, switching, and
	copying.

	* src/roff/troff/env.cpp: Rename struct `env_list` to
	`env_list_node` since it describes a node of a singly-linked
	list.  Remove constant `NENVIRONMENTS` and array `env_table`.
	Add static symbol `default_environment_name` to replace string
	literal.
	(init_environments): Stop initializing `curenv` through
	`env_table`.  Use `default_environment_name` for that
	initialization and add the default environment to
	`env_dictionary`.
	(environment_switch): Simplify.  Shorten "dummy environment"
	diagnostic message.  Stop creating an integer-named
	environment inside the `env_table` array, only falling through
	to use the `env_dictionary` if the named environment is not a
	valid integer or if the array is full.  Instead use
	`env_dictionary` always.  Drop no longer needed `pop`
	quasi-Boolean integer with extra state to suppress environment
	stack underflow errors.  Instead report the error if underflow
	occurs, regardless of any other circumstance.
	(environment_copy): Simplify.  Stop searching the `env_table`
	array for an environment to copy from, only falling through to
	use the `env_dictionary` if the named environment is not a valid
	integer or if the array is full.  Instead search
	`env_dictionary` always.  Emit "no environment specified to copy
	from" diagnostic only if the `evc` request is given no argument.
	If the source environment to copy from is given but not found,
	emit a new diagnostic naming the nonexistent environment.  Fix
	bug: stop returning early if no copying could be done; instead
	fall through to the end of the function, which calls
	`skip_line()` and prevents anything on the remainder of the
	{invalid} control line from being interpreted.  Problem dates
	back to commit da3b7137, 6 March 2000 (groff 1.16).

	Fixes <https://savannah.gnu.org/bugs/?60913>.

2021-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/evc_produces_no_output_if_invalid.sh:
	  Regression-test Savannah #60913.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2021-07-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Update English hyphenation patterns.

	* NEWS: Add item.
	* tmac/hyphen.en: Update file using `hyph-en-us.tex` patterns
	file from the TeX hyph-utf8 project.
	* tmac/hyphenex.en: Remove explicit hyphenations for words that
	no longer require them when using the new patterns.  Add one
	item scraped from an erratum comment in hyphen.en
	{"dem-o-crat"}.

	The new patterns likely _will_ change the automatic hyphenation
	break points of your English documents.  Here is a sample of
	affected words found within groff's own documentary corpus.

	OLD			NEW
	===			===
	ar‐range‐ment		arrange‐ment
	col‐umns		columns
	con‐struc‐ted		con‐structed
	cus‐tom‐ized		cus‐tomized
	def‐i‐ni‐tions		de‐f‐i‐n‐i‐tions
	der‐i‐va‐tions		de‐riva‐tions
	hy‐phen‐a‐tion		hy‐phen‐ation
	ma‐te‐rial		ma‐te‐r‐ial
	Mi‐cro‐soft		Mi‐crosoft
	pipe‐lines		pipelines
	post‐pro‐ces‐sors	post‐proces‐sors
	pro‐cessed		processed
	pro‐cesses		processes
	spa‐ces			spaces
	Wer‐ner			Werner

2021-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Add unit test for `substring` request.

	* src/roff/groff/tests/substring_works.sh: Do it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2021-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Remove compatibility mode save registers after using
	them.

	* tmac/an.tmac:
	* tmac/andoc.tmac:
	* tmac/cp1047.tmac:
	* tmac/devtag.tmac:
	* tmac/ec.tmac:
	* tmac/fallbacks.tmac:
	* tmac/latin1.tmac:
	* tmac/latin2.tmac:
	* tmac/latin5.tmac:
	* tmac/latin9.tmac:
	* tmac/papersize.tmac:
	* tmac/pdfpic.tmac:
	* tmac/psold.tmac:
	* tmac/pspic.tmac:
	* tmac/trace.tmac:
	* tmac/unicode.tmac: Do it.

	* doc/groff.texi (Implementation Differences):
	* man/groff_diff.7.man (Implementation Differences): Illustrate
	doing so in relevant examples.

2021-07-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/troffrc: Load the English localization file `en.tmac` by
	default, instead of dealing with hyphenation language and
	patterns directly in this file.  (This also replaces a
	localization-determination mechanism that was never part of a
	groff release.)

	* src/roff/groff/tests/initialization_is_quiet.sh:
	* src/roff/groff/tests/localization_works.sh: Rewrite to use
	explicit macro file loading localization mechanism.

2021-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	Move core man(7) implementation to an.tmac.

	* tmac/an.tmac: Delete andoc-sourcing wrapper.

	* tmac/an-old.tmac: Rename...
	* tmac/an.tmac: ...to this.

	* tmac/tests/an-old_AT-and-UC-footer-saved-and-restored.sh:
	* tmac/tests/an-old_CS-register-off.sh:
	* tmac/tests/an-old_CS-register-on.sh:
	* tmac/tests/an-old_CS-register-unspecified.sh:
	* tmac/tests/an-old_CT-register-off.sh:
	* tmac/tests/an-old_CT-register-on.sh:
	* tmac/tests/an-old_CT-register-unspecified.sh:
	* tmac/tests/an-old_FT-bad-value-should-not-trash-titles.sh:
	* tmac/tests/an-old_LL-init-sanely.sh:
	* tmac/tests/an-old_TH-repairs-ad-damage.sh:
	* tmac/tests/an-old_TH-repairs-hy-damage.sh:
	* tmac/tests/an-old_TS-do-not-keep-tables-when-cR-set.sh:
	* tmac/tests/an-old_X-register-works.sh:
	* tmac/tests/an-old_avoid-two-font-denial-of-service.sh:
	* tmac/tests/an-old_no-break-after-short-paragraph-tags.sh:
	* tmac/tests/an-old_page-footers-present.sh:
	* tmac/tests/an-old_page-header-has-current-data.sh:
	* tmac/tests/an-old_title-abbreviation-works.sh: Rename...

	* tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh:
	* tmac/tests/an_CS-register-off.sh:
	* tmac/tests/an_CS-register-on.sh:
	* tmac/tests/an_CS-register-unspecified.sh:
	* tmac/tests/an_CT-register-off.sh:
	* tmac/tests/an_CT-register-on.sh:
	* tmac/tests/an_CT-register-unspecified.sh:
	* tmac/tests/an_FT-bad-value-should-not-trash-titles.sh:
	* tmac/tests/an_LL-init-sanely.sh:
	* tmac/tests/an_TH-repairs-ad-damage.sh:
	* tmac/tests/an_TH-repairs-hy-damage.sh:
	* tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh:
	* tmac/tests/an_X-register-works.sh:
	* tmac/tests/an_avoid-two-font-denial-of-service.sh:
	* tmac/tests/an_no-break-after-short-paragraph-tags.sh:
	* tmac/tests/an_page-footers-present.sh:
	* tmac/tests/an_page-header-has-current-data.sh:
	* tmac/tests/an_title-abbreviation-works.sh: ...to these.

	* tmac/tmac.am (TMACNORMALFILES): Remove an-old.tmac.
	(tmac_TESTS): Reflect renames of test files above.
	(tmac/stamp-wrap): Macro-source `an.tmac` in the man wrapper.

	* tmac/andoc.tmac: Refer to (and macro-source) an.tmac.
	* tmac/man.tmac: Macro-source `an.tmac`, not `andoc.tmac`.
	* tmac/tests/andoc_flush-between-packages.sh: Call groff with
	`-mandoc` option instead of `-man`.  Henceforth, if you want the
	andoc wrapper, you have to ask for it.

	* tmac/an.tmac: Drop "-old" nomenclature.

	* PROBLEMS:
	* doc/groff.texi (man):
	* tmac/man.local: Update documentation appropriately.

	* NEWS: Add item.

	* man/groff_tmac.5.man (Macro packages/man pages):
	* src/roff/groff/groff.1.man (Usage/Macro packages): Update
	discussion of an, doc, and andoc.
	* tmac/groff_man.7.man.in (Files): Update descriptions of
	an.tmac, andoc.tmac, man.tmac, and mandoc.tmac.

	Fixes <https://savannah.gnu.org/bugs/?60789>.

2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Slightly refactor.  Make the source code slightly more
	accessible by using a `bool` type for a function's default
	parameter used as a Boolean, and comment it at call sites where
	the default is overridden.

	* src/roff/troff/token.h (get_name, get_long_name): Change type
	of parameter from `int` to `bool` and default from 0 to `false`.
	* src/roff/troff/input.cpp (do_get_long_name)
	(empty_name_warning, get_name, get_long_name): Change type of
	parameter from `int` to `bool` in declarations and definitions.
	* src/roff/troff/column.cpp (column_justify):
	* src/roff/troff/div.cpp (diversion_trap):
	* src/roff/troff/env.cpp (environment_switch, environment_copy)
	(do_input_trap, set_hyphenation_language)
	(do_hyphenation_patterns_file):
	* src/roff/troff/input.cpp (define_color, composite_request)
	(do_define_string, do_define_macro, rename_macro, alias_macro)
	(chop_macro, do_string_case_transform, substring_request)
	(length_request, asciify_macro, unformat_macro, do_register)
	(device_macro_request, do_if_request, do_source)
	(ps_bbox_request, do_open, close_request, do_write_request)
	(write_macro_request, define_class, copy_file, vjustify)
	(transparent_file, do_macro_source):
	* src/roff/troff/node.cpp (font_translate, font_position, style)
	(get_fontno):
	* src/roff/troff/reg.cpp (define_number_reg, inline_define_reg)
	(alter_format, alias_reg, rename_reg): Update call sites.  Add
	(comment indicating meaning of parameter.

	Do similarly for token::delimiter() member function.

	* src/roff/troff/token.h (token::delimiter): Change type of
	parameter from `int` to `bool`, name from `warn` to `err` (to
	match definition and behavior in input.cpp) and default from 0
	to `false`.
	* src/roff/troff/input.cpp (token::delimiter): Change type of
	parameter from `int` to `bool` in definition.
	* src/roff/troff/input.cpp (do_expr_test, get_delim_number)
	(get_line_arg, read_size, do_register, read_draw_node):
	* src/roff/troff/reg.cpp (inline_define_reg): Update call sites.
	Add comment indicating meaning of parameter.

2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-footer): Remove string
	`an-outer-footer-text` after we're done with it.

2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	Remove the stripper script and its vestiges.

	* contrib/hdtbl/hdmisc.tmac:
	* contrib/hdtbl/hdtbl.tmac:
	* contrib/mom/om.tmac:
	* tmac/doc.tmac:
	* tmac/e.tmac:
	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff:
	* tmac/mdoc/doc-syms: Remove `%beginstrip` comment.

	* tmac/strip.sed: Delete.

	* tmac/tmac.am (EXTRA_DIST): Stop shipping `strip.sed`.

	Fixes <https://savannah.gnu.org/bugs/?55091>.

2021-07-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	Skip the stripper, part 3/3 (mdoc).

	* tmac/doc-old.tmac-u:
	* tmac/doc.tmac-u:
	* tmac/mdoc/doc-common-u:
	* tmac/mdoc/doc-ditroff-u:
	* tmac/mdoc/doc-nroff-u:
	* tmac/mdoc/doc-syms-u: Rename these...

	* tmac/doc-old.tmac:
	* tmac/doc.tmac:
	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff:
	* tmac/mdoc/doc-syms: ...to these.

	* tmac/tmac.am (TMACNORMALFILES): Add `doc-old.tmac` and
	`doc.tmac`.
	(TMACUNSTRIPFILES, TMACSTRIPFILES): Delete variables.
	(dist_tmac_DATA): Drop `$(TMACUNSTRIPFILES)`.
	(nodist_tmac_DATA): Drop `$(TMACSTRIPFILES)`.
	(TMACMDOCSTRIPFILES): Rename...
	(TMACMDOCFILES): ...to this.
	(nodist_mdoc_DATA, MOSTLYCLEANFILES): Reflect above rename.
	(nodist_mdoc_DATA): Rename...
	(dist_mdoc_DATA): ...to this.
	(TMACMDOCUNSTRIPFILES): Delete variable.
	(EXTRA_DIST): Drop `$(TMACMDOCUNSTRIPFILES)`.
	($(TMACSTRIPFILES), $(TMACMDOCSTRIPFILES)): Drop targets.

	The portions above are based on a patch by Ingo Schwarze.

	* tmac/doc.tmac:
	* tmac/mdoc/doc-common:
	* tmac/mdoc/doc-ditroff:
	* tmac/mdoc/doc-nroff:
	* tmac/mdoc/doc-syms: Bracket macro definitions tightly with
	`eo` and `ec` requests since they were written under this
	assumption.  The files in general were also drafted under the
	assumption that they'd be stripped, so `eo` was in effect for
	broad swaths of the file including portions outside of any macro
	definition where comments were used.  But comments are expressed
	using the escape character!  So we got warnings about an
	undefined '\"' macro, and that was just the beginning of a
	wrecking ball of trouble that smashed through the
	implementation.  Some--but not all--string definitions (and
	appendments) needed to be bracketed with `eo` and `ec` as well,
	to delay interpolation of embedded string names that are not
	defined until macros interpolate them later.  I did what
	appeared necessary to pass our tests and keep -Tutf8 and -Tps
	renderings of tmac/groff_mdoc.7 from changing from their
	strip-influenced output.  Subtle bugs might linger, but some
	won't be the fault of the unstripping process.  (For instance,
	try provoking a usage message on the `Hf` macro.)

2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man pages]: Remove compatibility save register.

	* **/*.man*: Remove page-local compatibility save register after
	using it.

2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Simplify `mso` requests.

	* tmac/X.tmac:
	* tmac/Xps.tmac:
	* tmac/dvi.tmac:
	* tmac/html.tmac:
	* tmac/lbp.tmac:
	* tmac/lj4.tmac:
	* tmac/ps.tmac:
	* tmac/tty-char.tmac:
	* tmac/tty.tmac:
	* tmac/www.tmac.in: Move `mso` requests to be inside regions
	where compatibility mode is turned off.  I believe they were
	placed where they were because things didn't work when the
	compatibility mode register being saved was .C, rather than the
	.cp register introduced in commit 6a37bb5f, 17 April 2020.  Now
	the logic is less mysterious.  Also, remove the register used to
	save compatibility mode after we're done with it, to reduce name
	space clutter.

2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/it.tmac: Drop sourcing of `latin1.tmac` and set up of
	hyphenation codes; since the `hyphen.it` file is pure ASCII, we
	don't need to expect Latin-1-encoded code points in it.

2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Make localization files work in compatibility mode.

	* tmac/cs.tmac:
	* tmac/de.tmac:
	* tmac/en.tmac:
	* tmac/fr.tmac:
	* tmac/it.tmac:
	* tmac/ja.tmac:
	* tmac/sv.tmac:
	* tmac/zh.tmac: Save and restore compatibility mode.

	* tmac/den.tmac: Invoke requests with `do`.

	Fixes <https://savannah.gnu.org/bugs/?60874>.  Thanks to Bjarni
	Ingi Gislason for the report.

2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #60874.

	* src/roff/groff/tests/initialization_is_quiet.sh: Test it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2021-07-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	Integrate Italian localization.

	* NEWS: Add item.  Update an existing list of localization macro
	files.
	* doc/groff.texi (Manipulating Hyphenation):  Update table of
	hyphenation pattern left and right minimums and list of
	available localization files to include Italian.
	* man/groff_tmac.5.man: Update list of available localization
	files to include Italian.
	* src/roff/groff/tests/localization_works.sh: Test it.
	* tmac/tmac.am (TMACNORMALFILES): Add `it.tmac` and `hyphen.it`.

	Fixes <https://savannah.gnu.org/bugs/?60828>.

2021-07-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Flesh out Italian localization.

	* tmac/hyphen.it: Add hyphenation patterns from TeX hyph-utf8
	project.
	* tmac/it.tmac:
	  - Revise copyright date to just this year (it had been copied
	    from fr.tmac).
	  - Use grave accents instead of acute ones to indicate stress
	    on word-final vowels.  Per the University of Wikipedia and a
	    sampling of apparently well-typeset Italian language
	    documents online, this appears to be correct.  Yell at me if
	    I'm wrong.
	  - Source latin1.tmac instead of latin9.tmac; Italian doesn't
	    require any letter code points from Latin-9, unlike the
	    French file upon which this one was based, and Latin-1 is
	    less of a pain to work with.
	  - Set the hyphenation mode to 1 instead of 4 for congruence
	    with the requirements of the hyphenation patterns.
	  - Set up hyphenation codes.  This (and sourcing latin1.tmac)
	    might not be necessary as the hyphenation pattern file, of a
	    more recent vintage than the others we're using, is pure
	    ASCII.  However I don't understand these issues perfectly so
	    I am making the conservative choice.  Again per the
	    University of Wikipedia, Italian requires only acute and
	    grave accents, in contrast to the rich French diacritical
	    bouillabaisse.
	  - Set the hyphenation language and load the pattern file.
	  - Add comments in parallel with other localization files and
	    to supply text editors with hints.

2021-07-02  Edmond Orignac <edmond.orignac@wanadoo.fr>

	* tmac/it.tmac: Add Italian localization.

2021-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	Skip the stripper, part 1/3 ("me").

	* tmac/e.tmac-u: Rename to...
	* tmac/e.tmac: ...this.

	* tmac/tmac.am (TMACNORMALFILES): Add tmac/e.tmac.
	(TMACUNSTRIPFILES): Remove tmac/e.tmac-u.
	(TMACSTRIPFILES): Remove tmac/e.tmac.

	Fixes one third of <https://savannah.gnu.org/bugs/?55091>.

2021-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl: Simplify parsing.  Dave Kemper pointed
	out that preprocessors like pic(1) use pretty unsophisticated
	*roff parsing to determine where to perform their textual
	replacements.  My enhancements to support input line
	continuation and cope with brace escapes were thus
	overengineered.  Remove them.
	  - Drop scalars `is_continued_line` and `logical_line`.
	  (do_line): Stop performing logical line concatenation and
	  detecting input line continuation.  Perform operations on
	  `line` instead of `logical_line`.  Stop removing brace
	  escapes.
	* src/utils/grog/grog.1.man (Limitations): Update discussion.

	Fixes <https://savannah.gnu.org/bugs/?60862>.  Thanks, Dave!

2021-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/reg.cpp (lookup_number_reg, alias_reg): In
	diagnostic messages, say simply "register" instead of "number
	register" (there is no other kind).

2021-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Refactor input parsing.

	* src/utils/grog/grog.pl:
	  - Add scalar `use_compatibility_mode` (see below).
	  - Add list `request` to store the names of all requests
	    recognized by groff so that they aren't confused with macro
	    names.
	  - Add scalars `have_seen_first_macro_call` (replaces
	    `before_first_command`, but at global scope),
	    `is_continued_line` and `logical_line`.  The latter two
	    enable us to handle *roff input line continuation correctly.
	  (process_arguments): Set `use_compatibility_mode` if `-C`
	  option specified.
	  (process_input): Refactor to greatly simplify, to not attempt
	  to read the first line of an input file as a special case, and
	  to avoid sending `do_line` an undefined argument (when EOF is
	  reached).
	  (do_first_line): Delete.
	  (do_line): Rewrite the early stages of input parsing.
	  - Concatenate continued input lines, setting
	    `is_continued_line` and returning early as each one is seen,
	    storing the accumulating input in `logical_line`.
	  - Check the input line for the form of comment deposited by
	    Perl's Pod::Man, which uses a highly accented dialect of
	    man(7); if it's present, inflate `man_score` to compensate
	    for the page-private `IX` macro it defines but which
	    duplicates the name and function of a 4.2BSD-era ms(7)
	    extension that would otherwise deceive our scoring
	    mechanism, because Pod::Man produces `IX` calls to
	    metastatic excess.  (An alternative to this kludge is
	    documented in comments: if a "standard" macro is redefined,
	    we could delete it from the relevant lists and hashes.)
	  - Strip *roff comments from input.
	  - Normalize control lines; convert the no-break control
	    character to the regular one and remove unnecessary
	    white space.
	  - Remove brace escapes.
	  - Recognize two-character macro calls when not followed by
	    white space in compatibility mode.
	  - Drop logic that erroneously attempted to infer soelim(1) use
	    from macro calls and request invocations.  The grog(1) and
	    soelim(1) man pages now both explain why such an effort was
	    misguided.
	  - Recognize macro definitions created by .am and .am1 requests
	    {not just .de and .de1}.
	  - Ignore all other *roff requests.
	  - What remains must be a ("standard") macro call, so set
	    `have_seen_first_macro_call`.

	* src/utils/grog/grog.1.man (Limitations): Document a further
	restriction: don't change the escape character, either.

	* src/utils/grog/tests/smoke-test.sh: Comment out pic-detection
	test on soelim(1).  The pic macro calls are guarded by roff
	control structures and only worked previously by accident
	because grog did not recognize *roff input line continuation,
	now it does and the illusion is dispelled.  (A reliable way to
	fool grog before and after my refactoring is now documented in
	its man page.)

	Fixes <https://savannah.gnu.org/bugs/?59622>.

2021-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #59622.

	* src/utils/grog/tests/recognize-perl-pod.sh: Test it.
	* src/utils/grog/grog.am (grog_TESTS): Run test.

2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.1.man (Limitations): Document further
	restrictions (no changing of control characters, control
	structures not interpreted).

2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Refactor command-line argument handling.

	* src/utils/grog/grog.pl:
	  - Drop scalars `groff_opts`, `device`, and `with_warnings`.
	  - Move scalar `pdf_with_ligatures`...
	  (process_arguments): ...here.  Recognize all groff options
	  that take an optionally whitespace-separated option argument
	  and apply the existing "delayed option" handling to them.
	  Push any groff option except `-m` as-is onto the constructed
	  groff command's argument list (`-m` handling is unchanged).
	  Match long option names exactly, not sloppily.  Stop
	  recognizing `--warnings` option.  Emit error diagnostic if
	  unrecognized long option encountered.
	  (infer_device): Delete subroutine and its top-level call site.
	  (help): Undocument `--warnings`.

	* src/utils/grog/grog.1.man:
	  (Synopsis): Use font style macros instead of .OP.  Undocument
	  `--warnings`.
	  (Options): Note that the groff arguments produced by the grog
	  `--ligatures` option are supported only by the `pdf` device.
	  Undocument `--warnings`.  Undocument groff-incompatible
	  restriction on whitespace before option arguments; grog is
	  compatible now.  Simplify discussion in light of simplified
	  grog logic.
	  (Details): Undocument scenario where grog infers multiple
	  main/major/full-service macro packages; this no longer
	  happens.
	  (Examples): Update to no longer illustrate inclusion of `-T
	  ps` option; this no longer happens by default.

	* NEWS: Document removal of grog's `--warnings` option.

	Fixes <https://savannah.gnu.org/bugs/?57873>; groff options are
	no longer "mangled".

2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #57873.

	* src/utils/grog/tests/preserve-groff-options.sh: Test it.
	* src/utils/grog/grog.am (grog_TESTS): Run test.

2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Refactor device (`-T` option) handling.

	* src/utils/grog/grog.pl: Redeclare `device` as a scalar instead
	of a list.
	(process_arguments): Generalize handling of `-T` and `-m`
	options to permit optional whitespace.  Rename scalar `was_T` to
	`delayed_option`.
	(infer_device): Stop unconditionally adding a `-T ps` argument
	to the generated groff command.  Remove logic that validates any
	given `-T` option argument; instead, let groff fail if a bad one
	is supplied (its own diagnostics in this scenario were improved
	in commit 5a721a30, 27 May).  This makes grog agnostic about any
	differently configured default device in groff itself, and about
	the GROFF_TYPESETTER environment variable.

	Fixes <https://savannah.gnu.org/bugs/?55301> by getting out of
	the way.

	* src/utils/grog/tests/PF-does-not-start-pic-region.sh:
	* src/utils/grog/tests/smoke-test.sh: Update expected output.

2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.am (grog): Drop sed replacement of unused
	configuration variables @g@, @BINDIR@, @libdir@, and @EGREP@.
	* src/utils/grog/grog.pl (process_arguments, construct_command):
	Tweak warning diagnostics to use a style where an empty argument
	will be easy to spot.
	(do_first_line): Stop emitting pseudo-diagnostic (to standard
	output!) if we see a "groff options line" [it's not] of
	incorrect form.  The preprocessor encoding hint convention of
	concern here is particular to man pages, disregarded by at least
	one major implementation thereof (man-db man), and not used by
	other types of roff documents; at this point, we don't yet know
	if the document we're processing is a man page.
	(construct_command): Correct comment and related logic error.
	Clear the inferred main macro package if _any_ `-m` argument
	matching any main macro package is given.  Warn only if what is
	specified doesn't match the inference.

2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Heavily refactor.

	* src/utils/grog/grog.pl:
	  - Drop import of unused module `Data::Dumper`.
	  - Drop unused scalars `Sp` and `correct_tmac`.
	  - Simplify determination of version number.  Drop hash `at_at`
	    which only stored one key, `GROFF_VERSION`.  Initialize
	    scalar `groff_version` to "DEVELOPMENT".  Rename scalar
	    `before_make` to `in_source_tree` and initialize to zero.
	    Update `groff_version` with Automake-determined version
	    variable if it is defined (i.e., grog is not running outside
	    of, or in an unbuilt, groff source or binary distribution).
	  - Drop unused `Mparams` list.  Replace it with new list
	    `requested_package`, which stores the arguments to any grog
	    `-m` options specified by the user.
	  - Rename many objects so that I, and others, can better
	    comprehend their purpose, and for consistent letter casing.
	    . @Command -> @command
	    . @devices -> @device
	    . $Prog -> $program_name
	    . %macros -> %user_macro
	    . $have_any_valid_args -> $have_any_valid_arguments
	    . &handle_args -> &process_arguments
	    . &handle_whole_files -> &process_input
	    . @preprograms -> @preprocessor
	    . &make_groff_device -> &infer_device
	    . &make_groff_preproc -> &infer_preprocessors
	    . &make_groff_tmac_others -> &infer_macro_packages
	    . &make_groff_tmac_man_ms -> &infer_man_or_ms_package
	    . &make_groff_line_rest -> &construct_command
	  - Drop many unused keys in `Groff` hash.
	  - Add new lists, `macro_ms`, `macro_man`, and
	    `macro_man_or_ms` to support new scoring technique to
	    disambiguate input documents between these two packages.
	  - Append the foregoing 3 lists to new list `standard_macro`,
	    and add these as keys to the `Groff` hash.
	  - Add new list `main_package` to keep track of full-service
	    package names.
	  - Add new scalars `man_score`, `ms_score`, and
	    `inside_tbl_table` to aid disambiguation of .TH macro calls
	    and the many macro names shared between man(7) and ms(7).
	  (process_arguments): Strip '-m' off of argument before storing
	  the remainder in `@requested_package`.
	  (do_line): Detect .TH macro call even if white space occurs
	  between the control character and the macro name.
	  (do_line): Inflate `$man_score` by 100 if .TH is the first
	  macro call seen in a document.
	  (do_line): Fix bug; clear `$before_first_command` in correct
	  scope--after any macro call, not just if we saw a .TH as the
	  first macro call.
	  (do_line): Set `$inside_tbl_table` when we see a .TS call.
	  (do_line): Clear `$inside_tbl_table` when we see a .TE call.
	  Also increment `$Groff{'tbl')' again, increasing the "score"
	  of tbl(1) usage evidence.
	  (do_line): Drop a lot of code that manually increments %Groff
	  keys corresponding to man and ms macros.  This is now done
	  differently and elsewhere.
	  (do_line): Drop "P" from list of characteristic mm(7) macros.
	  (do_line): Simplify matching of mom(7) macros (match $command,
	  not $line).  Extend list of characteristic mom(7) macros.
	  (do_line): Increment $Groff{$key} if $key is in
	  @standard_macro.
	  (infer_man_or_ms_package): Rewrite.  Compute a score for each
	  package by counting occurrences of their characteristic
	  macros.  If both have a score of zero, assume that the input
	  is a raw roff document.  If the scores are equal
	  {doc/webpage.ms, startlingly, comes within 1 point of a tied
	  score}, infer ms(7) if 'TH' was never called, and if it was,
	  issue a diagnostic advising user to supply a disambiguating
	  `-m` option.  Otherwise, the scores are unequal: infer the
	  package of the winner.  Set scalar `inferred_main_package`
	  instead of pushing `-m` options onto `@m`.
	  (infer_macro_packages): Set scalar `inferred_main_package`
	  instead of pushing `-m` options onto `@m`.  Explicitly return
	  0 if we fall off the end of the function.
	  (construct_command): Rewrite handling of -m options.  Add new
	  list `msupp` to store supplementary (non-main) macro package
	  arguments.  If a full-service package was explicitly
	  requested, it had better not clash with what we inferred.  If
	  it does, explicitly unset `inferred_main_package` so that the
	  -m arguments are placed in the same order that the user gave
	  them; caveat dictator.  If `--run` option was given, just
	  print the command; don't preface it with __FILE__ and __LINE__
	  noise.
	  - Remove comments documenting shared variables used by
	    subroutines.  These are far from useless but too tedious to
	    keep up to date while the code is in flux.
	  - Note several places for further code review or refactoring
	    with "XXX" comments.
	  - Add Vim modeline.

	grog now passes all its tests and correctly infers arguments for
	all in-tree groff documents (except for a known, and already
	documented in grog(1), false positive detection of soelim in
	soelim(1)).  This refactor also obviates or resolves several
	outstanding Savannah tickets.

	Fixes <https://savannah.gnu.org/bugs/?44707> by obviating it;
	grog no longer cares about file name extensions on man pages (or
	any other input).

	Fixes <https://savannah.gnu.org/bugs/?55302>; same.  The quality
	of diagnostic messages has been improved as well.

	Fixes <https://savannah.gnu.org/bugs/?59753>; same.

	Fixes <https://savannah.gnu.org/bugs/?59664>.  The attached
	patch was a less aggressive refactor of &do_line and %Groff.
	Its author made the following claim for it: "With this patch,
	all 'man', 'me', 'mom, and 'ms' files in the repository are
	correctly identified.  The only example of a 'mm'-file is
	"letter.mm", which is not recognized correctly."  As noted
	above, the present refactor achieves correct recognition of all
	of the files, including letter.mm.

2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/tests/smoke-test.sh: Perform whole-line
	matches.  Apply DRY principle to expected output.  In
	anticipation of pending changes to grog.pl, uncomment and add
	tests for several in-tree documents.
		doc/meref.me
		contrib/mom/examples/copyright-chapter.mom
		contrib/mom/examples/copyright-default.mom
		contrib/mom/examples/letter.mom
		contrib/mom/examples/mom-pdf.mom
		contrib/mom/examples/mon_premier_doc.mom
		contrib/mom/examples/sample_docs.mom
		contrib/mom/examples/slide-demo.mom
		contrib/mom/examples/typesetting.mom
		doc/webpage.ms

2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Refactor.  Discard filename extension-based inference.

	* src/utils/grog/grog.pl (do_line): Stop saving the control
	character in the matched scalar `command` (the request or macro
	name).  We don't need it, and it simplifies much later matching.
	(handle_file_ext): Delete.
	(top level): Drop call site.

	* src/utils/grog/grog.pl: Rename `tmac_ext` scalar to
	`inferred_main_package`.

2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.pl (handle_args): Complain less noisily
	and more comprehensibly when given unrecognized groff options.

2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Handle "--" argument as documented.

	* src/utils/grog/grog.pl (handle_args): Rename scalar
	`double_minus` to `no_more_options` so it actually communicates
	something.  Drop openability check of operand encountered after
	"--"; since it's on the operand list, it will be checked later
	{in `handle_whole_files`}.  Stop pushing "--" itself onto the
	`filespec` list.

	Fixes <https://savannah.gnu.org/bugs/?60834>.

2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Revise operand handling, diagnostics, and exit status.

	* src/utils/grog/grog.pl: Track more state so that we can
	process the argument list more intelligently and exit with a
	meaningful status.  Add `had_inference_problem`,
	`had_processing_problem`, and `have_any_valid_args` Boolean
	scalars.
	(fail): Add diagnostic subroutine for serious problems; sets
	`had_processing_problem`.
	(handle_args, handle_file_ext): Stop complaining here about
	unopenable file operands.
	(handle_whole_files): Complain only here, with `fail` if a file
	operand cannot be opened.
	(make_groff_line_rest): Don't exit immediately if there is a
	macro package inference clash, because there might be more
	operands to process.  Instead, set `had_inference_problem`.
	Stop exiting from this subroutine.
	(top level): Only call the inference subroutines if we had a
	valid operand to work with (including an implicit read from
	stdin).  Exit with a status corresponding to the Booleans
	declared above.

	* src/utils/grog/grog.1.man (Exit status): Add section; describe
	semantics of exit status values.

	Fixes <https://savannah.gnu.org/bugs/?60833>.

2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Revise diagnostic messages.

	* src/utils/grog/grog.1.man (err): Rename from this...
	(warn): ...to this.  Prefix diagnostic with command name and
	diagnostic severity level.  The subroutine didn't change the
	exit status and was not used to report serious trouble, so
	"warning" seems appropriate.
	(make_groff_tmac_man_ms): Update call sites.  Modify diagnostic
	wording to stop calling macros "requests".

2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/grog.1.man (Limitations): Add subsection
	covering the problem grog has with soelim inference.  Undocument
	groff's -s option as one that can be inferred, because at
	present it cannot be.

	Prompted by Savannah #60421.

2021-06-26  Dave Kemper <saint.snit@gmail.com>

	[grog]: Fix erroneous detection of pic(1) usage.

	Fixes <https://savannah.gnu.org/bugs/?60772>.

2021-06-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/grog/tests/PF-does-not-start-pic-region.sh:
	  Regression-test Savannah #60772.
	* src/utils/grog/grog.am (grog_TESTS): Run test.

2021-06-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Add smoke test.

	* src/utils/grog/tests/smoke-test.sh: Add test.
	* src/utils/grog/grog.am (grog_TESTS): Run it.
	(TESTS): Add `grog_TESTS`.
	(EXTRA_DIST): Ship test.

2021-06-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grog]: Relocate in source tree.

	* src/roff/grog: Move from here...
	* src/utils/grog: ...to here.

	* MANIFEST:
	* Makefile.am:
	* src/utils/grog/grog.am: Reflect move.

	Fixes <https://savannah.gnu.org/bugs/?60788>.

2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Assigning Formats): Revise discussion.
	Clarify that a format never causes truncation of an interpolated
	magnitude.  Note that non-Arabic number formats cannot be used
	as operands to arithmetic expressions.  Add example of how to
	work around this.

2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Clarify diagnostics.

	* src/roff/troff/reg.cpp (reg::set_increment): Update diagnostic
	to unabbreviate "auto".
	(reg::alter_format): Update diagnostic to say "assign" instead
	of "alter", since the documentation consistently uses the former
	term.

2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[troff]: Slightly refactor.  Make the source code slightly more
	accessible by using a `bool` type for a member function's
	default parameter used as a Boolean, and comment it at call
	sites where the default is overridden.

	* src/roff/troff/token.h (token::get_char): Change type of
	parameter from `int` to `bool` and default from 0 to `false`.
	* src/roff/troff/input.cpp (token::get_char): Update definition.
	* src/roff/troff/env.cpp (hyphen_word):
	* src/roff/troff/node.cpp (remove_font_special_character):
	* src/roff/troff/input.cpp (do_overstrike, do_bracket, next)
	(do_define_character, remove_character, get_line_arg)
	(encode_char, do_if_request, do_translate, char_flags)
	(hyphenation_code, define_class): Update call sites.  Add
	comment indicating meaning of parameter.

2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): When outputting HTML, write the
	possibly case-transformed (but not yet abbreviated) page title
	as the `title` element instead of the unaltered first argument
	to `TH`.

2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-abbreviate-title): Define with `de`, not
	`de1`, since it is not intended for call by traps or users.

2021-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Tab Stops): Fix erroneous claim; tab stops are
	not set "every half inch across the page".  This is only true in
	"line tabs mode", which is not enabled by default.  The default
	behavior, to keep compatibility with AT&T troff, measures tab
	stops relative to the current position on the input line.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-nroff-u: Set the usekeeps register used by tbl
	to the logical complement of the cR (continuous rendering)
	register.  This prevents blank lines from creeping into tables
	in that mode.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-blank-line-trap, an-leading-space-trap):
	We say in a comment, "Macros ... that are called by traps of any
	kind must be defined with `de1` because they might be called
	from a context where compatibility mode is enabled."  So do it.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-header): Lightly refactor; tighten.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-write-paragraph-tag): Lightly refactor
	for clarity and to reduce code duplicated in both branches of an
	`ie`/`el` structure.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Rename `an-HF-remap-I-style` register to
	`an-remap-I-style-in-headings` for greater clarity.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common-u (doc-header, doc-end-macro): Partially
	revert bf4b3dde (from 20 May); per Ingo Schwarze, continuous
	rendering in mdoc(7) documents has always used only one vee
	between headers, footers, and man page body text.

2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/en.tmac: Stop using `do` request; it's unnecessary since
	the file is already loaded with compatibility mode off.

2021-06-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Fix doc omission; .ID can take an argument.

	* doc/groff.texi (ms Document Control Settings) <DI>:
	Characterize register setting as a _default_.
	(ms Displays and Keeps): Add optional variable "indent" argument
	to syntax summary of ".DS I" and ".ID".  Note that the given
	indentation is used if present, and \n[DI] otherwise.
	* doc/ms.ms (Displays and keeps): Add optional variable "indent"
	argument to syntax summary of ".ID".  Switch fonts more
	carefully and apply italic corrections.
	* tmac/groff_ms.7.man (Displays and keeps): Sync with doc/ms.ms.

2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Properly situate devtag flag-related register
	names in the package name space.  Rename `need_eo_h` to
	`s@devtag-needs-end-of-heading'.  Rename `need_eo_tl` to
	`s@devtag-needs-end-of-title`.
	((initialization), par@reset, @SH, par@finish, @NH): Do it.
	(par@reset): Test their values more idiomatically.

	Fixes last third of <https://savannah.gnu.org/bugs/?42515>.

2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac-u (@h): Migrate SCCS revision 2.37 to be idiomatic
	for groff (and not throw warnings of type 'mac').

2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Improve diagnostics during documentation
	generation; none should occur normally, but when they do, seeing
	troff complain about "<standard input>" is disheartening.
	(DOC_GROFF_ONLY): Add -b option so we get backtraces (also kill
	off trailing whitespace).
	(DOC_GROFF):
	(doc/pic.html):
	(doc/webpage.html): Add sed expression to inject `lf` request
	into the stream to identify the file being processed.

2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/me-revisions: Supplement history with subsequent BSD work
	from versions 2.29 (1988-04-22) to 8.1 (1993-06-05).

2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/me-revisions: Add 'me' macro package revision log, scraped
	from <https://svnweb.freebsd.org/csrg/share/me/revisions>.
	* doc/doc.am (DOCFILES): Ship it.

2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac-u: Rename registers for clarity.  Unlike other
	macro packages supplied by groff, "me" mostly remains within the
	AT&T 2-character name space, accessing extended names
	selectively through `do` and `de1` requests.  The package
	therefore has no characteristic name prefix.
	  need_eo_h  -> devtag-needs-end-of-heading
	  need_eo_tl -> devtag-needs-end-of-title
	  need_tl    -> devtag-needs-title
	(@html_check_need_title, sh, EQ): The foregoing registers are
	effectively Booleans, so perform Boolean-style tests on their
	interpolations.

	Fixes a second third of <https://savannah.gnu.org/bugs/?42515>.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/e.tmac-u: Work in compatibility mode.  It seems this was
	the intention (reasonable, since "me" originates in pre-groff
	BSD Unix), but there were several problems.
	(@R): Prefix register existence test with `do`.
	(@html_check_need_title): Define with `do` since the macro name
	is long, and also with `de1` so that we can freely use groff
	extensions within.  Drop many `do` requests from macro
	definition.
	(@check_need_title): Define with `do`, as above.  Add comment
	explaining why `de1` is not needed for this macro definition.
	(@S): Prefix macro/string existence test with `do`.  Remove
	spurious space so that the argument string name is truly defined
	as empty.
	(nm, n1, n2): Prefix handling of long register names `_#p` and
	`_#f` with `do` request.
	(top level): Prefix `mso` request with `do`.
	((x-html): Define with `do` and `de1` instead of `de`.  Drop
	now-unnecessary `do` requests from macro body.
	()x-html): Define with `do` and `de1` instead of `de` for
	symmetry.
	(xp-html): Define with `do` and `de1` instead of `de`.  Drop
	now-unnecessary `do` requests from macro body.

	Fixes <https://savannah.gnu.org/bugs/?60785>.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/devtag.tmac: Work in compatibility mode; define macros
	with the `de1` instead of the `de` request.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/refer-me.tmac:
	* tmac/refer.tmac: Add include guards.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/refer-me.tmac: Handle being loaded in compatibility mode.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Properly situate devtag flag-related
	register names in the package name space.  Rename `need_eo_h` to
	`an-devtag-needs-end-of-heading'.  Rename `need_col2` to
	`an-devtag-needs-second-column`.
	(an-input-trap, SH, SS, HP, (initialization)): Do it.
	(an-input-trap): Test their values more idiomatically.

	Fixes one third of <https://savannah.gnu.org/bugs/?42515>.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_if_request): Improve diagnostic
	message; say "conditional operator", not just "conditional".

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-end, an-header): In continuous rendering
	mode, use same spacing amount after header and before footer as
	mdoc in its own continuous rendering mode.  Thanks to Ingo
	Schwarze for the suggestion.

	Fixes <https://savannah.gnu.org/bugs/?60653>.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (P): Define this as the "canonical"
	paragraphing macro.
	(LP, PP): Make these aliases of P.

2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (spring_trap): Tighten lexical
	discipline; describe macro as "trap-called" rather than
	"trap-invoked".

2021-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Don't spuriously break a page after a paragraph tag when
	the tag is short enough to fit within the paragraph's
	indentation.

	* tmac/an-old.tmac (an-write-paragraph-tag): Reserve ("need") 2
	vees plus 1 basic unit of vertical space regardless of the width
	of the tag.  In the short tag case, we reverse space by one vee
	after outputting the diversion in which the tag is stored, but
	it will always contain a break, and by the time we reverse, we
	might have already hit a page location trap
	{an-break-body-text}, and by then it's too late to back up.

	* tmac/tests/an-old_no-break-after-short-paragraph-tags.sh: Test
	it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?60624>.

2021-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Rename environments to be more descriptive.
	  an-env -> an-env-header-or-footer
	  an-2   -> an-env-paragraph-tag
	(an-header, an-footer, an-write-paragraph-tag): Do it.

2021-06-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Add diagnostic error if .EQ used within .TS/.TE.
	Introduce register `tbl@within-table` to track whether we're
	inside a table.
	(@EQ): Check register and issue error if it is true.
	(@TS): Set register.
	(@TE): Clear register.

	Prompted by Savannah #55754.

2021-06-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Permit document to start with .PS.
	(cov*ab-init): Alias PS to @PS.
	(PS): Call LP, then re-execute (aliased) self as TS does.
	(TS): Update comment to parallel the one in PS.

2021-06-11  Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>

	Indent an IP paragraph based on the type size of the paragraph
	text, not a preceding heading.  We have to delay evaluating IP's
	argument until the font size has been reset, which I've
	attempted to do by simply passing the argument unevaluated down
	the call hierarchy, instead of saving it in a number register
	right away, as appears customary in this ms implementation.

	However, par@reset is called from a great number of places, and
	these usually set the indent registers beforehand.  I've left
	this as it is, so now two ways of setting the indents exist: via
	register and optionally via argument.

	* tmac/s.tmac (par@reset): Move font-size setting stuff before
	indent-setting stuff; set registers from optional arguments with
	default "n" scaling indicator before setting indents.
	(par*start, par@finish): Don't set registers, but instead pass
	arguments to par@reset.
	(@IP): Pass argument unevaluated to par*start.

	Fixes <https://savannah.gnu.org/bugs/?59604>.

2021-06-11  Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>

	* tmac/s.tmac (@QP, @XP): Be more scrupulous about using "u"
	scaling indicator.

2021-06-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #59604.

	* tmac/tests/s_IP-indents-using-paragraph-type-size.sh: Add it.
	* tmac/tmac.am (tmac_TEST): Run it.

2021-06-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	Refactor grog even more aggressively.  Make the tedious search
	for subs.pl unnecessary by inlining it into grog.pl directly.
	This makes the script stand alone and much more convenient to
	work with, and doesn't contribute to bloat, in my
	opinion--subs.pl was 10 times the size of grog.pl, and most of
	the code in the latter was dedicated to trying to locate
	subs.pl.

	* Makefile.am: Delete references to $(grog_dir).
	* configure.ac: Delete call of `GROFF_GROGDIR_DEFAULT` macro.
	* m4/groff.m4: Delete definition of same.
	* src/roff/grog/grog.am (GROG, dist_grog_DATA, grogdir): Drop
	variables.
	(grog): Remove target's dependency on `$(GROG)`.  Remove sed
	expression replacing `@grog_dir@` with `$(grog_dir)` in grog.pl.
	* src/roff/grog/grog.pl: Inline most of subs.pl (except for
	author/license comment banner).  Delete sub-hunting logic.
	* src/roff/grog/subs.pl: Delete.

2021-06-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/pic.ms (Basic PIC Concepts, Decorating Objects/Filled
	Objects, PIC Reference/Semi-Formal Grammar): Fix error: the
	keyword "solid" sets a line style, not a fill for a closed
	figure.  Thanks to Dave Kemper and Wim Stockman for reporting
	and researching this issue.

	Fixes <https://savannah.gnu.org/bugs/?60470>.

2021-06-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* NEWS:
	* doc/webpage.ms:
	* man/groff.7.man (Registers/Read-only registers) <.U>:
	* man/groff_diff.7.man (Language/New number registers) <.U>: Fix
	error; the sense of this Boolean variable was backwardly
	documented {perhaps due to an implementation detail from 2004
	that was reversed in commit 7a0e2f15, 26 February 2008}.

2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.cpp: Revise usage message.
	(synopsis): Set primary synopsis on a single output line, for
	convenience of parsing and also because we have no control over
	the width of the program name in character cells; it comes from
	argv[0] and is under user control.  There is thus no point in
	trying to get pretty formatting.  Also include separate synopsis
	lines for short and long help options.  Use opposite case from
	option flags for option arguments.
	(help): Collate option flags in English lexicographic order.
	Include space after flag letters for options that take
	arguments.  Consistently use capitals for option arguments
	because they are space-separated here.  Illustrate longer forms
	of -d and -r options.  Update language (some, like "tmac.name",
	was very old).  Add reference to groff(1) man page at end.
	(usage): Drop appendnment of notice regarding -h option; this is
	now covered in `synopsis()` unconditionally.

2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	Eliminate "groff_opts_no_arg.txt" and "groff_opts_with_arg.txt"
	files from distribution.  They are not needed by any live code
	in the tree; possibly only groffer ever used them.

	* src/roff/groff/groff.am (GROFF_OPTS_OUTPUT, groffoptsdir)
	(groffopts_DATA): Delete variables.
	(MOSTLYCLEANFILES): Stop adding to target.
	(groff_opts.tmp, groff_opts_no_arg.txt,
	groff_opts_with_arg.txt): Delete targets.

2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/grog/subs.pl (version): Report version information in
	a format consistent with our other programs.

2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/grog/grog.pl: Refactor initialization so that the
	program can be run from a build tree--and tested.  Drop much
	cruft from before Bertrand Garrigues's 2018 work to adopt
	`git-version-gen`.

2021-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_title-abbreviation-works.sh: Log more
	accurate messages in test failures.

2021-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-abbreviate-title): Add new internal macro
	to reduce the length of a man page title (i.e., the "ls" in
	"ls(1)", if it is too wide to fit in the page header (and would
	overwrite the center header material, usually the title of the
	manual section).  Since the beginning and end of the title might
	be important for disambiguation, truncation at either end would
	be unwise; replace the middle of the title with an ellipsis.
	Define new an-pageref and an-title-abbv strings for use by other
	macros and user-defined PT and BT traps.
	(PT, an-footer): Use new an-pageref string for economy.
	(an-header): Call an-abbreviate-title after setting the title
	length.

	* tmac/tests/an-old_title-abbreviation-works.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?43532>.

2021-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Copy mode): Add new section.

2021-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (else_request, while_request)
	(pipe_source, open_request, opena_request, pipe_output)
	(system_request): Update diagnostic messages to not presume the
	identities of the control or escape characters.

2021-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Conventions Used in This Manual): Add node.

2021-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.1.man: Expand to aid beginners.
	(initialization): Define `TeX` string.
	(Usage): Rewrite.
	(Usage/Getting started): Add "Hello, world!" example using
	multiple output devices (formats).
	(Usage/Using groff as a REPL): Add example of likely interest to
	programmers.  Or so I hope.  It illustrates the Turing
	fundamentals; we read, store, test, and branch.

2021-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/papersize.tmac: Improve diagnostic message; when
	complaining about unrecognized input, report back the input we
	actually received, not what it looks like after we transform it.
	Also add name of macro package to diagnostic so the user knows
	who is speaking, continuing the long process of fixing Savannah
	#52463.

2021-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_ms.7.man (Usage/Paragraphs) <QP>: Fix error: .QP
	paragraphs are indented by \n[QI], not \n[PI].

2021-05-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libdriver/input.cpp (do_file): Make fatal diagnostic
	from output driver when the device description file "DESC" can't
	be found more informative by including the name of the device
	for which the input was prepared.  Also makes malformed input of
	intermediate format more obvious.

2021-05-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/tbl.1.man (Miscellaneous): Add paragraph
	cautioning users against making tbl(1) tables conditional
	document content.

2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add style warnings for documents with input lines that
	are blank or have leading spaces, since they can cause
	surprising rendering; enabled if the CHECKSTYLE register is
	greater than 2.

	* tmac/an-old.tmac (an-blank-line-trap, an-leading-space-trap):
	Issue style warning if enabled (and only if fill mode enabled in
	leading space trap); in any event, recreate the default *roff
	behavior.
	(TH): Install traps.

	* doc/andoc.tmac (reload-doc): Remove man(7) traps before
	loading doc.tmac.

2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/andoc.tmac (reload-doc): Fix spurious blank line.

2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Operators in Conditionals):
	* man/groff.7.man (Control structures/Conditional expressions):
	Fix omission; the conditional operators "F", "m", and "S" also
	accept optional spaces and/or tabs between themselves and their
	arguments.

2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Requests/Request short reference) <.ta>:
	Describe the request as tersely as possible without omitting its
	essential syntax and semantics.  (The AT&T troff "+" relative
	prefix for normally absolute positions ".ta 1i +1i +1i" and
	alignment-specifying suffixes "L", "R", and "C" had both been
	omitted.)

2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Registers/Writable registers): Fix error:
	\n[nl] interpolates the current vertical position, not the
	vertical position of the "last printed text baseline"; the
	latter is \n[.h].

2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Filling and Adjustment): Update
	inter-sentence space example to be more illustrative.  Thanks to
	Dave Kemper and Doug McIlroy for the discussion.

	Fixes <https://savannah.gnu.org/bugs/?60404>.

2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common-u: Add comment warning source divers that
	\n[doc-header-space] is re-used for a purpose for which it is
	not documented.
	* tmac/mdoc/doc-nroff-u: Initialize doc-{header,footer}-space
	registers, which define the vertical spacing between body text
	and the relevant titles (not between the titles and the page
	margins) to 1v instead of 0.5i.  This is what mdoc(7) has always
	done in practice, per Ingo Schwarze.

2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grohtml/post-html.cpp (assert_state::add): Avoid
	potential deallocation of statically-allocated strings.  Use
	strsave() to duplicate them so that they can be safely handed to
	a_delete().  Also update diagnostic message to report name of
	complaining program (continuing the long process of fixing
	Savannah #52463).

	Fixes <https://savannah.gnu.org/bugs/?55693>.  Thanks to
	Petru-Florin Mihancea for the report.

2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/troffrc-end: Fix transposition error (in commit a248aa33
	on 15 January) that broke most table image generation in HTML
	output.

	Fixes <https://savannah.gnu.org/bugs/?60656>.

2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (UE, ME): Replace calls to HTML-NS macro for
	emissions of HTML 'A' tags with direct usage of \X device
	control escapes.  Replace .nop requests with text lines since
	this file is supposed to be maximally portable to other *roffs.

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (main): Call `scanArguments()`
	earlier, before trying to load a font description, so that -v,
	--version, and --help work.

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	[grohtml]: Add -C and -G options to postprocessor, to suppress
	output of CreationDate and Creator HTML comments, respectively.
	These can inject unwanted noise into build artifacts.

	* src/devices/grohtml/post-html.cpp: Add static globals
	`do_write_creator_comment` and `do_write_date_comment`.
	(html_printer::{do_file_components,~html_printer}): Write
	comments per corresponding global variables.
	(main): Add to `getopt_long()` call parameter and set as needed.
	(usage): Document them.

	* src/preproc/html/pre-html.cpp (scanArguments): Add to
	`getopt_long()` parameter, but ignore.

	* src/devices/grohtml/grohtml.1.man (Synopsis, Options):
	Document them.

	* src/roff/groff/tests/output_driver_C_and_G_options_work.sh:
	Test them.
	* tmac/tmac.am (groff_TESTS): Run test.

	Fixes 1/3rd of <https://savannah.gnu.org/bugs/?60655>.

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (usage):
	* src/devices/grohtml/post-html.cpp (usage): Fix inaccuracies in
	supported option summary.

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/html/pre-html.cpp (scanArguments):
	* src/devices/grohtml/post-html.cpp (main): Use libgroff's
	warning() instead of printf() to emit diagnostic about
	unrecognized parameter to `-x` option.  This sends the
	diagnostic to the standard error stream and continues the long
	process of fixing Savannah #52463.

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_www.7.man: Stop using the "www" macro package.  The
	macros it exposes are not part of the quasi-standardized man(7)
	language, and thus should not be used in man(7) documents.  See
	groff_man_style(7) for portability advice.  Besides, the
	extension macros in the permissively-licensed an-ext.tmac are
	sufficient to support URL and email hyperlinks, and our SH and
	SS macro implementations already support anchor placement
	without requiring explicit effort from page authors.
	(initialization): Stop sourcing www.tmac.  Stop calling .LK and
	.HR; the page-internal navigation links were being placed after
	the apropos line instead of at the beginning of the page,
	contradicting the comment that was there (possibly a bug).
	(Requests) <URL, LK>: Stop calling .TAG.
	<LK>: Drop paragraph advising reader to format page for groff's
	HTML output device to observe the navigation links at that point
	in the test.

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Comments): Fix error in description of parser
	operation; '.\"' is an effective whole-line comment not because
	it is a call of an undefined macro named '\"' (no 'mac' warning
	is emitted when that warning type is enabled), but because the
	comment escape is recognized normally and what remains is
	handled as the empty request.  Clarify that the optional
	argument to the .ig request is the name of a macro (which will
	be called normally _and_ end the ignored region; this is
	analogous to ".de foo bar").

2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (UR, UE, MT, ME): Rename environment and
	diversion for clarity; they apply to the link text, not the URL
	{or email address}.  The latter might not visibly appear,
	depending on the output driver.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Remove extraneous right-brace escape.

	Fixes <https://savannah.gnu.org/bugs/?60651>.  Thanks to Bjarni
	Ingi Gislason for catching it.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Copy Mode): Fix omissions from list of escape
	sequences interpreted even in copy mode.  Add \g, \V, "\.",
	'\"', \#, \a, \e and \E (with caveat), and \t.  Parallels
	groff(7) now.  Add cross reference to "Character Translations"
	node.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Escape Sequences): Fix omission; the escape
	character in an unrecognized escape sequence is not merely
	ignored; the sequence produces a warning diagnostic, albeit of a
	type that is disabled by default.
	(Escape Sequences/Escape short reference): Fix omissions; \# and
	\V are interpreted even in copy mode.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-header): Fix missing brace escape.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Slightly refactor footer spacing management when
	continuously rendering.

	* tmac/an-old.tmac (an-end): Increase the page length _after_
	flushing a pending output line.  Do so only by the amount of
	spacing we actually perform next.  Make the scaling indicator on
	the .sp request explicit.  The amount seemed magical because it
	was accounting for the one line to be consumed by output of the
	footer title line.  Instead, move that further increase of the
	page length from here...
	(an-footer): ...to here (~250 lines away), before calling BT.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common-u (doc-end-macro): When continuously
	rendering and after flushing the last line of the body text of a
	page, vertically space by 3 vees instead of 1, for consistency
	with our man(7) implementation.  Also increase page length by
	same amount _after_ flushing a pending output line, for symmetry
	with other spacing requests (and to prevent nasty surprises
	analogous to those in Savannah #60611).
	(doc-header): Put 3 vees of space after the header in continuous
	rendering mode, not 1 (and increase page length accordingly).

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Add warnings for macros deprecated in groff_man(7),
	emitted if the CHECKSTYLE register is greater than 1.

	* tmac/an-old.tmac (an-deprecation-warn): New macro emits
	diagnostic.
	(DT, PD): Call the foregoing, re-using arguments.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Refactor to move bodies of DT and PD into
	private macros.
	(an-reset-tab-stops, an-reset-paragraph-spacing): New names for
	the former DT and PT.
	(TH): Call these new macro names.
	(DT, PD): Wrap the corresponding private macros.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-bp): In continuous rendering mode, draw
	a horizontal line between a page footer of one man page document
	and the header of the next, but only if multiple documents are
	being rendered.
	(initialization): Use variable to ensure we don't draw this line
	after finishing the only document we render.

	Fixes other half of <https://savannah.gnu.org/bugs/?60611>.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix stochastic vertical space loss problems in continuous
	rendering mode by being more scrupulous about extending the page
	length.  As noted in Savannah #60611, sometimes the vertical
	space between a header line and the first section heading
	{"Name"} would be reduced or removed altogether, in a way that
	was highly sensitive to circumstances.  As far as I can tell,
	the problem is that this vertical space disappeared only when we
	were in double-secret probation no-space mode; this is the
	special non-spacing mode {not apparent with inspection of
	\n[.ns]} that happens when the stealth internal page location
	trap is sprung.  This trap does not appear in .ptr output but
	can be disabled with ".vpt 0", which is an alternative fix for
	this problem {because continuous rendering mode does not use
	vertical position traps at all}.  Another fix might have been to
	simply call the moral equivalent of ".pl MAXINT" as soon as
	continuous rendering mode was decided upon.

	* tmac/an-old.tmac (an-header): In continuous rendering mode,
	extend the page length by one line before calling PT to output
	the page header, and afterwards, extend the page length by 3
	vees and space by that amount (instead of half an inch).

	Fixes half of <https://savannah.gnu.org/bugs/?60611>.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-header, an-footer): Drop no-op .tl
	requests.

2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-footer): Improve symmetry with an-header.
	If rendering to HTML, don't bother setting the
	an-outer-footer-text, an-extra1, and an-extra2 strings to empty
	values; instead don't call BT, just as we don't call PT in
	an-header.

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-end): Drop needless .nr % assignment.
	Call our (wrapped) bp instead of the .pl request directly.
	(an-bp): Drop needless .br and (aliased) real .bp request.

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-footer): Refactor complex conditional.

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_X-register-works.sh: Add test for footer
	creeping into page content.

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (initialization): Ignore P and X rendering
	parameter registers if specified with continuous rendering
	enabled (the default in the nroff mode used for terminals), and
	emit diagnostic.

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_X-register-works.sh: Rewrite.  Increase test
	coverage and stop assuming that -rcR=1 and -rX=anything is a
	supported combination.  (Continuous rendering is supposed to
	suppress the printing of page numbers anyway.)

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (initialization): Refactor handling of P and
	X rendering parameter register validation in preparation for
	disabling them in continuous rendering mode, where they don't
	make any sense.

2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_TH-repairs-ad-damage.sh: Tweak test
	internals to make troubleshooting easier.

2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Relocate some initialization logic to
	be adjacent to (most of) the rest of it.

2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Remove useless .if.  Its condition is
	always true now in the wake of the fix for Savannah #60609.

2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Rename many package macros, strings, and
	registers (and the lone named environment) to be more expressive
	of their function.  "an-footer" is now the proper complement of
	"an-header" (setting up an environment and calling a
	user-redefinable trap macro).
	  an-first         -> an-is-first-page-of-document
	  an-html          -> an-is-output-html
	  an-footer        -> an-break-body-text
	  an-p-footer      -> an-footer
	  an-set-margin    -> an-reset-margin-and-inset-level
	  an-level         -> an-inset-level
	  an-tag-sep       -> an-tag-separation
	  an-no-space-flag -> an-need-no-space-mode
	  an-break-flag    -> an-need-break
	  an-div?          -> an-is-in-diversion
	  an-page-string   -> an-outer-footer-text
	  an-trap          -> an-input-trap
	  an-do-tag        -> an-write-paragraph-tag
	  an-1             -> an-env

	* tmac/andoc.tmac (reload-doc): ...as above for the exposed
	parts of the interface.
	  an-footer        -> an-break-body-text
	  an-p-footer      -> an-footer

2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Rearrange alternating font macros to be in
	alphabetical order (and the order documented in groff_man(7).

2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Refactor alternating font macros.  These
	macros are hard enough to understand without adding gratuitous
	structural differences to the reader's burden.  Make their
	implementations rigidly parallel.  Update comments.
	(RI, IR, IB, BI, RB, BR): Always define the `an-result` string
	as empty except for a dummy character '\&' for the sake of
	compatibility mode.
	(RI, IR, IB, BI): Defer interpolation of the first argument to
	the while loop if there are at least two (like the existing RB,
	BR).  This way the style name arguments to the font selection
	escape sequences in the appendment to `an-result` match the
	order of the letters in the macro name (useful to make sense of
	diffs).
	(RI, IR, IB, BI, RB, BR): Always remove the `an-result` string
	after interpolating it.
	(RB, BR): Only do work if there are any arguments.

2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Apply italic corrections more consistently.

	* tmac/an-old.tmac (BI, IB, IR, RI): Apply italic corrections
	more consistently.  Add lengthy comment rationalizing approach.
	(RI, BI): An italic correction is now applied after the last
	argument if it is of even parity (i.e., the 2nd, 4th, 6th, ...).

	* tmac/groff_man.7.man.in (Description/Font style macros): Note
	that italic corrections are applied.

	Fixes <https://savannah.gnu.org/bugs/?53541>.

	Thanks to Bjarni Ingi Gislason for the report and a suggested
	patch.

2021-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Ignore FT register when appropriate.

	* tmac/an-old.tmac (initialization): Validate user-specified
	value of \n[FT].  Continuous rendering ignores FT (page location
	traps are not used for footers in that mode).  Measuring a
	footer distance from the page top isn't done.  A footer distance
	of over half the page length is unlikely.  A footer distance of
	less than one line height is too.  Issue diagnostics in all of
	these cases.

	* tmac/tests/tmac/tests/\
	an-old_FT-bad-value-should-not-trash-titles.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?60612>.

2021-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Plant the an-footer trap (where we
	schedule a break in the page text prior to spacing down to the
	footer) at twice the value of \n[FT], not a hard-coded -1i.
	This way, the user can't make the an-p-footer trap (planted at
	\n[FT]) spring before the an-footer trap that should precede it.

	* tmac/groff_man.7.man.in (Options) <-rFT>: Document this.

2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Add new
	autoconf macro to check Ghostscript version.  Versions 9.00 <= x
	< 9.54 suffer from a rendering glitch that affects the AT&T
	troff (and groff) special character \(lh; see
	<https://bugs.ghostscript.com/show_bug.cgi?id=703187>.  Store
	the result of the check.
	(GROFF_GHOSTSCRIPT_VERSION_NOTICE): Add new macro to report the
	problem detected by GROFF_GHOSTSCRIPT_VERSION_CHECK to the user.

	* configure.ac: Call the macros in appropriate places.

	Fixes <https://savannah.gnu.org/bugs/?59531>.

2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac (reload-man): Remove removal of RI macro, made
	unnecessary by commit 551f138 (15 May).

2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_HTML_PROGRAMS, GROFF_PDFDOC_PROGRAMS):
	Tweak autoconf warning messages when Ghostscript (gs) command
	missing to be more mutually congruent.
	(GROFF_URW_FONTS_CHECK): Tweak to note that gs is only run to
	locate the URW fonts if gs is available.

2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_AT-and-UC-footer-saved-and-restored.sh:
	Tweak to be more helpful when troubleshooting exasperating
	header/footer problems as in Savannah #60609.

2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Fix missing page footers when continuously rendering
	multiple documents.  Resolving this uncovered entangled header
	and footer management bugs with batch processing even when _not_
	continuously rendering.

	* tmac/an-old.tmac (an-start-new-document): New macro clears
	header trap so it doesn't get called with stale information.
	{The TH macro already replants a header trap with every man
	page if not continuously rendering.}  This macro also absorbs
	the break-page and page number incrementation logic from TH.
	(TH): Adapt semantics of "an-first" register to mean not "first
	page rendered" (apparently) but "first page of new document".
	If we are _not_ on the first page of a new document and the TH
	macro is called, we must be batch processing: force the previous
	man page to end (call an-end if continuously rendering, or
	an-start-new-document if not).  After all the header and footer
	strings have been configured for the man page, call an-header if
	we're on the first page of the document, not (just) if we're
	continuously rendering.  Zero an-first register at end of macro
	here unconditionally instead of conditionally in .an-header.
	(an-header): Drop conditional on continuous rendering.

	When I batch-render our 62 man pages to the terminal, I do note
	one cosmetic regression: the lj4_font(5) page, when continuously
	rendered in batch processing, has no space between its header
	line and first section heading ("Name").  Another cosmetic issue
	in this scenario is that the footers for every rendered page but
	the last, which had (wrongly) been absent entirely, are set with
	no space after them and the header of the next.

	* tmac/tests/an-old_page-footers-present.sh:
	* tmac/tests/an-old_page-header-has-current-data.sh: Add man
	page header/footer regression tests.
	* tmac/tmac.am (tmac_TESTS): Run the tests.

	Fixes <https://savannah.gnu.org/bugs/?60609>.

2021-05-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (initialization): Key the reprocessing guard
	{like a C language #include guard} on the existence of the TH
	macro instead of RI.  The latter seemed kind of random and TH
	is even more guaranteed to exist; it is the macro name most
	characteristic of the man(7) language and the andoc.tmac
	superstructure relies on it.  (TH may have been avoided because
	of its use with tbl(1); however, neither man(7) nor mdoc(7)
	support tbl's TH feature, and GNU tbl does not supply its own
	empty fallback definition as it does for TS and TE.  If we ever
	want TH-like functionality in future man pages, I suggest we
	pick a new, non-colliding name for it.)
	(initialization): Relocate load of devtag package; we don't
	need it before entering compatibility mode.  Move assignment of
	format of an-page-letter register from a "loose declaration"
	amid macro definitions to within existence test of X register.
	Stop initializing an-extra[123] strings outside of any macro;
	they need to be reinitialized at every TH call when batch
	rendering.
	(TH): Call DT in a less surprising place.
	(TH): Initialize all header/footer-related strings before
	calling header macros, even those not needed for the default
	header configuration.
	(TH): Add style warnings for underspecified arguments.
	(an-ne): Rename register from "an-need", which is pretty
	confusing in context, to "an-amount", since (1) a (vertical)
	amount is what it is, and (2) it's only used within this macro.
	Also due to factor (2), remove the register after using it.

2021-05-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* m4/groff.m4 (GROFF_URW_FONTS): Update configure script check
	for URW fonts to recognize recent releases of the URW Base 35
	fonts from Artifex Software.  Look for the AR (Arial roman
	equivalent) font under all of the names recognized by
	fonts/devpdf/Foundry.in.
	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): Update wording of notice
	when URW fonts are not found.  Replace dead URL with working
	one.  Try to hedge against the future, but the Web is an
	ephemeral place, as are the file names Artifex gives to its
	fonts.  Thanks to T. Kurt Bond and Thomas Dupond for reporting
	and investigating the problem.

	Fixes <https://savannah.gnu.org/bugs/?60604>.

2021-05-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (ms Document Control Settings) <DI>:
	* doc/ms.ms (Document control settings, Displays and keeps)
	<DI>:
	* tmac/groff_ms.7.man (Document control settings, Displays and
	keeps) <DI>: Document this register; it had been mentioned only
	in passing.

2021-05-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (ms Document Control Settings) <DD>:
	* doc/ms.ms (Document control settings) <DD>:
	* tmac/groff_ms.7.man (Document control settings) <DD>: Fix
	error; changes to \n[DD] take effect at the next display
	boundary (including the end of the active one), not the next
	"paragraph" (paragraph macros cannot be called inside a display
	anyway).

2021-05-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac (reload-man): Delete no-op line that attempts
	to restore compatibility mode.  Individual pages have to do
	this, and ".do cp \n(.C" is not effective for the reason
	discussed in the 2020-04-16 ChangeLog entry.

2021-05-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (@RT): Delete definition; make it an alias for
	par@finish.  Until commit 021ba0e7 (1 May), they had identical
	definitions.  I find it difficult to imagine what use it would
	be to have an undocumented reset macro that resets everything
	_except_ the deeply internal \n[.ev]:ai.

2021-05-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: Handle HF strings with an embedded font family when
	applying italic-to-bold-italic remapping; the feature now works
	on troff devices as well.

	* tmac/an-old.tmac (initialization): Do more validity checking.
	Store heading family in new string \*[an-heading-family].  Clean
	up after self.
	(SH, SS): Include the heading family in the remapping target.

	* tmac/groff_man.7.man.in (Description/Document structure
	macros) <.SH, .SS>: Document it.

2021-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_char.7.man (Glyph tables/Mathematical symbols): Fix
	errors in special character descriptions; \[sqrt] is a "special"
	glyph (that is, it uses mathematical metrics on typesetter
	devices), and \[radicalex) is not (and is thus a "text" glyph).
	See Werner Lemberg's ChangeLog entry of 2003-01-05.  Problem
	dates to 07a6233ad, 27 May 2014.

	The overloaded use of the word "special" really pinches here.

2021-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tty.tmac: Replace fallback glyphs for radical extension
	and square root extension; use \[rn] instead, which works fine.

	Now the only glyph in the page that doesn't render on a UTF-8
	terminal (if one's font has adequate coverage) is the Bell
	System logo.

2021-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tty.char: Add fallback characters for \[fm] and \[sd].

2021-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	[man]: If \*[HF] is a bold style, substitute bold italics for
	italics in section and subsection headings, keeping the font
	weight consistent.

	* tmac/an-old.tmac (initialization): Set a flag for this based
	on the interpolation of \*[HF] matching "B" as its last
	character.
	(SH, SS): Apply and reverse font remapping based on this flag.

2021-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (EX): Work around Savannah #59522 by changing
	fonts differently on DVI output, avoiding a font warning.

2021-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac: If in nroff mode, remap font CBI to BI.
	* tmac/dvi.tmac: Remap font CBI to CWI.  (Computer Modern
	Constant Width has no bold styles.)

2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (NL, SM, LG): Issue warning diagnostic if macro
	called with arguments.
	(par*define-font-macro): Construct font macro with diagnostic to
	warn if called with excess arguments.
	(UL, BX): Issue warning diagnostic if macro called with excess
	arguments.

	Fixes <https://savannah.gnu.org/bugs/?60522>.

2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi: Delete redefinition of \putwordAppendix
	Texinfo macro.  This restores the word "Appendix" to the names
	of all appendices and fixes two bad internal links to Appendix
	E, the Register Index, in the DVI and PDF output formats.  Per
	consultation with Texinfo maintainer Gavin Smith, it's difficult
	to get the behavior we want, so give up trying for now.

2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (@MC): Actually diagnose and recover when user
	tries to .MC inside a diversion.

2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Differences from AT&T ms):
	* doc/ms.ms (Differences from AT&T ms):
	* tmac/groff_ms.7.man (Differences from AT&T ms): Document our
	different default (empty) for the center footer in nroff mode;
	this behavior appears to date back to June 1991 or earlier,
	drawing few complaints.

	Fixes <https://savannah.gnu.org/bugs/?59826>.

2021-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/*: Rename files to use consistent scheme; one
	underscore to separate the package name from the test objective,
	dashes to otherwise separate words.
	* tmac/tmac.am (tmac_TESTS): Use new names.

2021-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Restore support for AT&T ms PN register.

	* tmac/s.tmac (pg): Make register PN an alias of %.

	* doc/groff.texi (Differences from AT&T ms):
	* doc/ms.ms (Differences from AT&T ms):
	* tmac/groff_ms.7.man (Differences from troff ms): We don't need
	PN, and it was removed in commit 08291b40 (25 October 2020), but
	since it is documented in Lesk 1978 we're stuck with it.  Advise
	users to stick with %.  Also warn them of the hoop they must
	jump through if they redefine the page trap macro PT, which Lesk
	1978 also encourages.

	* tmac/tests/s_PN-works.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?59823>.

2021-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Restore default IP paragraph indentation after an SH call.

	* tmac/s.tmac (par@finish): Set "ai" register for the current
	environment to the paragraph indent (PI) setting for the current
	environment.

	* doc/groff.texi (Highlighting in ms) <IP>:
	* doc/ms.ms (Highlighting) <IP>:
	* tmac/groff_ms.7.man (Usage/Highlighting) <IP>: Update
	documentation.

	* tmac/tests/s_SH_resets_IP_indentation_amount: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?60222>.

2021-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (DS): Issue diagnostic and attempt recovery if
	document attempts to start a display within another display.

	Fixes <https://savannah.gnu.org/bugs/?55136>.

2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Implement alternative rendering for automatic
	footnote numbers in nroff mode, inspired by Heirloom Doctools
	ms; since superscripting is not universally available on
	terminals, surround number with square brackets instead.
	(fn@init): New macro finishes initializing footnote module,
	setting up aliases to par@sup-{start,end} strings in troff mode
	and otherwise defining fn@sup-{start,end} as brackets.  Define *
	string here, using new strings.
	(par): Call fn@init after par@sup-{start,end} are defined, and
	prior to other footnote integration material.
	(par*fp!0): Migrate from par@sup-{start,end} to
	fn@sup-{start,end}.

	* doc/groff.texi (ms Document Control Settings) <FF>:
	* doc/ms.ms (Footnotes) <FF>:
	* tmac/groff_ms.7.man (Usage/Footnotes) <FF>: Document it.

	Fixes <https://savannah.gnu.org/bugs/?60228>.

2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* test-groff.in: Stop passing the built groff executable -b and
	-ww options by default.  This reverses a change from 2017.  Dave
	Kemper has convincingly argued that there's no way to override
	-b and turn backtraces on warnings/errors back off, and that the
	built groff should behave as much like a "normal" one as
	possible.  The latter factor is of added importance now that we
	are using test-groff for generation of documents.

	* src/roff/groff/tests/regression_savannah_58153.sh: Adapt.

2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (BX): Add alternative implementation for terminal
	{nroff} devices.  Store width of boxed text, adding .4m only on
	troff devices (to make room for the vertical box lines).  Break
	long input line in troff implementation.  If not in troff mode,
	use ISO 6429 color escapes to render boxed text in black on
	white.  Use the \Z escape to match breaking semantics of macro
	in troff mode.

	* doc/groff.texi (Highlighting in ms) <BX>:
	* doc/ms.ms (Highlighting) <BX>:
	* tmac/groff_ms.7.man (Usage/Highlighting) <BX>: Document it.

	Fixes <https://savannah.gnu.org/bugs/?60477>.

2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am: Make $(PROCESSEDDOCFILES) depend on all the same
	targets as $(PROCESSEDEXAMPLEFILES); this way the me, ms, and
	pic.ms manuals are all regenerated upon changes to their
	underlying macro packages.

2021-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* INSTALL.extra: Update.
	(Evaluation): New section updates material on "test-groff"
	script.  Also tell people how to preview our Texinfo manual (in
	info, text, DVI, PDF, and HTML formats).
	(In Case of Trouble): New section updates bug reporting URL.

	Fixes <https://savannah.gnu.org/bugs/?57863>.

2021-04-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Make the FAM string work more sensibly; it now
	applies to headers, footers, and footnotes only if set
	before the first call of a sectioning, paragraphing, or
	{non-date} document description macro.
	(PT, BT): Set the font family to that saved for titles.
	(fn*do-FS): Set the font family to that saved for footnotes.
	(par@init): Copy the document font family to independent strings
	for titles and footnotes.
	(par@reset): If in a footnote environment, set the font family
	to that saved for footnotes; otherwise use \*[FAM].

	* tmac/groff_ms.7.man (Differences from troff ms/Text settings):
	Describe placement-dependent effect of FAM string setting.

	* doc/groff.texi (Highlighting in ms):
	* doc/ms.ms (Highlighting): As above, and suggest different
	occasions in which ".ds FAM C" and "CW" are convenient.

	Fixes <https://savannah.gnu.org/bugs/?60422>.

2021-04-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (source, source_quietly)
	(macro_source, macro_source_quietly): Use idiomatic Boolean
	literals.

2021-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi: Drop workarounds for Texinfo pre-5.0 versions;
	our local macros produced many warnings during generation of our
	Texinfo manual.
	(Langlemacro):
	(Ranglemacro):
	(Lparenmacro):
	(Rparenmacro):
	(Lbrackmacro):
	(Rbrackmacro): Delete.  Replace call sites with literals.
	(Lbracemacro):
	(Rbracemacro): Delete.  Replace call sites with @lbracechar{}
	and @rbracechar{}.
	(angles): Reimplement in terms of @guilsinglleft{} and
	@guilsinglright{}.  Flesh out comment.

	Fixes remainder of <https://savannah.gnu.org/bugs/?59524>.

2021-04-17  Dave Kemper <saint.snit@gmail.com>

	* doc/meintro.me:
	* doc/meref.me: Correct and make consistent usage of the term
	"point size".

	Fixes <https://savannah.gnu.org/bugs/?60403>.

2021-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (SS): Add devtags support.  Set a subsection
	title as a second-level heading and add it to a table of
	contents, if any.  Prompted by a query from Hans Unzner to the
	groff mailing list.  Thanks, Hans!

2021-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (SH): Fix apparent thinko.  Pass the devtags
	macro a literal "1" argument.  Passing it \n[an-level] wasn't
	correct (it stores the relative inset level, not a sectioning
	level), and was useless anyway: SH has already called
	.an-set-margin by this point, which resets \n[an-level] to 1.
	man(7) does not support nesting of SH macros.  Also call
	.DEVTAG-NH by its alias .DEVTAG-SH since section headings are
	not numbered in man(7).

2021-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tmac]: Adjust editor file encoding hints.

	* tmac/cs.tmac: Tell Vim the file is "iso-8859-2" (ISO Latin-2).
	* tmac/en.tmac: Stop telling Emacs the file is "latin-1"; it's
	ASCII.
	* tmac/fr.tmac: Tell Vim file is "iso-8859-15" (ISO Latin-9).

	Vim users may need to use ":e ++enc=iso-8859-2", for instance,
	to see correct glyphs.

2021-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	The first-order determinant of hyphenation points is language,
	not territory.  Use ISO 639 2-letter language codes for
	hyphenation and exception patterns instead of ISO 3166 2-letter
	territory codes.

	* tmac/*.us: Rename *.us files to *.en.
	* tmac/troffrc: Change hyphenation language "us" to "en".
	* tmac/en.tmac: Add English localization file.  Set hyphenation
	mode to 4.
	* tmac/troffrc: Derive groff locale from system.

	* doc/groff.texi (Manipulating Hyphenation):
	* man/groff.7.man (Hyphenation):
	* man/groff_diff.7.man (Implementation differences): Refer to
	"U.S. English" hyphenation patterns as simply "English"; they
	will be mostly correct for Commonwealth English as well, and no
	alternative English hyphenation patterns for other territories
	are available.

	* doc/groff.texi (Manipulating Hyphenation):
	* man/groff_diff.7.man (New requests): Note that default
	hyphenation mode depends on the language used on the system.
	Add concept index entry for localization.  Add file index
	entries for the locale macro files (cs.tmac, etc.).  Update to
	reflect rename of English hyphenation patterns and .hla
	identifier from "us" to "en".

	* src/roff/groff/tests/localization_works.sh: Add 10 test cases.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	* tmac/LOCALIZATION: Rewrite.

	Fixes <https://savannah.gnu.org/bugs/?59814>.

2021-04-12  Dave Kemper <saint.snit@gmail.com>

	* doc/meref.me: Correct various small issues.

	Fixes <https://savannah.gnu.org/bugs/?60379>.

2021-04-12  Dave Kemper <saint.snit@gmail.com>

	* man/groff.7.man (Registers/Writable registers) <year, yr>:
	Drop discussion of Y2K issues.

	Fixes <https://savannah.gnu.org/bugs/?60372>.

2021-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Setting Registers) <rnn>: Fix error: the
	request is not ignored if the second argument (the new name)
	does not exist.  Problem dates back to 52a6d12a (11 May 2000).

2021-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Implement new .soquiet and .msoquiet requests.

	Needed for two planned developments: {1} the i18n patch in
	Savannah #59814 can use this to quietly attempt to open a
	localization file.  groff only supports a few locales, so people
	with LANG=es_ES, for instance, would ordinarily see warning
	diagnostics on every groff startup; and {2} system- or
	site-configurable support of per-user {.,}troffrc or man.local
	files, gracefully failing if they don't exist.

	* src/roff/troff/input.cpp:
	(do_source): Add new function, taking boolean "quietly"
	parameter and absorbing function of source(), with added
	conditional.
	(source): Convert into a wrapper to call do_source() unquietly.
	(source_quietly): Wrap do_source(), quietly.
	(do_macro_source, macro_source, macro_source_quietly): Analogous
	to the foregoing.
	(init_requests): Hook "msoquiet" to macro_source_quietly() and
	"soquiet" to "source_quietly().

	* doc/groff.texi (I/O):
	* man/groff.7.man (Requests/Request short reference):
	* man/groff_diff.7.man (Language/New requests): Document them.

	* src/roff/groff/tests/msoquiet_works.sh:
	* src/roff/groff/tests/soquiet_works.sh: Test them.

	* src/roff/groff/groff.am (groff_TESTS): Add tests.

	Fixes <https://savannah.gnu.org/bugs/?59973>.

2021-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (ms Document Control Settings) <FF>: Update
	description to cover application of footnote format to footnote
	markers in general, not just numbers.  Clarify different
	behavior of format 1 with respect to automatic numbers and other
	markers.
	(ms Footnotes) <*>: Describe string operation in more detail.
	<FS>: Describe more precisely how the optional argument is
	handled.

	* doc/ms.ms (Footnotes): Synchronize with doc/groff.texi.  Add
	example using document's own text as a model.

	* tmac/groff_ms.7.man (Usage/Footnotes): Resync relevant
	portions with doc/ms.ms.

	Fixes <https://savannah.gnu.org/bugs/?60227>.

2021-04-06  Dave Kemper <saint.snit@gmail.com>

	* src/roff/nroff/nroff.sh: Recognize -k and -K options and pass
	them through to troff.  Document them in usage message.
	* src/roff/nroff/nroff.1.man: Document new -k and -K options.

	Fixes <https://savannah.gnu.org/bugs/?60349>.

2021-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Hyphenation):
	Recast introductory paragraph to better distinguish the
	automatic breaking of words and placement of hyphens at
	user-specified hyphenation points (done with the \% escape) and
	automatic determination of hyphenation points within words (what
	the pattern files and most of the hyphenation mode parameters
	are for).  Clarify that what our manual calls "automatic
	hyphenation" pertains only to the latter.
	<hw> Correct over-general claim; hyphenation exceptions defined
	with the .hw request _do_ honor .hy value 2 (don't break a word
	at the bottom of a page), but none of the others.
	<\%> Recast description of escape to emphasize independence of
	its two uses (e.g., "\%pseudo\%unununium" is hyphenated only
	after "pseudo-", if at all).
	<\:> Clarify that escape is an input word boundary.
	<shc> Clarify that the soft hyphen glyph is applied to manual as
	well as automatically-determined hyphenation points.
	<hy> Recharacterize as setting the _automatic_ hyphenation mode.
	Note that restrictions apart from value 2 are not applied to
	words with manually-assigned hyphenation points.
	<nh> Note that request affects only automatic hyphenation.

	* man/groff.7.man (Requests/Request short reference) <.hy,.nh>:
	Clarify that requests deal with _automatic_ hyphenation.
	(Registers/Read-only registers) <.hy>:
	Clarify that register applies to _automatic_ hyphenation.
	(Hyphenation): Add new introductory paragraph summarizing manual
	hyphenation support and features, including notice that breaking
	at explicit hyphens is performed in fill mode, i.e., even if
	_automatic_ hyphenation is disabled.

	Thanks to Peter Schaffter for the report.

	Fixes <https://savannah.gnu.org/bugs/?60332>.

2021-03-27  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Changes to the ghostscript fontnames (9.53.3).

	* font/devpdf/Foundry.in: HI and HBI switch to using
	Italic rather than Oblique.

2021-03-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Filling and Adjustment):
	* man/groff_diff.7.man (Language/Extended requests): Fix
	incorrect claim that additional inter-sentence space is applied
	only in fill mode.  Drop word "parameter" from description of
	unit used in .ss request arguments; it is a needlessly specific
	reference to the font file format.  Tighten wording.

	* man/groff.7.man (Control Characters): Fix incorrect claim that
	end-of-sentence detection is attempted only in fill mode.  Note
	that .ss request also affects inter-word spacing.

	* man/groff_diff.7.man (Language/Extended requests):
	  - Drop example.
	  - Move discussion of AT&T vs. GNU troff difference in .ss
	    handling from here...
	  (Implementation Differences): ...to here.

	Thanks to Dave Kemper for his continued scrutiny!

2021-03-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (ms Cover Page Macros):
	* doc/ms.ms (Cover page macros):
	* tmac/groff_ms.7.man (Usage/Cover page macros): Revise and
	rename (sub)sections to "Document description macros".

2021-03-15  Dave Kemper <saint.snit@gmail.com>

	* Makefile.am: Fix typos.  Thanks to Bjarni Ingi Gislason for
	the report.

	Fixes <https://savannah.gnu.org/bugs/?59457>.

2021-03-14  Dave Kemper <saint.snit@gmail.com>

	* man/groff_tmac.5.man: Correct erroneous reference to PSPIC
	where PDFPIC was intended.  Fix numerous smaller style and
	content problems.

	Fixes <https://savannah.gnu.org/bugs/?60229>.

2021-03-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Optional man extensions) <CW, EX, PN, Pn>:
	(Highlighting in ms) <CW>:
	(Additional ms macros) <CW>: Use "monospaced" to refer to font
	selected, retaining "constant-width" term only where it explains
	the macro mnemonic.  Thanks to Dave Kemper for pointing out the
	issue.  Also fix error: .CW in the ms package seems to have
	originated with Research Unix, not Berkeley.

	* doc/ms.ms (Highlighting) <CW>: Sync with our Texinfo manual.
	* tmac/groff_ms.7.man: Sync with ms.ms, omitting FAM advice.

	Fixes <https://savannah.gnu.org/bugs/?60037>.

2021-03-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Identifiers, Strings, Writing Macros)
	(Diversions): Improve cross-linkage of documentation regarding
	shared name space of macros, strings, diversions, and boxes.

	Fixes <https://savannah.gnu.org/bugs/?58995>.

2021-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Improve diagnostic messages.
	(@diag): New macro wraps .tm request, always prefixing it with
	the name of the macro package, as well as file and line
	indicators only if these are set to non-empty or non-zero
	values, respectively.
	(@error, @warning): Call @diag instead of .tm directly.
	(@fatal): Retire; it had only one call site and it would have
	greatly complicated @diag to support calling .ab instead of .tm.
	An ugly alternative would have been to call .ab with a redundant
	message after calling @diag.
	(@divert): New macro wraps .di request, remembering the name of
	the current file (\n[.F]) when a diversion is started.
	(@error-recover): Call .ab instead of (deleted) @fatal.
	(pg@super-eject): Tell user what the last file name seen was
	when recovering from an unfinished diversion when processing
	ends.

	Fixes <https://savannah.gnu.org/bugs/?55099>.

2021-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Fix bug where having line numbering off but the output line
	number register \n[ln] set to a positive value would cause
	tbl(1) table rows to spontaneously become numbered.  Use new
	\n[.nm] register to determine whether line numbering is enabled.

	* src/preproc/tbl/table.cpp (table::init_output, table::do_row)
	(table::do_bottom): Predicate all conditions on \n[ln]
	additionally on \n[.nm].

	Thanks to Olle Lögdahl for the report.  Problem appears to date
	back to commit b69062693d3360efce9d4d63fac337be21e07db7, 20 July
	2011.

	Fixes <https://savannah.gnu.org/bugs/?59812>.

2021-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #59812.

	* src/preproc/tbl/tests/cooperate-with-nm-request.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TEST): Run test.

2021-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Implement new read-only register ".nm".  It reports the
	enablement status of output line numbering (caused by the .nm
	request) irrespective of the temporary suspension of numbering
	with the .nn request.  Needed because there was no way to
	introspect its state, tbl(1) needs to do so, and the writable
	line number register \n[ln] is not a reliable proxy for it.

	* src/roff/troff/env.h: Add get_numbering_nodes(), returning
	`int`, to public interface of `environment` class.
	* src/roff/troff/env.cpp: Implement get_numbering_nodes().

	* src/roff/groff/tests/dot-nm_register_works.sh: Test it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	* doc/groff.texi (Miscellaneous):
	* man/groff_diff.7.man (Language/New number registers):
	* man/groff.7.man (Registers/Read-only registers): Document it.

	* NEWS: Add item.

2021-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Emit warning diagnostic when using a multi-page
	table with a repeating header (".TS H").
	(KS): Rename diversion from "kp*div" to "kp@div" since the name
	is now referenced outside the keep module.
	(KF): ...similarly for kp@fdiv.
	(generally): Update diversion dereference sites and derived
	names.
	(@TS): When handling "H" argument, check identity of current
	diversion and emit appropriately worded warning.

2021-02-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* FOR-RELEASE: Add more procedures and information related to
	incrementing groff's version number.

2021-02-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/searchpath.cpp (search_path::open_file)
	(search_path::open_file_cautious): Save errno before calling
	free() and restore it afterwards.  A future version of POSIX
	will require that free() not change errno if it succeeds[1];
	some C library implementations, including recent versions of
	glibc[2], lack this property.  free() is called in these
	libgroff functions to clean up after an unsuccessful fopen() of
	a heap-allocated file name string, and because the errno from
	fopen() may be passed to strerror() in a diagnostic message, it
	needs to be accurate.  I checked the rest of groff's codebase
	and found no other instances of free() being used to clean up
	after fopen() failure.

	[1] https://www.austingroupbugs.net/view.php?id=385
	[2] https://sourceware.org/bugzilla/attachment.cgi?id=13073

2021-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Address build failure on macOS.

	Follow the advice of the gnulib manual ("Changing your source
	for use with gnulib") more scrupulously; include config.h in
	more files.

	* src/libs/libgroff/curtime.cpp [HAVE_CONFIG_H]:
	* src/libs/libgroff/device.cpp [HAVE_CONFIG_H]:
	* src/libs/libgroff/fatal.cpp [HAVE_CONFIG_H]:
	* src/libs/libgroff/string.cpp [HAVE_CONFIG_H]:
	* src/libs/libgroff/strsave.cpp [HAVE_CONFIG_H]:
	* src/preproc/eqn/other.cpp [HAVE_CONFIG_H]:
	* src/preproc/eqn/text.cpp [HAVE_CONFIG_H]:
	* src/preproc/pic/object.cpp [HAVE_CONFIG_H]: Do it.

	* src/libs/libgroff/assert.cpp [HAVE_CONFIG_H]:
	* src/libs/libgroff/errarg.cpp [HAVE_CONFIG_H]:
	* src/libs/libgroff/error.cpp [HAVE_CONFIG_H]: #include
	config.h using angle brackets instead of quotation marks.

	Fixes <https://savannah.gnu.org/bugs/?60035>.

2021-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #60025.

	* tmac/tests/doc_Mt-works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2021-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Demote definition of \[yogh] special character escape from
	unconditional availability to be defined only if the output
	device defines it or if .AM macro is called to enable support
	for Berkeley-style accent marks.

	See
	  https://lists.gnu.org/archive/html/groff/2021-01/msg00000.html
	and follow-ups for discussion.

	* tmac/s.tmac (initialization): Move definition of \[yogh] (only
	if the output device doesn't already define it) from here...
	(AM): ...to here.

2021-02-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/ms.ms: Use \[ps] special character instead of local
	character definition using numeric code point escape, which is
	less portable.

	Fixes <https://savannah.gnu.org/bugs/?59528>.  Thanks to Bjarni
	Ingi Gislason for the report and a suggested patch.

2021-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (initialization): Call par*define-font-macro with
	arguments "CW" and "R" in nroff mode to silence font warnings
	from documents using .CW macro in nroff mode.

2021-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::init_output): Save value of
	hyphenation maximum consecutive line count register (\n[.hlm])
	more carefully to keep it from being incorrectly parsed as a
	decrement, because negative values of \n[.hlm] are valid (in
	fact, "-1" is the default).  In documents with a large number of
	tables, this can lead to a Persian chessboard problem and an
	integer overflow (at the groff language level, caught and
	handled by src/roff/troff/number.cpp:parse_term()).

	It is wise to wrap a non-literal second argument to the .nr
	request in parentheses if assignment is desired and its value
	can be negative.  See section 5.6.1 ("Setting Registers") of the
	groff Texinfo manual.

	Fixes <https://savannah.gnu.org/bugs/?59993>.

2021-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* test-groff.in: Add support for rfc1345.tmac.

2021-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	Integrate rfc1345.tmac into build system.

	* contrib/rfc1345/rfc1345.am: Do it.
	* Makefile.am: Include contrib/rfc1345/rfc1345.am.

2021-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (open_mac_file): Report problem when
	attempting to open macro files (-m arguments) and the error is
	something other than ENOENT.
	(process_macro_file): Update diagnostic to be more precise; the
	file couldn't be _opened_, not necessarily _found_, and clarify
	that the string being reported back to the user is the argument
	to the -m option, not a file name.
	(macro_source): Update diagnostic to report that the file
	couldn't be _opened_, not necessarily _found_, and include the
	nature of the problem.

2021-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	[tbl]: Save and restore hyphenation parameters.

	* src/preproc/tbl/table.cpp (table::init_output): When starting
	a table, save the hyphenation parameters (\n[.hy], \n[.hla],
	\n[.hlm], \n[.hym], \n[.hys]).  Restore them in the table reset
	macro (confusingly called "3init"), which is called before
	performing each diversion and before exiting a table.

	This enables people to, e.g., turn off hyphenation in a table
	text block with .nh, just as they can turn off adjustment with
	.na, without having to manually reset it.  The next text block,
	and the material after the table, will not be affected.

	Fixes <https://savannah.gnu.org/bugs/?59971>.

2021-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #59971.

	* src/preproc/tbl/tests/\
	save-and-restore-hyphenation-parameters.sh: Do it.
	* src/preproc/tbl/tbl.am (tbl_TEST): Run test.

2021-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am ($(TMACSTRIPFILES)):
	($(TMACMDOCSTRIPFILES)): Remove unidiomatic for loop which
	frustrated parallel make operation.

	Thanks to an anonymous contributor for the report and patch.

	Fixes <https://savannah.gnu.org/bugs/?59958>.

2021-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/ms.ms (Document control settings): Document old FAM string
	and new FR string.

2021-01-29  T. Kurt Bond <tkurtbond@gmail.com>

	[ms]: Add new string FR to hold an expression for computing the
	footnote length relative to the line length, consistently for
	single- and multi-column modes, which \n[FL] has never done.

	* tmac/s.tmac: Initialize FR string to "11/12".
	(@MC): Compute footnote column width using \*[FR] instead of a
	hard-coded "11/12" expression.
	(par@init): Compute default \n[FL] using \*[FR] instead of a
	hard-coded "11/12" expression.

	* doc/groff.texi (Macro Packages/ms/Document control settings):
	* tmac/groff_ms.7.man (Usage/Document control registers):
	Document it.

	Fixes <https://savannah.gnu.org/bugs/?59605>.

2021-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp: Add ADJUST_MAX enumeration constant to
	record maximum valid numerical adjustment mode.
	(adjust): Verify numeric argument against ADJUST_MAX instead of
	a numeric literal.  Ignore excessively large values instead of
	setting adjustment mode to "right".  Update warning diagnostic.

2021-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for .ad and .na requests.

	* src/roff/groff/tests/adjustment_works.sh: Do it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2021-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Filling and Adjustment):
	* man/groff.7 (Requests/Request short reference): Clarify
	behavior of ".na" and ".ad l".

	Thanks to Bjarni Ingi Gislason for pointing out the potential
	for confusion and for his careful review of the new text.

	Fixes <https://savannah.gnu.org/bugs/?59795>.

2021-01-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/grog/grog.pl: Report program name in fatal error
	diagnostics.  Also drop sentence-ending punctuation since Perl
	supplies additional information.

	Continues the long process of fixing Savannah #52463.

2021-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (RE): Style-warn if macro arguments are out
	of range or redundant.

	Fixes <https://savannah.gnu.org/bugs/?55320>.

2021-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	Improve style of troffrc{,-end} files.  Follow established
	idioms and make them consistent with each other.

	* tmac/troffrc:
	* tmac/troffrc-end:
	  - Identify files in header comments as part of GNU troff.

	* tmac/troffrc:
	  - Clarify purpose of .do request.
	  - Identify .X (set by groff -X) as a register, not a string.
	  - Remove temporary registers one per line to make
	    synchronization with foregoing logic easier.  Fixes name
	    space management nits: an undefined string troffrc!Xps was
	    being removed, and troffrc!{ascii,latin1,utf8,cp1047} were
	    not being removed despite being defined.

	* tmac/troffrc-end:
	  - Clarify that file is read after -m file arguments (not "all
	    macro sets", which can be loaded with .mso after this file
	    is processed).
	  - Advise usage of .do for groff extensions.
	  - Line-break one-off conditionals as troffrc does.
	  - Add empty string comment to empty string definitions.

2021-01-14  Dave Kemper <saint.snit@gmail.com>

	Commit 87edb525, from 2003, added character U+2026 (HORIZONTAL
	ELLIPSIS) to most base groff fonts, but there has been no
	kerning information for this character.  To produce consistent
	typography, it should be kerned the same way as the period,
	which is in 818 kern pairs across all the devps fonts.

	Apply the following shell command to the groff description files
	of the PostScript fonts.

	  for file in font/devps/*[A-Z]
	    do sed -Ei\~ 's/(.*)(^| )\. (.*)/&\n\1\2u2026 \3/' $file
	  done

	* font/devps/AB:
	* font/devps/ABI:
	* font/devps/AI:
	* font/devps/AR:
	* font/devps/BMB:
	* font/devps/BMBI:
	* font/devps/BMI:
	* font/devps/BMR:
	* font/devps/HB:
	* font/devps/HBI:
	* font/devps/HI:
	* font/devps/HNB:
	* font/devps/HNBI:
	* font/devps/HNI:
	* font/devps/HNR:
	* font/devps/HR:
	* font/devps/NB:
	* font/devps/NBI:
	* font/devps/NI:
	* font/devps/NR:
	* font/devps/PB:
	* font/devps/PBI:
	* font/devps/PI:
	* font/devps/PR:
	* font/devps/TB:
	* font/devps/TBI:
	* font/devps/TI:
	* font/devps/TR:
	* font/devps/ZCMI: Apply above script.

	Fixes <https://savannah.gnu.org/bugs/?58897>.  However, this
	will need to be done again if afmtodit is used to regenerate the
	above files, or afmtodit will need to be modified to add this
	kerning information itself.

2021-01-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/relocate.cpp (set_current_prefix) [_WIN32]:
	Move declaration of `pathextstr` to lie within preprocessor
	conditional, since it is dereferenced only there.

2021-01-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add support for strsignal().

	POSIX.1-2008 added strsignal() to the C library and recommended
	its use over sys_siglist[], but groff's pipeline management
	hadn't been updated in that respect since that time.

	* configure.ac: Check for strsignal().
	* src/roff/groff/pipeline.c (xstrsignal): Return strsignal() if
	it is defined.

	Thanks to an anonymous contributor for the report and the patch.

	Fixes <https://savannah.gnu.org/bugs/?59835>.

2021-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/libs/libgroff/relocate.cpp (relocatep): Add assertion to
	identify logic error if `curr_prefix` is unexpectedly a null
	pointer.
	(set_current_prefix) [_WIN32]: Allocate memory from heap for
	`curr_prefix` only on Windows; on other systems, this file's
	searchpath() is used to populate `curr_prefix`, and that
	function (except on Windows) performs its own allocation.  Fixes
	memory leak noted by Ingo Schwarze.
	(set_current_prefix) [!_WIN32]: Move logic attempting to set
	`curr_prefix` by calling searchpathext() from here...
	[WIN32]: ...to here.  The PATHEXT environment variable has
	semantics only under Windows, not POSIX systems, so the
	placement of this code seemed erroneous.

	See <https://savannah.gnu.org/bugs/?55475>.

2021-01-06  Colin Watson <cjwatson@debian.org>

	* contrib/glilypond/glilypond.pl:
	* contrib/gperl/gperl.pl:
	* contrib/gpinyin/gpinyin.pl:
	* tmac/hyphenex.pl: Avoid Perl's unsafe "<>" operator.

	The "<>" operator is implemented using the two-argument form of
	"open", which interprets magic such as pipe characters, allowing
	execution of arbitrary commands which is unlikely to be
	expected.  Perl >= 5.22 has a "<<>>" operator which avoids this,
	but also forbids the use of "-" to mean the standard input,
	which is a facility that the affected groff programs document.

	ARGV::readonly would probably also fix this, but I fundamentally
	dislike the approach of escaping data in preparation for a
	language facility to unescape it, especially when the required
	escaping is as non-obvious as it is here.  (For the same reason,
	I prefer to use subprocess invocation facilities that allow
	passing the argument list as a list rather than as a string to
	be interpreted by the shell.)  So I've abandoned this dubious
	convenience and changed the affected programs to iterate over
	command-line arguments manually using the three-argument form of
	open.

	glilypond doesn't need the initial unshift since that's already
	handled in contrib/glilypond/args.pl.

	Fixes <https://savannah.gnu.org/bugs/?55557>.

2021-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Set footnote line length in multi-column
	environments to 11/12ths of the text line length for consistency
	with earlier change to FL register default.

	Thanks to T. Kurt Bond for bringing this issue to my attention.

2021-01-04  John Gardner <gardnerjohng@gmail.com>

	* tmac/strip.sed: Escape '.' wildcard when matching lines using
	.as and .ds requests.

	Fixes <https://savannah.gnu.org/bugs/?59498>.

2021-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	Document use of SOURCE_DATE_EPOCH and TZ.

	The semantics of SOURCE_DATE_EPOCH to groff were not established
	with respect to time zone selection, prompting divergent
	interpretations; Debian and distributions derived from it have
	for several years patched groff to implicitly use UTC as the
	time zone when interpreting the current time (or
	SOURCE_DATE_EPOCH) as a local time.  While a convenient and
	defensible choice for reproducible build efforts[1], it runs
	against the grain of user expectations.  Systems programmers
	like monotonically increasing clocks; the broader user base
	usually prefers a clock that follows an applicable civil
	calendar.  To the latter audience, a difference between
	  $ date "+%Y-%M-%d %H:%m:%S"
	and
	  $ groff <<EOF
	  .af year 0000
	  .af mo 00
	  .af dy 00
	  .af hours 00
	  .af minutes 00
	  .af seconds 00
	  .tm \n[year]-\n[mo]-\n[dy] \n[hours]:\n[minutes]:\n[seconds]
	  EOF
	is difficult to explain.

	* doc/groff.texi (Environment):
	* src/devices/grohtml/grohtml.1.man (Environment):
	* src/devices/gropdf/gropdf.1.man (Environment):
	* src/devices/grops/grops.1.man (Environment):
	* src/roff/groff/groff.1.man (Environment):
	* src/roff/troff/troff.1.man (Environment): Expand description
	of use of SOURCE_DATE_EPOCH to note that it converts the time
	{as seconds since the Epoch} to local time, which motivates
	documentation of the TZ environment variable.  Explain what the
	time stamps are used for: troff merely stores the human-readable
	time components in registers; the grohtml, gropdf, and grops
	output drivers write the information to the output in comments.

	Fixes <https://savannah.gnu.org/bugs/?57218>.

	[1] https://reproducible-builds.org/docs/source-date-epoch/

2020-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/doc.am (.texi.dvi): Call texi2dvi with FORCE_SOURCE_DATE=1
	in the environment, avoiding an embedded timestamp in the
	generated groff.dvi file, which frustrated reproducible builds.
	Thanks to Werner Lemberg for the suggestion.

	* src/roff/groff/tests/string_case_xform_unicode_escape.sh: Fix
	test to no longer use Bash process substitution, resulting in
	nondeterministic file descriptor numbers appearing in test logs,
	frustrating reproducible builds.

	* contrib/pdfmark/pdfmark.am (PDFROFF): Call pdfroff without
	`--keep-temporary-files` option.  Temporary directories are
	created with mktemp(1) and files with an embedded process
	identifier, which frustrates reproducible builds.

	See <https://savannah.gnu.org/bugs/?57218>.

2020-12-21  Dorai Sitaram <ds26gte@yahoo.com>

	* tmac/s.tmac (@IP): Handle inter-sentence space correctly in
	paragraph tags by copying \n[.sss] from the enclosing
	environment to that used to format the paragraph tag.

	Fixes <https://savannah.gnu.org/bugs/?59742>.

2020-12-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #59742.

	* tmac/tests/s_IP_respects_inter-sentence_space_in_tags.sh: Do
	it.
	* tmac/tmac.am (tmac_TESTS): Run it.

2020-12-21  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>

	* src/utils/addftinfo/addftinfo.cpp (usage): Use size_t for loop
	index when iterating over a count of size_t items.  Quiets
	signedness mismatch compiler warning.

	Fixes <https://savannah.gnu.org/bugs/?59583>.

2020-12-20  Colin Watson <cjwatson@debian.org>

	* src/devices/gropdf/gropdf.pl:
	* src/utils/afmtodit/afmtodit.pl: Sort Perl hash keys.  Hash
	iteration order may differ between runs, which makes builds
	harder to reproduce.  Sort hash keys in gropdf and afmtodit
	output to avoid this.

2020-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/ms.ms (Basic Information): Tweak unit definitions.  groff
	defines a typesetter's point as precisely 1/72 inches.  Also use
	the correct symbol for inch units--strictly, it's the same as
	that for "seconds" as in subdivisions of the degree, and not a
	typographical quote of any sort.

	Fixes <https://savannah.gnu.org/bugs/?59463>.

2020-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	[ms]: Set footnote line length to AT&T default.

	groff ms has since its initial implementation used a default
	footnote line length of 5/6ths of the text line length; this may
	correspond to an early AT&T ms default (perhaps documented in
	the 1974 version of the M. E. Lesk paper, "Typing Documents on
	the UNIX System"[1]).  However, as early as V6 Unix (1975), AT&T
	ms actually used a footnote line length of 11/12ths of the text
	line length instead[2].

	Heirloom Doctools and neatroff ms also use this default.

	* tmac/s.tmac: Set default footnote line length to 11/12ths of
	the text line length.

	* doc/groff.texi (ms Document Control Settings):
	* doc/ms.ms (Document control registers): Document new default.

	[1] https://www.troff.org/using-ms.pdf
	[2] https://minnie.tuhs.org/cgi-bin/utree.pl?file=V6/usr/lib/tmac.s

2020-12-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Lower new unplanted trap error to 'mac' warning.

	* src/roff/troff/div.cpp (top_level_diversion::change_trap):
	Change error upon invalid attempt to move an unplanted trap into
	a warning of type 'mac'.

	* doc/groff.texi (Warnings):
	* src/roff/troff/troff.1.man (Warnings): Recast description of
	'mac' warning type to include the above scenario.

	Thanks to Bjarni Ingi Gislason for reporting the diagnostic
	arising in real life, and to Peter Schaffter for the discussion
	and recommendation.  Some bike sheds get painted quickly!

	Fixes <https://savannah.gnu.org/bugs/?59573>.

2020-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_mdoc.7.man: Tweak mandatory macro explanations.

	Update descriptions and template of .Dd, .Dt, .Os usage to
	reflect recent changes and recommended conventions.

	Thanks to Ingo Schwarze, Colin Watson, and Alan D. Salewski for
	the discussion, and Florent Rougon and Robert Bihlmeyer (many
	years ago) for the original report.

	Fixes <https://bugs.debian.org/284002>.

2020-12-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/xtotroff/xtotroff.c (MapFont): Avoid writing past
	the end of a static buffer.  Problem found and patch supplied by
	Bjarni Ingi Gislason.  I tweaked it to comment it differently
	{in case the buffer ever needs to grow, but the prospects of
	future X11 server-side font rendering development seem dim} and
	use snprintf() instead of retaining the existing sprintf().

	Fixes <https://savannah.gnu.org/bugs/?55257>.

2020-12-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/xtotroff/xtotroff.c (CanonicalizeFontName)
	(FontNamesAmbiguous, MapFont, main): Format diagnostic messages
	more consistently with GNU Coding Standards.  Prefix with name
	of complaining command.  Put argument literals in quotation
	marks.  Put each message on one line only.

2020-11-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Parameters): Fix error in example.  Arguments
	to .als were in the wrong order (.als is not ln(1)).  Also mark
	output to the standard error stream using the @error Texinfo
	command instead of @result.

	Thanks to Dorai Sitaram for finding this error.

	Fixes <https://savannah.gnu.org/bugs/?59566>.

2020-11-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Debugging): Update with a more helpful
	introduction, summarizing available procedures.  Mention
	backtracing since it is much more useful now (post-groff
	1.22.4.)

	* man/groff.7 (Debugging): Add new section summarizing
	material added to our Texinfo manual.

	* man/groff_diff.7.man (Debugging): Add new section describing
	groff extensions.

2020-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Traps): Update.  Organize subsubsections "Page
	Location Traps" and "Diversion Traps" under new subsection node
	"Vertical Position Traps" to make the conceptual organization
	more clear.  Define and discuss trap visibility earlier.
	Document unit used for page location trap reporting.  Introduce
	analogy of .wh and .ch requests as queue operations.  Document
	what happens when the same macro is planted as a trap in
	multiple locations; supply example.  Supply example of .itc
	usage.  Consistently refer to an end-of-input macro as such, to
	contrast it with the "end macro" that can be used with, e.g.,
	.de and .ig requests.

	* man/groff.7 (Traps): Add new section summarizing
	language feature.

2020-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common-u (doc-footer): When performing
	double-sided page layout, set page number on outside of _recto_
	{odd-numbered} pages, as is conventional and for consistency
	with man(7).

	* tmac/groff_mdoc.7.man
	(Formatting with groff, troff, and nroff): Document what
	double-sided layout (not "printing") means.  Also correct
	description of continuous rendering, which implied that page
	headers and footers were not written at all, and used an
	incorrect groff driver name.

	Fixes <https://bugs.debian.org/919890>.  Also see:
	https://lists.gnu.org/archive/html/groff/2019-01/msg00021.html
	Thanks to Ralph Corderoy for the discussion.

	* tmac/tests/doc-D_places_page_numbers_correctly.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2020-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common-u (doc-header): Fix infinite loop when
	attempting to trim header string (like "FTP(1)") to fit when the
	available title length won't allow even extreme shortening.
	Measure the string before and after calling .substring on it,
	and break out of loop if it didn't get shorter.

	Problem dates back to at least
	ed63b0ae76a611b581601a1afc192f6a7367be6f (7 July 2002), possibly
	as far as the Great Mdoc Rewrite of
	058f72af832fc68488d33cd09ec819e5c560fa09 (23 March 2001).

	One can never check loop invariants too many times...

	Fixes <https://bugs.debian.org/411227>.

	* tmac/tests/\
	doc-do_not_loop_infinitely_when_shortening_headers.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

2020-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh: Recognize -b and -z options and pass
	them through to troff.  Document them in usage message.
	* src/roff/nroff/nroff.1.man: Document new -b and -z options.

2020-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/div.cpp (top_level_diversion::change_trap):
	Emit error diagnostic if an attempt is made to move an unplanted
	macro.  This could have been a warning, as it's pretty harmless
	{though possibly a big surprise to anyone who was wondering why
	their .ch was a no-op}, but there's no good warning category for
	this kind of problem and I am not about to start a bike shed
	discussion about it right now.

2020-11-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi: Update.  Add introductory material.  Rewrite
	the first section of the "gtroff Reference" chapter of our
	Texinfo manual.  It is written as an introduction for readers
	who want to go straight to "raw" troff without knowing much or
	anything about existing macro packages.  Thanks to Dave Kemper
	and John Gardner for feedback and support.

	Clarify whitespace usage.  "Whitespace" is defined in this
	manual as "spaces, tabs, and newlines".  Say only "spaces and
	tabs" when newlines should not be included.

	Rename "Font Files" to "Device and Font Files".

	Rename "Manipulating Filling and Adjusting" to "Manipulating
	Filling and Adjustment".

	Update discussion of "copy mode".  Rename from "copy-in mode",
	which I don't think eludicdated anything; is there a "copy-out
	mode"?  Rename nodes accordingly.  Attempt to explain more
	clearly.  Recast to shift emphasis to what _isn't_ merely copied
	in copy mode, since that is what seems to cause confusion among
	the inexperienced.

	Update "Conditionals and Loops".  Add introductory paragraph.
	Add nodes/subsections "if-then" and "Conditional Blocks".  Add
	subsection "Conditional Blocks" to explain the behavior of the
	\{ and \} escapes much more precisely.  I don't think this
	syntactical area is well understood.  Supply examples.

2020-11-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add style checks to man(7) macro package.

	Not otherwise documented yet; experimental--subject to change.

	* tmac/an-old.tmac: Initialize CHECKSTYLE to false if not
	already set.
	(an-style-warn): New macro emits diagnostic of type "style" when
	called if CHECKSTYLE register is true.
	(TH): Call an-style-warn if fewer than two or more than five
	arguments are seen.
	(RI, IR, IB, BI, RB, BR): Call an-style-warn if fewer than two
	arguments are seen.

2020-11-11  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	Update copyright.

	* update-copyright.sh: use gnulib's 'update-copyright' script.
	Pass this script in directories 'arch', 'contrib', 'font',
	'man', 'tmac', 'src' and on a list of extra files.

	* FOR-RELEASE: mention this point.

2020-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/preconv.1.man (Description): Fix error:
	groff's -K option, not -k, specifies a character econding (and
	overrides GROFF_ENCODING in the environment).  Also explain how
	valid encoding strings are determined.

	Thanks to Bjarni Ingi Gislason for the report.

	Fixes <https://savannah.gnu.org/bugs/?59445>.

2020-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::compute_separation_factor):
	Add word "table" to diagnostic message to better cue the user
	that it is produced by roff that has been injected into the
	document by the tbl(1) preprocessor.  The other 3 such possible
	diagnostic messages already do this.  Thanks to Bjarni Ingi
	Gislason for bringing the inconsistency to light.

	Fixes <https://savannah.gnu.org/bugs/?59443>.

2020-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_mdoc.7.man (Predefined strings): Ensure the table
	fits even on ASCII and Latin-1 terminals.  Thanks to Bjarni Ingi
	Gislason for the report.

	Fixes <https://savannah.gnu.org/bugs/?59424>.

2020-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_mdoc.7.man (General text domain/Enclosure and
	Quoting Macros): Fix errors in macro descriptions.
	<.Dq>: Encloses its arguments in directional double quotes where
	available.
	<.Eq>: Misrendered example; say "XstringY" rather than
	"XXstring".
	<.Sq>: Encloses its arguments in directional single quotes where
	available.

2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add support for CS and CT registers to mdoc(7), just like in
	man(7), from a year ago.

	* tmac/doc.tmac-u (doc-print-recursive): Call .stringup on each
	argument if register doc-do-capitalize is true.
	* tmac/mdoc/doc-common-u (Dt): Call .stringup on
	doc-document-title if \n[CT] is true.
	(Sh): Set doc-do-capitalize to value of \n[CS].  Set
	doc-do-capitalize false before returning.
	* tmac/mdoc/doc-ditroff-u:
	* tmac/mdoc/doc-nroff-u: Set CS and CT registers to 0 (false)
	if the user has not defined them.

	* tmac/groff_mdoc.7.man \
	(Formatting with groff, troff, and nroff): Document it.

	* tmac/tests/doc-CS_works.sh:
	* tmac/tests/doc-CT_works.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run tests.

2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_overstrike, do_bracket)
	(do_name_test, do_expr_test, do_zero_width, do_width)
	(do_special, do_if_request, read_color_draw_node): Improve
	diagnostic messages for missing closing delimiters by describing
	the incomplete structure and the problem token.
	(read_rgb, read_cmy, read_cmyk, read_gray): Improve English
	syntax of diagnostic message when color definition missing.

2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-ditroff-u:
	* tmac/mdoc/doc-nroff-u: Recognize but ignore the groff_man(7)
	string HF and registers FT, IN, P, SN, and X (by initializing
	them empty or zero if they are not set).  This reserves them so
	that they don't become used for divergent purposes.  man(1)
	programs set these and other parameters already handled (like
	LL) to configure page rendering, and it would break the
	macro-package agnosticism afforded by andoc.tmac to expose
	different externally-programmable registers and strings.
	* tmac/groff_mdoc.7.man \
	(Formatting with groff, troff, and nroff): Document this.

2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Implement \*< and \*> strings for subscripting.
	groff ms has had (extension) strings for superscripting since
	1991 at the latest, and the asymmetry possessed me of a madness.
	Both pairs of string names follow similar usage in Eric Allman's
	"me" macros.

	* NEWS:
	* doc/groff.texi:
	* tmac/groff_ms.7.man: Document it.

2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_mdoc.7.man (Predefined strings): Fix error: the
	\*[Lq] and \*[Rq] strings degrade to neutral double quotes (")
	on "nroff" devices (-Tascii and -Tlatin1), not "``" and "''".

2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac (ds*end!0): Improve diagnostic to mention .RD.

2020-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/s.tmac: Revise diagnostic messages.  Define a common
	prefix string, starting all such messages with "s.tmac".
	Continues the long process of fixing Savannah #52463.  Drop the
	word "macro" from diagnostic since this will now be clear from
	the prefix.  Prefix every macro name in a diagnostic message
	with a leading dot; this was already done in four cases.
	(cov*first-page-init): Use temporary string to avoid multi-line
	diagnostic message.
	(@NH): Use temporary string to prevent overlength line.

	A further benefit of this revision is that index information
	produced by ms's .IX macro (which writes to the standard error
	stream) will now be trivially easy to extract even for documents
	that cause diagnostic messages.  One can simply filter them with
		grep -v '^s\.tmac:'
	or similar.

2020-10-28  Ingo Schwarze <schwarze@openbsd.org>

	* man/roff.7.man, tmac/groff_man.7.man.in: Correct man(7)
	history.

2020-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	Fix ms .R macro to work as documented, by handling its arguments
	instead of ignoring them.

	* tmac/s.tmac (R): Delete.  During set up, call
	par*define-font-macro for R font just as we do for B, I, and BI.

	Problem dates back at least to groff 1.02, June 1991.

	* tmac/tests/s_R-handles-its-arguments.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?59348>.

2020-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Fix ms .TC macro by allowing it to actually use lowercase Roman
	numerals for the page(s) of the table of contents when a custom
	title (header or footer) is defined containing '%'.

	As a side effect, eliminate the PN register, which was
	apparently misused because it was undocumented and had a name
	just long enough to be both suggestive and ambiguous.  Another
	pin goes into my Ken Thompson voodoo doll.

	* tmac/s.tmac (IX): Write out page number of index term(s) using
	the % register (instead of PN), obtaining whatever format is
	assigned to the register at that time.
	(CH): Similarly, output %, not PN, in the center of the default
	heading.
	(PT): Save the format of %, set it to decimal, copy its value to
	a new register, pg*page-number-in-decimal, then restore %'s
	previous format.  Compare the new register, not %, to 1 to
	determine whether special page one behavior should be used.
	(pg*end-page): Assign pg*next-format to %, not PN.
	(XA): Define toc*num with the interpolation of %, not PN.

	* tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Test.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Problem appears to be very old; as I read it, Larry Kollar was
	complaining of it in his ms.ms document over 20 years ago.

	Fixes <https://savannah.gnu.org/bugs/?59345>.

2020-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7 (Requests/Request short reference) <.af>: Fix
	error; "l" is not a valid register format.  Explain what the
	request does, and the default format, as tersely as possible.

2020-10-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	Use only `malloc()` and `free()` to manage memory of paths
	opened by the parser instead of mixing in C++ new/delete
	management under some runtime-dependent circumstances.

	* src/libs/libgroff/relocate.cpp (relocatep): Use `malloc()`,
	not new.
	* src/roff/troff/input.cpp (process_macro_file)
	(process_startup_file, macro_source): Use `free()`, not
	`{a_,}delete()`.

	Thanks to an anonymous contributor for the report and patch.

	Fixes <https://savannah.gnu.org/bugs/?56694>.

2020-10-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_char.7.man (Description/Special character escape
	forms): Clarify discussion of Unicode Normalization Form D and
	its applicability to code points acceptable in Unicode numeric
	special character escapes.  Also document that these escapes
	must use uppercase hexadecimal digits.

	Attempts once again to slay the unkillable beast that is
	<https://savannah.gnu.org/bugs/?57618>.

2020-10-21  Ingo Schwarze <schwarze@openbsd.org>

	On systems without NAME_MAX, use FILENAME_MAX as a last resort.

	Problem reported by Eli Zaretskii <eliz at gnu dot org>
	on MS Windows in https://savannah.gnu.org/bugs/?55449

2020-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (environment::possibly_break_line):
	Emit break warning and return if the output width is not
	positive.  The code assumes that it will be and loops infinitely
	if it isn't.  I _think_ this is because we're not able to get
	width data for (some?) CJK glyphs.  Based on a patch by Osamu
	Sayama.

	* src/roff/groff/tests/\
	do_not_loop_infinitely_when_breaking_cjk.sh: Test it.
	* src/roff/groff/groff.am: Run test.

	Fixes <https://savannah.gnu.org/bugs/?44018>.

2020-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::init_output): Save the value
	of \n[.tabs] when starting a table.  In the reset macro, restore
	the saved value.

	Based on a patch by Bjarni Ingi Gislason (tweaked to use a more
	normative preprocessor symbol; "REG"s aren't "NAME"s).

	* src/preproc/tbl/tests/save-and-restore-tab-stops.sh: Test it.
	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?42978>.

2020-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/nroff/nroff.sh: Recognize -E option and pass it
	through to troff.  Document it in usage message.
	* src/roff/nroff/nroff.1.man: Document new -E option.

	Based on a patch by Ingo Schwarze.

	Fixes <https://savannah.gnu.org/bugs/?44289>.

2020-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Stop remapping ` and '.  Our own pages now
	appear to be clear of wrong-quote problems, so let's make them
	visible if they recur.  Those who don't want to fix bad man
	pages (distributors, site admins) can restore the mappings in
	their man.local files.

2020-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-warn): New; emits warning diagnostic.
	(R): Use new macro instead of .tm* requests directly.

2020-10-18  Ingo Schwarze <schwarze@openbsd.org>

	#include "config.h" before <stdio.h>

	Required with e.g. gcc 4.2.1 because gnulib/lib/stdio.in.h
	uses the "restrict" keyword since this gnulib commit:
	commit 182afcba2635cbff91240656c7fb3742dd23ab6f
	Author: Bruno Haible <bruno@clisp.org>
	Date: Sat Feb 22 20:57:30 2020 +0100

	Otherwise, the build may die from the declaration of
	various printf-like functions with messages like:
	./lib/stdio.h:851: error: expected ',' or '...' before 'fp'

	* src/libs/libgroff/assert.cpp, src/libs/libgroff/errarg.cpp,
	src/libs/libgroff/error.cpp, src/preproc/eqn/eqn.ypp:
	#include "config.h".

2020-10-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	hpftodit: incorrect 'delete' after new[]

	* src/utils/hpftodit/hpftodit.cpp (output_font_name): use
	'delete[]'.

	Fixes bug #55331. Found by David Binderman, fixed by Ingo
	Schwarze.

2020-10-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	preconv: don't use libuchardet if input is stdin

	* src/preproc/preconv/preconv.cpp (do_file): don't call
	detect_file_encoding if input file is "-"

	This fixes the failure on MS-Windows described #55334, however
	this does not fix the encoding detection with uchardet if the
	input is stdin (the user would have to pass with -D the correct
	encoding as explained in the man page).

2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/lex.cpp (troff_defs): Set the "..." token on
	the baseline, not vertically centered, aligning the actual
	behavior with what our eqn(1) man page has claimed since 2007.

	Fixes <https://savannah.gnu.org/bugs/?59285>.

2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grops/grops.1.man
	(Usage/TrueType and other font formats): Remove dead URL to
	ttftot42 utility.  Update URL to fontforge tool.  Replace much
	of the discussion with an example, motivated by Jordan Torbiak's
	"groff-install-font" script on GitHub Gist, of how to add the
	Roboto Slab Regular font to a user-local groff font directory
	{and how to test it, too}.

	Fixes <https://savannah.gnu.org/bugs/?58077>.

2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Report program name in warning
	diagnostics.

	Continues the long process of fixing Savannah #52463.

2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Add fallback for lq, rq strings.

	Define \*(lq and \*(rq as '"' if the output device has no \(lq
	or \(rq special character escapes defined (respectively).

	This is a bit belt-and-suspenders for groff since our output
	devices all guarantee availability of these glyphs, but if this
	macro file gets used with other implementations (and if they
	support the 'c' conditional), it should prevent the strings from
	producing empty output.

	Man page writers should simply use \(lq and \(rq unless they are
	aiming for pathological levels of portability (e.g., composing
	man pages today for consumption on simulators of 1980s Unix
	systems).

2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Define an-end with .de1.  We need to define
	an-end with de1 (execute macro with compatibility mode off)
	because, as of 37b4180a27a6eeaea429e40ec278abefcda7f3a7 (11
	October), it can now be called from a trap executing in a
	context whence compatibility mode might be on (namely,
	"reload-doc" in andoc.tmac).

2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/eqn/main.cpp (main):
	* src/preproc/pic/main.cpp (main):
	* src/preproc/tbl/main.cpp (main):
	* tmac/eqnrc:
	* tmac/troffrc: Perform checks of register and macro definitions
	with a .do request, since we might be in compatibility mode.

2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (do_if_request): Emit warning of type
	"syntax" if a groff conditional expression extension is used
	when compatibility mode is active.

	* doc/groff.texi:
	* src/roff/troff/troff.1.man: Update description of "syntax"
	warning type to be more general.  It was inaccurate, referring
	only to "dubious syntax in numeric expressions", which was not
	the case.  Instead it was being used only for poor construction
	of character classes with the .class request.

2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (main): Stop ignoring -T.  GNU tbl
	was undocumentedly ignoring the -T option; apparently IRIX tbl
	implemented it, something on the system called tbl with that
	option (I'm guessing IRIX's man(1)) and its users spammed James
	Clark with bug reports.  We can probably weather the volume of
	such spurious reports from IRIX users today.

2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/main.cpp (main): Clarify fatal diagnostic in
	generated document by informing the user that the program is
	aborting, and also that it is groff extensions that are required
	rather than GNU troff per se (since Heirloom Doctools troff
	claims groff extension support via the .g register).

2020-10-14  Ingo Schwarze <schwarze@openbsd.org>

	In groff(1), fix the combination of -v with -k, -j, and -J.

	* src/roff/groff/groff.cpp: Pass the -v option through to the
	preconv, chem, and ideal preprocessors, just like for all
	other preprocessors, to print the version of the preprocessor
	and to avoid garbage output.

	Bugfix patch from Eli Zaretskii <eliz at gnu dot org>
	submitted in: https://savannah.gnu.org/bugs/?55297

2020-10-12  Bertrand Garrigues <bertrand.garrigues@laposte.net>

	Update 'gnulib' submodule.

	* gnulib: now points on d60a35e94c4f5b8f09f15828242418f5073d46e7
	from 'gnulib' repository.

	* configure.ac: minimum autoconf version is now 2.64 due to
	gnulib upgrade.

	* FOR-RELEASE: add the gnulib update to the checklist.

2020-10-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac: When switching between macro packages in
	andoc and using continuous-rendering mode, flush any partially
	collected output line and write page footer.
	(reload-doc): Call an-end if it is defined.
	(reload-man): Call doc-end-macro if it is defined.
	* tmac/tests/andoc-flush-between-packages.sh: Add regression
	test.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?59106>.

2020-10-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac: Remove traps set by mdoc package by the names
	they actually use.
	* tmac/tests/andoc-clear-doc-traps.sh: Add regression test.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Fixes <https://savannah.gnu.org/bugs/?59246>.

2020-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::init_output): In the release
	macro written to the output, reword the warning diagnostic that
	is emitted when a table row is to be output without enough room
	before the next page location trap.  The former wording said
	that a "text block" would not fit on the page, and that is
	normally how table rows grow longer than one line in the first
	place.  However, there are other ways the conditional can be
	satisfied, as witnessed in Savannah #57665, so simply say what
	is known; that the table _row_ overruns the space to the next
	trap (we say the row won't "fit on [the] page").

	Fixes <https://savannah.gnu.org/bugs/?59233>.

2020-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp
	(double_line_entry::double_line_entry):
	(double_line_entry::simple_print): Remove garbage lines
	inadvertently added in previous commit.

2020-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Stop tbl from injecting spurious blank lines (and emitting
	spurious warnings about tables and "text blocks" not "fitting on
	a page") into long tables in man pages when continuous rendering
	is used (the default for nroff output devices).

	* src/preproc/tbl/table.cpp (USE_KEEPS_REG): New preprocessor
	symbol stores name of groff register for dynamic determination
	of keep usage.
	(table::init_output): If the NOKEEP flag is not set, then in
	generated groff output, see if the usekeeps register is defined;
	if not, define it and enable usage of keeps.
	(table::do_row): In groff output, check usekeeps register before
	calling keep and release macros.
	(table::do_bottom): In groff output, check usekeeps register
	before calling release macro.

	* tmac/an-old.tmac (TS): Set the usekeeps register used by tbl
	to the logical complement of the man(7) cR (continuous
	rendering) register.

	* tmac/tests/an-old_TS_do_not_keep_tables_when_cR_set.sh: Add
	regression test.
	* tmac/tmac.am (tmac_TESTS): Run test.

	Problem appears to date back to the introduction of continuous
	rendering in groff 1.17 (3 May 2001).

	Fixes <https://savannah.gnu.org/bugs/?57665>.

2020-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (simple_entry::position_vertically):
	(block_entry::position_vertically):
	(table::determine_row_type):
	(printfs): Update assertions to indicate what actually went
	wrong.

2020-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/node.cpp: Make diagnostics slightly more
	informative in unusual error cases.
	(real_output_file::~real_output_file): If ferror() reports error
	status on a stream say that, instead of "error writing".  If it
	does not, but fflush() fails on the stream, describe the flush
	as failing, and use strerror() since fflush() sets errno.  If
	pclose() fails, say that we were unable to close a pipe instead
	of repeating the name of the C library function to the user, who
	might not be a C programmer.  Report strerror() in this case and
	for a failing fclose().
	(real_output_file::flush): Repeat updated fflush() logic from
	previous function.

2020-09-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (register setup): Make interaction of \n[C]
	register and HTML output more clear in code and comments.

2020-09-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/regression_savannah_59202.sh: Reduce test
	case.

2020-09-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	Fix SEGV arising from recursing destructor.

	* src/roff/troff/node.h (output_file): Add class member
	`is_dying` to track whether destructor has already been entered;
	initialize false.
	* src/roff/troff/node.cpp (real_output_file::~real_output_file):
	Set `is_dying` true when destructor entered.
	* src/roff/troff/div.cpp (cleanup_and_exit): Only delete
	`the_output` object if it is not already being destroyed.
	* src/roff/groff/tests/regression_savannah_59202.sh: Add test.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	Thanks to "hackerb9" for reporting the problem.  Problem appears
	to date back to groff 1.02 (June 1991) or earlier.

	Fixes <https://savannah.gnu.org/bugs/?59202>.

2020-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (register setup): Condition decisions on
	\n[an-html] rather than a string comparison using \*[.T]; that
	is what the register is there for.

2020-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/andoc.tmac: Save alias to .ne request.
	(reload-doc): Restore .ne request, which an-old.tmac meddles
	with if continuous rendering is used.  (The meddling ultimately
	dates back to 777e2d262862621966c18d685a000cc88f432bc6, 26
	January 2002, which simply redefined .ne as empty on nroff
	devices.)

2020-09-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	Ship tests in distribution archive.

	* src/preproc/preconv/preconv.am (EXTRA_DIST):
	* src/roff/groff/groff.am (EXTRA_DIST):
	* src/roff/nroff/nroff.am (EXTRA_DIST):
	* tmac/tmac.am (EXTRA_DIST): Add
	$({preconv,groff,nroff,tmac}_TESTS), as appropriate.

	* src/roff/nroff/nroff.am (MOSTLYCLEANFILES): Stop adding
	$(nroff_TESTS), which can only have unhappy consequences.

2020-09-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am: Fix problem with recently-relocated mdoc macro
	files not ending up in the right place in the distribution
	archive.
	(dist_tmac_DATA): Also include $(TMACUNSTRIPFILES).
	(TMACMDOCSTRIPFILES): Rename from $(TMACMDOCFILES).  Update
	interpolation sites.
	(TMACMDOCUNSTRIPFILES): New variable holds mdoc macro files in
	the tmac/mdoc subdirectory.  Stop adding these files to
	$(TMACUNSTRIPFILES) since those reside in tmac/ directly.
	(EXTRA_DIST): Add $(TMACMDOCUNSTRIPFILES).
	($(TMACSTRIPFILES)): Depend only on $(TMACUNSTRIPFILES).
	($(TMACMDOCSTRIPFILES)): Add new rule, much like the foregoing.
	Depend on $(TMACMDOCUNSTRIPFILES) and copy files into tmac/mdoc.
	(dist-hook, tmac-dist-hook): Remove; they no longer do any
	distinct work.

	Fixes <https://savannah.gnu.org/bugs/?59186>.

2020-09-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/tbl/table.cpp (table::init_output):
	(table::compute_expand_width):
	(table::compute_separation_factor): Use consistent format for
	diagnostic messages.
	  - Do not spread a single diagnostic across multiple lines.
	  - Report messages in GNU Coding Standards format, that is:
	  - Report the name of the file the problem is in...
	  - ...then the line number...
	  - ...then the diagnostic severity level...
	  - ...then the specific problem.

2020-09-26  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Emit warnings when configuration registers
	are ignored when producing output for HTML.

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (an-p-footer): Define \*[an-page-string] if
	(1) the output device is not HTML; (2) \n[X] has been defined;
	and (3) the page number has not yet reached the threshold
	defined by \n[X].

	Fixes <https://savannah.gnu.org/bugs/?59179>.

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for Savannah #59179.

	* tmac/tests/an-old_X_register_works.sh: Do it.
	* tmac/tmac.am (tmac_TESTS): Run it.

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac:
	* tmac/doc.tmac-u: Emit more informative fatal diagnostic when
	installed version of groff is too old.  Report the version found
	and explicitly note consequent abort.

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am: Regenerate stripped macro files upon changes to
	any of their unstripped counterparts.  This is crude, but they
	weren't being regenerated at _all_.  Defeating a central
	function of Make is bad.
	(TMACUNSTRIPFILES): New variable.  Populate with -u files.
	($(TMACMDOCFILES) $(TMACSTRIPFILES)): Depend on
	$(TMACUNSTRIPFILES).

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac:
	* tmac/andoc.tmac:
	* tmac/doc.tmac-u:
	* tmac/s.tmac: Clarify fatal diagnostics by informing the user
	that the program is aborting.

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/www.tmac.in: Revise diagnostic message handling.
	(www:fatal): New macro handles fatal macro usage errors.
	(www:lenstr): Use www:fatal instead of writing to standard error
	with .tm (rather than www:error) and then calling .ab without
	arguments, which produces an unsightly "User Abort." message.
	(www:lenstr):
	(www:splitstr):
	(www:url_breaks):
	(www:url_breaks_split):
	(LINKSTYLE): Report expected number of arguments in diagnostics.
	(www:fontstyle): Shorten diagnostic message.

2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/div.cpp
	(top_level_diversion::clear_diversion_trap): Fix copy and paste
	error in diagnostic, which wrongly reported that a top-level
	diversion trap couldn't be "set" when "clear"ed was meant.

2020-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/grn/main.cpp (conv):
	* src/roff/troff/node.cpp (suppress_node::tprint): Remove
	embedded newlines from diagnostic messages.

2020-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Move setup of remaining rendering option
	parameters (registers C, D, P, and X) to end of file.

2020-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Move setup of rendering parameter
	registers IN and SN from here to the end of the file.  Update
	comments.

2020-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Drop \*[an-empty] string.  This string is
	documented as preventing "looping" (presumably infinitely) if
	someone calls a two-font macro with an inconvenient parameter;
	the example shown is ".RB ( \\ )".  This string was being
	interpolated at the end of each argument pair to the two-font
	macros BI, BR, IB, RB, and RI.  This code dates back to groff
	1.10 (dc5351364982f78f8c630f1e856d692d4a82666f, 26 November
	1995).  Did you notice a two-font macro missing?  It was: IR.
	Using it with the proscribed input fails to cause a problem; the
	others similarly operate just fine when the empty string
	interpolation is removed.  Presumably at some point in the past
	25 years, this workaround became unnecessary.
	(BI, BR, IB, RB, RI): Remove interpolations of string.

	* tmac/tests/an-old_avoid_two-font_denial_of_service.sh: Add
	regression test.
	* tmac/tmac.am (tmac_TESTS): Run test.

2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Refactor continuous rendering handling.
	Relocate set up of \n[cR] to end of file in parallel with other
	rendering parameter management.  Instead of conditionally
	defining the an-ne and an-bp macros, define them
	unconditionally.  Also define them with .de instead of .de1,
	since they will only be called within the contexts of macros
	that are already running with compatibility mode off (i.e., the
	public interface macros).  Relocate definition of an-end to sit
	alongside these other continuous-rendering-mode specific macros
	and avoid a forward reference and scattering of \n[cR]
	conditionals around the file.
	(an-set-up-continuous-rendering): Define new macro to move
	macros (and end macro) into place.  Call it at the end of the
	file only if cR eventually winds up being true.

2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Improve name space management.  Rename .ne
	request to .an-ne instead of outright clobbering it (and in
	parallel with .an-bp).  Rename 'an-ne' register to 'an-need' to
	prevent confusion with renamed request.

2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Drop .ll hack for LL register.

	Drop the .ll hack for setting the line length on nroff devices.

	Once upon a time, the only way to get man pages to render on a
	terminal at any width other than the nroff default of 65n was to
	put an .ll request into the page--a mortal sin against
	portability--or your man(1) program could sneak such a request
	into nroff's input stream.

	Also, long ago, John Eaton of UT Austin wrote a man(1) program.
	In a few years this implementation branched into two lines of
	development, which I'll call man-db man (Wilford/Polacco/Watson)
	and another, Brouwer/Lucifredi man, which as of this writing saw
	its last release in 2011 (1.6g).

	The man and mdoc macros of groff 1.18 (July 2002) introduced an
	LL register to configure the line length, respecting an -rLL
	command-line option.  The source change was made by Werner
	Lemberg on 3 May 2002 and Colin Watson updated man-db man(1)--on
	the same day!--to synthesize the option when calling groff.

	Later, in August 2005, Keith Marshall, a user of version 1.5m of
	Brouwer/Lucifredi man(1), which did not set the LL register,
	suggested that the existing .ll setting (technically, the value
	of \n[.l], the only way the result of an .ll request could be
	introspected) be honored in the absence of the LL register.
	However, it is impossible to distinguish a user-supplied ".ll
	65n" request from nroff's default setting, which was in that
	case overridden to the modern default of 78n.

	And so, in what is now git commit
	f9d5df4aebd3d834b4084ffefa52a115e00dce38 (1 September 2005), it
	was done.

	This led to (1) surprising behavior for users accustomed to old
	methods and desirous of the nroff default and (2) lengthy
	apologia in groff source code comments and the groff_man(7) man
	page.

	Ironically, Brouwer/Lucifredi man(1) had already added support
	for the LL register by the time of its 1.6 release two months
	earlier (20 June 2005).  (Curiously, it did so similarly to the
	old .ll hack, by injecting an '.nr LL' request into groff's
	input stream, rather than using the -r command-line option.)
	Moreover, Marshall and the groff list were already aware of
	this, but the change was accepted anyway because version 1.6
	was "too new"!  (Distributions are slow sometimes, true...)

	Let us survey the field in 2020.  man-db man(1) has supported
	the LL register for eighteen years, and Brouwer/Lucifredi man(1)
	for fifteen.  Heirloom Doctools's man macros set the line length
	to 78n on nroff devices unconditionally.  mandoc(1) similarly
	also always formats for 78 columns on terminals.  groff's
	mdoc(7) macros grew support for LL in parallel with man(7) in
	2002 and never added the \n[.l] introspection at all.

	There no longer seems to be any reason to preserve this hack.

	* tmac/an-old.tmac (initialization): Drop complex setup of LL
	register.
	(TH): Relocate line length reset; no behavior change.
	(after .mso man.local): Initialize LL only if the user hasn't;
	use device default in troff mode, and 78n in nroff mode.

	* tmac/groff_man.7.man.in (Options) <-rLL>: Stop documenting .ll
	hack.

	Fixes <https://savannah.gnu.org/bugs/?58992>.

2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_LL_init_sanely.sh: Add test.
	* tmac/tmac.am (tmac_TESTS): Run test.

2020-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/xditview/GXditview.ad: Widen the default geometry
	to accommodate the width of a page rendered using the X100-12
	device.  Display devices these days have much greater horizontal
	resolution than they did 20 years ago.

2020-09-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Use correct point size default for
	X{75,100}-12 devices.

2020-09-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/mdoc/doc-common-u (doc-prepare-section-heading): New
	macro defines new string doc-sec-head to enable recognition of
	mixed-case section headings in mdoc man pages.  For example,
	"Name" and "Description" are now recognized in addition to
	"NAME" and "DESCRIPTION".
	(doc-section-{name,synopsis,library,description,see-also,files,
	authors}): Redefine strings to be mixed-case.  Add trailing
	comment guard per recommended best practice.
	(Sh): Call doc-prepare-section-heading instead of
	doc-first-parameter, and compare predefined section strings to
	doc-sec-head instead of doc-str-dfp.

	* tmac/tests/doc-accept-mixed-case-section-headings.sh: Test it.
	* tmac/tmac.am (tmac_TESTS): Run test.
	* tmac/tests/doc-smoke-test.sh: Use mixed-case section headings.

2020-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* makevarescape.sed: Use \[] form of special character escapes.

	The only man page we have that doesn't turn compatibility mode
	off (neqn) also doesn't use any sed-substituted patterns where
	characters replaced by a \[] special character escape form are
	likely to be used.

	The @g@ command prefix is the main avenue for intrusion of such
	escapes, but I think it improbable that many people are going to
	include apostrophes, double quotes, carets, grave accents, or
	tildes in the command prefix; some or all of these will pick
	fights with the shell and require quoting that we don't
	represent in man page text anyway.

	On top of that, neqn is largely a stub page.

	If it's a problem, a better fix than reverting this is to make
	neqn switch out of compatibility mode like our other man pages.

2020-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>

	* FOR-RELEASE: Start a release checklist.  We probably should
	have done the afmtodit.tables update for 1.22.4.  There were no
	AGL changes and the Unicode decomposition changes were limited
	to additions for Balinese (11), CJK compatibility ideographs
	(5), and 13 code points outside the Basic Multilingual Plane.

2020-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.tables: Regenerate using Unicode
	13.0.0.

2020-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	make-afmtodit-tables: Automate AGL reassignments.

	Automate the procedure done manually in
	b72b91e85e80a69304e6569db535bcca0e0ecab5 (9 April 2007), so that
	it doesn't regress when we regenerate afmtodit.tables.

	* src/utils/afmtodit/make-afmtodit-tables: Do it.
	* src/utils/afmtodit/afmtodit.tables: Regenerate it.

2020-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/groff.1.man (Options) <-E>:
	* src/roff/troff/troff.1.man (Options) <-E>: Document that -E
	implies -Ww.

	Fixes <https://savannah.gnu.org/bugs/?59030>.

2020-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_char.7.man: Revise glyph descriptions.

	Fixes <https://savannah.gnu.org/bugs/?59031>.

2020-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tty.tmac: Define fallback glyphs for Bell System logo
	{non-breaking adjustable space} and radical extension and square
	root extension (both dummy characters '\&') to suppress warnings
	from groff_char(7).  As none of these are encoded in Unicode it
	seems unlikely they will become supported soon.

2020-08-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/troff.1.man (Options) <-I>: The current working
	directory is searched _last_, not first, unless the order is
	altered with "-I .".

	* src/roff/groff/groff.1.man (Options) <-I>: Rearrange
	description.

2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Update mdoc package to honor HY register as man does now, per
	suggestion from Colin Watson.  Recognize but ignore AD string
	for man package compatibility (essentially "reserving" it),
	though mdoc intentionally does not permit configuration of
	adjustment.

	* tmac/mdoc/doc-ditroff-u:
	* tmac/mdoc/doc-nroff-u: Do it.

	* tmac/mdoc/doc-common-u: Initialize \n[doc-hyphen-flags] from
	\n[HY].

	* tmac/groff_mdoc.7.man \
	(FORMATTING WITH GROFF, TROFF, AND NROFF): Document it.

2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Reset inter-word and inter-sentence
	spacing to default with each new page rendered.

	{To observe the problem prior to this change,
	  $ groff -mandoc groff_mmse.7 $any_other_man_page
	groff_mmse(7) loads sv.tmac, which changes the sentence
	spacing.}

2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* PROBLEMS: Undocument the problem with test-groff and mdoc.
	It's resolved.

	Fixes <https://savannah.gnu.org/bugs/?51073>.

2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am (NORMALFILES, MDOCFILES): Drop unused variables.
	($(TMACMDOCFILES) $(TMACSTRIPFILES)): Scrub trailing whitespace.
	Wrap long line.

2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	mdoc: Relocate within build tree.

	The (modern) mdoc macro package has not been usable within the
	build tree, unlike the others.  This makes it more troublesome
	to test changes, and frustrates deploying our test
	infrastructure against it.  Re-arrange the build tree to
	resemble an installation tree closely enough for the macro
	package to load.

	* tmac/doc-common-u:
	* tmac/doc-ditroff-u:
	* tmac/doc-nroff-u:
	* tmac/doc-syms-u: Rename to...
	* tmac/mdoc/doc-common-u:
	* tmac/mdoc/doc-ditroff-u:
	* tmac/mdoc/doc-nroff-u:
	* tmac/mdoc/doc-syms-u: ...these.

	* tmac/tmac.am (TMACMDOCFILES): Look for files in tmac/mdoc.
	($(TMACMDOCFILES)): Create tmac/mdoc in build tree.

	Fixes <https://savannah.gnu.org/bugs/?51003>.

2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test for usable in-tree mdoc.

	* tmac/tests/doc-smoke-test.sh: Add test.
	* tmac/tmac.am (tmac_TESTS): Run test.

2020-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_TH_repairs_ad_damage.sh:
	* tmac/tests/an-old_TH_repairs_hy_damage.sh: Add tests.
	* tmac/tmac.am (tmac_TESTS): Run tests.

2020-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Set hyphenation mode to user preference
	with each new page rendered, in case a hostile page meddled with
	'.hy' or '.nh'.
	(after .mso man.local): Relocate setting of default hyphenation
	mode here (instead of just before .mso man.local).  Eliminate
	conditional on \n[an-html]; this doesn't matter because
	grohtml(1) doesn't support hyphenation anyway.  If it does learn
	to hyphenate, we should treat it the same as other output
	devices in any case.  Add comment explaining why we fall back to
	different defaults depending on \n[cR].

2020-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (TH): Set adjustment to user preference with
	each new page rendered, in case a hostile page meddled with
	'.ad' or '.na'.
	(after .mso man.local): Set the default adjustment mode only if
	a -d option or man.local did not.  Also do the same for the HF
	string; relocate its definition here and make it similarly
	conditional.  Also update comment on setting of CS and CT
	registers and style their conditionals consistently with the
	rest of the package.

	* tmac/groff_man.7.man.in (Strings) <\*(AD>: Document it.
	(Strings) <\*(HF>: Parallelize language with new \*(AD.
	(Options) Expand introductory sentence to discuss -d and -r
	options.
	(Options) <-dAD>: Document default and likely values.  Nobody
	right-justifies or centers man page text; send the curious to
	groff(7) for '.ad' request documentation.
	(Options) <-dHF>: Document default and steer people to groff(7)
	for '.ft' request documentation.

2020-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac (set-an-margin): Rename...
	(an-set-margin): ...to this.  It was the only package-internal
	register, macro, string, or diversion that wasn't named using
	the "an-*" schema.
	(TH, SH, SS): Update call sites.

2020-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (.ME, .UE): Restore hyphenation after
	"punctuation" arguments have been output.  The next token will
	always be a space node, the end of the document, or similar.

	* tmac/tmac.am (tmac_XFAIL_TESTS): Mark the punctuation
	hyphenation tests as expected to fail, because they now do.

2020-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/ps.tmac: Define ordinary hyphen-minus as fallback
	character for U+2011 (non-breaking hyphen).  Prompted by
	discussion with Dave Kemper in Savannah #58390.

2020-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	Fix hyphenation bug.  The UR/UE and MT/ME macros were much too
	aggressive about turning hyphenation off.  Disable it only when
	writing the actual URL or email address.

	* tmac/an-ext.tmac (.MT, .UR): Stop disabling hyphenation here.
	(.ME, .UE): Disable hyphenation right before output of
	URL/address; restore it right before output of supplementary
	arguments ("punctuation").

	* tmac/tests/an-ext_ME_punct_hyphenates.sh:
	* tmac/tests/an-ext_MT_body_hyphenates.sh:
	* tmac/tests/an-ext_UE_punct_hyphenates.sh:
	* tmac/tests/an-ext_UR_body_hyphenates.sh: Test behavior.

	* tmac/tmac.am (tmac_TESTS): Run tests.

2020-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	Adapt to the fact that \: reënables hyphenation.  Rename
	"hyphenless [discretionary] break" to "non-printing break point"
	in documentation.

	* doc/groff.texi (Manipulating Hyphenation): Rename "hyphenless
	break" to "non-printing break point".  Clarify that it is the
	soft hyphen glyph, not necessarily a hyphen, that is ordinarily
	written to the output on hyphenation breaks.  Note that the
	remainder of a word after \: is subject to hyphenation as
	normal.  Note (new) '\:\%' idiom for getting what people will
	want at least some of the time.  Update example to use it.
	* makevarescape.sed: Insert \% after we insert \: to rewrite
	slashes in filenames, to protect later portions of the filename
	from hyphenation.
	* man/groff.7.man (Escape Sequences/Escape short reference):
	Rename "hyphenless break" to "non-printing break point".
	* man/groff_diff.7.man (Language/Escape sequences): Resync with
	our Texinfo manual.
	* tmac/groff_man.7.man.in (Description/Hyperlink and email
	macros): Rename "hyphenless break" to "non-printing break
	point".

2020-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	documentation: Re-christen 'ESCAPE_AMPERSAND'.

	s/zero[- ]width space character/non-printing input break/

	* doc/groff.texi (Requests): Rename.  Update conceptual index
	entries; retain old name (with an appended "[sic]") to aid
	readers accustomed to it.
	(Ligatures and kerning): Update conceptual index entries.
	Supply context ("effect on kerning").
	(Drawing requests): Update conceptual index entries.  Supply
	context ("effect on '\l'").
	* man/groff.7.man (Description): Rename in macro-advice-writing
	shorthand.
	(Escape Sequences/Escape short reference): Rename.
	* tmac/groff_man.7.man.in (Description/Command synopsis macros
	[style]: Rename.
	(Description/Portability) [style]: Rename.
	* tmac/groff_mdoc.7.man (TROFF IDIOSYNCRASIES/Macro Usage):
	Rename.
	(TROFF IDIOSYNCRASIES/Other Possible Pitfalls): Rename.

2020-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man.in (Description/{Document structure
	macros <.TH>, Horizontal and vertical spacing}): Fix erroneous
	use of "flush left".  The current uses were introduced by me,
	but the page has borne incorrect uses of it as far back as 1999
	{in the description of .TP}.  Simply say "with no indentation"
	instead.

2020-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man.in (Description/Number registers): Inform
	reader that registers can be set in man.local file and
	cross-reference it.
	(Files/*/man.local): [style] Supply example of man.local
	customizations, prompted by recent discussions on groff,
	linux-man, and man-db mailing lists.

2020-08-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tmac.am: Use a stamp file for m4 keyword check.
	(M4CHECK): Add stamp file variable.
	($(M4CHECK)): Create stamp file if check succeeds.

2020-08-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	Split groff_man(7) into two pages; one a (relatively) terse
	reference and the other a tutorial and style guide.  Both are
	generated from the same source, which is processed by m4 into
	two man page sources.

	* tmac/groff_man.7.man: Rename...
	* tmac/groff_man.7.man.in: ...to this.

	* tmac/groff_man.7.man.in: Add m4 directives and define macros.
	Protect m4 keywords in English from unintended expansion (this
	affected the word "include").  Add new .TH and apropos lines for
	style guide.  Convert marker comments into m4 macros for content
	control.  Uncomment material intended only for basic reference
	page.

	* tmac/tmac.am (man7_MANS): Add groff_man_style.7.
	(EXTRADIST) Add groff_man.7.man.in.
	(MOSTLYCLEANFILES): Add m4-generated man page sources
	tmac/groff_man{,_style}.7.man.
	Add targets to generate those same two pages from the renamed
	file.  Add target to grep the page for unprotected English m4
	keywords and halt the build if they are found.  Make generation
	of those pages depend on this new target.

2020-08-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man: Add material on hooks and encoding.
	(Description, ./Deprecated features): Stop identifying .PT and
	.BT as "deprecated"; they shouldn't ever be called in man pages,
	but that has never been their intention.
	(Description): Identify character encoding and line-ending
	requirements (tutorial/style-guide material).
	(Description/Hooks): Add new subsection to house descriptions of
	.PT and .BT.  Add mnemonic expansions for both.

2020-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Control Characters): Incorrect claims were
	made.  Double quotes can indeed be used to enclose arguments to
	string interpolations.  The statement about a leading " in a
	string definition (or appendment with .as) was stated too
	generally.  The leading quote is not necessary to include
	leading tab characters, which can be input as-is, even in
	compatibility mode.

2020-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Requests/Request short reference/.ft): Fix
	some outright damage in the description of the request; the
	escape sequences that are synonymous with a nullary .ft had been
	wrongly removed.

2020-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/meintro.me:
	* doc/meref.me:
	* tmac/e.tmac-u: Remove postal address for Eric Allman.  It's
	probably decades out of date.  Adjust footnote symbols.  Thanks
	to Dave Kemper for the bug report and the patch.  Fixes
	<https://savannah.gnu.org/bugs/?58726>.

2020-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	Migrate macro packages from font CW to CR.  The font name "CW"
	{"constant-width"} is a legacy item we can dispose of (except
	for the DVI device, which also has CWI for "constant-width
	italic"), and much of the groff codebase already did starting
	with commit 0de1d6d79cdb959ffa7dac3af77c2a36ef31873f {October
	2017}.  Courier is available in the usual four styles {roman,
	bold, italic, bold+italic}.

	* tmac/an-ext.tmac (.EX): Set font to R, not CW.  The existing
	.ft request was somewhat redundant with the '.do fam C'
	immediately before, which set the font family to Courier.
	* tmac/s.tmac (.UC): Use font CR, not CW.

2020-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tty.tmac: Stop suppressing nonexistent font warning.
	Prompted by a 2017 suggestion and patch from Bjarni Ingi
	Gislason.  Documents and macro packages that want to change the
	font family should do so in awareness that this is meaningless
	on terminal (nroff) devices (and -Thtml as well).

	Fixes <https://savannah.gnu.org/bugs/?51364>.

2020-07-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man (.PP, .LP, .P): Fix error: these macros
	do not reset the left margin.

2020-07-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Strings): Document behavior of .ds request
	when only one argument is supplied.  (The string is defined as
	empty.)  Thanks to Dave Kemper for the report and the patch.

	Fixes <https://savannah.gnu.org/bugs/?58746>.

2020-07-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Using Symbols): Fix error in .rfschar
	description, which should refer to "font f" rather than "glyph
	f".  Thanks to Dave Kemper for the report and the patch.

	Fixes <https://savannah.gnu.org/bugs/?58767>.

2020-07-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man (.EE, .YS): Fix error: refer to "initial
	hyphenation setting" instead of "previous hyphenation mode".
	Incidentally, this fact points out why putting ".hy 0" or ".nh"
	in your man page is futile.

2020-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Requests/Request short reference): Fix error
	in description of .hc; it changes the hyphenation character
	rather than supplying an additional one.

2020-06-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Groff Options): Remove editorial comment about
	'-a' option being "useless".  It isn't.  Update example for
	contemporary systems (like Debian) and to reflect the fact that
	the GNU troff(1) man page needs to be preprocessed with tbl(1).
	(Invoking grotty): Recast discussion of -c option, importing
	much language from grotty(1) page rewrite from a year ago.  Add
	program index entries for col, more, and ul.  Fix transposition
	error in ISO document number.

	* src/devices/grotty/grotty.1.man (Description/Legacy output
	format): Make slight wording changes prompted by content of
	parallel section in our Texinfo manual.

	* src/roff/groff/groff.1.man (Options/-a): Parallelize with
	first sentence of corresponding material in our Texinfo
	manual.

	* src/roff/troff/troff.1.man (Options/-a): Parallelize with
	our Texinfo manual.

	Fixes the rest of
	<https://savannah.gnu.org/bugs/?55278>.

2020-06-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff_diff.7.man (Language/Long names): Fix error: groff
	adds three new requests with short names, not two.  List them in
	an adjacent comment.

2020-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-ext.tmac (.ME, .UE): Fix portability issue.  While
	widely supported, the \$* escape is not documented in CSTR #54.
	If groff is not the typesetter, append macro arguments using
	\$1, \$2, ..., \$9 instead.

2020-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* man/groff.7.man (Numerical Expressions): Fix error: negative
	expressions evaluate false, not true as was implied.
	Parallelize descriptions with our Texinfo manual and
	groff_diff(7) (in abbreviated form).

2020-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Manipulating Filling and Adjusting): Fix error
	in code sample: missing 'n' in number register interpolation.

2020-05-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/preconv/tests/smoke-test.sh: Make BOM detection
	override less hinky (i.e., use more normative input).  Add tests
	for all five detected BOMs.

2020-05-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/env.cpp (space_size): Prevent assertion
	failure.  If an argument to the .ss request is negative, throw a
	range warning and ignore it.
	* src/roff/groff/tests/regression_savannah_58337.sh: Add test.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	Fixes https://savannah.gnu.org/bugs/?58337.

2020-05-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	Update documentation of .ss request.

	* doc/groff.texi (Manipulating Filling and Adjusting): Rewrite
	documentation of .ss request and \n[.ss] and \n[.sss] escapes.
	Note that negative values are not permitted in either argument
	to .ss.  Use new terminology, "minimal inter-word spacing" and
	"additional inter-sentence spacing" for clarity.  Clarify that
	additional inter-sentence spacing is only used when the output
	line is not full when the end of a sentence occurs.  Add index
	nodes to help readers find discussion of details of spacing
	between words and sentences.  Move discussion of differences
	from AT&T troff to section "Implementation Differences".  Update
	example to more closely resemble a real-world case, use second
	argument to .ss request, and eliminate hackish use of .nop
	request.

	* man/groff_diff.7.man (New number registers): Recast in
	parallel with the foregoing.

	* man/groff.7.man (Read-only registers): Use new terminology and
	describe \n[.ss] and \n[.sss] in meaningful terms, not by
	reference to arguments to the .ss request (which wasn't even
	accurate, because these registers have default values).

	Fixes https://savannah.gnu.org/bugs/?54101.

2020-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	Undocument plans to support end-of-file GNU Emacs coding tags.

	* src/preproc/preconv/preconv.cpp (check_coding_tag):  Update
	comments.
	(detect_file_encoding): Alter debugging output so it's easier to
	grep and verify Emacs coding tag detection.

	* src/preproc/preconv/preconv.1.man (Bugs): Delete; its sole
	concern was the absence of this feature.
	(Usage): Document detection algorithm in more detail.  Note
	which detection methods don't work on unseekable input (pipes).
	Offer recommendations for those struggling with encoding
	detection.
	(Usage/Coding Tags): Stop manipulating line adjustment.  Use
	hyphen-minus (\- escape) characters in coding tag names, since
	they are literals that one might copy and paste.  Stop
	referencing XEmacs, whose development appears moribund.
	(See Also): Add cross-references to iconv(3) and locale(7) man
	pages.

	* src/preproc/preconv/tests/smoke-test.sh: Test each of the
	steps in the detection algorithm.
	* src/preproc/preconv/preconv.am: Run test.
	(preconv_TESTS): Add new variable.
	(TESTS): Append $(preconv_TESTS).

2020-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/afmtodit/afmtodit.pl: Format usage message with
	full capitals for parameters, and break out -v option in a
	separate "synopsis".

2020-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	* font/devpdf/util/BuildFoundries.pl: Stop throwing away
	diagnostics from afmtodit.  This results in only one extra line
	of build output:

		both Upsilon1 and Upsilon map to *U at .../afmtodit line
		6413.

2020-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>

	Correct documentation of .pm request.

	* man/groff.7.man (Requests/Request short reference): The .pm
	request's classical behavior was described instead of groff's,
	and omitted mention of strings and diversions; correct it.

	* man/groff_diff.7.man (Implementation Differences): Document
	this difference between AT&T troff and groff.

	* doc/groff.texi (Debugging): Relocate description of .pm
	behavioral difference...
	(Implementation Differences): ...hither.

2020-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/addftinfo/addftinfo.cpp (usage):
	* src/utils/tfmtodit/tfmtodit.cpp (usage): Add "usage:" prefix
	to messages documenting auxiliary modes of invoking the program.
	The output doesn't look right without one, and it feels
	dishonest to not document the relevant options (-v, --version)
	disjunctively.  I'm trying to strike a balance between the
	ultra-terse BSD approach and the ultra-garrulous GNU one (see,
	e.g., ls(1)).  Likely both camps will be unhappy.  :-/

2020-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/tfmtodit/tfmtodit.cpp (read_map): Report invalid
	character code from map file in diagnostic.
	(main): Report invalid skew character position in diagnostic.
	Explicitly report insufficient arguments in addition to usage
	message.  Lift invariant computed expressions out of loops (more
	to shorten long lines than because I think the compiler won't
	figure it out).  Give content to "impossible assertion".
	(tfm::load): Capitalize TFM initialism in diagnostics.
	(usage): Use full capitals for parameters as is conventional.
	Document disjunction of -v/--version flag from other
	invocations.

2020-04-29  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/utils/addftinfo/addftinfo.cpp (usage): Add overloaded
	version that accepts a constant string argument, which emits the
	argument as a diagnostic and then calls usage().
	(main): Add diagnostics to usage message where the problem is
	clear.  Add comment explaining why it sometimes isn't.
	(usage): Refactor main usage message (which prints the summary)
	to report the actual names of the accepted option arguments
	instead of just "-param", which is not literally accepted.

	Sort param_table alphabetically for use by the usage message.

2020-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	Delete groffer.

	Per discussion on the groff development mailing list, there is
	no desire to retain the maintenance of this portion of the groff
	distribution.

	See
	<https://lists.gnu.org/archive/html/groff/2020-04/msg00051.html>
	et seq.

	* contrib/groffer: Recursively delete.

	* Makefile.am:
	* arch/mingw/mingw.am: Stop building groffer.

	* m4/groff.m4 (GROFF_GROFFERDIR_DEFAULT):
	(GROFF_GROFFERDIR_OPTION): Delete; remove "--with-grofferdir"
	configuration option.
	* configure.ac: Stop calling these macros.

	* MANIFEST:
	* NEWS:
	* PROJECTS:
	* TODO:
	* contrib/chem/chem.1.man:
	* contrib/chem/examples/122/README.txt:
	* contrib/chem/examples/README.txt:
	* contrib/glilypond/glilypond.1.man:
	* contrib/gperl/gperl.1.man:
	* contrib/gpinyin/gpinyin.1.man:
	* contrib/groff_filenames/groff_filenames.5.man:
	* man/groff_font.5.man:
	* man/roff.7.man:
	* src/roff/groff/groff.1.man:
	* src/roff/grog/grog.1.man:
	* src/utils/addftinfo/addftinfo.1.man:
	* tmac/groff_trace.7.man: Delete references to groffer.

2020-04-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/include/curtime.h: #include <time.h> if we're returning
	a time_t from current_time().

	* src/libs/libgroff/curtime.cpp (current_time): Quote
	$SOURCE_DATE_EPOCH variable content in diagnostics produced due
	to bad input since it's under user control and could have all
	kinds of bogosity in it (like whitespace).

2020-04-19  G. Branden Robinson <g.branden.robinson@gmail.com>

	* **/*.{man,tmac}: Save compatibility mode robustly.

	Use new \n[.cp] register to save compatibility mode.

	Use register names based on the filename (at the source
	maintenance level) to avoid clobbering other files' saved
	compatibility modes.

	* tmac/html.tmac: Eliminate test of saved-compatibility
	register by moving its body inside the block where compatibility
	mode is off.  This is the only part of this changeset that was
	not automated.

	Fixes <https://savannah.gnu.org/bugs/?58162>.

2020-04-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	Implement new read-only .cp register.

	Within a .do request, \n[.cp] holds the saved value of
	compatibility mode.

	The register \n[.cp] is specialized and may require a statement
	of rationale.  When writing macro packages or documents that use
	groff features and which may be mixed with other packages or
	documents that do not—common scenarios include serial processing
	of man pages or use of the .so or .mso requests—you may desire
	correct operation regardless of compatibility mode in the
	surrounding context.  It may occur to you to save the existing
	value of \n(.C into a register, say, _C, at the beginning of
	your file, turn compatibility mode off with “.cp 0”, then
	restore it from that register at the end with “.cp \n(_C”.  At
	the same time, a modular design of a document or macro package
	may lead you to multiple layers of inclusion.  You cannot use
	the same register name everywhere or you risk “clobbering” the
	value from a preceding or enclosing context.  The two‐character
	register namespace of AT&T troff is confining and mnemonically
	challenging; you may wish to use groff's more capacious
	namespace.  However, attempting “.nr _my_saved_C \n(.C” will not
	work in compatibility mode; the register name is too long.
	“This is exactly what .do is for,” you think, “.do nr
	_my_saved_C \n(.C”.  The foregoing will always save zero to your
	register, because .do turns compatibility mode off while it
	interprets its argument list.  What you need is:
		.do nr _my_saved_C \n[.cp]
		.cp 0
	at the beginning of your file, followed by
		.cp \n[_my_saved_C]
	at the end.  As in the C language, we all have to share one big
	namespace, so choose a register name that is unlikely to collide
	with other uses.

	* src/roff/troff/input.cpp (do_request, init_input_requests):
	Implement it.

	* doc/groff.texi:
	* man/groff.7.man:
	* man/groff_diff.7.man: Document it.

	* src/roff/groff/tests/dot-cp_register_works.sh: Test it.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	Enables a fix for
	<https://savannah.gnu.org/bugs/?58162>.

	Thanks to John Gardner and Ingo Schwarze for the discussion.

2020-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Implementation Differences):
	* man/groff_diff.7.man (New requests): Rewrite description of
	.do request, and replace example with a more illustrative one.

	* man/groff.7.man (Request short reference): Rewrite description
	of .do request briefly.

2020-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Implementation Differences): Remove incorrect
	claim.  The .C register cannot be manipulated manually.

2020-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/smoke-test_html_device.sh: Simplify
	charmap test.

2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	It's too easy for the nroff version to get desynced from the
	groff version when we're running test cases, leading to spurious
	results.  Make it easier to see a discrepancy.

	* src/roff/nroff/nroff.sh: Call groff with -v or --version when
	we are called that way.  Let test cases tell us to use
	test-groff as groff with an environment variable.

	* src/roff/nroff/tests/verbose_option_works.sh.in: Rename to...
	* src/roff/nroff/tests/verbose_option_works.sh: ...this.  Check
	the nroff version being tested against the groff version being
	wrapped.  This exposes a bug; the system groff rather than the
	build tree groff was being invoked.  Refactor.  Stop messing
	with @GROFF_BIN_PATH_SETUP@ (enabling the rename); instead, let
	test-groff handle that for us.  Locate it and export the
	variable GROFF_TEST_GROFF so nroff can find it.  Because we
	manipulate $PATH to run the tests, the $PATH of an installed
	groff system will _always_ differ from that used by a build
	tree; ignore it in the test cases.  Dispose of bashisms and set
	shebang to /bin/sh.

	* src/roff/nroff/nroff.am: Stop generating the above test
	script.  It can now be run as it ships.

2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	Make our assert() C99-conformant.

	groff has its own implementation of the standard C library's
	assert() macro.  It hasn't been updated since C89.  C99 requires
	that the diagnostic emitted by assert() contain the failing
	expression and name of the function in scope.

	* src/include/assert.h: Add additional pointer to const char
	arguments to do_assert() and assertion_failed() for function
	name and stringified expression.
	(assertion_failed): Update prototype.
	(do_assert): Accept 'func' and 'msg' parameters and pass them to
	assertion_failed().
	(assert): Update macro to collect '__func__' and stringify the
	expr parameter (as 'msg') and pass them do do_assert().
	* src/libs/libgroff/assert.cpp (assertion_failed): Rewrite
	diagnostic to more closely match GNU Coding Style format and
	also report function and failing expression.

	Example output:
		troff: ../src/roff/troff/input.cpp:2644: do_request():
		assertion failed: '0 == "But first, here's a rotten old
		BBC programme."'

	We have no excuse to assert(0) ever again.  Express the
	invariant that has been violated.

2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/smoke-test_html_device.sh: Set
	LC_CTYPE=C.UTF-8 so that byte sequences in the pipelines are
	handled correctly.  Skip the test if the environment doesn't
	support UTF-8.  Thanks to Bjarni Ingi Gislason for the trouble
	report.

	Fixes <https://savannah.gnu.org/bugs/?58164>.

2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/html.tmac: Use .do so we correctly load unicode.tmac in
	compatibility mode.

	Fixes the following problem (wrapped, filenames abbreviated):

	$ echo | ./build/test-groff -C -Thtml >/dev/null
	troff: backtrace: file '.../groff/build/../tmac/html.tmac':546
	troff: backtrace: file '.../groff/build/../tmac/troffrc':30
	troff: .../groff/build/../tmac/html.tmac:546: warning: macro
		'ms' not defined

2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/smoke-test_html_device.sh: Add test.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2020-04-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/regression_savannah_58153.sh:
	* src/roff/groff/tests/\
	use_point_size_escape_with_single_digit_arg.sh: Use "set -e" to
	ensure that multi-test script files don't hide problems.  There
	are arguments against "set -e" (and you can ask Greg Wooledge
	for all of them), but I'm so used to it from years of writing
	Debian package maintainer scripts that I feel comfortable with
	it.  It is less verbose than several alternatives (especially
	having one test script per case).

	* src/roff/groff/tests/string_case_xform_unicode_escape.sh:
	Update with respect to new failure output (in a comment only,
	since this is an XFAIL test).

	* tmac/tests/an-old_AT_and_UC_footer_saved_and_restored.sh:
	Drop unnecessary "|| exit 1" from end of script.  Incidentally,
	this script illustrates an alternative to "set -e".

2020-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Rework documentation of .spreadwarn.

	* doc/groff.texi (Debugging):
	* man/groff.7.man (Request short reference):
	* man/groff_diff.7.man (New requests): Recast description of
	.spreadwarn request, some based on suggestions from Dave Kemper.
	Make more prominent the fact that spreading only applies to
	adjustment mode 'b'.  Document warning type used.

	Fixes half of Savannah #58035.

2020-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Require Texinfo 5.0 (February 2013) at a minimum.

	* m4/groff.m4 (GROFF_MAKEINFO): Check for version 5.0 (increased
	from 4.8).  Update diagnostics and comments.

	* INSTALL.extra:
	* README:
	* doc/groff.texi:
	* doc/webpage.ms: Document updated requirement.

	* doc/fixinfo.sh: Delete; it is no longer necessary to work
	around Texinfo 4.x bugs.

	* doc/doc.am (EXTRA_DIST): Stop shipping fixinfo.sh.
	(.texi.html): Remove makeinfo < 5.0 version check and consequent
	execution of fixinfo.sh.  Update comment.

2020-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	Enable backtracing across process/file boundaries when errors or
	non-ignored warnings are encountered.

	Experimentation reveals that .so, .mso, and .pso requests acted
	as barriers to backtracing except when explicitly requested with
	the .backtrace request.  Judging by the git history, this
	behavior dates back to June 1991 or earlier.  The intention,
	according to a source comment, was only to suppress the
	backtrace output for the line corresponding to the outermost
	level of the input stack (commonly, a file argument to groff).
	Unfortunately, that wasn't its only effect.

	This change does result in one additional line of output for
	each error or (non-ignored) warning when -b is given.  However,
	I regard this as unobjectionable because {1} a backtrace was in
	fact explicitly requested; and {2} it seems a poor tradeoff to
	suppress most of the backtrace in some complicated and
	frustrating cases for the sake of one fewer line of backtrace
	output in a trivial one.

	Now, backtracing behaves the same no matter what triggers it.

	Fixes Savannah #58153.

	* src/roff/troff/input.cpp (file_iterator::backtrace): Call
	get_location() for its side effect of rewriting a filename of
	"-" to "<standard input>", for consistency with other diagnostic
	messages.  (In this class, this member function always returns
	1, so ignore the return value.  This fact is an essential part
	of what led to the bug; the conditional
		p && !p->get_location(0, &f, &n)
	which appeared in the for loop of input_stack::backtrace() prior
	to this change would always evaluate to false when a node of the
	file_iterator class was encountered.)
	(input_stack::backtrace): Replace member function body with that
	of input_stack::backtrace_all().
	(input_stack::backtrace_all): Delete.
	(backtrace_request): Update the only call site of the above.

	* src/roff/groff/tests/regression_savannah_58153.sh: Add test.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

	* src/roff/groff/tests/string_case_xform_errors.sh: Update
	regression test to not be confounded by additional line of
	backtrace output.  Remove bashism along the way.

	* doc/groff.texi:
	* man/groff.7.man:
	* man/groff_diff.7.man: Update documentation.

2020-04-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	Reorganize backtrace output.

	* src/roff/troff/input.cpp (string_iterator::backtrace):
	Prefix the output with the program name if it is known.  In a
	deviation from the GNU Coding Standards, put the string
	"backtrace:" immediately next instead of the file and line
	number; this is because, particularly in cases where the
	backtrace is most interesting or needed, it will produce
	multiple lines of output and the common prefix aids visual
	understanding.
	(file_iterator::backtrace): As above; also, change prefix for
	popened nodes in the iterator from "process" to "pipe".  This
	seemed preferable to omitting the information entirely or using
	an inscrutable sigil like 'f' or 'p'.  The advantage is that the
	output is better aligned--better ergonomics for those who have
	to cope with a lot of it.  Furthermore, output the filename only
	once.

	Example of old and new output:

	/tmp/inner:2: backtrace: file '/tmp/inner'
	echo .so /tmp/inner:1: backtrace: process 'echo .so /tmp/inner'
	/tmp/outer:1: backtrace: file '/tmp/outer'

	troff: backtrace: file '/tmp/inner':2
	troff: backtrace: pipe 'echo .so /tmp/inner':1
	troff: backtrace: file '/tmp/outer':1

2020-04-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_size): Add units to diagnostic.
	This function works only with device-specific basic units
	internally; users likely think in terms of point size, so add
	the basic unit suffix "u" to offer a hint about what's going on.

	Example:
	$ groff -ww >/dev/null
	\s[10]A\s[-12]B
	troff: <standard input>:1: warning: point-size escape results in
	non-positive size -2000u; set to 1u

	On a PostScript device with 1000 basic units to the point, the
	difference is important and would be confusing without the unit
	indication.

2020-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>

	Correct and clarify point size documentation.

	Our Texinfo manual has long documented the request '.ps 0' as
	restoring the previous point size (just as '\s0' or '.ps' with
	no argument does), but this is incorrect; since groff 1.02 or
	earlier (June 1991), the request has not actually worked this
	way.  Instead, '.ps 0' sets the point size to 1 basic unit
	{though output drivers may clamp this to a higher value}.  This
	behavior is consistent with AT&T troff, Hierloom Doctools troff
	and, per Ingo Schwarze, Plan 9 troff.  (It is, however, not
	consistent with neatroff.)

	* doc/groff.texi (Changing Type Sizes): Stop claiming that '.ps
	0' works like '\s0'.  Note that the resulting (computed) point
	size, not the argument, is clamped.  Note that it is
	non-positive, not negative, point sizes that are clamped to 1u.
	Add (forward) cross-reference to section where \n[.ps] is
	defined since it is mentioned here.  Move explanation of special
	handling of zero argument to \s escape description.

	* man/groff.7.man (Request short reference): Explain .ps N
	independently of \s.  Note clamping behavior.

2020-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_size): Correctly brace 'else'
	block.

	* src/roff/groff/tests/\
	use_point_size_escape_with_single_digit_arg.sh:
	Check that we get a diagnostic when relying on ambiguous form.

2020-04-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp (read_size): Move special-case
	interpretation of the '\sN' form of point-size escapes when 'N'
	is 1, 2, or 3 to compatibility mode (groff -C) only, and throw
	error diagnostic with suggestion for remedy if encountered.

	Traditionally, '\s36A' is interpreted as "set point size to 36,
	then emit 'A'".  However, only values in the range 10-39 are
	handled specially; '\s40A' is interpreted as a four-point "0A".
	This is unlike anything else in *roff grammar; see \*, \$, \f,
	\F, \g, \k, \m, \M, \n, \V, \Y, and \z.

	To anticipate objections: Why not throw only a warning?  Because
	there isn't a warning category for supported but ambiguous
	syntax (this behavior of AT&T troff dates back to the mid-1970s
	but was not documented in the Troff User's Manual until 1992).
	Why not throw the error outside of compatibility mode too?
	Because outside of compatibility mode we (now) have an
	unambiguous parse.

	Background: The Graphic Systems C/A/T phototypesetter (the
	original device target for AT&T troff) only supported a few
	discrete point sizes in the range 6..36, so Ossanna
	special-cased the parser to do what the user must have meant.
	Kernighan warned of this in the 1992 revision of CSTR #54
	{§2.3}, and more recently, McIlroy referred to it as a "living
	fossil".

	See:
	  https://lists.gnu.org/archive/html/groff/2020-03/msg00054.html
	  https://lists.gnu.org/archive/html/groff/2020-04/msg00002.html
	  https://lists.gnu.org/archive/html/groff/2020-04/msg00015.html
	and follow-ups for discussion.

	* NEWS: Advise users of behavior change and offer guidance.

	* doc/groff.texi:
	* man/groff.7.man: Document the restriction of special handling
	of point-size arguments to '\s' to compatibility mode.

	* src/roff/groff/tests/\
	use_point_size_escape_with_single_digit_arg.sh: Add regression
	test.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2020-04-04  G. Branden Robinson <g.branden.robinson@gmail.com>

	Improve point-size escape diagnostics.

	* src/roff/troff/input.cpp (read_size): Disclose context
	{point-size escape interpretation} in diagnostic messages.  When
	a "bad digit" is encountered, describe it if possible.  When a
	relative adjustment results in a negative point size, report the
	computed value.  Also rename a variable for slightly more
	clarity ("bad" does not refer to all bad parses, just some cases
	of bad digits), and update an insufficiently generalized comment
	{"\s(00" is also an acceptable expression for point-size zero}.

	Based on suggestions by Ingo Schwarze and Bjarni Ingi Gislason.

2020-04-01  G. Branden Robinson <g.branden.robinson@gmail.com>

	Align diagnostic message format.

	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
	* src/roff/troff/input.cpp (do_error):
	Display the diagnostic level when it is "error", instead of
	leaving it implicit.

	* src/roff/troff/input.cpp (error_with_file_and_line): Include
	the program name in the diagnostic message if it is known.

	* src/roff/groff/tests/string_case_xform_errors.sh: Update
	diagnostic message expectation.

2020-02-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi (Page Motions):
	* man/groff.7.man (Single-character escapes): Document
	non-breaking spaces as such.

	Report and patch by Dave Kemper <saint.snit@gmail.com>.
	Fixes <https://savannah.gnu.org/bugs/?55954>.

2020-02-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	nroff: Implement -P and -V options.

	* src/roff/nroff/nroff.sh: Recognize -P option (with argument)
	and pass it through to groff.  Recognize -V option; if given,
	display constructed groff command instead of executing it.
	Update usage message to document new options.  Tidy up shell
	style and indentation.  Add comments.
	* src/roff/nroff/nroff.1.man: Document new -P and -V options.
	* src/roff/nroff/tests/verbose_option_works.sh.in: Test -V
	option.
	* src/roff/nroff/nroff.am: Generate test and run it.

2020-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>

	Stop ms macro package from manipulating warnings.

	* tmac/s.tmac: Remove code block that attempted to enable all
	warnings "only if none are given on the command line".  It did
	this by simply comparing the value of the warn register
	{\n[.warn]} against the default value; but of course, a user
	could specify -w options that exactly matched the default and
	the test would not be able to tell, causing puzzling and
	undesired behavior.  Furthermore, the hard-coded default was out
	of date and did not correspond to recent releases of groff.  If
	you want all warnings on, use the ".warn" request with no
	arguments in your ms document or pass "-w w" to groff (see
	troff(1) or our Texinfo manual for more on warnings).

	Thanks to Bjarni Ingi Gislason for bringing this issue to our
	attention.

	Resolves <https://savannah.gnu.org/bugs/?57583>.

2020-01-21  George HELFFRICH  <ghfbsd@gmail.com>

	[me]: Fix regression of '.nm' (#57638).

	* tmac/e.tmac-u (nm): Use saved point size and font position
	for line numbering only if those registers exist.

	Fixes <https://savannah.gnu.org/bugs/?57638>.

2020-01-18  Ingo Schwarze  <schwarze@openbsd.org>

	Accept any number of arguments for .Dd in the groff_mdoc(7)
	macros.

	* tmac/doc-common-u: The .Dd macro behaved in a weird way:
	Without arguments, it printed the string "Epoch".
	With one, two, four, or more arguments, it ignored all arguments
	and used the current date instead.
	Only for exactly three arguments, it printed the arguments.
	None of this made sense.  Giving the date as "Epoch" is
	absurd, and printing the current date is just misleading:
	why should a document be considered up-to-date when the author
	did not even bother to state the date of the last change?
	Admittedly, the behaviour for 0 and 4 or more arguments
	already appeared 4.3BSD-Reno, and the behaviour for 2 or 3
	arguments in 4.4BSD.  But it was already wrong even in those
	days: several manual pages in 4.4BSD gave .Dd a single, quoted
	argument, e.g. .Dd "June 9, 1993": cap_mkdb(1), id(1), sed(1),
	err(3), getcap(3), sysctl(3), amd(8), disklabel(8), and others.
	Consequently, simply print all the arguments, no matter how
	many there are.

	This bug was found by Jonathan Gray <jsg@openbsd.org>
	while he looked at 4.xBSD manual pages.

2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* doc/groff.texi: Document initial empty set membership of
	characters with cflags values of 128, 256, or 512 in parallel
	with preceding paragraphs regarding smaller powers of two.

	Report and patch by Dave Kemper <saint.snit@gmail.com>.
	Fixes <https://savannah.gnu.org/bugs/?57549>.

2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/*.sh: Rename some tests so their
	filenames are more self-descriptive.
	* src/roff/groff/groff.am (groff_TESTS): Update.

2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/groff/tests/transparent_end-of-sentence_chars.sh: Add
	test for end-of-sentence recognition.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp: Mark \[dd] character (double dagger)
	as transparent for purposes of end-of-sentence recognition.

	* doc/groff.texi (Sentences):
	* man/groff_diff.7.man (New requests/.cflags): Document this.

	Report and patch by Dave Kemper <saint.snit@gmail.com>.
	Fixes <https://savannah.gnu.org/bugs/?57546>.

2020-01-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.1.man (See Also):
	* src/utils/indxbib/indxbib.1.man (See Also):
	* src/utils/lkbib/lkbib.1.man (See Also):
	* src/utils/lookbib/lookbib.1.man (See Also): Add bibliographic
	reference to the original Bell Labs "refer" paper by Mike Lesk.

2020-01-17  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_AT_and_UC_footer_saved_and_restored.sh: Add
	regression test for Ingo's change below.

2020-01-16  Ingo Schwarze  <schwarze@openbsd.org>

	Repair .AT and .UC in the groff_man(7) macros.

	* tmac/an-old.tmac: Setting user-defined strings in a macro that
	will later be called indirectly from page location traps is
	excessively complicated.  Besides, the implementation doesn't
	work: when the trap is finally sprung, the defaults from the
	an-init macro clobber what the author specified with .AT or .UC.
	Instead, all that is needed is setting the strings for the
	header before triggering the page break, such that they appear
	right away, while setting the strings for the footer after the
	page break, such that they don't appear on the previous page.

	This bug was found by Jonathan Gray <jsg@openbsd.org> while he
	looked at 4.xBSD manual pages.

2020-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/groff_man.7.man (Document structure macros/.SH): Fix
	errors in footer description.

2020-01-12  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/tests/an-old_CS_register_on.sh: Tweak flags; all the
	other tests in this group pass "-Tascii -P-cbou" instead of
	"-Tutf8".  (This is so that output is easy to grep from a shell
	script.)  Bring this test into line.  Does not regress anything.

2019-12-30  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Certain pdfmark destination names caused gropdf to fail.

	* src/devices/gropdf/gropdf.pl: Look for pdfmark types, (i.e.
	DEST, OUT, ANN), only preceding 'pdfmark' at end of line, not
	anywhere else.

2019-12-30  Ingo Schwarze  <schwarze@openbsd.org>

	Correct output of sprintf("%%") in pic(1).

	* src/preproc/pic/pic.ypp: Print "%" rather than "%%".

	Bug reported by Doug McIlroy <doug at cs dot dartmouth dot edu>.
	Patch using feedback from Larry McVoy <lm at mcvoy dot com>.

2019-12-29  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Update man page of gropdf to document \X calls.

	* src/devices/gropdf/gropdf.1.man: The calls 'pagename' and
	  'switchtopage' (used by mom to relocate TOC) are documented,
	  together with their convenience commands '.pdfpagename' and
	  '.pdfswitchtopage'.

2019-12-29  Ingo Schwarze  <schwarze@openbsd.org>

	Improve documentation of pic(1) regarding printf.

	* src/preproc/pic/pic.1.man:
	  Document which conversion specifications are supported.
	* doc/pic.ms:
	  Correct the list of supported conversion specifications.

2019-12-21  Ingo Schwarze  <schwarze@openbsd.org>

	Update NetBSD, OpenBSD, FreeBSD, Darwin, and DragonFly version
	strings.

	* tmac/doc-common-u: Update.
	* tmac/groff_mdoc.7.man: Synchronize.

	Based on a patch from Guillem Jover <guillem@debian.org>
	via Colin Watson <cjwatson@debian.org>, tweaked by me.
	Fixes: https://bugs.debian.org/867123

2019-09-22  G. Branden Robinson <g.branden.robinson@gmail.com>

	Use a vertical spacing of 1v between paragraphs in man page
	examples.  This looks better (on typesetter devices like
	PostScript and PDF) with the Courier font family also used in
	examples.  Typewriter devices (like the terminal) already used
	an inter-paragraph spacing of 1v.

	* tmac/an-ext.tmac (EX): Save the value of the PD number
	register (inter-paragraph distance), and set it to 1v.
	(EE): Restore previous value of the PD register.

2019-09-21  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Changes to allow configure to check for URW fonts

	* font/devpdf/util/BuildFoundries.pl: Call the program with
	--dirURW with path provided to ./configure, and --check to do
	a dry-run just checking if the fonts are available. (bug #56748)

2019-09-21  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Add new ghostscript font names (bug #56748)

	* font/devpdf/Foundry.in: Add changed font names

2019-09-21  Deri James  <deri@chuzzlewit.myzen.co.uk>

	Prevent gropdf executing arbitrary commands

	* src/devices/gropdf/gropdf.pl: See bug #55557

2019-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/an-old.tmac: Move test for definitions of CS and CT
	registers to after man.local is sourced; this way we can both
	respect any setting of those registers in that file (which is
	intended for customization by the site administrator) and ensure
	that the registers are defined when dereferenced later.

2019-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>

	* **/*.man: Put section headings in title case.

2019-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/roff/troff/input.cpp: Lift invariant out of loop.

2019-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/preproc/refer/refer.1.man: Add mention of man and mm
	packages as supporting the "refer" preprocessor (GNU mm grew
	this support back in groff 1.22.1).

2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	Mark expected-to-fail test as XFAIL.

	Automake supports XFAIL and XPASS, so actually use the
	infrastructure as intended.

	* Makefile.am: Declare XFAIL_TESTS variable.
	* src/roff/groff/groff.am (groff_XFAIL_TESTS): Add
	string_case_xform_unicode_escape.sh.
	* src/roff/groff/tests/string_case_xform_unicode_escape.sh: Set
	the expected output to what it would be if string case
	transforms worked on groff Unicode escapes.

2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	Retire '@G@' build system macro.

	It existed only for forcibly-capitalized man page titles; it was
	the uppercase-transformed counterpart of @g@.

	* Makefile.am: Delete sed transformation of @G@.
	* src/preproc/tbl/tbl.1.man: Replace '@G@EQN' in section heading
	with '@g@eqn'.

2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>

	* **/*.man: Downcase man page titles, except for glilypond and
	roff2*, which did not require it.

	Here's a sed script for the aid of those who have a corpus of
	man pages to migrate.

		# Downcase man page titles.
		#
		# Use the first line to skip any .TH lines that require
		# special handling, perhaps because the name of the
		# command gets externally macro-expanded.  In groff, the
		# "roff2.1.man" page is an example.
		#
		# This script operates _only_ on .TH lines.
		#
		# usage: sed -i -f this_script.sed your_man_page.1 ...
		/@ROFF2MODE@/b
		/^\.\s*TH/{
		h
		s/^\.\s*TH \+\([^ ]\+\) .*/\1/
		y/ABCDEFGHIJKLMNOPQRSTUVWXYZ/abcdefghijklmnopqrstuvwxyz/
		G
		s/\([^ ]\+\)\n\(^\.\s*TH \+\)[^ ]\+\( .*\)/\2\1\3/
		}

2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	The an (man) macro package supports new CS and CT number
	registers to control rendering of man page section headings and
	titles, respectively, in full capitals.  These default off (with
	no visible effect on pages which already fully capitalize these
	strings in man page sources).  The rationale is to encourage man
	page authors to preserve case distinction information in (or
	restore it to) their titles and section headings, while giving
	users (including system administrators, distributors,
	integrators, and maintainers of man(1) implementations) a way to
	view the rendered page elements in full capitals if desired.

	* tmac/an-old.tmac (TH/an-init): If number register CT is
	defined and nonzero, call .stringup on \*[an-title].
	(SH): Store macro argument list to \*[an-section-heading].  If
	number register CS is defined and nonzero, call .stringup on it.
	* tmac/groff_man.7.man (OPTIONS): Document the CS and CT number
	registers.
	* tmac/tests/an-old_CS_register_off.sh:
	* tmac/tests/an-old_CS_register_on.sh:
	* tmac/tests/an-old_CS_register_unspecified.sh:
	* tmac/tests/an-old_CT_register_off.sh:
	* tmac/tests/an-old_CT_register_on.sh:
	* tmac/tests/an-old_CT_register_unspecified.sh: Add tests.
	* tmac/tmac.am (tmac_TESTS): Run tests.

2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Add regression test to check behavior of case transformation
	request on a string containing a Unicode character escape.
	Right now, this is not supported, so it is an XFAIL test in the
	parlance of DejaGNU/POSIX 1003.3.

	* src/roff/groff/tests/string_case_xform_unicode_escape.sh: New
	test.
	* src/roff/groff/groff.am (groff_TESTS): Run test.

2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Implement .stringdown and .stringup requests.

	* src/roff/troff/input.cpp: Add .stringdown and .stringup
	requests.
	* doc/groff.texi: Document them, including example.
	* man/groff_diff.7.man: Same.
	* man/groff.7.man: Document them briefly.

2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>

	Regression-test string case transform feature.

	* src/roff/groff/tests/string_case_xform_errors.sh: New test.
	* src/roff/groff/tests/string_case_xform_requests.sh: New test.
	* src/roff/groff/groff.am (groff_TESTS): Run tests.

2019-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>

	* src/devices/grotty/grotty.1.man (Options/-i): Note support of
	recent versions of xterm for italic (oblique) styles.

	Fixes part of <https://savannah.gnu.org/bugs/?55278>.

2019-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	devlatin1: Map \(oq to ' on output.

	* font/devlatin1/R.proto: Render the output glyph \[oq]
	{opening quote} as 0x27 (apostrophe) instead of 0x60 (grave
	accent).  A grave accent is just flat wrong for the Latin-1
	character set, a.k.a. ISO 8859-1.  The defining document ECMA-94
	{June 1986} is freely available for perusal.  The ECMA-94 Latin
	character sets do not define any glyphs for directional
	{"typographer's"} quotation marks, but the apostrophe is
	depicted as a neutral (vertical) glyph, whereas the grave accent
	0x60 and acute accent 0xB4 are mirror-symmetric diacritical
	marks.

	Note that this change has no effect on _input_ conventions for
	roff source documents.  You can still get directional single
	quotes on UTF-8, PostScript, PDF, and other output devices
	supporting them by typing sequences like `this' in the input
	{character remapping with ".char" requests and similar
	notwithstanding}.

	Patch and idea from Ingo Schwarze, who originally proposed it
	for ASCII as well, and included Latin-1 for parallelism.
	The groff developers could reach no consensus about the wisdom
	of such a change for ASCII (which was designed to support
	ambiguity for some code points, requiring the development of
	supplementary interpretation conventions between parties).
	ECMA-94/ISO-8859 is more strongly prescriptive.

	See https://savannah.gnu.org/bugs/?55616 and the groff mailing
	list archives for 31 January to 23 February 2019 at
	https://lists.gnu.org/archive/html/groff for lengthy discussion.

	* src/roff/groff/tests/on-latin1-device-oq-is-0x27.sh: Check for
	correct output glyph.

	* src/roff/groff/groff.am: Add test.

2019-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>

	* tmac/unicode.tmac: Save and restore compatibility mode since
	the script uses a GNU extension (.char).

2019-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>

	libdriver: Fix SEGV (Savannah #56555).

	* src/libs/libdriver/printer.cpp: Check result of
	set_char_and_width() for error condition before relying on it.

	* src/roff/groff/tests/regression-56555.sh: Provoke segfault
	with five bytes of input using transparent line indicator.

	* src/roff/groff/groff.am: Add test.

	Fixes <https://savannah.gnu.org/bugs/?55278>.

2019-01-12  Ingo Schwarze  <schwarze@openbsd.org>

	Correctly handle groff_mdoc(7) .Lk arguments starting with a
	dot.

	* tmac/doc.tmac-u: Each argument to the .Lk macro is printed
	on its own roff input line.  If it happens to start with a dot
	or apostroph, it was misinterpreted as a request or macro.
	Force it to be treated as text by adding "\&" in front of it.

2018-12-31  Ingo Schwarze  <schwarze@openbsd.org>

	* man/groff_diff.7.man: remove two stray .RE macros


________________________________________________________________________

##### License

Copyright 2018-2021 Free Software Foundation, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.


##### Editor settings
Local Variables:
fill-column: 72
mode: change-log
version-control: never
End:
vim:set autoindent textwidth=72: