[imp] PATCH: User configurable attribution text with macros

[Chuck Hagenbuch]

Quoting Chris Hastie <lists at oak-wood.co.uk>:

> I'm also aware that the meaning of the macros really needs to be
> documented somewhere. Again, suggestions appreciated.

I believe that you can now specify help topics for the prefs system, so you
should include a 'help' attribute in the preference and a help entry. Ah,
yes, example from imp/config/prefs.php.dist:

// perform maintenance operations?
$_prefs['do_maintenance'] = array(
    'value' => 1,
    'locked' => false,
    'shared' => true,
    'type' => 'checkbox',
    'desc' => _("Perform maintenance operations on login?"),
    'help' => 'prefs-do_maintenance');

... and then from imp/locale/en_US/help.xml:

<entry id="prefs-do_maintenance">
    <title>Preferences: Maintenance: Do Maintenance</title>
    <para>
    If you would like to perform maintenance operations on login, check this
box.
    </para>
</entry>


You can obviously get a bit more detailed.

-chuck

--
Charles Hagenbuch, <chuck at horde.org>
must ... find ... acorns ... *thud*