From d4598ce0f91f1ccf6e62ca644ed26fe7a27a887b Mon Sep 17 00:00:00 2001 From: Arseniy Zaostrovnykh Date: Wed, 27 Jan 2021 13:42:22 +0100 Subject: [PATCH] make in-line code blocks verbatim --- rules/S100/abap/rule.adoc | 2 +- rules/S100/apex/rule.adoc | 2 +- rules/S100/cfamily/rule.adoc | 2 +- rules/S100/csharp/rule.adoc | 10 +- rules/S100/go/rule.adoc | 2 +- rules/S100/java/rule.adoc | 2 +- rules/S100/javascript/rule.adoc | 2 +- rules/S100/php/rule.adoc | 4 +- rules/S100/python/rule.adoc | 2 +- rules/S100/rpg/rule.adoc | 2 +- rules/S1003/rule.adoc | 2 +- rules/S1005/plsql/rule.adoc | 2 +- rules/S1009/rule.adoc | 2 +- rules/S101/abap/rule.adoc | 2 +- rules/S101/apex/rule.adoc | 2 +- rules/S101/cfamily/rule.adoc | 2 +- rules/S101/csharp/rule.adoc | 8 +- rules/S101/flex/rule.adoc | 2 +- rules/S101/go/rule.adoc | 2 +- rules/S101/noncompliant.adoc | 2 +- rules/S101/python/rule.adoc | 2 +- rules/S101/ruby/rule.adoc | 2 +- rules/S101/vbnet/rule.adoc | 2 +- rules/S1012/rule.adoc | 2 +- rules/S1013/rule.adoc | 2 +- rules/S1016/rule.adoc | 2 +- rules/S1017/rule.adoc | 4 +- rules/S1019/rule.adoc | 4 +- rules/S1027/rule.adoc | 2 +- rules/S1035/rule.adoc | 2 +- rules/S1036/rule.adoc | 6 +- rules/S1039/cfamily/rule.adoc | 2 +- rules/S1039/description.adoc | 4 +- rules/S1040/rule.adoc | 2 +- rules/S1041/compliant.adoc | 2 +- rules/S1041/plsql/rule.adoc | 2 +- rules/S1045/description.adoc | 2 +- rules/S1045/php/rule.adoc | 8 +- rules/S1045/python/rule.adoc | 10 +- rules/S1046/description.adoc | 4 +- rules/S1050/rule.adoc | 2 +- rules/S1052/rule.adoc | 2 +- rules/S1053/rule.adoc | 4 +- rules/S1055/rule.adoc | 2 +- rules/S1056/rule.adoc | 4 +- rules/S1057/rule.adoc | 2 +- rules/S1058/rule.adoc | 4 +- rules/S1059/rule.adoc | 2 +- rules/S106/csharp/rule.adoc | 4 +- rules/S1062/rule.adoc | 2 +- rules/S1066/cobol/rule.adoc | 2 +- rules/S1066/description.adoc | 2 +- rules/S1067/abap/rule.adoc | 2 +- rules/S1067/apex/rule.adoc | 2 +- rules/S1067/description.adoc | 2 +- rules/S1067/java/rule.adoc | 2 +- rules/S1067/rpg/rule.adoc | 2 +- rules/S1067/scala/rule.adoc | 2 +- rules/S1067/tsql/rule.adoc | 2 +- rules/S1067/vb6/rule.adoc | 2 +- rules/S1068/description.adoc | 2 +- rules/S1068/java/rule.adoc | 8 +- rules/S107/java/rule.adoc | 10 +- rules/S107/kotlin/rule.adoc | 2 +- rules/S107/python/rule.adoc | 2 +- rules/S1070/rule.adoc | 2 +- rules/S1071/rule.adoc | 2 +- rules/S1074/rule.adoc | 2 +- rules/S1075/csharp/rule.adoc | 6 +- rules/S1077/rule.adoc | 14 +- rules/S1079/rule.adoc | 6 +- rules/S108/go/rule.adoc | 2 +- rules/S108/java/rule.adoc | 2 +- rules/S108/javascript/rule.adoc | 2 +- rules/S108/kotlin/rule.adoc | 2 +- rules/S108/ruby/rule.adoc | 2 +- rules/S1081/rule.adoc | 6 +- rules/S1082/rule.adoc | 14 +- rules/S1083/rule.adoc | 28 ++-- rules/S1085/rule.adoc | 24 ++-- rules/S1086/rule.adoc | 2 +- rules/S1087/rule.adoc | 4 +- rules/S1088/rule.adoc | 4 +- rules/S109/cfamily/rule.adoc | 2 +- rules/S109/csharp/rule.adoc | 2 +- rules/S109/java/rule.adoc | 2 +- rules/S1090/rule.adoc | 2 +- rules/S1091/rule.adoc | 4 +- rules/S1092/rule.adoc | 4 +- rules/S1093/rule.adoc | 2 +- rules/S1094/rule.adoc | 2 +- rules/S1095/rule.adoc | 4 +- rules/S1096/rule.adoc | 2 +- rules/S1097/rule.adoc | 14 +- rules/S1099/rule.adoc | 2 +- rules/S110/description.adoc | 2 +- rules/S110/java/rule.adoc | 14 +- rules/S1100/rule.adoc | 8 +- rules/S1102/rule.adoc | 10 +- rules/S1103/description.adoc | 4 +- rules/S1103/plsql/rule.adoc | 2 +- rules/S1104/csharp/rule.adoc | 4 +- rules/S1104/exceptions.adoc | 2 +- rules/S1104/java/rule.adoc | 2 +- rules/S1107/rule.adoc | 2 +- rules/S1108/rule.adoc | 2 +- rules/S1110/cfamily/rule.adoc | 2 +- rules/S1113/rule.adoc | 2 +- rules/S1114/rule.adoc | 4 +- rules/S1116/css/rule.adoc | 2 +- rules/S1116/description.adoc | 4 +- rules/S1116/javascript/rule.adoc | 4 +- rules/S1116/vb6/rule.adoc | 4 +- rules/S1117/swift/rule.adoc | 2 +- rules/S1118/csharp/rule.adoc | 4 +- rules/S1118/java/rule.adoc | 4 +- rules/S112/cfamily/rule.adoc | 4 +- rules/S112/csharp/rule.adoc | 2 +- rules/S112/description.adoc | 2 +- rules/S112/python/rule.adoc | 10 +- rules/S112/vbnet/rule.adoc | 2 +- rules/S1121/java/rule.adoc | 2 +- rules/S1121/php/rule.adoc | 2 +- rules/S1123/cfamily/rule.adoc | 2 +- rules/S1123/csharp/rule.adoc | 2 +- rules/S1123/description.adoc | 6 +- rules/S1125/javascript/rule.adoc | 2 +- rules/S1125/php/rule.adoc | 2 +- rules/S1126/description.adoc | 2 +- rules/S1126/java/rule.adoc | 4 +- rules/S1126/javascript/rule.adoc | 2 +- rules/S1126/vb6/rule.adoc | 2 +- rules/S1128/csharp/rule.adoc | 2 +- rules/S1128/css/rule.adoc | 2 +- rules/S1130/rule.adoc | 8 +- rules/S1132/rule.adoc | 2 +- rules/S1134/description.adoc | 2 +- rules/S1137/rule.adoc | 2 +- rules/S1138/description.adoc | 2 +- rules/S1139/abap/rule.adoc | 2 +- rules/S1139/description.adoc | 6 +- rules/S114/abap/rule.adoc | 2 +- rules/S114/noncompliant.adoc | 2 +- rules/S114/php/rule.adoc | 2 +- rules/S114/swift/rule.adoc | 2 +- rules/S114/vbnet/rule.adoc | 2 +- rules/S1141/cfamily/rule.adoc | 2 +- rules/S1141/description.adoc | 2 +- rules/S1143/cfamily/rule.adoc | 2 +- rules/S1143/description.adoc | 4 +- rules/S1143/javascript/rule.adoc | 4 +- rules/S1143/python/rule.adoc | 12 +- rules/S1144/csharp/rule.adoc | 10 +- rules/S1144/description.adoc | 2 +- rules/S1144/java/rule.adoc | 4 +- rules/S1144/python/rule.adoc | 4 +- rules/S1145/description.adoc | 4 +- rules/S1145/plsql/rule.adoc | 2 +- rules/S1147/csharp/rule.adoc | 4 +- rules/S1147/java/rule.adoc | 4 +- rules/S1147/pli/rule.adoc | 2 +- rules/S1147/vbnet/rule.adoc | 2 +- rules/S1148/rule.adoc | 6 +- rules/S1149/rule.adoc | 10 +- rules/S115/flex/rule.adoc | 2 +- rules/S115/java/rule.adoc | 2 +- rules/S115/php/rule.adoc | 2 +- rules/S115/plsql/rule.adoc | 2 +- rules/S115/swift/rule.adoc | 2 +- rules/S115/vb6/rule.adoc | 2 +- rules/S1151/apex/rule.adoc | 4 +- rules/S1151/cfamily/rule.adoc | 2 +- rules/S1151/description.adoc | 2 +- rules/S1151/kotlin/rule.adoc | 2 +- rules/S1151/plsql/rule.adoc | 2 +- rules/S1151/rpg/rule.adoc | 2 +- rules/S1151/ruby/rule.adoc | 2 +- rules/S1151/scala/rule.adoc | 2 +- rules/S1151/tsql/rule.adoc | 2 +- rules/S1151/vb6/rule.adoc | 2 +- rules/S1151/vbnet/rule.adoc | 2 +- rules/S1153/rule.adoc | 4 +- rules/S1155/cfamily/rule.adoc | 2 +- rules/S1155/csharp/rule.adoc | 6 +- rules/S1155/description.adoc | 2 +- rules/S1155/php/rule.adoc | 2 +- rules/S1155/swift/rule.adoc | 2 +- rules/S1157/rule.adoc | 2 +- rules/S1158/rule.adoc | 4 +- rules/S116/cfamily/rule.adoc | 2 +- rules/S116/csharp/rule.adoc | 2 +- rules/S116/flex/rule.adoc | 2 +- rules/S116/java/rule.adoc | 2 +- rules/S116/php/rule.adoc | 2 +- rules/S116/python/rule.adoc | 2 +- rules/S116/swift/rule.adoc | 2 +- rules/S1161/rule.adoc | 4 +- rules/S1163/description.adoc | 2 +- rules/S1165/rule.adoc | 4 +- rules/S1166/exceptions.adoc | 2 +- rules/S1168/csharp/rule.adoc | 2 +- rules/S1168/description.adoc | 4 +- rules/S117/apex/rule.adoc | 2 +- rules/S117/cfamily/rule.adoc | 4 +- rules/S117/flex/rule.adoc | 2 +- rules/S117/go/rule.adoc | 2 +- rules/S117/java/rule.adoc | 4 +- rules/S117/javascript/rule.adoc | 2 +- rules/S117/php/rule.adoc | 2 +- rules/S117/plsql/rule.adoc | 2 +- rules/S117/tsql/rule.adoc | 2 +- rules/S117/vbnet/rule.adoc | 2 +- rules/S1170/description.adoc | 4 +- rules/S1170/flex/rule.adoc | 2 +- rules/S1172/cfamily/rule.adoc | 2 +- rules/S1172/csharp/rule.adoc | 8 +- rules/S1172/flex/rule.adoc | 2 +- rules/S1172/java/rule.adoc | 8 +- rules/S1172/javascript/rule.adoc | 2 +- rules/S1172/vbnet/rule.adoc | 6 +- rules/S1174/rule.adoc | 2 +- rules/S1175/rule.adoc | 8 +- rules/S1176/flex/rule.adoc | 2 +- rules/S1176/java/rule.adoc | 28 ++-- rules/S118/rule.adoc | 4 +- rules/S1181/cfamily/rule.adoc | 10 +- rules/S1181/description.adoc | 4 +- rules/S1182/rule.adoc | 18 +-- rules/S1185/csharp/rule.adoc | 2 +- rules/S1185/description.adoc | 2 +- rules/S1186/csharp/rule.adoc | 6 +- rules/S1186/flex/rule.adoc | 2 +- rules/S1186/java/rule.adoc | 2 +- rules/S1186/php/rule.adoc | 2 +- rules/S1186/python/rule.adoc | 2 +- rules/S1186/vbnet/rule.adoc | 6 +- rules/S119/swift/rule.adoc | 2 +- rules/S1190/rule.adoc | 6 +- rules/S1191/rule.adoc | 2 +- rules/S1192/cobol/rule.adoc | 2 +- rules/S1192/javascript/rule.adoc | 2 +- rules/S1194/rule.adoc | 2 +- rules/S120/flex/rule.adoc | 2 +- rules/S120/java/rule.adoc | 2 +- rules/S1201/rule.adoc | 4 +- rules/S1206/csharp/rule.adoc | 4 +- rules/S1206/description.adoc | 6 +- rules/S121/pli/rule.adoc | 2 +- rules/S121/tsql/rule.adoc | 2 +- rules/S1210/csharp/rule.adoc | 4 +- rules/S1210/description.adoc | 6 +- rules/S1212/rule.adoc | 6 +- rules/S1215/csharp/rule.adoc | 4 +- rules/S1215/description.adoc | 8 +- rules/S1217/rule.adoc | 4 +- rules/S122/cfamily/rule.adoc | 2 +- rules/S1221/rule.adoc | 4 +- rules/S1226/cfamily/rule.adoc | 2 +- rules/S1226/description.adoc | 2 +- rules/S1226/vbnet/rule.adoc | 4 +- rules/S1227/description.adoc | 2 +- rules/S1228/rule.adoc | 2 +- rules/S1231/rule.adoc | 4 +- rules/S1232/rule.adoc | 4 +- rules/S1235/rule.adoc | 4 +- rules/S1236/rule.adoc | 2 +- rules/S1238/cfamily/rule.adoc | 2 +- rules/S124/cobol/rule.adoc | 4 +- rules/S124/description.adoc | 4 +- rules/S124/java/rule.adoc | 6 +- rules/S124/javascript/rule.adoc | 2 +- rules/S1244/cfamily/rule.adoc | 6 +- rules/S1244/csharp/rule.adoc | 4 +- rules/S1244/description.adoc | 4 +- rules/S1244/java/rule.adoc | 6 +- rules/S1244/swift/rule.adoc | 4 +- rules/S1250/rule.adoc | 4 +- rules/S1258/description.adoc | 2 +- rules/S1258/java/rule.adoc | 2 +- rules/S1259/rule.adoc | 2 +- rules/S126/abap/rule.adoc | 10 +- rules/S126/apex/rule.adoc | 2 +- rules/S126/cfamily/rule.adoc | 2 +- rules/S126/description.adoc | 6 +- rules/S126/go/rule.adoc | 2 +- rules/S126/kotlin/rule.adoc | 2 +- rules/S126/php/rule.adoc | 2 +- rules/S126/plsql/rule.adoc | 10 +- rules/S126/rpg/rule.adoc | 6 +- rules/S126/ruby/rule.adoc | 8 +- rules/S126/scala/rule.adoc | 8 +- rules/S126/tsql/rule.adoc | 6 +- rules/S126/vbnet/rule.adoc | 6 +- rules/S1262/rule.adoc | 4 +- rules/S1264/description.adoc | 2 +- rules/S1264/javascript/rule.adoc | 2 +- rules/S1265/rule.adoc | 2 +- rules/S1269/rule.adoc | 4 +- rules/S127/description.adoc | 4 +- rules/S1270/rule.adoc | 2 +- rules/S1271/rule.adoc | 2 +- rules/S1274/rule.adoc | 2 +- rules/S1275/rule.adoc | 2 +- rules/S1276/rule.adoc | 4 +- rules/S1277/rule.adoc | 2 +- rules/S1279/rule.adoc | 2 +- rules/S1283/rule.adoc | 2 +- rules/S1289/rule.adoc | 2 +- rules/S1290/rule.adoc | 2 +- rules/S1291/rule.adoc | 4 +- rules/S1292/rule.adoc | 2 +- rules/S1293/rule.adoc | 2 +- rules/S1301/abap/rule.adoc | 4 +- rules/S1301/cfamily/rule.adoc | 10 +- rules/S1301/csharp/rule.adoc | 4 +- rules/S1301/description.adoc | 4 +- rules/S1301/javascript/rule.adoc | 4 +- rules/S1301/vb6/rule.adoc | 4 +- rules/S1306/rule.adoc | 2 +- rules/S1307/rule.adoc | 4 +- rules/S1308/rule.adoc | 2 +- rules/S1309/csharp/rule.adoc | 2 +- rules/S1309/description.adoc | 2 +- rules/S131/abap/rule.adoc | 2 +- rules/S131/apex/rule.adoc | 2 +- rules/S131/cfamily/rule.adoc | 2 +- rules/S131/cobol/rule.adoc | 2 +- rules/S131/csharp/rule.adoc | 2 +- rules/S131/description.adoc | 2 +- rules/S131/java/rule.adoc | 2 +- rules/S131/kotlin/rule.adoc | 2 +- rules/S131/php/rule.adoc | 2 +- rules/S131/pli/rule.adoc | 2 +- rules/S131/plsql/rule.adoc | 2 +- rules/S131/ruby/rule.adoc | 2 +- rules/S131/scala/rule.adoc | 2 +- rules/S131/tsql/rule.adoc | 2 +- rules/S131/vb6/rule.adoc | 2 +- rules/S131/vbnet/rule.adoc | 2 +- rules/S1311/abap/rule.adoc | 2 +- rules/S1311/java/rule.adoc | 2 +- rules/S1312/description.adoc | 6 +- rules/S1312/flex/rule.adoc | 8 +- rules/S1312/java/rule.adoc | 10 +- rules/S1313/exceptions.adoc | 2 +- rules/S1316/rule.adoc | 2 +- rules/S1317/rule.adoc | 4 +- rules/S1319/rule.adoc | 6 +- rules/S1320/rule.adoc | 22 +-- rules/S1321/description.adoc | 4 +- rules/S1321/flex/rule.adoc | 2 +- rules/S133/java/rule.adoc | 2 +- rules/S134/abap/rule.adoc | 2 +- rules/S134/cfamily/rule.adoc | 2 +- rules/S134/cobol/rule.adoc | 2 +- rules/S134/csharp/rule.adoc | 2 +- rules/S134/description.adoc | 2 +- rules/S134/flex/rule.adoc | 2 +- rules/S134/kotlin/rule.adoc | 2 +- rules/S134/pli/rule.adoc | 2 +- rules/S134/plsql/rule.adoc | 2 +- rules/S134/python/rule.adoc | 2 +- rules/S134/rpg/rule.adoc | 2 +- rules/S134/ruby/rule.adoc | 2 +- rules/S134/scala/rule.adoc | 2 +- rules/S134/swift/rule.adoc | 2 +- rules/S134/tsql/rule.adoc | 2 +- rules/S134/vbnet/rule.adoc | 2 +- rules/S135/abap/rule.adoc | 4 +- rules/S135/description.adoc | 4 +- rules/S139/vb6/rule.adoc | 2 +- rules/S139/vbnet/rule.adoc | 2 +- rules/S140/cfamily/rule.adoc | 2 +- rules/S140/pli/rule.adoc | 2 +- rules/S140/plsql/rule.adoc | 2 +- rules/S1437/rule.adoc | 4 +- rules/S1438/description.adoc | 2 +- rules/S1438/swift/rule.adoc | 2 +- rules/S1439/description.adoc | 2 +- rules/S1439/javascript/rule.adoc | 2 +- rules/S1440/description.adoc | 4 +- rules/S1440/javascript/rule.adoc | 2 +- rules/S1442/description.adoc | 2 +- rules/S1442/flex/rule.adoc | 2 +- rules/S1443/rule.adoc | 2 +- rules/S1444/description.adoc | 2 +- rules/S1444/java/rule.adoc | 2 +- rules/S1445/rule.adoc | 2 +- rules/S1449/csharp/rule.adoc | 4 +- rules/S1449/description.adoc | 4 +- rules/S1451/csharp/rule.adoc | 4 +- rules/S1451/rpg/rule.adoc | 2 +- rules/S1451/vbnet/rule.adoc | 4 +- rules/S1459/rule.adoc | 2 +- rules/S1465/rule.adoc | 2 +- rules/S1471/rule.adoc | 2 +- rules/S1474/rule.adoc | 2 +- rules/S1475/rule.adoc | 2 +- rules/S1476/rule.adoc | 2 +- rules/S1478/rule.adoc | 2 +- rules/S1479/cobol/rule.adoc | 2 +- rules/S1479/csharp/rule.adoc | 4 +- rules/S1479/description.adoc | 2 +- rules/S1479/java/rule.adoc | 2 +- rules/S1479/kotlin/rule.adoc | 2 +- rules/S1479/plsql/rule.adoc | 2 +- rules/S1479/ruby/rule.adoc | 2 +- rules/S1479/scala/rule.adoc | 2 +- rules/S1479/tsql/rule.adoc | 2 +- rules/S1479/vb6/rule.adoc | 2 +- rules/S1479/vbnet/rule.adoc | 4 +- rules/S1481/csharp/rule.adoc | 2 +- rules/S1481/python/rule.adoc | 2 +- rules/S1481/swift/rule.adoc | 2 +- rules/S1481/vbnet/rule.adoc | 2 +- rules/S1485/rule.adoc | 2 +- rules/S1486/rule.adoc | 2 +- rules/S1491/rule.adoc | 2 +- rules/S1492/description.adoc | 2 +- rules/S1492/exceptions.adoc | 2 +- rules/S1493/cobol/rule.adoc | 2 +- rules/S1493/description.adoc | 2 +- rules/S1494/rule.adoc | 6 +- rules/S1496/rule.adoc | 2 +- rules/S1498/rule.adoc | 2 +- rules/S1499/description.adoc | 2 +- rules/S1499/plsql/rule.adoc | 2 +- rules/S1499/tsql/rule.adoc | 18 +-- rules/S1500/rule.adoc | 2 +- rules/S1502/rule.adoc | 2 +- rules/S1503/rule.adoc | 2 +- rules/S1505/rule.adoc | 2 +- rules/S1506/rule.adoc | 4 +- rules/S1507/rule.adoc | 2 +- rules/S1508/rule.adoc | 4 +- rules/S1511/rule.adoc | 14 +- rules/S1514/rule.adoc | 2 +- rules/S1516/pli/rule.adoc | 2 +- rules/S1523/abap/rule.adoc | 10 +- rules/S1523/javascript/rule.adoc | 4 +- rules/S1523/php/rule.adoc | 2 +- rules/S1523/plsql/rule.adoc | 4 +- rules/S1523/tsql/rule.adoc | 6 +- rules/S1526/description.adoc | 2 +- rules/S1526/javascript/rule.adoc | 4 +- rules/S1527/description.adoc | 36 ++--- rules/S1527/java/rule.adoc | 2 +- rules/S1529/rule.adoc | 6 +- rules/S1533/rule.adoc | 2 +- rules/S1534/rule.adoc | 2 +- rules/S1535/rule.adoc | 4 +- rules/S1540/rule.adoc | 4 +- rules/S1541/java/rule.adoc | 2 +- rules/S1542/python/rule.adoc | 2 +- rules/S1542/vbnet/rule.adoc | 4 +- rules/S1544/rule.adoc | 2 +- rules/S1547/rule.adoc | 2 +- rules/S1551/rule.adoc | 2 +- rules/S1552/rule.adoc | 2 +- rules/S1554/rule.adoc | 2 +- rules/S1555/rule.adoc | 4 +- rules/S1556/rule.adoc | 2 +- rules/S1557/rule.adoc | 2 +- rules/S1558/rule.adoc | 2 +- rules/S1559/rule.adoc | 2 +- rules/S1560/rule.adoc | 2 +- rules/S1561/rule.adoc | 2 +- rules/S1562/rule.adoc | 2 +- rules/S1563/rule.adoc | 2 +- rules/S1565/rule.adoc | 2 +- rules/S1566/rule.adoc | 2 +- rules/S1567/rule.adoc | 2 +- rules/S1568/rule.adoc | 2 +- rules/S1569/rule.adoc | 2 +- rules/S1570/rule.adoc | 2 +- rules/S1571/description.adoc | 2 +- rules/S1571/plsql/rule.adoc | 8 +- rules/S1572/rule.adoc | 2 +- rules/S1576/rule.adoc | 2 +- rules/S1577/rule.adoc | 2 +- rules/S1579/rule.adoc | 2 +- rules/S1580/rule.adoc | 2 +- rules/S1581/rule.adoc | 2 +- rules/S1582/rule.adoc | 2 +- rules/S1583/description.adoc | 2 +- rules/S1584/rule.adoc | 2 +- rules/S1586/rule.adoc | 6 +- rules/S1587/rule.adoc | 2 +- rules/S1588/rule.adoc | 2 +- rules/S1589/rule.adoc | 2 +- rules/S1590/description.adoc | 2 +- rules/S1591/rule.adoc | 2 +- rules/S1592/rule.adoc | 2 +- rules/S1593/rule.adoc | 2 +- rules/S1594/rule.adoc | 2 +- rules/S1595/rule.adoc | 2 +- rules/S1596/rule.adoc | 2 +- rules/S1597/rule.adoc | 2 +- rules/S1598/rule.adoc | 4 +- rules/S1602/rule.adoc | 2 +- rules/S1604/rule.adoc | 2 +- rules/S1605/rule.adoc | 2 +- rules/S1607/csharp/rule.adoc | 4 +- rules/S1607/description.adoc | 2 +- rules/S1607/python/rule.adoc | 2 +- rules/S1608/rule.adoc | 2 +- rules/S1609/rule.adoc | 6 +- rules/S1610/rule.adoc | 2 +- rules/S1611/rule.adoc | 2 +- rules/S1612/rule.adoc | 4 +- rules/S1615/rule.adoc | 2 +- rules/S1617/rule.adoc | 4 +- rules/S1619/pli/rule.adoc | 2 +- rules/S1622/rule.adoc | 4 +- rules/S1624/rule.adoc | 4 +- rules/S1625/rule.adoc | 4 +- rules/S1627/rule.adoc | 2 +- rules/S1628/rule.adoc | 2 +- rules/S1629/rule.adoc | 4 +- rules/S1630/rule.adoc | 2 +- rules/S1632/rule.adoc | 2 +- rules/S1633/rule.adoc | 2 +- rules/S1634/rule.adoc | 2 +- rules/S1638/rule.adoc | 2 +- rules/S1639/rule.adoc | 2 +- rules/S1640/rule.adoc | 2 +- rules/S1642/description.adoc | 2 +- rules/S1642/noncompliant.adoc | 2 +- rules/S1642/swift/rule.adoc | 2 +- rules/S1643/csharp/rule.adoc | 2 +- rules/S1643/vbnet/rule.adoc | 2 +- rules/S1644/rule.adoc | 2 +- rules/S1645/description.adoc | 2 +- rules/S1645/vbnet/rule.adoc | 6 +- rules/S1647/rule.adoc | 2 +- rules/S1648/rule.adoc | 2 +- rules/S1649/rule.adoc | 4 +- rules/S1650/rule.adoc | 2 +- rules/S1651/rule.adoc | 20 +-- rules/S1652/rule.adoc | 2 +- rules/S1654/noncompliant.adoc | 2 +- rules/S1654/vbnet/rule.adoc | 2 +- rules/S1655/rule.adoc | 2 +- rules/S1657/rule.adoc | 2 +- rules/S1659/vb6/rule.adoc | 2 +- rules/S1660/rule.adoc | 2 +- rules/S1661/rule.adoc | 2 +- rules/S1662/rule.adoc | 2 +- rules/S1669/cfamily/rule.adoc | 2 +- rules/S1669/pli/rule.adoc | 2 +- rules/S1670/rule.adoc | 2 +- rules/S1671/rule.adoc | 2 +- rules/S1673/rule.adoc | 2 +- rules/S1674/rule.adoc | 2 +- rules/S1675/rule.adoc | 2 +- rules/S1676/rule.adoc | 2 +- rules/S1683/rule.adoc | 44 +++--- rules/S1685/rule.adoc | 2 +- rules/S1694/csharp/rule.adoc | 4 +- rules/S1694/description.adoc | 2 +- rules/S1695/rule.adoc | 6 +- rules/S1696/csharp/rule.adoc | 2 +- rules/S1696/description.adoc | 2 +- rules/S1697/javascript/rule.adoc | 2 +- rules/S1698/csharp/rule.adoc | 6 +- rules/S1698/java/rule.adoc | 14 +- rules/S1699/cfamily/rule.adoc | 2 +- rules/S1699/csharp/rule.adoc | 2 +- rules/S1699/description.adoc | 2 +- rules/S1702/rule.adoc | 2 +- rules/S1703/rule.adoc | 4 +- rules/S1706/rule.adoc | 8 +- rules/S1707/noncompliant.adoc | 2 +- rules/S1708/rule.adoc | 2 +- rules/S1709/rule.adoc | 4 +- rules/S1710/rule.adoc | 2 +- rules/S1713/rule.adoc | 2 +- rules/S1714/rule.adoc | 2 +- rules/S1716/rule.adoc | 2 +- rules/S1717/rule.adoc | 2 +- rules/S1721/rule.adoc | 2 +- rules/S1722/rule.adoc | 2 +- rules/S1725/rule.adoc | 2 +- rules/S1726/rule.adoc | 2 +- rules/S1729/rule.adoc | 2 +- rules/S1731/rule.adoc | 2 +- rules/S1732/rule.adoc | 6 +- rules/S1735/description.adoc | 2 +- rules/S1737/rule.adoc | 2 +- rules/S1738/rule.adoc | 2 +- rules/S1739/description.adoc | 2 +- rules/S1739/tsql/rule.adoc | 2 +- rules/S1740/rule.adoc | 2 +- rules/S1741/rule.adoc | 2 +- rules/S1742/rule.adoc | 2 +- rules/S1745/rule.adoc | 2 +- rules/S1749/rule.adoc | 16 +-- rules/S1751/abap/rule.adoc | 4 +- rules/S1751/csharp/rule.adoc | 2 +- rules/S1751/description.adoc | 4 +- rules/S1751/plsql/rule.adoc | 4 +- rules/S1751/python/rule.adoc | 4 +- rules/S1751/tsql/rule.adoc | 4 +- rules/S1752/rule.adoc | 4 +- rules/S1753/rule.adoc | 4 +- rules/S1754/rule.adoc | 2 +- rules/S1757/rule.adoc | 2 +- rules/S1760/rule.adoc | 8 +- rules/S1761/rule.adoc | 4 +- rules/S1763/apex/rule.adoc | 2 +- rules/S1763/description.adoc | 2 +- rules/S1763/javascript/rule.adoc | 4 +- rules/S1763/kotlin/rule.adoc | 2 +- rules/S1763/plsql/rule.adoc | 12 +- rules/S1763/python/rule.adoc | 2 +- rules/S1763/ruby/rule.adoc | 2 +- rules/S1763/scala/rule.adoc | 2 +- rules/S1763/swift/rule.adoc | 2 +- rules/S1763/tsql/rule.adoc | 2 +- rules/S1764/apex/rule.adoc | 2 +- rules/S1764/cfamily/rule.adoc | 6 +- rules/S1764/cobol/rule.adoc | 2 +- rules/S1764/csharp/rule.adoc | 2 +- rules/S1764/exceptions.adoc | 2 +- rules/S1764/go/rule.adoc | 2 +- rules/S1764/java/rule.adoc | 4 +- rules/S1764/javascript/rule.adoc | 4 +- rules/S1764/plsql/rule.adoc | 2 +- rules/S1764/python/rule.adoc | 4 +- rules/S1764/rpg/rule.adoc | 2 +- rules/S1764/see.adoc | 2 +- rules/S1764/swift/rule.adoc | 2 +- rules/S1764/tsql/rule.adoc | 2 +- rules/S1764/vbnet/rule.adoc | 2 +- rules/S1765/rule.adoc | 2 +- rules/S1768/rule.adoc | 2 +- rules/S1769/rule.adoc | 2 +- rules/S1771/rule.adoc | 4 +- rules/S1772/rule.adoc | 2 +- rules/S1773/rule.adoc | 2 +- rules/S1774/description.adoc | 2 +- rules/S1780/rule.adoc | 2 +- rules/S1782/rule.adoc | 2 +- rules/S1784/flex/rule.adoc | 10 +- rules/S1788/javascript/rule.adoc | 2 +- rules/S1793/rule.adoc | 2 +- rules/S1799/rule.adoc | 4 +- rules/S1820/cfamily/rule.adoc | 2 +- rules/S1821/apex/rule.adoc | 4 +- rules/S1821/description.adoc | 4 +- rules/S1821/kotlin/rule.adoc | 4 +- rules/S1821/php/rule.adoc | 4 +- rules/S1821/ruby/rule.adoc | 4 +- rules/S1821/scala/rule.adoc | 4 +- rules/S1821/vb6/rule.adoc | 4 +- rules/S1821/vbnet/rule.adoc | 4 +- rules/S1827/rule.adoc | 138 +++++++++---------- rules/S1828/rule.adoc | 2 +- rules/S1831/rule.adoc | 6 +- rules/S1836/rule.adoc | 4 +- rules/S1844/rule.adoc | 4 +- rules/S1845/python/rule.adoc | 2 +- rules/S1845/swift/rule.adoc | 2 +- rules/S1849/rule.adoc | 2 +- rules/S1850/rule.adoc | 2 +- rules/S1852/rule.adoc | 4 +- rules/S1854/cfamily/rule.adoc | 6 +- rules/S1854/csharp/rule.adoc | 4 +- rules/S1854/exceptions.adoc | 2 +- rules/S1854/javascript/rule.adoc | 2 +- rules/S1854/php/rule.adoc | 2 +- rules/S1854/python/rule.adoc | 2 +- rules/S1854/swift/rule.adoc | 2 +- rules/S1858/csharp/rule.adoc | 12 +- rules/S1860/rule.adoc | 2 +- rules/S1862/apex/rule.adoc | 4 +- rules/S1862/cobol/rule.adoc | 2 +- rules/S1862/description.adoc | 2 +- rules/S1862/javascript/rule.adoc | 2 +- rules/S1862/php/rule.adoc | 6 +- rules/S1862/plsql/rule.adoc | 2 +- rules/S1862/rpg/rule.adoc | 2 +- rules/S1862/ruby/rule.adoc | 4 +- rules/S1862/scala/rule.adoc | 4 +- rules/S1862/swift/rule.adoc | 2 +- rules/S1862/tsql/rule.adoc | 2 +- rules/S1862/vbnet/rule.adoc | 2 +- rules/S1871/abap/rule.adoc | 6 +- rules/S1871/apex/rule.adoc | 6 +- rules/S1871/cobol/rule.adoc | 6 +- rules/S1871/csharp/rule.adoc | 6 +- rules/S1871/description.adoc | 2 +- rules/S1871/exceptions.adoc | 4 +- rules/S1871/go/rule.adoc | 2 +- rules/S1871/kotlin/rule.adoc | 6 +- rules/S1871/php/rule.adoc | 4 +- rules/S1871/plsql/rule.adoc | 8 +- rules/S1871/python/rule.adoc | 6 +- rules/S1871/rpg/rule.adoc | 6 +- rules/S1871/ruby/rule.adoc | 6 +- rules/S1871/scala/rule.adoc | 6 +- rules/S1871/swift/rule.adoc | 8 +- rules/S1871/tsql/rule.adoc | 8 +- rules/S1871/vbnet/rule.adoc | 6 +- rules/S1872/description.adoc | 2 +- rules/S1872/java/rule.adoc | 2 +- rules/S1873/rule.adoc | 2 +- rules/S1878/rule.adoc | 4 +- rules/S1887/rule.adoc | 2 +- rules/S1888/rule.adoc | 2 +- rules/S1895/rule.adoc | 4 +- rules/S1896/rule.adoc | 2 +- rules/S1899/rule.adoc | 2 +- rules/S1900/rule.adoc | 2 +- rules/S1901/rule.adoc | 2 +- rules/S1909/description.adoc | 6 +- rules/S1912/rule.adoc | 2 +- rules/S1913/rule.adoc | 2 +- rules/S1914/rule.adoc | 2 +- rules/S1916/rule.adoc | 4 +- rules/S1917/rule.adoc | 2 +- rules/S1927/rule.adoc | 2 +- rules/S1929/rule.adoc | 2 +- rules/S1930/rule.adoc | 2 +- rules/S1931/rule.adoc | 2 +- rules/S1932/rule.adoc | 2 +- rules/S1933/rule.adoc | 2 +- rules/S1934/rule.adoc | 2 +- rules/S1937/rule.adoc | 2 +- rules/S1939/csharp/rule.adoc | 4 +- rules/S1939/description.adoc | 6 +- rules/S1939/java/rule.adoc | 2 +- rules/S1942/rule.adoc | 2 +- rules/S1943/rule.adoc | 92 ++++++------- rules/S1944/csharp/rule.adoc | 4 +- rules/S1948/rule.adoc | 6 +- rules/S1950/rule.adoc | 2 +- rules/S1951/rule.adoc | 2 +- rules/S1956/rule.adoc | 2 +- rules/S1966/rule.adoc | 2 +- rules/S1968/rule.adoc | 2 +- rules/S1976/rule.adoc | 4 +- rules/S1978/rule.adoc | 4 +- rules/S1979/rule.adoc | 2 +- rules/S1980/rule.adoc | 4 +- rules/S1982/rule.adoc | 2 +- rules/S1985/rule.adoc | 2 +- rules/S1987/rule.adoc | 2 +- rules/S1988/rule.adoc | 2 +- rules/S1989/rule.adoc | 2 +- rules/S1990/cfamily/rule.adoc | 4 +- rules/S1990/description.adoc | 2 +- rules/S1994/description.adoc | 2 +- rules/S1994/go/rule.adoc | 2 +- rules/S1997/rule.adoc | 2 +- rules/S2000/rule.adoc | 2 +- rules/S2001/rule.adoc | 66 ++++----- rules/S2003/rule.adoc | 10 +- rules/S2005/java/rule.adoc | 2 +- rules/S2007/description.adoc | 2 +- rules/S2007/plsql/rule.adoc | 2 +- rules/S2010/rule.adoc | 2 +- rules/S2011/description.adoc | 2 +- rules/S2011/python/rule.adoc | 2 +- rules/S2014/rule.adoc | 2 +- rules/S2015/rule.adoc | 2 +- rules/S2025/rule.adoc | 2 +- rules/S2028/rule.adoc | 2 +- rules/S2029/rule.adoc | 2 +- rules/S2035/rule.adoc | 2 +- rules/S2036/rule.adoc | 4 +- rules/S2037/rule.adoc | 4 +- rules/S2039/java/rule.adoc | 2 +- rules/S2041/rule.adoc | 2 +- rules/S2044/rule.adoc | 2 +- rules/S2048/rule.adoc | 2 +- rules/S2050/rule.adoc | 34 ++--- rules/S2053/java/rule.adoc | 2 +- rules/S2055/rule.adoc | 4 +- rules/S2057/rule.adoc | 6 +- rules/S2059/rule.adoc | 6 +- rules/S2060/rule.adoc | 2 +- rules/S2061/rule.adoc | 2 +- rules/S2062/rule.adoc | 2 +- rules/S2063/rule.adoc | 2 +- rules/S2064/rule.adoc | 4 +- rules/S2065/rule.adoc | 2 +- rules/S2066/rule.adoc | 6 +- rules/S2070/csharp/rule.adoc | 2 +- rules/S2070/java/rule.adoc | 36 ++--- rules/S2076/javascript/rule.adoc | 4 +- rules/S2076/python/rule.adoc | 10 +- rules/S2077/csharp/rule.adoc | 36 ++--- rules/S2077/java/rule.adoc | 56 ++++---- rules/S2077/javascript/rule.adoc | 16 +-- rules/S2077/php/rule.adoc | 28 ++-- rules/S2077/python/rule.adoc | 10 +- rules/S2077/vbnet/rule.adoc | 34 ++--- rules/S2078/description.adoc | 2 +- rules/S2083/description.adoc | 2 +- rules/S2084/rule.adoc | 4 +- rules/S2092/csharp/rule.adoc | 2 +- rules/S2092/description.adoc | 2 +- rules/S2092/java/rule.adoc | 2 +- rules/S2092/kotlin/rule.adoc | 2 +- rules/S2092/php/rule.adoc | 2 +- rules/S2092/recommended.adoc | 4 +- rules/S2093/rule.adoc | 6 +- rules/S2094/description.adoc | 2 +- rules/S2094/swift/rule.adoc | 2 +- rules/S2095/cfamily/rule.adoc | 2 +- rules/S2095/description.adoc | 2 +- rules/S2095/java/rule.adoc | 16 +-- rules/S2096/csharp/rule.adoc | 4 +- rules/S2096/description.adoc | 4 +- rules/S2097/rule.adoc | 2 +- rules/S2107/description.adoc | 2 +- rules/S2108/swift/rule.adoc | 2 +- rules/S2109/rule.adoc | 10 +- rules/S2110/rule.adoc | 4 +- rules/S2111/rule.adoc | 4 +- rules/S2112/rule.adoc | 6 +- rules/S2116/rule.adoc | 2 +- rules/S2118/rule.adoc | 2 +- rules/S2119/rule.adoc | 8 +- rules/S2120/rule.adoc | 4 +- rules/S2121/rule.adoc | 4 +- rules/S2122/rule.adoc | 4 +- rules/S2125/rule.adoc | 2 +- rules/S2127/rule.adoc | 2 +- rules/S2129/rule.adoc | 4 +- rules/S2130/rule.adoc | 2 +- rules/S2131/rule.adoc | 2 +- rules/S2133/rule.adoc | 2 +- rules/S2134/rule.adoc | 4 +- rules/S2137/rule.adoc | 10 +- rules/S2138/rule.adoc | 2 +- rules/S2139/rule.adoc | 2 +- rules/S2140/rule.adoc | 4 +- rules/S2141/rule.adoc | 2 +- rules/S2142/rule.adoc | 6 +- rules/S2143/rule.adoc | 2 +- rules/S2144/rule.adoc | 4 +- rules/S2145/description.adoc | 2 +- rules/S2145/plsql/rule.adoc | 2 +- rules/S2147/rule.adoc | 4 +- rules/S2148/csharp/rule.adoc | 2 +- rules/S2148/description.adoc | 2 +- rules/S2150/rule.adoc | 4 +- rules/S2151/rule.adoc | 2 +- rules/S2153/rule.adoc | 2 +- rules/S2154/rule.adoc | 2 +- rules/S2156/cfamily/rule.adoc | 4 +- rules/S2156/csharp/rule.adoc | 2 +- rules/S2156/description.adoc | 4 +- rules/S2156/java/rule.adoc | 2 +- rules/S2157/rule.adoc | 4 +- rules/S2159/description.adoc | 4 +- rules/S2159/java/rule.adoc | 8 +- rules/S2159/python/rule.adoc | 4 +- rules/S2160/rule.adoc | 6 +- rules/S2162/rule.adoc | 10 +- rules/S2164/rule.adoc | 2 +- rules/S2165/rule.adoc | 2 +- rules/S2166/description.adoc | 2 +- rules/S2167/rule.adoc | 2 +- rules/S2168/rule.adoc | 6 +- rules/S2175/rule.adoc | 26 ++-- rules/S2177/rule.adoc | 6 +- rules/S2180/rule.adoc | 4 +- rules/S2183/csharp/rule.adoc | 6 +- rules/S2183/description.adoc | 4 +- rules/S2184/csharp/rule.adoc | 2 +- rules/S2184/description.adoc | 4 +- rules/S2185/rule.adoc | 6 +- rules/S2186/rule.adoc | 2 +- rules/S2187/csharp/rule.adoc | 8 +- rules/S2187/java/rule.adoc | 4 +- rules/S2188/rule.adoc | 2 +- rules/S2189/description.adoc | 2 +- rules/S2189/javascript/rule.adoc | 4 +- rules/S2190/description.adoc | 2 +- rules/S2190/python/rule.adoc | 2 +- rules/S2193/description.adoc | 2 +- rules/S2194/rule.adoc | 2 +- rules/S2195/rule.adoc | 2 +- rules/S2196/rule.adoc | 4 +- rules/S2198/rule.adoc | 14 +- rules/S2200/rule.adoc | 2 +- rules/S2201/csharp/rule.adoc | 8 +- rules/S2201/java/rule.adoc | 90 ++++++------ rules/S2201/python/rule.adoc | 2 +- rules/S2201/swift/rule.adoc | 24 ++-- rules/S2202/rule.adoc | 2 +- rules/S2203/rule.adoc | 2 +- rules/S2204/rule.adoc | 4 +- rules/S2207/rule.adoc | 2 +- rules/S2208/javascript/rule.adoc | 2 +- rules/S2208/python/rule.adoc | 6 +- rules/S2209/description.adoc | 2 +- rules/S2213/rule.adoc | 4 +- rules/S2219/csharp/rule.adoc | 20 +-- rules/S2219/description.adoc | 4 +- rules/S2221/csharp/rule.adoc | 4 +- rules/S2221/description.adoc | 4 +- rules/S2223/rule.adoc | 2 +- rules/S2225/csharp/rule.adoc | 2 +- rules/S2225/description.adoc | 2 +- rules/S2226/rule.adoc | 8 +- rules/S2228/csharp/rule.adoc | 4 +- rules/S2229/rule.adoc | 6 +- rules/S2230/rule.adoc | 4 +- rules/S2232/rule.adoc | 2 +- rules/S2233/rule.adoc | 12 +- rules/S2235/rule.adoc | 4 +- rules/S2236/rule.adoc | 4 +- rules/S2237/rule.adoc | 2 +- rules/S2238/rule.adoc | 2 +- rules/S2239/rule.adoc | 2 +- rules/S2240/rule.adoc | 2 +- rules/S2241/rule.adoc | 2 +- rules/S2242/rule.adoc | 2 +- rules/S2243/rule.adoc | 2 +- rules/S2245/cfamily/rule.adoc | 2 +- rules/S2245/csharp/rule.adoc | 2 +- rules/S2245/java/rule.adoc | 2 +- rules/S2245/javascript/rule.adoc | 4 +- rules/S2245/php/rule.adoc | 6 +- rules/S2250/rule.adoc | 42 +++--- rules/S2251/description.adoc | 2 +- rules/S2251/javascript/rule.adoc | 2 +- rules/S2252/description.adoc | 2 +- rules/S2254/rule.adoc | 2 +- rules/S2257/csharp/rule.adoc | 22 +-- rules/S2257/description.adoc | 4 +- rules/S2257/python/rule.adoc | 4 +- rules/S2257/vbnet/rule.adoc | 22 +-- rules/S2258/rule.adoc | 2 +- rules/S2259/csharp/rule.adoc | 6 +- rules/S2259/java/rule.adoc | 4 +- rules/S2259/javascript/rule.adoc | 2 +- rules/S2259/python/rule.adoc | 2 +- rules/S2269/rule.adoc | 16 +-- rules/S2272/rule.adoc | 2 +- rules/S2273/rule.adoc | 2 +- rules/S2274/rule.adoc | 6 +- rules/S2275/cfamily/rule.adoc | 2 +- rules/S2275/csharp/rule.adoc | 6 +- rules/S2275/description.adoc | 2 +- rules/S2275/python/rule.adoc | 2 +- rules/S2276/rule.adoc | 2 +- rules/S2277/java/rule.adoc | 2 +- rules/S2277/php/rule.adoc | 2 +- rules/S2290/rule.adoc | 6 +- rules/S2291/rule.adoc | 6 +- rules/S2293/rule.adoc | 4 +- rules/S2301/rule.adoc | 4 +- rules/S2302/description.adoc | 4 +- rules/S2302/exceptions.adoc | 2 +- rules/S2302/vbnet/rule.adoc | 6 +- rules/S2303/rule.adoc | 2 +- rules/S2304/noncompliant.adoc | 2 +- rules/S2304/vbnet/rule.adoc | 2 +- rules/S2305/rule.adoc | 6 +- rules/S2306/rule.adoc | 2 +- rules/S2308/rule.adoc | 2 +- rules/S2311/rule.adoc | 2 +- rules/S2313/rule.adoc | 4 +- rules/S2316/rule.adoc | 2 +- rules/S2317/rule.adoc | 2 +- rules/S2318/rule.adoc | 2 +- rules/S2319/rule.adoc | 2 +- rules/S2320/rule.adoc | 2 +- rules/S2322/rule.adoc | 2 +- rules/S2323/rule.adoc | 2 +- rules/S2324/rule.adoc | 2 +- rules/S2325/description.adoc | 2 +- rules/S2325/exceptions.adoc | 2 +- rules/S2325/java/rule.adoc | 10 +- rules/S2325/javascript/rule.adoc | 2 +- rules/S2325/python/rule.adoc | 4 +- rules/S2327/description.adoc | 2 +- rules/S2327/rpg/rule.adoc | 2 +- rules/S2328/rule.adoc | 2 +- rules/S2330/rule.adoc | 4 +- rules/S2333/csharp/rule.adoc | 8 +- rules/S2333/description.adoc | 4 +- rules/S2334/rule.adoc | 2 +- rules/S2339/description.adoc | 4 +- rules/S2340/description.adoc | 2 +- rules/S2340/plsql/rule.adoc | 2 +- rules/S2342/cfamily/rule.adoc | 2 +- rules/S2342/csharp/rule.adoc | 6 +- rules/S2342/description.adoc | 2 +- rules/S2342/swift/rule.adoc | 2 +- rules/S2342/vbnet/rule.adoc | 4 +- rules/S2343/noncompliant.adoc | 2 +- rules/S2343/swift/rule.adoc | 2 +- rules/S2346/description.adoc | 2 +- rules/S2347/rule.adoc | 4 +- rules/S2348/rule.adoc | 2 +- rules/S2353/rule.adoc | 2 +- rules/S2354/rule.adoc | 2 +- rules/S2357/csharp/rule.adoc | 4 +- rules/S2357/exceptions.adoc | 2 +- rules/S2358/rule.adoc | 2 +- rules/S2359/rule.adoc | 4 +- rules/S2362/rule.adoc | 4 +- rules/S2363/rule.adoc | 4 +- rules/S2364/rule.adoc | 6 +- rules/S2365/csharp/rule.adoc | 2 +- rules/S2366/rule.adoc | 2 +- rules/S2367/rule.adoc | 4 +- rules/S2369/rule.adoc | 4 +- rules/S2370/rule.adoc | 4 +- rules/S2371/rule.adoc | 2 +- rules/S2372/exceptions.adoc | 2 +- rules/S2373/rule.adoc | 2 +- rules/S2375/rule.adoc | 2 +- rules/S2384/csharp/rule.adoc | 6 +- rules/S2384/description.adoc | 2 +- rules/S2385/rule.adoc | 4 +- rules/S2386/csharp/rule.adoc | 22 +-- rules/S2386/description.adoc | 8 +- rules/S2387/cfamily/rule.adoc | 2 +- rules/S2387/csharp/rule.adoc | 2 +- rules/S2387/java/rule.adoc | 2 +- rules/S2387/vbnet/rule.adoc | 2 +- rules/S2388/rule.adoc | 2 +- rules/S2389/rule.adoc | 2 +- rules/S2391/rule.adoc | 4 +- rules/S2392/rule.adoc | 2 +- rules/S2393/rule.adoc | 6 +- rules/S2425/rule.adoc | 2 +- rules/S2427/rule.adoc | 2 +- rules/S2429/vbnet/rule.adoc | 2 +- rules/S2430/rule.adoc | 2 +- rules/S2432/rule.adoc | 2 +- rules/S2433/rule.adoc | 2 +- rules/S2434/rule.adoc | 2 +- rules/S2437/description.adoc | 2 +- rules/S2437/vbnet/rule.adoc | 2 +- rules/S2438/rule.adoc | 4 +- rules/S2440/rule.adoc | 2 +- rules/S2441/rule.adoc | 4 +- rules/S2442/rule.adoc | 2 +- rules/S2444/rule.adoc | 6 +- rules/S2445/rule.adoc | 2 +- rules/S2446/rule.adoc | 2 +- rules/S2447/rule.adoc | 2 +- rules/S2448/rule.adoc | 2 +- rules/S2449/rule.adoc | 2 +- rules/S2450/rule.adoc | 2 +- rules/S2453/rule.adoc | 4 +- rules/S2457/rule.adoc | 2 +- rules/S2458/rule.adoc | 2 +- rules/S2459/rule.adoc | 2 +- rules/S2460/rule.adoc | 4 +- rules/S2461/rule.adoc | 2 +- rules/S2463/rule.adoc | 2 +- rules/S2464/rule.adoc | 4 +- rules/S2466/rule.adoc | 2 +- rules/S2468/rule.adoc | 2 +- rules/S2469/rule.adoc | 2 +- rules/S2470/rule.adoc | 2 +- rules/S2472/rule.adoc | 2 +- rules/S2473/rule.adoc | 2 +- rules/S2479/description.adoc | 6 +- rules/S2481/rule.adoc | 2 +- rules/S2482/rule.adoc | 2 +- rules/S2486/csharp/rule.adoc | 2 +- rules/S2486/rpg/rule.adoc | 2 +- rules/S2490/rule.adoc | 2 +- rules/S2491/rule.adoc | 2 +- rules/S2492/rule.adoc | 2 +- rules/S2493/rule.adoc | 2 +- rules/S2496/rule.adoc | 4 +- rules/S2497/rule.adoc | 4 +- rules/S2498/rule.adoc | 2 +- rules/S2517/rule.adoc | 2 +- rules/S2519/rule.adoc | 2 +- rules/S2520/rule.adoc | 2 +- rules/S2521/rule.adoc | 2 +- rules/S2522/rule.adoc | 2 +- rules/S2523/cfamily/rule.adoc | 4 +- rules/S2524/rule.adoc | 12 +- rules/S2525/rule.adoc | 2 +- rules/S2526/rule.adoc | 2 +- rules/S2527/description.adoc | 4 +- rules/S2527/tsql/rule.adoc | 4 +- rules/S2528/rule.adoc | 4 +- rules/S2529/rule.adoc | 2 +- rules/S2530/rule.adoc | 2 +- rules/S2532/rule.adoc | 2 +- rules/S2534/rule.adoc | 2 +- rules/S2535/rule.adoc | 2 +- rules/S2538/rule.adoc | 2 +- rules/S2541/rule.adoc | 4 +- rules/S2542/rule.adoc | 4 +- rules/S2543/rule.adoc | 8 +- rules/S2544/rule.adoc | 2 +- rules/S2545/rule.adoc | 2 +- rules/S2549/rule.adoc | 2 +- rules/S2550/rule.adoc | 2 +- rules/S2551/description.adoc | 6 +- rules/S2551/vbnet/rule.adoc | 6 +- rules/S2552/rule.adoc | 4 +- rules/S2558/rule.adoc | 2 +- rules/S2560/rule.adoc | 4 +- rules/S2562/rule.adoc | 2 +- rules/S2563/rule.adoc | 2 +- rules/S2564/rule.adoc | 2 +- rules/S2566/rule.adoc | 2 +- rules/S2567/rule.adoc | 2 +- rules/S2570/rule.adoc | 6 +- rules/S2577/rule.adoc | 4 +- rules/S2578/rule.adoc | 4 +- rules/S2583/csharp/rule.adoc | 4 +- rules/S2583/description.adoc | 2 +- rules/S2583/java/rule.adoc | 4 +- rules/S2583/javascript/rule.adoc | 4 +- rules/S2612/cfamily/rule.adoc | 8 +- rules/S2612/description.adoc | 2 +- rules/S2612/java/rule.adoc | 2 +- rules/S2612/javascript/rule.adoc | 8 +- rules/S2613/rule.adoc | 2 +- rules/S2629/rule.adoc | 8 +- rules/S2631/description.adoc | 2 +- rules/S2631/java/rule.adoc | 4 +- rules/S2631/php/rule.adoc | 2 +- rules/S2637/cfamily/rule.adoc | 2 +- rules/S2637/description.adoc | 2 +- rules/S2638/description.adoc | 2 +- rules/S2638/python/rule.adoc | 8 +- rules/S2639/description.adoc | 8 +- rules/S2639/java/rule.adoc | 6 +- rules/S2644/rule.adoc | 14 +- rules/S2651/rule.adoc | 2 +- rules/S2652/rule.adoc | 4 +- rules/S2653/rule.adoc | 4 +- rules/S2654/rule.adoc | 2 +- rules/S2665/rule.adoc | 2 +- rules/S2668/rule.adoc | 2 +- rules/S2674/csharp/rule.adoc | 4 +- rules/S2674/description.adoc | 6 +- rules/S2675/rule.adoc | 2 +- rules/S2676/rule.adoc | 4 +- rules/S2677/rule.adoc | 2 +- rules/S2681/description.adoc | 2 +- rules/S2681/javascript/rule.adoc | 2 +- rules/S2681/tsql/rule.adoc | 4 +- rules/S2684/rule.adoc | 4 +- rules/S2685/rule.adoc | 4 +- rules/S2688/description.adoc | 4 +- rules/S2688/java/rule.adoc | 4 +- rules/S2689/rule.adoc | 4 +- rules/S2690/rule.adoc | 2 +- rules/S2692/csharp/rule.adoc | 6 +- rules/S2692/description.adoc | 4 +- rules/S2692/javascript/rule.adoc | 2 +- rules/S2692/vbnet/rule.adoc | 6 +- rules/S2693/rule.adoc | 4 +- rules/S2694/rule.adoc | 6 +- rules/S2695/rule.adoc | 2 +- rules/S2696/csharp/rule.adoc | 4 +- rules/S2696/description.adoc | 4 +- rules/S2699/apex/rule.adoc | 8 +- rules/S2699/csharp/rule.adoc | 12 +- rules/S2699/java/rule.adoc | 8 +- rules/S2699/javascript/rule.adoc | 2 +- rules/S2702/rule.adoc | 2 +- rules/S2703/rule.adoc | 4 +- rules/S2709/rule.adoc | 2 +- rules/S2710/rule.adoc | 4 +- rules/S2711/rule.adoc | 2 +- rules/S2712/rule.adoc | 2 +- rules/S2715/rule.adoc | 4 +- rules/S2716/rule.adoc | 2 +- rules/S2718/rule.adoc | 4 +- rules/S2733/rule.adoc | 2 +- rules/S2734/rule.adoc | 4 +- rules/S2737/csharp/rule.adoc | 2 +- rules/S2737/description.adoc | 2 +- rules/S2737/plsql/rule.adoc | 2 +- rules/S2737/python/rule.adoc | 2 +- rules/S2737/tsql/rule.adoc | 2 +- rules/S2737/vbnet/rule.adoc | 4 +- rules/S2738/cfamily/rule.adoc | 8 +- rules/S2738/description.adoc | 2 +- rules/S2743/rule.adoc | 2 +- rules/S2753/rule.adoc | 2 +- rules/S2755/java/rule.adoc | 2 +- rules/S2757/cfamily/rule.adoc | 4 +- rules/S2757/description.adoc | 4 +- rules/S2757/javascript/rule.adoc | 4 +- rules/S2757/python/rule.adoc | 4 +- rules/S2757/vbnet/rule.adoc | 4 +- rules/S2761/cfamily/rule.adoc | 6 +- rules/S2761/description.adoc | 2 +- rules/S2761/go/rule.adoc | 4 +- rules/S2761/java/rule.adoc | 6 +- rules/S2761/php/rule.adoc | 2 +- rules/S2761/plsql/rule.adoc | 2 +- rules/S2761/tsql/rule.adoc | 2 +- rules/S2761/vbnet/rule.adoc | 2 +- rules/S2769/rule.adoc | 2 +- rules/S2770/rule.adoc | 28 ++-- rules/S2772/rule.adoc | 2 +- rules/S2777/rule.adoc | 6 +- rules/S2778/rule.adoc | 2 +- rules/S2786/rule.adoc | 4 +- rules/S2787/rule.adoc | 2 +- rules/S2788/rule.adoc | 2 +- rules/S2789/rule.adoc | 2 +- rules/S2792/rule.adoc | 2 +- rules/S2793/rule.adoc | 2 +- rules/S2794/rule.adoc | 2 +- rules/S2795/rule.adoc | 2 +- rules/S2797/rule.adoc | 2 +- rules/S2799/rule.adoc | 2 +- rules/S2800/rule.adoc | 2 +- rules/S2803/rule.adoc | 2 +- rules/S2807/rule.adoc | 8 +- rules/S2808/rule.adoc | 2 +- rules/S2809/rule.adoc | 16 +-- rules/S2813/rule.adoc | 2 +- rules/S2815/rule.adoc | 4 +- rules/S2819/rule.adoc | 2 +- rules/S2821/rule.adoc | 2 +- rules/S2822/rule.adoc | 2 +- rules/S2823/rule.adoc | 2 +- rules/S2836/rule.adoc | 2 +- rules/S2838/rule.adoc | 2 +- rules/S2848/rule.adoc | 2 +- rules/S2854/rule.adoc | 2 +- rules/S2856/rule.adoc | 2 +- rules/S2864/rule.adoc | 2 +- rules/S2870/rule.adoc | 8 +- rules/S2871/rule.adoc | 2 +- rules/S2873/rule.adoc | 2 +- rules/S2876/rule.adoc | 6 +- rules/S2885/rule.adoc | 2 +- rules/S2886/rule.adoc | 2 +- rules/S2887/rule.adoc | 2 +- rules/S2898/rule.adoc | 16 +-- rules/S2912/rule.adoc | 4 +- rules/S2918/rule.adoc | 4 +- rules/S2924/rule.adoc | 6 +- rules/S2925/rule.adoc | 2 +- rules/S2930/rule.adoc | 44 +++--- rules/S2931/rule.adoc | 6 +- rules/S2933/csharp/rule.adoc | 2 +- rules/S2933/description.adoc | 2 +- rules/S2933/typescript/rule.adoc | 2 +- rules/S2934/rule.adoc | 4 +- rules/S2950/rule.adoc | 2 +- rules/S2951/description.adoc | 2 +- rules/S2951/vbnet/rule.adoc | 2 +- rules/S2952/rule.adoc | 2 +- rules/S2953/rule.adoc | 6 +- rules/S2955/rule.adoc | 2 +- rules/S2957/rule.adoc | 2 +- rules/S2959/description.adoc | 2 +- rules/S2961/rule.adoc | 2 +- rules/S2962/rule.adoc | 2 +- rules/S2963/description.adoc | 2 +- rules/S2963/swift/rule.adoc | 2 +- rules/S2964/rule.adoc | 2 +- rules/S2966/description.adoc | 2 +- rules/S2966/typescript/rule.adoc | 2 +- rules/S2967/rule.adoc | 2 +- rules/S2970/java/rule.adoc | 8 +- rules/S2970/javascript/rule.adoc | 8 +- rules/S2971/rule.adoc | 14 +- rules/S2974/rule.adoc | 2 +- rules/S2975/rule.adoc | 4 +- rules/S2976/rule.adoc | 8 +- rules/S2978/rule.adoc | 2 +- rules/S2979/rule.adoc | 4 +- rules/S2982/rule.adoc | 2 +- rules/S2987/rule.adoc | 6 +- rules/S2990/rule.adoc | 2 +- rules/S2995/rule.adoc | 2 +- rules/S2996/rule.adoc | 2 +- rules/S2997/rule.adoc | 2 +- rules/S2999/rule.adoc | 2 +- rules/S3001/rule.adoc | 2 +- rules/S3002/rule.adoc | 4 +- rules/S3003/rule.adoc | 2 +- rules/S3005/rule.adoc | 4 +- rules/S3008/rule.adoc | 2 +- rules/S3009/rule.adoc | 2 +- rules/S3010/description.adoc | 4 +- rules/S3012/rule.adoc | 4 +- rules/S3014/rule.adoc | 2 +- rules/S3016/rule.adoc | 2 +- rules/S3018/description.adoc | 2 +- rules/S3019/rule.adoc | 14 +- rules/S3020/rule.adoc | 2 +- rules/S3024/rule.adoc | 2 +- rules/S3025/rule.adoc | 2 +- rules/S3026/rule.adoc | 2 +- rules/S3027/rule.adoc | 2 +- rules/S3028/rule.adoc | 4 +- rules/S3030/rule.adoc | 2 +- rules/S3031/rule.adoc | 2 +- rules/S3032/rule.adoc | 2 +- rules/S3033/rule.adoc | 2 +- rules/S3034/rule.adoc | 8 +- rules/S3035/rule.adoc | 4 +- rules/S3036/rule.adoc | 4 +- rules/S3038/rule.adoc | 2 +- rules/S3039/rule.adoc | 4 +- rules/S3040/rule.adoc | 20 +-- rules/S3042/rule.adoc | 2 +- rules/S3043/rule.adoc | 2 +- rules/S3046/csharp/rule.adoc | 2 +- rules/S3046/description.adoc | 2 +- rules/S3049/rule.adoc | 2 +- rules/S3050/rule.adoc | 4 +- rules/S3051/rule.adoc | 2 +- rules/S3052/csharp/rule.adoc | 2 +- rules/S3052/exceptions.adoc | 2 +- rules/S3053/rule.adoc | 2 +- rules/S3054/rule.adoc | 2 +- rules/S3055/csharp/rule.adoc | 6 +- rules/S3055/description.adoc | 8 +- rules/S3057/rule.adoc | 2 +- rules/S3058/rule.adoc | 6 +- rules/S3059/rule.adoc | 2 +- rules/S3060/csharp/rule.adoc | 2 +- rules/S3060/description.adoc | 2 +- rules/S3063/rule.adoc | 4 +- rules/S3064/rule.adoc | 2 +- rules/S3065/rule.adoc | 6 +- rules/S3066/rule.adoc | 2 +- rules/S3067/rule.adoc | 4 +- rules/S3068/rule.adoc | 12 +- rules/S3074/rule.adoc | 2 +- rules/S3076/rule.adoc | 2 +- rules/S3077/rule.adoc | 4 +- rules/S3078/rule.adoc | 2 +- rules/S3086/rule.adoc | 2 +- rules/S3110/rule.adoc | 2 +- rules/S3135/rule.adoc | 18 +-- rules/S3137/rule.adoc | 2 +- rules/S3168/rule.adoc | 10 +- rules/S3169/rule.adoc | 4 +- rules/S3215/description.adoc | 2 +- rules/S3215/exceptions.adoc | 2 +- rules/S3215/java/rule.adoc | 4 +- rules/S3216/rule.adoc | 4 +- rules/S3217/rule.adoc | 6 +- rules/S3218/rule.adoc | 2 +- rules/S3220/rule.adoc | 4 +- rules/S3222/rule.adoc | 2 +- rules/S3234/rule.adoc | 4 +- rules/S3236/rule.adoc | 4 +- rules/S3237/rule.adoc | 4 +- rules/S3239/rule.adoc | 2 +- rules/S3240/rule.adoc | 6 +- rules/S3242/java/rule.adoc | 2 +- rules/S3243/rule.adoc | 4 +- rules/S3244/rule.adoc | 2 +- rules/S3246/rule.adoc | 6 +- rules/S3247/rule.adoc | 2 +- rules/S3249/rule.adoc | 2 +- rules/S3251/rule.adoc | 2 +- rules/S3252/cfamily/rule.adoc | 2 +- rules/S3252/description.adoc | 2 +- rules/S3253/rule.adoc | 2 +- rules/S3256/rule.adoc | 2 +- rules/S3257/description.adoc | 6 +- rules/S3257/typescript/rule.adoc | 2 +- rules/S3260/rule.adoc | 2 +- rules/S3262/rule.adoc | 2 +- rules/S3265/rule.adoc | 2 +- rules/S3269/rule.adoc | 2 +- rules/S3270/rule.adoc | 2 +- rules/S3271/rule.adoc | 2 +- rules/S3272/rule.adoc | 10 +- rules/S3274/rule.adoc | 16 +-- rules/S3276/rule.adoc | 2 +- rules/S3281/rule.adoc | 4 +- rules/S3283/rule.adoc | 2 +- rules/S3285/rule.adoc | 2 +- rules/S3287/rule.adoc | 16 +-- rules/S3288/rule.adoc | 4 +- rules/S3305/rule.adoc | 2 +- rules/S3306/rule.adoc | 6 +- rules/S3317/javascript/rule.adoc | 2 +- rules/S3318/rule.adoc | 2 +- rules/S3324/rule.adoc | 2 +- rules/S3329/java/rule.adoc | 2 +- rules/S3330/ask-yourself.adoc | 2 +- rules/S3330/csharp/rule.adoc | 2 +- rules/S3330/description.adoc | 2 +- rules/S3330/java/rule.adoc | 2 +- rules/S3330/kotlin/rule.adoc | 2 +- rules/S3330/php/rule.adoc | 2 +- rules/S3330/recommended.adoc | 2 +- rules/S3331/ask-yourself.adoc | 2 +- rules/S3331/recommended.adoc | 2 +- rules/S3332/description.adoc | 4 +- rules/S3332/php/rule.adoc | 4 +- rules/S3333/rule.adoc | 6 +- rules/S3334/rule.adoc | 4 +- rules/S3335/rule.adoc | 4 +- rules/S3336/rule.adoc | 4 +- rules/S3337/rule.adoc | 4 +- rules/S3338/rule.adoc | 4 +- rules/S3343/rule.adoc | 2 +- rules/S3345/rule.adoc | 2 +- rules/S3346/csharp/rule.adoc | 4 +- rules/S3346/description.adoc | 2 +- rules/S3351/rule.adoc | 8 +- rules/S3353/csharp/rule.adoc | 2 +- rules/S3353/description.adoc | 2 +- rules/S3353/javascript/rule.adoc | 2 +- rules/S3354/rule.adoc | 4 +- rules/S3355/rule.adoc | 2 +- rules/S3357/rule.adoc | 2 +- rules/S3358/php/rule.adoc | 2 +- rules/S3362/rule.adoc | 2 +- rules/S3363/rule.adoc | 4 +- rules/S3364/rule.adoc | 6 +- rules/S3365/rule.adoc | 2 +- rules/S3366/description.adoc | 6 +- rules/S3366/exceptions.adoc | 2 +- rules/S3367/rule.adoc | 2 +- rules/S3368/rule.adoc | 2 +- rules/S3369/rule.adoc | 2 +- rules/S3370/rule.adoc | 2 +- rules/S3372/rule.adoc | 6 +- rules/S3373/rule.adoc | 4 +- rules/S3375/rule.adoc | 10 +- rules/S3376/rule.adoc | 4 +- rules/S3385/rule.adoc | 8 +- rules/S3388/rule.adoc | 2 +- rules/S3389/rule.adoc | 2 +- rules/S3394/rule.adoc | 4 +- rules/S3395/rule.adoc | 2 +- rules/S3397/rule.adoc | 4 +- rules/S3398/rule.adoc | 2 +- rules/S3400/cfamily/rule.adoc | 2 +- rules/S3400/description.adoc | 2 +- rules/S3400/java/rule.adoc | 2 +- rules/S3400/swift/rule.adoc | 2 +- rules/S3402/rule.adoc | 4 +- rules/S3403/description.adoc | 2 +- rules/S3403/javascript/rule.adoc | 2 +- rules/S3403/python/rule.adoc | 2 +- rules/S3415/description.adoc | 2 +- rules/S3415/java/rule.adoc | 2 +- rules/S3415/php/rule.adoc | 2 +- rules/S3417/rule.adoc | 2 +- rules/S3419/rule.adoc | 4 +- rules/S3420/rule.adoc | 4 +- rules/S3421/rule.adoc | 2 +- rules/S3422/rule.adoc | 2 +- rules/S3428/rule.adoc | 4 +- rules/S3431/rule.adoc | 4 +- rules/S3433/rule.adoc | 6 +- rules/S3434/description.adoc | 2 +- rules/S3434/exceptions.adoc | 2 +- rules/S3434/java/rule.adoc | 4 +- rules/S3436/rule.adoc | 6 +- rules/S3437/rule.adoc | 4 +- rules/S3438/rule.adoc | 4 +- rules/S3439/rule.adoc | 4 +- rules/S3442/rule.adoc | 2 +- rules/S3443/rule.adoc | 2 +- rules/S3444/rule.adoc | 2 +- rules/S3445/rule.adoc | 2 +- rules/S3447/rule.adoc | 4 +- rules/S3449/description.adoc | 2 +- rules/S3449/vbnet/rule.adoc | 2 +- rules/S3450/rule.adoc | 2 +- rules/S3451/rule.adoc | 2 +- rules/S3453/description.adoc | 2 +- rules/S3453/exceptions.adoc | 2 +- rules/S3456/rule.adoc | 2 +- rules/S3457/cfamily/rule.adoc | 2 +- rules/S3457/csharp/rule.adoc | 6 +- rules/S3457/description.adoc | 2 +- rules/S3457/python/rule.adoc | 8 +- rules/S3458/description.adoc | 2 +- rules/S3465/rule.adoc | 4 +- rules/S3466/description.adoc | 2 +- rules/S3469/rule.adoc | 2 +- rules/S3470/rule.adoc | 8 +- rules/S3471/rule.adoc | 6 +- rules/S3472/rule.adoc | 2 +- rules/S3474/rule.adoc | 4 +- rules/S3475/rule.adoc | 4 +- rules/S3481/rule.adoc | 6 +- rules/S3482/rule.adoc | 8 +- rules/S3483/rule.adoc | 4 +- rules/S3486/rule.adoc | 2 +- rules/S3490/rule.adoc | 4 +- rules/S3491/rule.adoc | 4 +- rules/S3500/rule.adoc | 2 +- rules/S3504/rule.adoc | 8 +- rules/S3506/rule.adoc | 2 +- rules/S3510/rule.adoc | 2 +- rules/S3513/rule.adoc | 4 +- rules/S3516/description.adoc | 2 +- rules/S3516/javascript/rule.adoc | 2 +- rules/S3518/java/rule.adoc | 4 +- rules/S3520/rule.adoc | 4 +- rules/S3523/rule.adoc | 4 +- rules/S3525/rule.adoc | 4 +- rules/S3529/rule.adoc | 2 +- rules/S3531/rule.adoc | 2 +- rules/S3532/rule.adoc | 4 +- rules/S3533/rule.adoc | 2 +- rules/S3538/rule.adoc | 8 +- rules/S3539/rule.adoc | 4 +- rules/S3541/rule.adoc | 2 +- rules/S3543/cfamily/rule.adoc | 2 +- rules/S3543/description.adoc | 2 +- rules/S3547/rule.adoc | 2 +- rules/S3548/rule.adoc | 4 +- rules/S3549/rule.adoc | 2 +- rules/S3551/rule.adoc | 2 +- rules/S3553/rule.adoc | 6 +- rules/S3562/description.adoc | 2 +- rules/S3573/rule.adoc | 2 +- rules/S3576/rule.adoc | 2 +- rules/S3577/csharp/rule.adoc | 2 +- rules/S3577/noncompliant.adoc | 2 +- rules/S3578/rule.adoc | 2 +- rules/S3580/rule.adoc | 4 +- rules/S3581/rule.adoc | 4 +- rules/S3582/rule.adoc | 2 +- rules/S3584/rule.adoc | 4 +- rules/S3588/rule.adoc | 2 +- rules/S3590/rule.adoc | 2 +- rules/S3595/rule.adoc | 4 +- rules/S3597/rule.adoc | 2 +- rules/S3598/description.adoc | 2 +- rules/S3598/exceptions.adoc | 2 +- rules/S3599/rule.adoc | 2 +- rules/S3600/rule.adoc | 2 +- rules/S3603/description.adoc | 2 +- rules/S3606/rule.adoc | 4 +- rules/S3608/rule.adoc | 4 +- rules/S3609/rule.adoc | 2 +- rules/S3610/rule.adoc | 2 +- rules/S3613/rule.adoc | 2 +- rules/S3614/rule.adoc | 2 +- rules/S3616/description.adoc | 4 +- rules/S3618/description.adoc | 2 +- rules/S3618/noncompliant.adoc | 2 +- rules/S3618/plsql/rule.adoc | 4 +- rules/S3620/rule.adoc | 2 +- rules/S3621/rule.adoc | 6 +- rules/S3624/rule.adoc | 2 +- rules/S3625/rule.adoc | 2 +- rules/S3626/abap/rule.adoc | 2 +- rules/S3626/cfamily/rule.adoc | 2 +- rules/S3626/csharp/rule.adoc | 2 +- rules/S3626/description.adoc | 2 +- rules/S3626/javascript/rule.adoc | 4 +- rules/S3626/php/rule.adoc | 2 +- rules/S3626/plsql/rule.adoc | 2 +- rules/S3626/python/rule.adoc | 4 +- rules/S3626/tsql/rule.adoc | 2 +- rules/S3628/rule.adoc | 8 +- rules/S3630/description.adoc | 4 +- rules/S3630/swift/rule.adoc | 2 +- rules/S3631/rule.adoc | 2 +- rules/S3632/rule.adoc | 2 +- rules/S3633/rule.adoc | 2 +- rules/S3636/rule.adoc | 4 +- rules/S3637/rule.adoc | 2 +- rules/S3639/rule.adoc | 4 +- rules/S3641/description.adoc | 2 +- rules/S3641/tsql/rule.adoc | 4 +- rules/S3642/rule.adoc | 8 +- rules/S3643/rule.adoc | 4 +- rules/S3644/rule.adoc | 2 +- rules/S3645/rule.adoc | 2 +- rules/S3646/rule.adoc | 2 +- rules/S3647/rule.adoc | 2 +- rules/S3649/description.adoc | 2 +- rules/S3649/java/rule.adoc | 2 +- rules/S3649/php/rule.adoc | 2 +- rules/S3649/python/rule.adoc | 2 +- rules/S3650/rule.adoc | 2 +- rules/S3651/description.adoc | 2 +- rules/S3651/plsql/rule.adoc | 2 +- rules/S3652/rule.adoc | 4 +- rules/S3653/rule.adoc | 4 +- rules/S3654/rule.adoc | 8 +- rules/S3655/description.adoc | 2 +- rules/S3655/java/rule.adoc | 6 +- rules/S3656/rule.adoc | 8 +- rules/S3657/rule.adoc | 8 +- rules/S3658/description.adoc | 4 +- rules/S3658/java/rule.adoc | 4 +- rules/S3661/rule.adoc | 2 +- rules/S3667/rule.adoc | 2 +- rules/S3671/rule.adoc | 2 +- rules/S3673/rule.adoc | 6 +- rules/S3675/rule.adoc | 2 +- rules/S3676/rule.adoc | 6 +- rules/S3686/rule.adoc | 2 +- rules/S3687/rule.adoc | 6 +- rules/S3688/cobol/rule.adoc | 2 +- rules/S3692/rule.adoc | 4 +- rules/S3693/description.adoc | 2 +- rules/S3696/description.adoc | 8 +- rules/S3696/javascript/rule.adoc | 4 +- rules/S3698/rule.adoc | 4 +- rules/S3699/description.adoc | 2 +- rules/S3699/javascript/rule.adoc | 2 +- rules/S3706/rule.adoc | 2 +- rules/S3708/rule.adoc | 4 +- rules/S3715/rule.adoc | 2 +- rules/S3717/rule.adoc | 6 +- rules/S3725/rule.adoc | 6 +- rules/S3726/rule.adoc | 2 +- rules/S3727/rule.adoc | 4 +- rules/S3729/rule.adoc | 2 +- rules/S3730/rule.adoc | 4 +- rules/S3731/rule.adoc | 6 +- rules/S3732/rule.adoc | 4 +- rules/S3735/rule.adoc | 4 +- rules/S3743/rule.adoc | 8 +- rules/S3745/rule.adoc | 2 +- rules/S3749/rule.adoc | 12 +- rules/S3750/rule.adoc | 4 +- rules/S3751/rule.adoc | 6 +- rules/S3753/rule.adoc | 2 +- rules/S3756/rule.adoc | 4 +- rules/S3757/rule.adoc | 6 +- rules/S3758/rule.adoc | 4 +- rules/S3760/rule.adoc | 4 +- rules/S3763/rule.adoc | 6 +- rules/S3767/rule.adoc | 2 +- rules/S3772/rule.adoc | 2 +- rules/S3777/rule.adoc | 2 +- rules/S3780/rule.adoc | 6 +- rules/S3782/rule.adoc | 2 +- rules/S3785/rule.adoc | 4 +- rules/S3786/rule.adoc | 2 +- rules/S3796/rule.adoc | 20 +-- rules/S3798/rule.adoc | 2 +- rules/S3801/description.adoc | 6 +- rules/S3801/php/rule.adoc | 2 +- rules/S3805/rule.adoc | 2 +- rules/S3807/rule.adoc | 230 +++++++++++++++---------------- rules/S3812/rule.adoc | 4 +- rules/S3815/rule.adoc | 2 +- rules/S3817/rule.adoc | 78 +++++------ rules/S3822/rule.adoc | 2 +- rules/S3823/rule.adoc | 2 +- rules/S3824/rule.adoc | 6 +- rules/S3827/javascript/rule.adoc | 10 +- rules/S3828/rule.adoc | 2 +- rules/S3829/rule.adoc | 2 +- rules/S3830/rule.adoc | 4 +- rules/S3832/rule.adoc | 2 +- rules/S3833/rule.adoc | 2 +- rules/S3834/rule.adoc | 4 +- rules/S3838/rule.adoc | 2 +- rules/S3839/rule.adoc | 2 +- rules/S3840/rule.adoc | 2 +- rules/S3847/rule.adoc | 4 +- rules/S3848/rule.adoc | 2 +- rules/S3849/rule.adoc | 12 +- rules/S3850/rule.adoc | 4 +- rules/S3851/rule.adoc | 2 +- rules/S3852/rule.adoc | 6 +- rules/S3854/description.adoc | 12 +- rules/S3855/rule.adoc | 2 +- rules/S3857/rule.adoc | 4 +- rules/S3860/rule.adoc | 2 +- rules/S3862/description.adoc | 2 +- rules/S3862/python/rule.adoc | 6 +- rules/S3864/rule.adoc | 6 +- rules/S3866/rule.adoc | 4 +- rules/S3869/description.adoc | 2 +- rules/S3871/rule.adoc | 6 +- rules/S3874/csharp/rule.adoc | 4 +- rules/S3874/plsql/rule.adoc | 2 +- rules/S3875/rule.adoc | 6 +- rules/S3877/rule.adoc | 22 +-- rules/S3878/rule.adoc | 2 +- rules/S3881/rule.adoc | 16 +-- rules/S3884/description.adoc | 2 +- rules/S3885/rule.adoc | 4 +- rules/S3887/rule.adoc | 4 +- rules/S3889/description.adoc | 2 +- rules/S3890/rule.adoc | 4 +- rules/S3891/rule.adoc | 4 +- rules/S3892/rule.adoc | 2 +- rules/S3897/rule.adoc | 4 +- rules/S3898/rule.adoc | 2 +- rules/S3900/rule.adoc | 6 +- rules/S3902/rule.adoc | 4 +- rules/S3904/description.adoc | 2 +- rules/S3906/rule.adoc | 8 +- rules/S3908/rule.adoc | 2 +- rules/S3909/rule.adoc | 4 +- rules/S3923/abap/rule.adoc | 4 +- rules/S3923/cobol/rule.adoc | 4 +- rules/S3923/csharp/rule.adoc | 2 +- rules/S3923/description.adoc | 2 +- rules/S3923/exceptions.adoc | 2 +- rules/S3923/go/rule.adoc | 2 +- rules/S3923/javascript/rule.adoc | 2 +- rules/S3923/kotlin/rule.adoc | 4 +- rules/S3923/php/rule.adoc | 2 +- rules/S3923/plsql/rule.adoc | 4 +- rules/S3923/python/rule.adoc | 4 +- rules/S3923/ruby/rule.adoc | 4 +- rules/S3923/scala/rule.adoc | 4 +- rules/S3923/swift/rule.adoc | 2 +- rules/S3923/tsql/rule.adoc | 4 +- rules/S3923/vbnet/rule.adoc | 4 +- rules/S3925/rule.adoc | 22 +-- rules/S3926/description.adoc | 4 +- rules/S3927/description.adoc | 10 +- rules/S3927/vbnet/rule.adoc | 10 +- rules/S3928/rule.adoc | 2 +- rules/S3931/cfamily/rule.adoc | 2 +- rules/S3931/description.adoc | 2 +- rules/S3935/rule.adoc | 2 +- rules/S3936/rule.adoc | 2 +- rules/S3937/rule.adoc | 2 +- rules/S3938/rule.adoc | 2 +- rules/S3939/rule.adoc | 2 +- rules/S3946/rule.adoc | 2 +- rules/S3949/cfamily/rule.adoc | 2 +- rules/S3950/rule.adoc | 2 +- rules/S3956/rule.adoc | 20 +-- rules/S3962/rule.adoc | 4 +- rules/S3963/rule.adoc | 2 +- rules/S3964/rule.adoc | 2 +- rules/S3966/rule.adoc | 6 +- rules/S3971/rule.adoc | 4 +- rules/S3972/description.adoc | 2 +- rules/S3972/php/rule.adoc | 2 +- rules/S3972/tsql/rule.adoc | 2 +- rules/S3973/tsql/rule.adoc | 2 +- rules/S3974/rule.adoc | 2 +- rules/S3981/description.adoc | 2 +- rules/S3981/php/rule.adoc | 2 +- rules/S3981/python/rule.adoc | 2 +- rules/S3981/swift/rule.adoc | 2 +- rules/S3982/rule.adoc | 2 +- rules/S3984/csharp/rule.adoc | 2 +- rules/S3984/description.adoc | 2 +- rules/S3984/javascript/rule.adoc | 2 +- rules/S3984/php/rule.adoc | 2 +- rules/S3984/python/rule.adoc | 2 +- rules/S3984/vbnet/rule.adoc | 2 +- rules/S3985/description.adoc | 2 +- rules/S3985/python/rule.adoc | 4 +- rules/S3986/rule.adoc | 2 +- rules/S3990/description.adoc | 2 +- rules/S3992/description.adoc | 2 +- rules/S3993/rule.adoc | 2 +- rules/S3994/rule.adoc | 4 +- rules/S3995/rule.adoc | 4 +- rules/S3996/rule.adoc | 2 +- rules/S3997/rule.adoc | 4 +- rules/S3998/description.adoc | 16 +-- rules/S4000/rule.adoc | 2 +- rules/S4002/rule.adoc | 6 +- rules/S4004/rule.adoc | 10 +- rules/S4005/rule.adoc | 6 +- rules/S4015/rule.adoc | 4 +- rules/S4016/rule.adoc | 2 +- rules/S4019/rule.adoc | 2 +- rules/S4021/rule.adoc | 4 +- rules/S4022/rule.adoc | 2 +- rules/S4025/csharp/rule.adoc | 2 +- rules/S4025/vbnet/rule.adoc | 2 +- rules/S4026/rule.adoc | 4 +- rules/S4027/rule.adoc | 10 +- rules/S4029/rule.adoc | 4 +- rules/S4034/rule.adoc | 12 +- rules/S4035/rule.adoc | 6 +- rules/S4036/description.adoc | 2 +- rules/S4039/rule.adoc | 6 +- rules/S4042/rule.adoc | 2 +- rules/S4043/rule.adoc | 2 +- rules/S4045/rule.adoc | 2 +- rules/S4047/rule.adoc | 4 +- rules/S4049/rule.adoc | 10 +- rules/S4050/rule.adoc | 6 +- rules/S4052/rule.adoc | 18 +-- rules/S4054/cobol/rule.adoc | 2 +- rules/S4054/description.adoc | 4 +- rules/S4055/rule.adoc | 4 +- rules/S4056/rule.adoc | 14 +- rules/S4057/rule.adoc | 4 +- rules/S4058/rule.adoc | 4 +- rules/S4060/rule.adoc | 2 +- rules/S4061/rule.adoc | 6 +- rules/S4062/rule.adoc | 2 +- rules/S4064/rule.adoc | 6 +- rules/S4065/rule.adoc | 4 +- rules/S4069/rule.adoc | 38 ++--- rules/S4070/rule.adoc | 2 +- rules/S4071/rule.adoc | 2 +- rules/S4075/rule.adoc | 38 ++--- rules/S4078/rule.adoc | 4 +- rules/S4081/rule.adoc | 8 +- rules/S4084/rule.adoc | 4 +- rules/S4087/rule.adoc | 2 +- rules/S4094/rule.adoc | 6 +- rules/S4099/rule.adoc | 2 +- rules/S4102/rule.adoc | 10 +- rules/S4103/rule.adoc | 2 +- rules/S4104/rule.adoc | 4 +- rules/S4108/rule.adoc | 2 +- rules/S4109/rule.adoc | 2 +- rules/S4123/rule.adoc | 4 +- rules/S4124/rule.adoc | 4 +- rules/S4125/rule.adoc | 6 +- rules/S4137/rule.adoc | 2 +- rules/S4138/rule.adoc | 2 +- rules/S4139/rule.adoc | 2 +- rules/S4143/python/rule.adoc | 2 +- rules/S4149/rule.adoc | 2 +- rules/S4154/rule.adoc | 2 +- rules/S4156/rule.adoc | 2 +- rules/S4158/csharp/rule.adoc | 2 +- rules/S4158/description.adoc | 2 +- rules/S4159/description.adoc | 4 +- rules/S4165/rule.adoc | 2 +- rules/S4172/rule.adoc | 2 +- rules/S4174/rule.adoc | 4 +- rules/S4183/rule.adoc | 2 +- rules/S4184/rule.adoc | 2 +- rules/S4185/rule.adoc | 10 +- rules/S4186/rule.adoc | 14 +- rules/S4187/rule.adoc | 4 +- rules/S4197/rule.adoc | 4 +- rules/S4200/rule.adoc | 4 +- rules/S4201/csharp/rule.adoc | 2 +- rules/S4201/description.adoc | 2 +- rules/S4201/vbnet/rule.adoc | 2 +- rules/S4204/rule.adoc | 2 +- rules/S4210/description.adoc | 4 +- rules/S4210/vbnet/rule.adoc | 4 +- rules/S4211/rule.adoc | 4 +- rules/S4212/rule.adoc | 2 +- rules/S4214/rule.adoc | 4 +- rules/S4220/rule.adoc | 8 +- rules/S4225/rule.adoc | 2 +- rules/S4231/rule.adoc | 20 +-- rules/S4232/rule.adoc | 40 +++--- rules/S4233/rule.adoc | 2 +- rules/S4248/rule.adoc | 10 +- rules/S4260/description.adoc | 4 +- rules/S4261/rule.adoc | 2 +- rules/S4263/rule.adoc | 4 +- rules/S4265/rule.adoc | 14 +- rules/S4266/rule.adoc | 18 +-- rules/S4274/description.adoc | 4 +- rules/S4274/python/rule.adoc | 2 +- rules/S4275/csharp/rule.adoc | 2 +- rules/S4275/description.adoc | 2 +- rules/S4275/vbnet/rule.adoc | 2 +- rules/S4276/rule.adoc | 68 ++++----- rules/S4277/description.adoc | 4 +- rules/S4284/rule.adoc | 2 +- rules/S4288/rule.adoc | 4 +- rules/S4309/rule.adoc | 4 +- rules/S4322/rule.adoc | 2 +- rules/S4324/rule.adoc | 2 +- rules/S4325/rule.adoc | 2 +- rules/S4326/rule.adoc | 2 +- rules/S4327/rule.adoc | 6 +- rules/S4328/rule.adoc | 2 +- rules/S4334/rule.adoc | 2 +- rules/S4335/rule.adoc | 2 +- rules/S4347/rule.adoc | 6 +- rules/S4348/rule.adoc | 6 +- rules/S4349/rule.adoc | 6 +- rules/S4351/rule.adoc | 4 +- rules/S4412/rule.adoc | 2 +- rules/S4423/java/rule.adoc | 6 +- rules/S4423/javascript/rule.adoc | 4 +- rules/S4423/kotlin/rule.adoc | 6 +- rules/S4423/python/rule.adoc | 4 +- rules/S4424/rule.adoc | 4 +- rules/S4425/rule.adoc | 4 +- rules/S4426/description.adoc | 8 +- rules/S4426/python/rule.adoc | 8 +- rules/S4428/description.adoc | 4 +- rules/S4432/java/rule.adoc | 2 +- rules/S4433/csharp/rule.adoc | 2 +- rules/S4433/java/rule.adoc | 2 +- rules/S4434/rule.adoc | 2 +- rules/S4435/description.adoc | 4 +- rules/S4436/rule.adoc | 8 +- rules/S4437/rule.adoc | 2 +- rules/S4446/rule.adoc | 2 +- rules/S4449/rule.adoc | 4 +- rules/S4454/rule.adoc | 6 +- rules/S4456/rule.adoc | 4 +- rules/S4457/rule.adoc | 6 +- rules/S4458/rule.adoc | 2 +- rules/S4462/rule.adoc | 16 +-- rules/S4470/rule.adoc | 4 +- rules/S4473/rule.adoc | 4 +- rules/S4487/python/rule.adoc | 4 +- rules/S4488/rule.adoc | 2 +- rules/S4499/java/rule.adoc | 4 +- rules/S4502/python/rule.adoc | 10 +- rules/S4502/recommended.adoc | 2 +- rules/S4507/cobol/rule.adoc | 2 +- rules/S4507/csharp/rule.adoc | 6 +- rules/S4507/flex/rule.adoc | 2 +- rules/S4507/java/rule.adoc | 8 +- rules/S4507/rpg/rule.adoc | 2 +- rules/S4507/vbnet/rule.adoc | 6 +- rules/S4507/xml/rule.adoc | 6 +- rules/S4508/java/rule.adoc | 10 +- rules/S4508/php/rule.adoc | 2 +- rules/S4508/python/rule.adoc | 2 +- rules/S4512/rule.adoc | 2 +- rules/S4517/rule.adoc | 4 +- rules/S4524/abap/rule.adoc | 4 +- rules/S4524/description.adoc | 4 +- rules/S4524/go/rule.adoc | 4 +- rules/S4524/java/rule.adoc | 4 +- rules/S4524/pli/rule.adoc | 4 +- rules/S4529/java/rule.adoc | 2 +- rules/S4529/recommended.adoc | 2 +- rules/S4530/rule.adoc | 2 +- rules/S4531/rule.adoc | 4 +- rules/S4544/rule.adoc | 10 +- rules/S4545/rule.adoc | 4 +- rules/S4551/rule.adoc | 6 +- rules/S4564/rule.adoc | 4 +- rules/S4575/rule.adoc | 6 +- rules/S4576/rule.adoc | 2 +- rules/S4577/rule.adoc | 2 +- rules/S4581/rule.adoc | 8 +- rules/S4583/description.adoc | 6 +- rules/S4584/rule.adoc | 2 +- rules/S4586/description.adoc | 2 +- rules/S4586/vbnet/rule.adoc | 2 +- rules/S4601/rule.adoc | 6 +- rules/S4602/rule.adoc | 8 +- rules/S4603/rule.adoc | 6 +- rules/S4604/rule.adoc | 4 +- rules/S4605/rule.adoc | 2 +- rules/S4619/rule.adoc | 4 +- rules/S4621/rule.adoc | 4 +- rules/S4622/rule.adoc | 2 +- rules/S4623/rule.adoc | 2 +- rules/S4624/rule.adoc | 2 +- rules/S4632/rule.adoc | 4 +- rules/S4634/rule.adoc | 2 +- rules/S4635/csharp/rule.adoc | 14 +- rules/S4635/description.adoc | 16 +-- rules/S4645/rule.adoc | 6 +- rules/S4647/rule.adoc | 2 +- rules/S4648/rule.adoc | 2 +- rules/S4649/rule.adoc | 2 +- rules/S4650/rule.adoc | 2 +- rules/S4651/rule.adoc | 6 +- rules/S4653/rule.adoc | 2 +- rules/S4654/rule.adoc | 4 +- rules/S4655/rule.adoc | 4 +- rules/S4656/rule.adoc | 2 +- rules/S4661/rule.adoc | 2 +- rules/S4662/rule.adoc | 2 +- rules/S4664/rule.adoc | 2 +- rules/S4668/rule.adoc | 4 +- rules/S4682/rule.adoc | 4 +- rules/S4684/rule.adoc | 12 +- rules/S4719/rule.adoc | 6 +- rules/S4782/rule.adoc | 4 +- rules/S4784/description.adoc | 6 +- rules/S4784/exceptions.adoc | 4 +- rules/S4784/java/rule.adoc | 6 +- rules/S4784/php/rule.adoc | 20 +-- rules/S4784/python/rule.adoc | 4 +- rules/S4787/python/rule.adoc | 4 +- rules/S4790/abap/rule.adoc | 2 +- rules/S4790/description.adoc | 2 +- rules/S4790/recommended.adoc | 2 +- rules/S4792/java/rule.adoc | 2 +- rules/S4792/php/rule.adoc | 2 +- rules/S4797/csharp/rule.adoc | 4 +- rules/S4797/java/rule.adoc | 6 +- rules/S4797/python/rule.adoc | 16 +-- rules/S4797/recommended.adoc | 2 +- rules/S4797/vbnet/rule.adoc | 4 +- rules/S4801/rule.adoc | 8 +- rules/S4806/rule.adoc | 2 +- rules/S4817/csharp/rule.adoc | 32 ++--- rules/S4817/python/rule.adoc | 4 +- rules/S4817/vbnet/rule.adoc | 28 ++-- rules/S4819/rule.adoc | 6 +- rules/S4820/rule.adoc | 4 +- rules/S4822/rule.adoc | 4 +- rules/S4823/description.adoc | 2 +- rules/S4823/java/rule.adoc | 8 +- rules/S4823/php/rule.adoc | 2 +- rules/S4823/python/rule.adoc | 2 +- rules/S4824/rule.adoc | 2 +- rules/S4825/python/rule.adoc | 8 +- rules/S4829/csharp/rule.adoc | 2 +- rules/S4829/java/rule.adoc | 2 +- rules/S4829/python/rule.adoc | 2 +- rules/S4829/vbnet/rule.adoc | 2 +- rules/S4830/java/rule.adoc | 2 +- rules/S4830/kotlin/rule.adoc | 2 +- rules/S4833/rule.adoc | 6 +- rules/S4834/java/rule.adoc | 30 ++-- rules/S4838/rule.adoc | 4 +- rules/S4882/rule.adoc | 4 +- rules/S4883/rule.adoc | 2 +- rules/S4884/rule.adoc | 2 +- rules/S4925/rule.adoc | 34 ++--- rules/S4926/rule.adoc | 8 +- rules/S4929/rule.adoc | 6 +- rules/S4962/rule.adoc | 4 +- rules/S4963/rule.adoc | 10 +- rules/S4968/rule.adoc | 2 +- rules/S4970/description.adoc | 6 +- rules/S4972/rule.adoc | 2 +- rules/S4973/rule.adoc | 2 +- rules/S4981/description.adoc | 2 +- rules/S4997/rule.adoc | 6 +- rules/S4998/rule.adoc | 8 +- rules/S4999/rule.adoc | 4 +- rules/S5000/rule.adoc | 2 +- rules/S5008/rule.adoc | 12 +- rules/S5018/rule.adoc | 6 +- rules/S5019/rule.adoc | 10 +- rules/S5020/rule.adoc | 6 +- rules/S5025/rule.adoc | 10 +- rules/S5028/rule.adoc | 4 +- rules/S5032/rule.adoc | 2 +- rules/S5034/rule.adoc | 22 +-- rules/S5047/rule.adoc | 6 +- rules/S5115/abap/rule.adoc | 4 +- rules/S5117/rule.adoc | 6 +- rules/S5118/rule.adoc | 4 +- rules/S5119/rule.adoc | 2 +- rules/S5122/ask-yourself.adoc | 6 +- rules/S5122/recommended.adoc | 4 +- rules/S5128/rule.adoc | 6 +- rules/S5139/rule.adoc | 2 +- rules/S5141/description.adoc | 2 +- rules/S5148/rule.adoc | 12 +- rules/S5164/rule.adoc | 8 +- rules/S5205/rule.adoc | 8 +- rules/S5213/rule.adoc | 10 +- rules/S5240/rule.adoc | 2 +- rules/S5247/description.adoc | 4 +- rules/S5247/java/rule.adoc | 9 +- rules/S5254/rule.adoc | 4 +- rules/S5255/rule.adoc | 8 +- rules/S5256/rule.adoc | 10 +- rules/S5257/rule.adoc | 2 +- rules/S5258/rule.adoc | 12 +- rules/S5259/rule.adoc | 6 +- rules/S5260/rule.adoc | 8 +- rules/S5261/rule.adoc | 6 +- rules/S5263/rule.adoc | 2 +- rules/S5264/rule.adoc | 4 +- rules/S5265/rule.adoc | 2 +- rules/S5267/rule.adoc | 2 +- rules/S5268/rule.adoc | 2 +- rules/S5270/rule.adoc | 2 +- rules/S5271/rule.adoc | 4 +- rules/S5273/rule.adoc | 4 +- rules/S5274/rule.adoc | 6 +- rules/S5275/rule.adoc | 8 +- rules/S5277/rule.adoc | 2 +- rules/S5278/rule.adoc | 2 +- rules/S5279/rule.adoc | 4 +- rules/S5280/rule.adoc | 2 +- rules/S5281/rule.adoc | 6 +- rules/S5282/rule.adoc | 6 +- rules/S5286/rule.adoc | 2 +- rules/S5290/rule.adoc | 2 +- rules/S5293/rule.adoc | 2 +- rules/S5296/rule.adoc | 6 +- rules/S5297/rule.adoc | 4 +- rules/S5300/description.adoc | 2 +- rules/S5308/rule.adoc | 2 +- rules/S5310/rule.adoc | 2 +- rules/S5324/description.adoc | 20 +-- rules/S5326/java/rule.adoc | 2 +- rules/S5329/rule.adoc | 4 +- rules/S5332/description.adoc | 4 +- rules/S5332/exceptions.adoc | 2 +- rules/S5332/recommended.adoc | 8 +- rules/S5334/javascript/rule.adoc | 8 +- rules/S5338/rule.adoc | 2 +- rules/S5344/rule.adoc | 20 +-- rules/S5348/rule.adoc | 4 +- rules/S5350/rule.adoc | 2 +- rules/S5361/rule.adoc | 6 +- rules/S5362/rule.adoc | 6 +- rules/S5376/rule.adoc | 12 +- rules/S5377/rule.adoc | 10 +- rules/S5378/rule.adoc | 10 +- rules/S5380/rule.adoc | 2 +- rules/S5381/rule.adoc | 4 +- rules/S5383/rule.adoc | 2 +- rules/S5385/rule.adoc | 2 +- rules/S5386/rule.adoc | 6 +- rules/S5387/rule.adoc | 4 +- rules/S5390/rule.adoc | 2 +- rules/S5391/rule.adoc | 8 +- rules/S5392/rule.adoc | 10 +- rules/S5393/rule.adoc | 6 +- rules/S5394/rule.adoc | 8 +- rules/S5395/rule.adoc | 4 +- rules/S5402/rule.adoc | 8 +- rules/S5404/rule.adoc | 4 +- rules/S5408/rule.adoc | 4 +- rules/S5409/rule.adoc | 4 +- rules/S5410/rule.adoc | 6 +- rules/S5411/rule.adoc | 4 +- rules/S5413/rule.adoc | 4 +- rules/S5414/rule.adoc | 8 +- rules/S5415/rule.adoc | 10 +- rules/S5416/rule.adoc | 4 +- rules/S5417/rule.adoc | 14 +- rules/S5419/rule.adoc | 2 +- rules/S5421/rule.adoc | 2 +- rules/S5422/rule.adoc | 4 +- rules/S5425/rule.adoc | 2 +- rules/S5428/rule.adoc | 2 +- rules/S5439/rule.adoc | 2 +- rules/S5443/description.adoc | 32 ++--- rules/S5445/csharp/rule.adoc | 2 +- rules/S5445/java/rule.adoc | 8 +- rules/S5484/rule.adoc | 4 +- rules/S5485/rule.adoc | 4 +- rules/S5486/rule.adoc | 2 +- rules/S5487/rule.adoc | 4 +- rules/S5488/rule.adoc | 10 +- rules/S5489/rule.adoc | 2 +- rules/S5495/rule.adoc | 2 +- rules/S5498/rule.adoc | 4 +- rules/S5500/rule.adoc | 2 +- rules/S5501/rule.adoc | 10 +- rules/S5502/rule.adoc | 12 +- rules/S5503/rule.adoc | 4 +- rules/S5506/rule.adoc | 10 +- rules/S5507/rule.adoc | 2 +- rules/S5523/rule.adoc | 4 +- rules/S5524/rule.adoc | 2 +- rules/S5526/rule.adoc | 14 +- rules/S5527/java/rule.adoc | 6 +- rules/S5531/rule.adoc | 4 +- rules/S5539/rule.adoc | 4 +- rules/S5547/csharp/rule.adoc | 4 +- rules/S5549/description.adoc | 2 +- rules/S5566/rule.adoc | 14 +- rules/S5594/xml/rule.adoc | 2 +- rules/S5604/ask-yourself.adoc | 2 +- rules/S5604/recommended.adoc | 2 +- rules/S5604/xml/rule.adoc | 4 +- rules/S5607/rule.adoc | 4 +- rules/S5625/rule.adoc | 10 +- rules/S5631/rule.adoc | 2 +- rules/S5632/description.adoc | 4 +- rules/S5633/rule.adoc | 2 +- rules/S5639/rule.adoc | 2 +- rules/S5642/rule.adoc | 6 +- rules/S5644/rule.adoc | 6 +- rules/S5650/rule.adoc | 6 +- rules/S5651/rule.adoc | 6 +- rules/S5654/rule.adoc | 8 +- rules/S5655/rule.adoc | 2 +- rules/S5659/description.adoc | 2 +- rules/S5659/java/rule.adoc | 4 +- rules/S5665/rule.adoc | 2 +- rules/S5669/rule.adoc | 2 +- rules/S5673/rule.adoc | 2 +- rules/S5679/rule.adoc | 6 +- rules/S5680/rule.adoc | 4 +- rules/S5685/rule.adoc | 2 +- rules/S5689/ask-yourself.adoc | 2 +- rules/S5689/java/rule.adoc | 2 +- rules/S5689/javascript/rule.adoc | 4 +- rules/S5689/recommended.adoc | 2 +- rules/S5691/ask-yourself.adoc | 2 +- rules/S5691/description.adoc | 2 +- rules/S5696/description.adoc | 2 +- rules/S5704/rule.adoc | 8 +- rules/S5706/rule.adoc | 10 +- rules/S5707/rule.adoc | 8 +- rules/S5708/description.adoc | 8 +- rules/S5708/python/rule.adoc | 2 +- rules/S5709/rule.adoc | 10 +- rules/S5712/rule.adoc | 6 +- rules/S5713/description.adoc | 6 +- rules/S5713/php/rule.adoc | 6 +- rules/S5714/rule.adoc | 6 +- rules/S5717/rule.adoc | 2 +- rules/S5719/rule.adoc | 2 +- rules/S5720/rule.adoc | 6 +- rules/S5722/rule.adoc | 2 +- rules/S5727/rule.adoc | 4 +- rules/S5730/javascript/rule.adoc | 4 +- rules/S5732/javascript/rule.adoc | 2 +- rules/S5734/javascript/rule.adoc | 4 +- rules/S5736/javascript/rule.adoc | 4 +- rules/S5736/recommended.adoc | 2 +- rules/S5738/rule.adoc | 2 +- rules/S5739/description.adoc | 8 +- rules/S5739/recommended.adoc | 2 +- rules/S5742/javascript/rule.adoc | 2 +- rules/S5743/javascript/rule.adoc | 2 +- rules/S5744/rule.adoc | 4 +- rules/S5747/rule.adoc | 10 +- rules/S5750/recommended.adoc | 2 +- rules/S5753/description.adoc | 2 +- rules/S5754/rule.adoc | 10 +- rules/S5755/rule.adoc | 10 +- rules/S5756/rule.adoc | 2 +- rules/S5759/description.adoc | 2 +- rules/S5764/rule.adoc | 6 +- rules/S5766/csharp/rule.adoc | 8 +- rules/S5768/rule.adoc | 8 +- rules/S5769/rule.adoc | 4 +- rules/S5773/csharp/rule.adoc | 2 +- rules/S5773/description.adoc | 2 +- rules/S5776/rule.adoc | 2 +- rules/S5777/rule.adoc | 2 +- rules/S5779/description.adoc | 2 +- rules/S5782/rule.adoc | 2 +- rules/S5785/description.adoc | 2 +- rules/S5785/php/rule.adoc | 2 +- rules/S5786/rule.adoc | 6 +- rules/S5790/rule.adoc | 4 +- rules/S5793/rule.adoc | 20 +-- rules/S5795/rule.adoc | 8 +- rules/S5796/rule.adoc | 6 +- rules/S5797/rule.adoc | 2 +- rules/S5798/rule.adoc | 8 +- rules/S5799/rule.adoc | 4 +- rules/S5800/rule.adoc | 4 +- rules/S5801/rule.adoc | 16 +-- rules/S5802/cfamily/rule.adoc | 6 +- rules/S5803/rule.adoc | 10 +- rules/S5807/rule.adoc | 2 +- rules/S5808/java/rule.adoc | 8 +- rules/S5808/php/rule.adoc | 12 +- rules/S5813/rule.adoc | 8 +- rules/S5814/rule.adoc | 16 +-- rules/S5815/rule.adoc | 18 +-- rules/S5816/rule.adoc | 32 ++--- rules/S5821/rule.adoc | 6 +- rules/S5823/rule.adoc | 14 +- rules/S5824/rule.adoc | 8 +- rules/S5825/rule.adoc | 6 +- rules/S5826/rule.adoc | 4 +- rules/S5827/rule.adoc | 4 +- rules/S5828/rule.adoc | 6 +- rules/S5831/rule.adoc | 2 +- rules/S5832/cfamily/rule.adoc | 6 +- rules/S5833/rule.adoc | 16 +-- rules/S5838/rule.adoc | 148 ++++++++++---------- rules/S5841/rule.adoc | 14 +- rules/S5843/rule.adoc | 8 +- rules/S5845/description.adoc | 2 +- rules/S5845/javascript/rule.adoc | 2 +- rules/S5845/python/rule.adoc | 8 +- rules/S5846/rule.adoc | 6 +- rules/S5847/cfamily/rule.adoc | 4 +- rules/S5847/description.adoc | 2 +- rules/S5849/description.adoc | 2 +- rules/S5850/rule.adoc | 4 +- rules/S5852/description.adoc | 4 +- rules/S5852/java/rule.adoc | 2 +- rules/S5852/recommended.adoc | 8 +- rules/S5853/rule.adoc | 4 +- rules/S5854/rule.adoc | 2 +- rules/S5856/rule.adoc | 2 +- rules/S5857/rule.adoc | 2 +- rules/S5863/java/rule.adoc | 2 +- rules/S5864/rule.adoc | 2 +- rules/S5866/rule.adoc | 2 +- rules/S5867/rule.adoc | 4 +- rules/S5868/rule.adoc | 2 +- rules/S5869/rule.adoc | 2 +- rules/S5870/rule.adoc | 2 +- rules/S5871/rule.adoc | 2 +- rules/S5876/java/rule.adoc | 2 +- rules/S5876/php/rule.adoc | 4 +- rules/S5878/python/rule.adoc | 2 +- rules/S5883/javascript/rule.adoc | 4 +- rules/S5899/description.adoc | 4 +- rules/S5905/rule.adoc | 8 +- rules/S5906/rule.adoc | 60 ++++---- rules/S5914/rule.adoc | 10 +- rules/S5915/description.adoc | 2 +- rules/S5917/rule.adoc | 6 +- rules/S5918/rule.adoc | 10 +- rules/S5939/description.adoc | 2 +- rules/S5939/see.adoc | 4 +- rules/S5939/vbnet/rule.adoc | 2 +- rules/S5944/rule.adoc | 4 +- rules/S5945/rule.adoc | 14 +- rules/S5946/rule.adoc | 10 +- rules/S5950/rule.adoc | 22 +-- rules/S5952/rule.adoc | 6 +- rules/S5954/rule.adoc | 10 +- rules/S5956/rule.adoc | 6 +- rules/S5957/rule.adoc | 2 +- rules/S5958/java/rule.adoc | 4 +- rules/S5958/javascript/rule.adoc | 6 +- rules/S5960/rule.adoc | 6 +- rules/S5962/rule.adoc | 4 +- rules/S5963/rule.adoc | 4 +- rules/S5964/rule.adoc | 8 +- rules/S5970/rule.adoc | 4 +- rules/S5972/rule.adoc | 14 +- rules/S5973/rule.adoc | 2 +- rules/S5974/rule.adoc | 2 +- rules/S5977/rule.adoc | 2 +- rules/S5978/rule.adoc | 2 +- rules/S5979/rule.adoc | 12 +- rules/S5981/rule.adoc | 10 +- rules/S5982/cfamily/rule.adoc | 4 +- rules/S5993/rule.adoc | 2 +- rules/S5995/rule.adoc | 18 +-- rules/S5996/rule.adoc | 4 +- rules/S5997/rule.adoc | 2 +- rules/S5998/rule.adoc | 6 +- rules/S5999/rule.adoc | 2 +- rules/S6000/rule.adoc | 8 +- rules/S6001/rule.adoc | 4 +- rules/S6003/rule.adoc | 6 +- rules/S6004/rule.adoc | 4 +- rules/S6005/rule.adoc | 8 +- rules/S6006/rule.adoc | 4 +- rules/S6007/rule.adoc | 6 +- rules/S6009/rule.adoc | 12 +- rules/S6010/rule.adoc | 6 +- rules/S6011/rule.adoc | 8 +- rules/S6012/rule.adoc | 2 +- rules/S6013/rule.adoc | 4 +- rules/S6015/rule.adoc | 10 +- rules/S6016/rule.adoc | 8 +- rules/S6018/rule.adoc | 4 +- rules/S6019/rule.adoc | 4 +- rules/S6020/rule.adoc | 4 +- rules/S6021/rule.adoc | 8 +- rules/S6022/rule.adoc | 6 +- rules/S6023/rule.adoc | 8 +- rules/S6024/rule.adoc | 6 +- rules/S6026/rule.adoc | 4 +- rules/S6027/rule.adoc | 10 +- rules/S6029/rule.adoc | 4 +- rules/S6030/rule.adoc | 20 +-- rules/S6031/rule.adoc | 8 +- rules/S6032/rule.adoc | 6 +- rules/S6033/rule.adoc | 12 +- rules/S6038/rule.adoc | 16 +-- rules/S6045/rule.adoc | 8 +- rules/S6046/rule.adoc | 6 +- rules/S6061/rule.adoc | 4 +- rules/S6068/rule.adoc | 4 +- rules/S6069/rule.adoc | 6 +- rules/S6070/rule.adoc | 4 +- rules/S6073/rule.adoc | 4 +- rules/S6079/rule.adoc | 4 +- rules/S6080/rule.adoc | 2 +- rules/S6092/rule.adoc | 20 +-- rules/S6096/description.adoc | 2 +- rules/S6103/rule.adoc | 6 +- rules/S6104/rule.adoc | 4 +- rules/S6105/description.adoc | 2 +- rules/S6108/rule.adoc | 2 +- rules/S6109/rule.adoc | 2 +- rules/S6112/description.adoc | 4 +- rules/S6112/vbnet/rule.adoc | 4 +- rules/S6145/rule.adoc | 6 +- rules/S6146/rule.adoc | 4 +- rules/S786/rule.adoc | 4 +- rules/S787/rule.adoc | 2 +- rules/S793/rule.adoc | 4 +- rules/S796/rule.adoc | 2 +- rules/S798/rule.adoc | 12 +- rules/S802/rule.adoc | 4 +- rules/S804/rule.adoc | 2 +- rules/S810/rule.adoc | 2 +- rules/S813/rule.adoc | 2 +- rules/S814/rule.adoc | 4 +- rules/S823/rule.adoc | 2 +- rules/S832/rule.adoc | 2 +- rules/S841/rule.adoc | 2 +- rules/S842/rule.adoc | 2 +- rules/S853/rule.adoc | 2 +- rules/S854/rule.adoc | 4 +- rules/S856/rule.adoc | 2 +- rules/S859/cfamily/rule.adoc | 2 +- rules/S859/description.adoc | 8 +- rules/S860/rule.adoc | 6 +- rules/S864/cfamily/rule.adoc | 4 +- rules/S864/description.adoc | 14 +- rules/S867/rule.adoc | 16 +-- rules/S868/rule.adoc | 2 +- rules/S871/rule.adoc | 12 +- rules/S872/rule.adoc | 6 +- rules/S874/rule.adoc | 2 +- rules/S876/rule.adoc | 2 +- rules/S877/rule.adoc | 4 +- rules/S878/exceptions.adoc | 2 +- rules/S878/javascript/rule.adoc | 2 +- rules/S879/rule.adoc | 4 +- rules/S886/rule.adoc | 2 +- rules/S888/description.adoc | 2 +- rules/S888/exceptions.adoc | 2 +- rules/S888/javascript/rule.adoc | 2 +- rules/S899/java/rule.adoc | 16 +-- rules/S905/description.adoc | 2 +- rules/S905/python/rule.adoc | 2 +- rules/S907/description.adoc | 2 +- rules/S907/pli/rule.adoc | 2 +- rules/S907/plsql/rule.adoc | 2 +- rules/S907/rpg/rule.adoc | 2 +- rules/S907/tsql/rule.adoc | 2 +- rules/S907/vb6/rule.adoc | 4 +- rules/S907/vbnet/rule.adoc | 2 +- rules/S909/description.adoc | 2 +- rules/S909/plsql/rule.adoc | 2 +- rules/S912/rule.adoc | 2 +- rules/S920/rule.adoc | 2 +- rules/S924/rule.adoc | 2 +- rules/S925/cobol/rule.adoc | 2 +- rules/S927/csharp/rule.adoc | 2 +- rules/S929/rule.adoc | 2 +- rules/S930/javascript/rule.adoc | 2 +- rules/S930/python/rule.adoc | 2 +- rules/S932/rule.adoc | 2 +- rules/S935/cfamily/rule.adoc | 2 +- rules/S935/typescript/rule.adoc | 4 +- rules/S936/rule.adoc | 2 +- rules/S941/rule.adoc | 2 +- rules/S945/rule.adoc | 2 +- rules/S948/rule.adoc | 4 +- rules/S949/rule.adoc | 2 +- rules/S954/rule.adoc | 2 +- rules/S955/rule.adoc | 2 +- rules/S956/rule.adoc | 2 +- rules/S957/rule.adoc | 4 +- rules/S958/rule.adoc | 2 +- rules/S959/rule.adoc | 6 +- rules/S964/rule.adoc | 2 +- rules/S967/rule.adoc | 2 +- rules/S968/rule.adoc | 2 +- rules/S969/rule.adoc | 10 +- rules/S970/rule.adoc | 2 +- rules/S972/rule.adoc | 2 +- rules/S977/rule.adoc | 2 +- rules/S978/rule.adoc | 2 +- rules/S980/rule.adoc | 2 +- rules/S982/rule.adoc | 6 +- rules/S983/rule.adoc | 14 +- rules/S984/rule.adoc | 4 +- rules/S985/rule.adoc | 4 +- rules/S986/rule.adoc | 2 +- rules/S988/rule.adoc | 4 +- rules/S989/rule.adoc | 2 +- rules/S990/rule.adoc | 2 +- rules/S991/rule.adoc | 2 +- rules/S995/rule.adoc | 2 +- rules/S996/rule.adoc | 4 +- rules/S997/description.adoc | 4 +- rules/S998/rule.adoc | 2 +- rules/S999/description.adoc | 6 +- rules/S999/plsql/rule.adoc | 2 +- 2483 files changed, 5577 insertions(+), 5572 deletions(-) diff --git a/rules/S100/abap/rule.adoc b/rules/S100/abap/rule.adoc index ef8825515f..34bf0d6aa2 100644 --- a/rules/S100/abap/rule.adoc +++ b/rules/S100/abap/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression ``^([A-Z0-9_]*|[a-z0-9_]*)$``: +With default provided regular expression ``++^([A-Z0-9_]*|[a-z0-9_]*)$++``: ---- METHOD MyMethod diff --git a/rules/S100/apex/rule.adoc b/rules/S100/apex/rule.adoc index 1e13f197f5..3cf58bbea5 100644 --- a/rules/S100/apex/rule.adoc +++ b/rules/S100/apex/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With provided regular expression ``^[a-z][a-zA-Z0-9_]*$``: +With provided regular expression ``++^[a-z][a-zA-Z0-9_]*$++``: ---- public void DoSomething(){...} diff --git a/rules/S100/cfamily/rule.adoc b/rules/S100/cfamily/rule.adoc index 036de6f660..24514a2fd3 100644 --- a/rules/S100/cfamily/rule.adoc +++ b/rules/S100/cfamily/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression: ``^[a-z][a-zA-Z0-9]*$``: +With default provided regular expression: ``++^[a-z][a-zA-Z0-9]*$++``: ---- void DoSomething (void); diff --git a/rules/S100/csharp/rule.adoc b/rules/S100/csharp/rule.adoc index 3722cfe52e..6692d60c58 100644 --- a/rules/S100/csharp/rule.adoc +++ b/rules/S100/csharp/rule.adoc @@ -1,4 +1,4 @@ -Shared naming conventions allow teams to collaborate efficiently. This rule checks whether or not method and property names are PascalCased. To reduce noise, two consecutive upper case characters are allowed unless they form the whole name. So, ``MyXMethod`` is compliant, but ``XM`` on its own is not. +Shared naming conventions allow teams to collaborate efficiently. This rule checks whether or not method and property names are PascalCased. To reduce noise, two consecutive upper case characters are allowed unless they form the whole name. So, ``++MyXMethod++`` is compliant, but ``++XM++`` on its own is not. == Noncompliant Code Example @@ -14,10 +14,10 @@ public int DoSomething() {...} == Exceptions -* The rule ignores members in types that are marked with ``ComImportAttribute`` or ``InterfaceTypeAttribute``. -* The rule ignores ``extern`` methods. -* The rule allows for two-letter acronyms in which both letters are capitalized, as shown in the following identifier: ``ExecuteOnUIThread``. -* Furthermore, when ``'_'`` character is found in a name, the camel casing is not enforced. +* The rule ignores members in types that are marked with ``++ComImportAttribute++`` or ``++InterfaceTypeAttribute++``. +* The rule ignores ``++extern++`` methods. +* The rule allows for two-letter acronyms in which both letters are capitalized, as shown in the following identifier: ``++ExecuteOnUIThread++``. +* Furthermore, when ``++'_'++`` character is found in a name, the camel casing is not enforced. ---- void My_method(){...} // valid diff --git a/rules/S100/go/rule.adoc b/rules/S100/go/rule.adoc index 1655c6e31f..9d555aad14 100644 --- a/rules/S100/go/rule.adoc +++ b/rules/S100/go/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression: ``^(_|[a-zA-Z0-9]+)$``: +With default provided regular expression: ``++^(_|[a-zA-Z0-9]+)$++``: ---- func execute_all() { diff --git a/rules/S100/java/rule.adoc b/rules/S100/java/rule.adoc index fe2b6775e9..25da7cdb1e 100644 --- a/rules/S100/java/rule.adoc +++ b/rules/S100/java/rule.adoc @@ -2,7 +2,7 @@ Shared naming conventions allow teams to collaborate efficiently. This rule chec == Noncompliant Code Example -With default provided regular expression ``^[a-z][a-zA-Z0-9]*$``: +With default provided regular expression ``++^[a-z][a-zA-Z0-9]*$++``: ---- public int DoSomething(){...} diff --git a/rules/S100/javascript/rule.adoc b/rules/S100/javascript/rule.adoc index 9fb1a4b294..f074a4e1f0 100644 --- a/rules/S100/javascript/rule.adoc +++ b/rules/S100/javascript/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With the default regular expression ``^[a-z][a-zA-Z0-9]*$``: +With the default regular expression ``++^[a-z][a-zA-Z0-9]*$++``: ---- function DoSomething(){...} // Noncompliant diff --git a/rules/S100/php/rule.adoc b/rules/S100/php/rule.adoc index 617a67b522..5c2b01928d 100644 --- a/rules/S100/php/rule.adoc +++ b/rules/S100/php/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression: ``^[a-z][a-zA-Z0-9]*$``: +With default provided regular expression: ``++^[a-z][a-zA-Z0-9]*$++``: ---- function DoSomething(){...} @@ -16,7 +16,7 @@ function doSomething(){...} == Exceptions -Methods with an ``@inheritdoc`` annotation, as well as magic methods (``__construct()``, ``__destruct()``, ``__call()``, ``__callStatic()``, ``__get()``, ``__set()``, ``__isset()``, ``__unset()``, ``__sleep()``, ``__wakeup()``, ``__toString()``, ``__invoke()``, ``__set\_state()``, ``__clone()``, ``__debugInfo()``) are ignored. +Methods with an ``++@inheritdo{cpp}`` annotation, as well as magic methods (``++__construct()++``, ``++__destruct()++``, ``++__call()++``, ``++__callStatic()++``, ``++__get()++``, ``++__set()++``, ``++__isset()++``, ``++__unset()++``, ``++__sleep()++``, ``++__wakeup()++``, ``++__toString()++``, ``++__invoke()++``, ``++__set\_state()++``, ``++__clone()++``, ``++__debugInfo()++``) are ignored. ---- function __construct(){...} diff --git a/rules/S100/python/rule.adoc b/rules/S100/python/rule.adoc index 0c70a200f0..3a78aa6587 100644 --- a/rules/S100/python/rule.adoc +++ b/rules/S100/python/rule.adoc @@ -2,7 +2,7 @@ Sharing some naming conventions is a key point to make it possible for a team to == Noncompliant Code Example -With default provided regular expression: ``^[a-z_][a-z0-9_]*$`` +With default provided regular expression: ``++^[a-z_][a-z0-9_]*$++`` ---- class MyClass: diff --git a/rules/S100/rpg/rule.adoc b/rules/S100/rpg/rule.adoc index d7421760b6..661480d063 100644 --- a/rules/S100/rpg/rule.adoc +++ b/rules/S100/rpg/rule.adoc @@ -2,7 +2,7 @@ Sharing some naming conventions is a key point to make it possible for a team to == Noncompliant Code Example -With default provided regular expression ``^SR[a-zA-Z0-9]*$``: +With default provided regular expression ``++^SR[a-zA-Z0-9]*$++``: ---- C XXXXX BEGSR diff --git a/rules/S1003/rule.adoc b/rules/S1003/rule.adoc index dfd29e44ad..ce9cc12358 100644 --- a/rules/S1003/rule.adoc +++ b/rules/S1003/rule.adoc @@ -53,5 +53,5 @@ The issue only happens if the using directive is at global scope or at namespace == See * MISRA {cpp}:2008, 7-3-6 - using-directives and using-declarations (excluding class scope or function scope using-declarations) shall not be used in header files. -* https://github.com/isocpp/CppCoreGuidelines/blob/036324/CppCoreGuidelines.md#sf7-dont-write-using-namespace-at-global-scope-in-a-header-file[{cpp} Core Guidelines SF.7] - Don’t write ``using namespace`` at global scope in a header file +* https://github.com/isocpp/CppCoreGuidelines/blob/036324/CppCoreGuidelines.md#sf7-dont-write-using-namespace-at-global-scope-in-a-header-file[{cpp} Core Guidelines SF.7] - Don’t write ``++using namespace++`` at global scope in a header file diff --git a/rules/S1005/plsql/rule.adoc b/rules/S1005/plsql/rule.adoc index c80a418550..59eeb42c2d 100644 --- a/rules/S1005/plsql/rule.adoc +++ b/rules/S1005/plsql/rule.adoc @@ -1,4 +1,4 @@ -Procedures, unlike functions, do not return values. The ``RETURN`` statement therefore, when used within a procedure, is used to prematurely end the procedure. However, having multiple exit points (i.e. more than the ``END`` of the procedure itself), increases the complexity of the procedure and makes it harder to understand and debug. +Procedures, unlike functions, do not return values. The ``++RETURN++`` statement therefore, when used within a procedure, is used to prematurely end the procedure. However, having multiple exit points (i.e. more than the ``++END++`` of the procedure itself), increases the complexity of the procedure and makes it harder to understand and debug. == Noncompliant Code Example diff --git a/rules/S1009/rule.adoc b/rules/S1009/rule.adoc index b329543ffe..1f299fdcda 100644 --- a/rules/S1009/rule.adoc +++ b/rules/S1009/rule.adoc @@ -1,4 +1,4 @@ -The use of ``enum`` as a bit-field type is prohibited because ISO/IEC 14882:2003 does not explicitly define the underlying representation as ``signed`` or ``unsigned``. It is therefore not possible to determine the exact number of bits required to represent all values in the enumeration. +The use of ``++enum++`` as a bit-field type is prohibited because ISO/IEC 14882:2003 does not explicitly define the underlying representation as ``++signed++`` or ``++unsigned++``. It is therefore not possible to determine the exact number of bits required to represent all values in the enumeration. == Noncompliant Code Example diff --git a/rules/S101/abap/rule.adoc b/rules/S101/abap/rule.adoc index 1122f8ac26..9f568db1fd 100644 --- a/rules/S101/abap/rule.adoc +++ b/rules/S101/abap/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With the default provided regular expression ``^([A-Z0-9_]*|[a-z0-9_]*)$``: +With the default provided regular expression ``++^([A-Z0-9_]*|[a-z0-9_]*)$++``: ---- CLASS MyClass DEFINITION. diff --git a/rules/S101/apex/rule.adoc b/rules/S101/apex/rule.adoc index 5b98076cc3..33baab0eb9 100644 --- a/rules/S101/apex/rule.adoc +++ b/rules/S101/apex/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression ``^[A-Z][a-zA-Z0-9_]*$``: +With default provided regular expression ``++^[A-Z][a-zA-Z0-9_]*$++``: ---- class myClass {} diff --git a/rules/S101/cfamily/rule.adoc b/rules/S101/cfamily/rule.adoc index 7ff8d29620..df780b6cd5 100644 --- a/rules/S101/cfamily/rule.adoc +++ b/rules/S101/cfamily/rule.adoc @@ -3,7 +3,7 @@ This rule allows to check that all class names (along with Objective-C interface == Noncompliant Code Example -With default provided regular expression ``^[A-Z][a-zA-Z0-9]*$``: +With default provided regular expression ``++^[A-Z][a-zA-Z0-9]*$++``: ---- // C++ diff --git a/rules/S101/csharp/rule.adoc b/rules/S101/csharp/rule.adoc index 4d30c7c1c7..a0375dfd60 100644 --- a/rules/S101/csharp/rule.adoc +++ b/rules/S101/csharp/rule.adoc @@ -1,4 +1,4 @@ -Shared naming conventions allow teams to collaborate efficiently. This rule checks whether or not type names are using PascalCase. To reduce noise, two consecutive upper case characters are allowed unless they form the whole type name. So, ``MyXClass`` is compliant, but ``XC`` on its own is not. +Shared naming conventions allow teams to collaborate efficiently. This rule checks whether or not type names are using PascalCase. To reduce noise, two consecutive upper case characters are allowed unless they form the whole type name. So, ``++MyXClass++`` is compliant, but ``++X{cpp}`` on its own is not. == Noncompliant Code Example @@ -16,9 +16,9 @@ class SomeName42 {...} == Exceptions -* The rule ignores types that are marked with ``ComImportAttribute`` or ``InterfaceTypeAttribute``. -* The rule allows for two-letter acronyms in which both letters are capitalized, as shown in the following identifier: ``IOStream`` -* The rule allows having ``'_'`` characters in class names inside test projects. +* The rule ignores types that are marked with ``++ComImportAttribute++`` or ``++InterfaceTypeAttribute++``. +* The rule allows for two-letter acronyms in which both letters are capitalized, as shown in the following identifier: ``++IOStream++`` +* The rule allows having ``++'_'++`` characters in class names inside test projects. ---- class Some_Name___42 {...} // valid in test diff --git a/rules/S101/flex/rule.adoc b/rules/S101/flex/rule.adoc index 7370feeb8a..9039219cbc 100644 --- a/rules/S101/flex/rule.adoc +++ b/rules/S101/flex/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression ``^[A-Z][a-zA-Z0-9]*$``: +With default provided regular expression ``++^[A-Z][a-zA-Z0-9]*$++``: ---- public class myClass {...} diff --git a/rules/S101/go/rule.adoc b/rules/S101/go/rule.adoc index 5852a358b6..db8142467f 100644 --- a/rules/S101/go/rule.adoc +++ b/rules/S101/go/rule.adoc @@ -6,7 +6,7 @@ Note that the casing of the first character determines if the type is exported o == Noncompliant Code Example -With default provided regular expression ``^[a-zA-Z][a-zA-Z0-9]*$``: +With default provided regular expression ``++^[a-zA-Z][a-zA-Z0-9]*$++``: ---- type my_struct struct {...} diff --git a/rules/S101/noncompliant.adoc b/rules/S101/noncompliant.adoc index cb483c1fa2..194604a0f1 100644 --- a/rules/S101/noncompliant.adoc +++ b/rules/S101/noncompliant.adoc @@ -1,6 +1,6 @@ == Noncompliant Code Example -With default provided regular expression ``^[A-Z][a-zA-Z0-9]*$``: +With default provided regular expression ``++^[A-Z][a-zA-Z0-9]*$++``: ---- class my_class {...} diff --git a/rules/S101/python/rule.adoc b/rules/S101/python/rule.adoc index e58a57d6bf..69ac68b7f7 100644 --- a/rules/S101/python/rule.adoc +++ b/rules/S101/python/rule.adoc @@ -4,7 +4,7 @@ The default regular expression is based on PEP-8 standard. It allows "CapWords" == Noncompliant Code Example -With default provided regular expression ``^_?([A-Z_][a-zA-Z0-9]\*|[a-z_][a-z0-9_]\*)$``: +With default provided regular expression ``++^_?([A-Z_][a-zA-Z0-9]\*|[a-z_][a-z0-9_]\*)$++``: ---- class myClass: # Noncompliant diff --git a/rules/S101/ruby/rule.adoc b/rules/S101/ruby/rule.adoc index d81db16f3f..3606dd9493 100644 --- a/rules/S101/ruby/rule.adoc +++ b/rules/S101/ruby/rule.adoc @@ -2,7 +2,7 @@ include::../description.adoc[] == Noncompliant Code Example -With default provided regular expression ``^[A-Z][a-zA-Z0-9]*$``: +With default provided regular expression ``++^[A-Z][a-zA-Z0-9]*$++``: ---- class my_class diff --git a/rules/S101/vbnet/rule.adoc b/rules/S101/vbnet/rule.adoc index 0ae7d14dcc..1606d98f69 100644 --- a/rules/S101/vbnet/rule.adoc +++ b/rules/S101/vbnet/rule.adoc @@ -8,7 +8,7 @@ The default configuration is the one recommended by Microsoft: == Noncompliant Code Example -With the default regular expression ``^([A-Z]{1,3}[a-z0-9]+)*([A-Z]{2})?$``: +With the default regular expression ``++^([A-Z]{1,3}[a-z0-9]+)*([A-Z]{2})?$++``: ---- Class foo ' Noncompliant diff --git a/rules/S1012/rule.adoc b/rules/S1012/rule.adoc index 21f77d74a2..59b7754ae2 100644 --- a/rules/S1012/rule.adoc +++ b/rules/S1012/rule.adoc @@ -1,4 +1,4 @@ -The use of ``virtual`` base classes can introduce a number of undefined and potentially confusing behaviours. Therefore, a base class shall only be declared ``virtual`` if that base class is to be used as a common base class in a diamond hierarchy. +The use of ``++virtual++`` base classes can introduce a number of undefined and potentially confusing behaviours. Therefore, a base class shall only be declared ``++virtual++`` if that base class is to be used as a common base class in a diamond hierarchy. == Noncompliant Code Example diff --git a/rules/S1013/rule.adoc b/rules/S1013/rule.adoc index 4ae884ab59..7f3c67ff2a 100644 --- a/rules/S1013/rule.adoc +++ b/rules/S1013/rule.adoc @@ -1,4 +1,4 @@ -If a base class is both ``virtual`` and non-virtual in a multiple inheritance hierarchy then there will be at least two copies of the base class sub-object in the derived object. This may not be consistent with developer expectations. +If a base class is both ``++virtual++`` and non-virtual in a multiple inheritance hierarchy then there will be at least two copies of the base class sub-object in the derived object. This may not be consistent with developer expectations. == Noncompliant Code Example diff --git a/rules/S1016/rule.adoc b/rules/S1016/rule.adoc index 913ff94886..9b9718b45d 100644 --- a/rules/S1016/rule.adoc +++ b/rules/S1016/rule.adoc @@ -1,4 +1,4 @@ -For code compliant with {cpp}98 or {cpp}03 standards, declaring overriding virtual functions with the ``virtual`` keyword removes the need to check the base class to determine whether a function is virtual. +For code compliant with {cpp}98 or {cpp}03 standards, declaring overriding virtual functions with the ``++virtual++`` keyword removes the need to check the base class to determine whether a function is virtual. == Noncompliant Code Example diff --git a/rules/S1017/rule.adoc b/rules/S1017/rule.adoc index 3303033ed9..075c1de8ff 100644 --- a/rules/S1017/rule.adoc +++ b/rules/S1017/rule.adoc @@ -1,6 +1,6 @@ -A ``virtual`` function has an implementation that _may_ be replaced in a child class. A pure ``virtual`` has no implementation, and _must_ be implemented in child classes. +A ``++virtual++`` function has an implementation that _may_ be replaced in a child class. A pure ``++virtual++`` has no implementation, and _must_ be implemented in child classes. -Hiding a base class implementation with a "pure implementation" (``=0``) is sure to confuse extenders, who may not be aware of the base class' implementation. Instead, they'll see there's no implementation in the class they're extending and assume that none exists. When that base class implementation contains crucial functionality such as freeing resources, this could cause future users of the class to introduce bugs. +Hiding a base class implementation with a "pure implementation" (``++=0++``) is sure to confuse extenders, who may not be aware of the base class' implementation. Instead, they'll see there's no implementation in the class they're extending and assume that none exists. When that base class implementation contains crucial functionality such as freeing resources, this could cause future users of the class to introduce bugs. This rule raises an issue if a pure virtual function overrides a virtual function that is not pure. diff --git a/rules/S1019/rule.adoc b/rules/S1019/rule.adoc index 2ae042083f..80f3a4d2f8 100644 --- a/rules/S1019/rule.adoc +++ b/rules/S1019/rule.adoc @@ -1,8 +1,8 @@ During construction and destruction of an object, its final type may be different from that of the completely constructed object. The result of using an object’s dynamic type in a constructor or destructor may not be consistent with developer expectations. The dynamic type of an object is used in the following constructs: -* ``typeid`` on a class with a virtual function or a virtual function in a base class. -* ``dynamic_cast`` +* ``++typeid++`` on a class with a virtual function or a virtual function in a base class. +* ``++dynamic_cast++`` * A virtual call to a virtual function. This rule also prohibits a call being made to a pure virtual function from within a constructor or destructor. Such calls lead to undefined behaviour. diff --git a/rules/S1027/rule.adoc b/rules/S1027/rule.adoc index 513888eff3..c89c11452e 100644 --- a/rules/S1027/rule.adoc +++ b/rules/S1027/rule.adoc @@ -1,4 +1,4 @@ -Using a qualified-id or prefixing the identifier with ``this->`` ensures that the entity chosen is consistent with developer expectations. +Using a qualified-id or prefixing the identifier with ``++this->++`` ensures that the entity chosen is consistent with developer expectations. == Noncompliant Code Example diff --git a/rules/S1035/rule.adoc b/rules/S1035/rule.adoc index 99c34febc5..c0c825e8be 100644 --- a/rules/S1035/rule.adoc +++ b/rules/S1035/rule.adoc @@ -1,4 +1,4 @@ -If a pointer to an object is used as an exception, the code that will catch the exception may or may not have to delete the pointed-to object. This is even more complex in the exception case than in classical manual memory management, because of the distance between the ``throw`` statements and the matching ``catch``. +If a pointer to an object is used as an exception, the code that will catch the exception may or may not have to delete the pointed-to object. This is even more complex in the exception case than in classical manual memory management, because of the distance between the ``++throw++`` statements and the matching ``++catch++``. Throwing by value is just simpler and less error prone. diff --git a/rules/S1036/rule.adoc b/rules/S1036/rule.adoc index 4e769f70eb..67fbc3fd09 100644 --- a/rules/S1036/rule.adoc +++ b/rules/S1036/rule.adoc @@ -1,8 +1,8 @@ -Having a ``switch`` and its cases wholly encompassed by a control structure such as a ``try``, ``@try``, ``catch``, ``@catch``, or a loop is perfectly acceptable. (``try`` and ``catch`` are used hereafter to refer to both variants.) It is also acceptable to have a ``goto`` and its target label wholly encompassed in a control structure. +Having a ``++switch++`` and its cases wholly encompassed by a control structure such as a ``++try++``, ``++@try++``, ``++catch++``, ``++@catch++``, or a loop is perfectly acceptable. (``++try++`` and ``++catch++`` are used hereafter to refer to both variants.) It is also acceptable to have a ``++goto++`` and its target label wholly encompassed in a control structure. -What is not acceptable is using a ``goto`` or ``case`` to suddenly jump into the body of a ``try``, ``catch``, Objective-C ``@finally``, or loop structure. Tangling labels or ``switch`` blocks with other control structures results in code that is difficult, if not impossible to understand. More importantly, when it compiles (some of these constructs won't compile under ISO-conformant compilers), it can lead to unexpected results. Therefore this usage should be strictly avoided. +What is not acceptable is using a ``++goto++`` or ``++case++`` to suddenly jump into the body of a ``++try++``, ``++catch++``, Objective-C ``++@finally++``, or loop structure. Tangling labels or ``++switch++`` blocks with other control structures results in code that is difficult, if not impossible to understand. More importantly, when it compiles (some of these constructs won't compile under ISO-conformant compilers), it can lead to unexpected results. Therefore this usage should be strictly avoided. -This {cpp} code sample, which is also applicable to Objective-C if ``try`` and ``catch`` are converted to ``@try`` and ``@catch``, demonstrates jumping into a ``switch`` and into a ``try`` and ``catch`` : +This {cpp} code sample, which is also applicable to Objective-C if ``++try++`` and ``++catch++`` are converted to ``++@try++`` and ``++@catch++``, demonstrates jumping into a ``++switch++`` and into a ``++try++`` and ``++catch++`` : == Noncompliant Code Example diff --git a/rules/S1039/cfamily/rule.adoc b/rules/S1039/cfamily/rule.adoc index fcd66ca22e..a8474c2ed8 100644 --- a/rules/S1039/cfamily/rule.adoc +++ b/rules/S1039/cfamily/rule.adoc @@ -6,4 +6,4 @@ include::../compliant.adoc[] == See -* MISRA {cpp}:2008, 15-1-3 - An empty throw (``throw;``) shall only be used in the compound-statement of a catch handler. +* MISRA {cpp}:2008, 15-1-3 - An empty throw (``++throw;++``) shall only be used in the compound-statement of a catch handler. diff --git a/rules/S1039/description.adoc b/rules/S1039/description.adoc index d44f6f4979..058a2e91b6 100644 --- a/rules/S1039/description.adoc +++ b/rules/S1039/description.adoc @@ -1,3 +1,3 @@ -An empty ``throw`` re-throws the temporary object that represents the exception being processed. It is intended to allow partially handling an exception at some level in the call stack (for instance, logging an issue) but then forwarding it to a higher level where it will be fully handled. +An empty ``++throw++`` re-throws the temporary object that represents the exception being processed. It is intended to allow partially handling an exception at some level in the call stack (for instance, logging an issue) but then forwarding it to a higher level where it will be fully handled. -However, syntactically, there is nothing to prevent ``throw;`` being used outside a catch handler, where there might be no exception object to re-throw. In such a case, the program would call ``std::terminate``, which is probably not the expected behavior. +However, syntactically, there is nothing to prevent ``++throw;++`` being used outside a catch handler, where there might be no exception object to re-throw. In such a case, the program would call ``++std::terminate++``, which is probably not the expected behavior. diff --git a/rules/S1040/rule.adoc b/rules/S1040/rule.adoc index b511cbc8a9..a2e5e1587c 100644 --- a/rules/S1040/rule.adoc +++ b/rules/S1040/rule.adoc @@ -1,4 +1,4 @@ -Throwing an exception during startup or shutdown results in an implementation-defined termination of the program. This is because there is no where to put ``try``/``catch`` blocks to catch exceptions thrown in the startup phase, when static objects are being constructed, or during the shutdown phase, when those static objects are being destroyed. +Throwing an exception during startup or shutdown results in an implementation-defined termination of the program. This is because there is no where to put ``++try++``/``++catch++`` blocks to catch exceptions thrown in the startup phase, when static objects are being constructed, or during the shutdown phase, when those static objects are being destroyed. Therefore exceptions should not be thrown during the construction or destruction of static objects. diff --git a/rules/S1041/compliant.adoc b/rules/S1041/compliant.adoc index 8a548b8bd0..af4a4b75be 100644 --- a/rules/S1041/compliant.adoc +++ b/rules/S1041/compliant.adoc @@ -1,6 +1,6 @@ == Compliant Solution -For the majority of programs this will mean ``main`` should look like: +For the majority of programs this will mean ``++main++`` should look like: ---- int32_t main( ) diff --git a/rules/S1041/plsql/rule.adoc b/rules/S1041/plsql/rule.adoc index d5fc62c0db..0fa5fab45c 100644 --- a/rules/S1041/plsql/rule.adoc +++ b/rules/S1041/plsql/rule.adoc @@ -1,4 +1,4 @@ -Ensure that every possible exception is caught by using a ``WHEN OTHERS`` clause. +Ensure that every possible exception is caught by using a ``++WHEN OTHERS++`` clause. == Noncompliant Code Example diff --git a/rules/S1045/description.adoc b/rules/S1045/description.adoc index ac5897444d..e483faa136 100644 --- a/rules/S1045/description.adoc +++ b/rules/S1045/description.adoc @@ -1 +1 @@ -Exceptions handlers (``catch ()``) are evaluated in the order they are written. Once a match is found, the evaluation stops. If there is a handler for a base class followed by a handler for class derived from that base class, the second handler will never trigger: The handler for the base class will match the derived class, and will be the only executed handler. The derived class handler is dead code. +Exceptions handlers (``++catch ()++``) are evaluated in the order they are written. Once a match is found, the evaluation stops. If there is a handler for a base class followed by a handler for class derived from that base class, the second handler will never trigger: The handler for the base class will match the derived class, and will be the only executed handler. The derived class handler is dead code. diff --git a/rules/S1045/php/rule.adoc b/rules/S1045/php/rule.adoc index e6e8bc54ab..3bc56c0951 100644 --- a/rules/S1045/php/rule.adoc +++ b/rules/S1045/php/rule.adoc @@ -1,11 +1,11 @@ -Exceptions handlers (``catch``) are evaluated in the order they are written. Once a match is found, the evaluation stops. +Exceptions handlers (``++catch++``) are evaluated in the order they are written. Once a match is found, the evaluation stops. -In some contexts a ``catch`` block is dead code as it will never catch any exception: +In some contexts a ``++catch++`` block is dead code as it will never catch any exception: * If there is a handler for a base class followed by a handler for class derived from that base class, the second handler will never trigger: the handler for the base class will match the derived class, and will be the only executed handler. -* When multiple ``catch`` blocks try to catch the same exception class, only the first one will be executed. +* When multiple ``++catch++`` blocks try to catch the same exception class, only the first one will be executed. -This rule raises an issue when a ``catch`` block catches every exception before a later ``catch`` block could catch it. +This rule raises an issue when a ``++catch++`` block catches every exception before a later ``++catch++`` block could catch it. == Noncompliant Code Example diff --git a/rules/S1045/python/rule.adoc b/rules/S1045/python/rule.adoc index f1d3b98790..e0d1582b13 100644 --- a/rules/S1045/python/rule.adoc +++ b/rules/S1045/python/rule.adoc @@ -1,12 +1,12 @@ -Exceptions handlers (``except:``) are evaluated in the order they are written. Once a match is found, the evaluation stops. +Exceptions handlers (``++except:++``) are evaluated in the order they are written. Once a match is found, the evaluation stops. In some contexts an except block is dead code as it will never catch any exception: * If there is a handler for a base class followed by a handler for class derived from that base class, the second handler will never trigger: The handler for the base class will match the derived class, and will be the only executed handler. -* When multiple ``except`` statements try to catch the same exception class, only the first one will be executed. -* In python 3, ``BaseException`` is the parent of every exception class. When ``BaseException`` is caught and the same try-except block has a bare ``except:`` statement, i.e. an ``except`` with no expression, the bare except will never catch anything. +* When multiple ``++except++`` statements try to catch the same exception class, only the first one will be executed. +* In python 3, ``++BaseException++`` is the parent of every exception class. When ``++BaseException++`` is caught and the same try-except block has a bare ``++except:++`` statement, i.e. an ``++except++`` with no expression, the bare except will never catch anything. -This rule raises an issue when an ``except`` block catches every exception before a later ``except`` block could catch it. +This rule raises an issue when an ``++except++`` block catches every exception before a later ``++except++`` block could catch it. == Noncompliant Code Example @@ -62,4 +62,4 @@ def foo(): == See -* Python Documentation - https://docs.python.org/3/reference/compound_stmts.html#the-try-statement[The ``try`` statement] +* Python Documentation - https://docs.python.org/3/reference/compound_stmts.html#the-try-statement[The ``++try++`` statement] diff --git a/rules/S1046/description.adoc b/rules/S1046/description.adoc index ce9bf01813..da42aacdf7 100644 --- a/rules/S1046/description.adoc +++ b/rules/S1046/description.adoc @@ -1,3 +1,3 @@ -The catch-all handler should come last in a chain of ``catch`` or ``@catch`` statements because it catches everything, and any more-specific ``catch``/``@catch`` that comes after it will never be used, even when the relevant condition occurs. +The catch-all handler should come last in a chain of ``++catch++`` or ``++@catch++`` statements because it catches everything, and any more-specific ``++catch++``/``++@catch++`` that comes after it will never be used, even when the relevant condition occurs. -This {cpp} code sample is very similar to the Objective-C equivalent with ``@try`` and ``@catch``. +This {cpp} code sample is very similar to the Objective-C equivalent with ``++@try++`` and ``++@catch++``. diff --git a/rules/S1050/rule.adoc b/rules/S1050/rule.adoc index 44ed75db86..884f98c1dd 100644 --- a/rules/S1050/rule.adoc +++ b/rules/S1050/rule.adoc @@ -1,4 +1,4 @@ -It is implementation-defined whether the call stack is unwound before ``terminate()`` is called, so the destructors of any automatic objects may or may not be executed. +It is implementation-defined whether the call stack is unwound before ``++terminate()++`` is called, so the destructors of any automatic objects may or may not be executed. == See diff --git a/rules/S1052/rule.adoc b/rules/S1052/rule.adoc index 8e9b0749b9..90ea030f79 100644 --- a/rules/S1052/rule.adoc +++ b/rules/S1052/rule.adoc @@ -1,4 +1,4 @@ -Various aspects of ``ctime`` are implementation-defined or unspecified, such as the formats of times. +Various aspects of ``++ctime++`` are implementation-defined or unspecified, such as the formats of times. == Noncompliant Code Example diff --git a/rules/S1053/rule.adoc b/rules/S1053/rule.adoc index 1f60587283..71a01027d8 100644 --- a/rules/S1053/rule.adoc +++ b/rules/S1053/rule.adoc @@ -1,6 +1,6 @@ -Used correctly, the functions from the ```` library are safe and reliable. Unfortunately, they are easily misused, and can read or write beyond the end of defined buffer, resulting in undefined behavior. +Used correctly, the functions from the ``++++`` library are safe and reliable. Unfortunately, they are easily misused, and can read or write beyond the end of defined buffer, resulting in undefined behavior. -Therefore this rule flags all uses of the following methods, which should be avoided, in favor of functions from {cpp}'s new "safe string" library, ````: ``strcpy``, ``strcmp``, ``strcat``, ``strchr``, ``strspn``, ``strcspn``, ``strpbrk``, ``strrchr``, ``strstr``, ``strtok``, and ``strlen``. +Therefore this rule flags all uses of the following methods, which should be avoided, in favor of functions from {cpp}'s new "safe string" library, ``++++``: ``++strcpy++``, ``++strcmp++``, ``++strcat++``, ``++strchr++``, ``++strspn++``, ``++strcspn++``, ``++strpbrk++``, ``++strrchr++``, ``++strstr++``, ``++strtok++``, and ``++strlen++``. == Noncompliant Code Example diff --git a/rules/S1055/rule.adoc b/rules/S1055/rule.adoc index edc82740fc..fe5bebc23a 100644 --- a/rules/S1055/rule.adoc +++ b/rules/S1055/rule.adoc @@ -1,4 +1,4 @@ -This includes file and I/O functions ``fgetpos``, ``fopen``, ``ftell``, ``gets``, ``perror``, ``remove``, ``rename``, etc. +This includes file and I/O functions ``++fgetpos++``, ``++fopen++``, ``++ftell++``, ``++gets++``, ``++perror++``, ``++remove++``, ``++rename++``, etc. Streams and file I/O have a large number of unspecified, undefined and implementation-defined behaviors associated with them. diff --git a/rules/S1056/rule.adoc b/rules/S1056/rule.adoc index 286ee7171f..35517be606 100644 --- a/rules/S1056/rule.adoc +++ b/rules/S1056/rule.adoc @@ -1,8 +1,8 @@ Compound triggers were introduced to ease the implementation of multiple triggers which need to work in cooperation. -Typically, a ``FOR EACH ROW`` trigger accumulates facts, and an ``AFTER STATEMENT`` trigger performs the actual changes. +Typically, a ``++FOR EACH ROW++`` trigger accumulates facts, and an ``++AFTER STATEMENT++`` trigger performs the actual changes. -The compound trigger can hold a state common to all the triggers it defines, thereby removing the need to use package variables. This approach is sometimes the only possible one, as when avoiding a mutating table ``ORA-04091`` error, or it can be used to get better performance. +The compound trigger can hold a state common to all the triggers it defines, thereby removing the need to use package variables. This approach is sometimes the only possible one, as when avoiding a mutating table ``++ORA-04091++`` error, or it can be used to get better performance. However, there is no point in defining a compound trigger which contains only a single trigger, since there is no state to be shared. In such cases, a simple trigger should be used instead. diff --git a/rules/S1057/rule.adoc b/rules/S1057/rule.adoc index 411e4ce51f..762e5c76e9 100644 --- a/rules/S1057/rule.adoc +++ b/rules/S1057/rule.adoc @@ -1,4 +1,4 @@ -Some Oracle packages contain powerful SYS-owned functions that can be used to perform malicious operations. For instance, ``DBMS_SYS_SQL.PARSE_AS_USER`` can be used to execute a statement as another user. +Some Oracle packages contain powerful SYS-owned functions that can be used to perform malicious operations. For instance, ``++DBMS_SYS_SQL.PARSE_AS_USER++`` can be used to execute a statement as another user. Most programs do not need those functions and this rule helps identify them in order to prevent security risks. diff --git a/rules/S1058/rule.adoc b/rules/S1058/rule.adoc index b3e685c2a8..e5dfbe6ed2 100644 --- a/rules/S1058/rule.adoc +++ b/rules/S1058/rule.adoc @@ -1,8 +1,8 @@ Pipelined functions offers the ability to create programmatically generated tables. One of the benefits of such functions is that they reduce memory consumption as results are not all kept in memory before being returned. -Instead of relying on ``RETURN``, ``PIPE ROW`` must be used to return the results, one row at a time. +Instead of relying on ``++RETURN++``, ``++PIPE ROW++`` must be used to return the results, one row at a time. -Trying to return an expression from a pipelined function raises ``PLS-00633: RETURN statement in a pipelined function cannot contain an expression`` +Trying to return an expression from a pipelined function raises ``++PLS-00633: RETURN statement in a pipelined function cannot contain an expression++`` == Noncompliant Code Example diff --git a/rules/S1059/rule.adoc b/rules/S1059/rule.adoc index f11560eb13..3ccb8f09a5 100644 --- a/rules/S1059/rule.adoc +++ b/rules/S1059/rule.adoc @@ -1,4 +1,4 @@ -Since Oracle 10g, ``DBMS_UTILITY.FORMAT_ERROR_BACKTRACE`` is available to get an exception's stack trace, i.e. files and lines that lead up to the exception. When combined with ``DBMS_UTILITY.FORMAT_ERROR_STACK``, which contains the exception error code and message, developers are able quickly identify defects. +Since Oracle 10g, ``++DBMS_UTILITY.FORMAT_ERROR_BACKTRACE++`` is available to get an exception's stack trace, i.e. files and lines that lead up to the exception. When combined with ``++DBMS_UTILITY.FORMAT_ERROR_STACK++``, which contains the exception error code and message, developers are able quickly identify defects. This rule verifies that whenever either is used in an exception handler, the other is used as well. diff --git a/rules/S106/csharp/rule.adoc b/rules/S106/csharp/rule.adoc index 2939bff981..8b2b960918 100644 --- a/rules/S106/csharp/rule.adoc +++ b/rules/S106/csharp/rule.adoc @@ -16,7 +16,7 @@ private void DoSomething() The following are ignored by this rule: * Console Applications -* Calls in methods decorated with ``[Conditional ("DEBUG")]`` -* Calls included in DEBUG preprocessor branches (``#if DEBUG``) +* Calls in methods decorated with ``++[Conditional ("DEBUG")]++`` +* Calls included in DEBUG preprocessor branches (``++#if DEBUG++``) include::../see.adoc[] diff --git a/rules/S1062/rule.adoc b/rules/S1062/rule.adoc index dba1fa3797..699691d91f 100644 --- a/rules/S1062/rule.adoc +++ b/rules/S1062/rule.adoc @@ -1,7 +1,7 @@ According to the Java Language Specification: ____ -It is permitted, but discouraged as a matter of style, to redundantly specify the ``public`` and/or ``abstract`` modifier for a method declared in an interface. +It is permitted, but discouraged as a matter of style, to redundantly specify the ``++publi{cpp}`` and/or ``++abstract++`` modifier for a method declared in an interface. ____ diff --git a/rules/S1066/cobol/rule.adoc b/rules/S1066/cobol/rule.adoc index bf2f103f56..2ba78f4c68 100644 --- a/rules/S1066/cobol/rule.adoc +++ b/rules/S1066/cobol/rule.adoc @@ -1,4 +1,4 @@ -Merging collapsible ``IF`` statements increases the code's readability. +Merging collapsible ``++IF++`` statements increases the code's readability. == Noncompliant Code Example diff --git a/rules/S1066/description.adoc b/rules/S1066/description.adoc index d68ab03503..cfa54a2ad9 100644 --- a/rules/S1066/description.adoc +++ b/rules/S1066/description.adoc @@ -1 +1 @@ -Merging collapsible ``if`` statements increases the code's readability. +Merging collapsible ``++if++`` statements increases the code's readability. diff --git a/rules/S1067/abap/rule.adoc b/rules/S1067/abap/rule.adoc index 953516194c..ed4993d461 100644 --- a/rules/S1067/abap/rule.adoc +++ b/rules/S1067/abap/rule.adoc @@ -1,4 +1,4 @@ -The complexity of an expression is defined by the number of ``AND``, ``OR``, ``XOR`` and ``EQUIV`` operators it contains. +The complexity of an expression is defined by the number of ``++AND++``, ``++OR++``, ``++XOR++`` and ``++EQUIV++`` operators it contains. A single expression's complexity should not become too high to keep the code readable. == Noncompliant Code Example diff --git a/rules/S1067/apex/rule.adoc b/rules/S1067/apex/rule.adoc index 12d078552f..7276517393 100644 --- a/rules/S1067/apex/rule.adoc +++ b/rules/S1067/apex/rule.adoc @@ -1,4 +1,4 @@ -The complexity of an expression is defined by the number of ``&&`` and ``||`` operators it contains. +The complexity of an expression is defined by the number of ``++&&++`` and ``++||++`` operators it contains. A single expression's complexity should not become too high to keep the code readable. == Noncompliant Code Example diff --git a/rules/S1067/description.adoc b/rules/S1067/description.adoc index f1f6c87c4b..8569510aa7 100644 --- a/rules/S1067/description.adoc +++ b/rules/S1067/description.adoc @@ -1,2 +1,2 @@ -The complexity of an expression is defined by the number of ``&&``, ``||`` and ``condition ? ifTrue : ifFalse`` operators it contains. +The complexity of an expression is defined by the number of ``++&&++``, ``++||++`` and ``++condition ? ifTrue : ifFalse++`` operators it contains. A single expression's complexity should not become too high to keep the code readable. diff --git a/rules/S1067/java/rule.adoc b/rules/S1067/java/rule.adoc index 06e8cca3bd..edc1de0a09 100644 --- a/rules/S1067/java/rule.adoc +++ b/rules/S1067/java/rule.adoc @@ -16,4 +16,4 @@ if ( (myFirstCondition() || mySecondCondition()) && myLastCondition()) { ... } == Exceptions -No issue is reported inside ``equals`` methods, because it is common to compare all the fields of a class for equality inside this kind of method. +No issue is reported inside ``++equals++`` methods, because it is common to compare all the fields of a class for equality inside this kind of method. diff --git a/rules/S1067/rpg/rule.adoc b/rules/S1067/rpg/rule.adoc index 4eb6558598..7c225d9259 100644 --- a/rules/S1067/rpg/rule.adoc +++ b/rules/S1067/rpg/rule.adoc @@ -1,4 +1,4 @@ -The complexity of an expression is defined by the number of ``AND``, ``OR``. +The complexity of an expression is defined by the number of ``++AND++``, ``++OR++``. A single expression's complexity should not become too high to keep the code readable. == Noncompliant Code Example diff --git a/rules/S1067/scala/rule.adoc b/rules/S1067/scala/rule.adoc index 12d078552f..7276517393 100644 --- a/rules/S1067/scala/rule.adoc +++ b/rules/S1067/scala/rule.adoc @@ -1,4 +1,4 @@ -The complexity of an expression is defined by the number of ``&&`` and ``||`` operators it contains. +The complexity of an expression is defined by the number of ``++&&++`` and ``++||++`` operators it contains. A single expression's complexity should not become too high to keep the code readable. == Noncompliant Code Example diff --git a/rules/S1067/tsql/rule.adoc b/rules/S1067/tsql/rule.adoc index 3201fc360d..7a25f36fa1 100644 --- a/rules/S1067/tsql/rule.adoc +++ b/rules/S1067/tsql/rule.adoc @@ -1,4 +1,4 @@ -The complexity of an expression is defined by the number of ``AND`` and ``OR`` operators it contains. +The complexity of an expression is defined by the number of ``++AND++`` and ``++OR++`` operators it contains. A single expression's complexity should not become too high to keep the code readable. == Noncompliant Code Example diff --git a/rules/S1067/vb6/rule.adoc b/rules/S1067/vb6/rule.adoc index 08e12d393a..e5b26a99ea 100644 --- a/rules/S1067/vb6/rule.adoc +++ b/rules/S1067/vb6/rule.adoc @@ -1,4 +1,4 @@ -The difficulty of understanding an expression increases for each of the ``And``, ``Or`` and ``Xor`` operators it contains. +The difficulty of understanding an expression increases for each of the ``++And++``, ``++Or++`` and ``++Xor++`` operators it contains. A single expression's complexity should not become too high to keep the code readable. == Noncompliant Code Example diff --git a/rules/S1068/description.adoc b/rules/S1068/description.adoc index f15e5b6b4a..b1ce3f5f7b 100644 --- a/rules/S1068/description.adoc +++ b/rules/S1068/description.adoc @@ -1 +1 @@ -If a ``private`` field is declared but not used in the program, it can be considered dead code and should therefore be removed. This will improve maintainability because developers will not wonder what the variable is used for. +If a ``++private++`` field is declared but not used in the program, it can be considered dead code and should therefore be removed. This will improve maintainability because developers will not wonder what the variable is used for. diff --git a/rules/S1068/java/rule.adoc b/rules/S1068/java/rule.adoc index 3537d631eb..ecb8f5027b 100644 --- a/rules/S1068/java/rule.adoc +++ b/rules/S1068/java/rule.adoc @@ -1,6 +1,6 @@ -If a ``private`` field is declared but not used in the program, it can be considered dead code and should therefore be removed. This will improve maintainability because developers will not wonder what the variable is used for. +If a ``++private++`` field is declared but not used in the program, it can be considered dead code and should therefore be removed. This will improve maintainability because developers will not wonder what the variable is used for. -Note that this rule does not take reflection into account, which means that issues will be raised on ``private`` fields that are only accessed using the reflection API. +Note that this rule does not take reflection into account, which means that issues will be raised on ``++private++`` fields that are only accessed using the reflection API. == Noncompliant Code Example @@ -27,8 +27,8 @@ public class MyClass { == Exceptions -The Java serialization runtime associates with each serializable class a version number, called ``serialVersionUID``, which is used during deserialization to verify that the sender and receiver of a serialized object have loaded classes for that object that are compatible with respect to serialization. -A serializable class can declare its own ``serialVersionUID`` explicitly by declaring a field named ``serialVersionUID`` that must be static, final, and of type long. By definition those ``serialVersionUID`` fields should not be reported by this rule: +The Java serialization runtime associates with each serializable class a version number, called ``++serialVersionUID++``, which is used during deserialization to verify that the sender and receiver of a serialized object have loaded classes for that object that are compatible with respect to serialization. +A serializable class can declare its own ``++serialVersionUID++`` explicitly by declaring a field named ``++serialVersionUID++`` that must be static, final, and of type long. By definition those ``++serialVersionUID++`` fields should not be reported by this rule: ---- public class MyClass implements java.io.Serializable { diff --git a/rules/S107/java/rule.adoc b/rules/S107/java/rule.adoc index 1811c7ca02..739d1a036b 100644 --- a/rules/S107/java/rule.adoc +++ b/rules/S107/java/rule.adoc @@ -22,10 +22,10 @@ public void doSomething(int param1, int param2, int param3, String param4) { Methods annotated with : -* Spring's ``@RequestMapping`` (and related shortcut annotations, like ``@GetRequest``) -* JAX-RS API annotations (like ``@javax.ws.rs.GET``) -* Bean constructor injection with ``@org.springframework.beans.factory.annotation.Autowired`` -* CDI constructor injection with ``@javax.inject.Inject`` -* ``@com.fasterxml.jackson.annotation.JsonCreator`` +* Spring's ``++@RequestMapping++`` (and related shortcut annotations, like ``++@GetRequest++``) +* JAX-RS API annotations (like ``++@javax.ws.rs.GET++``) +* Bean constructor injection with ``++@org.springframework.beans.factory.annotation.Autowired++`` +* CDI constructor injection with ``++@javax.inject.Inject++`` +* ``++@com.fasterxml.jackson.annotation.JsonCreator++`` may have a lot of parameters, encapsulation being possible. Such methods are therefore ignored. diff --git a/rules/S107/kotlin/rule.adoc b/rules/S107/kotlin/rule.adoc index b3605527a4..037741b624 100644 --- a/rules/S107/kotlin/rule.adoc +++ b/rules/S107/kotlin/rule.adoc @@ -20,4 +20,4 @@ fun foo(p1: String, p2: String, p3: String, p4: String) { == Exceptions -Methods annotated with Spring's ``@RequestMapping`` (and related shortcut annotations, like ``@GetRequest``) or ``@JsonCreator`` may have a lot of parameters, encapsulation being possible. Such methods are therefore ignored. +Methods annotated with Spring's ``++@RequestMapping++`` (and related shortcut annotations, like ``++@GetRequest++``) or ``++@JsonCreator++`` may have a lot of parameters, encapsulation being possible. Such methods are therefore ignored. diff --git a/rules/S107/python/rule.adoc b/rules/S107/python/rule.adoc index 373bc7ff45..4b6e3ccf92 100644 --- a/rules/S107/python/rule.adoc +++ b/rules/S107/python/rule.adoc @@ -18,4 +18,4 @@ def do_something(param1, param2, param3, param4): == Exceptions -The first argument of non-static methods, i.e. ``self`` or ``cls``, is not counted as it is mandatory and it is passed automatically. +The first argument of non-static methods, i.e. ``++self++`` or ``++cls++``, is not counted as it is mandatory and it is passed automatically. diff --git a/rules/S1070/rule.adoc b/rules/S1070/rule.adoc index 6831d08d11..eb4c22d14a 100644 --- a/rules/S1070/rule.adoc +++ b/rules/S1070/rule.adoc @@ -1,4 +1,4 @@ -The ``result_cache`` Oracle hint can vastly improve performance, but it comes at the cost of extra memory consumption, so one should double-check that the gain in performance is significant, and avoid overusing this feature in general. +The ``++result_cache++`` Oracle hint can vastly improve performance, but it comes at the cost of extra memory consumption, so one should double-check that the gain in performance is significant, and avoid overusing this feature in general. == Noncompliant Code Example diff --git a/rules/S1071/rule.adoc b/rules/S1071/rule.adoc index 8287e56c67..d8f6ff9e20 100644 --- a/rules/S1071/rule.adoc +++ b/rules/S1071/rule.adoc @@ -1,4 +1,4 @@ -Since Oracle 11.2, ``RELIES_ON`` has been deprecated because the dependencies of result cache-enabled functions are automatically computed. +Since Oracle 11.2, ``++RELIES_ON++`` has been deprecated because the dependencies of result cache-enabled functions are automatically computed. == Noncompliant Code Example diff --git a/rules/S1074/rule.adoc b/rules/S1074/rule.adoc index 321790cf4f..11f5e26b03 100644 --- a/rules/S1074/rule.adoc +++ b/rules/S1074/rule.adoc @@ -1,4 +1,4 @@ -When the ``FORALL`` statement is used without the ``SAVE EXCEPTIONS`` clause and an exception is raised by a DML query, the whole operation is rolled back and the exception goes unhandled. Instead of relying on this default behavior, it is better to always use the ``SAVE EXCEPTIONS`` clause and explicitly handle exceptions in a ``ORA-24381`` handler. +When the ``++FORALL++`` statement is used without the ``++SAVE EXCEPTIONS++`` clause and an exception is raised by a DML query, the whole operation is rolled back and the exception goes unhandled. Instead of relying on this default behavior, it is better to always use the ``++SAVE EXCEPTIONS++`` clause and explicitly handle exceptions in a ``++ORA-24381++`` handler. == Noncompliant Code Example diff --git a/rules/S1075/csharp/rule.adoc b/rules/S1075/csharp/rule.adoc index cd162fdb37..445d89e6db 100644 --- a/rules/S1075/csharp/rule.adoc +++ b/rules/S1075/csharp/rule.adoc @@ -8,8 +8,8 @@ This rule raises an issue when URI's or path delimiters are hardcoded. This rule does not raise an issue when an ASP.NET virtual path is passed as an argument to one of the following: -* methods: ``System.Web.HttpServerUtilityBase.MapPath()``, ``System.Web.HttpRequestBase.MapPath()``, ``System.Web.HttpResponseBase.ApplyAppPathModifier()``, ``System.Web.Mvc.UrlHelper.Content()`` -* all methods of: ``System.Web.VirtualPathUtility`` -* constructors of: ``Microsoft.AspNetCore.Mvc.VirtualFileResult``, ``Microsoft.AspNetCore.Routing.VirtualPathData`` +* methods: ``++System.Web.HttpServerUtilityBase.MapPath()++``, ``++System.Web.HttpRequestBase.MapPath()++``, ``++System.Web.HttpResponseBase.ApplyAppPathModifier()++``, ``++System.Web.Mvc.UrlHelper.Content()++`` +* all methods of: ``++System.Web.VirtualPathUtility++`` +* constructors of: ``++Microsoft.AspNetCore.Mvc.VirtualFileResult++``, ``++Microsoft.AspNetCore.Routing.VirtualPathData++`` include::../see.adoc[] diff --git a/rules/S1077/rule.adoc b/rules/S1077/rule.adoc index 0a3ea712f9..0a91c87940 100644 --- a/rules/S1077/rule.adoc +++ b/rules/S1077/rule.adoc @@ -1,4 +1,4 @@ -The ``alt`` attribute provides a textual alternative to an image. +The ``++alt++`` attribute provides a textual alternative to an image. It is used whenever the actual image cannot be rendered. Common reasons for that include: @@ -6,12 +6,12 @@ Common reasons for that include: * Visually impaired users using a screen reader software * Images loading is disabled, to reduce data consumption on mobile phones -It is also very important to not set an ``alt`` attribute to a non-informative value. For example ``logo`` is useless as it doesn't give any information to the user. In this case, as for any other decorative image, it is better to use a CSS background image instead of an ```` tag. If using CSS background-image is not possible, an empty ``alt=""`` is tolerated. See Exceptions bellow. +It is also very important to not set an ``++alt++`` attribute to a non-informative value. For example ``++logo++`` is useless as it doesn't give any information to the user. In this case, as for any other decorative image, it is better to use a CSS background image instead of an ``++++`` tag. If using CSS background-image is not possible, an empty ``++alt=""++`` is tolerated. See Exceptions bellow. This rule raises an issue when -* an ```` tag or an ```` tag have no ``alt`` attribute or their ``alt`` attribute has an empty string value. -* an ```` tag has no ``alt`` attribute. +* an ``++++`` tag or an ``++++`` tag have no ``++alt++`` attribute or their ``++alt++`` attribute has an empty string value. +* an ``++++`` tag has no ``++alt++`` attribute. == Noncompliant Code Example @@ -51,16 +51,16 @@ This rule raises an issue when == Exceptions -```` tags with empty string ``alt=""`` attributes won't raise any issue. However this technic should be used in two cases only: +``++++`` tags with empty string ``++alt=""++`` attributes won't raise any issue. However this technic should be used in two cases only: -When the image is decorative and it is not possible to use a CSS background image. For example, when the decorative ```` is generated via javascript with a source image coming from a database, it is better to use an ```` tag rather than generate CSS code. +When the image is decorative and it is not possible to use a CSS background image. For example, when the decorative ``++++`` is generated via javascript with a source image coming from a database, it is better to use an ``++++`` tag rather than generate CSS code. ----
    • ---- -When the image is not decorative but it's ``alt`` text would repeat a nearby text. For example, images contained in links should not duplicate the link's text in their ``alt`` attribute, as it would make the screen reader repeat the text twice. +When the image is not decorative but it's ``++alt++`` text would repeat a nearby text. For example, images contained in links should not duplicate the link's text in their ``++alt++`` attribute, as it would make the screen reader repeat the text twice. ---- diff --git a/rules/S1079/rule.adoc b/rules/S1079/rule.adoc index f46ad679c8..a91f7e5ba3 100644 --- a/rules/S1079/rule.adoc +++ b/rules/S1079/rule.adoc @@ -1,9 +1,9 @@ -The ``%s`` placeholder is used to read a word into a string. +The ``++%s++`` placeholder is used to read a word into a string. By default, there is no restriction on the length of that word, and the developer is required to pass a sufficiently large buffer for storing it. No matter how large the buffer is, there will always be a longer word. -Therefore, programs relying on ``%s`` are vulnerable to buffer overflows. +Therefore, programs relying on ``++%s++`` are vulnerable to buffer overflows. -A field width specifier can be used together with the ``%s`` placeholder to limit the number of bytes which will by written to the buffer. +A field width specifier can be used together with the ``++%s++`` placeholder to limit the number of bytes which will by written to the buffer. Note that an additional byte is required to store the null terminator. diff --git a/rules/S108/go/rule.adoc b/rules/S108/go/rule.adoc index 42e9ff7547..69b8e27809 100644 --- a/rules/S108/go/rule.adoc +++ b/rules/S108/go/rule.adoc @@ -24,4 +24,4 @@ func compute(a int, b int) { == Exceptions -When a block contains a comment, this block is not considered to be empty. ``for`` without ``init`` and ``post`` statements with empty blocks are ignored as well. +When a block contains a comment, this block is not considered to be empty. ``++for++`` without ``++init++`` and ``++post++`` statements with empty blocks are ignored as well. diff --git a/rules/S108/java/rule.adoc b/rules/S108/java/rule.adoc index 49a472c3a8..5d540d7b79 100644 --- a/rules/S108/java/rule.adoc +++ b/rules/S108/java/rule.adoc @@ -4,4 +4,4 @@ include::../noncompliant.adoc[] == Exceptions -When a block contains a comment, this block is not considered to be empty unless it is a ``synchronized`` block. ``synchronized`` blocks are still considered empty even with comments because they can still affect program flow. +When a block contains a comment, this block is not considered to be empty unless it is a ``++synchronized++`` block. ``++synchronized++`` blocks are still considered empty even with comments because they can still affect program flow. diff --git a/rules/S108/javascript/rule.adoc b/rules/S108/javascript/rule.adoc index 2763f6e15e..cf80df9e6b 100644 --- a/rules/S108/javascript/rule.adoc +++ b/rules/S108/javascript/rule.adoc @@ -8,4 +8,4 @@ for (var i = 0; i < length; i++) {} // Empty on purpose or missing piece of cod == Exceptions -When a block contains a comment, this block is not considered to be empty. Moreover ``catch`` blocks are ignored. +When a block contains a comment, this block is not considered to be empty. Moreover ``++catch++`` blocks are ignored. diff --git a/rules/S108/kotlin/rule.adoc b/rules/S108/kotlin/rule.adoc index a3b5d4082f..ef3ffbbe80 100644 --- a/rules/S108/kotlin/rule.adoc +++ b/rules/S108/kotlin/rule.adoc @@ -5,7 +5,7 @@ include::../noncompliant.adoc[] == Exceptions When a block contains a comment, this block is not considered to be empty. -``while`` and unless loops are also exception to the rule. +``++while++`` and unless loops are also exception to the rule. ---- while (order.processNext()); // Compliant diff --git a/rules/S108/ruby/rule.adoc b/rules/S108/ruby/rule.adoc index fe6538f34b..ff951a479a 100644 --- a/rules/S108/ruby/rule.adoc +++ b/rules/S108/ruby/rule.adoc @@ -26,7 +26,7 @@ end == Exceptions When a block contains a comment, this block is not considered to be empty. -``while`` and ``unless`` loops are also exception to the rule. +``++while++`` and ``++unless++`` loops are also exception to the rule. ---- while @order.process_next; end # Compliant diff --git a/rules/S1081/rule.adoc b/rules/S1081/rule.adoc index 872f219ca6..f32a8c4880 100644 --- a/rules/S1081/rule.adoc +++ b/rules/S1081/rule.adoc @@ -1,11 +1,11 @@ When using typical C functions, it's up to the developer to make sure the size of the buffer to be written to is large enough to avoid buffer overflows. Buffer overflows can cause the program to crash at a minimum. At worst, a carefully crafted overflow can cause malicious code to be executed. -This rule reports use of the following insecure functions, for which knowing the required size is not generally possible: ``gets()`` and ``getpw()``. +This rule reports use of the following insecure functions, for which knowing the required size is not generally possible: ``++gets()++`` and ``++getpw()++``. In such cases, it's better to use an alternate, secure function which allows you to define the maximum number of characters to be written to the buffer: -* ``fgets`` or ``gets_s`` -* ``getpwuid`` +* ``++fgets++`` or ``++gets_s++`` +* ``++getpwuid++`` == Noncompliant Code Example diff --git a/rules/S1082/rule.adoc b/rules/S1082/rule.adoc index 6705152fcd..b25a0f8978 100644 --- a/rules/S1082/rule.adoc +++ b/rules/S1082/rule.adoc @@ -3,11 +3,11 @@ Offering the same experience with the mouse and the keyboard allow users to pick This rule raises an issue when: -* an HTML element with an ``onMouseover`` attribute doesn't also have an ``onFocus attribute.`` -* an HTML element with an ``onMouseout`` attribute doesn't also have an ``onBlur attribute.`` -* an HTML element with an ``onClick`` attribute doesn't also have one of the following attributes: ``onKeyDown``, ``onKeyUp``, ``onKeyPress``. +* an HTML element with an ``++onMouseover++`` attribute doesn't also have an ``++onFocus attribute.++`` +* an HTML element with an ``++onMouseout++`` attribute doesn't also have an ``++onBlur attribute.++`` +* an HTML element with an ``++onClick++`` attribute doesn't also have one of the following attributes: ``++onKeyDown++``, ``++onKeyUp++``, ``++onKeyPress++``. -Note that in the case of ``onClick``, the equivalent keyboard handler should support both the "Enter" and "Space" keys as these are usually used by screen-readers. +Note that in the case of ``++onClick++``, the equivalent keyboard handler should support both the "Enter" and "Space" keys as these are usually used by screen-readers. == Noncompliant Code Example @@ -21,7 +21,7 @@ Note that in the case of ``onClick``, the equivalent keyboard handler should su == Compliant Solution -Note that setting the ``tabindex`` attribute is necessary to make the ``
    `` element focusable. +Note that setting the ``++tabindex++`` attribute is necessary to make the ``++
    ++`` element focusable. ----
    @@ -32,9 +32,9 @@ Note that setting the ``tabindex`` attribute is necessary to make the ``
    `` == Exceptions -For the following elements, https://www.w3.org/TR/WCAG20-TECHS/SCR35.html[pressing a key will trigger the ``onClick`` attribute]: ````, ````, ``