- #### xxx NOTE : pending move towards a more elaborate mode for 'toggled'
- # . toggled: if togglable, what's the initial status; possible values are
- # .. True : start up open/hidden
- # .. False : start up closed/shown
- # .. 'last' : start up as it was the last time that browser showed it (based on 'domid')
- # .. None : if not passed to __init__ at all, then the DefaultTaggled() method is called
- # .. : anything else, defaults to True
- #### xxx NOTE : pending move towards a more elaborate mode for 'toggled'
- #
+ # possible values are
+ # .. True : start up open/hidden
+ # .. False : start up closed/shown
+ # .. 'persistent' : start up as it was the last time that browser showed it (based on 'domid')
+ # NOTE that it is required for you to set a domid if you want to use persistent mode
+ # since domid is the key for storing that data in the browser storage space
+ # .. None : if not passed to __init__ at all, then the default_toggled() method is called
+ # .. : anything else, defaults to True
+ # . outline_complete: whether the overall plugin (body + toggle buttons/title) needs to receive
+ # a border and extra space
+ # . outline_body : same but for the plugin body only
+ # for these 2 outline_ flags, possible values mimick the above behaviour, i.e.:
+ # .. True: : outline is on
+ # .. False: : outline is off
+ # .. None: : calls default_outline_complete() on the plugin object
+ #