Colors Menu Help

Name:	Colors Menu
Version:	1.4
Last update:	2019-10-17 13:28:52

This menu helps with the manual application of colors, styles and hyperlinks to Alpha files.

Colors Menu Items

The Color Menu ↣ Window Colors ↣ Colorize/Stylize Patterns menu item allows you to perform a global search-and-color for specified words or regular expressions in the current window. Additional submenus provide options for colorizing/stylizing/marking the currently selected region, or to add hyperlinks for Alpha/Tcl commands, urls, or e-mails.
Click here to display the Menus Preferences dialog and activate this package.
Most menu items can be assigned personalized keyboard shortcuts by selecting Color Menu ↣ Color Options ↣ Menu Shortcuts.
IMPORTANT: If you create colors/hypers in a window, you MUST set the saved state of the file in order for them to be 'remembered' when you save/close the window. Use the 'File' popup menu in the window toolbar to change this setting.
You must also be aware that attempting to color text "manually" using this menu interferes with syntax coloring. The only way to prevent this conflict is to deactivate syntax coloring for the window. Each document window has a "coloring" internal flag which can be manipulated with the [getWinInfo] and [setWinInfo] commands.
Select Color Menu ↣ Color Options ↣ Color Menu Prefs to set the default colors used for creating hypertext/url/mail links. See also the Alpha ↣ Preferences ↣ Color Definitions submenu to define your own custom colors.
This package also creates two contextual menu submenu modules that are available even if the package has not been turned on globally -- they are named Create Hyperlink and Color Style Text. Click here to display the Contextual Menu Preferences panel.
While any colors set using this menu will not be recognized if you subsequently open the document with any application other than Alpha, they might be retained if sent to a color printer.

Developers Note

In order to automatically mark/colorize/hyperize help windows, see the Doc Files Help page for more information. Note that files committed to the Alpha Subversion repository never include the resource fork of the original file, so if that is your document's final destination you probably shouldn't spend a whole lot of time creating marks/colors/hyperlinks manually using this menu.

Known problems

Please report any problem or bug you encounter to Alpha's Bug Tracker.

License and Disclaimer

Copyright (c) 1995-2019, Craig Barton Upright.
All rights reserved.
The colorsMenu package is free software and distributed under the terms of the new BSD license:
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Craig Barton Upright nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CRAIG BARTON UPRIGHT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.