zopectl and runzope not working on freshly easy_install'd zope 2.12.0c1

[Jürgen Herrmann]

steps to reproduce:

>>> mkdir /home/jh/1

>>> cd /home/jh/1

>>> virtualenv .

>>> ./bin/easy_install Zope2
    *snip lots of output*

>>> ./bin/mkzopeinstance
Please choose a directory in which you'd like to install
Zope "instance home" files such as database files, configuration
files, etc.

Directory: /home/jh/1
Please choose a username and password for the initial user.
These will be the credentials you use to initially manage
your new Zope instance.

Username: admin
Password: ***
Verify password: ***

>>> ./bin/zopectl fg
Traceback (most recent call last):
  File "./bin/zopectl", line 8, in <module>
    load_entry_point('Zope2==2.12.0c1', 'console_scripts', 'zopectl')()
  File "/home/jh/1/lib/python2.6/site-packages/Zope2-2.12.0c1-py2.6-linux-i686.egg/Zope2/Startup/zopectl.py", line 347, in run
    exitstatus = main()
  File "/home/jh/1/lib/python2.6/site-packages/Zope2-2.12.0c1-py2.6-linux-i686.egg/Zope2/Startup/zopectl.py", line 303, in main
    options.realize(args)
  File "/home/jh/1/lib/python2.6/site-packages/Zope2-2.12.0c1-py2.6-linux-i686.egg/Zope2/Startup/zopectl.py", line 122, in realize
    self.directory = config.instancehome
AttributeError: 'NoneType' object has no attribute 'instancehome'

>>> ./bin/runzope
Traceback (most recent call last):
  File "./bin/runzope", line 8, in <module>
    load_entry_point('Zope2==2.12.0c1', 'console_scripts', 'runzope')()
  File "/home/jh/1/lib/python2.6/site-packages/Zope2-2.12.0c1-py2.6-linux-i686.egg/Zope2/Startup/run.py", line 19, in run
    opts = _setconfig()
  File "/home/jh/1/lib/python2.6/site-packages/Zope2-2.12.0c1-py2.6-linux-i686.egg/Zope2/Startup/run.py", line 50, in _setconfig
    handlers.handleConfig(opts.configroot, opts.confighandlers)
  File "/home/jh/1/lib/python2.6/site-packages/Zope2-2.12.0c1-py2.6-linux-i686.egg/Zope2/Startup/handlers.py", line 263, in handleConfig
    return multihandler(handlers)
TypeError: 'NoneType' object is not callable

[Andreas Jung (ajung)]

See

http://docs.zope.org/zope2/releases/2.12/INSTALL.html

[Jürgen Herrmann (xlhost)]

the virtualenv directory and the instance_home directory cannot be identical. that was the underlying issue.

[Andreas Jung (ajung)]

Documentation has been updated