2013/6/18 10:02 -0700, [email protected]: > On 6/18/2013 12:49 AM, alexey zhebel wrote: >> We are moving to a new process for generating man pages. I checked in >> the two that changed for 7u40 (java and jcmd): >> http://cr.openjdk.java.net/~azhebel/8016767/ >> >> Please review. >> >> Note that the copyright/license information format was approved by >> Donald Smith who worked with legal. > > On that final point, under the proposed change, the copyright line and > the start of the license are not contiguous. There are a number of > intervening lines: > > 3 .\" Arch: generic > 4 .\" Software: JDK 7 > 5 .\" Date: 6 August 2013 > 6 .\" SectDesc: Basic Tools > 7 .\" Title: java.1 > > The convention for basically every other file with a copyright and > license statement under source code control in the OpenJDK repositories > is that the copyright + license must be at the top of the file and be > contiguous. > > From an engineering perspective, I think it is neither necessary nor > desirable to grant to an exception to this rule for man pages even if it > is acceptable to Don.
Agreed. Please retain the existing format of the legal notices in the man-page sources. - Mark
