Replace lore's line-number example inclusion with class/function inclusion

[twisted-trac]

	@glyph reported
Trac ID	trac#1073
Type	defect
Created	2005-06-03 08:51:26Z

Searchable metadata

trac-id__1073 1073
type__defect defect
reporter__glyph glyph
priority__high high
milestone__ 
branch__ 
branch_author__ 
status__closed closed
resolution__fixed fixed
component__lore lore
keywords__documentation__lore__EndOfLore documentation, lore, EndOfLore
time__1117788686000000 1117788686000000
changetime__1389977747000000 1389977747000000
version__ 
owner__ 
cc__glyph cc__radix cc__spiv cc__thijs

[twisted-trac]

	@glyph commented

#!html
<pre>
Lore currently uses line-number offsets to point into examples.  This is wrong.
 It should use semantic ranges like classnames and function names.  This way you
don't need to update _every_ file that refers to it when you update example .py
files.
</pre>

[twisted-trac]

	@radix commented

#!html
<pre>
VERB
</pre>

[twisted-trac]

	@glyph commented

#!html
<pre>
NOUN! (what?)

I'm not really the right person to do this.  Who is?  Hot potato time.
</pre>

[twisted-trac]

	@radix commented

#!html
<pre>
(VERB: it's good to have explanatory titles that contain a verb indicating what
action must be done :)

I guess I'll potato this over to spiv, unfortunately. I know he's not *really*
the maintainer of Lore, but he's still marked as it :)
</pre>

[twisted-trac]

	@khorn set owner to @khorn

Sphinx supports including classes, functions and methods in this manner, so this should be fixed following the Sphinx conversion.

[twisted-trac]

	Automation removed owner

[twisted-trac]

	@khorn set status to closed

As we are now using Sphinx for documentation, following completion of #4500, this is effectively fixed.