        Using-resourceFileEditor

        blackhome-0.3.4
        Will Eighteen 2006


        1) Function Overview

        1			Quit

        2			Find
        2.1				Colour
        2.2				Label

        3			Opts
        3.1				Colour
        3.1.1					Depth
        3.1.2					Digits
        3.1.3					Deviation
        3.2				Resource
        3.2.1					Xdefaults
        3.2.2                   Gtk defaults
        3.2.3					App defaults
        3.2.4					Menus
        3.2.5					Styles
        3.3				Search
        3.3.1					Append search
        3.3.2					Preserve targets
        3.4				Undo
        3.5				Replace
        3.5.1					Autoexec
        3.5.2					Colour
        3.5.2.1						Replacement type
        3.5.2.2						Colour type
        3.5.2.3						Force shade
        3.5.2.4						Local/Global replace
        3.5.2.5						Derivation mode
        3.6				Save

        4			View
        4.1				Available
        4.1.1					Applications
        4.1.2					Themes
        4.1.3					Aliases
        4.2				Selected
        4.2.1					Applications
        4.2.2					Themes
        4.2.3					Targets

        5			Seln
        5.1				Applications
        5.2				Themes

        6			Exec
        6.1				Delete
        6.1.1					Application
        6.1.2					Theme
        6.1.3					Target
        6.1.4					Undo
        6.2				Edit
        6.2.1					Applications
        6.2.2					Resources
        6.2.3					Configuration
        6.3				Replace
        6.4				Undo
        6.4.1					Undo last edit
        6.4.2					Undo previous edit(s)

        
        2) Function descriptions
        

        1       Quit
        
        Exit program.
        

        2       Find
        
        Find  resources  in files which have been selected by 'Seln'.  Re-
        sources may currently be one of two types, 'Colour' and 'Label'.
        
        2.1     Find/colour
        
        Find 'colour' allows you to identify colour resources by  entering
        a  colour  specification  to  search for; this can be one of three
        types.
        
        a) a valid X resource specification numerically or by name:
        
        	#ff00ff ( magenta)
        	rgb:000/fff/fff ( cyan )
        	rgbi:0.9/0.9/0.9 ( very light grey )
        	pink ( assuming 'pink' is in your rgb.txt )
        
        b) you may enter a colour specified  as  three  positive  integers
        separated by spaces:
        
        	238 130 238 ( violet )
        	65280 42240 0 ( orange )
        
        c)  an  alias  selected  from  the  colour  alias list (View/Aval-
        able/Aliases ). A colour alias _does not_ specify a colour; it de-
        termines  a  _range_  of red, green and blue values for which that
        alias is a suitable description.  These names are arbitrary speci-
        fiers  for  their  ranges and are used to find all matching colour
        resources whose individual r,g and b components values fall within
        the range of the specification for the alias.  This allows search-
        ing for resources fitting a fairly broad category of hue  (drop  a
        sample of a near colour into 'find colour', find its alias, cancel
        out, then do 'find colour' again with the alias  instead  to  find
        near relatives of the colour sought for).
        
        Resource  File  Editor doesn't have anything as sophisticated as a
        'grab colour' option; I recommend you use something like Xcolorsel
        for  this;  grab  a  colour, get its specification, mouse copy and
        paste into 'find colour'...  ( shift, left click and drag to copy,
        middle  button  or  left  and right together to paste into the re-
        source file editor text box).
        
        RFE does not currently accept colour names consisting of more than
        2  words  - so things like 'light sea green' are out; use a single
        word instead, 'lightseagreen', or 'LightSeaGreen'; the  result  of
        using  a  named  description  longer than 2  words is the third or
        final word is detected as a  colour,  if  valid,  but  the  entire
        string  is  substituted; so 'light sea green' exchanged for 'pink'
        produces 'light sea pink'.  X does not like this.
        
        RFE accepts numeric suffixes to names, as in 'grey95'; it does not
        accept  more  than  two  digits for the numeral suffix, so if your
        rgb.txt is personalised and  has, say,  orange1..., orange 252,...
        etc.   you'll  have  to change it.  Or make a copy, stick it some-
        where else, edit it and change the path to rgb.txt in
        .blackhome/app-defaults/ResourceFileEditor.

        2.2     Find/label
        
        Find 'label' allows search  for  a  matching  string;  unlike  2.1
        'colour' there is no error checking on the input with this option;
        although it will search for matching colours, it does not do alias
        searching.   It  is intended for  use in  finding colour resources
        specified by  widget or  application name.  Typing accuracy is es-
        sential  here.   Searching for 'Netscape' will find all colour re-
        sources for this application.  other uses are 'foreground',  'bor-
        derColor', etc.
        
        The  search  options so far implemented only allow for replacement
        of colour resources; it is  hoped  that,  time  permitting,  other
        types of resource may eventually be dealt with, for example widget
        geometries, fonts and the like.
        

        3       Opts
        
        Things you can change to modify resourceFileEditor's behaviour.
        
        3.1     Opts/colour
        
        Click this to get a menu of colour options.
        
        3.1.1   Opts/Colour/Depth
        
        Displays the current colour depth; this is  used  to  specify  the
        number  of  bits per pixel used in writing colour resources to re-
        source files.  The default is 8 bpp,  so  'white;  in  rgb  format
        would be written as 'rgb:ff/ff/ff',
        
        Clicking  'Cancel' quits from the menu without altering the colour
        depth.
        
        Clicking 'Ok' pops up a submenu  allowing  you  to  change  colour
        depths:   select  from  4, 8, 12 or 16 bpp.  If  you  selected  12
        bpp, for example, then 'white'  would  be  specified  in  resource
        files (again in rgb format) as 'rgb:fff/fff/fff'.
        
        3.1.2   Opts/Colour/Digits
        
        Controls  the number of digits used for floating point numbers (in
        this case, rgbi format ). The default is 4, so that 'black'  would
        be written in rgbi format as a  replacement resource in  the  form
        'rgbi:0.0000/0.0000/0.0000'.
        
        Again, clicking 'Cancel' preserves the current  number  of  digits
        and  pressing  'Ok'  gives a submenu  allowing you  to change to a
        different number of digits ( up to 7 ). Selecting '2'  would  give
        black as 'rgb:0.00/0.00/0.00'.
        
        3.1.3   Opts/Colour/Deviation
        
        Controls how to match red, green and blue components in the speci-
        fied colour resource you wish to search for.   If  these  are  all
        '0',  no deviation from the specified  colour is allowed, and only
        an exact match will be returned.
        
        If you wish to search for colours 'nearly' matching the  specified
        resource,  for  instance  all  'white'  resources   plus  anything
        within 10% of  being 'white', you would set  the lower colour  de-
        viations to be 0.1 and the upper values to 0, so anything from ap-
        proximately grey90 to white will be found.  This can be useful for
        searching for and replacing a range of related resources.
        
        Note  that  you  cannot  search for 'nearly black' by specifying a
        search for 'black' with non-zero deviations:  since the components
        of  black are all zero, any percentage is zero, so only black will
        be returned.  To find 'nearly black' say within the range 0  -  20
        for  the  rgb  components  ( in 8- bit terms ), i.e. from 0,0,0 to
        20,20,20, use 'find/colour' '10 10 10' with the  colour  deviation
        values  set to 0.04 (4%).  The actual component value deviation is
        automatically calculated depending on colour depth, so that appro-
        priate  colours  are indentified regardless of their specification
        as 4, 8, 12 or 16-bit.
        
        Deviations from the specified component value  can  be  separately
        specified  as upper and lower bounds; you can search by red compo-
        nents with range plus 5% and minus 10%, for  example,  by  setting
        the red deviation minimum to 0.1 and the maximum to 0.05.
        
        Default deviations are +/- 0.05 (5%) for all components.
        
        A global colour deviation may also be specified; if this is set to
        other than zero ( default ), then all  individual  deviations  are
        set  to  this amount.  This is a quick way of achieving, say, 'red
        +/- 15%'.
        
        Note that changing the values of individual deviations  will  have
        no effect unless the global value is set to zero.
        
        3.2     Opts/Resource
        
        Resource  options allow you to specify which types of file are use
        in the search process.  This allows you to specify whether  appli-
        cation default resources are modified, global defaults, and black-
        box menus and styles.  Useful if, say, you only want modifications
        in  menus  but  not in anything else, or perhaps in everything but
        styles.
        
        3.2.1   Opts/Resource/Xdefaults
        
        This option toggles the search in .Xdefaults  and  .Xresources  on
        and  off.  These two sets of files are grouped together since they
        perform similar functions; there are  both  .Xdefaults  and  .Xre-
        sources files since I have found instances where some applications
        accept resources defined in one but not the other.
        
        3.2.2   Opts/Resource/Gtk defaults
        
        This  option  toggles the search in  .gtkrc-<themeName>  (to which
        ~/.gtkrc.mine is a symbolic link). This allows  ResourceFileEditor
        to modify  Gnome  applications  which use colour specifications of
        the form '{ r, g, b }' ( which are not catered for by the resident
        ColourSpecConvert utility). ResourceFileEditor expects the r, g, b
        constituents to be floating point in the range 0-1 and manipulates
        them as corresponding rgbi equivalents.
        
        Note that colouring GTK  resources works best when  'Opts/Replace/
        Colour/Replacement type'  is set to  'exact specification'. If the
        'shade replacement colour' option is used,  then GTK style colours
        can  become  unreasonably  dark  unless 'Opts/Replace/Colour/Force
        shade' is set to some number typically in the range 0.25 - 0.5.
        
        3.2.3   Opts/Resource/App defaults)
        
        Toggles the search in applications' resource files on and off.  By
        default, resource  files  for  applications running under the cur-
        rent theme are searched if no other theme has been selected (  see
        'Seln/Themes' ).
        
        3.2.4   Opts/Resource/Menus
        
        Toggles  the search for resources in the blackbox menu files on an
        off.
        
        3.2.5   Opts/Resource/Styles
        
        Toggles the search in blackbox style files on and off.
        
        3.3     Opts/Search
        
        Search options allow you to control how resource file editor makes
        its list of targets on which to operate, i.e. colour resources  to
        be replaced,
        
        3.3.1   Opts/Append search
        
        This  simply  preserves all previous search results; new resources
        to be modified are added to any  existing  list  (  see  'View/Se-
        lected/Targets' ). You can search for 'red' and then'blue' if 'ap-
        pend search' is true; then the 'replace' option will allow  you  (
        if global replace is not also on ) to be prompted for replacements
        first for 'red', then for 'blue'.
        
        3.3.2   Opts/Preserve old search targets.
        
        Useful if you want to  keep  the  list  of  files  you  previously
        searched  in; This is a debugging aid left in since it's still be-
        ing used.  The default is off.  Probably best left that way.
        
        
        3.4     Opts/Undo
        
        Allows you to specify whether an undo file should be saved on  re-
        source replacement.  The  undo files are  saved to .blackhome/con-
        fig, and are named for the current theme plus a  number  which  is
        created  during  the  running  of  resourceFileEditor,  e.g.  'al-
        pha-1.undo'.
        
        Note that numbering starts from 1 whenever  resourceFileEditor  is
        started; you may therefore get overwrite warnings if you are work-
        ing in the same theme and  there  are  previously  generated  undo
        files  present.   Either  delete them ( exec/delete/undo ), rename
        them, or rename the new undo files when prompted.
        
        The default behaviour is 'save undo files'.
        
        3.5     Opts/Replace
        
        These options govern how replacements are made,  whether  by  some
        exactly  specified  new colour or by synthesising one under speci-
        fied constraints.
                
        3.5.1   Opts/Replace/Autoexec
        
        If  this  is  true,  any application which has been selected using
        'Seln/Applications' will be  automatically executed once 'exec/re-
        place' has  completed its action.  This is useful if  working with
        the defaults  for a particular  application,  and saves having  to
        fire it up whenever a  resource modification is made.  Having  the
        original  resource file editor application running can be  partic-
        ularly  useful if its own resource file got modified so everything
        was changed to one colour (!).
        
        The default behaviour is 'off'.
        
        3.5.2   Opts/Replace/Colour
        
        Here you can tell resourceFileEditor how to  replace  colours,  if
        something  other than a straightforward exchange of two colours is
        involved.
        
        Colours can be replaced on a 'nearly like' basis, much as  in  the
        'fuzzy'  search  outlined above, where a latitude of colour can be
        specified by means of colour bounds.  So 'find almost white + or -
        10% and replace with equivalent shades of yellow' is possible.
        
        3.5.2.1 Opts/Replace/Colour/Replacement type
        
        This can be either of 'exact' or 'relative intensity'.
        
        Exact  replacement  substitutes  all found target colour resources
        with the specified replacement colour.  Either a  fuzzy  or  exact
        search may be substituted by an exact replacement.
        
        Relative  intensity  replacement is the 'fuzzy' colour replacement
        option, much like the 'fuzzy  search'.   A  specified  replacement
        colour  is used to derive an actual replacement colour whose shade
        is governed by the inten- sity of the target to be replaced.  Thus
        a  fuzzy  search  and fuzzy replace are possible; shades of purple
        can be substituted for shades of green, for example.
        
        3.5.2.2 Opts/Replace/Colour/Colour type
        
        Here you specify the format in which the colour resources  are  to
        be written in the resource files. Available options are '#' (trun-
        cated), rgb, indexed (rgbi) or named.
        
        Click 'Cancel' in the pop-up box which appears confirming the cur-
        rent replacement type to keep this option unchanged.
        
        If  you  click 'Ok' in the pop-up box you will be presented with a
        submenu from which you can select a new replacement type.
        
        If you select 'named', an additional menu appears requesting a de-
        fault  colour  specification  to  use  if a named colour cannot be
        found to match either that specified as a replacement or an  auto-
        matically generated one.
        
        3.5.2.3 Opts/Replace/Colour/Force shade
        
        This  option  allows  entry of a value -1 <= value <= 1 ( floating
        point ) which will be added to the value of colour resources to be
        substituted  into  the resource files.  Dark and light colours can
        be interchanged using this.
        
        3.5.2.4 Opts/Replace/Colour/Local replace \ Global replace
        
        The menu button indicates the currently  selected  option.   Left-
        clicking  it cause a dialogue box to appear allowing you to change
        the option.  Click 'Ok' to change, 'Cancel' to keep  the  existing
        option.
        
        There  are  two resource replacement modes for resources, 'Global'
        and 'Local'.
        
        Global replace allows you to replace all the current target colour
        re-  sources  found during the search process with a single speci-
        fied colour ( or related variant if the 'relative replacement' op-
        tion  for  colour  replacement  has  been  selected ).  A range of
        shades ( or hues ) can  be substitued  by a  single  colour  (  or
        shades of a specified colour ).
        
        Local replace works in two ways, as does global replace, using ei-
        ther  exact  or fuzzy replacement options, but here  you  will  be
        prompted  to  enter a new replacement resource for each new occur-
        rence of a target resource to be replaced.  So if you searched for
        'nearly  white'  and  had  targets of white, seashell ( two occur-
        rences ) and #fff8fe returned, you  would  be  prompted  to  enter
        three replacement resources.
        
        Note that when multiple occurrences of a colour target occur sepa-
        rated by other colour targets, you will  be  prompted  for  a  new
        colour  each  type  the colour to be substituted _changes_.  So if
        the  search resulted  in occurrences of white,  seashell.   white,
        white and NavajoWhite, you would be prompted for replacements once
        each for white,  seashell,  white and NavajoWhite; successive  oc-
        currences  of  the _same_ resource are replaced by the previously-
        specified replacement colour ( or shade ) for that resource.
        
        3.5.2.5 Opts/Replace/Colour/Derivation Mode
        
        This flag controls how resourceFileEditor derives a new colour  to
        replace one it has found.  If the replacement type ( see 3.5.2.1 )
        has been set to 'relative intensity', it constitutes a  refinement
        of this option.  One of two modes of behaviour can be selected:
        
        a)  Make new colour
        This uses the colour to be replaced as a means of deriving the hue
        of the new colour;  this option can result  in fairly  drastic and
        unexpected changes.  Use with extreme caution  and  make sure  you
        have 'undo' set to 'save' ( see 3.4 ).
        
        b) Shade replacement colour
        The colour produced will be a shade of the  specified  replacement
        colour. Due to the way in which resourceFileEditor calculates sha-
        des, the intensity  of the new shade will always  lie between that
        of the colour selected as replacement and that of the colour to be
        replaced.  Usually this means that the resulting  colour is darker
        than the one specified as the replacement. The resulting shade can
        be forced up or down in intensity by the use of 'Force shade' (see
        3.5.2.3 ). Useful values are generally in  the range 0.05 to 0.15,
        positive or negative, depending on whether you want the results to
        be lighter or darker.
        
        
        3.6     Opts/Save
        
        Saves the current state of the options set in 'Opts'.
        
        
        4       View
        
        View  shows  you what is available for selection and what the cur-
        rent selections are, if any.
        
        4.1     View/Available
        
        Browse to see currently available applications, themes and  colour
        alias  names.   Clicking  any of these buttons shows a list of the
        relevant items.
        
        4.1.1   View/Available/Applications
        
        Applications avaliable for selection as search targets.
        
        4.1.2   View/Available/Themes
        
        Themes available for selection as search targets.
        
        4.1.3   View/Available/Colour aliases
        
        Colour alias names which are valid for use in 'Find colour' (  use
        of  these constitutes an alternative mode of 'fuzzy' colour search
        - see 3.5.2.1 ).
        
        4.2     View/Selected
        
        Shows which targets have been currently selected for use in 'Find'
        opera- tions, and which targets have been found to operate on with
        'Exec/Replace'.
        
        4.2.1   View/Selected/Applications
        
        Shows currently selected applications.
        
        4.2.2   View/Selected/Themes
        
        Shows currently selected themes.
        
        4.2.3   View/Selected/Targets
        
        Shows which resources have been found  by  'Find/Resource'  opera-
        tions  using  the  themes  and applications displayed by 'View/Se-
        lected/Applications' and 'View/Selected/Themes'.
        
        Note that once selected, themes and applications  continue  to  be
        used  in  the  search  process  unless explicitly deselected using
        'Exec/Delete/Application'  or  'Exec/Delete/Theme',  although  you
        should  be aware that these can be overridden if the corresponding
        target types are off in 'Opts/Resource'.
        
        
        5       Seln
        
        This governs the actual selection of applications and themes to be
        used as targets during search operations.
        
        5.1     Seln/Applications
        
        Pops  up a button which when clicked, gives a menu of applications
        available  to  be used as targets, Click on the relevant button to
        select  the  app.   'View/Selected/Applications' will confirm your
        current selection.
        
        5.2     Seln/Themes
        
        As 5.1, but a menu of themes is presented, perhaps with 'more'  at
        the  bottom  if  you  have more themes installed than  the current
        maximum number specified in the resource  file  editor's  own  re-
        source  file ( default 30 ). A button also exists if you have more
        than two themes, labelled 'all'.  Clicking this, well, selects all
        themes...
        
        
        6       Exec
        
        This  button  gives  a menu of actions that resourceFileEditor can
        perform.
        
        6.1     Exec/Delete
        
        Clicking this gives a menu of types of deletion that can  be  per-
        formed.
        
        6.1.1   Exec/Delete/Application
        
        Use  this  to remove targets from the search list ( those selected
        by 'Seln/Target/Applications' ).  If  you  decided  to  search  in
        theme-suffixed  XTerm resource files, here is the place to kill it
        if you don't want it.
        
        6.1.2   Exec/Delete/Theme
        
        Another clickable button popping up a menu  of  clickable  buttons
        (...) which you can use to deselect previously-selected themes.
        
        6.1.3   Exec/Delete/Target
        
        A  menu of resources currently identified as being targets for re-
        placement by the 'Exec/replace' option.  Use this to weed out  re-
        sources  you don't want modified, particularly when a fuzzy search
        has resulted in unwanted items being included.
        
        6.1.4   Exec/Delete/Undo
        
        This will delete any undo files saved  in  .blackhome/config.   If
        undo  files  resulting from a previous session are found, you will
        be asked for  confirmation as to whether you  require these to  be
        deleted.
        
        6.2     Exec/Edit
        
        This  option  pops  up  a button 'Edit files' which, when clicked,
        gives a drop-down menu of, yes, clickable buttons for types of re-
        source  you  might want to edit.  Or perhaps, like me, you may now
        be suffering from RSI uninduced by anything more pleasurable  than
        seemingly  endless menus of buttons and would really prefer not to
        edit anything. At all. Ever. Especially if it needs any clicking.
        
        6.2.1   Exec/Edit/Applications
        
        Gives  a  menu from which you can click on an application to get a
        pop-up box displaying  the  application's  colour  resource  file.
        Clicking  'Cancel'  here  quits without saving the file.  If it is
        modified, clicking 'Ok' will save the modified file.
        
        6.2.2   Exec/Edit/Resources
        
        Displays an 'Edit resource' pop-up button which when clicked  dis-
        plays  a  drop-down  menu  from which you can select blackhome re-
        source files - other than app resources, edited in 6.2.1 above.
        
        6.2.3   Exec/Edit/Configuration
        
        Displays  an  'Edit resource' button with a menu of blackhome con-
        figuration files you can edit.
        
        Select from:        
        
        AppDefsList
        Applications you want install theme to include resource files for,
        for that theme.
        
        LinkDefsList
        Link names of themed app resource files in your home directory.
        
        User Spec
        Governs sound and background loading used by theme.
        
        Colour alias
        The currently defined colour analysis descriptions and correspond-
        ing alias names (where allocated).  See  ColourSpecConvert.txt for
        details.
        
        App alias
        resourceFileEditor tries to determine  the name of  an application
        from  its resource file (whose name will appear on the list of se-
        lected targets).  For example, the XTerm colour resource  file for
        theme alpha,  XTerm-color-alpha,  will be  used  to  determine the
        application name ( xterm ).  This name is used by the 'autoexec on
        modification' feature.
        
        Sometimes names cannot be correctly derived.  For example, the re-
        source file under theme alpha for resourceFileEditor is  Resource-
        FileEditorcolor-alpha, from which the application name 'resource-
        fileeditor' is derived.  This is wrong, since the application name
        is  'resourceFileEditor' and,  furthermore,  it requires that your
        home directory  be specified  as  an  argument.  So to  launch the
        application I have to use either 'resourceFileEditor ~' or, equiv-
        alently, 'resourceFiledEditor /home/will'.  Thus the derived  name
        'resourcefileeditor' is aliased as 'resourceFileEditor ~/blackhome
        /config/resourceFileEditor,~'  in  the  appNameAlias file. Another
        example is MiXViews-color,  the app default file for the sound ed-
        itor of that name which is invoked  as  'mxv'. RFE derives the app
        name 'mixviews' from the resource file name  'MiXViews'  and  con-
        sequently an  alias  must  be  set up to translate  'mixviews'  to
        the executable 'mxv'.
        Thus the appNameAlias entry reads 'mixviews mxv'.
        
        Thus the app alias allows the problem to be overcome. In this file
        you specify the derived name of the application (which will be all
        lower-case ), then a space as a separator,  followed by the actual
        application name and,  optionally,  any arguments the  application
        requires _separated_by_commas_. This latter point is important.
        
        Note  that  applications  which cannot be executed properly by the
        'autoexec' feature may well cause a  core  dump.   Usually  the  X
        server's  output when it is shut down will give a clue as to why a
        particular app failed to execute ( often specifiying a list of re-
        quired parameters, which may be entered as arguments after the app
        name in the App alias file ).
        
        RFE rc
	The contents of the blackhome resource file editor colour resource
        file itself. Occasionally handy as a direct way to examine and ed-
        it the current configuration, apart from all those 'Opts' buttons.
        
        6.3     Exec/Replace
        
        This  option allows specification of a replacement resource, It is
        popped up during the replacement process as new  resources  to  be
        replaced are  encountered ( unless 'Opts/Replace/Colour/Global re-
        place' is selected ).  The box label specifies the resource  to be
        replaced.   Type or mouse select and copy the replacement resource
        specification into the text box and press 'Ok'.  Pressing 'Cancel'
        here does not accomplish anything useful.
        
        6.4     Exec/Undo
        
        Displays  a  button  'Undo edit' which, when clicked with the left
        mouse button,  pops up a  menu  with  two  types of undo operation,
        'Last' and 'Previous'.
        
        6.4.1   Exec/Undo/Last
        
        Clicking  on  this undoes the last edit operation performed during
        the current  resourceFileEditor  session.   This  is  most  useful
        when  used  in  conjunction with  'Autoexec'  set to 'true';  when
        modified, a selected app.  pops up in its new guise, and  the  ef-
        fect  can  be immediately undone if it is not satisfactory.  If no
        undo file can be found, an error message is displayed.
        
        6.4.2   Exec/Undo/Previous
        
        Pressing this allows you to enter an  undo  filename  (  the  undo
        files are in .blackhome.config,  assuming 'Opts/Undo' has been set
        to 'save undo files'). Either browse here and mouse copy and paste
        or type in the undo filename (themeName-number.undo, e.g. 'alpha-1
        .undo' ),  and the previous state of affairs will be restored.  If
        
        If  an  undo  file  already exists, you will be prompted for a re-
        placement name.  A text box will appear with the existing name  in
        it, allowing you to edit it to something else.
        
        Clicking  'Ok' will overwrite an existing file if the filename has
        not been altered.  Clicking 'Cancel' will cause the undo file  not
        to be written.
        
        
        Finally,  for  those  in  desperation  - if you have more than one
        theme, and if you remembered to save undo files:  if you have man-
        aged to modify blackhome and blackbox' appearance beyond any mean-
        ingful recognition,  either change  to another  theme  or  install
        some theme just as a dummy, then resourceFileEditor should use its
        basic defaults and you should be able to enter the  undo  filename
        you  need  from  whatever  theme you happen to be in.  The correct
        theme's resource modifications will be  undone.   Hopefully  light
        dawns and your menus, etc, go back to being readable.
        
