[
https://issues.apache.org/jira/browse/DAFFODIL-3044?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18034424#comment-18034424
]
Mike Beckerle commented on DAFFODIL-3044:
-----------------------------------------
This is a list of all the DFDL language extensions in Daffodil with my
suggestion for which are commitments for long-term support (LTS) and which
remain experimental.
The LTS implications would include having real documentation of the features
(which I am working on) on the daffodil-site, whereas the experimental would be
documented with Wiki pages only. Also the LTS features really could/should
eventually have support from the VSCode extension for Daffodil as if they were
officially part of DFDL. They are mostly very easy to support. Only dfdlx:layer
is hard - and that one is quite a challenge for a visual GUI tool.
LTS:
* Type hexBinary with lengthUnits='bits'
* dfdlx:alignmentKind
* dfdlx:parseUnparseProperty
* dfdlx:direction for dfdl:defineVariable
* Layers and layer feature: dfdlx:layer
* Enums feature: dfdlx:repType, dfdlx:repValues, and dfdlx:repValueRanges
* [{{dfdlx:trace($value,
$label)}}|http://localhost:4000/dfdl-extensions/#dfdlxtracevalue-label]
* [{{dfdlx:lookAhead(offset,
bitSize)}}|http://localhost:4000/dfdl-extensions/#dfdlxlookaheadoffset-bitsize]
* [{{dfdlx:bitAnd(arg1,
arg2)}}|http://localhost:4000/dfdl-extensions/#dfdlxbitandarg1-arg2]
* [{{dfdlx:bitOr(arg1,
arg2)}}|http://localhost:4000/dfdl-extensions/#dfdlxbitorarg1-arg2]
* [{{dfdlx:bitXor(arg1,
arg2)}}|http://localhost:4000/dfdl-extensions/#dfdlxbitxorarg1-arg2]
* [{{dfdlx:bitNot(arg)}}|http://localhost:4000/dfdl-extensions/#dfdlxbitnotarg]
* [{{dfdlx:leftShift(value,
shiftCount)}}|http://localhost:4000/dfdl-extensions/#dfdlxleftshiftvalue-shiftcount]
* [{{dfdlx:rightShift(value,
shiftCount)}}|http://localhost:4000/dfdl-extensions/#dfdlxrightshiftvalue-shiftcount]
* [{{dfdlx:doubleFromRawLong(longArg)}}
|http://localhost:4000/dfdl-extensions/#dfdlxdoublefromrawlonglongarg-and-dfdlxdoubletorawlongdoublearg]
*
[{{dfdlx:doubleToRawLong(doubleArg)}}|http://localhost:4000/dfdl-extensions/#dfdlxdoublefromrawlonglongarg-and-dfdlxdoubletorawlongdoublearg]
Experimental:
* dfdlx:choiceBranchKeyRanges
* Function dfdlx:currentPosition
* dfdlx:runtimeProperties
* Function
[{{daf:error(messageArg)}}|http://localhost:4000/dfdl-extensions/#daferrormessagearg]
- is deprecated since fn:error(..) now is supported.
> create LTS DFDL-extension documentation on daffodil-site
> --------------------------------------------------------
>
> Key: DAFFODIL-3044
> URL: https://issues.apache.org/jira/browse/DAFFODIL-3044
> Project: Daffodil
> Issue Type: Improvement
> Components: Documentation, Website
> Affects Versions: 4.0.0
> Reporter: Mike Beckerle
> Assignee: Mike Beckerle
> Priority: Major
> Fix For: 4.1.0
>
>
>
> Because Daffodil's extensions to the DFDL language are in wide use now, and
> because the DFDL OGF/ISO workgroup progress for approving and accepting these
> extensions is too slow, we need to provide LTS documentation of these
> features.
> We also need to more clearly differentiate LTS features from experimental
> features which we document only on the Confluence site.
> In addition, some people using daffodil do development on secure networks not
> connected to the internet, so having this LTS features documentation
> available in a downloadable PDF, not just a site page, is needed.
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
