Document ext/uri

[kocsismate]

Another attempt to document ext/uri after #5060

Some of my sentences are very clunky, so I am happy to receive suggestions.

[TimWolla]

First pass at comments. Didn't yet look at all files, but this looks like a good start. Will take another look after you reviewed my comments to avoid looking at all files twice in case they change.

[TimWolla]

This is pretty tautological.

Suggested change

	Context of the error.
	The input URL at the point where the error was detected.

[kocsismate]

Yes, documenting such a huge API is very painful, so I usually tried to rely on very basic content (it can be improved over time). But I agree, your suggestion is much better!

[TimWolla]

so I usually tried to rely on very basic content (it can be improved over time)

Absolutely. I'm happy to get this merged when the obvious mistakes (e.g. example code is there, but the output is still a placeholder) are fixed and will then go through the rendered version to propose better explanations.

[TimWolla]

I don't think the RFC 3986 getters are appropriate "see also" for this method.

Suggested change

	<member><methodname>Uri\Rfc3986\Uri::getUsername</methodname></member>
	<member><methodname>Uri\Rfc3986\Uri::getRawUsername</methodname></member>
	<member><methodname>Uri\WhatWg\Url::getUsername</methodname></member>
	<member><methodname>Uri\WhatWg\Url::getUsername</methodname></member>
	<member><methodname>Uri\Rfc3986\Uri::withUserinfo</methodname></member>

[TimWolla]

Prefer references of the same class first (same for the others).

Suggested change

	<member><methodname>Uri\Rfc3986\Uri::withScheme</methodname></member>
	<member><methodname>Uri\WhatWg\Url::getScheme</methodname></member>
	<member><methodname>Uri\WhatWg\Url::getScheme</methodname></member>
	<member><methodname>Uri\Rfc3986\Uri::withScheme</methodname></member>

[TimWolla]

It should reference withUserInfo: For the same class the getters should be listed, for the other class, the corresponding with-er should be lsited.

[TimWolla]

Placeholder.

[TimWolla]

Placeholder.

[kocsismate]

I didn't have a good idea what kind of description I should write in the examples. Do you have a good suggestion?

[TimWolla]

The description for the example can just be dropped if you have nothing useful to say.

Suggested change

	<simpara>
	Description.
	</simpara>

[kocsismate]

Ah yes, that makes sense

[TimWolla]

I think listing the contructor / parse method here is appropriate.

[TimWolla]

Placeholder