Fix handling of dedented continuation lines.

[anntzer]

• Dedent the function definition before parsing it.
• Join continued-lines before attempting to parse the docstring.

Alternative to #441; further improves handling of parameter descriptions with continued lines (which were not handled correctly before).

Thanks for submitting a PR!

Please make sure to check for the following items:

• Add unit tests and integration tests where applicable.
  If you've added an error code or changed an error code behavior,
  you should probably add or change a test case file under tests/test_cases/ and add
  it to the list under tests/test_definitions.py.
  If you've added or changed a command line option,
  you should probably add or change a test in tests/test_integration.py.
• Add a line to the release notes (docs/release_notes.rst) under "Current Development Version".
  Make sure to include the PR number after you open and get one.

Please don't get discouraged as it may take a while to get a review.

[sambhav]

Thanks for the patch. But from what I can see, this introduces new behaviour which is unrelated to the original issue. (It looks like if the doc string now has line continuation, it no longer errors with a D207). Although this might be a good improvement, can we please file a related issue to the repo with this behaviour and reference that in this PR instead?

Also it looks like most of the code in this PR is taken from #441

Can you either pick my commits from that PR to preserve the original code attribution or wait for it to be merged and create a new PR with the improved handling of line continuations?

I would prefer the latter.

[sambhav]

Looks like the issue this PR is solving is - #234

Let's update the PR, description and docs to match the same.

[anntzer]

The only reason I opened this separately is because you didn't pick up #441 (comment). Now that you did I have no problem waiting for your PR to go in first and rebase this one over yours.

[sambhav]

The original PR was fixed. Would you like to rebase and update the description with the dedented bug fix?

[sambhav]

@anntzer bump?

[anntzer]

fixed :)

[sambhav]

Thanks for this. Sorry for the late review. Can you also add a test that tests for line continuation in sections beside the Params one?

[anntzer]

What do you actually want to test for?

[sambhav]

That it doesn't throw D207 for normal doc string descriptions with line continuations

[anntzer]

done

[sambhav]

Isn't it doing this for more than just numpy parameter descriptions at this point?

[sambhav]

should we update this?

[anntzer]

thanks for fixing the last part :)