I am still working on the Mini-language Reference page:
https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference
but it is taking longer than I expected due to the enormity of the task.
I would like to get some preliminary code changes committed to the
project before the next release branch is created, so I am asking the
developer community for a preliminary review of the reference and the
proposed changes.
Here is what I would like to do before creation of the next release
branch (in sequence):
1. Reformat all Mini-language Java code. This would be a single,
separate commit.
2. Get developer community approval of the "Attribute Types" reference
section, the <set> element section, and the deprecated items marked in red.
3. Remove from the Mini-language Java code all deprecated items that are
marked in red in the reference.
4. Make some small changes to the Java code API in preparation for
future work. The API changes will not change Mini-language behavior in
any way.
5. Update the <set> element Java code and schema to match the reference.
The changes to the <set> element are the most important and they will
have the biggest impact on Mini-language code. The updated <set> element
will still work with existing Mini-language code, but it will issue
warnings about syntax changes. I'm thinking this approach will give
users of the new release branch an opportunity to update their
Mini-language code.
I will continue working on the reference after the release branch is
created and solicit developer community review of the finished draft
before any more work is done.
So, please take a few minutes to review the "Attribute Types" reference
section and the <set> element section and let me know if you see any
problems with them.
-Adrian
