created directory setuptools/docs/references and place
keywords.txt from PR1765 in it en bloc

doc overhaul step 3: update userguide

these should be properly grouped but for now I'm just
leaving them here

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