Mod_Info version 1.5 by Vasiliy
-------------------------------
(sorry for my bad english)

This utility allows to view content of Morrowind data files and generate various 
reports.

1. Introduction
2. Syntax highlight
3. Detection of the new / changed records
4. PreScan
5. Statistic
6. Reports
7. Export
8. Version History

1. Introduction
-------------
This utility allows to view content of Morrowind data files and generate various 
reports.

Full supported files:
 mods: *.esp
 master files: *.esm
 export files: *.esd (created by tesame) 
As it is possible to look through any file based on a format TES3 (for example, saves),
However their special records are not distinguished and are brought in a category 'UNKN'. 

To more full to understand the deduced information it is desirable to familiarize with the
Morrowind files format.

Mod Info there are no editorial functions (for example, as against tesame not
allows to delete records or to concatenate mods).

To look through records it is possible or in the complete list, or on each of categories. 
The sorting according any column is supported. At a choice of a record the list is shown
its subrecords. Contents of each subrecord it is possible to look at double click ( or [ENTER])
on it.

PS: all additional windows are closed with the help of a key [Esc].

2. Syntax highlight
-----------------------
Mod Info highlights syntax in two modes:
 à) at viewing the list of records
    - the colour allocates types of records for which there is a special processing:
      TES3 - at double click on such record opens îêîøêî with the information about header of a file
      BOOK - at double click viewing the text of the book (scroll)
      SCPT - at double click viewing the text of the script
      INFO - at double click viewing the text of the answer and built - in script 
    - more dark colour allocates records with ID, found in the master files
    - reder colour allocates records, at which is present DELE subrecord (i.e. either record, or one of
      his subrecords is marked on Removal)
  á) at detailed viewing of the texts
    - books (scrolls)
    - scripts
    - answers

3. Detection of the new / changed records
-----------------------------------------
Mod Info allows to determine what records of the current file also are present in the master files.
For this purpose, after loading the mod is necessary to execute a command "Find in master files " [Ctrl+F].
You'll se the list of the master files specified in the header of a mod. You can edit this list. After
pressing "Îê", Mod Info will scan the specified files, will make the list them ID and will mark by a symbol
'©' all records current a mod, at which ID was found as and in the master files. Such records I shall name
"changed". Records, with which in the master files the conformity is not found, I shall name "new".
Actually in quality the master files it is possible to specify anyone .esm and .esp files. So, with the help
of this function also it is possible to determine conflicting records.


4. PreScan
----------
The preliminary scanning allows to not scan anew file at its use. It is enough once to process it and to keep
results of scanning. After this the scanned results will be used automatically every time, when this file is
required. For example, on my computer opening of a file morrowind.esm occurs for ~ 15 seconds. At use of
preliminary scanning time loadings are reduced to ~2 seconds, and with help of the window's buffers up to 0.5
sec.!

And for it we pay only in additional file at a rate of ~2,5 Mb. Even, if you do not plan to study .esm files,
all the same it is necessary them to scan, since. They are used at definition of the changed records.

To use preliminary scanning it is necessary to make the following:
 - Load the necessary file in Mod Info (and by the way unessentially .esm!) [Ctrl+O];
 - Lead search of ID in the master files, which are specified in it. [Ctrl+F];
 - Keep results of scanning [Ctrl+F];
Resulting file will be kept in a directory .\work with extension .scn

Attention:
 - the preliminary scanning is used, only if his date or size was not changed. If you, for example, edited a file,
   do not forget rescan it.
 - as a result of scanning also keep the attribute of the "changed" records (on the moment of scan). I.e. if you
   do experiences with searches of IDs in the various files, before saving the results of scanning, do scan again,
   but already in the master files specified in the header of a mod.

5. Statistic
------------
Mod Info also allows to get the various statistical information.

The following information can be received:
  - total amount of records and their amount in each category;

  - to generate the list of records with duplicating ID's;

  - to generate the list of records, in which there is a subrecord DELE (i.e. it, or its subrecord is marked
    on removal).

  - to generate the list of records of the answers (INFO), in which there are no hyperlink labels,
    and they are present at their master's versions (new in the version 1.2)
    Attention: the symbol '@' is searched only. To the log write the line of a kind: 
    INFO:1234567890=Master Text
    (I.e. the text which was got out from the master file for this ID)

The commands of getting of the information are located in menu 'Info', and results are showed in the log
(to look [F2]).

