added a script to automaitcally fix 'Derived from' doc sections; updated the 'Library' sections script to be able to run it on files already having these functions (patch 1765640)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@48100 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
179
misc/scripts/update_doc_libs.py
Normal file → Executable file
179
misc/scripts/update_doc_libs.py
Normal file → Executable file
@@ -7,103 +7,94 @@
|
||||
# Licence: wxWindows licence
|
||||
##############################################################################
|
||||
|
||||
import sys, os, glob, distutils.file_util
|
||||
from update_doc_utils import scanTexFiles
|
||||
|
||||
tofix = set()
|
||||
count = 0
|
||||
for f in glob.glob('*.tex'):
|
||||
file = open(f, "r")
|
||||
if not file:
|
||||
print "could not open %s" % f
|
||||
continue
|
||||
print "opened file %s" % f
|
||||
count = count + 1
|
||||
|
||||
# search \class
|
||||
content = file.readlines()
|
||||
classdecl = 0
|
||||
for i in range(len(content)):
|
||||
line = content[i]
|
||||
if "\class{" in line:
|
||||
classdecl = classdecl + 1
|
||||
|
||||
classname = line
|
||||
classname = classname[classname.find("\class{"):]
|
||||
classname = classname[classname.find("{")+1:classname.find("}")]
|
||||
print " the class declared is named '%s'" % classname
|
||||
|
||||
tofix.add(f) # consider this .tex broken
|
||||
|
||||
# now search the include file for this class
|
||||
include = ""
|
||||
for j in range(i,len(content)):
|
||||
line = content[j]
|
||||
if "wx/" in line and ".h" in line:
|
||||
include = line[line.find("wx/"):line.find(".h")+2]
|
||||
INCLUDE_PATH="../../include"
|
||||
|
||||
def myCallback(classname, texFileName, content, i):
|
||||
tofix.add(texFileName) # consider this .tex broken
|
||||
|
||||
# now search the include file for this class
|
||||
include = ""
|
||||
for j in range(i,len(content)):
|
||||
line = content[j]
|
||||
if "wx/" in line and ".h" in line:
|
||||
include = line[line.find("wx/"):line.find(".h")+2]
|
||||
break
|
||||
if include == "":
|
||||
print " no include file declared for class %s" % classname
|
||||
return True # go on with next \class
|
||||
|
||||
include = include.replace("\\_", "_")
|
||||
print " the include file for %s is %s" % (classname, include)
|
||||
|
||||
# does this .tex already contains the \wxheading{Library} section nearby the include file?
|
||||
for k in range(j,min(len(content), j+3)):
|
||||
line = content[k]
|
||||
if "\wxheading{Library}" in line:
|
||||
print " this \class section already has its \wxheading{Library} section... skipping"
|
||||
tofix.remove(texFileName) # was a valid .tex (at least for current class)
|
||||
return True # go on with next \class
|
||||
|
||||
# now try to understand which lib contains this class
|
||||
include = INCLUDE_PATH + "/" + include
|
||||
header = open(include, "r")
|
||||
if not header:
|
||||
print " could not open %s" % include
|
||||
return True # go on with next \class
|
||||
|
||||
decl = ""
|
||||
content2 = header.readlines()
|
||||
|
||||
# if they exist append port-specific headers contents
|
||||
for c in ["wx/gtk/", "wx/msw/", "wx/mac/", "wx/generic/"]:
|
||||
try:
|
||||
temp = include.replace("wx/", c)
|
||||
print " trying to open %s..." % temp
|
||||
header = open(temp, "r")
|
||||
headercontents = header.readlines()
|
||||
content2 = content2 + headercontents
|
||||
print " added %d lines from %s" % (len(headercontents), temp)
|
||||
except:
|
||||
pass
|
||||
|
||||
# now search for the export-declaration associated with this class
|
||||
for line in content2:
|
||||
if "class " in line and classname in line:
|
||||
if line.find("class") < line.find(classname): # could be a comment
|
||||
if "_" in line:
|
||||
decl = line[line.find("_")+1:]
|
||||
decl = decl[:decl.find(" ")]
|
||||
decl = decl.replace("FWD_", "")
|
||||
decl = decl[0:1].upper() + decl[1:].lower()
|
||||
break
|
||||
elif " WXDLLEXPORT " in line:
|
||||
decl = "Core"
|
||||
break
|
||||
if include == "":
|
||||
print " no include file declared for class %s" % classname
|
||||
continue
|
||||
|
||||
include = include.replace("\\_", "_")
|
||||
print " the include file for %s is %s" % (classname, include)
|
||||
|
||||
# now try to understand which libs contains this class
|
||||
include = "../../../include/" + include
|
||||
header = open(include, "r")
|
||||
if not file:
|
||||
print " could not open %s" % include
|
||||
continue
|
||||
|
||||
decl = ""
|
||||
content2 = header.readlines()
|
||||
|
||||
# if they exist append port-specific headers contents
|
||||
for c in ["wx/gtk/", "wx/msw/", "wx/mac/", "wx/generic/"]:
|
||||
try:
|
||||
temp = include.replace("wx/", c)
|
||||
print " trying to open %s..." % temp
|
||||
header = open(temp, "r")
|
||||
headercontents = header.readlines()
|
||||
content2 = content2 + headercontents
|
||||
print " added %d lines from %s" % (len(headercontents), temp)
|
||||
except:
|
||||
pass
|
||||
|
||||
for line in content2:
|
||||
if "class " in line and classname in line:
|
||||
if line.find("class") < line.find(classname): # could be a comment
|
||||
if "_" in line:
|
||||
decl = line[line.find("_")+1:]
|
||||
decl = decl[:decl.find(" ")]
|
||||
decl = decl.replace("FWD_", "")
|
||||
decl = decl[0:1].upper() + decl[1:].lower()
|
||||
break
|
||||
elif " WXDLLEXPORT " in line:
|
||||
decl = "Core"
|
||||
break
|
||||
|
||||
if decl == "":
|
||||
print " no declaration associated with %s" % classname
|
||||
continue
|
||||
|
||||
print " the declaration associated with %s is %s" % (classname, decl)
|
||||
tofix.remove(f) # was a valid .tex (at least for current class)
|
||||
|
||||
# now modify the .tex file
|
||||
content.insert(j+2, "\wxheading{Library}\n\n\helpref{wx%s}{librarieslist}\n\n" % decl)
|
||||
|
||||
# write it
|
||||
file = open(f, "w")
|
||||
file.write(''.join(content))
|
||||
file.flush()
|
||||
|
||||
file = open(f, "r")
|
||||
if decl == "":
|
||||
print " no declaration associated with %s" % classname
|
||||
return True # go on with next \class
|
||||
|
||||
print " updated %s" % f
|
||||
print " the declaration associated with %s is %s" % (classname, decl)
|
||||
tofix.remove(texFileName) # was a valid .tex (at least for current class)
|
||||
|
||||
|
||||
print " file %s contains %d class declarations" % (f, classdecl)
|
||||
# now modify the .tex file
|
||||
content.insert(j+2, "\wxheading{Library}\n\n\helpref{wx%s}{librarieslist}\n\n" % decl)
|
||||
|
||||
print "\nProcessed %d files." % count
|
||||
print "There are %d files to fix:\n%s" % (len(tofix), '\n'.join(tofix))
|
||||
# write it
|
||||
file = open(texFileName, "w")
|
||||
file.write(''.join(content))
|
||||
file.flush()
|
||||
|
||||
print " updated %s" % texFileName
|
||||
fixed = fixed+1
|
||||
|
||||
return True
|
||||
|
||||
fixed = 0
|
||||
tofix = set()
|
||||
count = scanTexFiles(myCallback)
|
||||
|
||||
print "\nProcessed %d files, automatically fixed %d files." % (count, fixed)
|
||||
print "There are %d files to fix manually:\n%s" % (len(tofix), '\n'.join(tofix))
|
||||
|
||||
Reference in New Issue
Block a user