Mailing-List: contact commits-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
From: Apache Wiki <wikidiffs@apache.org>
To: Apache Wiki <wikidiffs@apache.org>
Date: Sat, 29 Sep 2012 13:02:00 -0000
Message-ID: <20120929130200.34926.30264@eos.apache.org>
Subject: 
 =?utf-8?q?=5BCouchdb_Wiki=5D_Update_of_=22Documentation=22_by_kxepal?=
Auto-Submitted: auto-generated

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for c=
hange notification.

The "Documentation" page has been changed by kxepal:
http://wiki.apache.org/couchdb/Documentation?action=3Ddiff&rev1=3D19&rev2=
=3D20

Comment:
Add comment-answer for Noah Slater question about virtualenv.

  =

  ''Can someone explain why a virtual environment is needed? Why can't, or =
shouldn't, I just install these packages normally? ~ Noah S.''
  =

+ ''Virtualenv is good common practice to not mix system wide installed Pyt=
hon packages with project required ones. While in most cases you will not f=
ace any problems with installing sphinx and all his dependencies system wid=
e, there are some edge cases that could make things broken:
+ =

+ - Your system package manager doesn't have sphinx or some of his depended=
 package available to install. Manual system wide installation is like `mak=
e && make install` - one more step closer to unmanaged system;
+ =

+ - You already has sphinx installed, but of version that has breaking chan=
ges against required one, and you're needed this different version - updati=
ng could break something for you;
+ =

+ Since Python 3.3 release there wouldn't be any requirement for virtualenv=
 since it goes to be in [[http://docs.python.org/dev/library/venv.html#modu=
le-venv|stdlib]] and sphinx is ready for Python 3.x. ~ Alexander Sh.
+ ''
+ =

  =3D=3D Generation via Makefile =3D=3D
  =

  There is no makefile support yet. It should do the following: