[0001]
[0002]
[0003]
[0004]
[0005]
[0006]
[0007]
[0008]
[0009]
[0010]
[0011]
[0012]
[0013]
[0014]
[0015]
[0016]
[0017]
[0018]
[0019]
[0020]
[0021]
[0022]
[0023]
[0024]
[0025]
[0026]
[0027]
[0028]
[0029]
[0030]
[0031]
[0032]
[0033]
[0034]
[0035]
[0036]
[0037]
[0038]
[0039]
[0040]
[0041]
[0042]
[0043]
[0044]
[0045]
[0046]
[0047]
[0048]
[0049]
[0050]
[0051]
[0052]
[0053]
[0054]
[0055]
[0056]
[0057]
[0058]
[0059]
[0060]
[0061]
[0062]
[0063]
[0064]
[0065]
[0066]
[0067]
[0068]
[0069]
[0070]
[0071]
[0072]
[0073]
[0074]
[0075]
[0076]
[0077]
[0078]
[0079]
[0080]
[0081]
[0082]
[0083]
[0084]
[0085]
[0086]
[0087]
[0088]
[0089]
[0090]
[0091]
[0092]
[0093]
[0094]
[0095]
[0096]
[0097]
[0098]
[0099]
[0100]
[0101]
[0102]
[0103]
[0104]
[0105]
[0106]
[0107]
[0108]
[0109]
[0110]
[0111]
[0112]
[0113]
[0114]
[0115]
[0116]
[0117]
[0118]
[0119]
[0120]
[0121]
[0122]
[0123]
[0124]
[0125]
[0126]
[0127]
[0128]
[0129]
[0130]
[0131]
[0132]
[0133]
[0134]
[0135]
[0136]
[0137]
[0138]
[0139]
[0140]
[0141]
[0142]
[0143]
[0144]
[0145]
[0146]
[0147]
[0148]
[0149]
[0150]
[0151]
[0152]
[0153]
[0154]
[0155]
[0156]
[0157]
[0158]
[0159]
[0160]
[0161]
[0162]
[0163]
[0164]
[0165]
[0166]
[0167]
[0168]
[0169]
[0170]
[0171]
[0172]
[0173]
[0174]
[0175]
[0176]
[0177]
[0178]
[0179]
[0180]
[0181]
[0182]
[0183]
[0184]
[0185]
[0186]
[0187]
[0188]
[0189]
[0190]
[0191]
[0192]
[0193]
[0194]
[0195]
[0196]
[0197]
[0198]
[0199]
[0200]
[0201]
[0202]
[0203]
[0204]
[0205]
[0206]
[0207]
[0208]
[0209]
[0210]
[0211]
[0212]
[0213]
[0214]
[0215]
[0216]
[0217]
[0218]
[0219]
[0220]
[0221]
[0222]
[0223]
[0224]
[0225]
[0226]
[0227]
[0228]
[0229]
[0230]
[0231]
[0232]
[0233]
[0234]
[0235]
[0236]
[0237]
[0238]
[0239]
[0240]
[0241]
[0242]
[0243]
[0244]
[0245]
[0246]
[0247]
[0248]
[0249]
[0250]
[0251]
[0252]
[0253]
[0254]
[0255]
[0256]
[0257]
[0258]
[0259]
[0260]
[0261]
[0262]
[0263]
[0264]
[0265]
[0266]
[0267]
[0268]
[0269]
[0270]
[0271]
[0272]
[0273]
[0274]
[0275]
[0276]
[0277]
[0278]
[0279]
[0280]
[0281]
[0282]
[0283]
[0284]
[0285]
[0286]
[0287]
[0288]
[0289]
[0290]
[0291]
[0292]
[0293]
[0294]
[0295]
[0296]
[0297]
[0298]
[0299]
[0300]
[0301]
[0302]
[0303]
[0304]
[0305]
[0306]
[0307]
[0308]
[0309]
[0310]
[0311]
[0312]
[0313]
[0314]
[0315]
[0316]
[0317]
[0318]
[0319]
[0320]
[0321]
[0322]
[0323]
[0324]
[0325]
[0326]
[0327]
[0328]
[0329]
[0330]
[0331]
[0332]
[0333]
[0334]
[0335]
[0336]
[0337]
[0338]
[0339]
[0340]
[0341]
[0342]
[0343]
[0344]
[0345]
[0346]
[0347]
[0348]
[0349]
[0350]
[0351]
[0352]
[0353]
[0354]
[0355]
[0356]
[0357]
[0358]
[0359]
[0360]
[0361]
[0362]
[0363]
[0364]
[0365]
[0366]
[0367]
[0368]
[0369]
[0370]
[0371]
[0372]
[0373]
[0374]
[0375]
[0376]
[0377]
[0378]
[0379]
[0380]
[0381]
[0382]
[0383]
[0384]
[0385]
[0386]
[0387]
[0388]
[0389]
[0390]
[0391]
[0392]
[0393]
[0394]
[0395]
[0396]
[0397]
[0398]
[0399]
[0400]
[0401]
[0402]
[0403]
[0404]
[0405]
[0406]
[0407]
[0408]
[0409]
[0410]
[0411]
[0412]
[0413]
[0414]
[0415]
[0416]
[0417]
[0418]
[0419]
[0420]
[0421]
[0422]
[0423]
[0424]
[0425]
[0426]
[0427]
[0428]
[0429]
[0430]
[0431]
[0432]
[0433]
[0434]
[0435]
[0436]
[0437]
[0438]
[0439]
[0440]
[0441]
[0442]
[0443]
[0444]
[0445]
[0446]
[0447]
[0448]
[0449]
[0450]
[0451]
[0452]
[0453]
[0454]
[0455]
[0456]
[0457]
[0458]
[0459]
[0460]
[0461]
[0462]
[0463]
[0464]
[0465]
[0466]
[0467]
[0468]
[0469]
[0470]
[0471]
[0472]
[0473]
[0474]
[0475]
[0476]
[0477]
[0478]
[0479]
[0480]
[0481]
[0482]
[0483]
[0484]
[0485]
[0486]
[0487]
[0488]
[0489]
[0490]
[0491]
[0492]
[0493]
[0494]
[0495]
[0496]
[0497]
[0498]
[0499]
[0500]
[0501]
[0502]
[0503]
[0504]
[0505]
[0506]
[0507]
[0508]
[0509]
[0510]
[0511]
[0512]
[0513]
[0514]
[0515]
[0516]
[0517]
[0518]
[0519]
[0520]
[0521]
[0522]
[0523]
[0524]
[0525]
[0526]
[0527]
[0528]
[0529]
[0530]
[0531]
[0532]
[0533]
[0534]
[0535]
[0536]
[0537]
[0538]
[0539]
[0540]
[0541]
[0542]
[0543]
[0544]
[0545]
[0546]
[0547]
[0548]
[0549]
[0550]
[0551]
[0552]
[0553]
[0554]
[0555]
[0556]
[0557]
[0558]
[0559]
[0560]
[0561]
[0562]
[0563]
[0564]
[0565]
[0566]
[0567]
[0568]
[0569]
[0570]
[0571]
[0572]
[0573]
[0574]
[0575]
[0576]
[0577]
[0578]
[0579]
[0580]
[0581]
[0582]
[0583]
[0584]
[0585]
[0586]
[0587]
[0588]
[0589]
[0590]
[0591]
[0592]
[0593]
[0594]
[0595]
[0596]
[0597]
[0598]
[0599]
[0600]
[0601]
[0602]
[0603]
[0604]
[0605]
[0606]
[0607]
[0608]
[0609]
[0610]
[0611]
[0612]
[0613]
[0614]
[0615]
[0616]
[0617]
[0618]
[0619]
[0620]
[0621]
[0622]
[0623]
[0624]
[0625]
[0626]
[0627]
[0628]
[0629]
[0630]
[0631]
[0632]
[0633]
[0634]
[0635]
[0636]
[0637]
[0638]
[0639]
[0640]
[0641]
[0642]
[0643]
[0644]
[0645]
[0646]
[0647]
[0648]
[0649]
[0650]
[0651]
[0652]
[0653]
[0654]
[0655]
[0656]
[0657]
[0658]
[0659]
[0660]
[0661]
[0662]
[0663]
[0664]
[0665]
[0666]
[0667]
[0668]
[0669]
[0670]
[0671]
[0672]
[0673]
[0674]
[0675]
[0676]
[0677]
[0678]
[0679]
[0680]
[0681]
[0682]
[0683]
[0684]
[0685]
[0686]
[0687]
[0688]
[0689]
[0690]
[0691]
[0692]
[0693]
[0694]
[0695]
[0696]
[0697]
[0698]
[0699]
[0700]
[0701]
[0702]
[0703]
[0704]
[0705]
[0706]
[0707]
[0708]
[0709]
[0710]
[0711]
[0712]
[0713]
[0714]
[0715]
[0716]
[0717]
[0718]
[0719]
[0720]
[0721]
[0722]
[0723]
[0724]
[0725]
[0726]
[0727]
[0728]
[0729]
[0730]
[0731]
[0732]
[0733]
[0734]
[0735]
[0736]
[0737]
[0738]
[0739]
[0740]
[0741]
[0742]
[0743]
[0744]
[0745]
[0746]
[0747]
[0748]
[0749]
[0750]
[0751]
[0752]
[0753]
[0754]
[0755]
[0756]
[0757]
[0758]
[0759]
[0760]
[0761]
[0762]
[0763]
[0764]
[0765]
[0766]
[0767]
[0768]
[0769]
[0770]
[0771]
[0772]
[0773]
[0774]
[0775]
[0776]
[0777]
[0778]
[0779]
[0780]
[0781]
[0782]
[0783]
[0784]
[0785]
[0786]
[0787]
[0788]
[0789]
[0790]
[0791]
[0792]
[0793]
[0794]
[0795]
[0796]
[0797]
[0798]
[0799]
[0800]
[0801]
[0802]
[0803]
[0804]
[0805]
[0806]
[0807]
[0808]
[0809]
[0810]
[0811]
[0812]
[0813]
[0814]
[0815]
[0816]
[0817]
[0818]
[0819]
[0820]
[0821]
[0822]
[0823]
[0824]
[0825]
[0826]
[0827]
[0828]
[0829]
[0830]
[0831]
[0832]
[0833]
[0834]
[0835]
[0836]
[0837]
[0838]
[0839]
[0840]
[0841]
[0842]
[0843]
[0844]
[0845]
[0846]
[0847]
[0848]
[0849]
[0850]
[0851]
[0852]
[0853]
[0854]
[0855]
[0856]
[0857]
[0858]
[0859]
[0860]
[0861]
[0862]
[0863]
[0864]
[0865]
[0866]
[0867]
[0868]
[0869]
[0870]
[0871]
[0872]
[0873]
[0874]
[0875]
[0876]
[0877]
[0878]
[0879]
[0880]
[0881]
[0882]
[0883]
[0884]
[0885]
[0886]
[0887]
[0888]
[0889]
[0890]
[0891]
[0892]
[0893]
[0894]
[0895]
[0896]
[0897]
[0898]
[0899]
[0900]
[0901]
[0902]
[0903]
[0904]
[0905]
[0906]
[0907]
[0908]
[0909]
[0910]
[0911]
[0912]
[0913]
[0914]
[0915]
[0916]
[0917]
[0918]
[0919]
[0920]
[0921]
[0922]
[0923]
[0924]
[0925]
[0926]
[0927]
[0928]
[0929]
[0930]
[0931]
[0932]
[0933]
[0934]
[0935]
[0936]
[0937]
[0938]
[0939]
[0940]
[0941]
[0942]
[0943]
[0944]
[0945]
[0946]
[0947]
[0948]
[0949]
[0950]
[0951]
[0952]
[0953]
[0954]
[0955]
[0956]
[0957]
[0958]
[0959]
[0960]
[0961]
[0962]
[0963]
[0964]
[0965]
[0966]
[0967]
[0968]
[0969]
[0970]
[0971]
[0972]
[0973]
[0974]
[0975]
[0976]
[0977]
[0978]
[0979]
[0980]
[0981]
[0982]
[0983]
[0984]
[0985]
[0986]
[0987]
[0988]
[0989]
[0990]
[0991]
[0992]
[0993]
[0994]
[0995]
[0996]
[0997]
[0998]
[0999]
[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]
<!DOCTYPE html>
<!-- WASDOC AXP-2.0.0 (CGILIB AXP-2.0.1) -->
<!-- wasDOC Copyright (C) 2019,2020 Mark G.Daniel - Apache-2.0 licenced -->
<!-- 11-JUL-2020 09:12 -->
<noscript>NOTE: SOME FUNCTIONALITY EMPLOYS JAVASCRIPT</noscript>
<div id="erreport1" style="display:none;"></div>
<script>
function errorReport(string) {
for (var cnt = 1; cnt <= 2; cnt++) {
var err = document.getElementById('erreport'+cnt);
err.style.display = 'block';
err.innerHTML += string;
}
}
</script>
<style type="text/css">
html { font-family: arial, verdana, sans-serif; font-size:12pt; margin:1em; }
h1 { font-size:124%; font-style:bold;
margin-top:1em; margin-bottom:0.5em; }
h2 { font-size:120%; font-style:bold;
margin-top:1.1em; margin-bottom:0.4em; }
h3 { font-size:116%; font-style:bold;
margin-top:1.0em; margin-bottom:0.3em; }
h4 { font-size:112%; font-style:bold;
margin-top:1.1em; margin-bottom:0.3em; }
h5 { font-size:112%; font-style:bold;
margin-top:1.1em; margin-bottom:0.3em; }
h6 { font-size:112%; font-style:bold; padding:0; margin:0; }
h1 .text { text-decoration:underline; }
h1 .numb { padding-right:0.8em; }
h1 .numb:empty { display:none; padding-right:0; }
h2 .numb { padding-right:0.8em; }
h2 .numb:empty { display:none; padding-right:0; }
h3 .numb { padding-right:0.8em; }
h3 .numb:empty { display:none; padding-right:0; }
h4 .numb { padding-right:0.8em; }
h4 .numb:empty { display:none; padding-right:0; }
h5 .numb { display:none; padding-right:0; }
h6 .numb { display:none; padding-right:0; }
kbd { font-family:monospace; }
noscript { font-size:1.2em; }
p { line-height:1.1em; margin-top:1em; margin-bottom:1em; }
.chunk { font-size:130%; text-decoration:underline; }
.head {}
.high {}
.bold { font-weight:bold; }
.center { text-align:center; }
.italic { font-style:italic; }
.left { text-align:left; }
.nowrap { white-space:nowrap; }
.prewrap { white-space:pre; }
.right { text-align:right; }
.strike { text-decoration:line-through; }
.under { text-decoration:underline; }
.backlight { background-color:#f2f2f2; }
.display0 { display:none; }
img { max-width:100%; }
.imglink { }
.link { }
.blank { }
.list { margin-bottom:1em; }
.list li { margin-top:0.5em; }
.list0 li { margin-top:0; }
.item {}
.tabl { border-collapse:collapse; text-align:left; margin:0.4em 2em 0.5em 2em; }
.tabu { border-collapse:collapse; text-align:right; margin:0.4em 2em 0.5em 2em; }
.tabr { vertical-align:top; }
.tabh { padding:0.2em 0 0 2em; margin:0; }
.tabd { padding:0.1em 0 0 2em; margin:0; }
.tabh:first-of-type, td:first-of-type { padding-left:0; }
.tabu .tabh,
.tabu .tabd { border:1px solid gray; padding:0.2em 0.3em 0.2em 0.3em; }
.tab0 { border:none; visibility:hidden; max-width:1em;
white-space:nowrap; overflow:hidden; }
.tabauto { margin-left:auto; margin-right:auto; }
.tabr:empty { height:0.2em; }
.tabu .tabh:empty, .tabu .tabd:empty { border:none; visibility:hidden; }
.error { font-size:110%; color:black; background-color:yellow;
font-family:sans-serif; font-weight:bold; font-style:normal;
width:95%; border:solid 1px gray; padding:0.5em 1em 0.5em 1em; }
.error::before { content:'\026a0\00a0'; }
.image { }
.page { width:98%; border:1px dashed gray; margin:1.5em 0 1.8em 0; }
.epage { width:98%; border:1px dashed black; margin:1.5em 0 1.8em 0; }
.monosp { font-family:monospace; }
.ppage { display:none; }
.simple { list-style-type:none; }
.valtop { vertical-align:top; }
.valmid { vertical-align:middle; }
.valbot { vertical-align:bottom; }
.code { border-style:solid; border-width:0 0 0 1px; padding-left:1em;
font-family:monospace; white-space:pre; }
.block { }
.blockof { margin:0.4em 2em 0.5em 2em; }
.example { border-style:dashed; border-width:0 0 0 1px; padding-left:1em;
margin-top:0.5em; margin-bottom:0.5em; white-space:pre; }
.indent { margin-left:2em; margin-right:2em; }
.noindent { margin-left:0; margin-right:0; }
.inblock { display:inline-block; }
.mono { white-space:pre; font-family:monospace; }
.note { margin:0.4em 2em 0.5em 2em; page-break-inside:avoid; }
.note h5 { margin-top:0 }
.note_hr { width:80%; border:1px solid gray; }
.prop { padding-left:1em; margin-top:0.5em; margin-bottom:0.5em; }
.quote { border-style:dashed; border-width:0 0 0 1px; padding-left:1em;
margin-top:0.5em; margin-bottom:0.5em; }
.this { display:none; }
a:link,a:visited { color:black; text-decoration:none; }
a:hover,a:active { text-decoration:underline; }
a:focus { outline:0; }
:target:before { content:''; display:block; height:0.1em; margin:-0.1em; }
a.link:link, a.link:visited,a.link:active
{ color:midnightBlue; text-decoration:underline; text-decoration-style:solid; }
.TOC1cols1 { width:80%; max-width:80%; }
.TOC1cols2 { column-count:2; width:80%; max-width:80%; }
.TOC1cols3 { column-count:3; max-width:90%; max-width:90%; }
.TOC1cols4 { column-count:4; max-width:100%; max-width:100%; }
.TOC1table { margin-left:2em; white-space:nowrap; break-inside:auto; }
.TOC1table tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.TOC1table td+td { padding:0 0 0 0.5em; }
.TOC1table .numb { width:3em; max-width:3em; }
.TOC1table .sepr { width:5em; max-width:6em; overflow:hidden; }
.TOC1table .majr { font-weight:bold; }
.TOC1table .text { white-space:normal; }
/* These are due to Firefox (at least <= 76) recalcitrant multi-column handling.
Web search "Split table into css columns, issue in Firefox" (stackoverflow).
"Good grief, Charlie Brown!" */
.TOC1cols2 table,
.TOC1cols2 tbody,
.TOC1cols2 tr,
.TOC1cols3 table,
.TOC1cols3 tbody,
.TOC1cols3 tr,
.TOC1cols4 table,
.TOC1cols4 tbody,
.TOC1cols4 tr { display:block; padding:0; }
.TOC2cols1 { width:60%; max-width:60%; }
.TOC2cols2 { column-count:2; width:70%; max-width:70%; }
.TOC2cols3 { column-count:3; width:80%; max-width:80%; }
.TOC2cols4 { column-count:4; width:90%; max-width:90%; }
.TOC2table { margin-left:2em; white-space:nowrap; break-inside:auto; }
.TOC2table tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.TOC2table .numb { font-weight:bold; padding-right:0.5em; }
.TOC2table .text { width:100%; white-space:normal; }
/* see "recalcitrant" above */
.TOC2cols2 table,
.TOC2cols2 tbody,
.TOC2cols2 tr,
.TOC2cols3 table,
.TOC2cols3 tbody,
.TOC2cols3 tr,
.TOC2cols4 table,
.TOC2cols4 tbody,
.TOC2cols4 tr { display:block; padding:0; }
.NAVtable { margin:0.1em 0 0 2em; }
.NAVtable td { font-size:110%; font-weight:bold; padding:0; margin:0; }
.NAVtable a { padding:0 0.5em 0 0.5em; text-decoration:none; }
.IDXcols1 { width:80%; max-width:80%; }
.IDXcols2 { column-count:2; width:90%; max-width:90%; }
.IDXcols3 { column-count:3; width:95%; max-width:95%; }
.IDXcols4 { column-count:4; width:100%; max-width:100%; }
.IDXtable { margin:1em 0 1em 2em; white-space:nowrap; break-inside:auto; }
.IDXtable tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.IDXtable .alpha { font-weight:bold; min-width:2em; }
.IDXtable .text { width:100%; white-space:normal; }
.IDXtable .para:before { content:'\00b6\00a0'; }
/* see "recalcitrant" above */
.IDXcols2 table,
.IDXcols2 tbody,
.IDXcols2 tr,
.IDXcols3 table,
.IDXcols3 tbody,
.IDXcols3 tr,
.IDXcols4 table,
.IDXcols4 tbody,
.IDXcols4 tr { display:block; padding:0; }
.insight { background-color:cyan; font-family:monospace;
padding:0 0.2em 0 0.2em; margin:0 0.2em 0 0.2em;
font-size:100%; font-style:normal; font-weight:normal;
text-decoration:none; }
.wasdoc { font-family: "Lucida Console", Monaco, monospace;
letter-spacing:-0.07em; }
@media screen { .blank::after { content:"\2924"; }
.print { display:none; }
}
@media print {
table { page-break-inside:avoid; }
.noprint { display:none; }
.page { border:none; page-break-after: always; }
.epage { display:none; }
.ppage { page-break-after:always; }
.NAVtable { display:none; }
.NAVprint { display:block!important; }
}
@page { margin:2cm 1cm 2cm 1cm; }
</style>
<!-- source:0000_WASDOC.WASDOC -->
<style type="text/css">._button { border: 1px gray solid; border-radius:3px; padding:0.1em; margin:0.1em; font-size:90%; }</style>
<style type="text/css">._smiley::after { font-size:150%; vertical-align:middle; content:'\263a' }</style>
<style type="text/css">._frowny::after { font-size:150%; vertical-align:middle; content:'\2639' }</style>
<a id="0." href="#"></a>
<a id="0.0.0.0.1" href="#"></a>
<a id="0.wasddocumentationprocessor" href="#"></a>
<a id="wasddocumentationprocessor" href="#"></a>
<h1 class="head" style="font-size:140%;"><span class="text">WASD Documentation Processor</span></h1>
<p> The <span class="high wasdoc">wasDOC</span> document processing system is a CLI and CGI application
that processes its own markup syntax into HTML. Documents are generated from
multiple source files, with cross-referencing, table of content and navigation,
is economical and concise in its syntax, while allowing a full(-ish) range of
document capabilities, along with presentation customisation using style sheets
(CSS).
<p> <span class="high bold">Published July 2020 for <span class="high wasdoc">wasDOC</span> v2.0</span>
<p> Document generated using <span class="high wasdoc">wasDOC</span> v2.0.0
<p> <span class="high bold" style="font-size:110%;"><span class="high wasdoc">wasDOC</span> © Mark G. Daniel 2019,2020</span>
<a id="0.0.0.0.1.1" href="#"></a>
<a id="0.apachelicenseversion20" href="#"></a>
<a id="apachelicenseversion20" href="#"></a>
<h6 class="head display0"><span class="text">Apache License, Version 2.0</span></h6>
<a id="0.0.0.0.1.2" href="#"></a>
<a id="0.license" href="#"></a>
<a id="license" href="#"></a>
<h6 class="head display0"><span class="text">License</span></h6>
<p> Licensed under the <span class="high bold">Apache License</span>, Version 2.0 (the "License");
<div class="blockof quote" style="font-size:0.9em;width:49em;margin:-0.5em 0 0 1em;">you may not use this software except in compliance with the License.
You may obtain a copy of the License at
<p> <a class="link blank" target="_blank" style="margin-left:1em;" href="https://www.apache.org/licenses/LICENSE-2.0">https://www.apache.org/licenses/LICENSE-2.0</a>
<p> Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
</div>
<p> <a class="link" href="mailto:Mark.Daniel@wasd.vsm.com.au">Mark.Daniel@wasd.vsm.com.au</a>
<br> <span class="high bold italic">A pox on the houses of all spamers. Make that two poxes.</span>
<a id="0.0.0.0.1.3" href="#"></a>
<a id="0.documentformats" href="#"></a>
<a id="documentformats" href="#"></a>
<h6 class="head display0"><span class="text">document formats</span></h6>
<p> This is a static (file), single document.
<br> Alternative <a class="link" href="/wasd_root/src/wasdoc/doc/wasdoc.html">multi-part</a> static and
<a class="link" href="/cgi-bin/wasdoc/wasd_root/src/wasdoc/doc/">dynamic</a> documents.
<p> Links followed by ⤤ open in a new page.
<a id="0.0.0.0.2.3" href="#"></a>
<a id="0.tableofcontent" href="#"></a>
<a id="tableofcontent" href="#"></a>
<h1 class="head"><span class="text">Table of Content</span></h1>
<div class="TOC1cols2">
<table class="TOC1table">
<tr><td class="sepr"><a href="#1.wasddocumentationprocessormdashwasdoc">1.</a>………………<td class="text majr"><a href="#1.wasddocumentationprocessormdashwasdoc">WASD Documentation Processor — <span class="high wasdoc">wasDOC</span> </a>
<tr><td class="sepr"><a href="#1.1.yamlyetanothermarkuplanguage">1.1</a>………………<td class="text"><a href="#1.1.yamlyetanothermarkuplanguage">YAML (Yet Another Markup Language)</a>
<tr><td class="sepr"><a href="#1.2.deployingwasdoc">1.2</a>………………<td class="text"><a href="#1.2.deployingwasdoc">Deploying <span class="high wasdoc">wasDOC</span></a>
<tr><td class="sepr"><a href="#1.2.1.dynamicdocument">1.2.1</a>………………<td class="text"><a href="#1.2.1.dynamicdocument">Dynamic Document</a>
<tr><td class="sepr"><a href="#1.2.2.staticdocument">1.2.2</a>………………<td class="text"><a href="#1.2.2.staticdocument">Static Document</a>
<tr><td class="sepr"><a href="#2.markupfundamentals">2.</a>………………<td class="text majr"><a href="#2.markupfundamentals">Markup Fundamentals</a>
<tr><td class="sepr"><a href="#2.1.documentsections">2.1</a>………………<td class="text"><a href="#2.1.documentsections">Document Sections</a>
<tr><td class="sepr"><a href="#2.1.1.othersectionnumbers">2.1.1</a>………………<td class="text"><a href="#2.1.1.othersectionnumbers">Other Section Numbers</a>
<tr><td class="sepr"><a href="#2.2.texthighlight">2.2</a>………………<td class="text"><a href="#2.2.texthighlight">Text Highlight</a>
<tr><td class="sepr"><a href="#2.3.breaks">2.3</a>………………<td class="text"><a href="#2.3.breaks">Breaks</a>
<tr><td class="sepr"><a href="#2.4.blocks">2.4</a>………………<td class="text"><a href="#2.4.blocks">Blocks</a>
<tr><td class="sepr"><a href="#2.5.notes">2.5</a>………………<td class="text"><a href="#2.5.notes">Notes</a>
<tr><td class="sepr"><a href="#2.6.lists">2.6</a>………………<td class="text"><a href="#2.6.lists">Lists</a>
<tr><td class="sepr"><a href="#2.7.insertion">2.7</a>………………<td class="text"><a href="#2.7.insertion">Insertion</a>
<tr><td class="sepr"><a href="#2.7.1.spawnedcommand">2.7.1</a>………………<td class="text"><a href="#2.7.1.spawnedcommand">Spawned Command</a>
<tr><td class="sepr"><a href="#2.7.2.flaginsertion">2.7.2</a>………………<td class="text"><a href="#2.7.2.flaginsertion">FLAG Insertion</a>
<tr><td class="sepr"><a href="#2.7.3.systemdata">2.7.3</a>………………<td class="text"><a href="#2.7.3.systemdata">System Data</a>
<tr><td class="sepr"><a href="#2.8.verbarquotandverbarasisverbar">2.8</a>………………<td class="text"><a href="#2.8.verbarquotandverbarasisverbar">|" and |asis|</a>
<tr><td class="sepr"><a href="#2.9.othermarkup">2.9</a>………………<td class="text"><a href="#2.9.othermarkup">Other Markup</a>
<tr><td class="sepr"><a href="#2.10.images">2.10</a>………………<td class="text"><a href="#2.10.images">Images</a>
<tr><td class="sepr"><a href="#2.11.boxdrawing">2.11</a>………………<td class="text"><a href="#2.11.boxdrawing">Box Drawing</a>
<tr><td class="sepr"><a href="#2.12.documentstyle">2.12</a>………………<td class="text"><a href="#2.12.documentstyle">Document Style</a>
<tr><td class="sepr"><a href="#3.tables">3.</a>………………<td class="text majr"><a href="#3.tables">Tables</a>
<tr><td class="sepr"><a href="#4.links">4.</a>………………<td class="text majr"><a href="#4.links">Links</a>
<tr><td class="sepr"><a href="#4.1.theessentialfragment">4.1</a>………………<td class="text"><a href="#4.1.theessentialfragment">The Essential Fragment</a>
<tr><td class="sepr"><a href="#4.2.linkstootherdocuments">4.2</a>………………<td class="text"><a href="#4.2.linkstootherdocuments">Links to Other Documents</a>
<tr><td class="sepr"><a href="#5.conditionalcontent">5.</a>………………<td class="text majr"><a href="#5.conditionalcontent">Conditional Content</a>
<tr><td class="sepr"><a href="#5.1.matchconditional">5.1</a>………………<td class="text"><a href="#5.1.matchconditional">Match Conditional</a>
<tr><td class="sepr"><a href="#5.1.1.regexbasics">5.1.1</a>………………<td class="text"><a href="#5.1.1.regexbasics">Regex Basics</a>
<tr><td class="sepr"><a href="#5.2.spawnconditional">5.2</a>………………<td class="text"><a href="#5.2.spawnconditional">Spawn Conditional</a>
<tr><td class="sepr"><a href="#5.3.timeconditional">5.3</a>………………<td class="text"><a href="#5.3.timeconditional">Time Conditional</a>
<tr><td class="sepr"><a href="#6.documentnavigation">6.</a>………………<td class="text majr"><a href="#6.documentnavigation">Document Navigation</a>
<tr><td class="sepr"><a href="#6.1.primarytoc">6.1</a>………………<td class="text"><a href="#6.1.primarytoc">Primary TOC</a>
<tr><td class="sepr"><a href="#6.2.secondarytoc">6.2</a>………………<td class="text"><a href="#6.2.secondarytoc">Secondary TOC</a>
<tr><td class="sepr"><a href="#6.3.navigationicons">6.3</a>………………<td class="text"><a href="#6.3.navigationicons">Navigation Icons</a>
<tr><td class="sepr"><a href="#6.4.documentindex">6.4</a>………………<td class="text"><a href="#6.4.documentindex">Document Index</a>
<tr><td class="sepr"><a href="#7.documentconstruction">7.</a>………………<td class="text majr"><a href="#7.documentconstruction">Document Construction</a>
<tr><td class="sepr"><a href="#7.1.control">7.1</a>………………<td class="text"><a href="#7.1.control">Control</a>
<tr><td class="sepr"><a href="#7.2.flags">7.2</a>………………<td class="text"><a href="#7.2.flags">FLAGs</a>
<tr><td class="sepr"><a href="#7.3.documentinsights">7.3</a>………………<td class="text"><a href="#7.3.documentinsights">Document Insights</a>
<tr><td class="sepr"><a href="#8.quickreference">8.</a>………………<td class="text majr"><a href="#8.quickreference">Quick Reference</a>
<tr><td class="sepr"><a href="#9.index">9.</a>………………<td class="text majr"><a href="#9.index">Index</a>
</table>
</div>
<br>
<!-- source:0100_INTRO.WASDOC -->
<hr class="page">
<a id="1." href="#"></a>
<a id="1.wasddocumentationprocessormdashwasdoc" href="#"></a>
<a id="wasddocumentationprocessormdashwasdoc" href="#"></a>
<h1 class="head"><span class="numb">1.</span><span class="text">WASD Documentation Processor — <span class="high wasdoc">wasDOC</span> </span></h1>
<table class="TOC2table">
<tr><td><a href="#1.1.yamlyetanothermarkuplanguage"><span class="numb">1.1</span><span class="text">YAML (Yet Another Markup Language)</span></a>
<tr><td><a href="#1.2.deployingwasdoc"><span class="numb">1.2</span><span class="text">Deploying wasDOC</span></a>
<tr><td><a href="#1.2.1.dynamicdocument"><span class="numb">1.2.1</span><span class="text">Dynamic Document</span></a>
<tr><td><a href="#1.2.2.staticdocument"><span class="numb">1.2.2</span><span class="text">Static Document</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#0.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#2.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> For the first twenty-five years WASD documentation was largely maintained
using first the VAX, then DEC Document layered product (sold to Touch
Technologies, Inc.). With the demise of the TTI DEC Document a couple of
decades ago, it tenuously hanging on in legacy Alpha kits, without a port to
Itanium and certainly no prospect to x86-64, while there being no
vendor-supplied equivalent documentation system on VMS, or suggested else
elsewhere, then guess-what? Roll one's own, fit-for-purpose, CLI and CGI
document system. The browser having become ubiquitous in the couple of decades
since the birth of WASD and with HTML the lingua franca of markup languages
— use those!
<a id="1.1" href="#"></a>
<a id="1.1.yamlyetanothermarkuplanguage" href="#"></a>
<a id="yamlyetanothermarkuplanguage" href="#"></a>
<h2 class="head"><span class="numb">1.1</span><span class="text">YAML (Yet Another Markup Language)</span></h2>
<a id="1.1.0.0.1" href="#"></a>
<a id="1.1.inwasdsinimitablestyleofcoursenbsp" href="#"></a>
<a id="inwasdsinimitablestyleofcoursenbsp" href="#"></a>
<h5 class="head"><span class="text">In WASD's inimitable style of course <span class="high _smiley"> </span></span></h5>
<p> No, not that one. This one <span class="high italic">is</span> a markup processor. The vertical bar
character is used to delimit markup tags and commonly the text they are applied
to. For example, this <span class="high bold">bold text</span> was formatted using <span class="high monosp">|*bold text|</span> and
that explanation formatted using <span class="high monosp">|=\|*bold text\||</span>. Note the use of
the backslash character. It is all fairly straight-forward but more detail
shortly.
<p> If <span class="high wasdoc">wasDOC</span> is intended for browsers then why not just write HTML or
use an HTML editor? Sure. But <span class="high wasdoc">wasDOC</span> is more than just markup. It
is a processing system that integrates documents from multiple source files,
manages cross-referencing and table of content, is economical and concise in
its syntax while allowing a full(-ish) range of document capabilities, along
with presentation customisation using style sheets (CSS). All on VMS. All
using a preferred text editor.
<p> A knowledge of HTML and CSS is definitely <span class="high bold">not necessary</span> for authoring
using <span class="high wasdoc">wasDOC</span> – but may help understand some design decisions –
and some understanding of CSS essential to customise the look and feel of a
document.
<p> Unreservedly, <span class="high wasdoc">wasDOC</span> was designed and is intended for maintaining
general WASD documentation. Any other utility is incidental and secondary.
<a id="1.1.0.0.2" href="#"></a>
<a id="1.1.otherwasdocadvantages" href="#"></a>
<a id="otherwasdocadvantages" href="#"></a>
<h5 class="head"><span class="text">Other <span class="high wasdoc">wasDOC</span> Advantages</span></h5>
<p> Being a CGI application, quick and inexpensive when rendering, it is simple
to check editing changes as they are made. Just maintain a browser page on the
document and <span class="high italic">refresh</span>.
<p> The same CGI basis makes it a ready tool for creating dynamic documents.
External files, from anywhere the scripting account has access, can be
included. Other dynamic content, such as the current date/time –
Sat, 11 Jul 2020 09:12:19 – is also available.
<p> At the same time <span class="high wasdoc">wasDOC</span> can be used on the command-line and the
rendered HTML output to a file (or files) allowing static documents to be
generated.
<p> Every browser's ability to print to PDF easily provides documents in this
format if required. Other document format conversion tools can be used to
render a static HTML document to <span class="high italic">whatever</span>.
<p> <span class="high bold">This document is a little overblown</span> for the following reasons; it
<span class="high bold">demonstrates</span> as many aspects of <span class="high wasdoc">wasDOC</span> as possible, <span class="high bold">exercises</span>
those same aspects, and was employed as a <span class="high bold">development use case</span>.
<p> <span class="high bold">IMHO; It really is a delight to use.</span>
<a id="1.2" href="#"></a>
<a id="1.2.deployingwasdoc" href="#"></a>
<a id="deployingwasdoc" href="#"></a>
<h2 class="head"><span class="numb">1.2</span><span class="text">Deploying <span class="high wasdoc">wasDOC</span></span></h2>
<p> Each document should be contained in its own directory. A document
comprises one or more <span class="high monosp">.WASDOC</span> type files containing marked-up text. File
names beginning with an underscore are ignored.
<div class="note">
<a id="1.2.0.0.1" href="#"></a>
<a id="1.2.wasdoc" href="#"></a>
<a id="wasdoc" href="#"></a>
<h5 class="head center monosp"><span class="text">.WASDOC</span></h5>
<hr class="note_hr">
The <span class="high monosp">.WASDOC</span> file type seemed an obvious choice.
<br> To have these recognised as plain-text, established WASD sites will need to
add <span class="high monosp">.WASDOC</span> to global configuration.
<div class="blockof code"># WASD_CONFIG_GLOBAL
⋮
# -CONTENT TYPES-
⋮
.VMS text/plain plain text
.WASDOC text/plain wasDOC Markup Language <span style="background-color:yellow;padding:0.5em;">⇦ HERE</span>
⋮
</div>
<hr class="note_hr">
</div>
<p> A rendered document (HTML) is constructed by reading each of multiple
document files in directory order, creating an in-memory composite which is
then processed from beginning to end. Hence, the files
<div class="blockof mono">1_INTRODUCTION.WASDOC
2_DETAIL.WASDOC
3_SOLUTION.WASDOC
9_CONCLUSION.WASDOC
</div>
generate a document that begins (suggested by file name) with an introduction,
some detail and a solution, and finishes up with a conclusion – all due to
each file being read and processed in order. Of course it could be confined to
a single file but this allows larger documents to have the source organised
into more managable chunks. There is no relationship between section numbering
and any numbering used in source file names. Document files, distinguished by
the file type (extension), may be mixed with other files in a directory.
<p> <span class="high bold">A blog</span> might be organised, with more recent entries listed before older,
by a set of files such as the following.
<div class="blockof mono">1_OVERVIEW.WASDOC
5_996_2019FEB23.WASDOC
5_997_2019FEB09.WASDOC
5_998_2019JAN26.WASDOC
5_999_2019JAN12.WASDOC
9_POSTSCRIPT.WASDOC
</div>
Adding a new blog entry would be a matter creating a file with a name in the
"5" group, a number one less than the existing "latest" entry and then the
remaining file name, here suggested to be the actual date of the entry. Hence,
a file for a March 9th entry would be named <span class="high monosp">5_995_2019MAR09.WASDOC</span> and the
first markup <span class="high monosp">|hide|</span> while the entry was edited – see <a class="link" href="#7.documentconstruction">7. Document Construction</a>.
<a id="1.2.1" href="#"></a>
<a id="1.2.1.dynamicdocument" href="#"></a>
<a id="dynamicdocument" href="#"></a>
<h3 class="head"><span class="numb">1.2.1</span><span class="text">Dynamic Document</span></h3>
<a id="1.2.1.0.0.1" href="#"></a>
<a id="1.2.1.apacheserver" href="#"></a>
<a id="apacheserver" href="#"></a>
<h6 class="head display0"><span class="text">Apache server</span></h6>
<a id="1.2.1.0.0.2" href="#"></a>
<a id="1.2.1.osuserver" href="#"></a>
<a id="osuserver" href="#"></a>
<h6 class="head display0"><span class="text">OSU server</span></h6>
<p> These are documents which when accessed are generated and provided by a
(CGI) scripting application. The <span class="high monosp">WASDOC.EXE</span> is placed into the server
scripting location and document directories mapped to become the
<span class="high monosp">PATH_TRANSLATED</span> CGI variable provided to it. <span class="high wasdoc">wasDOC</span> CGI is
suitable for use with VMS Apache, OSU and of course is a default component of
WASD. This document only considers WASD but the few principles readily
translate to the others. WASD CGIplus mapping may also be used.
<span class="high bold">You are currently viewing a static document.</span>
<p> The simplest approach is just to provide the script with an already-mapped
file-system location. To process <span class="high wasdoc">wasDOC</span>'s own documentation using
this approach the URL would be
<div class="blockof mono">https://the.host.name<a class="link" target="_blank" href="/cgi-bin/wasdoc/wasd_root/src/wasdoc/doc/">/cgi-bin/wasdoc/wasd_root/src/wasdoc/doc/</a> †
</div>
<p class="indent"> † <span class="high italic">may work or not depending on site configuarion</span>
<p> A document URI can be explicitly mapped to the document processor. This
allows the document to be "transparently" accessed (i.e. it's not immediately
obvious a script is being used).
<div class="blockof mono">map /wasdoc/ /cgi-bin/wasdoc/wasd_root/src/wasdoc/doc/
</div>
The URL used to access that document would be
<div class="blockof mono">https://the.host.name/wasdoc/
</div>
<span class="high bold">Note</span> that the <span class="high italic">directory</span> specification is parsed from the translated path
so anything following this is ignored. Continuing with the above mapping, all
the following are all equivalent and would return the rendered document from
<span class="high monosp">WASD_ROOT:[SRC.WASDOC.DOC]</span> directory.
<div class="blockof mono">https://the.host.name/wasdoc/
https://the.host.name/wasdoc/wasdoc.html
https://the.host.name/wasdoc/Fred+Flintstone
</div>
<a id="1.2.1.0.1" href="#"></a>
<a id="1.2.1.largedocument" href="#"></a>
<a id="largedocument" href="#"></a>
<h5 class="head"><span class="text">Large Document</span></h5>
<p> A large document may be presented in major section "chunks". The advantage
is to have the client dealing with more manageable quantities of the document
in their browser at any one time rather than the whole thing, possibly over
many, many scrollable pages. Really just a personal preference. The content
remains the same. Note that a document is fully generated with each access,
even if only a portion is output to the client.
<p> This behaviour is controlled using the <span class="high monosp">|set|chunked=|</span> document
setting.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Setting
<th class="tabh">Behaviour
<tr class="tabr">
<td class="tabd"><span class="high monosp">|set|chunked=1|</span>
<td class="tabd">the document is always supplied chunked
<tr class="tabr">
<td class="tabd"><span class="high monosp">|set|chunked=0|</span>
<td class="tabd">chunking is determined by a numeric value trailing the URL
<tr class="tabr">
<td class="tabd">
<td class="tabd">for example: <span class="high monosp">/wasd_root/src/wasdoc/wasdoc/doc/000/</span>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|set|chunked=-1|</span>
<td class="tabd">chunking is disabled
</table>
<a id="1.2.2" href="#"></a>
<a id="1.2.2.staticdocument" href="#"></a>
<a id="staticdocument" href="#"></a>
<h3 class="head"><span class="numb">1.2.2</span><span class="text">Static Document</span></h3>
<p> A static document is one produced at the command-line and then accessed as
any other HTML document.
<span class="high bold">You are currently viewing a static document.</span>
The <span class="high wasdoc">wasDOC</span> executable can be activated
directly from the script location, or any other, using a foreign command or the
MCR utility.
<div class="blockof mono">$ wasdoc == "$cgi_exe:wasdoc.exe"
</div>
If a file name is specified using the <span class="high italic monosp">output=</span> qualifier the generated HTML
is stored in that. else it is sent to SYS$OUTPUT.
<div class="blockof mono">$ set default wasd_root:[src.wasdoc]
$ wasdoc [.doc] /output=[.doc]wasdoc.html
$ mcr cgi_exe:wasdoc.exe [.doc] /output=[.doc]wasdoc.html
</div>
Then the static content is available (continuing the example) via
<div class="blockof mono">https://the.host.name<a target="_blank" href="/wasd_root/src/wasdoc/doc/wasdoc.html">/wasd_root/src/wasdoc/doc/wasdoc.html</a>
</div>
<a id="1.2.2.0.1" href="#"></a>
<a id="1.2.2.multipartdocument" href="#"></a>
<a id="multipartdocument" href="#"></a>
<h5 class="head"><span class="text">Multipart Document</span></h5>
<p> As with dynamic documents, large static documents may be presented in major
section "chunks". This means the document is written as a series of files
with document navigation adjusting internal referencing to the required file.
Each file contains the document prologue (e.g. style data) and so is in some
sense a standalone sub-document requiring no further external resources. The
<span class="high italic">chunked</span> qualifier is used as with the following example.
<div class="blockof mono">$ set default wasd_root:[src.wasdoc]
$ wasdoc [.doc] /output=[.doc]wasdoc.html /chunked
</div>
<p> This would produce a series of related files similar to the following:
<div class="blockof mono">wasdoc.html
wasdoc000.html
wasdoc001.html
wasdoc002.html
wasdoc003.html
wasdoc004.html
</div>
<p> The unnumbered file is identical to the <span class="high monosp">000</span> file and is provided for more
obvious access to the document. To suppress this file use <span class="high monosp">/NOMAIN</span> and
to specify and alternate file name use <span class="high monosp">/MAIN=<span class="high italic">name</span></span> qualifier.
<a id="1.2.2.0.2" href="#"></a>
<a id="1.2.2.staticinsight" href="#"></a>
<a id="staticinsight" href="#"></a>
<h5 class="head"><span class="text">Static Insight</span></h5>
<p> <a class="link" href="#7.3.documentinsights">7.3 Document Insights</a> may also be added to static documents using the
<span class="high monosp">/INSIGHT=<span class="high italic"><integer></span></span> qualifier. Using <span class="high monosp">/INSIGHT</span> alone just lists
the document as it is processed.
<!-- source:0200_MARKUP.WASDOC -->
<hr class="page">
<a id="2." href="#"></a>
<a id="2.markupfundamentals" href="#"></a>
<a id="markupfundamentals" href="#"></a>
<h1 class="head"><span class="numb">2.</span><span class="text">Markup Fundamentals</span></h1>
<div class="TOC2cols2">
<table class="TOC2table">
<tr><td><a href="#2.1.documentsections"><span class="numb">2.1</span><span class="text">Document Sections</span></a>
<tr><td><a href="#2.1.1.othersectionnumbers"><span class="numb">2.1.1</span><span class="text">Other Section Numbers</span></a>
<tr><td><a href="#2.2.texthighlight"><span class="numb">2.2</span><span class="text">Text Highlight</span></a>
<tr><td><a href="#2.3.breaks"><span class="numb">2.3</span><span class="text">Breaks</span></a>
<tr><td><a href="#2.4.blocks"><span class="numb">2.4</span><span class="text">Blocks</span></a>
<tr><td><a href="#2.5.notes"><span class="numb">2.5</span><span class="text">Notes</span></a>
<tr><td><a href="#2.6.lists"><span class="numb">2.6</span><span class="text">Lists</span></a>
<tr><td><a href="#2.7.insertion"><span class="numb">2.7</span><span class="text">Insertion</span></a>
<tr><td><a href="#2.7.1.spawnedcommand"><span class="numb">2.7.1</span><span class="text">Spawned Command</span></a>
<tr><td><a href="#2.7.2.flaginsertion"><span class="numb">2.7.2</span><span class="text">FLAG Insertion</span></a>
<tr><td><a href="#2.7.3.systemdata"><span class="numb">2.7.3</span><span class="text">System Data</span></a>
<tr><td><a href="#2.8.verbarquotandverbarasisverbar"><span class="numb">2.8</span><span class="text">|" and |asis|</span></a>
<tr><td><a href="#2.9.othermarkup"><span class="numb">2.9</span><span class="text">Other Markup</span></a>
<tr><td><a href="#2.10.images"><span class="numb">2.10</span><span class="text">Images</span></a>
<tr><td><a href="#2.11.boxdrawing"><span class="numb">2.11</span><span class="text">Box Drawing</span></a>
<tr><td><a href="#2.12.documentstyle"><span class="numb">2.12</span><span class="text">Document Style</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#1.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#3.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> Markup directives, otherwise referred to as <span class="high italic">tags</span>, are introduced using a
<span class="high bold">vertical bar</span> followed by a symbol, a single digit, or a string. Most are
concluded, or <span class="high italic">closed</span>, using another vertical bar followed by white-space
(space, newline, etc). Where no white-space follows two consecutive vertical
bar characters must be used. The <span class="high italic">vertical bar</span> hereafter will be referred to
as the <span class="high bold">Vbar</span>.
<a id="2.0.0.0.1" href="#"></a>
<a id="2.whythevbar" href="#"></a>
<a id="whythevbar" href="#"></a>
<h5 class="head"><span class="text">Why the Vbar?</span></h5>
<p> Importantly, the markup introducing character needs to be uncommonly used.
Needing to escape every tenth character would very quickly become very tedious.
Additionally, the source text should look as uncluttered as possible. The Vbar
seems eminently suited. (Early development of <span class="high wasdoc">wasDOC</span> employed the
dollar symbol which in comparison made the source text look and feel very
crowded.)
<a id="2.0.0.0.1.1" href="#"></a>
<a id="2.anoteregardingtheuseoftheverbarverticalbarsymbolampbackslashcharacterexplicitverbarthisverbar" href="#"></a>
<a id="anoteregardingtheuseoftheverbarverticalbarsymbolampbackslashcharacterexplicitverbarthisverbar" href="#"></a>
<h6 class="head display0"><span class="text">A note regarding the use of the | vertical bar symbol & \ backslash character (explicit |this|)</span></h6>
<div class="note">
<a id="2.0.0.0.2" href="#"></a>
<a id="2.vbarsandescapes" href="#"></a>
<a id="vbarsandescapes" href="#"></a>
<h5 class="head center"><span class="text">Vbars and Escapes</span></h5>
<hr class="note_hr">
Vbar characters to be displayed as that must always be escaped using a leading
backslash. In fact, any character may be escaped using a leading backslash,
including the backslash. A backslash then space inserts a hard (non-breaking)
space, like these, while a backslash as the final character on a line
continues that line unbroken (by <span class="high italic">suppressing</span> the new line). Also see
<a class="link" href="#2.9.vbarscanbemessy">‘Vbars can be messy...’ in 2.9 Other Markup</a>.
<hr class="note_hr">
</div>
<a id="2.0.0.0.2.1" href="#"></a>
<a id="2.aparagraph" href="#"></a>
<a id="aparagraph" href="#"></a>
<h6 class="head display0"><span class="text">a paragraph!</span></h6>
<p> When nested tags become complex and sometimes confusing it is often useful
to document for the author which tag is being closed. This can be done using
the <span class="high monosp">|!</span> tag – annotated closure – which accepts ad hoc text terminated
with the usual Vbar. For example, for clarity in the source text, the <span class="high italic">Vbars
and Escapes</span> note above was begun with a <span class="high monosp">|note|</span> tag and closed with a
<span class="high monosp">|!note|</span>. But be aware, you can put anything you like after the <span class="high monosp">|!</span>
and before the closing <span class="high monosp">|</span>. The text is really only commentary.
<a id="2.1" href="#"></a>
<a id="2.1.documentsections" href="#"></a>
<a id="documentsections" href="#"></a>
<h2 class="head"><span class="numb">2.1</span><span class="text">Document Sections</span></h2>
<p> Documents are generally divided into major sections (can be considered
chapters) and subsections. For example, the <span class="high italic">Markup Fundamentals</span> (above) is a
major section and the <span class="high italic">Document Sections</span> (immediately above) is a second-level
(sub) section, with <span class="high italic">Other Section Numbers</span> (below) a further level of subsection. A
maximum of four levels is possible.
<p> A section is introduced with the usual Vbar followed by a digit.
<a id="2.1.0.0.0.1" href="#"></a>
<a id="2.1.sectionnumbers14" href="#"></a>
<a id="sectionnumbers14" href="#"></a>
<h6 class="head display0"><span class="text">section numbers 1...4</span></h6>
<a id="2.1.0.0.0.2" href="#"></a>
<a id="2.1.headingcrossreference" href="#"></a>
<a id="headingcrossreference" href="#"></a>
<h6 class="head display0"><span class="text">Heading Cross-Reference</span></h6>
<p> Section <span class="high bold">numbers 1…4</span> generate numbered headings. For example, <span class="high monosp">|1A
Major Heading|</span>, <span class="high monosp">|2Subsection Heading|</span>, <span class="high monosp">|3The Further
Subsection|</span> and <span class="high monosp">|4Lowest Subsection|</span>, result in headings similar to
the following
<div class="blockof block"><div style="font-size:115%;font-weight:bold;">1.
<span style="text-decoration:underline;">A Major Heading</span></div>
<div style="font-size:110%;font-weight:bold;">1.1
Subsection Heading</div>
<div style="font-size:105%;font-weight:bold;">1.1.1
The Further Subsection</div>
<div style="font-size:105%;font-weight:bold;">1.1.1.1
Lowest Subsection</div>
</div>
<p> These also generate table of content (TOC) and Index entries. See
<a class="link" href="#0.tableofcontent">‘Table of Content’ in WASD Documentation Processor</a> and <a class="link" href="#6.documentnavigation">6. Document Navigation</a>. To suppress the TOC
entry prefix the section heading digit with a <span class="high monosp">0</span> (zero) digit. Section
numbering can be suppressed altogether with a TOC setting of zero (see
<a class="link" href="#6.1.tocnumbering">‘TOC Numbering’ in 6.1 Primary TOC</a>).
<a id="2.1.0.0.0.3" href="#"></a>
<a id="2.1.sectionnumber0" href="#"></a>
<a id="sectionnumber0" href="#"></a>
<h6 class="head display0"><span class="text">section number 0</span></h6>
<p> Section <span class="high bold">number 0 (zero)</span> generates a heading equivalient to 4 but without
an associated TOC entry or numbering.
<a id="2.1.0.0.0.4" href="#"></a>
<a id="2.1.sectionnumber9" href="#"></a>
<a id="sectionnumber9" href="#"></a>
<h6 class="head display0"><span class="text">section number 9</span></h6>
<p> Section <span class="high bold">number 9 (nine)</span> generates a heading for index and reference
purposes but one that does not display in the document. In addition to the
visible headings 0..4 the 9 heading allows the creation of a generously
cross-referenced document. To suppress the index entry while still inserting a
reference, prefix the section number 9 digit with a <span class="high monosp">0</span> (zero) digit (i.e.
<span class="high monosp">|09</span>). A section number 9 may also be prefixed with another 9 (i.e.
<span class="high monosp">|99</span>) to further modify the reference. Also see <a class="link" href="#6.4.verbar9verbar">‘|9...|’ in 6.4 Document Index</a>.
<p> Section headings are left-aligned but can be center-aligned or right-aligned
by appending <span class="high monosp">><</span> or <span class="high monosp">></span> to the leading digit.
<a id="2.1.1" href="#"></a>
<a id="2.1.1.othersectionnumbers" href="#"></a>
<a id="othersectionnumbers" href="#"></a>
<h3 class="head"><span class="numb">2.1.1</span><span class="text">Other Section Numbers</span></h3>
<p> Numbers 5…8 are currently reserved.
<a id="2.2" href="#"></a>
<a id="2.2.texthighlight" href="#"></a>
<a id="texthighlight" href="#"></a>
<h2 class="head"><span class="numb">2.2</span><span class="text">Text Highlight</span></h2>
<p> Tags having text highlight flags are brief and inline. Like most other tags
they are terminated by a Vbar followed by white-space, or two consecutive Vbar
characters if white-space not immediately adjacent.
<table class="tabl">
<tr class="tabr">
<th class="tabh"><span class="high under">Appearance</span>
<th class="tabh"><span class="high under">Syntax</span>
<th class="tabh"><span class="high under">Note</span>
<tr class="tabr">
<tr class="tabr">
<td class="tabd"><span class="high bold">Bold text</span>
<td class="tabd"><span class="high monosp">|*Bold text|</span>
<tr class="tabr">
<td class="tabd center">Center text
<td class="tabd"><span class="high monosp">|><Center text|</span>
<td class="tabd"><span class="high italic">ability to center depends on the context</span>
<tr class="tabr">
<td class="tabd"><span class="high italic">Italicise text</span>
<td class="tabd"><span class="high monosp">|/Italicise text|</span>
<tr class="tabr">
<td class="tabd monosp nowrap">Monospace text
<td class="tabd"><span class="high monosp">|=Monospace text|</span>
<tr class="tabr">
<td class="tabd">no-wrap text
<td class="tabd"><span class="high monosp">|>>no-wrap text|</span>
<td class="tabd"><span class="high italic nowrap">white-space will not cause this text to be wrapped</span>
<tr class="tabr">
<td class="tabd">No <a href="JavaScript:alert('HELLO')">HTML-escape</a> text
<td class="tabd" colspan="3"><span class="high monosp">|"No <a href="JavaScript:alert('HELLO')">HTML-escape</a> text||</span>
<tr class="tabr">
<td class="tabd" colspan="2">
<td class="tabd"><span class="high italic">only terminated by (two)</span> ||
<tr class="tabr">
<td class="tabd"><span class="high strike">Strike text</span>
<td class="tabd"><span class="high monosp">|-Strike text|</span>
<tr class="tabr">
<td class="tabd"><span class="high under">Underline text</span>
<td class="tabd"><span class="high monosp">|_Underline text|</span>
<tr class="tabr">
<td class="tabd"><span class="high _wasdoc">wasDOC</span>
<td class="tabd"><span class="high monosp">|'<span class="high italic">class</span>.text|</span>
<td class="tabd"><span class="high italic">explicit class — see below</span>
</table>
<p> Text highlight flags may be combined in meaningful ways. <span class="high bold monosp under">This text is
obviously bolded, underlined, and in a monospaced font</span>, all by <span class="high monosp">|*_=This
text is obviously bolded, underlined, and in a monospaced font|</span>. The flags
are terminated by the first alphanumeric encountered, or explicitly by using a
period, as with <span class="high italic under">(example)</span> marked-up using <span class="high monosp">|/_.(example)|</span>.
<p> The flag <span class="high monosp">#*</span> applies standard background highlighting to an element.
This example is backlit using the demonstrated syntax.
<div class="blockof code backlight">|code#*|This example is backlit using the contained syntax.||
</div>
<p> Backlighting table rows operates slightly differently.
See <a class="link" href="#3.tablerowhighlight">‘table row highlight’ in 3. Tables</a>.
<p> The flag <span class="high monosp">##<span class="high italic"><integer></span></span> applies the specified number of 0.1em padding
to an element. This example backlights and pads by 0.8em.
<div class="blockof code backlight" style="padding:0.8em;">|code#*##8|This example backlights and pads by 0.8em.|</div>
<a id="2.2.0.0.1" href="#"></a>
<a id="2.2.explicitstyling" href="#"></a>
<a id="explicitstyling" href="#"></a>
<h5 class="head"><span class="text">Explicit Styling</span></h5>
<p> Text elements also may have specific styling applied. The & (ampersand)
character introduces a string of CSS style markup. This
<span class="high under" style="font-size:1.3em;">must be</span> the final element of the tag and delimited by a
style semi-colon and following period. Implemented as in the following example.
<div class="blockof code">This |_&font-size:1.3em;.must be| the final element of the tag
</div>
<p> Blocks of text (see <a class="link" href="#2.3.blocksoftext">‘Blocks of Text’ in 2.3 Breaks</a>) may be styled using the same
mechanism.
<div class="blockof code" style="background-color:azure;width:35em;padding:0.5em;">|code&background-color:azure;width:35em;padding:0.5em;|
and so on...
|!code|
</div>
<a id="2.2.0.0.2" href="#"></a>
<a id="2.2.explicitclass" href="#"></a>
<a id="explicitclass" href="#"></a>
<h5 class="head"><span class="text">Explicit Class</span></h5>
<style type="text/css">._wasdoc { font-size:1.2em; background-color:yellow;
padding:0 0.5em; 0 0.5em; }</style>
<p> The explicit class <span class="high monosp">|'</span> (single quote) highlight applies a named CSS
styling to the text following. The word <span class="high _wasdoc">wasDOC</span> has a specific
styling applied when used with the <span class="high italic">explicit class</span> tag. So the phrase
<div class="blockof prop"> The word <span class="high _wasdoc">wasDOC</span> has a specific styling </div>
was implemented using the marked-up text
<div class="blockof asis monosp">The word |'_wasdoc.wasDOC| has a specific styling</div>
and a style element (see <a class="link" href="#2.11.stylesheets">‘style sheets’ in 2.11 Box Drawing</a>)
<div class="blockof asis monosp prewrap">|style|._wasdoc { font-size:1.2em; background-color:yellow;
padding:0 0.5em 0 0.5em; }|</div>
<p> Multiple explicit classes may be applied to a text element, each introduced
using the <span class="high monosp">'</span> (single quote).
<p> <span class="high bold">To avoid clashing</span> with current or future <span class="high wasdoc">wasDOC</span> CSS classes, it
is recommended that document-specific classes are <span class="high bold">named using a leading
underscore</span>.
<a id="2.3" href="#"></a>
<a id="2.3.breaks" href="#"></a>
<a id="breaks" href="#"></a>
<h2 class="head"><span class="numb">2.3</span><span class="text">Breaks</span></h2>
<p> Paragraph, line and page breaks may be inserted using
<div class="blockof mono">|^
|^+
|^-
|ppage|
</div>
<p> Breaks require no closure. The <span class="high monosp">|^ </span> creates a paragraph break (note
the trailing space), with <span class="high monosp">|^+</span> an indented paragraph. The <span class="high monosp">|^-</span> provides a
line break. A <span class="high monosp">|ppage|</span> generates a page break only in a printed document.
A backslash as the last character on a line suppresses the new line.
<a id="2.3.0.0.0.1" href="#"></a>
<a id="2.3.blocksoftext" href="#"></a>
<a id="blocksoftext" href="#"></a>
<h6 class="head display0"><span class="text">Blocks of Text</span></h6>
<a id="2.4" href="#"></a>
<a id="2.4.blocks" href="#"></a>
<a id="blocks" href="#"></a>
<h2 class="head"><span class="numb">2.4</span><span class="text">Blocks</span></h2>
<p> Blocks of text can have specific presentations. By default each of these is
indented but can be directed to the current left margin by appending a <span class="high monosp">-</span>
(minus) character, as in the example <span class="high monosp">|code-|</span>. A simple paragraph,
ordinarily at the left margin, may be indented using <span class="high monosp">|^+</span>.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<tr class="tabr">
<tr class="tabr">
<td class="tabd">block of text
<td class="tabd"><span class="high monosp">|block| ... |</span>
<tr class="tabr">
<td class="tabd">code example
<td class="tabd"><span class="high monosp">|code| ... |</span>
<tr class="tabr">
<td class="tabd">example text
<td class="tabd"><span class="high monosp">|example| ... |</span>
<tr class="tabr">
<td class="tabd">inline, not indented
<td class="tabd"><span class="high monosp">|inline| ... |</span>
<tr class="tabr">
<td class="tabd">monospace preformatted
<td class="tabd"><span class="high monosp">|mono| ... |</span>
<tr class="tabr">
<td class="tabd">proportional preformatted
<td class="tabd"><span class="high monosp">|prop| ... |</span>
<tr class="tabr">
<td class="tabd">quotation
<td class="tabd"><span class="high monosp">|quote| ... |</span>
<tr class="tabr">
<td class="tabd">text just as it is
<td class="tabd">see <a class="link" href="#2.7.3.textjustasitis">‘text just as it is’ in 2.7.3 System Data</a>
</table>
<p> Text blocks may be styled using the mechanisms described in <a class="link" href="#2.2.texthighlight">2.2 Text Highlight</a>, sections <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a> and <a class="link" href="#2.2.explicitclass">‘Explicit Class’ in 2.2 Text Highlight</a>. Also
see <a class="link" href="#2.12.documentstyle">2.12 Document Style</a>.
<a id="2.5" href="#"></a>
<a id="2.5.notes" href="#"></a>
<a id="notes" href="#"></a>
<h2 class="head"><span class="numb">2.5</span><span class="text">Notes</span></h2>
<div class="note center"><a id="2.5.0.0.0.1" href="#"></a>
<a id="2.5.note" href="#"></a>
<a id="note" href="#"></a>
<h5 class="head center"><span class="text">Note</span></h5>
<hr class="note_hr">
The <span class="high monosp">|note|</span> tag is used to draw attention to something considered important.
<hr class="note_hr">
</div>
<p> The delimiting horizontal bars make it difficult to overlook. A note always
has an associated heading. This defaults to "Note" (or to
<span class="high monosp">|set|note=<span class="high italic">string</span>|</span>) but can (and often should) be explicitly supplied
to clearly identify why it is considered important. Explicit note headings
also appear in the Index (see <a class="link" href="#6.4.documentindex">6.4 Document Index</a>).
<div class="note center">
<a id="2.5.0.0.1" href="#"></a>
<a id="2.5.explicitnoteheading" href="#"></a>
<a id="explicitnoteheading" href="#"></a>
<h5 class="head center"><span class="text">Explicit Note Heading</span></h5>
<hr class="note_hr">
This note heading was provided using <span class="high monosp">|0Explicit Note Heading|</span>
<hr class="note_hr">
</div>
<p> An explicit heading is a zero-level section introduced immediately in the
note. Any other text will result in the default heading.
<div class="blockof code">|note><|
|0Explicit Note Heading|
This note heading was provided using |=\|0Explicit Note Heading\||
|!note|</div>
<p> Note also that notes with little text often work better if centered. This
was accomplished by appending the characters <span class="high monosp">><</span> to the tag as illustrated
above.
<a id="2.6" href="#"></a>
<a id="2.6.lists" href="#"></a>
<a id="lists" href="#"></a>
<h2 class="head"><span class="numb">2.6</span><span class="text">Lists</span></h2>
<p> <span class="high wasdoc">wasDOC</span> provides three list types; simple, ordered (numbered) and
unordered (bulleted). Lists themselves must be closed using <span class="high monosp">||</span> or the
equivalent, while <span class="high italic">items</span> do not require and must not be closed. Note the
alternative tags available. The choice between the longer or shorter variants
is purely personal.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<tr class="tabr">
<tr class="tabr">
<td class="tabd">simple list
<td class="tabd"><span class="high monosp">|simple|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|sl|</span>
<tr class="tabr">
<td class="tabd">ordered list
<td class="tabd"><span class="high monosp">|number|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|ol|</span>
<tr class="tabr">
<td class="tabd">unordered list
<td class="tabd"><span class="high monosp">|bullet|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|ul|</span>
<tr class="tabr">
<td class="tabd">list item
<td class="tabd"><span class="high monosp">|item|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|li|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|&</span>
</table>
<p> As used in the following examples:
<ul class="list simple">
<li class="item"> Simple list (like this one)
<table class="tabl">
<tr class="tabr">
<td class="tabd"><ul class="list simple"> <li class="item"> one <li class="item"> two <li class="item"> three </ul>
<td class="tabd"><div class="blockof asis monosp prewrap">|simple|
|& one
|& two
|& three
||</div></table>
<li class="item"> Ordered (numbered) list
<table class="tabl">
<tr class="tabr">
<td class="tabd"><ol class="list"> <li class="item"> one <li class="item"> two <li class="item"> three </ol>
<td class="tabd"><div class="blockof asis monosp prewrap">|number|
|& one
|& two
|& three
||</div></table>
<li class="item"> Unordered (bullet point) list
<table class="tabl">
<tr class="tabr">
<td class="tabd"><ul class="list"> <li class="item"> one <li class="item"> two <li class="item"> three </ul>
<td class="tabd"><div class="blockof asis monosp prewrap">|bullet|
|& one
|& two
|& three
||</div></table>
</ul>
<p> By default, lists have additional vertical space between items. To specify
a list with minimal space, append a hash character to the list type (i.e.
<span class="high monosp">|bullet#|</span>, <span class="high monosp">|numeric#|</span> and <span class="high monosp">|simple#|</span>).
<p> In common with blocks of text, lists may have specific styling applied.
List <span class="high italic">items</span> using styling must use the longer version (e.g. <span class="high monosp">|item|</span>).
See <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a> for example syntax.
<a id="2.6.0.0.0.1" href="#"></a>
<a id="2.6.chapterinsertion" href="#"></a>
<a id="chapterinsertion" href="#"></a>
<h6 class="head display0"><span class="text">Chapter Insertion</span></h6>
<a id="2.7" href="#"></a>
<a id="2.7.insertion" href="#"></a>
<a id="insertion" href="#"></a>
<h2 class="head"><span class="numb">2.7</span><span class="text">Insertion</span></h2>
<p> Other files and content can be <span class="high monosp">|insert|</span>ed into the document. The tag
accepts relevant highlight flags (see <a class="link" href="#2.2.texthighlight">2.2 Text Highlight</a>).
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<th class="tabh">Example
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">file name *
<td class="tabd"><span class="high monosp">|insert|file=wasd_root:\<br>[src.wasdoc.doc]hello.txt|</span>
<td class="tabd">Hello dere!
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|insert|file=/wasd_root\<br>/src/wasdoc/doc/hello.txt|</span>
<td class="tabd">Hello dere!
<tr class="tabr backlight">
<td class="tabd">FAO time
<td class="tabd"><span class="high monosp">|insert|fao=%T|</span>
<td class="tabd">09:12:19.89
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|insert|fao=5%T|</span>
<td class="tabd">09:12
<tr class="tabr backlight">
<td class="tabd">FAO date
<td class="tabd"><span class="high monosp">|insert|fao=%D|</span>
<td class="tabd">11-JUL-2020 09:12:19.89
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|insert|fao=17%D|</span>
<td class="tabd">11-JUL-2020 09:12
<tr class="tabr backlight">
<td class="tabd">FAO repeat
<td class="tabd"><span class="high monosp">|insert|fao=24*~|</span>
<td class="tabd">~~~~~~~~~~~~~~~~~~~~~~~~
<tr class="tabr">
<td class="tabd">strftime()
<td class="tabd"><span class="high monosp">|insert|time|</span>
<td class="tabd">Sat, 11 Jul 2020 09:12:19
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd nowrap"><span class="high monosp">|insert|time=%Y-%m-%dT%H:%M:%S%z|</span>
<td class="tabd">2020-07-11T09:12:19
<tr class="tabr">
<td class="tabd">locale all
<td class="tabd"><span class="high monosp">|insert|locale|</span>
<td class="tabd">C
<tr class="tabr backlight">
<td class="tabd">locale character set
<td class="tabd"><span class="high monosp">|insert|locale=ctype|</span>
<td class="tabd">C
<tr class="tabr">
<td class="tabd">document directory
<td class="tabd"><span class="high monosp">|insert|wasdoc=directory|</span>
<td class="tabd">wasd_root:[src.wasdoc.doc]
<tr class="tabr backlight">
<td class="tabd">document path
<td class="tabd"><span class="high monosp">|insert|wasdoc=path|</span>
<td class="tabd">/wasd_root/src/wasdoc/doc/
<tr class="tabr">
<td class="tabd"><span class="high wasdoc">wasDOC</span> executable
<td class="tabd"><span class="high monosp">|insert|wasdoc=software|</span>
<td class="tabd">WASDOC AXP-2.0.0 (CGILIB AXP-2.0.1)
<tr class="tabr backlight">
<td class="tabd"><span class="high wasdoc">wasDOC</span> version
<td class="tabd"><span class="high monosp">|insert|wasdoc=version|</span>
<td class="tabd">2.0.0
<tr class="tabr">
<td class="tabd">FLAG value
<td class="tabd"><span class="high monosp">|insert|HOWDY|</span>
<td class="tabd">Hi There! (see <a class="link" href="#2.7.2.flaginsertion">2.7.2 FLAG Insertion</a>)
<tr class="tabr backlight">
<td class="tabd">CGI variable *
<td class="tabd"><span class="high monosp">|insert|cgi=WWW_SERVER_SOFTWARE|</span>
<td class="tabd">HTTPd-WASD/11.3.0b OpenVMS/AXP SSL**
<br>**<span class="high italic">static document – edited</span>
<tr class="tabr nowrap">
<td class="tabd">C-RTL environment *
<td class="tabd"><span class="high monosp">|insert|env=USER|</span>
<td class="tabd">SYSTEM
<tr class="tabr backlight nowrap">
<td class="tabd">logical name *
<td class="tabd"><span class="high monosp">|insert|lnm=SYS$TIMEZONE_NAME|</span>
<td class="tabd">ACST
<tr class="tabr">
<td class="tabd">system data
<td class="tabd"><span class="high monosp">|insert|syi=<span class="high italic">keyword</span>|</span>
<td class="tabd">see <a class="link" href="#2.7.3.systemdata">2.7.3 System Data</a>
<tr class="tabr backlight">
<td class="tabd">spawned command *
<td class="tabd"><span class="high monosp">|insert|spawn=show time|</span>
<td class="tabd"> 11-JUL-2020 09:12:19
</table>
<p> <sup>*</sup> By default these items have content inserted with
significant HTML characters escaped. This may be suppressed by prefixing the
parameter with a <span class="high monosp">"</span> (quotation) symbol. Output is then included as-is.
Also, an encountered error will stop document processing. Prefixing the
parameter with a <span class="high monosp">!</span> (exclamation) symbol will result in it continuing.
<a id="2.7.1" href="#"></a>
<a id="2.7.1.spawnedcommand" href="#"></a>
<a id="spawnedcommand" href="#"></a>
<h3 class="head"><span class="numb">2.7.1</span><span class="text">Spawned Command</span></h3>
<p> Output from a spawned command may be inserted into the document – with
some restriction applied to dynamic documents. Use of <span class="high wasdoc">wasDOC</span> at the
command line has none. If the account can successfully issue the command the
output can be captured and inserted into the static document being generated.
<span class="high bold">CAUTION!</span> For a dynamic document the document location must be authorised to
do so. <span class="high bold">MORE CAUTION ADVISED!</span> A document author may then spawn any command
as the scripting account. This may and <span class="high italic">probably should be</span> a consideration.
See <a class="link" href="#2.7.1.documentauthorisation">‘Document Authorisation’ in 2.7.1 Spawned Command</a>.
<div class="blockof mono">DCL_Tips
Information that was previously listed under this help topic is now
included under the following individual help topics:
HELP DATE (includes time specifications)
HELP EXPRESSION
HELP FILESPEC
HELP INTEGER
HELP PRIVILEGE
HELP PROTECTION
HELP STRING
HELP SYMBOL
HELP UIC
</div>
<p> Using spawned commands without authorisation results in an error reported as
<div class="blockof mono">%SYSTEM-F-AUTHFAIL, authorization failure
</div>
and will stop document generation. In fact, any error returned by the spawned
command will stop document processing unless the command is prefixed by a <span class="high monosp">!</span>
(exclamation) symbol. When prefixed the document inserts the error message and
continues. If seeing the above message instead of <span class="high monosp">DCL_tips</span> help then the
document can be authorised as described below.
<p> Output from spawned commands is inserted with meaningful HTML characters
escaped. This may be suppressed by prefixing the command with a <span class="high monosp">"</span>
(quotation) symbol. Output is then included as-is. Command output is often
formatted for terminal display and includes white-space unnecessary for a
document. This can be trimmed by prefixing the command with a <span class="high monosp">-</span> (hyphen)
symbol. This is an example using all three (output above). Order is not
significant.
<div class="blockof mono">|insert|spawn=!-"help dcl|
</div>
<p> For dynamic documents, spawned commands add overhead and significantly
extend document generation times.
<p> The output from a spawned command may be tested using keyword and regex
matching (see <a class="link" href="#5.conditionalcontent">5. Conditional Content</a>) the same as any other string (see
<a class="link" href="#5.2.spawnconditional">5.2 Spawn Conditional</a>).
<p> The output from a previous spawn may be reused by specifying the <span class="high monosp">&</span>
(ampersand) character instead of a command.
<a id="2.7.1.0.1" href="#"></a>
<a id="2.7.1.documentauthorisation" href="#"></a>
<a id="documentauthorisation" href="#"></a>
<h5 class="head"><span class="text">Document Authorisation</span></h5>
<p> A dynamic document, generated under a scripting account, must be authorised
to insert the output from a spawned command. This is performed by adding its
VMS file specification location to the multi-valued logical name
<span class="high monosp">WASDOC_SPAWN</span> located in the <span class="high monosp">LNM$SYSTEM table</span>. This contrived example
shows this document being authorised to spawn.
<div class="blockof mono">$ define /system WASDOC_SPAWN some:[other], -
wasd_root:[src.wasdoc.doc], -
and:[this.one]
</div>
<a id="2.7.2" href="#"></a>
<a id="2.7.2.flaginsertion" href="#"></a>
<a id="flaginsertion" href="#"></a>
<h3 class="head"><span class="numb">2.7.2</span><span class="text">FLAG Insertion</span></h3>
<p> FLAGs are ad hoc, all-upper-case strings that may be <span class="high monosp">|set|</span> with string
values (see <a class="link" href="#7.2.flags">7.2 FLAGs</a>) which can then easily be inserted into the document
— 𝓉𝒽𝒾𝓈 𝒾𝓈 𝒶𝓃 ℯ𝓍𝒶𝓂𝓅𝓁ℯ.
<p> That example was generated using
<div class="blockof asis monosp prewrap">|set|EXAMPLE=&tscr;&hscr;&iscr;&sscr;&nbsp; &iscr;&sscr;&nbsp; \
&ascr;&nscr;&nbsp; &escr;&xscr;&ascr;&mscr;&pscr;&lscr;&escr;|
⋮
… inserted into the document |--| |insert|EXAMPLE|.</div>
and this
<div class="blockof block"><span class="highinsert under" style="background-color:yellow;font-size:150%;padding:0.3em;">𝓉𝒽𝒾𝓈 𝒾𝓈 𝒶𝓃 ℯ𝓍𝒶𝓂𝓅𝓁ℯ</span>
</div>
using
<div class="blockof asis monosp prewrap">|insert_&background-color:yellow;font-size:150%;padding:0.3em;|EXAMPLE|</div>
Flags values are always inserted without further processing.
<a id="2.7.2.0.0.1" href="#"></a>
<a id="2.7.2.insertsystemdata" href="#"></a>
<a id="insertsystemdata" href="#"></a>
<h6 class="head display0"><span class="text">Insert System Data</span></h6>
<a id="2.7.2.0.0.2" href="#"></a>
<a id="2.7.2.clustersystemdata" href="#"></a>
<a id="clustersystemdata" href="#"></a>
<h6 class="head display0"><span class="text">Cluster System Data</span></h6>
<a id="2.7.3" href="#"></a>
<a id="2.7.3.systemdata" href="#"></a>
<a id="systemdata" href="#"></a>
<h3 class="head"><span class="numb">2.7.3</span><span class="text">System Data</span></h3>
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<th class="tabh">Example
<tr class="tabr">
<tr class="tabr">
<td class="tabd">VMS version
<td class="tabd"><span class="high monosp">|insert|syi=version|</span>
<td class="tabd">V8.4-2L1
<tr class="tabr">
<td class="tabd">CPU architecure
<td class="tabd"><span class="high monosp">|insert|syi=arch_name|</span>
<td class="tabd">Alpha
<tr class="tabr">
<td class="tabd">cluster member
<td class="tabd"><span class="high monosp">|insert|syi=cluster=member|</span>
<td class="tabd">0
<tr class="tabr">
<td class="tabd">cluster votes
<td class="tabd"><span class="high monosp">|insert|syi=cluster=votes|</span>
<td class="tabd">0
<tr class="tabr">
<td class="tabd">cluster nodes
<td class="tabd"><span class="high monosp">|insert|syi=cluster=nodes|</span>
<td class="tabd">0
<tr class="tabr">
<td class="tabd">cluster quorum
<td class="tabd"><span class="high monosp">|insert|syi=cluster=quorum|</span>
<td class="tabd">0
<tr class="tabr">
<td class="tabd">cluster evotes
<td class="tabd"><span class="high monosp">|insert|syi=cluster=evotes|</span>
<td class="tabd">0
<tr class="tabr">
<td class="tabd">system platform
<td class="tabd"><span class="high monosp">|insert|syi=hw_name|</span>
<td class="tabd">Digital Personal WorkStation
<tr class="tabr">
<td class="tabd">memory size
<td class="tabd"><span class="high monosp">|insert|syi=memsize|</span>
<td class="tabd">1.50GB
<tr class="tabr">
<td class="tabd">node name
<td class="tabd"><span class="high monosp">|insert|syi=nodename|</span>
<td class="tabd">KLAATU
<tr class="tabr">
<td class="tabd">boot time
<td class="tabd"><span class="high monosp">|insert|syi=boottime|</span>
<td class="tabd"> 4-JUN-2020 12:06:55
<tr class="tabr">
<td class="tabd">up-time
<td class="tabd"><span class="high monosp">|insert|syi=uptime|</span>
<td class="tabd"> 36 21:05:24
</table>
<a id="2.7.3.0.0.1" href="#"></a>
<a id="2.7.3.textjustasitis" href="#"></a>
<a id="textjustasitis" href="#"></a>
<h6 class="head display0"><span class="text">text just as it is</span></h6>
<a id="2.8" href="#"></a>
<a id="2.8.verbarquotandverbarasisverbar" href="#"></a>
<a id="verbarquotandverbarasisverbar" href="#"></a>
<h2 class="head"><span class="numb">2.8</span><span class="text">|" and |asis|</span></h2>
<p> Text just as it is – or perhaps characters just as they are – can be
placed in the document using the <span class="high monosp">|"</span> and <span class="high monosp">|asis|</span> tags, with the former
intended for shorter sequences embedded in other text, and the latter for
multi-line blocks of text. Note that significant HTML characters (e.g.
<, >, &) to be rendered as characters must be represented by an entity.
<p> The <span class="high monosp">|"</span> closure is <span style="font-size:120%">two
consecutive</span> Vbar characters. The escape backslash continues to
escape. Primarily it is intended for ad hoc HTML markup. This paragraph was
marked up using
<div class="blockof asis monosp prewrap">|^ The |=.\|"| closure is |"<span style="font-size:120%">two
consecutive</span>|| Vbar characters. The escape backslash continues to
escape. Primarily it is intended for ad hoc HTML markup. This paragraph was
marked up using </div>
<p> The <span class="high monosp">|asis|</span> closure is four consecutive Vbar characters on a line by
themselves. The escape backslash <span class="high bold">no longer escapes</span>. Content is copied
character for character.
<div class="blockof asis monosp prewrap">|^ The |=.\|asis\|| closure is four consecutive Vbar characters on a line by
themselves. The escape backslash |*no longer escapes||. Content is copied
character for character.</div>
<p> The example above was documented using the following markup.
<div class="blockof asis monosp prewrap">|asis=<<|
|^ The |=\|asis\|| closure is four consecutive Vbar characters on a line by
themselves. The escape backslash no longer escapes. Content is copied
character for character.
\||||</div>
<a id="2.9" href="#"></a>
<a id="2.9.othermarkup" href="#"></a>
<a id="othermarkup" href="#"></a>
<h2 class="head"><span class="numb">2.9</span><span class="text">Other Markup</span></h2>
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<tr class="tabr">
<tr class="tabr">
<td class="tabd">insert an en dash –
<td class="tabd"><span class="high monosp">|-|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd">\&ndash;
<tr class="tabr">
<td class="tabd">insert an em dash —
<td class="tabd"><span class="high monosp">|--|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd">\&mdash;
<tr class="tabr">
<td class="tabd">insert an ellipsis …
<td class="tabd"><span class="high monosp">|...|</span>
<tr class="tabr">
<td class="tabd">
<td class="tabd">\&hellip;
<tr class="tabr">
<td class="tabd right">in fact, insert <span class="high bold">any HTML entity</span> Α…Ω
<td class="tabd">\&<span class="high italic">entity</span>;
<tr class="tabr">
<td class="tabd right">α…ω
<td class="tabd">\&<span class="high italic">#integer</span>;
<tr class="tabr">
<td class="tabd">not white-space or anything else!
<td class="tabd"><span class="high monosp">\\\\</span>
<tr class="tabr">
<td class="tabd" colspan="2">(<span class="high italic">lots of Vbars can get messy, see below</span>)
</table>
<a id="2.9.0.0.1" href="#"></a>
<a id="2.9.vbarscanbemessy" href="#"></a>
<a id="vbarscanbemessy" href="#"></a>
<h5 class="head"><span class="text">Vbars can be messy...</span></h5>
<p> … and the quad-backslash escape comes to the rescue. Vbar characters
back-to-back can start to confound themselves. Consider the need to link (see
<a class="link" href="#3.chapterlinks">‘Chapter Links’ in 3. Tables</a>) to another part of the document using a description that
begins with Vbar-introduced markup.
<div class="blockof prop">FLAGS may be employed in <a class="link" href="#5.conditionalcontent">5. Conditional Content</a>.
</div>
It might be imagined that this could be accomplished using something like
<div class="blockof asis monosp">FLAGS may employ the |link|Conditional Content| construct.</div>
but that is ambiguous to the parser. This works
<div class="blockof asis monosp prewrap">FLAGS may employ the |link|Conditional Content| construct.</div>
but not without adding extraneous white-space. What is needed is a construct
the parser recognises as NOT-white-space but is else ignored. Hence the
<span class="high monosp">\\\\</span> (quad-backslash). The solution then becomes
<div class="blockof asis monosp prewrap">FLAGS may employ the |link|else|\\\\|=\|else\||||| construct.</div>
Messy but does the job! Fortunately the need for such contortions seems
infrequent.
<a id="2.10" href="#"></a>
<a id="2.10.images" href="#"></a>
<a id="images" href="#"></a>
<h2 class="head"><span class="numb">2.10</span><span class="text">Images</span></h2>
<p> Images are inserted using the <span class="high monosp">|image|</span> tag. The image path follows the
tag. It can be in-document, relative, absolute or a fully specified URL.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Type
<th class="tabh">Syntax
<th class="tabh">Comment
<tr class="tabr">
<tr class="tabr">
<td class="tabd">in-document
<td class="tabd"><span class="high monosp">|image|wasdoc.png|</span>
<td class="tabd">contained in the same directory as the document source text
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|image|./wasdoc.png|</span>
<td class="tabd">
<tr class="tabr">
<td class="tabd">relative
<td class="tabd"><span class="high monosp">|image|../doc_two/another.png|</span>
<td class="tabd">contained in a directory adjacent to the document
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|image|../../yetmore.png|</span>
<td class="tabd">a directory two "up" from the document
<tr class="tabr">
<td class="tabd">absolute
<td class="tabd"><span class="high monosp">|image|/wasd_root/src/wasdoc/doc/\<br>wasdoc.png|</span>
<td class="tabd">fully qualified path to the image file
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|image|/wasd_root/src/yetmore.png|</span>
<td class="tabd">(hypothetically)
<tr class="tabr">
<td class="tabd">full URL
<td class="tabd"><span class="high monosp">|image|https://wasd.vsm.com.au\<br>/wasd_root/src/wasdoc/doc/wasdoc.png|</span>
<td class="tabd">fully specified URL to the image file
</table>
<table class="tabl">
<tr class="tabr">
<td class="tabd"><a class="imglink" target="_blank" href="../doc/wasdoc.png"><img class="image" src="../doc/wasdoc.png"></a>
<td class="tabd valmid">I like this graphic and if <span class="high wasdoc">wasDOC</span> was to have an icon this might be it <span class="high _smiley"> </span>
</table>
<p> An image may be made a clickable download by using the <span class="high monosp"></span> (percent)
character. The above image was marked-up as <span class="high monosp">|image%|../doc/wasdoc.png|</span>
(has a transparent background and Chrome renders it as a black page).
<p> In common with blocks of text, images may have specific styling applied.
See <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a> for example syntax.
<a id="2.11" href="#"></a>
<a id="2.11.boxdrawing" href="#"></a>
<a id="boxdrawing" href="#"></a>
<h2 class="head"><span class="numb">2.11</span><span class="text">Box Drawing</span></h2>
<p> Simple diagrams showing relationships and data flows are often useful to
illustrate, well, relationships and data flows.
<div class="drawing dfont draw noindent">
<style>
.dhflip { display:inline-block;transform:rotate(180deg); }
.dvflip { display:inline-block;transform:rotate(-180deg); }
.dnoflip { display:inline-block;transform:rotate(360deg); }
.dfont { font-family:monospace;font-size:1em;line-height:0.9em;line-spacing:0em; }
</style>
│ │<br>
<span class="dvflip">▲</span> <span class="dvflip">▲</span><br>
┌─────────┐ ┌─────────┐<br>
│ │<span class="dnoflip">◄</span>── THIS one ──<span class="dhflip">◄</span>│ │<br>
│ ONE+one │ │ two-TWO ├───┐<br>
│ │<span class="dnoflip">◄</span>── this TWO ──<span class="dhflip">◄</span>│ │ │<br>
└──┬──────┘ └─────────┘ │ <span class="dnoflip">◄</span>╌╌╌╌● <i>continuous line</i><br>
╎ <span class="dnoflip">▲</span> <span class="dnoflip">▲</span> │<br>
╎ │ │ │<br>
┌╌╌<span class="dhflip">◄</span> ╎ └────────────────────────│────────┘<br>
╎ ╎ │<br>
╎ └╌╌╌╌────────────────────────┘<br>
●<br>
<i>vertical dashed line</i><br>
</div>
<p> <span class="high wasdoc">wasDOC</span> provides these using a few simple drawing-specific markup
characters. The above diagram is constructed using:
<div class="blockof mono">|draw|
| |
# #
+---------+ +---------+
| |<-- THIS one -->| |
| ONE\+one | | two\-TWO +---+
| |<-- this TWO -->| | |
+--+------+ +---------+ | <....* {<i>continuous line</i>}
: ^ ^ |
: | | |
+..> : +------------------------|--------+
: : |
: +....------------------------+
*
{<i>vertical dashed line</i>}
|!draw|</div>
<p> In common with other <a class="link" href="#2.4.blocks">block</a> presentations, drawings may be
styled using the mechanisms described in <a class="link" href="#2.2.texthighlight">2.2 Text Highlight</a>, sections
<a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a> and <a class="link" href="#2.2.explicitclass">‘Explicit Class’ in 2.2 Text Highlight</a>. Also see <a class="link" href="#2.12.documentstyle">2.12 Document Style</a>.
<a id="2.11.0.0.1" href="#"></a>
<a id="2.11.drawingcharacters" href="#"></a>
<a id="drawingcharacters" href="#"></a>
<h5 class="head"><span class="text">Drawing Characters</span></h5>
<p> The default <span class="high wasdoc">wasDOC</span> <span class="high monosp">|</span> symbol (Vbar) and directives do not apply
in drawing contexts. A drawing is terminated only by <span class="high monosp">|!draw|</span>. Reserved
drawing characters used as literals must be backslash-escaped; as seen in the
above example with <span class="high monosp">ONE\+one</span> and <span class="high monosp">two\-TWO</span>. Alternatively, literally
used reserved characters may be placed between curly braces; as seen with the
embedded HTML <span class="high monosp"> {<i>vertical dashed line</i>}</span>.
<p> <table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Character
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">horizontal line
<td class="tabd">-
<td class="tabd">(hyphen)
<tr class="tabr">
<td class="tabd">horizontal dashed line
<td class="tabd">.
<td class="tabd">(period)
<tr class="tabr backlight">
<td class="tabd">vertical line
<td class="tabd">|
<td class="tabd">(vertical bar)
<tr class="tabr">
<td class="tabd">vertical dashed line
<td class="tabd">:
<td class="tabd">(colon)
<tr class="tabr backlight">
<td class="tabd">lines joining or branching
<td class="tabd">+
<td class="tabd">(plus)
<tr class="tabr">
<td class="tabd">left arrow
<td class="tabd"><
<td class="tabd">(less than)
<tr class="tabr backlight">
<td class="tabd">right arrow
<td class="tabd">>
<td class="tabd">(greater than)
<tr class="tabr">
<td class="tabd">up arrow
<td class="tabd">^
<td class="tabd">(caret/circumflex/hat)
<tr class="tabr backlight">
<td class="tabd">down arrow
<td class="tabd">#
<td class="tabd">(hash/pound)
<tr class="tabr">
<td class="tabd">black dot
<td class="tabd">*
<td class="tabd">(asterisk)
<tr class="tabr backlight">
<td class="tabd">escape next character
<td class="tabd">\
<td class="tabd">(backslash)
<tr class="tabr">
<td class="tabd">escape all between
<td class="tabd">{ … }
<td class="tabd">(curly braces)
</table>
<a id="2.11.0.0.1.1" href="#"></a>
<a id="2.11.css" href="#"></a>
<a id="css" href="#"></a>
<h6 class="head display0"><span class="text">CSS</span></h6>
<a id="2.11.0.0.1.2" href="#"></a>
<a id="2.11.cascadingstylesheetscss" href="#"></a>
<a id="cascadingstylesheetscss" href="#"></a>
<h6 class="head display0"><span class="text">Cascading Style Sheets (CSS)</span></h6>
<a id="2.11.0.0.1.3" href="#"></a>
<a id="2.11.stylesheets" href="#"></a>
<a id="stylesheets" href="#"></a>
<h6 class="head display0"><span class="text">style sheets</span></h6>
<a id="2.12" href="#"></a>
<a id="2.12.documentstyle" href="#"></a>
<a id="documentstyle" href="#"></a>
<h2 class="head"><span class="numb">2.12</span><span class="text">Document Style</span></h2>
<p> There is a default, in-built document style. If nothing else is set before
the first text output then this is used. This is the same style seen in this
document.
<p> Style sheet characteristics are set using the <span class="high bold"><span class="high monosp">|style|</span></span> tag.
<p> To explicitly use the default style then <span class="high monosp">|style|default|</span>.
<p> To insert style sheet data from a document file then
<span class="high monosp">|style|file=my.css|</span>, or using a file external to the document by
providing the full file path, as with
<span class="high monosp">|style|file=device:[directory]the.css|</span>.
<p> To link to external style sheet data then
<span class="high monosp">|style|sheet=https://the.host.name/path/style.css|</span>.
<p> Style elements may be set and reset using the <span class="high monosp">|style|</span> tag. Just
specify the required style sheet syntax. For example, to modify the default
font size:
<div class="blockof mono">|style|* { font-size: 14pt; }|
</div>
To create an <a class="link" href="#2.2.explicitclass">explicit class</a>
<div class="blockof mono">|style|._wasdoc
{ font-family: "Lucida Console", Monaco, monospace;
text-decoration:underline; }
||
</div>
<p> As documented in <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a> it is possible to define a class and
then apply that class to various tags.
<p> Style sheet data is generally set early in the document but can be defined
– <span class="high bold">and redefined</span> – at any stage.
<p> And of course, in common with any other HTML, style data can be "injected"
into the document using non-escaped document text. For example, the same
<span class="high monosp">_wasdoc</span> style as above could be done using
<div class="blockof mono">|"<style type="text/css">._wasdoc \
{ font-family: "Lucida Console", Monaco, monospace;
text-decoration:underline; } </style>||
</div>
<p> <span class="high bold">To avoid clashing</span> with current or future <span class="high wasdoc">wasDOC</span> CSS classes, it
is recommended that document-specific classes are <span class="high bold">named using a leading
underscore</span>.
<a id="2.12.0.0.1" href="#"></a>
<a id="2.12.multipartstyles" href="#"></a>
<a id="multipartstyles" href="#"></a>
<h5 class="head"><span class="text">Multipart Styles</span></h5>
<p> Where documents are presented as independent pages (see <a class="link" href="#1.2.1.largedocument">‘Large Document’ in 1.2.1 Dynamic Document</a> and <a class="link" href="#1.2.2.multipartdocument">‘Multipart Document’ in 1.2.2 Static Document</a>—basically the same thing) each
section could have individual styles applied using
<div class="blockof mono">|multi|
|style|html { background-image:url('/path/to/image') }|
|!multi|
</div>
however, there exists the "shorthand" syntax
<div class="blockof mono">|style|chunk=html { background-image:url('/path/to/image') }|
</div>
where the style is only applied to <span class="high italic">chunked</span> documents. May be useful for
blogs and the like in customising particular pages.
<!-- source:0300_TABLES.WASDOC -->
<hr class="page">
<a id="3." href="#"></a>
<a id="3.tables" href="#"></a>
<a id="tables" href="#"></a>
<h1 class="head"><span class="numb">3.</span><span class="text">Tables</span></h1>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#2.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#4.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> Tables are one of the more demanding document layout requirements.
<span class="high wasdoc">wasDOC</span> table generation largely uses HTML conventions. Note the
alternative tags available. The choice between the longer or shorter variants
is purely personal (though the shorter make for less clutter in non-trivial
tables). The following table is generated using only the following markup
elements.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">begin table
<td class="tabd"><span class="high monosp">|table|</span>
<br><span class="high monosp">|tabular|</span>
<tr class="tabr">
<td class="tabd">row of cells
<td class="tabd"><span class="high monosp">|row| ... </span>
<br><span class="high monosp">|tr| ... </span>
<br><span class="high monosp">|~ ... </span>
<tr class="tabr backlight">
<td class="tabd">header cell
<td class="tabd"><span class="high monosp">|head| ... </span>
<br><span class="high monosp">|th| ... </span>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|: ... </span>
<tr class="tabr backlight">
<td class="tabd">data cell
<td class="tabd"><span class="high monosp">|data| ... </span>
<br><span class="high monosp">|td| ... </span>
<br><span class="high monosp">|. ... </span>
<tr class="tabr">
<td class="tabd">end table
<td class="tabd"><span class="high monosp">||</span>
<br><span class="high monosp">|!table|</span>
</table>
<p> <span class="high bold">Note</span> that rows and cells <span class="high bold">do not require</span> and <span class="high bold">must not have</span> closure.
This is a deliberate design decision in an effort to reduce the clutter of tags
that else seems to accumulate inside tables. Note also that table syntax
is very sparse. Again an effort to reduce clutter around the actual data of
interest. Further, that table processing removes and compresses white-space
around elements in an effort to present "tidier" HTML.
<p> The table above was generated by the following markup text.
<div class="blockof asis monosp prewrap">|table|
|~_ |: Purpose |: Syntax
|~
|~#* |. begin table
|. |=\|table\||
|^-|=\|tabular\||
|~ |. row of cells
|. |=\|row\| ... |
|^-|=\|tr\| ... |
|^-|=\|~ ... |
|~ |. header cell
|. |=\|head\| ... |
|^-|=\|th\| ... |
|~ |.
|. |=\|: ... |
|~ |. data cell
|. |=\|data\| ... |
|^-|=\|td\| ... |
|^-|=\|. ... |
|~ |. end table
|. |=\|\||
|^-|=\|!table\||
|!table|</div>
<p> In common with other "block" elements such as lists, tables are indented
from the left margin. This may be suppressed using <span class="high monosp">|table-|</span>. The table
can be centered on the page using <span class="high monosp">|table><|</span>. The default table alignment
may also be set at any time using <span class="high monosp">|set|table=margin=<span class="high italic">flag</span>|</span>.
<p> Table headings and data are left aligned. Cells can be right and center
aligned using <span class="high monosp">|:></span> and <span class="high monosp">|.></span>, and <span class="high monosp">|:><</span> and <span class="high monosp">|.><</span> respectively. To
align an entire row use <span class="high monosp">|~></span> and <span class="high monosp">|~><</span>, an entire table <span class="high monosp">|table>|</span>
and <span class="high monosp">|table><|</span>. (The redundant <span class="high left monosp"></span> left alignment is also accepted.)
<p> A cell may have text protected against wrapping by marking it <span class="high monosp">|:>></span> or
<span class="high monosp">|.>></span>, and an entire row <span class="high monosp">|~>></span>.
<p> A cell may be underlined by marking it <span class="high monosp">|:_</span> or
<span class="high monosp">|._</span>, and an entire row <span class="high monosp">|~_</span>. Useful for table headings. The
table above had the column headings formatted as shown in the markup example.
<a id="3.0.0.0.0.1" href="#"></a>
<a id="3.tablerowhighlight" href="#"></a>
<a id="tablerowhighlight" href="#"></a>
<h6 class="head display0"><span class="text">table row highlight</span></h6>
<a id="3.0.0.0.0.2" href="#"></a>
<a id="3.r" href="#"></a>
<a id="r" href="#"></a>
<h6 class="head display0"><span class="text">R...</span></h6>
<p> Note that alternate rows are optionally highlighted to assist in delineating
each row's boundary. This highlight is enabled on a per-table basis using
<span class="high monosp">#*</span> on a row tag, as with <span class="high monosp">|~#*</span> (or <span class="high monosp">|row#*|</span>, etc.) and subsequently
can be disabled in the same table using <span class="high monosp">#!*</span>. A row may explicitly be set
to the same highlight as the preceding row using <span class="high monosp">#^*</span>. Any row at all may
have a one-shot highlight applied using <span class="high monosp">#1*</span>.
<p> Cells also can have column and row spanning by specifying a digit 2..9 in
the tag. The first digit encountered is the column span. Any second digit is
the row span. Use 1 for the column span to specify only the row span. To span
two columns <span class="high monosp">|.2</span>, to span three rows <span class="high monosp">|.13</span>, and to span four
columns and five rows center aligned <span class="high monosp">|.><45</span>.
<p> To suppress the display of a cell use <span class="high monosp">|:#</span> or <span class="high monosp">|.#</span>, and to
suppress an entire row <span class="high monosp">|~#</span>. This may actually contain data (see
<span class="high italic">assertion check</span> below) that just will not be visible.
<p> To add a little extra space between the preceding and succeeding rows use
<span class="high monosp">|~</span> (analagous to a line break).
<p> In common with blocks of text, table elements may have specific styling
applied. Also see <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a>. The <span class="high italic">tabular</span> example below
illustrates the use on a table row.
<a id="3.0.0.0.0.3" href="#"></a>
<a id="3.tabularexample" href="#"></a>
<a id="tabularexample" href="#"></a>
<h6 class="head display0"><span class="text">tabular example</span></h6>
<p> Using the <span class="high monosp">|tabular|</span> tag, tables also can be used to present tabular
data where the cells are right aligned and bordered.
<table class="tabu">
<tr class="tabr">
<th class="tabh tab0">(just to check the assertion above)
<th class="tabh">col 1
<th class="tabh">col 2
<th class="tabh">col 3
<tr class="tabr">
<th class="tabh">row 1
<td class="tabd">10
<td class="tabd">20
<td class="tabd">30
<tr class="tabr" style="background-color:gainsboro;">
<th class="tabh">row 2
<td class="tabd">400
<td class="tabd">500
<td class="tabd">600
<tr class="tabr">
<th class="tabh">row 3
<td class="tabd">7,000
<td class="tabd">8,000
<td class="tabd">9,000
</table>
<p> That table was generated by the following markup text:
<div class="blockof asis monosp prewrap">|tabular|
|~ |:# (just to check the assertion above)
|: col 1 |: col 2 |: col 3
|~ |: row 1 |. 10 |. 20 |. 30
|~&background-color:gainsboro;.
|: row 2 |. 400 |. 500 |. 600
|~ |: row 3 |. 7,000 |. 8,000 |. 9,000
|!tabular|</div>
<p> Also note that the <span class="high monosp">|:#</span> above has a trailing "<span class="high monosp">(just to check
the assertion above)</span>" which is not visible (check the HTML source if
requiring verification).
<!-- source:0400_LINKS.WASDOC -->
<a id="3.0.0.0.0.4" href="#"></a>
<a id="3.chapterlinks" href="#"></a>
<a id="chapterlinks" href="#"></a>
<h6 class="head display0"><span class="text">Chapter Links</span></h6>
<hr class="page">
<a id="4." href="#"></a>
<a id="4.links" href="#"></a>
<a id="links" href="#"></a>
<h1 class="head"><span class="numb">4.</span><span class="text">Links</span></h1>
<table class="TOC2table">
<tr><td><a href="#4.1.theessentialfragment"><span class="numb">4.1</span><span class="text">The Essential Fragment</span></a>
<tr><td><a href="#4.2.linkstootherdocuments"><span class="numb">4.2</span><span class="text">Links to Other Documents</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#3.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#5.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> Links to other parts of the document and to external resources are introduced
with the usual Vbar symbol.
<p> A URL beginning with a scheme (e.g. <span class="high monosp">https://</span>, <span class="high monosp">ftp://</span>) or a
<span class="high monosp">mailto:</span> only requires closure with a delimiting Vbar. If a
<span class="high bold">Vbar-delimitted description</span> does not follow then the URL is used as the
descriptor. If the tag ends in, or URL begins with, a <span class="high monosp">%</span> (percent) the link
opens in a new browser page.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Syntax
<th class="tabh">Example
<tr class="tabr">
<tr class="tabr">
<td class="tabd"><span class="high monosp">|https://wasd.vsm.com.au/|</span>
<td class="tabd"><a class="link" href="https://wasd.vsm.com.au/">https://wasd.vsm.com.au/</a>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|https://wasd.vsm.com.au/|A link to WASD|</span>
<td class="tabd"><a class="link" href="https://wasd.vsm.com.au/">A link to WASD</a>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|%https://wasd.vsm.com.au/wasd/|</span>
<td class="tabd"><a class="link blank" target="_blank" href="https://wasd.vsm.com.au/wasd/">https://wasd.vsm.com.au/wasd/</a>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|%https://wasd.vsm.com.au/wasd/|WASD \
<br>download in a new page|</span>
<td class="tabd"><a class="link blank" target="_blank" href="https://wasd.vsm.com.au/wasd/">WASD download in a new page</a>
</table>
<p> Where a URL does not begin with a scheme the <span class="high monosp">|link|</span> and <span class="high monosp">|link%|</span>
tags must be used. Of course, URLs with schemes can be specfied using
<span class="high monosp">|link|</span> as well, the sans-<span class="high monosp">|link|</span> is just a shorthand approach.
<p> A URL beginning with just text (ie. without a URL) is considered a document
section and is linked to that.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Syntax
<th class="tabh">Example
<tr class="tabr">
<tr class="tabr">
<td class="tabd"><span class="high monosp">|link|Chapter Insertion|</span>
<td class="tabd"><a class="link" href="#2.6.chapterinsertion">‘Chapter Insertion’ in 2.6 Lists</a>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|link%|Chapter Insertion|jump to Insertion|</span>
<td class="tabd"><a class="link blank" target="_blank" href="#2.6.chapterinsertion">jump to Insertion</a>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|link*&background-color:azure;|Chapter \
<br>Insertion|bold, coloured link to Insertion|</span>
<td class="tabd"><a class="link bold" style="background-color:azure;" href="#2.6.chapterinsertion">bold, coloured link to Insertion</a>
</table>
<p> A URL beginning with a <span class="high italic">fragment hash</span> (<span class="high monosp">#</span>) moves the browser context
to the specified fragment.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Syntax
<th class="tabh">Example
<tr class="tabr">
<tr class="tabr">
<td class="tabd"><span class="high monosp">|link|#tableofcontent|</span>
<td class="tabd"><a class="link" href="#tableofcontent"></a>
<tr class="tabr">
<td class="tabd"><span class="high monosp">|link%|#tableofcontent|Jump to \
<br>Table of Content|</span>
<td class="tabd"><a class="link blank" target="_blank" href="#tableofcontent">Jump to Table of Content</a>
</table>
<p> The Vbar-delimitted description can be an image.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Syntax
<th class="tabh">Example
<tr class="tabr">
<tr class="tabr">
<td class="tabd"><span class="high monosp">|link%|/wasd_root/src/wasdoc/*.*|image&\<br>
width:3em;|../doc/wasdoc.png|</span>
<td class="tabd"><a class="link" target="_blank" href="/wasd_root/src/wasdoc/*.*"><img class="image" style="width:3em;" src="../doc/wasdoc.png"></a>
</table>
<a id="4.1" href="#"></a>
<a id="4.1.theessentialfragment" href="#"></a>
<a id="theessentialfragment" href="#"></a>
<h2 class="head"><span class="numb">4.1</span><span class="text">The Essential Fragment</span></h2>
<p> A <span class="high wasdoc">wasDOC</span> fragment, being based on the HTML fragment (the string
following any <span class="high monosp">#</span> in a URL), is an identified location within a document.
<span class="high wasdoc">wasDOC</span> describes these as <span class="high italic">identifiers</span> and links to them, either
implicitly (internal links) or explicitly (externally into a document), as
<span class="high italic">references</span>.
<p> <span class="high bold">Each section</span> heading has <span class="high bold">three identifiers</span>.
<ol class="list list0">
<li class="item"> a dot-point numeric corresponding to the section number shown in major headings
<li class="item"> one derived from the text of the heading (alphanumeric all lower-case string)
<li class="item"> combination with a period-separated concatentation of the numeric and text
</ol>
<p> All internal document links use the concatenated identifier.
<p> The dot-point numeric can change with the addition or deletion of
intervening headings but the text-derived fragment identifier only changes when
the heading is modified. It is a good choice when making a reference from
another part of the document, or from an external document. The internal link
(combination) can generally be used as an external reference by just removing
the leading numeric element and using the alphanumeric string. The dot-point
may also be used as the fragment identifier.
<p> Different headings having the same text will result in duplicate fragment
identifiers and generally the first in the document will be targeted by the
browser. So as much as practicable, avoid using the same description for
multiple headings. If this is unavoidable the location can also be explicitly
located with a unique identifier using an explicit cross-reference as mentioned
above. Alternatively, prefix the alphanumeric with the dot-point number of the
most recent numbered heading.
<p> The above section may be directly accessed using
<ul class="list simple list0">
<li class="item"> <a href="#4.1"><span class="high monosp">#4.1</span></a>
<li class="item"> <a href="#4.1.theessentialfragment"><span class="high monosp">#4.1.theessentialfragment</span></a>
<li class="item"> <a href="#theessentialfragment"><span class="high monosp">#theessentialfragment</span></a>
</ul>
<a id="4.2" href="#"></a>
<a id="4.2.linkstootherdocuments" href="#"></a>
<a id="linkstootherdocuments" href="#"></a>
<h2 class="head"><span class="numb">4.2</span><span class="text">Links to Other Documents</span></h2>
<p> Links to <span class="high wasdoc">wasDOC</span> documents are are indicated by a path with a final
element (the fragment) beginning with two hashes (<span class="high monosp">/##</span>). The two
differentiate it as a <span class="high wasdoc">wasDOC</span> link and the path and hash are made
compliant with <span class="high wasdoc">wasDOC</span> requirements. One of the hashes is absorbed
when generating the link. The fragment can be empty. The links can be
relative, or site-absolute, or full URL references. The final element of the
path is the fragment reference. This is an example of a link to a document in
an adjacent location (directory). The variants are all equivalent.
<div class="blockof mono">|link|../Doc Two/##Somewhere Inside It|This is another document|
|link|../doc_two/##Somewhere Inside It|This is another document|
|link|../Doc Two/##somewhereinsideit|This is another document|
|link|../doc_two/##somewhereinsideit|This is another document|
|link|/wasd_root/src/wasdoc/Doc Two/##Somewhere Inside It|This is another document|
|link|/wasd_root/src/wasdoc/doc_two/##somewhereinsideit|This is another document|
</div>
In thse examples, the translated name of the directory containing the
document would be the equivalent of <span class="high monosp">[-.doc_two]</span> and the fragment
reference <span class="high monosp display0">somewhereinsideit</span>. The browser would use the URI
and it looks and behaves something like this
<div class="blockof mono"> <a class="link blank" target="_blank" href="../doc_two/#somewhereinsideit">This is another document</a> </div>
<a id="4.2.0.0.1" href="#"></a>
<a id="4.2.startofdocument" href="#"></a>
<a id="startofdocument" href="#"></a>
<h5 class="head"><span class="text">Start of Document</span></h5>
<p> To link to the beginning of a document just include an empty hash
<div class="blockof mono"> |link|../Doc Two/##| </div>
For this to work without additional mapping by the server there needs to be
a one-to-one correspondence between the referenced document and the translated
path to that document. So a rule such as
<div class="blockof mono"> pass /documents/* /doc_root/* </div>
would provide access to document locations
<div class="blockof mono">/documents/document_one/
/documents/document_two/
/documents/yet_another_document/
</div>
<p> Of course additional mappings may be in place to locate the documents just
about anywhere.
<a id="4.2.0.0.2" href="#"></a>
<a id="4.2.specificsectionofwholedocument" href="#"></a>
<a id="specificsectionofwholedocument" href="#"></a>
<h5 class="head"><span class="text">Specific Section of Whole Document</span></h5>
<p> Using the syntax described below a link to a section of another document may
be coupled with a separate link to the whole document. Two lots of two
consecutive plus symbols delineate the section link, the conjunction, and the
title of the document.
<div class="blockof mono"> |link%|../Doc Two/##Somewhere Inside It++in++Document Two| </div>
<p> and it looks and behaves something like this
<div class="blockof mono"> <a class="link blank" target="_blank" href="../doc_two/#somewhereinsideit">Somewhere Inside It</a> in <a class="link blank" target="_blank" href="../doc_two/#0.">Document Two</a> </div>
<!-- source:0500_CONDITIONAL.WASDOC -->
<hr class="page">
<a id="5." href="#"></a>
<a id="5.conditionalcontent" href="#"></a>
<a id="conditionalcontent" href="#"></a>
<h1 class="head"><span class="numb">5.</span><span class="text">Conditional Content</span></h1>
<table class="TOC2table">
<tr><td><a href="#5.1.matchconditional"><span class="numb">5.1</span><span class="text">Match Conditional</span></a>
<tr><td><a href="#5.1.1.regexbasics"><span class="numb">5.1.1</span><span class="text">Regex Basics</span></a>
<tr><td><a href="#5.2.spawnconditional"><span class="numb">5.2</span><span class="text">Spawn Conditional</span></a>
<tr><td><a href="#5.3.timeconditional"><span class="numb">5.3</span><span class="text">Time Conditional</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#4.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#6.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> <span class="high wasdoc">wasDOC</span> provides for content to be included and excluded based on
specified critera.
This has already been demonstrated when the document was described as
<span class="high bold">static</span> (a file)
using a construct such as
<div class="blockof mono">This has already been demonstrated when the document was described as
|if|dynamic| |*dynamic| (a CGI script)
|else| |*static| (a file)
|endif|
using a construct such as</div>
as well as in the <a class="link" href="#0.documentformats">document prologue</a> where alternative
formats were suggested based on the current presentation.
<p> The mechanism is the very familiar <span class="high monosp">if</span>–<span class="high monosp">elif</span>–<span class="high monosp">else</span>–<span class="high monosp">endif</span>
structure, where tests using <span class="high monosp">if</span> and <span class="high monosp">elif</span> resolving to true or false,
control inclusion of related portions of the document. Conditionals may be
nested. A conditional may be negated by prefixing it with <span class="high monosp">!</span> (an
exclamation point). A conditional structure may not span major sections
(<span class="high monosp">|1heading|</span>).
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Condition
<th class="tabh">Comment
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|apache|</span>
<td class="tabd">include if … Apache server
<tr class="tabr">
<td class="tabd"><span class="high monosp">|cgi=<name>[:<keyword>/<regex>]|</span>
<td class="tabd">… CGI variable **
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|dynamic|</span>
<td class="tabd">… executing as CGI script
<tr class="tabr">
<td class="tabd"><span class="high monosp">|hide|</span>
<td class="tabd">… only if the query string contains <span class="high monosp">nohide=1</span>
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|lnm=<name>[:<keyword>/<regex>]|</span>
<td class="tabd">… logical name value **
<tr class="tabr">
<td class="tabd"><span class="high monosp">|multi|</span>
<td class="tabd">… document presented in major-heading portions
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|osu|</span>
<td class="tabd">… OSU server
<tr class="tabr">
<td class="tabd"><span class="high monosp">|single|</span>
<td class="tabd">… full document
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|spawn=<command>[:<keyword>/<regex>]|</span>
<td class="tabd">… output from spawned command ** (see <a class="link" href="#5.2.spawnconditional">5.2 Spawn Conditional</a>)
<tr class="tabr">
<td class="tabd"><span class="high monosp">|static|</span>
<td class="tabd">… from a file (i.e. not a CGI script)
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|syi=<name>[:<keyword>/<regex>]|</span>
<td class="tabd">… any system value that can be inserted ** (see <a class="link" href="#2.7.3.systemdata">2.7.3 System Data</a>)
<tr class="tabr">
<td class="tabd"><span class="high monosp">|time:<pattern>|</span>
<td class="tabd">… time value (see <a class="link" href="#5.3.timeconditional">5.3 Time Conditional</a>)
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|wasd|</span>
<td class="tabd">… WASD server
<tr class="tabr">
<td class="tabd"><span class="high monosp">|FLAG[:<keyword>/<regex>]|</span>
<td class="tabd">… flag content ** (see <a class="link" href="#7.2.flags">7.2 FLAGs</a>)
<tr class="tabr backlight">
<td class="tabd"><span class="high monosp">|0|</span>
<td class="tabd">unconditional exclusion
<tr class="tabr">
<td class="tabd"><span class="high monosp">|1|</span>
<td class="tabd">unconditional inclusion
<tr class="tabr backlight">
<td class="tabd right" colspan="2"><sup>**</sup><span class="high italic">see <a class="link" href="#5.1.matchconditional">5.1 Match Conditional</a></span>
</table>
<p> Another example showing nested conditionals
<div class="blockof mono">|if|dynamic|
this dynamic document has been brought to you by the
|if|apache|
Apache
|elif|osu|
OSU
|elif|wasd|
WASD
|endif|
server executing on a
|if|syi=cluster=member| clustered |else| non-clustered |endif| \
|insert|syi=arch_name||.
|else|
this document is just from a flat, ol' file, originally generated on a
|if|syi=cluster=member| clustered |else| non-clustered |endif| \
|insert|syi=arch_name||.
|endif|</div>
and now in motion …
<span class="highinline" style="background-color:yellow;">this document is just from a flat, ol' file, originally generated on a
non-clustered Alpha.
</span>
<a id="5.0.0.0.0.1" href="#"></a>
<a id="5.conditionalkeywordmatch" href="#"></a>
<a id="conditionalkeywordmatch" href="#"></a>
<h6 class="head display0"><span class="text">Conditional keyword match</span></h6>
<a id="5.1" href="#"></a>
<a id="5.1.matchconditional" href="#"></a>
<a id="matchconditional" href="#"></a>
<h2 class="head"><span class="numb">5.1</span><span class="text">Match Conditional</span></h2>
<p> The simple conditions such as <span class="high monosp">|dynamic|</span> and <span class="high monosp">|multi|</span> allow fairly
"flat" documents to adapt presentation to basic variations in document access.
To use <span class="high wasdoc">wasDOC</span> for more sophisticated dynamic documents more
sophisticated variants need to be supported.
<p> The <span class="high monosp">cgi</span>, <span class="high monosp">trnlnm</span> and <span class="high monosp">FLAG</span> conditions may all have the associated
value matched to a keyword or regular expression (see <a class="link" href="#5.1.1.regexbasics">5.1.1 Regex Basics</a>).
<p> In general, if the conditional <span class="high monosp"><name></span> does not exist the following
document content is excluded. If the name exists and no match specified then
the content is included. When a colon-separated <span class="high monosp"><keyword></span> or <span class="high monosp"><regex></span>
is supplied the value is tested against the parameter. If the keyword (or
phrase) occurs in the value then the following content is included, otherwise
excluded. Likewise if the regular expression matches or does not match the
value. Matching is case insensitive.
<p> This example provides something similar to the one above.
<div class="blockof mono">|if|dynamic|
This dynamic document served by\
|if|cgi=SERVER_SOFTWARE:WASD| WASD. |else| something |*other| than WASD. |endif|
|else|
This document is from a static file.
|endif|</div>
<p class="indent">
This document is from a static file.
<a id="5.1.0.0.0.1" href="#"></a>
<a id="5.1.conditionalregularexpressionmatch" href="#"></a>
<a id="conditionalregularexpressionmatch" href="#"></a>
<h6 class="head display0"><span class="text">Conditional regular expression match</span></h6>
<a id="5.1.1" href="#"></a>
<a id="5.1.1.regexbasics" href="#"></a>
<a id="regexbasics" href="#"></a>
<h3 class="head"><span class="numb">5.1.1</span><span class="text">Regex Basics</span></h3>
<p> A regular expression, or <span class="high bold">regex</span>, is a sequence of characters that define
a search pattern. A detailed tutorial on regular expression capabilities and
usage is well beyond the scope of this document. Many such hard-copy and
on-line documents are available.
<p class="indent"> <a class="link blank" target="_blank" href="http://en.wikipedia.org/wiki/Regular_expression">http://en.wikipedia.org/wiki/Regular_expression</a>
<p> A regular expression is differentiated from a keyword by a leading <span class="high monosp">^</span>
(caret) character. Regex equivalent to the preceding example.
<div class="blockof mono">|if|dynamic| This dynamic document served by\
|if|cgi=SERVER_SOFTWARE:^.*WASD.*| WASD. |else| something |*other| than WASD. |endif|
|else| This document is from a static file. |endif|</div>
<p class="indent">
This document is from a static file.
<p> <span class="high wasdoc">wasDOC</span> regular expressions support the following elements. Escape
<span class="high wasdoc">wasDOC</span>-reserved characters (i.e. <span class="high monosp">|</span> and <span class="high monosp">\</span>).
<a id="5.1.1.0.1" href="#"></a>
<a id="5.1.1.operatoroverview" href="#"></a>
<a id="operatoroverview" href="#"></a>
<h5 class="head"><span class="text">Operator Overview</span></h5>
<table class="tabl nowrap">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Usage
<tr class="tabr">
<tr class="tabr">
<td class="tabd">Match-self Operator
<td class="tabd">Ordinary characters.
<tr class="tabr">
<td class="tabd">Match-any-character Operator
<td class="tabd">.
<tr class="tabr">
<td class="tabd">Concatenation Operator
<td class="tabd">Juxtaposition.
<tr class="tabr">
<td class="tabd">Repetition Operators
<td class="tabd">* + ? {}
<tr class="tabr">
<td class="tabd">Alternation Operator
<td class="tabd">|
<tr class="tabr">
<td class="tabd">List Operators
<td class="tabd">[...] [^...]
<tr class="tabr">
<td class="tabd">Grouping Operators
<td class="tabd">(...)
<tr class="tabr">
<td class="tabd">Back-reference Operator
<td class="tabd">^digit
<tr class="tabr">
<td class="tabd">Anchoring Operators
<td class="tabd">^ $
<tr class="tabr">
<td class="tabd">Backslash Operator
<td class="tabd">Escape meta-character; i.e.
^ ^ . $ | [ (
</table>
<p> The following operators are used to match one, or in conjunction with the
repetition operators more, characters of the target string. These single and
leading characters are reserved meta-characters and must be escaped using a
leading backslash ("^") if required as a literal character in the matching
pattern. <span class="high bold">Note</span> that this does not apply to the <span class="high italic">range</span> hyphen; to include a
hyphen in a range ensure the character is the first or last in the range.
<a id="5.1.1.0.2" href="#"></a>
<a id="5.1.1.matchingoperators" href="#"></a>
<a id="matchingoperators" href="#"></a>
<h5 class="head"><span class="text">Matching Operators</span></h5>
<table class="tabl nowrap">
<tr class="tabr under">
<th class="tabh">Expression
<th class="tabh">Purpose
<tr class="tabr">
<tr class="tabr">
<td class="tabd">^
<td class="tabd">Match the beginning of the line
<tr class="tabr">
<td class="tabd">.
<td class="tabd">Match any character
<tr class="tabr">
<td class="tabd">$
<td class="tabd">Match the end of the line
<tr class="tabr">
<td class="tabd">|
<td class="tabd">Alternation (or)
<tr class="tabr">
<td class="tabd">[abc]
<td class="tabd">Match only a, b or c
<tr class="tabr">
<td class="tabd">[^abc]
<td class="tabd">Match anything except a, b and c
<tr class="tabr">
<td class="tabd">[a-z0-9]
<td class="tabd">Match any character in the range a to z or 0 to 9
</table>
<p> Repetition operators control the extent, or number, of whatever the matching
operators match. These are also reserved meta-characters and must be escaped
using a leading backslash if required as a literal character.
<a id="5.1.1.0.3" href="#"></a>
<a id="5.1.1.repetitionoperators" href="#"></a>
<a id="repetitionoperators" href="#"></a>
<h5 class="head"><span class="text">Repetition Operators</span></h5>
<table class="tabl nowrap">
<tr class="tabr under">
<th class="tabh">Expression
<th class="tabh">Function
<tr class="tabr">
<tr class="tabr">
<td class="tabd">*
<td class="tabd">Match 0 or more times
<tr class="tabr">
<td class="tabd">+
<td class="tabd">Match 1 or more times
<tr class="tabr">
<td class="tabd">?
<td class="tabd">Match 1 or zero times
<tr class="tabr">
<td class="tabd">{n}
<td class="tabd">Match exactly n times
<tr class="tabr">
<td class="tabd">{n,}
<td class="tabd">Match at least n times
<tr class="tabr">
<td class="tabd">{n,m}
<td class="tabd">Match at least n but not more than m times
</table>
<a id="5.2" href="#"></a>
<a id="5.2.spawnconditional" href="#"></a>
<a id="spawnconditional" href="#"></a>
<h2 class="head"><span class="numb">5.2</span><span class="text">Spawn Conditional</span></h2>
<p> Output from a spawned command may be tested using keyword and regex matching
the same as other strings (see <a class="link" href="#2.7.1.spawnedcommand">2.7.1 Spawned Command</a>). Output also can be
reused for further matching or output by specifying the <span class="high monosp">&</span> (ampersand)
character instead of a command. This will not only avoid additional overhead
but also presents the exact same data used for the conditional.
<div class="blockof block"><span class="high bold">This system has a C compiler available:</span>
<br>
<div class="blockof mono backlight inblock noindent" style="padding:0.3em;">VSI C V7.4-002 on OpenVMS Alpha V8.4-2L1
</div>
</div>
<div class="blockof mono">|if|spawn=!-cc/version|
|*This system has a C compiler available:|
|else|
|*This system does not have a C compiler available:|
|endif| |^-
|mono-#*#::##3|
|insert|spawn=!&|
|!mono|</div>
<a id="5.3" href="#"></a>
<a id="5.3.timeconditional" href="#"></a>
<a id="timeconditional" href="#"></a>
<h2 class="head"><span class="numb">5.3</span><span class="text">Time Conditional</span></h2>
<p> The <span class="high monosp">time</span> conditional allows document content to change according to the
time of day, week, or even year. It compares the supplied parameter to the
current system time in one of three ways.
<ol class="list">
<li class="item"> The supplied parameter is in the form "1200-1759", which should
be read as "twelve noon to five fifty-nine PM" (i.e. as a time range in
minutes, generalized as <span class="high italic">hhmm-hhmm</span>), where the first is the start
time and the second the end time. If the current time is within that range
(inclusive) the conditional returns true, otherwise false. If the range
doesn't look correct false is always returned.
<div class="blockof mono">|if|time:0000-0000|
<i>it's midnight</i>
|elif|time:0001-1159|
<i>it's AM</i>
|elif|time:1200-1200|
<i>it's noon</i>
|else|
<i>it's PM</i>
|endif|</div>
<li class="item"> If the supplied parameter is a single digit (or series of digits) it is
compared to the VMS day of the week (1-Monday, 2-Tuesday … 7-Sunday).
<div class="blockof mono">|if|time:6,7|
<i>it's the weekend</i>
|else|
<i>it's the working week</i>
|endif|</div>
<li class="item"> If the supplied string is not in either of the formats described above
it is treated as a string match with a VMS comparision time (i.e.
<span class="high italic">yyyy-mm-dd hh-mm-ss.hh</span>) using C-RTL <span class="high italic">decc$match_wild()</span> or <span class="high monosp">^</span>regex).
<div class="blockof mono">|if|time:%%%%-07-*|
<i>it's the month of July</i>
|endif|</div>
</ol>
<p> These are combined in the following example.
<p class="indent">
<div class="blockof block backlight inblock" style="padding:0.8em;"> At time of rendering it was <span class="highinsert bold">Saturday, July 11 09:12</span>
<br> Which makes it <span class="high bold">the weekend</span>.
<br> And so many are <span class="high bold">not concerned</span> about the workplace. <span class="high _smiley"> </span>
</div>
<div class="blockof mono">|^+ |if|dynamic| Currently it is |else| At time of rendering it was |endif|\
|insert*|time=%A, %B %d %H:%M|
// largely teased out into separate, continued lines for clarity
|^- Which makes it \
|if|time:6,7| |*the weekend||.
|^- And so many are |*not concerned| about the workplace. |'_smiley.\ |
|else| during the working week.\
|^- And as it's \
|if|time:0000-0859| early morning\
|elif|time:0900-1700| between 9AM and 5PM\
|else| late in the day \
|endif| also likely \
|if|!time:0900-1700| |*_not| |endif| |*working hours||.
|endif|</div>
<p class="indent"> <span class="high italic">Clear as mud? Thought it might be.</span>
<!-- source:0600_NAVIGATE.WASDOC -->
<a id="5.3.0.0.0.1" href="#"></a>
<a id="5.3.documentnavigation2" href="#"></a>
<a id="documentnavigation2" href="#"></a>
<h6 class="head display0"><span class="text">Document Navigation 2</span></h6>
<hr class="page">
<a id="6." href="#"></a>
<a id="6.documentnavigation" href="#"></a>
<a id="documentnavigation" href="#"></a>
<h1 class="head"><span class="numb">6.</span><span class="text">Document Navigation</span></h1>
<table class="TOC2table">
<tr><td><a href="#6.1.primarytoc"><span class="numb">6.1</span><span class="text">Primary TOC</span></a>
<tr><td><a href="#6.2.secondarytoc"><span class="numb">6.2</span><span class="text">Secondary TOC</span></a>
<tr><td><a href="#6.3.navigationicons"><span class="numb">6.3</span><span class="text">Navigation Icons</span></a>
<tr><td><a href="#6.4.documentindex"><span class="numb">6.4</span><span class="text">Document Index</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#5.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#7.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> <span class="high wasdoc">wasDOC</span> provides a variety of navigation mechanisms.
<ul class="list">
<li class="item"> A primary Table of Context (TOC) provides links to all sections and
subsections of the document.
<li class="item"> Secondary Table of Content placed at the beginning of each major section
providing navigation to the subsections within.
<li class="item">
Navigation icons
↩︎
↖︎
↑︎
↘︎
↪︎
provide links to adjacent and visited sections.
<li class="item"> The document <span class="high italic">Index</span> provides an alphabetically arranged set of links into
various parts of the document.
</ul>
<p> Each of these is described in the following sections.
<a id="6.1" href="#"></a>
<a id="6.1.primarytoc" href="#"></a>
<a id="primarytoc" href="#"></a>
<h2 class="head"><span class="numb">6.1</span><span class="text">Primary TOC</span></h2>
<p> The tags <span class="high monosp">|1</span> through to <span class="high monosp">|4</span> divides the document into titled
sections and and generates a hierarchical primary table of content (TOC). Each
generates a corresponding (HTML) heading containing the section title.
<p> <span class="high monosp">|0</span> tags do not generate primary TOC entries. Optionally these can
be included in secondary TOCs.
<p> Any heading tag can be prefixed with a zero to suppress the primary TOC
entry while inserting that style heading.
<p> The primary TOC is presented in two columns. This may be reduced to a
single column or increased to three or four using
<span class="high monosp">|set|toc=cols=<span class="high italic">integer</span>|</span>.
<p> The table of content is inserted wherever the <span class="high monosp">|toc|</span> tag is placed. If
not included then no primary TOC is generated.
<a id="6.1.0.0.1" href="#"></a>
<a id="6.1.tocnumbering" href="#"></a>
<a id="tocnumbering" href="#"></a>
<h5 class="head"><span class="text">TOC Numbering</span></h5>
<p> By default the Table of Content is numbered as section and subsections (see
<a class="link" href="#2.1.documentsections">2.1 Document Sections</a>). Using the setting <span class="high monosp">|set|toc=format=0|</span> this
can be disabled, resulting in no section numbering. Explicitly (re)enable
using <span class="high monosp">|set|toc=format=1|</span>.
<p> In addition, a numeric TOC can have a separator inserted after the section
number up to the section heading, making a TOC entry look <span class="high italic">something</span> like the
next (faux) heading.
<a id="6.1.0.0.2" href="#"></a>
<a id="6.1.611obscureembellishments" href="#"></a>
<a id="611obscureembellishments" href="#"></a>
<h5 class="head"><span class="text">6.1.1 ......... Obscure Embellishments</span></h5>
<p> The syntax <span class="high monosp">|set|toc=format=1....................|</span> will introduce a
space filled with the specified text between the entry number and title. Just
make sure there is enough of the separator characters to span the space between
the section number and text (<span class="high bold">hint:</span> a ragged edge at the right indicates too
few). While simple characters such as periods and hyphens are obvious choices
some HTML entities are more aesthetically pleasing. The following seem to work
well; <span class="high monosp">&nldr;</span> ‥ <span class="high monosp">&ctdot;</span> ⋯ <span class="high monosp">&hellip;</span> … (used
in this document) <span class="high monosp">&bull;</span> • <span class="high monosp">&compfn;</span> ∘ <span class="high monosp">&hyphen;</span>
‐ <span class="high monosp">&lowbar;</span> _ and <span class="high monosp">&period;</span> . — just
remember to have enough entities to fill that intervening space!
<a id="6.1.0.0.3" href="#"></a>
<a id="6.1.bullnbspnbspasimplebullet" href="#"></a>
<a id="bullnbspnbspasimplebullet" href="#"></a>
<h5 class="head"><span class="text">• A Simple Bullet</span></h5>
<p> Alternatively, it can be set to a literal string which is
prefixed to the heading title. This is intended to allow an HTML entity to
delineate the headings, as in <span class="high monosp">|set|toc=format=&bull;&nbsp;&nbsp;|</span>.
<a id="6.2" href="#"></a>
<a id="6.2.secondarytoc" href="#"></a>
<a id="secondarytoc" href="#"></a>
<h2 class="head"><span class="numb">6.2</span><span class="text">Secondary TOC</span></h2>
<p> A secondary table of content can be placed at the beginning of each major
section providing navigation to the <span class="high monosp">|2</span> and <span class="high monosp">|4</span> headings within that
section. This document has secondary TOC enabled.
<p> The secondary TOC is enabled using the <span class="high monosp">|set|toc2=<span class="high italic">integer</span>|</span> setting.
The <span class="high italic">integer</span> specifies the level of inclusion. Using <span class="high monosp">|set|toc2=1|</span>
includes the primary TOC entries, <span class="high monosp">|set|toc2=2|</span> includes <span class="high italic">all</span> headings.
The TOC is presented in two columns. This may be reduced to a single column or
increased to three or four using <span class="high monosp">|set|toc2=cols=<span class="high italic">integer</span>|</span>.
<a id="6.3" href="#"></a>
<a id="6.3.navigationicons" href="#"></a>
<a id="navigationicons" href="#"></a>
<h2 class="head"><span class="numb">6.3</span><span class="text">Navigation Icons</span></h2>
<p> Navigation icons provide the
↩︎
↖︎
↑︎
↘︎
↪︎
which left to right represent; history backward, previous major section, start
of document (often primary TOC), next major section, history forward.
Navigation items are enabled using <span class="high monosp">|set|navigate=1|</span>. This document has
navigation items enabled as can be seen below the <a class="link" href="#6.documentnavigation">6. Document Navigation</a>
(this) heading.
<a id="6.4" href="#"></a>
<a id="6.4.documentindex" href="#"></a>
<a id="documentindex" href="#"></a>
<h2 class="head"><span class="numb">6.4</span><span class="text">Document Index</span></h2>
<p> This provides an <span class="high italic">alphabetically arranged</span> set of links into various parts
of the document, collated on the first character of the reference description.
Any and all headings are included (<span class="high monosp">|0</span>, <span class="high monosp">|1</span> … <span class="high monosp">|4</span> and <span class="high monosp">|9</span>).
<p> Unnumbered headings (i.e. <span class="high monosp">|0</span>) are placed into context by including the
preceding numbered heading in the entry. For example, the heading
<span class="high monosp">|0Contextual Example|</span> in this section would appear in the index as:
<span class="high" style="background-color:#f2f2f2;">‘Contextual Example’ in 6.4 Document Index</span>.
<p> To suppress the context, just using the heading, prefix the section number 9
digit with a leading <span class="high monosp">9</span> (nine) digit (i.e. <span class="high monosp">|99</span>).
<p> To suppress the index entry completely while still inserting a document
reference, prefix the section number 9 digit with a <span class="high monosp">0</span> (zero) digit (i.e.
<span class="high monosp">|09</span>).
<a id="6.4.0.0.0.1" href="#"></a>
<a id="6.4.verbar9verbar" href="#"></a>
<a id="verbar9verbar" href="#"></a>
<h6 class="head display0"><span class="text">|9...|</span></h6>
<p> A heading <span class="high monosp">|9...|</span> uses the following document text as the Index item. If
an explicit alphabetic character precedes the ellipsis this is used as the
Index collating character. Therefore
<div class="blockof asis monosp prewrap">|9X...|
This is just an example!</div>
would place "This is just an example!" into the "<span class="high monosp">X</span>" section of the Index.
<p> The Index is inserted wherever the <span class="high monosp">|index|</span> tag is placed (usually
towards the end of the document as with <a class="link" href="#9.index">this one</a>).
If not included then no Index is generated.
<p> The index is presented in two columns. This may be reduced to a single
column or increased to three or four using <span class="high monosp">|set|idx=cols=<span class="high italic">integer</span>|</span>.
<p> The default index is collated using the 26 alphabetics of the English
language Latin alphabet. This may be modified using the setting
<span class="high monosp">|set|idx=collate=<span class="high italic">string</span>|</span> where <span class="high italic">string</span> is a list of 8 bit Latin 1
characters. Each character to be collated must have two listed, the first an
upper-case version, followed by the lower-case equivalent. The first of the
two characters is listed in the index. If the character specified does not
have one or the other then just repeat the character. The default English
language collation sequence is
<div class="blockof code">AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz
</div>
<p> If the sequence is prefixed with a plus symbol
(i.e. <span class="high monosp">|set|idx=collate=+<span class="high italic">string</span>|</span>)
then the parameter is appended to any existing sequence. Without the plus the
collation sequence is replaced.
<p> To include entries beginning with integers use
<span class="high monosp">|set|idx=collate=+00112233445566778899|</span>.
<!-- source:0700_USING.WASDOC -->
<hr class="page">
<a id="7." href="#"></a>
<a id="7.documentconstruction" href="#"></a>
<a id="documentconstruction" href="#"></a>
<h1 class="head"><span class="numb">7.</span><span class="text">Document Construction</span></h1>
<table class="TOC2table">
<tr><td><a href="#7.1.control"><span class="numb">7.1</span><span class="text">Control</span></a>
<tr><td><a href="#7.2.flags"><span class="numb">7.2</span><span class="text">FLAGs</span></a>
<tr><td><a href="#7.3.documentinsights"><span class="numb">7.3</span><span class="text">Document Insights</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#6.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#8.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> <span class="high wasdoc">wasDOC</span> source is intended to be edited using a simple, plain-text
editor of choice — a.k.a. EDT, TPU, etc.
<p> Document markup should regularly be checked by keeping a browser open on
the document and <span class="high italic">refreshing</span> the page as required.
<p> The first file should contain document "prologue" content, primarily style
sheet data.
<p> Document style, for example the fonts used, background colour or image,
margins and spacings, etc., should be handled through the style sheet prologue.
"Hard-wiring" style using constructs such as
<span class="high monosp">|"<div style="background-color:red;">|</span> is also possible but should be
specific in purpose and carefully considered before being employed. If
absolutely needed, add a class to the style sheet and
<span class="high monosp">|"<div class="..">|</span>.
<p> Sections of a document may be kept hidden from casual viewing using the
<span class="high monosp">|hide|</span> tag. This allows ongoing document development on a "live" resource.
To access the hidden portion of the document under development access the
document with
<span class="high monosp">nohide=1</span>
in a query string. Most markup errors inside a hidden section will not affect
the rendering of the rest of the document. They will only be visible when
accessing via <span class="high monosp">nohide</span>. An <span class="high monosp">|exit|</span> terminates document processing.
<a id="7.1" href="#"></a>
<a id="7.1.control" href="#"></a>
<a id="control" href="#"></a>
<h2 class="head"><span class="numb">7.1</span><span class="text">Control</span></h2>
<p> A number of directives are used to control <span class="high wasdoc">wasDOC</span> behaviour.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Purpose
<th class="tabh">Syntax
<th class="tabh">Comment
<tr class="tabr">
<tr class="tabr">
<td class="tabd nowrap">break source
<td class="tabd"><span class="high monosp">|break|</span>
<td class="tabd">break as if source was exhausted
<tr class="tabr">
<td class="tabd nowrap">exit document processing
<td class="tabd"><span class="high monosp">|exit|</span>
<td class="tabd">terminate document processing
<tr class="tabr">
<td class="tabd nowrap">tag stack
<td class="tabd"><span class="high monosp">|insight!|</span>
<td class="tabd">for document "debugging" purposes (see <a class="link" href="#7.3.documentinsights">7.3 Document Insights</a>)
<tr class="tabr">
<td class="tabd nowrap">text and HTML reveal
<td class="tabd"><span class="high monosp">|insight@|</span>
<td class="tabd">display <span class="high _button">TEXT</span> and <span class="high _button">HTML</span> buttons
<tr class="tabr">
<td class="tabd nowrap">print
<td class="tabd"><span class="high monosp">|print|</span>
<td class="tabd">included only when printed
<tr class="tabr">
<td class="tabd nowrap">no print
<td class="tabd"><span class="high monosp">|noprint|</span>
<td class="tabd">omitted when printed
</table>
<a id="7.1.0.0.1" href="#"></a>
<a id="7.1.settings" href="#"></a>
<a id="settings" href="#"></a>
<h5 class="head"><span class="text">Settings</span></h5>
<p> The specific <span class="high monosp">|set|</span> directive is used to set and reset various document
processing functionality. <span class="high bold">Most should be used early in the document</span> as they
determine document processing characteristics.
<table class="tabl" style="width:90%">
<tr class="tabr under">
<th class="tabh" style="width:12em;">Purpose
<th class="tabh">Syntax
<th class="tabh">Comment
<tr class="tabr">
<tr class="tabr">
<td class="tabd nowrap">document in major sections
<td class="tabd"><span class="high monosp">|set|chunked=-1|</span>
<td class="tabd">document is <span class="high bold">not</span> to be provided in major heading chunks
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|chunked=0|</span>
<td class="tabd">let the client decide (<span class="high monosp">/000/</span>)
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|chunked=1|</span>
<td class="tabd">will be provided in major heading chunks
<tr class="tabr">
<td class="tabd nowrap">set default "<span class="high italic">this</span> in <span class="high italic">that</span>" reference
<td class="tabd nowrap"><span class="high monosp">|set|found=<span class="high italic">string</span>|</span>
<td class="tabd">default is " in "
<tr class="tabr">
<td class="tabd nowrap">index columns
<td class="tabd nowrap"><span class="high monosp">|set|idx=cols=<span class="high italic">integer</span>|</span>
<td class="tabd">number of columns in the index
<tr class="tabr">
<td class="tabd nowrap">index collation
<td class="tabd nowrap"><span class="high monosp">|set|idx=collation=<span class="high italic">string</span>|</span>
<td class="tabd">default is 26 Latin alphabetics (see <a class="link" href="#6.4.documentindex">6.4 Document Index</a>)
<tr class="tabr">
<td class="tabd nowrap">set informational comments
<td class="tabd nowrap"><span class="high monosp">|set|insight=<span class="high italic">integer</span>|</span>
<td class="tabd">1, 2, 3, 4 and 5 (see <a class="link" href="#7.3.documentinsights">7.3 Document Insights</a>)
<a id="7.1.0.0.1.1" href="#"></a>
<a id="7.1.characterset" href="#"></a>
<a id="characterset" href="#"></a>
<h6 class="head display0"><span class="text">character set</span></h6>
<a id="7.1.0.0.1.2" href="#"></a>
<a id="7.1.localeinparticularcharacterset" href="#"></a>
<a id="localeinparticularcharacterset" href="#"></a>
<h6 class="head display0"><span class="text">Locale, in particular character set</span></h6>
<tr class="tabr">
<td class="tabd">locale
<td class="tabd"><span class="high monosp">|set|locale=all=<span class="high italic">string</span>|</span>
<td class="tabd">all locale aspects as defined by C-RTL function setlocale()
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|locale=ctype=<span class="high italic">string</span>|</span>
<td class="tabd">document character set only
<br> i.e. those defined by SYS$I18N_LOCALE
<br> e.g. EN_US_ISO8859-1, EN_GB_ISO8859-1, DE_DE_ISO8859-1-EURO,
NL_NL_ISO8859-1, SV_SE_ISO8859-1
<tr class="tabr">
<td class="tabd">provide navigation arrows
<td class="tabd nowrap"><span class="high monosp">|set|navigate=0|</span>
<td class="tabd">disable per sub-TOC navigation arrows
<tr class="tabr">
<td class="tabd">
<td class="tabd nowrap"><span class="high monosp">|set|navigate=1|</span>
<td class="tabd">enable navigation arrows
<tr class="tabr">
<td class="tabd">
<td class="tabd nowrap"><span class="high monosp">|set|navigate=2|</span>
<td class="tabd">enable in printed documents <br>this will allow PDFs with active links to be navigated
<tr class="tabr">
<td class="tabd nowrap">set default note heading
<td class="tabd nowrap"><span class="high monosp">|set|note=<span class="high italic">string</span>|</span>
<td class="tabd">default is "Note"
<tr class="tabr">
<td class="tabd">set pagination
<td class="tabd nowrap"><span class="high monosp">|set|paginate=1|</span>
<td class="tabd">insert page rule at each major section
<tr class="tabr">
<td class="tabd">default table alignment
<td class="tabd nowrap"><span class="high monosp">|set|table=margin=<span class="high italic">flag</span>|</span>
<td class="tabd">where <span class="high italic">flag</span> is + (plus) or - (minus) or empty
<tr class="tabr">
<td class="tabd nowrap">set explicit document title
<td class="tabd nowrap"><span class="high monosp">|set|title=<span class="high italic">string</span>|</span>
<td class="tabd">default is the content of the document first heading
<tr class="tabr">
<td class="tabd nowrap">table of content columns
<td class="tabd nowrap"><span class="high monosp">|set|toc=cols=<span class="high italic">integer</span>|</span>
<td class="tabd">number of columns in TOC
<tr class="tabr">
<td class="tabd nowrap">table of content format
<td class="tabd nowrap"><span class="high monosp">|set|toc=format=<span class="high italic">string</span>|</span>
<td class="tabd">default is <span class="high italic">number</span> <span class="high italic">text</span>
<tr class="tabr">
<td class="tabd">enable secondary TOC
<td class="tabd"><span class="high monosp">|set|toc2=1|</span>
<td class="tabd">each major section has its own TOC table showing headings
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|toc2=2|</span>
<td class="tabd">include each unnumbered heading as well
<tr class="tabr">
<td class="tabd nowrap">secondary TOC columns
<td class="tabd nowrap"><span class="high monosp">|set|toc2=cols=<span class="high italic">integer</span>|</span>
<td class="tabd">number of columns in TOC
</table>
<a id="7.2" href="#"></a>
<a id="7.2.flags" href="#"></a>
<a id="flags" href="#"></a>
<h2 class="head"><span class="numb">7.2</span><span class="text">FLAGs</span></h2>
<p> FLAGs are ad hoc, all-upper-case strings that may be <span class="high monosp">|set|</span> with string
values and later used with the <span class="high monosp">|insert|</span> tag (<a class="link" href="#2.7.2.flaginsertion">2.7.2 FLAG Insertion</a>), as
well as to control document processing in similar ways to the <span class="high monosp">|dynamic|</span>,
<span class="high monosp">|static|</span> and similar conditionals (see <a class="link" href="#5.conditionalcontent">5. Conditional Content</a>). If
the value is zero (or empty) document content is excluded. If the value is one
or else non-zero (or not empty) document content is included. The intent is to
allow a value to be set early in the document that then affects what is or
isn't included throughout the rest of the document.
<p> A usage example is the generation of PDF versions of this document. This is
performed using the Safari browser on a macOS desktop. The macOS PDF engine
does a very respectable job of creating a navigable (clickable-link) version
of a document. To attribute the PDF version the following "PDF" FLAG is set at
the beginning of the document and then later used to include the text. The
<span class="high italic">static</span> setting is also used to set document processing appropriately.
Normally set 0, both are modified to 1. Also, the navigation arrows, normally
not <span class="high italic">printed</span>, are a desirable facility in a PDF document, with the setting
changed from 1 to 2 to ensure these are included. The document is then
accessed, printed to PDF, and then set back to the original values.
<div class="blockof asis monosp prewrap">|set|PDF=1|
|set|static=1|
|set|navigate=2|
⋮
|PDF|
// macOS PDF print does a good job of preserving the navigation
|^ This PDF version generated by macOS PDF print from Safari. |
|endif|</div>
<a id="7.2.0.0.0.1" href="#"></a>
<a id="7.2.debugging" href="#"></a>
<a id="debugging" href="#"></a>
<h6 class="head display0"><span class="text">Debugging</span></h6>
<a id="7.2.0.0.0.2" href="#"></a>
<a id="7.2.insights" href="#"></a>
<a id="insights" href="#"></a>
<h6 class="head display0"><span class="text">Insights</span></h6>
<a id="7.3" href="#"></a>
<a id="7.3.documentinsights" href="#"></a>
<a id="documentinsights" href="#"></a>
<h2 class="head"><span class="numb">7.3</span><span class="text">Document Insights</span></h2>
<p> While competent and capable, <span class="high wasdoc">wasDOC</span> is not an application with a
sophisticated user interface and diagnostics. It gets the job done but
sometimes requires significant human analysis when composing the markup.
<div class="note">
<a id="7.3.0.0.1" href="#"></a>
<a id="7.3.themostcommonissue" href="#"></a>
<a id="themostcommonissue" href="#"></a>
<h5 class="head center"><span class="text">The most common issue ...</span></h5>
<hr class="note_hr">
… is either too few or too many tag closures. That is, most tags operate
on intervening text and the end of that text must be indicated with the earlier
described single Vbar plus white-space, or two consecutive Vbars. Miss one (or
multiple) or add too many and <span class="high wasdoc">wasDOC</span> will detect the inbalance at
some stage, report an error, and stop processing. See <a class="link" href="#7.3.stackinsight">‘stack insight’ in 7.3 Document Insights</a> for
how to view the markup stack.
<hr class="note_hr">
</div>
<p> Examining the HTML source will often help, either using the browser
functionality, or the <a class="link" href="#7.3.insightbuttons">‘insight buttons’ in 7.3 Document Insights</a> button. Checking for unbalanced
HTML elements at or about the error report. A table <span class="high monosp"><table></span> not balanced
by a <span class="high monosp"></table></span> for instance.
<p> To assist in this <span class="high bold">insight functionality</span> will provide some embedded
informational data during document processing.
<p> The <span class="highinline monosp"> |set|insight=<span class="high italic"><integer></span>| </span> (<a class="link" href="#7.1.settings">‘Settings’ in 7.1 Control</a>) controls
the facility at a document level. It should be used at the very front of the
document. And the <span class="highinline monosp">?insight=<span class="high italic"><integer></span></span> query string at the
client level (the former overrides the latter). Information is embedded in
<span class="insight">coloured background callouts</span> to the actual
document text in a dynamic document. Integer values 1…5 provide
progressively more detailed insights into the document.
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Level
<th class="tabh">Description
<tr class="tabr">
<tr class="tabr">
<td class="tabd">0
<td class="tabd">disabled
<tr class="tabr">
<td class="tabd">1
<td class="tabd">not disabled but no insights, allows <span class="high monosp">?insight=<span class="high italic"><integer></span></span>
<tr class="tabr">
<td class="tabd">2
<td class="tabd">source file names
<tr class="tabr">
<td class="tabd">3
<td class="tabd">conditional processing
<tr class="tabr">
<td class="tabd">4
<td class="tabd">all highlight and markup tags
<tr class="tabr">
<td class="tabd">5
<td class="tabd">welter more detail
</table>
<p> <span class="high bold">All</span> insight functionality may be disabled by placing
<span class="high monosp">|set|insight=0|</span> at the front of the document.
<a id="7.3.0.0.1.1" href="#"></a>
<a id="7.3.insightquerystring" href="#"></a>
<a id="insightquerystring" href="#"></a>
<h6 class="head display0"><span class="text">insight query string</span></h6>
<a id="7.3.0.0.2" href="#"></a>
<a id="7.3.insightltintegergt" href="#"></a>
<a id="insightltintegergt" href="#"></a>
<h5 class="head monosp"><span class="text">?insight=<span class="high italic"><integer></span></span></h5>
<p> When <span class="highinline monosp"> |set|insight=<span class="high italic"><integer></span>| </span> is one or more, a query
string on a document can be used to control the level of insight provided.
The dynamic version of this document provides a working example.
<a id="7.3.0.0.2.1" href="#"></a>
<a id="7.3.stackinsight" href="#"></a>
<a id="stackinsight" href="#"></a>
<h6 class="head display0"><span class="text">stack insight</span></h6>
<a id="7.3.0.0.3" href="#"></a>
<a id="7.3.verbarinsightverbar" href="#"></a>
<a id="verbarinsightverbar" href="#"></a>
<h5 class="head monosp"><span class="text">|insight!|</span></h5>
<p> <span class="highinline"> This tag inserts the current markup stack which at this stage looks like
this … <span class="insight">☰3 ※</span> ※|/.<integer>|||</span><span class="insight">☰2 ※</span> ※|/.<integer>||\| || is one or more, a query</span><span class="insight">☰1✓ ※</span> ※|inline| This tag inserts the current markup stack which at this stage looks like</span> The ☰ symbol indicates a stack entry, the integer
the stack depth, a following ✓ (tick) that this is the current stack
level, then two strings each introduced with a ※ symbol. The first is
the closure HTML tag and the second the markup that introduced this. </span>
<a id="7.3.0.0.3.1" href="#"></a>
<a id="7.3.insightbuttons" href="#"></a>
<a id="insightbuttons" href="#"></a>
<h6 class="head display0"><span class="text">insight buttons</span></h6>
<a id="7.3.0.0.4" href="#"></a>
<a id="7.3.verbarinsightverbar" href="#"></a>
<a id="verbarinsightverbar" href="#"></a>
<h5 class="head monosp"><span class="text">|insight@|</span></h5>
<p> This tag adds <span class="high _button">TEXT</span> and <span class="high _button">HTML</span> buttons, along with some
basic markup statistics. The <span class="high _button">TEXT</span> button opens a page using the
<span class="high monosp">text=1</span> query showing the original markup text. Use the <span class="high _button">HTML</span>
button to open a page using the <span class="high monosp">html=1</span> query showing the generated HTML as
plain text. Reload the now opened pages to refresh the displayed information.
<!-- source:0800_REFERENCE.WASDOC -->
<hr class="page">
<a id="8." href="#"></a>
<a id="8.quickreference" href="#"></a>
<a id="quickreference" href="#"></a>
<h1 class="head"><span class="numb">8.</span><span class="text">Quick Reference</span></h1>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#7.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a href="#9.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> The term <span class="high italic">closure</span> refers to the need to terminate a tag's effect on
intervening content. As described in <a class="link" href="#2.markupfundamentals">2. Markup Fundamentals</a> the closure is
a vertical bar followed by white-space, or two Vbars if not followed by
white-space. Annotated closure using <span class="high monosp">|!</span> is also available. In these
tables <span class="high italic">required</span> means exactly that, <span class="high italic">none</span> resulting in an error if tried,
and <span class="high italic">implied</span> that the tag contains all the markup data required in itself
(often with a parameter).
<table class="tabl">
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.1" href="#"></a>
<a id="8.highlight" href="#"></a>
<a id="highlight" href="#"></a>
<h5 class="head"><span class="text">Highlight</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh" style="width:12em;">Description
<th class="tabh">Syntax
<th class="tabh">Example
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">bold text
<td class="tabd"><span class="high monosp">|*...|</span>
<td class="tabd"><span class="high bold">bold text</span>
<td class="tabd"><a class="link nowrap" href="#2.2.texthighlight">2.2 Text Highlight</a>
<tr class="tabr">
<td class="tabd">center text
<td class="tabd"><span class="high monosp">|><...|</span>
<td class="tabd center">center text
<tr class="tabr backlight">
<td class="tabd">italicise text
<td class="tabd"><span class="high monosp">|/...|</span>
<td class="tabd" colspan="2"><span class="high italic">italicised text</span>
<tr class="tabr">
<td class="tabd">monospace text
<td class="tabd"><span class="high monosp">|=...|</span>
<td class="tabd" colspan="2"><span class="high monosp">monospaced text</span>
<tr class="tabr backlight">
<td class="tabd">no-wrap text
<td class="tabd"><span class="high monosp">|>>...|</span>
<td class="tabd" colspan="2"><span class="high nowrap">this text will not wrap no matter what!</span>
<tr class="tabr">
<td class="tabd">strike text
<td class="tabd"><span class="high monosp">|-...|</span>
<td class="tabd" colspan="2"><span class="high strike">strike text</span>
<tr class="tabr backlight">
<td class="tabd">underline text
<td class="tabd"><span class="high monosp">|_...|</span>
<td class="tabd" colspan="2"><span class="high under">underlined text</span>
<tr class="tabr">
<td class="tabd">special class text
<td class="tabd"><span class="high monosp">|'<span class="high italic">class=</span>...|</span>
<td class="tabd" colspan="2"><span class="high wasdoc2">wasDOC</span>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.2" href="#"></a>
<a id="8.pagination" href="#"></a>
<a id="pagination" href="#"></a>
<h5 class="head"><span class="text">Pagination</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">paragraph *
<td class="tabd"><span class="high monosp">|^</span><white-space>
<td class="tabd">none
<td class="tabd"><a class="link" href="#2.3.breaks">2.3 Breaks</a>
<tr class="tabr">
<td class="tabd">new line
<td class="tabd"><span class="high monosp">|^-</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<td class="tabd">new page
<td class="tabd"><span class="high monosp">|page|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">new page when printed
<td class="tabd"><span class="high monosp">|ppage|</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<td class="tabd">end of document
<td class="tabd"><span class="high monosp">|epage|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<tr class="tabr">
<td class="tabd" colspan="4"><sup>*</sup>
<span class="high italic">Paragraphs will take a trailing <span class="high monosp"></span> (plus) symbol to indent.</span>
<a id="8.0.0.0.2.1" href="#"></a>
<a id="8.quickreferenceblocks" href="#"></a>
<a id="quickreferenceblocks" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Blocks</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.3" href="#"></a>
<a id="8.blocks" href="#"></a>
<a id="blocks" href="#"></a>
<h5 class="head"><span class="text">Blocks</span></h5>
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">text as written
<td class="tabd"><span class="high monosp">|asis|</span>
<td class="tabd">|||| (four on a line by themselves)
<td class="tabd"><a class="link" href="#2.4.blocks">2.4 Blocks</a>
<tr class="tabr">
<td class="tabd">some text as a block
<td class="tabd"><span class="high monosp">|block|</span>
<td class="tabd" colspan="2">required
<tr class="tabr backlight">
<td class="tabd">code example
<td class="tabd"><span class="high monosp">|code|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">example
<td class="tabd"><span class="high monosp">|example|</span>
<td class="tabd" colspan="2">required
<tr class="tabr backlight">
<td class="tabd">inline text
<td class="tabd"><span class="high monosp">|inline|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">monospace pre-formatted
<td class="tabd"><span class="high monosp">|mono|</span>
<td class="tabd" colspan="2">required
<tr class="tabr backlight">
<td class="tabd">obvious note
<td class="tabd"><span class="high monosp">|note|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">proportional pre-formatted
<td class="tabd"><span class="high monosp">|prop|</span>
<td class="tabd" colspan="2">required
<tr class="tabr backlight">
<td class="tabd">quoted text
<td class="tabd"><span class="high monosp">|quote|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<tr class="tabr">
<td class="tabd" colspan="4"><span class="high italic">All will take additional styling (see <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a>)</span>
<a id="8.0.0.0.3.1" href="#"></a>
<a id="8.quickreferencelists" href="#"></a>
<a id="quickreferencelists" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Lists</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.4" href="#"></a>
<a id="8.lists" href="#"></a>
<a id="lists" href="#"></a>
<h5 class="head"><span class="text">Lists</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">simple
<td class="tabd"><span class="high monosp">|simple|</span>
<td class="tabd">required
<td class="tabd"><a class="link" href="#2.6.lists">2.6 Lists</a>
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|sl|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">numeric
<td class="tabd"><span class="high monosp">|number|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|ol|</span>
<td class="tabd" colspan="2">required
<tr class="tabr backlight">
<td class="tabd">bulleted
<td class="tabd"><span class="high monosp">|bullet|</span>
<td class="tabd" colspan="2">required
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|ul|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">item
<td class="tabd"><span class="high monosp">|item|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|li|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|&</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<tr class="tabr">
<td class="tabd" colspan="4"><span class="high italic">All will take additional styling (see <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a>)</span>
<a id="8.0.0.0.4.1" href="#"></a>
<a id="8.quickreferencetables" href="#"></a>
<a id="quickreferencetables" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Tables</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.5" href="#"></a>
<a id="8.tables" href="#"></a>
<a id="tables" href="#"></a>
<h5 class="head"><span class="text">Tables</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">begin table
<td class="tabd"><span class="high monosp">|table|</span>
<td class="tabd">required
<td class="tabd"><a class="link" href="#3.tables">3. Tables</a>
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|tabular|</span>
<td class="tabd" colspan="2">required
<tr class="tabr">
<td class="tabd">begin row
<td class="tabd"><span class="high monosp">|~</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|tr|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|row|</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<td class="tabd">header cell
<td class="tabd"><span class="high monosp">|:|</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|th|</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|head|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">data cell
<td class="tabd"><span class="high monosp">|.|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|td|</span>
<td class="tabd" colspan="2">none
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|data|</span>
<td class="tabd" colspan="2">none
<tr class="tabr backlight">
<tr class="tabr">
<td class="tabd" colspan="4"><span class="high italic">All will take additional styling (see <a class="link" href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a>)</span>
<a id="8.0.0.0.5.1" href="#"></a>
<a id="8.quickreferencelinks" href="#"></a>
<a id="quickreferencelinks" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Links</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.6" href="#"></a>
<a id="8.links" href="#"></a>
<a id="links" href="#"></a>
<h5 class="head"><span class="text">Links</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">external resource
<td class="tabd"><span class="high monosp">|link|https://host/path|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#4.links">4. Links</a>
<tr class="tabr">
<td class="tabd">external with description
<td class="tabd"><span class="high monosp">|link|https://host/path|\<br>A link to WASD|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">external in new page
<td class="tabd"><span class="high monosp">|link%|https://host/path|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd">internal reference
<td class="tabd"><span class="high monosp">|link|Document Style|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">to equivalent fragment
<td class="tabd"><span class="high monosp">|link|#documentstyle|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd">to another document
<td class="tabd"><span class="high monosp">|link|../doc_two/\<br>#Somewhere Inside It|\<br>This is another document|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">another in new page
<td class="tabd"><span class="high monosp">|link%|../doc_two/\<br>#Somewhere Inside It|\<br>This is another document|</span>
<td class="tabd" colspan="2">implied
<a id="8.0.0.0.6.1" href="#"></a>
<a id="8.quickreferencevarious" href="#"></a>
<a id="quickreferencevarious" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Various</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.7" href="#"></a>
<a id="8.various" href="#"></a>
<a id="various" href="#"></a>
<h5 class="head"><span class="text">Various</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh" style="width:10em;">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">text as-is
<td class="tabd"><span class="high monosp">|=...|</span>
<td class="tabd">required
<td class="tabd"><a class="link" href="#2.8.verbarquotandverbarasisverbar">2.8 |" and |asis|</a>
<tr class="tabr">
<td class="tabd">insert data
<td class="tabd"><span class="high monosp">|insert|<span class="high italic">keyword</span>=|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#2.7.insertion">2.7 Insertion</a>
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|insert|spawn=<span class="high italic">DCL command</span>|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#2.7.1.spawnedcommand">2.7.1 Spawned Command</a>
<tr class="tabr">
<td class="tabd">insert image
<td class="tabd"><span class="high monosp">|image|<span class="high italic">image URI/L</span> </span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#2.10.images">2.10 Images</a>
<tr class="tabr backlight">
<td class="tabd">draw box diagram
<td class="tabd"><span class="high monosp">|draw|
<td class="tabd">required </span>
<td class="tabd"><a class="link" href="#2.11.boxdrawing">2.11 Box Drawing</a>
<tr class="tabr">
<td class="tabd">comment line
<td class="tabd"><span class="high monosp">|//</span>
<td class="tabd">none
<td class="tabd"><a class="link" href="#7.1.control">7.1 Control</a>
<a id="8.0.0.0.7.1" href="#"></a>
<a id="8.quickreferencecontrol" href="#"></a>
<a id="quickreferencecontrol" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Control</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.8" href="#"></a>
<a id="8.control" href="#"></a>
<a id="control" href="#"></a>
<h5 class="head"><span class="text">Control</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">break source
<td class="tabd"><span class="high monosp">|break|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd">exit document processing
<td class="tabd"><span class="high monosp">|exit|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd nowrap">tag stack
<td class="tabd"><span class="high monosp">|insight!|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#7.3.documentinsights">7.3 Document Insights</a>
<tr class="tabr">
<td class="tabd nowrap">text and HTML reveal
<td class="tabd"><span class="high monosp">|insight@|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">only when printed
<td class="tabd"><span class="high monosp">|print|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd">omit when printed
<td class="tabd"><span class="high monosp">|noprint|</span>
<td class="tabd" colspan="2">implied
<a id="8.0.0.0.8.1" href="#"></a>
<a id="8.quickreferencesettings" href="#"></a>
<a id="quickreferencesettings" href="#"></a>
<h6 class="head display0"><span class="text">Quick Reference Settings</span></h6>
<tr class="tabr">
<th class="tabh" colspan="4"><a id="8.0.0.0.9" href="#"></a>
<a id="8.settings" href="#"></a>
<a id="settings" href="#"></a>
<h5 class="head"><span class="text">Settings</span></h5>
<tr class="tabr">
<tr class="tabr under">
<th class="tabh">Description
<th class="tabh">Syntax
<th class="tabh">Closure
<th class="tabh">Reference
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd nowrap">document in major sections
<td class="tabd"><span class="high monosp">|set|chunked=-1|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#7.1.settings">‘Settings’ in 7.1 Control</a>
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|chunked=0|</span>
<td class="tabd" colspan="2">
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|chunked=1|</span>
<td class="tabd" colspan="2">
<tr class="tabr">
<td class="tabd nowrap">index of content columns
<td class="tabd nowrap"><span class="high monosp">|set|idx=cols=<span class="high italic">integer</span>|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#6.4.documentindex">6.4 Document Index</a>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|idx=collate=|</span>
<td class="tabd" colspan="2">
<tr class="tabr backlight">
<td class="tabd nowrap">informational content
<td class="tabd nowrap"><span class="high monosp">|set|insight=<span class="high italic">integer</span>|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#7.3.documentinsights">7.3 Document Insights</a>
<tr class="tabr">
<td class="tabd">localization
<td class="tabd"><span class="high monosp">|set|locale=<span class="high italic">string</span>|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">navigation arrows
<td class="tabd"><span class="high monosp">|set|navigate=0|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|navigate=1|</span>
<td class="tabd" colspan="2">
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|navigate=2|</span>
<td class="tabd" colspan="2">
<tr class="tabr">
<td class="tabd">default note heading
<td class="tabd"><span class="high monosp">|set|note=Attention!|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">pagination
<td class="tabd"><span class="high monosp">|set|paginate=1|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd">dynamic review period
<td class="tabd"><span class="high monosp">|set|review=<span class="high italic">number</span>|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">document as if static
<td class="tabd"><span class="high monosp">|set|static=1|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd">set default table margin
<td class="tabd"><span class="high monosp">|set|table=<span class="high italic">flag</span>|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr backlight">
<td class="tabd">explicit document title
<td class="tabd"><span class="high monosp">|set|title=This Is The Title|</span>
<td class="tabd" colspan="2">implied
<tr class="tabr">
<td class="tabd nowrap">table of content columns
<td class="tabd nowrap"><span class="high monosp">|set|toc=cols=<span class="high italic">integer</span>|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#6.1.primarytoc">6.1 Primary TOC</a>
<tr class="tabr">
<td class="tabd nowrap">table of content format
<td class="tabd nowrap"><span class="high monosp">|set|toc=format=<span class="high italic">string</span>|</span>
<td class="tabd" colspan="2">
<tr class="tabr backlight">
<td class="tabd">secondary TOC
<td class="tabd"><span class="high monosp">|set|toc2=1|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#6.2.secondarytoc">6.2 Secondary TOC</a>
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|toc2=2|</span>
<td class="tabd" colspan="2">
<tr class="tabr backlight">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|toc2=cols=|</span>
<td class="tabd" colspan="2">
<tr class="tabr">
<td class="tabd">set a FLAG value
<td class="tabd"><span class="high monosp">|set|AFLAG=<span class="high italic">integer</span>|</span>
<td class="tabd">implied
<td class="tabd"><a class="link" href="#7.2.flags">7.2 FLAGs</a>
<tr class="tabr">
<td class="tabd">
<td class="tabd"><span class="high monosp">|set|AFLAG=<span class="high italic">string</span>|</span>
<td class="tabd" colspan="2"></table>
<!-- source:0900_END.WASDOC -->
<a id="8.0.0.0.9.1" href="#"></a>
<a id="8.thedocumentindex" href="#"></a>
<a id="thedocumentindex" href="#"></a>
<h6 class="head display0"><span class="text">The Document Index</span></h6>
<hr class="page">
<a id="9." href="#"></a>
<a id="9.index" href="#"></a>
<a id="index" href="#"></a>
<h1 class="head"><span class="numb">9.</span><span class="text">Index</span></h1>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#8.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a>↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<div class="IDXcols2">
<table class="IDXtable">
<tr><td class="alpha">A</td><td class="text"><a href="#2.anoteregardingtheuseoftheverbarverticalbarsymbolampbackslashcharacterexplicitverbarthisverbar">‘A note regarding the use of the | vertical bar symbol & \ backslash character (explicit |this|)’ in 2. Markup Fundamentals</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.aparagraph">‘a paragraph!’ in 2. Markup Fundamentals</a>
<tr><td class="alpha"> </td><td class="text"><a href="#0.apachelicenseversion20">‘Apache License, Version 2.0’ in WASD Documentation Processor</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.1.apacheserver">‘Apache server’ in 1.2.1 Dynamic Document</a>
<tr><td class="alpha">B</td><td class="text"><a href="#2.4.blocks">2.4 Blocks</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.blocks">‘Blocks’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.3.blocksoftext">‘Blocks of Text’ in 2.3 Breaks</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.11.boxdrawing">2.11 Box Drawing</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.3.breaks">2.3 Breaks</a>
<tr><td class="alpha">C</td><td class="text"><a href="#2.11.cascadingstylesheetscss">‘Cascading Style Sheets (CSS)’ in 2.11 Box Drawing</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.6.chapterinsertion">‘Chapter Insertion’ in 2.6 Lists</a>
<tr><td class="alpha"> </td><td class="text"><a href="#3.chapterlinks">‘Chapter Links’ in 3. Tables</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.1.characterset">‘character set’ in 7.1 Control</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.2.clustersystemdata">‘Cluster System Data’ in 2.7.2 FLAG Insertion</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.conditionalcontent">5. Conditional Content</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.conditionalkeywordmatch">‘Conditional keyword match’ in 5. Conditional Content</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.1.conditionalregularexpressionmatch">‘Conditional regular expression match’ in 5.1 Match Conditional</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.1.control">7.1 Control</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.control">‘Control’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.11.css">‘CSS’ in 2.11 Box Drawing</a>
<tr><td class="alpha">D</td><td class="text"><a href="#7.2.debugging">‘Debugging’ in 7.2 FLAGs</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.deployingwasdoc">1.2 Deploying wasDOC</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.1.documentauthorisation">‘Document Authorisation’ in 2.7.1 Spawned Command</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.documentconstruction">7. Document Construction</a>
<tr><td class="alpha"> </td><td class="text"><a href="#0.documentformats">‘document formats’ in WASD Documentation Processor</a>
<tr><td class="alpha"> </td><td class="text"><a href="#6.4.documentindex">6.4 Document Index</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.3.documentinsights">7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#6.documentnavigation">6. Document Navigation</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.3.documentnavigation2">‘Document Navigation 2’ in 5.3 Time Conditional</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.1.documentsections">2.1 Document Sections</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.12.documentstyle">2.12 Document Style</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.11.drawingcharacters">‘Drawing Characters’ in 2.11 Box Drawing</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.1.dynamicdocument">1.2.1 Dynamic Document</a>
<tr><td class="alpha">E</td><td class="text"><a href="#2.2.explicitclass">‘Explicit Class’ in 2.2 Text Highlight</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.5.explicitnoteheading">‘Explicit Note Heading’ in 2.5 Notes</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.2.explicitstyling">‘Explicit Styling’ in 2.2 Text Highlight</a>
<tr><td class="alpha">F</td><td class="text"><a href="#2.7.2.flaginsertion">2.7.2 FLAG Insertion</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.2.flags">7.2 FLAGs</a>
<tr><td class="alpha">H</td><td class="text"><a href="#2.1.headingcrossreference">‘Heading Cross-Reference’ in 2.1 Document Sections</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.highlight">‘Highlight’ in 8. Quick Reference</a>
<tr><td class="alpha">I</td><td class="text"><a href="#7.3.verbarinsightverbar">‘|insight!|’ in 7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.3.verbarinsightverbar">‘|insight@|’ in 7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.10.images">2.10 Images</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.1.inwasdsinimitablestyleofcoursenbsp">‘In WASD's inimitable style of course ’ in 1.1 YAML (Yet Another Markup Language)</a>
<tr><td class="alpha"> </td><td class="text"><a href="#9.index">9. Index</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.2.insertsystemdata">‘Insert System Data’ in 2.7.2 FLAG Insertion</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.insertion">2.7 Insertion</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.3.insightbuttons">‘insight buttons’ in 7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.3.insightquerystring">‘insight query string’ in 7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.2.insights">‘Insights’ in 7.2 FLAGs</a>
<tr><td class="alpha">L</td><td class="text"><a href="#1.2.1.largedocument">‘Large Document’ in 1.2.1 Dynamic Document</a>
<tr><td class="alpha"> </td><td class="text"><a href="#0.license">‘License’ in WASD Documentation Processor</a>
<tr><td class="alpha"> </td><td class="text"><a href="#4.links">4. Links</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.links">‘Links’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#4.2.linkstootherdocuments">4.2 Links to Other Documents</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.6.lists">2.6 Lists</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.lists">‘Lists’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.1.localeinparticularcharacterset">‘Locale, in particular character set’ in 7.1 Control</a>
<tr><td class="alpha">M</td><td class="text"><a href="#2.markupfundamentals">2. Markup Fundamentals</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.1.matchconditional">5.1 Match Conditional</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.1.1.matchingoperators">‘Matching Operators’ in 5.1.1 Regex Basics</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.2.multipartdocument">‘Multipart Document’ in 1.2.2 Static Document</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.12.multipartstyles">‘Multipart Styles’ in 2.12 Document Style</a>
<tr><td class="alpha">N</td><td class="text"><a href="#6.3.navigationicons">6.3 Navigation Icons</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.5.note">‘Note’ in 2.5 Notes</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.5.notes">2.5 Notes</a>
<tr><td class="alpha">O</td><td class="text"><a href="#5.1.1.operatoroverview">‘Operator Overview’ in 5.1.1 Regex Basics</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.1.osuserver">‘OSU server’ in 1.2.1 Dynamic Document</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.1.otherwasdocadvantages">‘Other wasDOC Advantages’ in 1.1 YAML (Yet Another Markup Language)</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.9.othermarkup">2.9 Other Markup</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.1.1.othersectionnumbers">2.1.1 Other Section Numbers</a>
<tr><td class="alpha">P</td><td class="text"><a href="#8.pagination">‘Pagination’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#6.1.primarytoc">6.1 Primary TOC</a>
<tr><td class="alpha">Q</td><td class="text"><a href="#8.quickreference">8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferenceblocks">‘Quick Reference Blocks’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferencecontrol">‘Quick Reference Control’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferencelinks">‘Quick Reference Links’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferencelists">‘Quick Reference Lists’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferencesettings">‘Quick Reference Settings’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferencetables">‘Quick Reference Tables’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.quickreferencevarious">‘Quick Reference Various’ in 8. Quick Reference</a>
<tr><td class="alpha">R</td><td class="text"><a href="#3.r">‘R...’ in 3. Tables</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.1.1.regexbasics">5.1.1 Regex Basics</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.1.1.repetitionoperators">‘Repetition Operators’ in 5.1.1 Regex Basics</a>
<tr><td class="alpha">S</td><td class="text"><a href="#6.2.secondarytoc">6.2 Secondary TOC</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.1.sectionnumber0">‘section number 0’ in 2.1 Document Sections</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.1.sectionnumber9">‘section number 9’ in 2.1 Document Sections</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.1.sectionnumbers14">‘section numbers 1...4’ in 2.1 Document Sections</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.1.settings">‘Settings’ in 7.1 Control</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.settings">‘Settings’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.2.spawnconditional">5.2 Spawn Conditional</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.1.spawnedcommand">2.7.1 Spawned Command</a>
<tr><td class="alpha"> </td><td class="text"><a href="#4.2.specificsectionofwholedocument">‘Specific Section of Whole Document’ in 4.2 Links to Other Documents</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.3.stackinsight">‘stack insight’ in 7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#4.2.startofdocument">‘Start of Document’ in 4.2 Links to Other Documents</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.2.staticdocument">1.2.2 Static Document</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.2.2.staticinsight">‘Static Insight’ in 1.2.2 Static Document</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.11.stylesheets">‘style sheets’ in 2.11 Box Drawing</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.3.systemdata">2.7.3 System Data</a>
<tr><td class="alpha">T</td><td class="text"><a href="#0.tableofcontent">‘Table of Content’ in WASD Documentation Processor</a>
<tr><td class="alpha"> </td><td class="text"><a href="#3.tablerowhighlight">‘table row highlight’ in 3. Tables</a>
<tr><td class="alpha"> </td><td class="text"><a href="#3.tables">3. Tables</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.tables">‘Tables’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#3.tabularexample">‘tabular example’ in 3. Tables</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.2.texthighlight">2.2 Text Highlight</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.7.3.textjustasitis">‘text just as it is’ in 2.7.3 System Data</a>
<tr><td class="alpha"> </td><td class="text"><a href="#8.thedocumentindex">‘The Document Index’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#4.1.theessentialfragment">4.1 The Essential Fragment</a>
<tr><td class="alpha"> </td><td class="text"><a href="#7.3.themostcommonissue">‘The most common issue ...’ in 7.3 Document Insights</a>
<tr><td class="alpha"> </td><td class="text"><a href="#5.3.timeconditional">5.3 Time Conditional</a>
<tr><td class="alpha"> </td><td class="text"><a href="#6.1.tocnumbering">‘TOC Numbering’ in 6.1 Primary TOC</a>
<tr><td class="alpha">V</td><td class="text"><a href="#8.various">‘Various’ in 8. Quick Reference</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.vbarsandescapes">‘Vbars and Escapes’ in 2. Markup Fundamentals</a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.9.vbarscanbemessy">‘Vbars can be messy...’ in 2.9 Other Markup</a>
<tr><td class="alpha">W</td><td class="text"><a href="#0.wasddocumentationprocessor">‘WASD Documentation Processor’ in WASD Documentation Processor</a>
<tr><td class="alpha"> </td><td class="text"><a href="#1.wasddocumentationprocessormdashwasdoc">1. WASD Documentation Processor — wasDOC </a>
<tr><td class="alpha"> </td><td class="text"><a href="#2.whythevbar">‘Why the Vbar?’ in 2. Markup Fundamentals</a>
<tr><td class="alpha">Y</td><td class="text"><a href="#1.1.yamlyetanothermarkuplanguage">1.1 YAML (Yet Another Markup Language)</a>
<tr><td class="alpha">6</td><td class="text"><a href="#6.1.611obscureembellishments">‘6.1.1 ......... Obscure Embellishments’ in 6.1 Primary TOC</a>
<tr><td class="alpha">9</td><td class="text"><a href="#6.4.verbar9verbar">‘|9...|’ in 6.4 Document Index</a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="#8.">↖︎</a>
<td><a href="#0.">↑︎</a>
<td><a>↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<title>WASD Documentation Processor</title>