Re: [jdk17] RFR: JDK-8270872: Final nroff manpage update for JDK 17

2021-08-05 Thread Mark Reinhold
On Thu, 5 Aug 2021 21:40:40 GMT, Naoto Sato wrote: >> According to the comments in the makefile >> (`closed/make/UpdateOpenManPages.gmk`) the copyright line is taken from the >> original Markdown file, so if the year is wrong there, it will be wrong in >> the generated nroff file. >> >> I thi

Re: [jdk17] RFR: JDK-8270872: Final nroff manpage update for JDK 17

2021-08-05 Thread Mark Reinhold
On Thu, 5 Aug 2021 19:20:50 GMT, Jonathan Gibbons wrote: > Please review a semi-automatic update of the nroff man pages from the > upstream files. Marked as reviewed by mr (Lead). - PR: https://git.openjdk.java.net/jdk17/pull/303

New candidate JEP: 413: Code Snippets in Java API Documentation

2021-04-28 Thread mark . reinhold
https://openjdk.java.net/jeps/413 Summary: Introduce an @snippet tag for JavaDoc's Standard Doclet, to simplify the inclusion of example source code in API documentation. - Mark

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread mark . reinhold
2018/6/4 15:54:34 -0700, marti...@google.com: > TIL about Canonical link element and 301 redirects. You get to decide > whether to follow the joint advice of Google and Microsoft > https://en.wikipedia.org/wiki/HTTP_301#Search_engines Sure, a 301 would be preferable, but it’s not always easy to a

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread mark . reinhold
2018/6/4 14:17:47 -0700, Martin Buchholz : > On Mon, Jun 4, 2018 at 2:11 PM, jonathan.gibb...@oracle.com wrote: >> ... >> >> So, what are our options. >> >> 0. Do nothing. People, and search engines, will learn to use a URL >> ending in "api/" or "api/index.html" >> >> 1. Back out the change.

JEP 221: Simplified Doclet API

2014-10-30 Thread mark . reinhold
New JEP Candidate: http://openjdk.java.net/jeps/221 - Mark

JEP 172: DocLint

2012-12-04 Thread mark . reinhold
Posted: http://openjdk.java.net/jeps/172 - Mark