Changes between Initial Version and Version 1 of Documentation/T3D/Log-Output


Ignore:
Timestamp:
06/03/10 15:59:46 (14 years ago)
Author:
zeiss
Comment:

Importing pages from "/var/lib/svn/trac/etsicheck2" using WikiImport plugin.

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/T3D/Log-Output

    v1 v1  
     1== Documentation Generation Log == 
     2 
     3This log contains information about the generation process itself and is provided initially in the form of console messages which indicate the progress of the documentation generation process and show any errors or problems that are encountered during in the process. This log was also exported as an XML file for convenience and automated post-processing by third party tools. As of v1.0.0 this is no longer the case. The generation of an XML log file has been suspended until such functionality is reintegrated into the new common logging interface. The log file file was called {{{log.xml}}} and was located in the target directory where the other XML files from the main output are located as well. The particular format of the log messages will be described in more detail in the relevant sections concerning the causes and contexts of their occurrence. Ultimately, all messages shall have a uniform format, however currently some of them still have different formats. Further information about the XML file itself will be available in the T3D technical documentation once it is reintegrated. 
     4 
     5There are currently three types of log messages: 
     6 * Information 
     7 * Warning 
     8 * Error 
     9 
     10=== Information === 
     11 
     12Information messages include general information about the documentation process, its progress, as well as brief statistics at the end. Some of the messages may change to status-type messages in the future, once such type of log messages is introduced to T3D. Currently the following types of information are considered information messages:  
     13 * Status reporting (parsing a file, processing a file) 
     14 * Runtimes of the separate phases of T3D 
     15 * The number of generated HTML documentation files 
     16 * Brief statistics including 
     17  * A list of all processed files 
     18  * A list of all files processed without errors or warnings 
     19  * A list of all files processed with errors or warnings 
     20  
     21Not all of these messages are explicitly marked as ''INFORMATION'' messages as of yet, but this will be a subject to change in the future, where the log output format will be uniform for all log messages. 
     22 
     23[[Include(wiki:Documentation/T3D/Log-Output/Warnings)]] 
     24 
     25=== Error === 
     26 
     27Error messages are produced on unrecoverable errors, such as a parsing error (although there is an option in the configuration that would allow bypassing parsing errors, but it is disabled by default and it is recommended that it stays that way for reliable results).