--- old/src/jdk.compiler/share/man/serialver.1 2019-05-31 13:31:58.009376540 -0700 +++ new/src/jdk.compiler/share/man/serialver.1 2019-05-31 13:31:57.745376549 -0700 @@ -1,5 +1,4 @@ -'\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. +.\" Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" .\" This code is free software; you can redistribute it and/or modify it @@ -20,88 +19,66 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.\" Arch: generic -.\" Software: JDK 8 -.\" Date: 21 November 2013 -.\" SectDesc: Remote Method Invocation (RMI) Tools -.\" Title: serialver.1 -.\" -.if n .pl 99999 -.TH serialver 1 "21 November 2013" "JDK 8" "Remote Method Invocation (RMI) Tools" -.\" ----------------------------------------------------------------- -.\" * Define some portability stuff -.\" ----------------------------------------------------------------- -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" http://bugs.debian.org/507673 -.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- - -.SH NAME -serialver \- Returns the serial version UID for specified classes\&. -.SH SYNOPSIS -.sp -.nf - -\fBserialver\fR [ \fIoptions\fR ] [ \fIclassnames\fR ] -.fi -.sp -.TP -\fIoptions\fR -The command-line options\&. See Options\&. -.TP -\fIclassnames\fR -The classes for which the \f3serialVersionUID\fR is to be returned\&. -.SH DESCRIPTION -The \f3serialver\fR command returns the \f3serialVersionUID\fR for one or more classes in a form suitable for copying into an evolving class\&. When called with no arguments, the \f3serialver\fR command prints a usage line\&. -.SH OPTIONS +.\" Automatically generated by Pandoc 2.3.1 +.\" +.TH "SERIALVER" "1" "2018" "JDK 13" "JDK Commands" +.hy +.SH NAME +.PP +serialver \- return the \f[CB]serialVersionUID\f[R] for one or more +classes in a form suitable for copying into an evolving class +.SH SYNOPSIS +.PP +\f[CB]serialver\f[R] [\f[I]options\f[R]] [\f[I]classnames\f[R]] +.TP +.B \f[I]options\f[R] +This represents the command\-line options for the \f[CB]serialver\f[R] +command. +See \f[B]Options for serialver\f[R]. +.RS +.RE .TP --classpath \fIpath-files\fR -.br -Sets the search path for application classes and resources\&. Separate classes and resources with a colon (:)\&. +.B \f[I]classnames\f[R] +The classes for which \f[CB]serialVersionUID\f[R] is to be returned. +.RS +.RE +.SH DESCRIPTION +.PP +The \f[CB]serialver\f[R] command returns the \f[CB]serialVersionUID\f[R] for +one or more classes in a form suitable for copying into an evolving +class. +When called with no arguments, the \f[CB]serialver\f[R] command prints a +usage line. +.SH OPTIONS FOR SERIALVER .TP --show -.br -Displays a simple user interface\&. Enter the full class name and press either the \fIEnter\fR key or the \fIShow\fR button to display the \f3serialVersionUID\fR\&. +.B \f[CB]\-classpath\f[R] \f[I]path\-files\f[R] +Sets the search path for application classes and resources. +Separate classes and resources with a colon (:). +.RS +.RE .TP --J\fIoption\fR -.br -Passes \f3option\fR to the Java Virtual Machine, where option is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&. -.SH NOTES -The \f3serialver\fR command loads and initializes the specified classes in its virtual machine, and by default, it does not set a security manager\&. If the \f3serialver\fR command is to be run with untrusted classes, then a security manager can be set with the following option: -.sp -.nf -\f3\-J\-Djava\&.security\&.manager\fP -.fi -.nf -\f3\fP -.fi -.sp -When necessary, a security policy can be specified with the following option: -.sp -.nf -\f3\-J\-Djava\&.security\&.policy=\fP -.fi -.nf -\f3\fP -.fi -.sp -.SH SEE\ ALSO -.TP 0.2i -\(bu -The \f3java\&.io\&.ObjectStream\fR class description at http://docs\&.oracle\&.com/javase/8/docs/api/java/io/ObjectStreamClass\&.html -.RE -.br -'pl 8.5i -'bp +.B \f[CB]\-J\f[R]\f[I]option\f[R] +Passes the specified \f[I]option\f[R] to the Java Virtual Machine, where +\f[I]option\f[R] is one of the options described on the reference page +for the Java application launcher. +For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB. +.RS +.RE +.SH NOTES +.PP +The \f[CB]serialver\f[R] command loads and initializes the specified +classes in its virtual machine, and by default, it doesn\[aq]t set a +security manager. +If the \f[CB]serialver\f[R] command is to be run with untrusted classes, +then a security manager can be set with the following option: +.RS +.PP +\f[CB]\-J\-Djava.security.manager\f[R] +.RE +.PP +When necessary, a security policy can be specified with the following +option: +.RS +.PP +\f[CB]\-J\-Djava.security.policy=\f[R]\f[I]policy_file\f[R] +.RE