those that don't need to put into a dedicated file
are now inside the miscellaneous.txt

outline is completed, now to fill the donut holes

such that each section is comprised of a quick intro and example
that illustrate the use of that functionality and provide a link
to a more detailed explanation.

egg-secutable section moved from userguide/functionalities to deprecated/functionalities

so that the quickstart is cleaner for now. Might add more text later

from quickstart.txt to functionalities.txt

doc overhaul step 2: break main doc into multiple sections

from pointing at setuptools.txt to userguide/index.txt

cut and paste from setuptools.txt

cut-and-paste from setuptools.txt

Did a cut and paste from setuptools.txt

Did a cut and paste from setuptoo.txt to userguide/quickstart.txt

doc overhaul step 1: simplify index and group deprecated files

Tweak note about setup.cfg

Emit deprecation warning when 2to3 is used.

The top index now points to three files: setuptools.txt (user guide),
development.txt (development guide) and a WIP index file that is to
summarized deprecated practice that remains relevant for backward
compatibility.

In the deprecation warning, acknowledge that it's only for projects that still require Python 2 support.