From c32a56fc69602db954d4bdf0e986037fab6f0951 Mon Sep 17 00:00:00 2001
From: Matthias Baesken <mbaesken@openjdk.org>
Date: Tue, 30 Jul 2024 13:29:56 +0000
Subject: [PATCH] 8331077: nroff man page update for jar tool

Reviewed-by: rschmelter
Backport-of: c21672d8c94da6aa613174744ceaa945ca2a474a
---
 src/jdk.jartool/share/man/jar.1 | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/jdk.jartool/share/man/jar.1 b/src/jdk.jartool/share/man/jar.1
index c0edcd46910..0e0c58bf426 100644
--- a/src/jdk.jartool/share/man/jar.1
+++ b/src/jdk.jartool/share/man/jar.1
@@ -196,7 +196,8 @@ Specifies the location of module dependence for generating the hash.
 .RE
 .TP
 .B \f[CB]\@\f[R]\f[I]file\f[R]
-Reads \f[CB]jar\f[R] options and file names from a text file.
+Reads \f[CB]jar\f[R] options and file names from a text file as if they
+were supplied on the command line
 .RS
 .RE
 .SH OPERATION MODIFIERS VALID ONLY IN CREATE, UPDATE, AND
@@ -339,8 +340,15 @@ class files from the file \f[CB]classes.list\f[R].
 To shorten or simplify the \f[CB]jar\f[R] command, you can specify
 arguments in a separate text file and pass it to the \f[CB]jar\f[R]
 command with the at sign (\f[CB]\@\f[R]) as a prefix.
+
+To shorten or simplify the \f[CB]jar\f[R] command, you can provide an arg
+file that lists the files to include in the JAR file and pass it to the
+\f[CB]jar\f[R] command with the at sign (\f[CB]\@\f[R]) as a prefix.
 .RS
 .PP
 \f[CB]jar\ \-\-create\ \-\-file\ my.jar\ \@classes.list\f[R]
 .RE
+.PP
+If one or more entries in the arg file cannot be found then the jar
+command fails without creating the JAR file.
 .RE
-- 
GitLab