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

Comments

Projects
None yet
1 participant
@nvaccessAuto
Copy link

commented Jun 8, 2012

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

This comment has been minimized.

Copy link
Author

commented Jun 8, 2012

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

This comment has been minimized.

Copy link
Author

commented Jun 9, 2012

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

This comment has been minimized.

Copy link
Author

commented Jun 9, 2012

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

This comment has been minimized.

Copy link
Author

commented Jan 21, 2013

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

@nvaccessAuto nvaccessAuto added this to the 2013.1 milestone Nov 10, 2015

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.