Index: 04_common/index.html
===================================================================
--- 04_common/index.html (revision 32248)
+++ 04_common/index.html (revision 32249)
@@ -249,3 +249,30 @@
2. use the preferences window or a text editor to modify the config node rc/menu_patches
3. pcb-rnd will automatically update the in-memory menu file/patch list and will redo the menu merging once the config node is modified
+
+ 5.4.5.5. Menu file layout
+
+A menu file has the following main trees:
+
+
+ - li:mouse defines the mouse bindings
+
- li:toolbar_static specifies the static part of the toolbar (the "left side"; plugins can still add anything not listed here and those will end up in the dynamic section on the right end in random order)
+
- li:main_menu the menu tree for the main menu of the top window
+
- li:popups named popup menu trees; each child is the root of an independent popup menu that is invoked by name
+
- li:scripts named action scripts that can be symlinked from any of the above trees so long scripts don't scatter single-line menu item descriptions
+
- li:anchored each item is a ha:@anchor { li:submenu { ... } }, where @anchor refers to anchor(s) placed in the tree, by name; the content of the submenu is copied after each instance of the anchor in the main_menu or plugins tree
+
+
+ 5.4.5.6. Separators and anchors
+
+If a submenu item is a text node with a plain dash ("-") as value, it will
+appear as a horizontal separator line in the menu.
+
+If a submenu item is a text node with a text starting with the character @,
+it is a named anchor. An anchor is invisible placeholder. Plugins and scripts
+and user menu files may refer to these anchors from their anchored
+subtree to get submenus placed at specific (named) parts of the menu system
+without having to hardwire a path to those parts. The same anchor name may
+appear multiple times. Anchors are allowed only under the main_menu and popups
+tree.
+