On Thu, Mar 4, 2010 at 6:10 PM, Michael Hudson-Doyle <micahel@gmail.com> wrote:
On 5 March 2010 12:31, Kevin Horn <kevin.horn@gmail.com> wrote:
> On Thu, Mar 4, 2010 at 5:05 PM, <exarkun@twistedmatrix.com> wrote:
>>
>> On 10:49 pm, kevin.horn@gmail.com wrote:
>> >
>> >  If you look up a class, like "twisted.internet.defer.Deferred" for
>> >example,
>> >  the link looks like this:
>> >
>> >
>>
>> > >http://twistedmatrix.com/documents/current/api/twisted.internet.defer.Deferred.html
>> >
>> >  Pretty simple right?  But if you look up a function or method like
>> >  "twisted.internet.defer.Deferred.callback", the link has an anchor,
>> >like
>> >so:
>> >
>> >
>>
>> > >http://twistedmatrix.com/documents/9.0.0/api/twisted.internet.defer.Deferred.html#addCallback
>> >
>> >  So we'll need to do some checking on either the api docs or on twisted
>> >itself
>> >  to determine what sort of object is being linked to.  Shouldn't be
>> >  super-difficult, just haven't had time yet.
>>
>> Did you notice that
>>
>> http://twistedmatrix.com/documents/9.0.0/api/twisted.internet.defer.Deferred.addCallback.html
>> also exists?
>>
>> Jean-Paul
>>
>
> I hadn't actually.  If all functions and methods have a similar page in the
> PyDoctor output, then I think what I have now will pretty much work as-is
> (almost).  Do we think that just generating links to the individual
> function/method pages is acceptable?

It's what the lore-processed documentation currently links to.  It
would be nice to fix this (and I sort of vaguely know how), but that
should in no way hold up the move away from lore!

Cheers,
mwh


OK, if that's the way Lore does it, then I'm happy to call that "good enough for now".  It seems to work here in my local version of the docs, I'll update the online stuff at http://twistedsphinx.funsize.net soonish.

Kevin Horn