Review Request for 8039440: Tidy warnings cleanup for org/omg

Lance Andersen lance.andersen at oracle.com
Tue Apr 7 17:48:26 UTC 2015


Hi Alexander,

InTypeCode.java you might want to use {@code} vs <code> so that you do not have to use > < 

Otherwise it is OK

Best
Lance
On Apr 7, 2015, at 1:00 PM, alexander stepanov <alexander.v.stepanov at oracle.com> wrote:

> Hello Roger,
> 
> Thank you for the notes, fixed:
> http://cr.openjdk.java.net/~avstepan/8039440/webrev.01/src/java.corba/share/classes/org/omg/CORBA/portable/package.html.udiff.html
> http://cr.openjdk.java.net/~avstepan/8039440/webrev.01/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java.udiff.html
> http://cr.openjdk.java.net/~avstepan/8039440/webrev.01/src/java.corba/share/classes/org/omg/CORBA/TypeCode.java.udiff.html
> 
> Regards,
> Alexander
> 
> On 07.04.2015 18:20, Roger Riggs wrote:
>> Hi,
>> 
>> Just a few minor comments;  no need for another webrev (on my account).
>> 
>> The preferred form for code markup is {@code } instead of <code>... </code>
>> and <tt>... </tt> but that may beyond the scope of the current issue.
>> 
>> - Lowercase markup <p> is preferred over uppercase <P> but per file conventions should be consistent.
>> 
>> +++ new/src/java.corba/share/classes/org/omg/CORBA/portable/package.html 2015-04-07 16:41:12.299150361 +0400
>> 
>> -<li>Delegate
>> +<li><*code*>Delegate</*code*>
>> 
>> (RR) Why is this list element in code, the others are not.
>> 
>> +++ new/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java 2015-04-07 16:41:09.883150470 +0400
>> @@ -32,7 +32,7 @@
>> /**
>>  * The Holder for <tt>Short</tt>.  For more information on
>>  * Holder files, see <a href="doc-files/generatedfiles.html#holder">
>> - * "Generated Files: Holder Files"</a>.<P
>> + * "Generated Files: Holder Files"</a>.*<P>*
>> 
>> (RR) <p> should be on a new line; before the paragraph it separates
>> 
>> +++ new/src/java.corba/share/classes/org/omg/CORBA/TypeCode.java 2015-04-07 16:41:10.567150439 +0400
>> 
>> @@ -164,9 +164,9 @@
>>  *
>>  * Java IDL extends the CORBA specification to allow all operations permitted
>>  * on a <code>struct</code> <code>TypeCode</code> to be permitted
>> - * on an <code>exception</code> <code>TypeCode</code> as well. <p>
>> - *
>> + * on an <code>exception</code> <code>TypeCode</code> as well.
>>  */
>> +
>> public abstract class TypeCode implements IDLEntity {
>> 
>> (RR) There should not be blank line between comment and class definition.
>> 
>> 
>> Thanks, Roger
>> 
>> 
>> On 4/7/2015 10:40 AM, alexander stepanov wrote:
>>> Hello,
>>> 
>>> I'm not if the mail list is correct, but could anyone please review the following fix?
>>> http://cr.openjdk.java.net/~avstepan/8039440/webrev.01/
>>> 
>>> Bug: https://bugs.openjdk.java.net/browse/JDK-8039440
>>> 
>>> Just an HTML markup fix for CORBA.
>>> 
>>> Thanks,
>>> Alexander
>>> 
>> 
> 



Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
Lance.Andersen at oracle.com






More information about the core-libs-dev mailing list