Home | Examples | Reviews | Free download | Purchase | Web page help | Program help

HtmlPedigree: How warnings and errors are logged

Index | Logs | Style | Chart | Tags | Links | Images | Dates | Pages | Home | Search | Miscellaneous

GEDCOM warnings and errors

After the program has read a GEDCOM file, it displays some summary information, showing how many lines of the file have been read, the number of records that have been found, and how many there are of each type (individuals, families, notes and so on).

If the file has been read in order to update a set of web pages, the program will also display a summary of the matching process, by which it attempts to identify records in the web pages with those in the GEDCOM file. It will show the number of records matched, the number of records from the web pages deleted (because they cannot be matched to records from the GEDCOM), and the number of new records from the GEDCOM that have been added. In case of a query, these records are listed at the bottom of the page.

The program will also show a list of any unrecognised "tags" found in the GEDCOM file, and any unrecognised calendars, or unidentified words in dates that may be unrecognised months. If you wish, you can specify how you would like these to be interpreted (see Tags and Dates).

A list of unrecognised dates will be shown near the bottom of the page. These will be shown in the web pages as they appear in the GEDCOM file. However, because the program will be unable to compare them correctly with other dates, the order in which entries appear in the indexes may be incorrect.

The program is as forgiving as possible of errors or anomalies in the GEDCOM file, but will display a variety of warning messages in case you want to look into these and correct them.

Other errors and warnings

The program may also display errors and warnings if it encounters problems during other operations - the initial start-up, reading or saving web pages, or saving new default settings for style, tags or dates.

If the program fails to overwrite or delete a file because it has been set as "read-only", it will indicate a fatal error, and display the name of the first such file encountered. Before saving a set of web pages, the "read-only" setting needs to be cancelled for all files in the folder in which you want to save the pages. (Under Windows, right-click on the file icon, click the "Properties" item in the pop-up menu, and untick the "Read-only" box.)

Warnings will also be generated if the program has included a hyperlink to a file on the user's hard disc, but is unable to find the file when writing the web pages. (See How files linked from the GEDCOM are processed and How to link images and other multimedia files.)

Otherwise, warnings should appear very rarely unless the files being read have somehow been corrupted.

So long as these logs of information, errors and warnings remain available, they can be shown through the "Logs" sub-menu of the program's "View" menu. When a log is displayed, it can be printed, or saved to file by clicking the "Save log to file" item of the "File" menu. Note that only the first 100 items of each section of a log will be displayed on the screen or printed, but the complete log will be written to file when it is saved.