huey: Internal maintenance specification

This method adds one selection to the first-level help menu, along with its subcommand cascade.

# - - -   M e n u B a r . _ _ c a s c a d e N a m e P i c k e r

    def __cascadeNamePicker ( self, menu ):
        """Add the help cascade for picking colors by name

          [ menu is a Menu widget ->
              menu  :=  menu with choices added for help topics
                        about picking colors by name ]
        """

A “cascade” is a choice on a drop-down Menu that leads to another Menu.

        #-- 1 --
        # [ menu    :=  menu with a new cascade added
        #   select  :=  that cascade ]
        select  =  Menu ( menu )
        menu.add_cascade ( menu=select,
            label="Selecting a standard color" )

Both choices here are terminal choices. For a discussion of cascade and terminal choices, see Section 12.2, “MenuBar.__createHelp(): Create the Help menu”. For the methods that create the pop-up menus, see Section 12.4, “MenuBar.__helpTyping()” and Section 12.5, “MenuBar.__helpPicking()”.

        #-- 2 --
        # [ select  :=  select with a pop-up added about typing
        #       standard color names ]
        select.add_command ( command=self.__helpTyping,
            label="Typing in a standard color name" )

        #-- 3 --
        # [ select  :=  select with a pop-up added about picking
        #       standard color names ]
        select.add_command ( command=self.__helpPicking,
            label="Picking a standard color name" )