From martinrb at google.com  Tue May 28 12:14:56 2013
From: martinrb at google.com (Martin Buchholz)
Date: Tue, 28 May 2013 12:14:56 -0700
Subject: man page formatting troubles
Message-ID: <CA+kOe09V0zFEJuOG=EewdxD0_tEJF6mNwQ4aWvMmCN0pW91ccQ@mail.gmail.com>

Hi javadoc folk,

This is a bug report.  On my Ubuntu system, using recent lambda-dev
binaries, I see this:

$ man javadoc > /dev/null
<standard input>:29: warning [p 1, 1.8i]: cannot adjust line
<standard input>:1556: warning [p 20, 10.3i, div `b+', 0.7i]: can't break
line
<standard input>:1556: warning [p 20, 10.3i, div `c+', 0.7i]: can't break
line
<standard input>:1556: warning [p 20, 10.3i, div `d+', 1.0i]: can't break
line
<standard input>:1840: warning [p 21, 14.2i, div `i+', 0.0i]: can't break
line
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20130528/9932e0c8/attachment.html 

From jonathan.gibbons at oracle.com  Tue May 28 13:07:29 2013
From: jonathan.gibbons at oracle.com (Jonathan Gibbons)
Date: Tue, 28 May 2013 13:07:29 -0700
Subject: man page formatting troubles
In-Reply-To: <CA+kOe09V0zFEJuOG=EewdxD0_tEJF6mNwQ4aWvMmCN0pW91ccQ@mail.gmail.com>
References: <CA+kOe09V0zFEJuOG=EewdxD0_tEJF6mNwQ4aWvMmCN0pW91ccQ@mail.gmail.com>
Message-ID: <51A50E81.7020002@oracle.com>

Filed 8015523.

-- Jon

On 05/28/2013 12:14 PM, Martin Buchholz wrote:
> Hi javadoc folk,
>
> This is a bug report.  On my Ubuntu system, using recent lambda-dev 
> binaries, I see this:
>
> $ man javadoc > /dev/null
> <standard input>:29: warning [p 1, 1.8i]: cannot adjust line
> <standard input>:1556: warning [p 20, 10.3i, div `b+', 0.7i]: can't 
> break line
> <standard input>:1556: warning [p 20, 10.3i, div `c+', 0.7i]: can't 
> break line
> <standard input>:1556: warning [p 20, 10.3i, div `d+', 1.0i]: can't 
> break line
> <standard input>:1840: warning [p 21, 14.2i, div `i+', 0.0i]: can't 
> break line


From jonathan.gibbons at oracle.com  Wed May 29 08:05:26 2013
From: jonathan.gibbons at oracle.com (Jonathan Gibbons)
Date: Wed, 29 May 2013 08:05:26 -0700
Subject: JavaDoc and doclint
In-Reply-To: <CAP+Jvx4huDz_X+UYo5aDCBJJcMnmahsvVTHjHDvsMrXAFNLH4g@mail.gmail.com>
References: <CAP+Jvx4huDz_X+UYo5aDCBJJcMnmahsvVTHjHDvsMrXAFNLH4g@mail.gmail.com>
Message-ID: <51A61936.8020305@oracle.com>

On 05/29/2013 12:05 AM, Sven Reimers wrote:
> Hi,
>
> I hope this is the correct place to ask. With ea b91 installed from JDK8 I
> wanted to use the doclint feature. It seems that is is available from javac
> but not from javadoc at the moment, if I look at the help output from javac
> -X vs. javadoc -X.
>
> Hope anyone can clarify.
>
> Thanks
>
> Sven
>

It is a bug that -X does not list doclint.   doclint is available within 
javadoc;
the option is the same as for javac, except that you cannot specify access
modifiers within the option. Instead, doclint will check all doc comments
being included in the generated documentation.

I suggest followups to javadoc-dev.

-- Jon

From jonathan.gibbons at oracle.com  Wed May 29 08:13:07 2013
From: jonathan.gibbons at oracle.com (Jonathan Gibbons)
Date: Wed, 29 May 2013 08:13:07 -0700
Subject: [7604007.v0] 8 request for review
In-Reply-To: <E1Uhcu0-0003AY-00@sa.us.oracle.com>
References: <E1Uhcu0-0003AY-00@sa.us.oracle.com>
Message-ID: <51A61B03.6030006@oracle.com>

The issue number needs to be in the JDK project, not INTJDK.

Please break long lines.   In general, unless there are really
good reasons why you should not do so, try and make lines
less than half a screen width wide, on a typical big screen
(e.g. 1920x1200) in a typical font.

In general, the copyright year on new files should be 2013.

-- Jon


On 05/29/2013 02:42 AM, evgeniya.stepanova at oracle.com wrote:
> Changes made in testProfiles (test/com/sun/javadoc/testProfiles)
> Added testcases to increase patch code coverage. Added test testProfilesConfiguration to launch javadoc with nessesary configuration.
>
> patch code coverage was increased to 7%( from 87 to 94).
> Code coverage reports (old and new) can be found on testplan wikipage.
>
>
> javadoc patch for profiles support: http://hg.openjdk.java.net/jdk8/jdk8/langtools/rev/5f0731e4e5e6
> testplan: http://wiki.se.oracle.com/display/JPG/Langtools+adaptation+to+profiles+testplan
> Bugurl: https://jbs.oracle.com/bugs/browse/INTJDK-7604007
>
>
> ================================
> webrev:
> http://sa.us.oracle.com/projects/langtools_data/8/7604007.0
> mail-archive:
> http://sa.us.oracle.com/mail-archive/7604007
> bug description:
> https://jbs.oracle.com/bugs/browse/JDK-7604007
> bug summary:
> http://sa.us.oracle.com/projects/langtools/bugid_summary.pl?bugid=7604007
> robot documentation:
> http://sa.us.oracle.com/projects/langtools/
>
> To approve this request please reply to all with the word 'approved' added to the subject