Add source comment to explain why is the second argument (msgnode) not needed. Refs #1300, 8d51df20d4

1 files changed, 6 insertions, 0 deletions

diff --git a/sphinx/transforms.py b/sphinx/transforms.py
index 8919d6ce..0e103acf 100644
--- a/sphinx/transforms.py
+++ b/sphinx/transforms.py
@@ -243,6 +243,12 @@ class Locale(Transform):
                         self.document.ids.pop(_id, None)
 
                     # re-entry with new named section node.
+                    #
+                    # Note: msgnode that is a second parameter of the
+                    # `note_implicit_target` is not necessary here because
+                    # section_node has been noted previously on rst parsing by
+                    # `docutils.parsers.rst.states.RSTState.new_subsection()`
+                    # and already has `system_message` if needed.
                     self.document.note_implicit_target(section_node)
 
                     # replace target's refname to new target name