I did add a note saying that the templates don’t work, but unfortunately I don’t have time to learn PHP, reverse-engineer the entire theming system, and write up my findings right now. The reason I’m resorting to Codex in the first place is because I don’t already know how this stuff works and it is therefore fairly difficult for me to explain it to anyone else.
I do appreciate the efforts of the docs writers, but their consistent failure to grasp this simple point baffles me. Or maybe they see no contradiction in trying to document things they don’t know much about.
(Whatever, I’m through with whining about documentation. If it really mattered to me that much, I’d be using MT, wouldn’t I?)