Skip to content

Commit 4ab71b0

Browse files
committed
Corrections in translator report
- correctly sorting non up to date translators (sorting didn't work properly as 1.16.0 came after 1.4.6) - suppress "almost up to date list" when no items present - word `obsolete` is not correct should be `incomplete` - `&doxygen#160;` appeared in the official output in the documentations, use ` ` (remainder of when everything was still governed by `\htmlonly` and `\latexonly`.
1 parent bea822c commit 4ab71b0

1 file changed

Lines changed: 30 additions & 17 deletions

File tree

doc/translator.py

Lines changed: 30 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1390,7 +1390,13 @@ def __extractProcessedInfo(self):
13901390

13911391
# Sort the list and extract the object identifiers (classId's) for
13921392
# the up-to-date translators and English-based translators.
1393-
statLst.sort()
1393+
statLst1 = []
1394+
for obj in statLst:
1395+
statLst1.append(re.sub(r'^(\d)\.(\d)\.',r'\1.0\2.', obj))
1396+
statLst1.sort()
1397+
statLst = []
1398+
for obj in statLst1:
1399+
statLst.append(re.sub(r'^(\d)\.0(\d)\.',r'\1.\2.', obj))
13941400
self.upToDateIdLst = [x.split('|')[2] for x in statLst if x[0] == '|']
13951401
self.EnBasedIdLst = [x.split('|')[2] for x in statLst if x[:2] == 'En']
13961402

@@ -1626,27 +1632,34 @@ def generateTranslatorReport(self):
16261632

16271633

16281634
# Write separately the list of "ALMOST up-to-date" translator classes.
1629-
s = '''The following translator classes are ALMOST up-to-date (sorted
1630-
alphabetically). This means that they derive from the
1631-
Translator class, but there still may be some minor problems
1632-
listed for them:'''
1633-
f.write('\n' + ('-' * 70) + '\n')
1634-
f.write(fill(s) + '\n\n')
1635-
mailtoLst = []
1635+
almostUpToDate = False
16361636
for x in self.upToDateIdLst:
16371637
obj = self.__translDic[x]
16381638
if obj.note is not None:
1639-
f.write(' ' + obj.classId + '\t-- ' + obj.note + '\n')
1640-
mailtoLst.extend(self.__emails(obj.classId))
1641-
1642-
fmail.write('\n\nalmost up-to-date\n')
1643-
fmail.write('; '.join(mailtoLst))
1644-
1645-
# Write the list of the adapter based classes. The very obsolete
1639+
almostUpToDate = True
1640+
1641+
if almostUpToDate:
1642+
s = '''The following translator classes are ALMOST up-to-date (sorted
1643+
alphabetically). This means that they derive from the
1644+
Translator class, but there still may be some minor problems
1645+
listed for them:'''
1646+
f.write('\n' + ('-' * 70) + '\n')
1647+
f.write(fill(s) + '\n\n')
1648+
mailtoLst = []
1649+
for x in self.upToDateIdLst:
1650+
obj = self.__translDic[x]
1651+
if obj.note is not None:
1652+
f.write(' ' + obj.classId + '\t-- ' + obj.note + '\n')
1653+
mailtoLst.extend(self.__emails(obj.classId))
1654+
1655+
fmail.write('\n\nalmost up-to-date\n')
1656+
fmail.write('; '.join(mailtoLst))
1657+
1658+
# Write the list of the adapter based classes. The very incomplete
16461659
# translators that derive from TranslatorEnglish are included.
16471660
if self.adaptIdLst:
16481661
s = '''The following translator classes need maintenance
1649-
(the most obsolete at the end). The other info shows the
1662+
(the most incomplete at the end). The other info shows the
16501663
estimation of Doxygen version when the class was last
16511664
updated and number of methods that must be implemented to
16521665
become up-to-date:'''
@@ -1924,7 +1937,7 @@ def generateLanguageDoc(self):
19241937
if classId in self.__translDic:
19251938
lang = self.__translDic[classId].langReadable
19261939
mm = 'see the %s language' % lang
1927-
ee = ' '
1940+
ee = ' '
19281941

19291942
if not mm and obj.classId in self.__maintainersDic:
19301943
# Build a string of names separated by the HTML break element.

0 commit comments

Comments
 (0)