6. Reports
----------
The reports:
  - to generate the list of all IDs;

  - to generate the list of IDs, not found in the master files, ("new");

  - to generate the list of IDs, found in the master files, ("changed");

  - to generate the list models (.nif), found in a category BODY;

  - Generation of files .cel, .top, .mrk for current mod (new in the version 1.4);
    Mod Info will not translate them for you, but can automate work on their drawing up.
    Rules of formation of these files the following:
      - the record is looked through, and if it ID is not found in previous master files,
        and it satisfies to conditions (more in detail about them below), is added line of
        a kind "name [TAB] name".
      - to avoid override of existing files, the name of a target file is formed
        as '_' + mod_name + '.cel ' (.top, .mrk) for example "_mycoolmod.cel".
    .cel - the records CELL are looked through only. Conditions of record is should be new
           interior.
    .top - the records DIAL are looked through only. Conditions of record is should be new
           topic (DATA=0).
    .mrk - is a copy of a file .top.

7. Export
---------
Mod Info allows to keep any group of records in a separate file of the data .esd.
This file is compatible with the utility tesame. For this purpose allocate interesting records
( In any mode of viewing) and give a command "Export selected". 

In addition to this you can export to a textual file:

  - to generate names of records for translation (new in the version 1.3);
    The report goes as lines INFO:1234567890=text for translation. This text it is possible
    then to edit and to import back to the mod with the help of the utility MTM
    (Mod Text Merger). The list of processable records and fields in them:
    ACTI FNAM
    ALCH FNAM
    APPA FNAM
    ARMO FNAM
    BOOK FNAM
    BSGN FNAM
    CLAS FNAM
    CLOT FNAM
    CONT FNAM
    CREA FNAM
    DIAL NAME
    DOOR FNAM
    FACT FNAM
    GMST STRV
    INFO NAME
    INGR FNAM
    LIGH FNAM
    LOCK FNAM
    MGEF DESC
    MISC FNAM
    NPC_ FNAM
    PROB FNAM
    RACE FNAM
    REGN FNAM
    REPA FNAM
    SPEL FNAM
    WEAP FNAM

  - Texts of the books
  - Texts of the scripts
  - Texts of the dialogue scripts (INFO - BNAM) (new in the version 1.4)
  - Texts of the scripts with language aware function (new in the version 1.5)
  - Texts of the descriptions of zodiac (new in the version 1.5)
  - Texts of the descriptions of classes (new in the version 1.5)
  - Texts of the descriptions of races (new in the version 1.5)
  - Texts of the descriptions of skills (new in the version 1.5)

With one of methods of a filtration:
  - all records 
  - only new
  - only changed

In the version 1.5 the function of batch processing has appeared. For current mod are carried out all 
textual export. The resulting files will be written down in the same directory, where is original mod.
The names of files will be of a kind mod_name+.report_type+.txt, for example:
 morrowind.Books.txt, morrowind.Scripts.txt etc.

For detection the language aware functions used the textual search with key is used by words:
  addtopic
  aiescortcell
  aifollowcell
  choice
  changeweather
  getpccell
  messagebox
  modregion
  placeitemcell
  positioncell
  say
  showmap
  
Pay attention: even if the function is commented or is included into other word
as substring, such script will be considered as language aware.

PS: certainly, everywhere, where the division new / changed records is used,
it is meant, that you already have search for IDs in the master files...

8. Version History
------------------
  1.0 - first release

  1.1
   [FIX] - the misunderstanding with export of records is corrected

  1.2
   [ADD] - detection of the removed records / fields
   [ADD] - detection broken hyperlinks in dialogues

  1.3
   [ADD] - generation of the report for translation of names (together with the utility MTM)

  1.4
   [ADD] - toolbar implemented
   [ADD] - export of the texts of the dialog script
   [ADD] - generation .cel, .top, .mrk
   [FIX] - a few has cleaned format of export of the texts of the books and scripts, for
           sharing with the importing utilities.  
  1.5
   [MOD] - generation of the report for translation of names has transferred in the export menu 
   [ADD] - export of the scripts texts, containing the language aware functions
   [ADD] - export of the zodiac descriptions
   [ADD] - export of the class descriptions
   [ADD] - export of the race descriptions
   [ADD] - export of the skill descriptions
   [ADD] - batch export

--------------------------------------------------------------------------------------------
SOFTWARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.

AUTHOR DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH
RESPECT TO THE PROGRAM. THE END-USER ASSUMES ALL RISK AS TO THE SUITABILITY, QUALITY,
AND PERFORMANCE OF THE PROGRAM. IN NO EVENT WILL AUTHOR, OR ITS DIRECTORS, OFFICERS,
EMPLOYEES OR AFFILIATES, BE LIABLE TO THE END-USER FOR ANY CONSEQUENTIAL, INCIDENTAL,
INDIRECT, SPECIAL OR EXEMPLARY DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS,
BUSINESS INTERRUPTION, LOSS OF DATA OR BUSINESS INFORMATION, AND THE LIKE) ARISING OUT
OF THE USE OF OR INABILITY TO USE THE PROGRAM OR ACCOMPANYING WRITTEN MATERIALS, EVEN
IF AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
--------------------------------------------------------------------------------------------

Send your comments and suggestions to vasiliy73@mail.ru
With best regards, Vasiliy.
