Added information about the help system.

doc/CHANGES.txt

@@ -68,7 +68,7 @@ Zope Changes
 
         - Added a new online help system. Help is now available for
           standard Zope objects. Zope developers can add help for their
-	  Python Products and Control Panel Products.
+          Python Products and Control Panel Products. See HELPSYS.txt
 
         - The message returned when an empty result set is returned
           from a ZSQL Method has been clarified.
@@ -100,6 +100,11 @@ Zope Changes
 
         - Fixed a potential buffer bug in PCGI reported by Larry Luther.
 
+        - Fixed a bug which caused File objects of type 'text/html' be
+          have the wrong Content-Length set.
+
+        - Improved FCGI support in ZServer.
+
     Zope 2.1.1
 
       Bugs Fixed 

doc/HELPSYS.txt

+Zope Help System
+
+  The Zope Help System provides context-sensitive on-line help for
+  Zope users. The system is flexible and can provide help for
+  Python and ZClass-based Zope Products.
+  
+  In the future the Help System will be expanded to provide additional
+  help including API documentation.
+  
+Using the Help System
+
+  Every standard Zope management screen should include a help button
+  which provides access to help for that screen.
+
+  Additionally all the installed help topics can be browsed and
+  searched.
+  
+Architecture
+
+  The Help System is based around Zope Products. When a product is
+  installed, its help objects are installed along with it. All help
+  content is associated with a product.
+  
+  Help content is provided by 'Help Topic' objects. These objects live
+  inside Product folders within a special container object called a
+  'Product Help' object. When you browse a Product folder in the
+  Control Panel you will see these 'Product Help' objects and their
+  'Help Topics'.
+
+  In general you get access to the Help System through the help system
+  object which has methods for drawing help buttons. This object lives
+  in the Zope application object and has an id of 'HelpSys'.
+  
+Writing Help for ZClasses
+
+  Suppose you've created an addable type of object with ZClasses.
+  You'd like the management screens of your objects to have help
+  buttons just like the standard Zope management screens.
+  
+  First create some Help Topics though the web which document your
+  management screens. Do this by going to your ZClass's Product and
+  creating new Help Topics inside the Product Help object.
+  
+  Next go to your ZClass and click on the 'Views' management tab. On
+  this screen you define your object's management views. Each view has
+  a name, a method, and optionally a help topic. If you select a help
+  topic for a view, a help button will be drawn on that management
+  view and it will be linked to the help topic you select.
+  
+Writing Help for Python Products
+
+  To support help your Python product needs to register help topics
+  during product registration, and it needs to indicate which help
+  topics should be associated with which management screens.
+  
+  Registering Help Topics
+
+    To register help topics use the 'registerHelp' method on the
+    ProductContext object. For example::
+
+      def initialize(context):
+        ...
+        context.registerHelp()
+
+    This method will create help topics for all files found in the
+    'help' subdirectory of the product. Supported file types include:
+    .html, .htm, .txt, .stx, .dtml, .gif, .jpg, .png. Appropriate
+    classes of help topics are used depending on the suffix of the
+    help files.
+
+    If you want more control over how your help topics are created you
+    can use the 'registerHelpTopic' method that takes an id and a help
+    topic object as arguments. For example::
+
+      from mySpecialHelpTopics import MyTopic
+
+      def initialize(context):
+        ...
+        context.registerHelpTopic('myTopic', MyTopic())
+  
+  Associating Help Topics with Management Screens      
+    
+    The chief way to bind a help topic to a management screen is to
+    include information about the help topic in the class's
+    'manage_options' structure. For example::
+    
+      manage_options=(
+        {'label':'Edit', 
+         'action':'editMethod',
+         'help':('productId','topicId')},
+        )
+
+    In this example, 'productId' refers to the name of the Zope
+    Product in which the class is defined, and 'topicId' refers to the
+    id of the Help Topic associated with this management view.
+    
+    When Zope draws the management view it will automatically include
+    a help button pointing to the right help topic if you provide this
+    information in the 'manage_options' structure. 
+    
+    Note: sometimes Zope gets confused and defaults to highlighting
+    the first management tab in place of the correct one. To fix this,
+    set the 'management_view' variable to the name of the correct
+    view. If the wrong view is hilighted, then the wrong help button
+    will be drawn.
+
+    To draw a help button on a management screen that is not a view,
+    use the 'HelpButton' method of the 'HelpSys' object like so::
+    
+      <dtml-var "HelpSys.HelpButton('productId', 'topicId')">
+      
+    This will draw a help button linked to the specified help topic.
+    If you prefer to draw your own help button you can use the helpURL
+    method instead like so::
+
+      <dtml-var "HelpSys.helpURL(
+        topic='productId',
+        product='topicId')">
+      
+    This will give you a URL to the help topic. You can choose to draw
+    whatever sort of button or link you wish.
+    
+    
+      
+      
+      
\ No newline at end of file