@@ -185,23 +185,21 @@ class NumpyCDomain(ManglingDomainBase, CDomain):
185
185
def match_items (lines , content_old ):
186
186
"""Create items for mangled lines.
187
187
188
- This function tries to match the lines in ``lines``
189
- with the items (source file references and line numbers)
190
- in ``content_old``. The ``mangle_docstrings`` function
191
- changes the actual docstrings, but doesn't keep track of
192
- where each line came from. The manging does many operations
188
+ This function tries to match the lines in ``lines`` with the items (source
189
+ file references and line numbers) in ``content_old``. The
190
+ ``mangle_docstrings`` function changes the actual docstrings, but doesn't
191
+ keep track of where each line came from. The manging does many operations
193
192
on the original lines, which are hard to track afterwards.
194
193
195
- Many of the line changes come from deleting or inserting
196
- blank lines. This function tries to match lines by ignoring
197
- blank lines. All other changes (such as inserting figures
198
- or changes in the references) are compeltely ignored, so
199
- the generated line numbers will be off if ``mangle_docstrings``
194
+ Many of the line changes come from deleting or inserting blank lines. This
195
+ function tries to match lines by ignoring blank lines. All other changes
196
+ (such as inserting figures or changes in the references) are compeltely
197
+ ignored, so the generated line numbers will be off if ``mangle_docstrings``
200
198
does anything non-trivial.
201
199
202
- This is a best-effort function and the real fix would be
203
- to make ``mangle_docstrings`` actually keep track of the
204
- ``items`` together with the ``lines``.
200
+ This is a best-effort function and the real fix would be to make
201
+ ``mangle_docstrings`` actually keep track of the ``items`` together with
202
+ the ``lines``.
205
203
206
204
Examples
207
205
--------
0 commit comments