On Wed, Aug 24, 2011 at 5:05 PM, srean wrote:

Following up on my own question: I can see the code in the commit. So it appears that

code-block::

Are not being rendered correctly. Could anyone confirm ? In case it is my browser alone, though I did try after disabling no-script.

I believe this is because of github's .rst processor which simply drops blocks it can't understand. When building NumPy documentation, many more extensions and context exists. I'm getting the same thing in the C-API NA-mask documentation I just posted. -Mark

On Wed, Aug 24, 2011 at 6:53 PM, srean wrote:

...

Hi,

I was reading this document, https://github.com/numpy/numpy/blob/master/doc/source/user/c-info.ufunc-tuto...

its well written and there is a good build up to exciting code examples that are coming, but I do not see the actual examples, only how they may be used. Is it located somewhere else and not linked? or is it that the c-info.ufunc-tutorial.rst document is incomplete and the examples have not been written. I suspect the former. In that case could anyone point to the code examples and may be also update the c-info.ufunc-tutorial.rst document.

Thanks

-- srean

_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@scipy.org http://mail.scipy.org/mailman/listinfo/numpy-discussion

Thanks Anthony and Mark, this is good to know. So what would be the advised way of looking at freshly baked documentation ? Just look at the raw files ? or is there some place else where the correct sphinx rendered docs are hosted. On Wed, Aug 24, 2011 at 7:19 PM, Anthony Scopatz wrote:

code-block:: is a directive that I think might be specific to sphinx. Naturally, github's renderer will drop it.

On Wed, Aug 24, 2011 at 7:10 PM, Mark Wiebe wrote:

...

I believe this is because of github's .rst processor which simply drops blocks it can't understand. When building NumPy documentation, many more extensions and context exists. I'm getting the same thing in the C-API NA-mask documentation I just posted.

-Mark

On Wed, Aug 24, 2011 at 8:43 PM, Anthony Scopatz wrote:

On Wed, Aug 24, 2011 at 7:34 PM, srean wrote:

...

Thanks Anthony and Mark, this is good to know.

So what would be the advised way of looking at freshly baked documentation ? Just look at the raw files ? or is there some place else where the correct sphinx rendered docs are hosted.

Building the docs yourself is probably the safest bet.  However, someone should probably hook up the numpy and scipy repos to readthedocs.org.  That would solve this problem...

Maybe someone just needs to add it here http://docs.scipy.org/numpy/docs/numpy-docs/user/c-info.rst/#c-info and it would show up in numpy's own docs, which are hooked up to the repo, as far as I know. Josef

...

On Wed, Aug 24, 2011 at 7:19 PM, Anthony Scopatz wrote:

...

code-block:: is a directive that I think might be specific to sphinx.  Naturally, github's renderer will drop it. On Wed, Aug 24, 2011 at 7:10 PM, Mark Wiebe wrote:

...

I believe this is because of github's .rst processor which simply drops blocks it can't understand. When building NumPy documentation, many more extensions and context exists. I'm getting the same thing in the C-API NA-mask documentation I just posted. -Mark

_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@scipy.org http://mail.scipy.org/mailman/listinfo/numpy-discussion

_______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@scipy.org http://mail.scipy.org/mailman/listinfo/numpy-discussion