UNPKG

2.13 kBJavaScriptView Raw
1/**
2 * Part of the {@link TSDocConfiguration} object.
3 */
4var TSDocValidationConfiguration = /** @class */ (function () {
5 function TSDocValidationConfiguration() {
6 /**
7 * Set `ignoreUndefinedTags` to true to silently ignore unrecognized tags,
8 * instead of reporting a warning.
9 *
10 * @remarks
11 * Normally the parser will issue errors when it encounters tag names that do not
12 * have a corresponding definition in {@link TSDocConfiguration.tagDefinitions}.
13 * This helps to catch common mistakes such as a misspelled tag.
14 *
15 * @defaultValue `false`
16 */
17 this.ignoreUndefinedTags = false;
18 /**
19 * Set `reportUnsupportedTags` to true to issue a warning for tags that are not
20 * supported by your tool.
21 *
22 * @remarks
23 * The TSDoc standard defines may tags. By default it assumes that if your tool does
24 * not implement one of these tags, then it will simply ignore it. But sometimes this
25 * may be misleading for developers. (For example, they might write an `@example` block
26 * and then be surprised if it doesn't appear in the documentation output.).
27 *
28 * For a better experience, you can tell the parser which tags you support, and then it
29 * will issue warnings wherever unsupported tags are used. This is done using
30 * {@link TSDocConfiguration.setSupportForTag}. Note that calling that function
31 * automatically sets `reportUnsupportedTags` to true.
32 *
33 * @defaultValue `false`
34 */
35 this.reportUnsupportedTags = false;
36 /**
37 * Set `reportUnsupportedHtmlElements` to true to issue a warning for HTML elements which
38 * are not defined in your TSDoc configuration's `supportedHtmlElements` field.
39 *
40 * @defaultValue `false`
41 */
42 this.reportUnsupportedHtmlElements = false;
43 }
44 return TSDocValidationConfiguration;
45}());
46export { TSDocValidationConfiguration };
47//# sourceMappingURL=TSDocValidationConfiguration.js.map
\No newline at end of file