{"record":{"id":"a4803db4efd140f8","repo":"quarkusio/quarkus","slug":"unsupported-format-format","errorCode":null,"errorMessage":"Unsupported format: ${format}","messagePattern":"Unsupported format: (.+?)","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"devtools/config-doc-maven-plugin/src/main/java/io/quarkus/maven/config/doc/generator/Formatter.java","lineNumber":44,"sourceCode":"    int adjustedLevel(ConfigSection configSection, boolean multiRoot);\n\n    String escapeCellContent(String value);\n\n    String toAnchor(String value);\n\n    String formatSectionTitle(ConfigSection configSection);\n\n    String formatName(Extension extension);\n\n    static Formatter getFormatter(GenerationReport generationReport, JavadocRepository javadocRepository,\n            boolean enableEnumTooltips, Format format) {\n        switch (format) {\n            case asciidoc:\n                return new AsciidocFormatter(generationReport, javadocRepository, enableEnumTooltips);\n            case markdown:\n                return new MarkdownFormatter(generationReport, javadocRepository);\n            default:\n                throw new IllegalArgumentException(\"Unsupported format: \" + format);\n        }\n    }\n}","sourceCodeStart":26,"sourceCodeEnd":47,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/config-doc-maven-plugin/src/main/java/io/quarkus/maven/config/doc/generator/Formatter.java#L26-L47","documentation":"Formatter.getFormatter maps the configured Format enum to a formatter implementation and throws IllegalArgumentException for any value other than asciidoc or markdown. The plugin only ships those two formatters.","triggerScenarios":"generate-config-doc runs with -Dformat set to a value that resolves to a Format enum constant with no case branch (custom/typo/unsupported format from a different plugin version).","commonSituations":"Typo in the format parameter; copying a config example from another docs tool; plugin version where a format was added/removed relative to the docs you followed.","solutions":["Set format=asciidoc or format=markdown explicitly","Check supported values of the Format enum in your plugin version (mvn help:describe or the plugin docs)","Upgrade or downgrade the plugin to a version supporting the desired format"],"exampleFix":"// before\nmvn ... -Dformat=html\n// after\nmvn ... -Dformat=markdown","handlingStrategy":"validation","validationCode":"Set<String> supported = Set.of(\"asciidoc\", \"markdown\");\nif (!supported.contains(configuredFormat)) {\n    throw new IllegalArgumentException(\n        \"format must be one of \" + supported + \", got: \" + configuredFormat);\n}","typeGuard":null,"tryCatchPattern":"try {\n    mojo.execute();\n} catch (IllegalArgumentException e) {\n    if (e.getMessage().startsWith(\"Unsupported format\")) {\n        logger.error(\"Use asciidoc or markdown: \" + e.getMessage());\n    }\n}","preventionTips":["Only pass asciidoc or markdown as format","Check the Format enum for your plugin version","Copy format settings only from this plugin's official docs"],"tags":["maven","configuration","unsupported-format"],"backgroundTag":"unsupported-enum-value","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-12T22:17:10.623Z"}