Re: cleaning up docs/conf.py

2013-03-29 Thread Tshepang Lekhonkhobe
Well, one can always add a link targetting Sphinx settings documentation: For a complete listing of available settings, see http://sphinx-doc.org/config.html. An advantage with this approach is you get updated info, for example. On Fri, Mar 29, 2013 at 2:02 PM, Domen Kožar wrote: > I'd sa

Re: cleaning up docs/conf.py

2013-03-29 Thread Domen Kožar
I'd say it better to stay there, as it provides inline documentation for settings that you might turn on. To clean it up, maybe split settings in two sections - configured and commented. On Fri, Mar 29, 2013 at 1:00 PM, Tshepang Lekhonkhobe wrote: > On Sat, Mar 16, 2013 at 9:23 PM, Tshepang Lek

Re: cleaning up docs/conf.py

2013-03-29 Thread Tshepang Lekhonkhobe
On Sat, Mar 16, 2013 at 9:23 PM, Tshepang Lekhonkhobe wrote: > > I find the file overlong and messy. I would therefore like to get rid > of all commented-out unused options (those which just display a > default value). Is this acceptable? anyone? -- You received this message because you are sub