[
https://issues.apache.org/jira/browse/DAFFODIL-3050?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18033809#comment-18033809
]
Mike Beckerle commented on DAFFODIL-3050:
-----------------------------------------
Some discussion of config files, and alternatives to them are here:
https://issues.apache.org/jira/browse/DAFFODIL-2234 however, I don't think that
should prevent us from documenting what exists and works today.
> site documentation for Daffodil tunables
> -----------------------------------------
>
> Key: DAFFODIL-3050
> URL: https://issues.apache.org/jira/browse/DAFFODIL-3050
> Project: Daffodil
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 4.0.0
> Reporter: Mike Beckerle
> Priority: Major
>
> We have doc strings in the dafext.xsd file, but we don't generate a
> daffodil-site documentation page from them, so the only way people can know
> about them is to know to look in the dafext.xsd file itself.
> In general the mechanism for assigning DFDL variables, providing settings for
> tunables, etc. is not described in our documentation, other than the CLI
> documentation for specifying a config file on the command line, and API calls
> for specifying a config file.
> For example, our warning messages come with a WarnID which can be added to
> the tunable suppressSchemaDefinitionWarnings in a config file to silence the
> warnings.
> This is important but not documented anywhere.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
