This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/daffodil-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 95e4ab8 Publishing from 592b244078bce232393a258223e61f37a3cdb5e2
95e4ab8 is described below
commit 95e4ab8a56f3444a365efe4918915dd295c354f2
Author: Apache Daffodil Site Autobuild <[email protected]>
AuthorDate: Thu Jun 6 18:36:55 2024 +0000
Publishing from 592b244078bce232393a258223e61f37a3cdb5e2
---
content/layers/index.html | 14 +-
content/releases/3.8.0/index.html | 411 ++++++++++++++++++++++++++++++++++++++
2 files changed, 424 insertions(+), 1 deletion(-)
diff --git a/content/layers/index.html b/content/layers/index.html
index 16a2099..d116463 100644
--- a/content/layers/index.html
+++ b/content/layers/index.html
@@ -184,7 +184,9 @@ These are:</p>
<li><a href="#fixedlength-layer">fixedLength</a></li>
</ul>
-<p>Each of the built-in layers will be documented separately below with
examples of their usage.</p>
+<p>Each of the built-in layers will be
+<a href="#daffodil-built-in-layer-documentation">documented separately
below</a> with examples of their
+usage.</p>
<h3 id="custom-plug-in-layers">Custom Plug-In Layers</h3>
@@ -572,6 +574,16 @@ base class.</p>
<p>Each of the layers built-in to the Daffodil implementation are documented
in a section below
which gives the name, namespace, variables, and some usage notes.</p>
+<p>The built-in layers are:</p>
+<ul>
+ <li><a href="#base64-mime-layer">base64_MIME</a></li>
+ <li><a href="#byte-swapping-layers">fourbyteswap</a></li>
+ <li><a href="#byte-swapping-layers">twobyteswap</a></li>
+ <li><a href="#gzip-layer">gzip</a></li>
+ <li><a href="#line-folded-layers">lineFolded_IMF</a></li>
+ <li><a href="#line-folded-layers">lineFolded_iCalendar</a></li>
+</ul>
+
<hr />
<h3 id="base64-mime-layer">Base64 MIME Layer</h3>
diff --git a/content/releases/3.8.0/index.html
b/content/releases/3.8.0/index.html
new file mode 100644
index 0000000..207cc1e
--- /dev/null
+++ b/content/releases/3.8.0/index.html
@@ -0,0 +1,411 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <title>Apache Daffodil | 3.8.0</title>
+
+ <meta name="author" content="">
+
+ <!-- Enable responsive viewport -->
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <!-- HTML5 shim, for IE6-8 support of HTML elements -->
+ <!--[if lt IE 9]>
+ <script
src="http://html5shim.googlecode.com/svn/trunk/html5.js";></script>
+ <![endif]-->
+
+ <link href="/assets/themes/apache/bootstrap/css/bootstrap.css"
rel="stylesheet">
+ <link href="/assets/themes/apache/css/style.css?body=1" rel="stylesheet"
type="text/css">
+ <link href="/assets/themes/apache/css/syntax.css" rel="stylesheet"
type="text/css" media="screen" />
+
+ </head>
+
+ <body>
+
+ <div class="navbar navbar-inverse" role="navigation">
+ <div class="container">
+ <div class="navbar-header"><a class="navbar-brand" href="/"><img
src="/assets/themes/apache/img/apache-daffodil-logo.png" alt="Apache
Daffodil"/></a></div>
+ <nav role="navigation">
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="/releases">Releases</a></li>
+ <li id="extensions">
+ <a href="#" data-toggle="dropdown"
class="dropdown-toggle">Extensions<b class="caret"></b></a>
+ <ul class="dropdown-menu dropdown-left">
+ <li><a href="/vscode">VS Code</a></li>
+ <li><a href="/sbt">SBT</a></li>
+ </ul>
+ </li>
+ <li id="documentation">
+ <a href="#" data-toggle="dropdown"
class="dropdown-toggle">Docs<b class="caret"></b></a>
+ <ul class="dropdown-menu dropdown-left">
+ <li><a href="/getting-started/">Getting Started</a></li>
+ <li><a href="/examples/">Examples</a></li>
+ <li><a href="/docs/latest/javadoc/">Java API</a></li>
+ <li><a href="/docs/latest/scaladoc/">Scala API</a></li>
+ <li><a href="/docs/dfdl/">DFDL Specification</a></li>
+ <li><a href="/unsupported/">Unsupported Features</a></li>
+ <li><a href="/faq/">Frequently Asked Questions</a></li>
+ <li><a href="/dfdl-extensions/">Daffodil DFDL Language
Extensions</a></li>
+ </ul>
+ </li>
+ <li id="community">
+ <a href="#" data-toggle="dropdown"
class="dropdown-toggle">Community<b class="caret"></b></a>
+ <ul class="dropdown-menu dropdown-left">
+ <li><a href="/community">Get Involved</a></li>
+ <li><a href="/people">People</a></li>
+ </ul>
+ </li>
+ <li id="development">
+ <a href="#" data-toggle="dropdown"
class="dropdown-toggle">Development<b class="caret"></b></a>
+ <ul class="dropdown-menu dropdown-left">
+ <li><a class="external"
href="https://cwiki.apache.org/confluence/display/DAFFODIL/";>Wiki</a></li>
+ <li><a class="external"
href="https://github.com/apache/?q=daffodil";>GitHub</a></li>
+ <li><a class="external"
href="https://issues.apache.org/jira/projects/DAFFODIL/";>JIRA</a></li>
+ </ul>
+ </li>
+ <li id="apache">
+ <a href="#" data-toggle="dropdown"
class="dropdown-toggle">Apache<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a class="external"
href="https://www.apache.org/";>Foundation</a></li>
+ <li><a class="external"
href="https://www.apache.org/licenses/";>License</a></li>
+ <li><a class="external"
href="https://www.apache.org/events/current-event";>Events</a></li>
+ <li><a class="external"
href="https://www.apache.org/security";>Security</a></li>
+ <li><a class="external"
href="https://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a class="external"
href="https://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a class="external"
href="https://privacy.apache.org/policies/privacy-policy-public.html";>Privacy
Policy</a></li>
+ </ul>
+ </li>
+ </ul>
+ </nav>
+ </div>
+ </div>
+
+
+<div class="title">
+ <div class="container">
+ <h2>Apache Daffodil 3.8.0</h2>
+ </div>
+</div>
+
+
+
+ <div class="container">
+
+ <div class="alert alert-warning">
+ Apache Daffodil 3.8.0 has not yet been released! The artifacts
+ and release notes below are drafts for a proposed release of Apache
+ Daffodil which has not yet occurred.
+ </div>
+
+
+
+
+<div class="row">
+ <div class="col-md-3 text-right" style="float: right; z-index: 3;">
+ <h3>Documentation</h3>
+ <a href="/docs/3.8.0/javadoc/">Javadoc</a> | <a
href="/docs/3.8.0/scaladoc/">Scaladoc</a>
+ </div>
+
+ <div class="col-md-12">
+ <h3>Get Release</h3>
+ <ul class="nav nav-tabs">
+ <li class="active"><a data-toggle="tab"
href="#download">Download</a></li>
+ <li><a data-toggle="tab" href="#maven">Maven</a></li>
+ <li><a data-toggle="tab" href="#sbt">SBT</a></li>
+ <li><a data-toggle="tab" href="#rpm">DNF</a></li>
+ </ul>
+ <div class="tab-content">
+ <div id="download" class="tab-pane fade in active">
+
+ <h4>Source</h4>
+ <p>
+
+
+
+
+
+
+
+
+
+<div class="row">
+ <div class="col-sm-6">
+ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/src/apache-daffodil-3.8.0-src.zip";>apache-daffodil-3.8.0-src.zip</a>
+ </div>
+ <div class="col-sm-6">
+
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/src/apache-daffodil-3.8.0-src.zip.asc";>PGP</a>
]
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/src/apache-daffodil-3.8.0-src.zip.sha512";>SHA512</a>
]
+
+ </div>
+</div>
+
+
+ </p>
+
+
+
+ <h4>Binaries</h4>
+ <p>
+
+
+
+
+
+
+
+
+
+<div class="row">
+ <div class="col-sm-6">
+ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.tgz";>apache-daffodil-3.8.0-bin.tgz</a>
+ </div>
+ <div class="col-sm-6">
+
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.tgz.asc";>PGP</a>
]
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.tgz.sha512";>SHA512</a>
]
+
+ </div>
+</div>
+
+
+<div class="row">
+ <div class="col-sm-6">
+ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.zip";>apache-daffodil-3.8.0-bin.zip</a>
+ </div>
+ <div class="col-sm-6">
+
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.zip.asc";>PGP</a>
]
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.zip.sha512";>SHA512</a>
]
+
+ </div>
+</div>
+
+
+<div class="row">
+ <div class="col-sm-6">
+ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.msi";>apache-daffodil-3.8.0-bin.msi</a>
+ </div>
+ <div class="col-sm-6">
+
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.msi.asc";>PGP</a>
]
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-bin.msi.sha512";>SHA512</a>
]
+
+ </div>
+</div>
+
+
+<div class="row">
+ <div class="col-sm-6">
+ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-1.noarch.rpm";>apache-daffodil-3.8.0-1.noarch.rpm</a>
+ </div>
+ <div class="col-sm-6">
+
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-1.noarch.rpm.asc";>PGP</a>
]
+ [ <a
href="https://dist.apache.org/repos/dist/dev/daffodil/3.8.0-rc1/bin/apache-daffodil-3.8.0-1.noarch.rpm.sha512";>SHA512</a>
]
+
+ </div>
+</div>
+
+
+ </p>
+
+
+
+ <hr />
+ <p>
+ <i>
+ The above release files should be verified using the PGP
signatures and the
+ <a href='https://downloads.apache.org/daffodil/KEYS'>project
release KEYS</a>. See
+ <a
href='https://www.apache.org/info/verification.html'>verification
instructions</a>
+ for a description of using the PGP and KEYS files for
+ verification. A SHA512 checksum is also provided as
+ an alternative verification method.
+ </i>
+ </p>
+
+ </div>
+
+ <div id="maven" class="tab-pane fade">
+
+<figure class="highlight"><pre><code class="language-xml"
data-lang="xml"><span class="nt"><dependency></span>
+ <span class="nt"><groupId></span>org.apache.daffodil<span
class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>daffodil-japi_2.12<span
class="nt"></artifactId></span>
+ <span class="nt"><version></span>3.8.0<span
class="nt"></version></span>
+<span class="nt"></dependency></span></code></pre></figure>
+
+ </div>
+ <div id="sbt" class="tab-pane fade">
+
+<figure class="highlight"><pre><code class="language-scala"
data-lang="scala"><span class="n">libraryDependencies</span> <span
class="o">+=</span> <span class="s">"org.apache.daffodil"</span> <span
class="o">%%</span> <span class="s">"daffodil-sapi"</span> <span
class="o">%</span> <span class="s">"3.8.0"</span></code></pre></figure>
+
+ </div>
+ <div id="rpm" class="tab-pane fade">
+Create the file <code>/etc/yum.repos.d/apache-daffodil.repo</code> with the
following content:
+
+<div style="padding: 10px 15px;">
+
+<figure class="highlight"><pre><code class="language-ini"
data-lang="ini"><span class="nn">[apache-daffodil]</span>
+<span class="py">name</span><span class="p">=</span><span class="s">Apache
Daffodil</span>
+<span class="py">baseurl</span><span class="p">=</span><span
class="s">https://apache.jfrog.io/artifactory/daffodil-rpm/</span>
+<span class="py">enabled</span><span class="p">=</span><span class="s">1</span>
+<span class="py">gpgkey</span><span class="p">=</span><span
class="s">https://downloads.apache.org/daffodil/KEYS</span>
+<span class="py">gpgcheck</span><span class="p">=</span><span
class="s">1</span>
+<span class="py">repo_gpgcheck</span><span class="p">=</span><span
class="s">0</span></code></pre></figure>
+
+</div>
+
+Run the folllowing command:
+
+<div style="padding: 10px 15px;">
+
+<figure class="highlight"><pre><code class="language-text"
data-lang="text">sudo dnf install apache-daffodil</code></pre></figure>
+
+</div>
+ </div>
+ </div>
+ </div>
+</div>
+
+<h3 id="release-notes">Release Notes</h3>
+
+<p>This release focused on providing a supported API for creating Daffodil
Layers.</p>
+
+<h3 id="layers-feature">Layers Feature</h3>
+
+<p>A layer is an algorithmic transformation of the data stream that cannot be
expressed using regular
+DFDL properties.
+Daffodil provides a DFDL language extension using the property name <code
class="language-plaintext highlighter-rouge">dfdlx:layer</code> to invoke
+these layer transformations when parsing or unparsing.
+Layers can encode/decode data as well as can verify/recompute
checksums/CRCs.</p>
+
+<p>See the <a href="/layers">Layers</a> documentation which has links to the
javadoc for the new API as well
+as a description and examples of the <a
href="/layers#built-in-layers">built-in layers</a> that are available
+to use.</p>
+
+<p>This supported API is incompatible with the experimental and unsupported
prior version layering APIs.
+See the <a href="#deprecationcompatibility">Deprecation/Compatibility</a>
section for more
+details.</p>
+
+<h3 id="new-features">New Features</h3>
+
+<ul>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2569";>DAFFODIL-2569</a>] -
document how to write layer transforms</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2903";>DAFFODIL-2903</a>] -
Allow inputValueCalc to apear in a hidden group</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2825";>DAFFODIL-2825</a>] -
Define supported layering API</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2844";>DAFFODIL-2844</a>] -
LayerNotEnoughDataException doesn't propagate Throwable Error</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2845";>DAFFODIL-2845</a>] -
Layer improvements</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2841";>DAFFODIL-2841</a>] -
Layers do not support (or poorly documented) creating SDE or
Parse/UnparseErrors</li>
+</ul>
+
+<h3 id="miscellaneous-bugs">Miscellaneous Bugs</h3>
+
+<ul>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2900";>DAFFODIL-2900</a>] -
enable javadoc and scaladoc for runtime1 api</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2905";>DAFFODIL-2905</a>] -
add error parameter to N-byte-swap layer</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2907";>DAFFODIL-2907</a>] -
Improve documentation for building/testing the release candidate container</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2104";>DAFFODIL-2104</a>] -
TDML runner - throws exception if test has neither <tdml:errors> nor
<tdml:infoset></tdml:infoset></tdml:errors></li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2843";>DAFFODIL-2843</a>] -
Unclear how to create Parse/UnparseError from ParseOrUnparseState</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2883";>DAFFODIL-2883</a>] -
Pre-existing PUA characters in data cause SDE</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2887";>DAFFODIL-2887</a>] -
Choice branch array with discriminator or direct dispatch broken</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2890";>DAFFODIL-2890</a>] -
Set SOURCE_DATE_EPOCH when creating releases</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2891";>DAFFODIL-2891</a>] -
Abort: Invariant broken: minReps.==(0L) when unparsing</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2892";>DAFFODIL-2892</a>] -
JAR file URI processing does not allow for JARs within JARs</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2893";>DAFFODIL-2893</a>] -
Unable to initialise</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2895";>DAFFODIL-2895</a>] -
Runtime SDE in ElementCombinator parser with validation causes "Expression
Evaluation Error: Element does not have a value"</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2897";>DAFFODIL-2897</a>] -
change scalafmt back to rewrite.trailingCommas.style 'never'</li>
+ <li>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2898";>DAFFODIL-2898</a>] -
Compilation error with Java 21, add to CI</li>
+</ul>
+
+<h3 id="deprecationcompatibility">Deprecation/Compatibility</h3>
+
+<p>This release removes the unsupported/experimental APIs for creating layer
plug-ins that were
+present in releases 3.7.0 and prior.
+These are replaced with a new supported and documented API which is
+much easier to use and maintain and has more functionality.
+All layers written to the older 3.7.0 unsupported APIs will be broken and must
be rewritten to
+use the new API in 3.8.0.</p>
+
+<p>See the <a href="/layers">Layers</a> documentation which has links to the
javadoc for the new API.</p>
+
+<p>[<a
href="https://issues.apache.org/jira/browse/DAFFODIL-2825";>DAFFODIL-2825</a>]</p>
+
+<h3 id="dependency-changes">Dependency Changes</h3>
+
+<p>The following dependencies have been added or updated:</p>
+
+<p><strong>Core</strong></p>
+
+<ul>
+ <li>Apache Commons IO 2.16.1 <small>(update)</small></li>
+ <li>FasterXML Jackson Core 2.16.1 <small>(update)</small></li>
+ <li>FasterXML Woodstox Core 6.6.2 <small>(update)</small></li>
+ <li>ICU4J 75.1 <small>(update)</small></li>
+ <li>Scala Parser Combinators 2.4.0 <small>(update)</small></li>
+ <li>Scala XML 2.3.0 <small>(update)</small></li>
+ <li>Typesafe Config 1.4.3 <small>(update)</small></li>
+ <li>XML Resolver 1.2 <small>(update)</small></li>
+</ul>
+
+<p><strong>CLI</strong></p>
+
+<ul>
+ <li>JLine 3.26.1 <small>(update)</small></li>
+</ul>
+
+<p><strong>Code Generator</strong></p>
+
+<ul>
+ <li>OS Lib 0.10.2 <small>(update)</small></li>
+</ul>
+
+<p><strong>Logging</strong></p>
+
+<ul>
+ <li>SLF4J API 2.0.13 <small>(update)</small></li>
+</ul>
+
+<p><strong>Schematron Validator</strong></p>
+
+<ul>
+ <li>Saxon-HE 12.4 <small>(update)</small></li>
+</ul>
+
+<p><strong>Changes to Transitive Dependencies</strong></p>
+
+<ul>
+ <li>Woodstox Stax2 API 4.2.2 <small>(update, used by Woodstox
Core)</small></li>
+ <li>XML Resolver & Data 5.2.2 <small>(update, used by
Saxon-HE)</small></li>
+</ul>
+
+
+ <footer>
+ <footer class="site-footer">
+ <div class="wrapper">
+ <div class="footer-col-wrapper" style="font-size: .85em;">
+ <hr>
+ <div>
+ <div style="text-align: center;">
+ Copyright © 2024 <a href="https://www.apache.org";>The
Apache Software Foundation</a>.
+ Licensed under the <a
href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License, Version
+ 2.0</a>.
+ <br>
+ Apache, Apache Daffodil, Daffodil, and the Apache Daffodil
logo
+ are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </div>
+ </div>
+</footer>
+
+ </footer>
+ </div>
+
+ <script src="/assets/themes/apache/jquery/jquery-2.1.1.min.js"></script>
+
+ <script src="/assets/themes/apache/bootstrap/js/bootstrap.min.js"></script>
+
+
+ </body>
+</html>
+
