473,508 Members | 2,312 Online
Bytes | Software Development & Data Engineering Community
+ Post

Home Posts Topics Members FAQ

Pythonland documentation

Hi

I am new to python (fairly) but can't stop pythonning.

c++ seems so far away now.... from here it looks like a horrid scribble :)

Anyway.... my question is really about doc tools. I've been used to
doxygen in c++ land, and although it makes a reasonable stab with a
python project in java mode, the output is a bit messy.

Can any one suggest a more tailored tool? or do I risk a flamewar? :)

Thanks

SiPi

--
Linux user #458601 - http://counter.li.org.

Jan 18 '08 #1
2 1244
On Jan 18, 12:51 pm, Simon Pickles <sipick...@hotmail.comwrote:
Hi

I am new to python (fairly) but can't stop pythonning.

c++ seems so far away now.... from here it looks like a horrid scribble :)

Anyway.... my question is really about doc tools. I've been used to
doxygen in c++ land, and although it makes a reasonable stab with a
python project in java mode, the output is a bit messy.

Can any one suggest a more tailored tool? or do I risk a flamewar? :)

Thanks

SiPi

--
Linux user #458601 -http://counter.li.org.
Well, there's DocUtils:

http://docutils.sourceforge.net/

And here are some others:

http://peak.telecommunity.com/protoc...-example1.html

And finally, there's this:

http://www.python.org/community/sigs...ig/otherlangs/

Mike
Jan 18 '08 #2
Le Fri, 18 Jan 2008 18:51:19 +0000, Simon Pickles a écritÂ*:
Hi

I am new to python (fairly) but can't stop pythonning.

c++ seems so far away now.... from here it looks like a horrid scribble
:)

Anyway.... my question is really about doc tools. I've been used to
doxygen in c++ land, and although it makes a reasonable stab with a
python project in java mode, the output is a bit messy.

Can any one suggest a more tailored tool? or do I risk a flamewar? :)
You can take a look at epydoc

http://epydoc.sourceforge.net/

>
Thanks

SiPi


--
Laurent POINTAL - la*************@laposte.net
Jan 19 '08 #3

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

20
3243
by: Daniel R. Smorey Jr. | last post by:
I'm looking for a good place for Python documentation. I'm really lost on why it's so hard to find anything when it comes to me looking up a particular function in Python. My example would be the...
11
1948
by: Steve | last post by:
posted on: comp.lang.python emailed to: docs@python.org I have a suggestion/request that will, I think, improve the Python documentation. Currently, the Python documentation in HTML format is...
24
2186
by: Christopher J. Bottaro | last post by:
This post is just the culmination of my thoughts and discussions with my coworkers on Python. If you are not interested, please skip over it. At my work, we are developing a product from...
0
2135
by: Jeff Levinson [mcsd] | last post by:
I'm an architect for a very large fortune 100 company and we still struggle with the best balance. However, I use a couple of simple guidelines that have worked very well for me in almost all...
0
2391
by: Almoni | last post by:
Hi, I have a few .xsd files that include each other in the following way: <!-- lets call the main schema file AA.xsd and it includes BB.xsd inside it --> <xs:schema...
1
2958
by: Ole Hanson | last post by:
I would like to be able to generate documentation for a custom configuration file (xml) to enable future support engineers to understand applicable values to the various elements inside the...
97
4286
by: Cameron Laird | last post by:
QOTW: "Python makes it easy to implement algorithms." - casevh "Most of the discussion of immutables here seems to be caused by newcomers wanting to copy an idiom from another language which...
0
1807
by: innovasys | last post by:
TORQUAY, DEVON, UK - Innovasys announced the release of Document! X 5, the fifth version of the documentation solution of choice for developers using Microsoft Visual Studio or the .NET Framework....
34
2878
by: nicolasfr | last post by:
Hi, I am a bit disapointed with the current Python online documentation. I have read many messages of people complaining about the documentation, it's lack of examples and the use of complicated...
0
7123
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can...
0
7326
Oralloy
by: Oralloy | last post by:
Hello folks, I am unable to find appropriate documentation on the type promotion of bit-fields when using the generalised comparison operator "<=>". The problem is that using the GNU compilers,...
0
7383
jinu1996
by: jinu1996 | last post by:
In today's digital age, having a compelling online presence is paramount for businesses aiming to thrive in a competitive landscape. At the heart of this digital strategy lies an intricately woven...
1
7046
by: Hystou | last post by:
Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows...
0
5627
agi2029
by: agi2029 | last post by:
Let's talk about the concept of autonomous AI software engineers and no-code agents. These AIs are designed to manage the entire lifecycle of a software development project—planning, coding, testing,...
1
5053
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome a new...
0
4707
by: conductexam | last post by:
I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and...
1
766
muto222
by: muto222 | last post by:
How can i add a mobile payment intergratation into php mysql website.
0
418
bsmnconsultancy
by: bsmnconsultancy | last post by:
In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.