Repository: ant Updated Branches: refs/heads/master 7b29e8ff8 -> 6b576f1e8
Based on feedback, added self to contributors, added line to WHATSNEW, added Ant version to docs, and replaced GPL man pages with BSD-licensed man pages. Project: http://git-wip-us.apache.org/repos/asf/ant/repo Commit: http://git-wip-us.apache.org/repos/asf/ant/commit/a621bcbc Tree: http://git-wip-us.apache.org/repos/asf/ant/tree/a621bcbc Diff: http://git-wip-us.apache.org/repos/asf/ant/diff/a621bcbc Branch: refs/heads/master Commit: a621bcbccece69fcbb18aba496d6fb8830609e6f Parents: 343dff9 Author: VGR <[email protected]> Authored: Wed Dec 12 19:02:57 2018 -0500 Committer: Stefan Bodewig <[email protected]> Committed: Sat Dec 15 17:13:58 2018 +0100 ---------------------------------------------------------------------- CONTRIBUTORS | 1 + WHATSNEW | 2 + contributors.xml | 4 + manual/Tasks/jmod.html | 2 + manual/Tasks/link.html | 2 + src/etc/testcases/taskdefs/jmod.xml | 785 ++++++++++++++----- src/etc/testcases/taskdefs/link.xml | 308 ++++++-- .../apache/tools/ant/taskdefs/modules/Jmod.java | 2 + .../apache/tools/ant/taskdefs/modules/Link.java | 2 + .../ant/taskdefs/modules/package-info.java | 2 + .../apache/tools/ant/types/ModuleVersion.java | 2 + 11 files changed, 864 insertions(+), 248 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/CONTRIBUTORS ---------------------------------------------------------------------- diff --git a/CONTRIBUTORS b/CONTRIBUTORS index c6338ef..c9a3f08 100644 --- a/CONTRIBUTORS +++ b/CONTRIBUTORS @@ -76,6 +76,7 @@ Costin Manolache Craeg Strong Craig Cottingham Craig R. McClanahan +Craig Pell Craig Richardson Craig Ryan Craig Sandvik http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/WHATSNEW ---------------------------------------------------------------------- diff --git a/WHATSNEW b/WHATSNEW index d07846d..e67b256 100644 --- a/WHATSNEW +++ b/WHATSNEW @@ -82,6 +82,8 @@ Other changes: loading resources at runtime in Java 9+ runtime environments. Bugzilla Report 62952 + * Added jmod and link tasks, to support jmod and jlink tools of JDK 9+. + Changes from Ant 1.10.4 TO Ant 1.10.5 ===================================== http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/contributors.xml ---------------------------------------------------------------------- diff --git a/contributors.xml b/contributors.xml index c56bd24..960f2db 100644 --- a/contributors.xml +++ b/contributors.xml @@ -331,6 +331,10 @@ </name> <name> <first>Craig</first> + <last>Pell</last> + </name> + <name> + <first>Craig</first> <middle>R.</middle> <last>McClanahan</last> </name> http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/manual/Tasks/jmod.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/jmod.html b/manual/Tasks/jmod.html index 0540918..5c8e09d 100644 --- a/manual/Tasks/jmod.html +++ b/manual/Tasks/jmod.html @@ -25,6 +25,8 @@ <body> <h2 id="jmod">Jmod</h2> +<p><em>Since Apache Ant 1.10.6</em></p> + <h3>Description</h3> <p>Creates a linkable jmod file from a modular jar file, and optionally from other application files such as native libraries and license documents. http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/manual/Tasks/link.html ---------------------------------------------------------------------- diff --git a/manual/Tasks/link.html b/manual/Tasks/link.html index 078acc1..59646cb 100644 --- a/manual/Tasks/link.html +++ b/manual/Tasks/link.html @@ -25,6 +25,8 @@ <body> <h2 id="link">Link</h2> +<p><em>Since Apache Ant 1.10.6</em></p> + <h3>Description</h3> <p>Assembles jmod files into an executable image. Equivalent to the JDK's <a href="https://docs.oracle.com/en/java/javase/11/tools/jlink.html";>jlink</a> http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/src/etc/testcases/taskdefs/jmod.xml ---------------------------------------------------------------------- diff --git a/src/etc/testcases/taskdefs/jmod.xml b/src/etc/testcases/taskdefs/jmod.xml index 2a22998..6143040 100644 --- a/src/etc/testcases/taskdefs/jmod.xml +++ b/src/etc/testcases/taskdefs/jmod.xml @@ -642,43 +642,134 @@ limitations under the License. <property name="man1" value="${manpages}/man1.1"/> <echo file="${man1}"><!-- ---><![CDATA[.TH TRUE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -true \- do nothing, successfully -.SH SYNOPSIS -.B true -[\fI\,ignored command line arguments\/\fR] -.br -.B true -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here -.PP -Exit with a status code indicating success. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit -.PP -NOTE: your shell may have its own version of true, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report true translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +--><![CDATA[.TH "CHFN" "1" "05/17/2017" "shadow\-utils 4\&.4" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +chfn \- change real user name and information +.SH "SYNOPSIS" +.HP \w'\fBchfn\fR\ 'u +\fBchfn\fR [\fIoptions\fR] [\fILOGIN\fR] +.SH "DESCRIPTION" +.PP +The +\fBchfn\fR +command changes user fullname, office room number, office phone number, and home phone number information for a user\*(Aqs account\&. This information is typically printed by +\fBfinger\fR(1) +and similar programs\&. A normal user may only change the fields for her own account, subject to the restrictions in +/etc/login\&.defs\&. (The default configuration is to prevent users from changing their fullname\&.) The superuser may change any field for any account\&. Additionally, only the superuser may use the +\fB\-o\fR +option to change the undefined portions of the GECOS field\&. +.PP +These fields must not contain any colons\&. Except for the +\fIother\fR +field, they should not contain any comma or equal sign\&. It is also recommended to avoid non\-US\-ASCII characters, but this is only enforced for the phone numbers\&. The +\fIother\fR +field is used to store accounting information used by other applications\&. +.SH "OPTIONS" +.PP +The options which apply to the +\fBchfn\fR +command are: +.PP +\fB\-f\fR, \fB\-\-full\-name\fR\ \&\fIFULL_NAME\fR +.RS 4 +Change the user\*(Aqs full name\&. +.RE +.PP +\fB\-h\fR, \fB\-\-home\-phone\fR\ \&\fIHOME_PHONE\fR +.RS 4 +Change the user\*(Aqs home phone number\&. +.RE +.PP +\fB\-o\fR, \fB\-\-other\fR\ \&\fIOTHER\fR +.RS 4 +Change the user\*(Aqs other GECOS information\&. This field is used to store accounting information used by other applications, and can be changed only by a superuser\&. +.RE +.PP +\fB\-r\fR, \fB\-\-room\fR\ \&\fIROOM_NUMBER\fR +.RS 4 +Change the user\*(Aqs room number\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-u\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-w\fR, \fB\-\-work\-phone\fR\ \&\fIWORK_PHONE\fR +.RS 4 +Change the user\*(Aqs office phone number\&. +.RE +.PP +If none of the options are selected, +\fBchfn\fR +operates in an interactive fashion, prompting the user with the current values for all of the fields\&. Enter the new value to change the field, or leave the line blank to use the current value\&. The current value is displayed between a pair of +\fB[ ]\fR +marks\&. Without options, +\fBchfn\fR +prompts for the current user account\&. +.SH "CONFIGURATION" +.PP +The following configuration variables in +/etc/login\&.defs +change the behavior of this tool: +.PP +\fBCHFN_RESTRICT\fR (string) +.RS 4 +This parameter specifies which values in the +\fIgecos\fR +field of the +/etc/passwd +file may be changed by regular users using the +\fBchfn\fR +program\&. It can be any combination of letters +\fIf\fR, +\fIr\fR, +\fIw\fR, +\fIh\fR, for Full name, Room number, Work phone, and Home phone, respectively\&. For backward compatibility, +\fIyes\fR +is equivalent to +\fIrwh\fR +and +\fIno\fR +is equivalent to +\fIfrwh\fR\&. If not specified, only the superuser can make any changes\&. The most restrictive setting is better achieved by not installing +\fBchfn\fR +SUID\&. +.RE +.SH "FILES" +.PP +/etc/login\&.defs +.RS 4 +Shadow password suite configuration\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/true> +.PP +\fBchsh\fR(1), +\fBlogin.defs\fR(5), +\fBpasswd\fR(5)\&. ]]><!-- --></echo> @@ -692,43 +783,124 @@ Full documentation at: <http://www.gnu.org/software/coreutils/true> <property name="man2" value="${manpages}/man2.1"/> <echo file="${man2}"><!-- ---><![CDATA[.TH FALSE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -false \- do nothing, unsuccessfully -.SH SYNOPSIS -.B false -[\fI\,ignored command line arguments\/\fR] -.br -.B false -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here -.PP -Exit with a status code indicating failure. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit -.PP -NOTE: your shell may have its own version of false, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report false translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +--><![CDATA[.TH "VIPW" "8" "05/17/2017" "shadow\-utils 4\&.4" "System Management Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +vipw, vigr \- edit the password, group, shadow\-password or shadow\-group file +.SH "SYNOPSIS" +.HP \w'\fBvipw\fR\ 'u +\fBvipw\fR [\fIoptions\fR] +.HP \w'\fBvigr\fR\ 'u +\fBvigr\fR [\fIoptions\fR] +.SH "DESCRIPTION" +.PP +The +\fBvipw\fR +and +\fBvigr\fR +commands edits the files +/etc/passwd +and +/etc/group, respectively\&. With the +\fB\-s\fR +flag, they will edit the shadow versions of those files, +/etc/shadow +and +/etc/gshadow, respectively\&. The programs will set the appropriate locks to prevent file corruption\&. When looking for an editor, the programs will first try the environment variable +\fB$VISUAL\fR, then the environment variable +\fB$EDITOR\fR, and finally the default editor, +\fBvi\fR(1)\&. +.SH "OPTIONS" +.PP +The options which apply to the +\fBvipw\fR +and +\fBvigr\fR +commands are: +.PP +\fB\-g\fR, \fB\-\-group\fR +.RS 4 +Edit group database\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-p\fR, \fB\-\-passwd\fR +.RS 4 +Edit passwd database\&. +.RE +.PP +\fB\-q\fR, \fB\-\-quiet\fR +.RS 4 +Quiet mode\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-s\fR, \fB\-\-shadow\fR +.RS 4 +Edit shadow or gshadow database\&. +.RE +.SH "ENVIRONMENT" +.PP +\fBVISUAL\fR +.RS 4 +Editor to be used\&. +.RE +.PP +\fBEDITOR\fR +.RS 4 +Editor to be used if +\fBVISUAL\fR +is not set\&. +.RE +.SH "FILES" +.PP +/etc/group +.RS 4 +Group account information\&. +.RE +.PP +/etc/gshadow +.RS 4 +Secure group account information\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE +.PP +/etc/shadow +.RS 4 +Secure user account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/false> +.PP +\fBvi\fR(1), +\fBgroup\fR(5), +\fBgshadow\fR(5) +, +\fBpasswd\fR(5), , +\fBshadow\fR(5)\&. ]]><!-- --></echo> @@ -747,43 +919,124 @@ Full documentation at: <http://www.gnu.org/software/coreutils/false> <property name="man3" value="${manpages}/man3.1"/> <echo file="${man3}"><!-- ---><![CDATA[.TH FALSE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -false \- do nothing, unsuccessfully -.SH SYNOPSIS -.B false -[\fI\,ignored command line arguments\/\fR] -.br -.B false -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here -.PP -Exit with a status code indicating failure. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit -.PP -NOTE: your shell may have its own version of false, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report false translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +--><![CDATA[.TH "VIPW" "8" "05/17/2017" "shadow\-utils 4\&.4" "System Management Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +vipw, vigr \- edit the password, group, shadow\-password or shadow\-group file +.SH "SYNOPSIS" +.HP \w'\fBvipw\fR\ 'u +\fBvipw\fR [\fIoptions\fR] +.HP \w'\fBvigr\fR\ 'u +\fBvigr\fR [\fIoptions\fR] +.SH "DESCRIPTION" +.PP +The +\fBvipw\fR +and +\fBvigr\fR +commands edits the files +/etc/passwd +and +/etc/group, respectively\&. With the +\fB\-s\fR +flag, they will edit the shadow versions of those files, +/etc/shadow +and +/etc/gshadow, respectively\&. The programs will set the appropriate locks to prevent file corruption\&. When looking for an editor, the programs will first try the environment variable +\fB$VISUAL\fR, then the environment variable +\fB$EDITOR\fR, and finally the default editor, +\fBvi\fR(1)\&. +.SH "OPTIONS" +.PP +The options which apply to the +\fBvipw\fR +and +\fBvigr\fR +commands are: +.PP +\fB\-g\fR, \fB\-\-group\fR +.RS 4 +Edit group database\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-p\fR, \fB\-\-passwd\fR +.RS 4 +Edit passwd database\&. +.RE +.PP +\fB\-q\fR, \fB\-\-quiet\fR +.RS 4 +Quiet mode\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-s\fR, \fB\-\-shadow\fR +.RS 4 +Edit shadow or gshadow database\&. +.RE +.SH "ENVIRONMENT" +.PP +\fBVISUAL\fR +.RS 4 +Editor to be used\&. +.RE +.PP +\fBEDITOR\fR +.RS 4 +Editor to be used if +\fBVISUAL\fR +is not set\&. +.RE +.SH "FILES" +.PP +/etc/group +.RS 4 +Group account information\&. +.RE +.PP +/etc/gshadow +.RS 4 +Secure group account information\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE +.PP +/etc/shadow +.RS 4 +Secure user account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/false> +.PP +\fBvi\fR(1), +\fBgroup\fR(5), +\fBgshadow\fR(5) +, +\fBpasswd\fR(5), , +\fBshadow\fR(5)\&. ]]><!-- --></echo> @@ -804,83 +1057,255 @@ Full documentation at: <http://www.gnu.org/software/coreutils/false> <property name="man5" value="${manpages5}/man5.1"/> <echo file="${man4}"><!-- ---><![CDATA[.TH TRUE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -true \- do nothing, successfully -.SH SYNOPSIS -.B true -[\fI\,ignored command line arguments\/\fR] -.br -.B true -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here -.PP -Exit with a status code indicating success. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit -.PP -NOTE: your shell may have its own version of true, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report true translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +--><![CDATA[.TH "CHFN" "1" "05/17/2017" "shadow\-utils 4\&.4" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +chfn \- change real user name and information +.SH "SYNOPSIS" +.HP \w'\fBchfn\fR\ 'u +\fBchfn\fR [\fIoptions\fR] [\fILOGIN\fR] +.SH "DESCRIPTION" +.PP +The +\fBchfn\fR +command changes user fullname, office room number, office phone number, and home phone number information for a user\*(Aqs account\&. This information is typically printed by +\fBfinger\fR(1) +and similar programs\&. A normal user may only change the fields for her own account, subject to the restrictions in +/etc/login\&.defs\&. (The default configuration is to prevent users from changing their fullname\&.) The superuser may change any field for any account\&. Additionally, only the superuser may use the +\fB\-o\fR +option to change the undefined portions of the GECOS field\&. +.PP +These fields must not contain any colons\&. Except for the +\fIother\fR +field, they should not contain any comma or equal sign\&. It is also recommended to avoid non\-US\-ASCII characters, but this is only enforced for the phone numbers\&. The +\fIother\fR +field is used to store accounting information used by other applications\&. +.SH "OPTIONS" +.PP +The options which apply to the +\fBchfn\fR +command are: +.PP +\fB\-f\fR, \fB\-\-full\-name\fR\ \&\fIFULL_NAME\fR +.RS 4 +Change the user\*(Aqs full name\&. +.RE +.PP +\fB\-h\fR, \fB\-\-home\-phone\fR\ \&\fIHOME_PHONE\fR +.RS 4 +Change the user\*(Aqs home phone number\&. +.RE +.PP +\fB\-o\fR, \fB\-\-other\fR\ \&\fIOTHER\fR +.RS 4 +Change the user\*(Aqs other GECOS information\&. This field is used to store accounting information used by other applications, and can be changed only by a superuser\&. +.RE +.PP +\fB\-r\fR, \fB\-\-room\fR\ \&\fIROOM_NUMBER\fR +.RS 4 +Change the user\*(Aqs room number\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-u\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-w\fR, \fB\-\-work\-phone\fR\ \&\fIWORK_PHONE\fR +.RS 4 +Change the user\*(Aqs office phone number\&. +.RE +.PP +If none of the options are selected, +\fBchfn\fR +operates in an interactive fashion, prompting the user with the current values for all of the fields\&. Enter the new value to change the field, or leave the line blank to use the current value\&. The current value is displayed between a pair of +\fB[ ]\fR +marks\&. Without options, +\fBchfn\fR +prompts for the current user account\&. +.SH "CONFIGURATION" +.PP +The following configuration variables in +/etc/login\&.defs +change the behavior of this tool: +.PP +\fBCHFN_RESTRICT\fR (string) +.RS 4 +This parameter specifies which values in the +\fIgecos\fR +field of the +/etc/passwd +file may be changed by regular users using the +\fBchfn\fR +program\&. It can be any combination of letters +\fIf\fR, +\fIr\fR, +\fIw\fR, +\fIh\fR, for Full name, Room number, Work phone, and Home phone, respectively\&. For backward compatibility, +\fIyes\fR +is equivalent to +\fIrwh\fR +and +\fIno\fR +is equivalent to +\fIfrwh\fR\&. If not specified, only the superuser can make any changes\&. The most restrictive setting is better achieved by not installing +\fBchfn\fR +SUID\&. +.RE +.SH "FILES" +.PP +/etc/login\&.defs +.RS 4 +Shadow password suite configuration\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/true> +.PP +\fBchsh\fR(1), +\fBlogin.defs\fR(5), +\fBpasswd\fR(5)\&. ]]><!-- --></echo> <echo file="${man5}"><!-- ---><![CDATA[.TH FALSE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -false \- do nothing, unsuccessfully -.SH SYNOPSIS -.B false -[\fI\,ignored command line arguments\/\fR] -.br -.B false -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here -.PP -Exit with a status code indicating failure. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit -.PP -NOTE: your shell may have its own version of false, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report false translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +--><![CDATA[.TH "VIPW" "8" "05/17/2017" "shadow\-utils 4\&.4" "System Management Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +vipw, vigr \- edit the password, group, shadow\-password or shadow\-group file +.SH "SYNOPSIS" +.HP \w'\fBvipw\fR\ 'u +\fBvipw\fR [\fIoptions\fR] +.HP \w'\fBvigr\fR\ 'u +\fBvigr\fR [\fIoptions\fR] +.SH "DESCRIPTION" +.PP +The +\fBvipw\fR +and +\fBvigr\fR +commands edits the files +/etc/passwd +and +/etc/group, respectively\&. With the +\fB\-s\fR +flag, they will edit the shadow versions of those files, +/etc/shadow +and +/etc/gshadow, respectively\&. The programs will set the appropriate locks to prevent file corruption\&. When looking for an editor, the programs will first try the environment variable +\fB$VISUAL\fR, then the environment variable +\fB$EDITOR\fR, and finally the default editor, +\fBvi\fR(1)\&. +.SH "OPTIONS" +.PP +The options which apply to the +\fBvipw\fR +and +\fBvigr\fR +commands are: +.PP +\fB\-g\fR, \fB\-\-group\fR +.RS 4 +Edit group database\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-p\fR, \fB\-\-passwd\fR +.RS 4 +Edit passwd database\&. +.RE +.PP +\fB\-q\fR, \fB\-\-quiet\fR +.RS 4 +Quiet mode\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-s\fR, \fB\-\-shadow\fR +.RS 4 +Edit shadow or gshadow database\&. +.RE +.SH "ENVIRONMENT" +.PP +\fBVISUAL\fR +.RS 4 +Editor to be used\&. +.RE +.PP +\fBEDITOR\fR +.RS 4 +Editor to be used if +\fBVISUAL\fR +is not set\&. +.RE +.SH "FILES" +.PP +/etc/group +.RS 4 +Group account information\&. +.RE +.PP +/etc/gshadow +.RS 4 +Secure group account information\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE +.PP +/etc/shadow +.RS 4 +Secure user account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/false> +.PP +\fBvi\fR(1), +\fBgroup\fR(5), +\fBgshadow\fR(5) +, +\fBpasswd\fR(5), , +\fBshadow\fR(5)\&. ]]><!-- --></echo> http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/src/etc/testcases/taskdefs/link.xml ---------------------------------------------------------------------- diff --git a/src/etc/testcases/taskdefs/link.xml b/src/etc/testcases/taskdefs/link.xml index 3212475..e31659e 100644 --- a/src/etc/testcases/taskdefs/link.xml +++ b/src/etc/testcases/taskdefs/link.xml @@ -171,84 +171,256 @@ module ${smile.mod} { <property name="man2" value="${manpages}/man2.1"/> <echo file="${man1}"><!-- ---><![CDATA[.TH TRUE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -true \- do nothing, successfully -.SH SYNOPSIS -.B true -[\fI\,ignored command line arguments\/\fR] -.br -.B true -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here +--><![CDATA[.TH "CHFN" "1" "05/17/2017" "shadow\-utils 4\&.4" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +chfn \- change real user name and information +.SH "SYNOPSIS" +.HP \w'\fBchfn\fR\ 'u +\fBchfn\fR [\fIoptions\fR] [\fILOGIN\fR] +.SH "DESCRIPTION" .PP -Exit with a status code indicating success. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit +The +\fBchfn\fR +command changes user fullname, office room number, office phone number, and home phone number information for a user\*(Aqs account\&. This information is typically printed by +\fBfinger\fR(1) +and similar programs\&. A normal user may only change the fields for her own account, subject to the restrictions in +/etc/login\&.defs\&. (The default configuration is to prevent users from changing their fullname\&.) The superuser may change any field for any account\&. Additionally, only the superuser may use the +\fB\-o\fR +option to change the undefined portions of the GECOS field\&. .PP -NOTE: your shell may have its own version of true, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report true translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +These fields must not contain any colons\&. Except for the +\fIother\fR +field, they should not contain any comma or equal sign\&. It is also recommended to avoid non\-US\-ASCII characters, but this is only enforced for the phone numbers\&. The +\fIother\fR +field is used to store accounting information used by other applications\&. +.SH "OPTIONS" +.PP +The options which apply to the +\fBchfn\fR +command are: +.PP +\fB\-f\fR, \fB\-\-full\-name\fR\ \&\fIFULL_NAME\fR +.RS 4 +Change the user\*(Aqs full name\&. +.RE +.PP +\fB\-h\fR, \fB\-\-home\-phone\fR\ \&\fIHOME_PHONE\fR +.RS 4 +Change the user\*(Aqs home phone number\&. +.RE +.PP +\fB\-o\fR, \fB\-\-other\fR\ \&\fIOTHER\fR +.RS 4 +Change the user\*(Aqs other GECOS information\&. This field is used to store accounting information used by other applications, and can be changed only by a superuser\&. +.RE +.PP +\fB\-r\fR, \fB\-\-room\fR\ \&\fIROOM_NUMBER\fR +.RS 4 +Change the user\*(Aqs room number\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-u\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-w\fR, \fB\-\-work\-phone\fR\ \&\fIWORK_PHONE\fR +.RS 4 +Change the user\*(Aqs office phone number\&. +.RE +.PP +If none of the options are selected, +\fBchfn\fR +operates in an interactive fashion, prompting the user with the current values for all of the fields\&. Enter the new value to change the field, or leave the line blank to use the current value\&. The current value is displayed between a pair of +\fB[ ]\fR +marks\&. Without options, +\fBchfn\fR +prompts for the current user account\&. +.SH "CONFIGURATION" +.PP +The following configuration variables in +/etc/login\&.defs +change the behavior of this tool: +.PP +\fBCHFN_RESTRICT\fR (string) +.RS 4 +This parameter specifies which values in the +\fIgecos\fR +field of the +/etc/passwd +file may be changed by regular users using the +\fBchfn\fR +program\&. It can be any combination of letters +\fIf\fR, +\fIr\fR, +\fIw\fR, +\fIh\fR, for Full name, Room number, Work phone, and Home phone, respectively\&. For backward compatibility, +\fIyes\fR +is equivalent to +\fIrwh\fR +and +\fIno\fR +is equivalent to +\fIfrwh\fR\&. If not specified, only the superuser can make any changes\&. The most restrictive setting is better achieved by not installing +\fBchfn\fR +SUID\&. +.RE +.SH "FILES" +.PP +/etc/login\&.defs +.RS 4 +Shadow password suite configuration\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/true> +.PP +\fBchsh\fR(1), +\fBlogin.defs\fR(5), +\fBpasswd\fR(5)\&. ]]><!-- --></echo> <echo file="${man2}"><!-- ---><![CDATA[.TH FALSE "1" "February 2017" "GNU coreutils 8.26" "User Commands" -.SH NAME -false \- do nothing, unsuccessfully -.SH SYNOPSIS -.B false -[\fI\,ignored command line arguments\/\fR] -.br -.B false -\fI\,OPTION\/\fR -.SH DESCRIPTION -.\" Add any additional description here +--><![CDATA[.TH "VIPW" "8" "05/17/2017" "shadow\-utils 4\&.4" "System Management Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +vipw, vigr \- edit the password, group, shadow\-password or shadow\-group file +.SH "SYNOPSIS" +.HP \w'\fBvipw\fR\ 'u +\fBvipw\fR [\fIoptions\fR] +.HP \w'\fBvigr\fR\ 'u +\fBvigr\fR [\fIoptions\fR] +.SH "DESCRIPTION" .PP -Exit with a status code indicating failure. -.TP -\fB\-\-help\fR -display this help and exit -.TP -\fB\-\-version\fR -output version information and exit +The +\fBvipw\fR +and +\fBvigr\fR +commands edits the files +/etc/passwd +and +/etc/group, respectively\&. With the +\fB\-s\fR +flag, they will edit the shadow versions of those files, +/etc/shadow +and +/etc/gshadow, respectively\&. The programs will set the appropriate locks to prevent file corruption\&. When looking for an editor, the programs will first try the environment variable +\fB$VISUAL\fR, then the environment variable +\fB$EDITOR\fR, and finally the default editor, +\fBvi\fR(1)\&. +.SH "OPTIONS" .PP -NOTE: your shell may have its own version of false, which usually supersedes -the version described here. Please refer to your shell's documentation -for details about the options it supports. -.SH AUTHOR -Written by Jim Meyering. -.SH "REPORTING BUGS" -GNU coreutils online help: <http://www.gnu.org/software/coreutils/> -.br -Report false translation bugs to <http://translationproject.org/team/> -.SH COPYRIGHT -Copyright \(co 2016 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. -.br -This is free software: you are free to change and redistribute it. -There is NO WARRANTY, to the extent permitted by law. +The options which apply to the +\fBvipw\fR +and +\fBvigr\fR +commands are: +.PP +\fB\-g\fR, \fB\-\-group\fR +.RS 4 +Edit group database\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Display help message and exit\&. +.RE +.PP +\fB\-p\fR, \fB\-\-passwd\fR +.RS 4 +Edit passwd database\&. +.RE +.PP +\fB\-q\fR, \fB\-\-quiet\fR +.RS 4 +Quiet mode\&. +.RE +.PP +\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR +.RS 4 +Apply changes in the +\fICHROOT_DIR\fR +directory and use the configuration files from the +\fICHROOT_DIR\fR +directory\&. +.RE +.PP +\fB\-s\fR, \fB\-\-shadow\fR +.RS 4 +Edit shadow or gshadow database\&. +.RE +.SH "ENVIRONMENT" +.PP +\fBVISUAL\fR +.RS 4 +Editor to be used\&. +.RE +.PP +\fBEDITOR\fR +.RS 4 +Editor to be used if +\fBVISUAL\fR +is not set\&. +.RE +.SH "FILES" +.PP +/etc/group +.RS 4 +Group account information\&. +.RE +.PP +/etc/gshadow +.RS 4 +Secure group account information\&. +.RE +.PP +/etc/passwd +.RS 4 +User account information\&. +.RE +.PP +/etc/shadow +.RS 4 +Secure user account information\&. +.RE .SH "SEE ALSO" -Full documentation at: <http://www.gnu.org/software/coreutils/false> +.PP +\fBvi\fR(1), +\fBgroup\fR(5), +\fBgshadow\fR(5) +, +\fBpasswd\fR(5), , +\fBshadow\fR(5)\&. ]]><!-- --></echo> </target> http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/src/main/org/apache/tools/ant/taskdefs/modules/Jmod.java ---------------------------------------------------------------------- diff --git a/src/main/org/apache/tools/ant/taskdefs/modules/Jmod.java b/src/main/org/apache/tools/ant/taskdefs/modules/Jmod.java index 2284ed3..dfbf3e2 100644 --- a/src/main/org/apache/tools/ant/taskdefs/modules/Jmod.java +++ b/src/main/org/apache/tools/ant/taskdefs/modules/Jmod.java @@ -150,6 +150,8 @@ import org.apache.tools.ant.types.resources.Union; * </dl> * <p> * destFile and classpath are required data. + * + * @since 1.10.6 */ public class Jmod extends Task { http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/src/main/org/apache/tools/ant/taskdefs/modules/Link.java ---------------------------------------------------------------------- diff --git a/src/main/org/apache/tools/ant/taskdefs/modules/Link.java b/src/main/org/apache/tools/ant/taskdefs/modules/Link.java index 36fd281..343b867 100644 --- a/src/main/org/apache/tools/ant/taskdefs/modules/Link.java +++ b/src/main/org/apache/tools/ant/taskdefs/modules/Link.java @@ -230,6 +230,8 @@ import org.apache.tools.ant.util.ResourceUtils; * </dl> * * @see <a href="https://docs.oracle.com/en/java/javase/11/tools/jlink.html";><code>jlink</code> tool reference</a> + * + * @since 1.10.6 */ public class Link extends Task { http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/src/main/org/apache/tools/ant/taskdefs/modules/package-info.java ---------------------------------------------------------------------- diff --git a/src/main/org/apache/tools/ant/taskdefs/modules/package-info.java b/src/main/org/apache/tools/ant/taskdefs/modules/package-info.java index 99b11e5..d944317 100644 --- a/src/main/org/apache/tools/ant/taskdefs/modules/package-info.java +++ b/src/main/org/apache/tools/ant/taskdefs/modules/package-info.java @@ -19,5 +19,7 @@ /** * Tasks for dealing with Java modules, which are supported starting with * Java 9. + * + * @since 1.10.6 */ package org.apache.tools.ant.taskdefs.modules; http://git-wip-us.apache.org/repos/asf/ant/blob/a621bcbc/src/main/org/apache/tools/ant/types/ModuleVersion.java ---------------------------------------------------------------------- diff --git a/src/main/org/apache/tools/ant/types/ModuleVersion.java b/src/main/org/apache/tools/ant/types/ModuleVersion.java index 0a43420..551b959 100644 --- a/src/main/org/apache/tools/ant/types/ModuleVersion.java +++ b/src/main/org/apache/tools/ant/types/ModuleVersion.java @@ -24,6 +24,8 @@ import java.util.Objects; * Element describing the parts of a Java * <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/module/ModuleDescriptor.Version.html";>module version</a>. * The version number is required; all other parts are optional. + * + * @since 1.10.6 */ public class ModuleVersion { /** Module version's required <em>version number</em>. */
