HTML Tidy  5.9.15
The HTACG Tidy HTML Project
Report and Dialogue Writing Functions

Detailed Description

These simple functions perform the vast majority of Tidy's output, and one these should be your first choice when adding your own output.

A report is typically diagnostic output that is generated each time Tidy detects an issue in your document or makes a change. A dialogue is a piece of information such as a summary, a footnote, or other non-tabular data. Some of these functions emit multiple reports or dialogue in order to effect a summary.

General Report Writing

If one of the convenience reporting functions does not fit your required message signature, then this designated reporting function will fit the bill.

Be sure to see if a message formatter exists that can handle the variable arguments.

TY_PRIVATE void TY_❪Report❫ (TidyDocImpl *doc, Node *element, Node *node, uint code,...)
 The designated report writing function. More...
 

Convenience Reporting Functions

These convenience reporting functions are able to handle the bulk of Tidy's necessary reporting, and avoid the danger of using a variadic if you are unfamiliar with Tidy.

TY_PRIVATE void TY_❪ReportAccessError❫ (TidyDocImpl *doc, Node *node, uint code)
 
TY_PRIVATE void TY_❪ReportAttrError❫ (TidyDocImpl *doc, Node *node, AttVal *av, uint code)
 
TY_PRIVATE void TY_❪ReportBadArgument❫ (TidyDocImpl *doc, ctmbstr option)
 
TY_PRIVATE void TY_❪ReportEntityError❫ (TidyDocImpl *doc, uint code, ctmbstr entity, int c)
 
TY_PRIVATE void TY_❪ReportFileError❫ (TidyDocImpl *doc, ctmbstr file, uint code)
 
TY_PRIVATE void TY_❪ReportEncodingError❫ (TidyDocImpl *doc, uint code, uint c, Bool discarded)
 
TY_PRIVATE void TY_❪ReportEncodingWarning❫ (TidyDocImpl *doc, uint code, uint encoding)
 
TY_PRIVATE void TY_❪ReportMissingAttr❫ (TidyDocImpl *doc, Node *node, ctmbstr name)
 
TY_PRIVATE void TY_❪ReportSurrogateError❫ (TidyDocImpl *doc, uint code, uint c1, uint c2)
 
TY_PRIVATE void TY_❪ReportUnknownOption❫ (TidyDocImpl *doc, ctmbstr option)
 

General Dialogue Writing

These functions produce dialogue output such as individual messages, or several messages in summary form.

TY_PRIVATE void TY_❪Dialogue❫ (TidyDocImpl *doc, uint code,...)
 Emits a single dialogue message, and is capable of accepting a variadic that is passed to the correct message formatter as needed. More...
 

Output Dialogue Information

TY_PRIVATE void TY_❪ErrorSummary❫ (TidyDocImpl *doc)
 Outputs the footnotes and other dialogue information after document cleanup is complete. More...
 
TY_PRIVATE void TY_❪ReportMarkupVersion❫ (TidyDocImpl *doc)
 Outputs document HTML version and version-related information as the final report(s) in the report table. More...
 
TY_PRIVATE void TY_❪ReportNumWarnings❫ (TidyDocImpl *doc)
 Reports the number of warnings and errors found in the document as dialogue information. More...
 

Function Documentation

◆ TY_❪Dialogue❫()

TY_PRIVATE void TY_❪Dialogue❫ ( TidyDocImpl *  doc,
uint  code,
  ... 
)

Emits a single dialogue message, and is capable of accepting a variadic that is passed to the correct message formatter as needed.

◆ TY_❪ErrorSummary❫()

TY_PRIVATE void TY_❪ErrorSummary❫ ( TidyDocImpl *  doc)

Outputs the footnotes and other dialogue information after document cleanup is complete.

LibTidy users might consider capturing these individually in the message callback rather than capturing this entire buffer. Called by tidyErrorSummary(), in console.

Todo:
: This name is a bit misleading and should probably be renamed to indicate its focus on printing footnotes.

◆ TY_❪ReportAccessError❫()

TY_PRIVATE void TY_❪ReportAccessError❫ ( TidyDocImpl *  doc,
Node *  node,
uint  code 
)

◆ TY_❪ReportAttrError❫()

TY_PRIVATE void TY_❪ReportAttrError❫ ( TidyDocImpl *  doc,
Node *  node,
AttVal *  av,
uint  code 
)

◆ TY_❪ReportBadArgument❫()

TY_PRIVATE void TY_❪ReportBadArgument❫ ( TidyDocImpl *  doc,
ctmbstr  option 
)

◆ TY_❪ReportEncodingError❫()

TY_PRIVATE void TY_❪ReportEncodingError❫ ( TidyDocImpl *  doc,
uint  code,
uint  c,
Bool  discarded 
)

◆ TY_❪ReportEncodingWarning❫()

TY_PRIVATE void TY_❪ReportEncodingWarning❫ ( TidyDocImpl *  doc,
uint  code,
uint  encoding 
)

◆ TY_❪ReportEntityError❫()

TY_PRIVATE void TY_❪ReportEntityError❫ ( TidyDocImpl *  doc,
uint  code,
ctmbstr  entity,
int  c 
)

◆ TY_❪ReportFileError❫()

TY_PRIVATE void TY_❪ReportFileError❫ ( TidyDocImpl *  doc,
ctmbstr  file,
uint  code 
)

◆ TY_❪ReportMarkupVersion❫()

TY_PRIVATE void TY_❪ReportMarkupVersion❫ ( TidyDocImpl *  doc)

Outputs document HTML version and version-related information as the final report(s) in the report table.

Called by tidyRunDiagnostics(), from console. Called by tidyDocReportDoctype(), currently unused.

◆ TY_❪ReportMissingAttr❫()

TY_PRIVATE void TY_❪ReportMissingAttr❫ ( TidyDocImpl *  doc,
Node *  node,
ctmbstr  name 
)

◆ TY_❪ReportNumWarnings❫()

TY_PRIVATE void TY_❪ReportNumWarnings❫ ( TidyDocImpl *  doc)

Reports the number of warnings and errors found in the document as dialogue information.

Called by tidyRunDiagnostics(), from console.

◆ TY_❪ReportSurrogateError❫()

TY_PRIVATE void TY_❪ReportSurrogateError❫ ( TidyDocImpl *  doc,
uint  code,
uint  c1,
uint  c2 
)

◆ TY_❪ReportUnknownOption❫()

TY_PRIVATE void TY_❪ReportUnknownOption❫ ( TidyDocImpl *  doc,
ctmbstr  option 
)

◆ TY_❪Report❫()

TY_PRIVATE void TY_❪Report❫ ( TidyDocImpl *  doc,
Node *  element,
Node *  node,
uint  code,
  ... 
)

The designated report writing function.

When a proper formatter exists, this one function can handle all report output.