Then "OPTIONAL - foo" gets the same status with "EXAMPLES" (or "INPUT", "OUTPUT", etc). This conveys a misconception since "OPTIONAL" does not mean anything with the method or function that this docstring is attached to.
I prefer Dima's suggestion or some variant of that. -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.