                             FINDFONT

FindFont.SHM (Version: 2006-Dec-14)

The original WP macro FindFont.WPM was written by Edward Mendelson, www.wpdos.org. It was adapted by Niek Campagne as a Shell macro to give it the capability to recognize point size in a font code.

FindFont.SHM searches for a font name and/or a point size specified by the user, optionally replaces with another specified font.

It selects font codes in a document by font name, (scalable) point size, or both; and it can replace them with font codes with a chosen font name, point size, or both.

The macro can search in documents, styles, or both. The search path may be changed for one macro run only, or permanently.

REQUIREMENTS

The required programs are WordPerfect Shell version 3.x (downloadable from www.wpdos.org), the 6/30/1990 version of WordPerfect 5.1 or later, and Editor version 3.1 (www.wpdos.org).

Further requirements, apart from FindFont.SHM itself, are LaunchFF.WPM, to launch FindFont runs, and keyboard FFSearch.WPK containing key macro Ctrl-F12 with the commands required for a Full Search ({Home}{Search}) for font codes in a document. These files are found, together with FindFont.SHM and these instructions, FFGuide.TXT, in the zipped download FindFont.zip.

The macro has been tested under DOS 6.22 and Windows XP SP2, and will probably work correctly under other operating systems as well.

SETUP

After installation of the three programs, configure both WordPerfect and Editor in Shell's menu. Copy FindFont.SHM to Shell's macro directory (defined in Shell, Shift-F1, 4), and both FFSearch.WPK and LaunchFF.WPM to WordPerfect's macro directory (defined in WordPerfect, Shift-F1, 6, 2). For convenient operation, LaunchFF.WPM may be copied, or chained, to a WordPerfect Alt or key macro (but do NOT rename it because FindFont.SHM must be able to find and start LaunchFF.WPM - under that name - to restart itself after changing the default search path).

OPERATION

Start Shell with start option '/w-50' to allocate sufficient memory for the relatively big macro FindFont. Start WordPerfect from Shell. With the document to be edited on the screen, run LaunchFF to start FindFont.

The first prompt gives three options: 1) 'Find font (choose action when found)', 2) 'Replace (no confirm)', or 3) 'Search path'. Further prompts will guide you through the the macro run. The concluding prompt displays the numbers of font codes found, replaced, and deleted.

Font selection

Font names are selected from the Font list (Ctrl-F8, 4). Use cursor keys to move through the list, and confirm your choice with Enter; or press Cancel, if you do not want to define a particular font name. If the font chosen is scalable, you'll be asked next to enter a point size; with Cancel, no point size will be defined.

If no target font name is selected, all font codes with the selected point size will be searched for; if no font name is selected, all font codes with the specified point size will be searched for; and if neither font name, nor point size is selected, the macro will search for all font codes. If no replacing font name has been chosen, the target font name is retained, likewise with point size; if neither a replacing font name, nor a replacing point size is chosen, the target font code will be deleted.

Search paths

The macro can search for font codes in either of three search paths: 'Document' (including notes, headers and footers), 'Styles' (in the list found under Alt-F8), or 'Both' (both document and styles). The default search path of the macro as downloaded is 'Document'.

If option 3 of the first prompt is chosen, another search path than the default one can be selected, either to be used for the current macro run only, or to be made permanent as the new default search path; you'll be prompted to choose between both alternatives.
