[Checkins] SVN: bluebream/website/docs/v1.0/howto/ one more HOWTO

[Baiju M]

Log message for revision 108473:
  one more HOWTO
  

Changed:
  U   bluebream/website/docs/v1.0/howto/index.rst
  A   bluebream/website/docs/v1.0/howto/newdependency.rst

-=-
Modified: bluebream/website/docs/v1.0/howto/index.rst
===================================================================
--- bluebream/website/docs/v1.0/howto/index.rst	2010-01-25 12:35:07 UTC (rev 108472)
+++ bluebream/website/docs/v1.0/howto/index.rst	2010-01-25 13:00:23 UTC (rev 108473)
@@ -15,3 +15,4 @@
 
    defaultview
    browserpage
+   newdependency

Added: bluebream/website/docs/v1.0/howto/newdependency.rst
===================================================================
--- bluebream/website/docs/v1.0/howto/newdependency.rst	                        (rev 0)
+++ bluebream/website/docs/v1.0/howto/newdependency.rst	2010-01-25 13:00:23 UTC (rev 108473)
@@ -0,0 +1,39 @@
+How to add a new dependency ?
+=============================
+
+.. warning::
+
+   This documentation is under construction.  See the `Documentation
+   Status <http://wiki.zope.org/bluebream/DocumentationStatus>`_ page
+   in wiki for the current status and timeline.
+
+.. based on: http://wiki.zope.org/zope3/HowDoIAddAnEggDependency
+
+You are working in your instance or developing your package and then
+you discover that there is a package you may find useful, let's say
+'ldappas'.  Edit ``setup.py`` and add in ``install_requires`` the
+name of the package::
+
+    setup(name='ticketcollector'
+          ...
+          install_requires = ['setuptools',
+                              ...
+                              'ldappas',
+                             ],
+          ...
+
+Now it is time to rebuild your application::
+
+    $ ./bin/buildout
+
+Finally, remember to register the new package at ``site.zcml``::
+
+    <configure xmlns="http://namespaces.zope.org/zope"
+      ...
+      <include package="ldappas" />
+      ...
+    </configure>
+
+And restart application::
+
+  $ ./bin/paster serve debug.ini