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

fabric-1.4.2 release incomplete docs content. #640

idella opened this issue May 10, 2012 · 4 comments

fabric-1.4.2 release incomplete docs content. #640

idella opened this issue May 10, 2012 · 4 comments


Copy link

idella commented May 10, 2012

From the released tarball.

archtester fabric # ls /mnt/gen2/TmpDir/portage/dev-python/fabric-1.4.2//work/Fabric-1.4.2/docs/

api changelog.rst development.rst faq.rst index.rst installation.rst roadmap.rst tutorial.rst usage

Files, Makefile and folders _static and _templates from github not included.
Such a number makes wonder if the docs were not intended for building.

Copy link

I'd consider merging a patch that updates to include the necessary components for doc building.

Typically we assume people building docs will be using the actual, full source code as obtained from Git or a Github tarball, and not the PyPI sdist, which is primarily intended for installing the Python code.

Copy link

@@ -2,7 +2,9 @@
 include INSTALL
 include LICENSE
 include README
-recursive-include docs *.rst
+include doc/
+include doc/Makefile
+recursive-include docs *.css *.html *.rst
 recursive-exclude docs/_build *
 include requirements.txt

Copy link

#644's list is actually even better -- I finally went back and looked explicitly at our docs dir and yes -- we would want to include everything but _build for maximum usefulness to somebody obtaining just an sdist tarball. (The more explicit version in @Arfrever's diff works just as well, but I don't anticipate adding any files to docs that would not be needed to build the docs.)

I'll merge something in a minute.

Copy link

floppym commented May 17, 2012

Thanks for merging.

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

No branches or pull requests

4 participants