// Copyright (c) 1996-1997 Jeremy Wyld. All rights reserved.

/* For best viewing pleasure set the font to: Courier 10pt with 3 space tabs





	Project Overview

	

		This auto part adds items to the routing menu.  It overrides a method in root that may cease

		to exist someday, thus possibly killing this hack.  Don't blame me!  Playing with undocumented

		"features" isn't for the light-hearted.  Extra items can be added, or those I provide may be

		yanked.  Read on to figure how to do it yourself.

		

		For question or comments, send mail to: wyld@newton.apple.com





	 	Files



				Graphics.f				Loads graphics used in the routing frames.



				MiscFunctions.f		Contains the definition for general functions used in the

											rest of the files.

										

				RouteFrames.f			Defines the route frames to be added to the routing menu.

				

				GetRouteScripts.f		Definition for the "new" :GetRouteScripts().

				

				InstallScript.f		InstallScript() definition for this auto part.

				

				RemoveScript.f			RemoveScript() definition for this auto part.

				

				

		Adding More

		

			In order to add more items to the routing menu, I've supplied a few compile time functions.

			These include AddRouteFrame(), AddRouteItem(), AddOpenItem(), and AddSeparator().  Place

			the calls to these functions in RouteFrames.f (this keeps them all together in one place).

			

			

			AddRouteFrame()

			

				This function takes one argument, the actual frame to be added to the routing menu.  For

				documentation on routing frames, see "NPG - Comm" page 2-49 and page 2-50.

						

						

			AddRouteItem()

			

				This function takes three arguments: title, icon, and routescript, respectively.  This

				function then makes a routing frame with these arguments and calls AddRouteFrame() with

				this new frame.  The routing frame it creates looks as such:

				

						{

							title:			title,			// Name to show up in the menu.

							icon:				icon,				// As that returned by GetPICTAsBits()

							

							routeScript:	routescript		// Function to be called.

						}

				

				

			AddOpenItem()

			

				This function takes three arguments, the title, the icon and the symbol of the item to

				open in root (e.g. 'iobox).  It builds a frame similar to the one above but with a

				method that opens the root item.

				

				

			AddSeparator()

			

				This function takes no arguments and adds a pick separator (dotted line) to the menu.

*/