webchick asked me to create a new documentation issue now that #53870 has been committed. the patch from comment #22 in the thread (applied as revision includes a big re-write of the menu module's help text in various places, care of much back and forth between zen and myself. webchick tells me there's a (to my perspective somewhat strange) procedure where the handbook text on drupal.org is used to automatically generate the help text in the core modules. so, the menu handbook page is hereby out of date/sync with the new, better text in the code. someone w/ doc privs needs to keep them in sync for reasons more clear to webchick than myself. ;)

thanks!
-derek

p.s. sorry if "documentation in cvs" is the wrong component for this, but that seemed like the closest match...

Comments

dww’s picture

sorry, that "(applied as revision" was supposed to be "(applied as revision 1.73 in modules/menu.module)". i'm trying to do too many things at once right now...

sepeck’s picture

People said updating the help text found in the modules was challanging so this alternative method was established that allowed for many more people to provide edits and updates and these edits/updates to be applied to the modules themselves. This allows for the handbook to remain in sync with the modules and the modules to link accuratly with the handbook.

Is it possible for you to provide the text of your changes here?

dww’s picture

i guess so, sure. the links in here will be wrong (i'm just cut + pasting the html from my test site), but you get the idea:

Menus
are a collection of links (menu items) used to navigate a website. The
menu module provides an interface to control and customize the powerful
menu system that comes with Drupal. Menus are primarily displayed as a
hierarchical list of links using Drupal's highly flexible blocks
feature. Each menu automatically creates a block of the same name. By
default, new menu items are placed inside a built-in menu labelled Navigation, but administrators can also create custom menus.

Drupal themes generally provide out-of-the-box support for two menus commonly labelled primary links and secondary links.
These are sets of links which are usually displayed in the header or
footer of each page (depending on the currently active theme). Any menu
can be designated as the primary or secondary links menu via the menu settings page.

Menu administration tabs:

  • On the administer menu page, administrators can "edit" to
    change the title, description, parent or weight of a menu item. Under
    the "operations" column, click on "enable/disable" to toggle a menu
    item on or off. Only menu items which are enabled are displayed in the
    corresponding menu block. Note that the default menu items generated by
    the menu module cannot be deleted, only disabled.
  • Use the
    "add menu" tab to submit a title for a new custom menu. Once submitted,
    the menu will appear in a list toward the bottom of the administer menu
    page underneath the main navigation menu. Under the menu name there
    will be links to edit or delete the menu, and a link to add new items
    to the menu.
  • Use the "add menu item" tab to create new links
    in either the navigation or a custom menu (such as a primary/secondary
    links menu). Select the parent item to place the new link within an
    existing menu structure. For top level menu items, choose the name of
    the menu in which the link is to be added.

You can

For more information please read the configuration and customization handbook Menu page

jstarbow’s picture

Status: Active » Fixed

made changes requested

Anonymous’s picture

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for two weeks with no activity.