couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Couchdb Wiki] Update of "Documentation" by kxepal
Date Sat, 29 Sep 2012 13:02:00 GMT
Dear Wiki user,

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

The "Documentation" page has been changed by kxepal:
http://wiki.apache.org/couchdb/Documentation?action=diff&rev1=19&rev2=20

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 Python packages with
project required ones. While in most cases you will not face any problems with installing
sphinx and all his dependencies system wide, 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 `make && make install` - one more
step closer to unmanaged system;
+ 
+ - You already has sphinx installed, but of version that has breaking changes against required
one, and you're needed this different version - updating 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#module-venv|stdlib]] and sphinx is
ready for Python 3.x. ~ Alexander Sh.
+ ''
+ 
  == Generation via Makefile ==
  
  There is no makefile support yet. It should do the following:

Mime
View raw message