From e0beae7ae0bea46e4af3892bd4d9298d256d3205 Mon Sep 17 00:00:00 2001 From: vrutsky Date: Thu, 2 Jul 2015 11:00:57 +0000 Subject: fix typo: "a a" --- docs/setuptools.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/setuptools.txt') diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 89c08e23..0feb09ea 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -1467,7 +1467,7 @@ are included in any source distribution you build. This is a big improvement over having to manually write a ``MANIFEST.in`` file and try to keep it in sync with your project. So, if you are using CVS or Subversion, and your source distributions only need to include files that you're tracking in -revision control, don't create a a ``MANIFEST.in`` file for your project. +revision control, don't create a ``MANIFEST.in`` file for your project. (And, if you already have one, you might consider deleting it the next time you would otherwise have to change it.) -- cgit v1.2.3 From ceb604c40ef9d095942952e7bb535bf8dd3295ed Mon Sep 17 00:00:00 2001 From: "Jason R. Coombs" Date: Sat, 5 Sep 2015 13:36:04 -0400 Subject: Update documentation to reflect no integrated SCM support. --- docs/setuptools.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/setuptools.txt') diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 0feb09ea..0646eff5 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -2595,8 +2595,8 @@ those methods' docstrings for more details. Adding Support for Other Revision Control Systems ------------------------------------------------- -If you would like to create a plugin for ``setuptools`` to find files in other -source control systems besides CVS and Subversion, you can do so by adding an +If you would like to create a plugin for ``setuptools`` to find files in +source control systems, you can do so by adding an entry point to the ``setuptools.file_finders`` group. The entry point should be a function accepting a single directory name, and should yield all the filenames within that directory (and any subdirectories thereof) that -- cgit v1.2.3 From 5fcd56e4962e04ba01c278f492f4a95e581d5882 Mon Sep 17 00:00:00 2001 From: "Jason R. Coombs" Date: Sat, 5 Sep 2015 13:37:35 -0400 Subject: Remove cruft from Subclassing section --- docs/setuptools.txt | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) (limited to 'docs/setuptools.txt') diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 0646eff5..e2753cba 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -2652,9 +2652,7 @@ Subclassing ``Command`` ----------------------- Sorry, this section isn't written yet, and neither is a lot of what's below -this point, except for the change log. You might want to `subscribe to changes -in this page `_ to see when new documentation is -added or updated. +this point. XXX -- cgit v1.2.3 From 9186dd6e15a7f7102ec4d3bf0f9c660ea6c7f082 Mon Sep 17 00:00:00 2001 From: "Jason R. Coombs" Date: Fri, 27 Nov 2015 12:43:20 -0500 Subject: Add a bit more detail about the setup script and what to expect. Fixes #466. --- docs/setuptools.txt | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'docs/setuptools.txt') diff --git a/docs/setuptools.txt b/docs/setuptools.txt index e2753cba..d6a62de8 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -112,10 +112,16 @@ the distutils. Here's a minimal setup script using setuptools:: ) As you can see, it doesn't take much to use setuptools in a project. -Just by doing the above, this project will be able to produce eggs, upload to +Run that script in your project folder, alongside the Python packages +you have developed. + +Invoke that script to produce eggs, upload to PyPI, and automatically include all packages in the directory where the setup.py lives. See the `Command Reference`_ section below to see what -commands you can give to this setup script. +commands you can give to this setup script. For example, +to produce a source distribution, simply invoke:: + + python setup.py sdist Of course, before you release your project to PyPI, you'll want to add a bit more information to your setup script to help people find or learn about your -- cgit v1.2.3