[drupal-devel] needed documentation for block module for 4.6

[Neil Drumm]

On Tue, Jan 25, 2005 at 08:40:49AM +0100, Dries Buytaert wrote:
> Steven Wittens wrote:
> >
> >>Agreed,
> >>I ran into this exact thing in the last 48 hours or so working on a 
> >>patch for the block module and looking at block hooks in general.
> >>A quick search shows that only block, forum and statistics core 
> >>modules use 'configure' - so perhaps the rarity of its use kept it 
> >>from being documented.
> >>But knowing that you can add configuration options to a block would 
> >>certainly be helpful for module contributors.
> >
> >
> >IMO the update docs should instruct module authors to move block 
> >settings into the "configure" page. It's best for consistency and 
> >usability. Anyone have time to write the docs? ;)
> 
> Neil once posted an explanation of the modified _block() hook.  I 
> believe it was part of his patch.  Neil?

The documentation in hook_block() on drupaldocs.org should be fully
updated. Implementing the 'configure' op isn't strictly part of updating
a module. However, I do think it should be documented now. Bug me in IRC
/next/ week and I will do it myself if you catch me at a good time. I'm
a bit short on time for this week.

-Neil

http://civicspacelabs.org/
http://delocalizedham.com/