Re: [tor-dev] use sphinx on stem

2012-06-05 Thread Damian Johnson
> Do you need any help on this, or you can > complete all the work by yourself and I should move to another task > (maybe events)? Nope, I should be fine finishing this on my own. Events would be a great thing to work on next. I haven't written any examples but hopefully it won't be too hard to fi

Re: [tor-dev] use sphinx on stem

2012-06-05 Thread Beck Chen
Oh, that's absolutely my fault that has not contacted you or showed up on irc this week. I didn't spend too much time on it thought, so things are not that bad. Do you need any help on this, or you can complete all the work by yourself and I should move to another task (maybe events)? Beck ___

Re: [tor-dev] use sphinx on stem

2012-06-05 Thread Damian Johnson
Hi Beck. It's a pity that you disappeared from irc, I tried to tell you there that I was actively looking into Sphinx too and had some discussions in #tor-dev about if we should switch to reStructuredText. I'm currently converting all of our pydocs and will probably be done tomorrow... https://git

[tor-dev] use sphinx on stem

2012-06-05 Thread Beck Chen
Hi Damian, I explored sphinx and tried it on stem these days, and it seemed pretty handy. I think a good way to produce nice documentation for stem is to create a page for each module manually, write an introduction by hand, and use autoclass / autofunction / autoexception in the autodoc extension