Re: Documenting python code using LyX

2009-10-22 Thread Guenter Milde
On 2009-10-20, Wolfgang Keller wrote: Does anybody use LyX to document python code? Any hints? PyLit already allows to round-trip between Python code with embedded ReST comments and ReST documents with embedded Python code blocks. From ReST, you can then convert to LaTeX, which should be

Re: Documenting python code using LyX

2009-10-22 Thread Guenter Milde
On 2009-10-20, Wolfgang Keller wrote: Does anybody use LyX to document python code? Any hints? PyLit already allows to round-trip between Python code with embedded ReST comments and ReST documents with embedded Python code blocks. From ReST, you can then convert to LaTeX, which should be

Re: Documenting python code using LyX

2009-10-22 Thread Guenter Milde
On 2009-10-20, Wolfgang Keller wrote: >> Does anybody use LyX to document python code? Any hints? > PyLit already allows to round-trip between Python code with embedded > ReST comments and ReST documents with embedded Python code blocks. From > ReST, you can then convert to LaTeX, which should be

Re: Documenting python code using LyX

2009-10-20 Thread Wolfgang Keller
Does anybody use LyX to document python code? Any hints? PyLit already allows to round-trip between Python code with embedded ReST comments and ReST documents with embedded Python code blocks. From ReST, you can then convert to LaTeX, which should be somewhat importable to LyX. However, I

Re: Documenting python code using LyX

2009-10-20 Thread Wolfgang Keller
Does anybody use LyX to document python code? Any hints? PyLit already allows to round-trip between Python code with embedded ReST comments and ReST documents with embedded Python code blocks. From ReST, you can then convert to LaTeX, which should be somewhat importable to LyX. However, I

Re: Documenting python code using LyX

2009-10-20 Thread Wolfgang Keller
> Does anybody use LyX to document python code? Any hints? PyLit already allows to round-trip between Python code with embedded ReST comments and ReST documents with embedded Python code blocks. From ReST, you can then convert to LaTeX, which should be somewhat importable to LyX. However, I

Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
H LyXians! Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Thanks in advance, Nikos

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Why not use pydocs? That's what it's for. Rich

Re: Documenting python code using LyX

2009-10-14 Thread Manveru
2009/10/14 Nikos Alexandris nikos.alexand...@felis.uni-freiburg.de: H LyXians! Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Thanks in advance, Nikos I am using Doxygen with doxypy extension with

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Why not use pydocs? That's what it's for.

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: I don't know if doxygen or pydoc is what I am looking for. Or is it exactly what I need? Nikos, Pydocs, in specific circumstances. To provide multiline comments use the triple quotation mark method; for example, This class takes the foo as

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: thanks for the reply. I have in mind (most of the times) a documentation to describe/ explain step by step what is done. I am a very beginner with Python, not a good programmer at all and I like to spend a lot of time to write down what each piece of

Re: Documenting python code using LyX

2009-10-14 Thread Guenter Milde
On 2009-10-14, Nikos Alexandris wrote: On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). thanks

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 14:21 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: I don't know if doxygen or pydoc is what I am looking for. Or is it exactly what I need? Nikos, Pydocs, in specific circumstances. To provide multiline comments use the triple

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 14:25 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: thanks for the reply. I have in mind (most of the times) a documentation to describe/ explain step by step what is done. I am a very beginner with Python, not a good programmer at all and I

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: Yes, I already do that. I have more comments than code :-p. And I tried pydoc. It works... but I am not sure this is what I need :-? Nikos, I don't know what you seek that cannot be accommodated by using the built-in comment syntax. Perhaps you

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 21:34 +, Guenter Milde wrote: On 2009-10-14, Nikos Alexandris wrote: On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 15:01 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Yes, I already do that. I have more comments than code :-p. And I tried pydoc. It works... but I am not sure this is what I need :-? Nikos, I don't know what you seek that cannot be

Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
H LyXians! Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Thanks in advance, Nikos

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Why not use pydocs? That's what it's for. Rich

Re: Documenting python code using LyX

2009-10-14 Thread Manveru
2009/10/14 Nikos Alexandris nikos.alexand...@felis.uni-freiburg.de: H LyXians! Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Thanks in advance, Nikos I am using Doxygen with doxypy extension with

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Why not use pydocs? That's what it's for.

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: I don't know if doxygen or pydoc is what I am looking for. Or is it exactly what I need? Nikos, Pydocs, in specific circumstances. To provide multiline comments use the triple quotation mark method; for example, This class takes the foo as

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: thanks for the reply. I have in mind (most of the times) a documentation to describe/ explain step by step what is done. I am a very beginner with Python, not a good programmer at all and I like to spend a lot of time to write down what each piece of

