Description of toolbar macro is missing

[markkerrigan]

List of macros does not include toolbar macro.

The current tiddlers ToolbarButtons and ToolbarCommands do not provide a great description of how to customize the toolbar.

[YakovL]

In fact, there's many more not mentioned there:

• those that are usually used only in templates: annotations, backstage, edit, (view is present), message, tagChooser, toolbar;
• those that are rarely used (since are present in backstage/sidebar): importTiddlers, options, plugins, upgrade; allTags;
• option, refreshDisplay;
• shouldn't be mentioned: deprecated: br, sync; to deprecate: gradient.

I'd probably start with option.

As for the toolbar, indeed the docs are not complete: although there's [[ToolbarButtons]] that's shown in [[Reference]], it doesn't explain how to edit [[ToolbarCommands]]. I think, the best option to deliver better docs here is to edit [[ToolbarButtons]]: switch the list to a table that also shows the names of the commands, and may be references/aggregates tiddlers tagged [[commands]]. Also, special symbols that define the toolbar(>, <, *, !; -command, +command) should be explained.

Moreover, the annotation of ToolbarCommands in TW itself should have a link to such a description.

[YakovL]

Note: all the macros (except the backstage one) are described at dev docs, so the descriptions can be taken from there, or at least based on them