On Wed, 22 Apr 2026 16:45:27 GMT, Kevin Rushforth <[email protected]> wrote:
>> Andy Goryachev has updated the pull request with a new target base due to a >> merge or a rebase. The pull request now contains 173 commits: >> >> - review comments >> - Merge branch 'master' into 8356042.ruler >> - add exports >> - whitespace >> - test >> - doc >> - change listener >> - Merge branch 'master' into 8356042.ruler >> - new document >> - file >> - ... and 163 more: https://git.openjdk.org/jfx/compare/e735e23a...1ca1af96 > > doc-files/controls/RichTextArea/RichTextArea_DataFormat_v2.md line 50: > >> 48: >> 49: >> 50: ## Description > > Should this format be part of the JavaFX API specification? If so, we will > eventually need a normative definition that is part of the javadoc-generated > API docs. > > Related to this, you might consider defining the syntax and grammar of this > file in some standardized way (e.g., BNF), especially if this becomes part of > the specification. This is a good question! Should it be documented as a part of `RichTextModel` javadoc, or similarly to the way `cssref.html` (inheriting all its formatting and maintenance shortcomings)? BNF is a good idea too, albeit I'd rather postpone it until the moment we decide to add this incubating feature to the core. ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/1800#discussion_r3126828160
