Will Java ever allow comments to nest?

Roger Riggs Roger.Riggs at oracle.com
Wed Jul 22 14:02:14 UTC 2020


It looks a lot like the quotes within quotes problem that has existed in 
shells forever and
was addressed in text blocks with a different outer delimiter.

The kind of encoding below "*/" is error prone and makes the 
developer encode the real intent.
There's got to be a better way, even if it takes a new kind of doc 
comment delimiter for the outer.
It will be a bigger change for javac and javadoc but makes it possible 
to redefine/reinterpret the delimiters.
Maybe you can do something with:

          * ...

Regards, Roger

On 7/7/20 6:40 AM, Johannes Kuhn wrote:
> This is a source incompatible change.
> It would break /* inside comments:
>     /**
>      * Determines whether or not the tokenizer recognizes C-style 
> comments.
>      * If the flag argument is {@code true}, this stream tokenizer
>      * recognizes C-style comments. All text between successive
>      * occurrences of {@code /*} and <code>*/</code> are discarded.
>      * <p>
>      * If the flag argument is {@code false}, then C-style comments
>      * are not treated specially.
>      *
>      * @param   flag   {@code true} indicates to recognize and ignore
>      *                 C-style comments.
>      */
> That's the javadoc of StreamTokenizer.slashStarComments(boolean).
> With your proposed change, the javadoc comment would not be closed at 
> the end.
> - Johannes

More information about the discuss mailing list