ofproto: Fix documentation for calls to ->rule_destruct().
authorBen Pfaff <blp@nicira.com>
Thu, 8 Sep 2011 23:22:38 +0000 (16:22 -0700)
committerBen Pfaff <blp@nicira.com>
Fri, 9 Sep 2011 16:17:04 +0000 (09:17 -0700)
This documented what I intended to implement and what I thought I had
implemented, but not what the code actually did.  It is a little easier to
fix the documentation to match the implementation than vice versa, so this
commit does so.

Reported-by: Hao Zheng <hzheng@nicira.com>
ofproto/ofproto-provider.h

index 037dbae..c9d74ee 100644 (file)
@@ -721,8 +721,8 @@ struct ofproto_class {
      *       * Return an OpenFlow error code (as returned by ofp_mkerr()).  (Do
      *         not call ofoperation_complete() in this case.)
      *
-     *     In the former case, ->rule_destruct() will be called; in the latter
-     *     case, it will not.  ->rule_dealloc() will be called in either case.
+     *     Either way, ->rule_destruct() will not be called for 'rule', but
+     *     ->rule_dealloc() will be.
      *
      *   - If the operation is only partially complete, then it must return 0.
      *     Later, when the operation is complete, the ->run() or ->destruct()