guy@auspex.auspex.com (Guy Harris) (09/30/90)
There are a number of typos and other errors in "menulist.doc" (for
example, some methods are claimed to have names beginning with "menu_"
rather than "menulist_"):
*** atk/basics/common/menulist.doc.dist Wed Nov 22 08:51:05 1989
--- atk/basics/common/menulist.doc Sat Sep 22 23:32:01 1990
***************
*** 198,204 ****
Menu list entries have the form of:
! \example{card name~prioritynumber,item name,~prioritynumber: procedure}
Only the item name is required. Priority numbers are always two digits. The
--- 198,204 ----
Menu list entries have the form of:
! \example{card name~prioritynumber,item name~prioritynumber: procedure}
Only the item name is required. Priority numbers are always two digits. The
***************
*** 871,878 ****
\bold{Usage.} To look at all the menu items in a menu list, you should call
! menu_RewindML to set the current item to the first item, and then call
! menu_NextME until it returns \smaller{FALSE}. Note that the method only
iterates through the menu list; it will not search associated lists, e.g. a
stack of cards created by chained menu lists.
--- 871,878 ----
\bold{Usage.} To look at all the menu items in a menu list, you should call
! menulist_RewindML to set the current item to the first item, and then call
! menulist_NextME until it returns \smaller{FALSE}. Note that the method only
iterates through the menu list; it will not search associated lists, e.g. a
stack of cards created by chained menu lists.
***************
*** 894,900 ****
\bold{Usage.} You can use this macro to do the stepwise loop after the before
list has been rewound. Warning: The design of the code for menulists is
! non-reenterant; if one procedure is iterating over menulists, it must not call
another procedure that also iterates over the same menulist. However, a
problem occurs when the iteration variable is in the menulist rather than in
the caller.
--- 894,900 ----
\bold{Usage.} You can use this macro to do the stepwise loop after the before
list has been rewound. Warning: The design of the code for menulists is
! non-reentrant; if one procedure is iterating over menulists, it must not call
another procedure that also iterates over the same menulist. However, a
problem occurs when the iteration variable is in the menulist rather than in
the caller.
***************
*** 933,943 ****
\indexi{Menulist++Rewinding}
! \example{#define menu_RewindML(alist)}
! \leftindent{\bold{Macro description.} \italic{menu_RewindML} is a macro that
! "rewinds," or iterates over the menu list chain.
\bold{Usage.} In a stepwise loop situation, you would use this macro to set
--- 933,943 ----
\indexi{Menulist++Rewinding}
! \example{#define menulist_RewindML(alist)}
! \leftindent{\bold{Macro description.} \italic{menulist_RewindML} is a macro
! that "rewinds," or iterates over the menu list chain.
\bold{Usage.} In a stepwise loop situation, you would use this macro to set
***************
*** 949,959 ****
\indexi{ \italic{menulist_RewindBeforeMC}}
! \indexi{Menulist++Rewinding before}\example{#define menu_RewindBeforeMC(alist)
}
! \leftindent{\bold{Macro description.} The \italic{menu_RewindBeforeMC} macro
! does a rewind on the before menu list chain. It is used by
\italic{menulist_NextBeforeMC}.
--- 949,960 ----
\indexi{ \italic{menulist_RewindBeforeMC}}
! \indexi{Menulist++Rewinding before}\example{#define
! menulist_RewindBeforeMC(alist)
}
! \leftindent{\bold{Macro description.} The \italic{menulist_RewindBeforeMC}
! macro does a rewind on the before menu list chain. It is used by
\italic{menulist_NextBeforeMC}.
***************
*** 967,978 ****
\indexi{ \italic{menulist_RewindAfterMC}}
! \indexi{Menulist++Rewinding after}\example{#define menu_RewindAfterMC(alist)}
! \leftindent{\bold{Macro description.} The \italic{menu_RewindAfterMC} macro
! is similar to \italic{RewindBeforeMC }except the rewinding occurs for the
! after chain. It is used by \italic{menulist_NextAfterMC}.
\bold{Usage.} In a stepwise loop situation, you would use this macro to set
--- 968,980 ----
\indexi{ \italic{menulist_RewindAfterMC}}
! \indexi{Menulist++Rewinding after}\example{#define
! menulist_RewindAfterMC(alist)}
! \leftindent{\bold{Macro description.} The \italic{menulist_RewindAfterMC}
! macro is similar to \italic{RewindBeforeMC }except the rewinding occurs for
! the after chain. It is used by \italic{menulist_NextAfterMC}.
\bold{Usage.} In a stepwise loop situation, you would use this macro to set
***************
*** 989,995 ****
\indexi{Menulist++Versio}\example{#define menulist_GetMLVersion(alist)}
\leftindent{
! \bold{Macro description.} Gets the version number for a menu list.]}
--- 991,997 ----
\indexi{Menulist++Versio}\example{#define menulist_GetMLVersion(alist)}
\leftindent{
! \bold{Macro description.} Gets the version number for a menu list.}