[Zope3-checkins] SVN: Zope3/trunk/src/zope/app/workflow/interfaces/wfmc.py Cleanup the interfaces documentation a bit.

[Stephan Richter]

Log message for revision 26293:

Cleanup the interfaces documentation a bit.




-=-
Modified: Zope3/trunk/src/zope/app/workflow/interfaces/wfmc.py
===================================================================
--- Zope3/trunk/src/zope/app/workflow/interfaces/wfmc.py	2004-07-09 15:44:42 UTC (rev 26292)
+++ Zope3/trunk/src/zope/app/workflow/interfaces/wfmc.py	2004-07-09 15:44:44 UTC (rev 26293)
@@ -38,7 +38,8 @@
 
     redefinableHeader = Attribute("ref to refinable header")
 
-    formalParameters = Attribute("parameters that are interchanged e.g. subflow")
+    formalParameters = Attribute("parameters that are interchanged e.g. "
+                                 "subflow")
 
     relevantData = Attribute("wfr data definition")
 
@@ -74,9 +75,11 @@
 
     durationUnit = Attribute("Duration Unit")
 
-    workingTime = Attribute("amount of time, performer of activity needs to perform task")
+    workingTime = Attribute("amount of time, performer of activity needs "
+                            "to perform task")
 
-    waitingTime = Attribute("amount of time, needed to prepare performance of task")
+    waitingTime = Attribute("amount of time, needed to prepare performance "
+                            "of task")
 
     duration = Attribute("duration in units")
 
@@ -194,7 +197,8 @@
 
     performer = Attribute("link to workflow participant (may be expression)")
 
-    implementation = Attribute("if not Route-Activity: mandatory (no/tool+/subflow/loop)")
+    implementation = Attribute("if not Route-Activity: mandatory "
+                               "(no/tool+/subflow/loop)")
 
     instantiation = Attribute("capability: once/multiple times")
 
@@ -202,9 +206,11 @@
 
     cost = Attribute("average cost")
 
-    workingTime = Attribute("amount of time, performer of activity needs to perform task")
+    workingTime = Attribute("amount of time, performer of activity needs "
+                            "to perform task")
 
-    waitingTime = Attribute("amount of time, needed to prepare performance of task")
+    waitingTime = Attribute("amount of time, needed to prepare performance "
+                            "of task")
 
     duration = Attribute("duration of activity")
 
@@ -239,24 +245,25 @@
 
     execution = Attribute("Type of Execution: Asynchr/synchr.")
 
-    actualParameterList = Attribute("""Sequence of ActualParameters with those the
-                                     new Instance is initialized and whose are
-                                     returned.""")
+    actualParameterList = Attribute("Sequence of ActualParameters with those "
+                                    "the new Instance is initialized and "
+                                    "whose are returned.")
 
 
 class IWfMCTool(IWfMCImplementation):
     """WfMC Implementation Subflow.
     """
 
-    name = Attribute("Name of Application/Procedure to invoke (Application Declaration).")
+    name = Attribute("Name of Application/Procedure to invoke "
+                     "(Application Declaration).")
 
     type = Attribute("Type of Tool: APPLICATION/PROCEDURE.")
 
     description = Attribute("Description of Tool.")
 
-    actualParameterList = Attribute("""Sequence of ActualParameters with those the
-                                     new Instance is initialized and whose are
-                                     returned.""")
+    actualParameterList = Attribute("Sequence of ActualParameters with those "
+                                    "the new Instance is initialized and "
+                                    "whose are returned.")
 
 
 
@@ -291,12 +298,10 @@
 class IWfMCProcessInstanceData(Interface):
     """WfMC ProcessInstance Data.
 
-    This is a base interfaces that gets extended dynamically when
-    creating a ProcessInstance from the relevantData Spec.
+    This is a base interfaces that gets extended dynamically when creating a
+    ProcessInstance from the relevantData Spec.
     """
 
-    # XXX Not sure how to implement this.
-    # probably using schemagen
 
 class IWfMCProcessInstance(IProcessInstance):
     """WfMC Workflow process instance.
@@ -312,8 +317,9 @@
 
     data = Attribute("WorkflowRelevant Data (instance, not definition.)")
 
-    # XXX Do we need an actual Participantlist for implementation ??
+    # We might need an actual Participantlist for the implementation.
 
+
 class IWfMCActivityInstanceContainer(IContainer):
     """WfMC ActivityInstance Container.
     """
@@ -330,11 +336,11 @@
 
     status = Attribute("Status of ActivityInstance.")
 
-    priority = Attribute("Priority of ActivityInstance (initialized from Activity).")
+    priority = Attribute("Priority of ActivityInstance (initialized from "
+                         "Activity).")
 
     workitems = Attribute("ref to WorkitemContainer.")
 
-    # XXX
     # participants = Attribute("Sequence of assigned Participants.")
 
 class IWfMCWorkitemContainer(IContainer):
@@ -349,5 +355,6 @@
 
     priority = Attribute("Priority of Workitem.")
 
-    participant = Attribute("Participant that is assigned to do this item of Work.")
+    participant = Attribute("Participant that is assigned to do this item "
+                            "of Work.")