id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
16071	Update fix_ampersands documentation for behavior with existing entities	Jerry	nobody	"fix_ampersands doesn’t replace all ampersands with & entities; it attempts, usually successfully, to exclude named entities and numeric character references while converting all ampersands that do need replacing. This (and its behavior in some edge cases, noted at ticket:16066) should be documented.

Adds two lines under fix_ampersands in docs/_build/html/ref/templates/builtins.html:


{{{
Named entities and numeric character references are not replaced. If ``value``
is ``Pepé Le Pew``, the output will remain ``Pepé Le Pew``.

In some edge cases--such as abbreviations followed by semicolons--this filter
will not replace ampersands that need replacing. If ``value`` is ``Darrin, run
that past R&D; Betty…``, the output will remain unchanged because ``&D;``
resembles a named entity.
}}}
"	Cleanup/optimization	closed	Documentation	1.3	Normal	fixed	fix_ampersands filters		Ready for checkin	1	0	0	0	1	0