diff --git a/CHANGES b/CHANGES index 893827869..38d719d5c 100644 --- a/CHANGES +++ b/CHANGES @@ -89,6 +89,9 @@ Release 1.0 (in development) Release 0.6.5 (in development) ============================== +* In autodoc, fix the omission of some module members explicitly + documented using documentation comments. + * #345: Fix cropping of sidebar scroll bar with ``stickysidebar`` option of the default theme. diff --git a/sphinx/environment.py b/sphinx/environment.py index dddcd4369..99cd47bbe 100644 --- a/sphinx/environment.py +++ b/sphinx/environment.py @@ -1592,6 +1592,8 @@ class BuildEnvironment: else: if name in self.descrefs: newname = name + elif classname and classname + '.' + name in self.descrefs: + newname = classname + '.' + name elif modname and modname + '.' + name in self.descrefs: newname = modname + '.' + name elif modname and classname and \ diff --git a/sphinx/ext/autodoc.py b/sphinx/ext/autodoc.py index 1be4a7059..57cba83a8 100644 --- a/sphinx/ext/autodoc.py +++ b/sphinx/ext/autodoc.py @@ -594,19 +594,19 @@ class Documenter(object): # of inner classes can be documented full_mname = self.modname + '::' + \ '.'.join(self.objpath + [mname]) - memberdocumenters.append( - classes[-1](self.directive, full_mname, self.indent)) + documenter = classes[-1](self.directive, full_mname, self.indent) + memberdocumenters.append((documenter, isattr)) if (self.options.member_order or self.env.config.autodoc_member_order) \ == 'groupwise': # sort by group; relies on stable sort to keep items in the # same group sorted alphabetically - memberdocumenters.sort(key=lambda d: d.member_order) + memberdocumenters.sort(key=lambda d: d[0].member_order) - for documenter in memberdocumenters: - documenter.generate(all_members=True, - real_modname=self.real_modname, - check_module=members_check_module) + for documenter, isattr in memberdocumenters: + documenter.generate( + all_members=True, real_modname=self.real_modname, + check_module=members_check_module and not isattr) # reset current objects self.env.autodoc_current_module = None