 COPY.FMT file description
===========================


The  formatted  lines describing a format of the data copied from a plug-in
are  stored  in  this  file, and other information used to create the final
representation of these data. The lines beginning with a semicolon ";", are
considered  as comments and do not bear any semantic loading for a plug-in.
The  file  should  be  in  the  same  folder  in which there is a file of a
plug-in.

The file has the following structure:


<Object of Formatting> = <Format String>
...
<Object of Formatting> = <Format String>
<Headline Name> = <Headline Text>
...
<Headline Name> = <Headline Text>

where
<Object  of  Formatting>  is  the  object,  which  data  will be exposed to
    formatting. The following values are accessible:

      Export_List - the list of module's export;
      Modules_List - the list of modules from which functions are imported;
      Import_List - the list of imported functions;
      Section_List - the list module's sections.

      
<Format  String>  - the string specifying appearance of the copied data. It
    can accept any values. Also it can contain substitution elements. There
    are  individual substitution elements for each object giving data to be
    copied, and general ones for several objects.


<Headline Name> - the identifier of a headline, which text will be inserted
    before or after the data to be copied.

    
<Headline  Text>  -  actually,  the  text  of a headline. It can consist of
    several  lines. The text of a headline begins right after the name of a
    headline  and  a  sign  "="  and ends with two percent signs "%%". Line
    breaks  are  taken into account. The text of headlines is only inserted
    if copying all contents of the lists.


    
 All certain replacements are listed below:
--------------------------------------------

For Export_List:
  %NAME% - Function name.
  %ORD% - Function ordinal number.
  %HINT% - Number under which function has been read out from the module.
  %VA% - Virtual address of the function.
  %RAW% - Function offset in the file.

For Modules_List:
  %MOD% - Module name.
  %VALID% - Accessibility of a module (Yes/No).
  %DELAY%  -  Whether  the  module  has  been  loaded from the DELAY_IMPORT
              catalog (Yes/No).

For Import_List:
  %NAME% - Function name.
  %ORD% - Function ordinal number.
  %HINT% - Hint of a function.
  %MOD% - Name of the module the function is imported from.
  %VALID% - Function accessibility (Yes/No).

For Sections_List:
  %NAME% - Section name.
  %VIRTUALADDRESS% - Virtual address of the section.
  %RAWOFFSET% - Section offset in the file.
  %VIRTUALSIZE% - Virtual size of the section.
  %RAWSIZE% - Size of section data in the file.
  %FLAGSHEX% - Hexadecimal value of section characteristics.
  %FLAGSDESC% - Characteristics description.

  
In the headlines, and Modules_List and Import_List bodies:
  %INVCOUNT% - Number of the inaccessible elements of the list.


For all the lists:
  %CURIDX% - Current element number.


For all the lists and headlines:
  %COUNT% - Total number of the elements in the list.
  %SMOD% - The name of the current module open in the plug-in.

  
ATTENTION!!!  Replacements  MUST  be  in  the  UPPER case! At the slightest
inconformity substitution will not be made.



In all descriptions the following elements of lines formatting are allowed:

\n - Line break.
\t - Tab character.
\% - Percent sign "%".
\\ - Backslash "\".
\#NNN; - Character with NNN (decimal) code.
\e  - "Empty character", i. e. "\e" text just will be cuted from the source
     line.
     

In  all  other  cases, any replacements are not made if there are any other
characters following the backslash.


---------------------------------------------------------------------------