On Mon, Oct 29, 2012 at 10:56 AM, JP <[email protected]> wrote:
> Hi there Greg,
>
> This is a good idea - and one which is bound to save me lots of
> questions later on.

Glad you like it.

> I have added an Index to Cookbook.rst, but I cannot commit it back
> "svn: Authorization failed" . Unsurprising, as I have checked out a
> "read-only version" from the sf svn code page.

That's part of it. The other is that you aren't a committer for the RDkit. :-)

The easiest way to have source control available for working with this
would be to use github.

> Also, can you add a
> recipe on how to sphinx-generate the documentation (shamefully I have
> to admit I haven't tested this, bad bad boy).  I would like to make
> hyperlinks from each of the entries in the ToC to the actual code
> snippets - can I just htmlize the Cookbook documentation with anchors
> and hrefs ?

I will figure out if there's an easy way todo this. At the moment
because of the inclusion of the API documentation in the Sphinx docs
you need a copy of the API docs in order to build the HTML version. I
might be able to change this.

> I think an index section is important, not now, but when you have 20+
> entries and you want to check if some bit of functionality is already
> available or not (stops you from reading the whole page).  Here is
> what it looks like, it comes right after the "What is this" section.
>
> Table of Contents
> *****************
>
> The following recipes are found on this page:
>
> *  Cleaning up heterocycles - this fixes some [most?] of the annoying "can't
> kekulize errors"
> *  Parallel conformation generation - this bit of code makes use of your
> multi-core machine to generate conformers for a particular molecule
> *  Neutralizing Charged Molecules - removes charges from a molecule based on a
> set of SMARTS patterns
>
> NB more details can be found in every mailing-list cited post.

Good idea. I'll add this.

> p.s. how is the windows 8 build coming along ? :-)

Great! I should be done by the end of the day on the second Tuesday of
next week. ;-)

-greg

------------------------------------------------------------------------------
The Windows 8 Center - In partnership with Sourceforge
Your idea - your app - 30 days.
Get started!
http://windows8center.sourceforge.net/
what-html-developers-need-to-know-about-coding-windows-8-metro-style-apps/
_______________________________________________
Rdkit-discuss mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/rdkit-discuss

Reply via email to