Re: Documenting python code using LyX

2009-10-14 Thread Guenter Milde
On 2009-10-14, Nikos Alexandris wrote: On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). thanks

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 14:21 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: I don't know if doxygen or pydoc is what I am looking for. Or is it exactly what I need? Nikos, Pydocs, in specific circumstances. To provide multiline comments use the triple

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 14:25 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: thanks for the reply. I have in mind (most of the times) a documentation to describe/ explain step by step what is done. I am a very beginner with Python, not a good programmer at all and I

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: Yes, I already do that. I have more comments than code :-p. And I tried pydoc. It works... but I am not sure this is what I need :-? Nikos, I don't know what you seek that cannot be accommodated by using the built-in comment syntax. Perhaps you

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 21:34 +, Guenter Milde wrote: On 2009-10-14, Nikos Alexandris wrote: On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 15:01 -0700, Rich Shepard wrote: On Wed, 14 Oct 2009, Nikos Alexandris wrote: Yes, I already do that. I have more comments than code :-p. And I tried pydoc. It works... but I am not sure this is what I need :-? Nikos, I don't know what you seek that cannot be

Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
H LyXians! Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Thanks in advance, Nikos

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: Does anybody use LyX to document python code? Any hints? I've read about noweb but it looks a bit more complicated than it should be... (?). Why not use pydocs? That's what it's for. Rich

Re: Documenting python code using LyX

2009-10-14 Thread Manveru
2009/10/14 Nikos Alexandris : > H LyXians! > > Does anybody use LyX to document python code? Any hints? I've read about > noweb but it looks a bit more complicated than it should be... (?). > > Thanks in advance, Nikos I am using Doxygen with doxypy

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: > On Wed, 14 Oct 2009, Nikos Alexandris wrote: > > > Does anybody use LyX to document python code? Any hints? I've read about > > noweb but it looks a bit more complicated than it should be... (?). > >Why not use pydocs? That's what it's

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: I don't know if doxygen or pydoc is what I am looking for. Or is it exactly what I need? Nikos, Pydocs, in specific circumstances. To provide multiline comments use the triple quotation mark method; for example, """This class takes the foo as

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: thanks for the reply. I have in mind (most of the times) a documentation to describe/ explain step by step what is done. I am a very beginner with Python, not a good programmer at all and I like to spend a lot of time to write down what each piece of

Re: Documenting python code using LyX

2009-10-14 Thread Guenter Milde
On 2009-10-14, Nikos Alexandris wrote: > On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: >> On Wed, 14 Oct 2009, Nikos Alexandris wrote: >> > Does anybody use LyX to document python code? Any hints? I've read about >> > noweb but it looks a bit more complicated than it should be... (?). >

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 14:21 -0700, Rich Shepard wrote: > On Wed, 14 Oct 2009, Nikos Alexandris wrote: > > > I don't know if doxygen or pydoc is what I am looking for. Or is it > > exactly what I need? > > Nikos, > >Pydocs, in specific circumstances. > >To provide multiline comments use

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 14:25 -0700, Rich Shepard wrote: > On Wed, 14 Oct 2009, Nikos Alexandris wrote: > > > thanks for the reply. I have in mind (most of the times) a documentation > > to describe/ explain step by step what is done. I am a very beginner with > > Python, not a good programmer at

Re: Documenting python code using LyX

2009-10-14 Thread Rich Shepard
On Wed, 14 Oct 2009, Nikos Alexandris wrote: Yes, I already do that. I have more comments than code :-p. And I tried pydoc. It works... but I am not sure this is what I need :-? Nikos, I don't know what you seek that cannot be accommodated by using the built-in comment syntax. Perhaps you

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 21:34 +, Guenter Milde wrote: > On 2009-10-14, Nikos Alexandris wrote: > > On Wed, 2009-10-14 at 12:45 -0700, Rich Shepard wrote: > >> On Wed, 14 Oct 2009, Nikos Alexandris wrote: > > >> > Does anybody use LyX to document python code? Any hints? I've read about > >> >

Re: Documenting python code using LyX

2009-10-14 Thread Nikos Alexandris
On Wed, 2009-10-14 at 15:01 -0700, Rich Shepard wrote: > On Wed, 14 Oct 2009, Nikos Alexandris wrote: > > > Yes, I already do that. I have more comments than code :-p. And I tried > > pydoc. It works... but I am not sure this is what I need :-? > > Nikos, > >I don't know what you seek that