8361730: The CodeBuilder.trying(BlockCodeBuilder,CatchBuilder) method generates corrupted bytecode in certain cases

Reviewed-by: asotona

Author: liach

src/java.base/share/classes/java/lang/classfile/CodeBuilder.java

@@ -175,6 +175,11 @@ default CodeBuilder transforming(CodeTransform transform, Consumer<CodeBuilder>
      * A builder for blocks of code.  Its {@link #startLabel()} and {@link
      * #endLabel()} do not enclose the entire method body, but from the start to
      * the end of the block.
+     * <p>
+     * The location where a block of code merges back to its parent block, as
+     * represented by the {@link #breakLabel()}, is expected to be reachable,
+     * either from this block or the parent block.  The built code may be
+     * malformed if there is no executable code at that location.
      *
      * @since 24
      */