eric6/DocumentationTools/ModuleDocumentor.py

changeset 7888
803f811dc466
parent 7780
41420f82c0ac
child 7923
91e843545d9a
equal deleted inserted replaced
7887:c1588f5a83e9 7888:803f811dc466
959 959
960 dlist = descr.splitlines() 960 dlist = descr.splitlines()
961 while dlist and not dlist[0]: 961 while dlist and not dlist[0]:
962 del dlist[0] 962 del dlist[0]
963 lastTag = "" 963 lastTag = ""
964 buffer = ""
964 for ditem in dlist: 965 for ditem in dlist:
965 ditem = self.__processInlineTags(ditem) 966 ditem = self.__processInlineTags(ditem)
966 desc = ditem.strip() 967 desc = ditem.strip()
968 if buffer:
969 if desc.startswith("@"):
970 buffer = ""
971 raise TagError(
972 "Wrong format in {0} line.\n".format(lastTag))
973 else:
974 desc = buffer + desc
967 if desc: 975 if desc:
968 if desc.startswith(("@param", "@keyparam")): 976 if desc.startswith(("@param", "@keyparam")):
969 inTagSection = True 977 inTagSection = True
970 parts = desc.split(None, 2) 978 parts = desc.split(None, 2)
971 lastTag = parts[0] 979 lastTag = parts[0]
1046 elif desc.startswith("@signal"): 1054 elif desc.startswith("@signal"):
1047 inTagSection = True 1055 inTagSection = True
1048 lastTag = desc.split(None, 1)[0] 1056 lastTag = desc.split(None, 1)[0]
1049 m = _signal(desc, 0) 1057 m = _signal(desc, 0)
1050 if m is None: 1058 if m is None:
1051 raise TagError("Wrong format in @signal line.\n") 1059 buffer = desc
1052 signalName = ( 1060 else:
1053 1 and m.group("SignalName1") or m.group("SignalName2") 1061 buffer = ""
1054 ) 1062 signalName = (
1055 signalDesc = ( 1063 m.group("SignalName1") or m.group("SignalName2")
1056 1 and m.group("SignalDescription1") or 1064 )
1057 m.group("SignalDescription2") 1065 signalDesc = (
1058 ) 1066 m.group("SignalDescription1") or
1059 signalDict[signalName] = [] 1067 m.group("SignalDescription2")
1060 if signalDesc is not None: 1068 )
1061 signalDict[signalName].append(signalDesc) 1069 signalDict[signalName] = []
1062 lastItem = signalDict[signalName] 1070 if signalDesc is not None:
1071 signalDict[signalName].append(signalDesc)
1072 lastItem = signalDict[signalName]
1063 elif desc.startswith("@event"): 1073 elif desc.startswith("@event"):
1064 inTagSection = True 1074 inTagSection = True
1065 lastTag = desc.split(None, 1)[0] 1075 lastTag = desc.split(None, 1)[0]
1066 m = _event(desc, 0) 1076 m = _event(desc, 0)
1067 if m is None: 1077 if m is None:
1068 raise TagError( 1078 buffer = desc
1069 "Wrong format in {0} line.\n".format(parts[0])) 1079 else:
1070 eventName = ( 1080 buffer = ""
1071 1 and m.group("EventName1") or m.group("EventName2") 1081 eventName = (
1072 ) 1082 m.group("EventName1") or m.group("EventName2")
1073 eventDesc = ( 1083 )
1074 1 and m.group("EventDescription1") or 1084 eventDesc = (
1075 m.group("EventDescription2") 1085 m.group("EventDescription1") or
1076 ) 1086 m.group("EventDescription2")
1077 eventDict[eventName] = [] 1087 )
1078 if eventDesc is not None: 1088 eventDict[eventName] = []
1079 eventDict[eventName].append(eventDesc) 1089 if eventDesc is not None:
1080 lastItem = eventDict[eventName] 1090 eventDict[eventName].append(eventDesc)
1091 lastItem = eventDict[eventName]
1081 elif desc.startswith("@deprecated"): 1092 elif desc.startswith("@deprecated"):
1082 inTagSection = True 1093 inTagSection = True
1083 parts = desc.split(None, 1) 1094 parts = desc.split(None, 1)
1084 lastTag = parts[0] 1095 lastTag = parts[0]
1085 if len(parts) < 2: 1096 if len(parts) < 2:

eric ide

mercurial