(see #stuff) references break on trailing punctuation

[kopischke]

Using (see #stuff). instead of (see #stuff) (note the period in the first example) will break reference lookup.

[lsegal]

Periods are not supported with the (see X) syntax, so the current behaviour is expected.

[kopischke]

I don’t doubt this is expected behavior – I posit it is orthogonal to user expectations :). Adding punctuation is a natural idea in a natural language input-ish setting, and as trailing punctuation has no greater significance than trailing whitespace, which is ignored when parsing for the reference token, I’d also expect it to be ignored. Anyway, I’ve already come out the other end of that particular tunnel, so consider it “that really tripped me up” input and feel free to close; personally, I’d rather see #728 and #729 fixed, which are really messing up my docs.

[lsegal]

The issue is that (see X) is special macro syntax, and not natural language. It's meant to be unambiguous. Otherwise it would be impossible to differentiate actual natural language inputs from this macro reference syntax.

I am going to close this. And yes, I have seen the other reports.