Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

In the readme file, epydoc is not listed #2421

Closed
nvaccessAuto opened this issue Jun 8, 2012 · 4 comments
Closed

In the readme file, epydoc is not listed #2421

nvaccessAuto opened this issue Jun 8, 2012 · 4 comments

Comments

@nvaccessAuto
Copy link

Reported by PZajda on 2012-06-08 19:05
Hi,

To generate developer documentation, we have to install epydoc.
But it is not specified to the readme file available in last rev (main and 2012.2).

Could you add a note to specify we have to install it?
I installed it before because I read the message on the list which specified that, but I supose some people hasn't had this message which was sent some months ago.

@nvaccessAuto
Copy link
Author

Comment 1 by PZajda on 2012-06-08 19:06
Changes:
Changed title from "In the readme file, epydoc has disapeared" to "In the readme file, epydoc is not listed"

@nvaccessAuto
Copy link
Author

Comment 2 by jteh on 2012-06-09 04:59
Work on building code docs stalled because the current version of Epydoc doesn't work properly with Python 2.7, so it generates documentation with a lot of stuff (specifically comment docstrings) missing. I can add the Epydoc dependency, but it's misleading at best because it doesn't work as intended.

@nvaccessAuto
Copy link
Author

Comment 3 by PZajda on 2012-06-09 12:07
Hi,

So could you make epydoc not required on devDocs target?
Because I tried to generate developers documentation without epydoc installed and scons terminated with error about epydoc missing.

@nvaccessAuto
Copy link
Author

Comment 4 by jteh (in reply to comment 2) on 2013-01-21 07:05
Replying to jteh:

Work on building code docs stalled because the current version of Epydoc doesn't work properly with Python 2.7, so it generates documentation with a lot of stuff (specifically comment docstrings) missing.

This is covered by bug 2585292, which includes a patch. Development of Epydoc seems to have stalled, so we'll have to maintain our own build. I've made a build including this patch.

e10bd0c adds Epydoc to the source readme and provides a link to this build.
Changes:
Milestone changed from None to 2013.1
State: closed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant