I just sent this message to the turbogears mailing list
by mistake instead of here.  Sorry!  
Here it goes again:

There's a sort of inconsistency among the docs tutorials about
whether or not work is done in a virtual environment.

The "How to install TurboGears2" document (DownloadInstall)
includes the item "Setting up a Virtual Environment", not listed as
optional, and illustrates the "(tg2env)$" prompt as a sign that the 
virtualenv having been activated.

Then (till I changed it) proceeded to illustrate shell commands 
with a regular prompt. - 

The next section, Quickstarting a TG2 project, 
made no reference to a virtualenv - so last week I inserted
a statement at the top that if tg2 had been installed in a 
virtual env, it was assumed it had now been activated.
(and linked back to the process of activation).

The wiki20 docs don't mention virtualenv, 
or show any tg2env prefix on the prompt, but for example
the two tutorials in Extensions.Geo docs do - every shell 
prompt there has the (tg2env) prefix.  

A recursive grep on the docs directories shows that the only 
occurrence of the prefix is in:
*   main/DownloadInstall.rst
*   main/Extensions/Geo/TileCacheTutorial.rst
*   main/Extensions/Geo/MapFishTutorial.rst

I'm going through the wiki20 and toscawidgets tutorials 
converting SA setup to declarative, and wondering 
what the policy is: 
- all tutorials explicitlly assume virtualenv?
- none do?
- it's up to the whim of the documentor?

I'm happy to insert that prompt in the wiki20 and toscawidgets
tutorials if you want.

-- 
Anita


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TurboGears Docs" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/turbogears-docs?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to