pytest.raises documention doesn't state upfront that 'match' is keyword only

[brettcannon]

Reading http://pytest.org/en/latest/reference.html#pytest-raises I thought the 'match' argument supporting positional specificity due to it being listed as [, match] in the parameter list and the argument specification not saying anything about it. But if you read a bit farther down you notice that it's mentioned it's keyword-only.

My suspicion is there's no way to change the syntax of that parameter list to use *, to make it clearer that match is positional-only? Otherwise I'm happy to write a PR to state that in its parameter documentation.

[Zac-HD]

https://github.com/pytest-dev/pytest/blob/master/doc/en/reference.rst#pytest-raises

Looks like the signature is specified in our docs file, so it should be pretty easy to fix!

[nnrepos]

@Zac-HD, do you think changing [, match] to , [match] is clear enough? If so, where can it be changed? Could you type the path to the directory from which http://pytest.org/en/latest/reference.html#pytest-raises is edited? Thanks

[Zac-HD]

@nnrepos - I think [, *, match] would be clearer, using Python 3's syntax for keyword-only arguments. The file is doc/en/reference.rst. Hope that helps 😄

[brettcannon]

@Zac-HD created #6173 to implement your suggestion.