0

I've found errors in multiple sets of man pages for open source packages. I want to submit patches but I can't find the source for them, only the code.

Are they maintained with the project? Is this project specific?

For example, where is the source for the virtualenv or ejabberdctl man page?

  • What's the downvote about? – jglouie May 8 '17 at 11:12
4

It is project specific, although there are some standard locations. Look in the makefile for the project and track down the make command for the man pages or whatever documentation the project provides, and there you'll find what you seek.

Some projects separate it out, ejabbedctl is part of ejabberd and the docs for ejabberd are on a separate github repository, specifically the folder containing ejabberdcrl is content/admin/ejabberdctl/ in the docs.ejabberd repository.

For virtualenv, the project is python so they're using sphinx, which pulls a lot of the documentation straight from the source (much like doxygen, javadoc, et al) and converts sphinx code into several formats (html, latex, man, text, et al). If you look at it in github, it looks like it's the finished product because github knows how to display .rst files. The docs directory in the virtualenv source has things like the userguide, etc. You may find what you're looking for there. Since it could be embedded anywhere, I'd recommend pulling down the source and using grep to find the erroneous text, it could be literally anywhere.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.