[Checkins] SVN: zope3book/trunk/source/ Rephrase few sentences

Baiju M baiju.m.mail at gmail.com
Mon Feb 23 01:37:21 EST 2009


Log message for revision 97128:
  Rephrase few sentences
  

Changed:
  U   zope3book/trunk/source/development-tools.rst
  U   zope3book/trunk/source/getting-started.rst

-=-
Modified: zope3book/trunk/source/development-tools.rst
===================================================================
--- zope3book/trunk/source/development-tools.rst	2009-02-23 06:36:46 UTC (rev 97127)
+++ zope3book/trunk/source/development-tools.rst	2009-02-23 06:37:20 UTC (rev 97128)
@@ -7,24 +7,22 @@
 are already familiar with these you may skip this chapter.
 
 
-Eggs
-----
+Eggs and setuptools
+-------------------
 
-Eggs are Python's new distribution format managed using `setuptool`
-package http://peak.telecommunity.com/DevCenter/PythonEggs .
+Eggs_ are Python's new distribution format.  We can make Python
+packages in Egg format using setuptool package.  To install an egg,
+you can use easy_install_.  An easy way to automate the installtion
+would be to use `easy_setup.py` program.  To install setuptool, these
+two steps are enough::
 
-To install an egg, you can use easy_install program
-http://peak.telecommunity.com/DevCenter/EasyInstall .
-
-An easy way to automate the installtion would be to use
-easy_setup.py program.
-
-::
-
   $ wget -c http://peak.telecommunity.com/dist/ez_setup.py
   $ python easy_setup.py
 
 
+.. _Eggs: http://peak.telecommunity.com/DevCenter/PythonEggs
+.. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall
+
 Buildout
 --------
 

Modified: zope3book/trunk/source/getting-started.rst
===================================================================
--- zope3book/trunk/source/getting-started.rst	2009-02-23 06:36:46 UTC (rev 97127)
+++ zope3book/trunk/source/getting-started.rst	2009-02-23 06:37:20 UTC (rev 97128)
@@ -144,11 +144,11 @@
 ------------------------------
 
 To demonstrate the concepts, tools and techniques, we are going to
-develop a ticket collector application.  To begin the work, first
-create a directory for the project.  After creating the directory,
-create a configuration file, `buildout.cfg` as given below.  To
-bootstrap this application checkout bootstrap.py and run it using a
-clean Python.
+develop a ticket collector application.  The application can be used
+for issue/bug tracking.  To begin the work, first create a directory
+for the project.  After creating the directory, create a
+configuration file, `buildout.cfg` as given below.  To bootstrap this
+application checkout bootstrap.py and run it using a clean Python.
 
 ::
 
@@ -216,8 +216,8 @@
   eggs = ticketcollector
   interpreter = python
 
-Now run the `buildout` script inside `bin` directory.  This will download
-all necessary eggs and install it.
+Now run the `buildout` script inside `bin` directory.  It will
+download all eggs and install it inside `~/eggs` directory.
 
 ::
 
@@ -241,15 +241,13 @@
 Configuring application
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-We are going to continue the Ticket Collector application in this
-section.  In the last section when you run `./bin/buildout` command
-all necessary Zope 3 packages required for running our application is
-downloaded inside `~/eggs` directory.  Now to run the bare minimum
-Zope 3, we have to create Zope Configuration Markup Language (ZCML)
-file and extend the `buildout.cfg` with appropriate Buildout recipes.
-We are going to use `zc.zope3recipes:app`, `zc.zope3recipes:instance`
-and `zc.recipe.filestorage` recipes for setting up our application.
-Here is our modified buildout.cfg (inside the ticketcollector project
+We are going to continue the ticketcollector application in this
+section.  To run the bare minimum Zope 3, we have to create Zope
+Configuration Markup Language (ZCML) file and extend the
+`buildout.cfg` with appropriate Buildout recipes.  We are going to
+use `zc.zope3recipes:app`, `zc.zope3recipes:instance` and
+`zc.recipe.filestorage` recipes for setting up our application.  Here
+is our modified buildout.cfg (inside the ticketcollector project
 directory)::
 
   [buildout]
@@ -276,7 +274,7 @@
   [database]
   recipe = zc.recipe.filestorage
 
-Then we will create `application.zcml` inside `src/ticketcollector`
+Then, we will create `application.zcml` inside `src/ticketcollector`
 directory with the following text.  Consider it as boiler plate code
 now, we will explain this in detail later::
 
@@ -356,10 +354,8 @@
 ~~~~~~~~~~~~~~~~~~~
 
 Now you can run the application by executing `./bin/buildout` command
-followed by `./bin/instance` command.
+followed by `./bin/instance` command as given below::
 
-::
-
   $ ./bin/buildout
   $ ./bin/instance fg
 
@@ -428,4 +424,4 @@
 ----------
 
 Setting up a Zope 3 project sandbox is nothing but creating a proper
-Buildout configuration.
+Buildout configuration which use various Buildout recipes.



More information about the Checkins mailing list