Update javadoc

src/jdk.jpackage/share/classes/jdk/jpackage/internal/Package.java

@@ -87,10 +87,16 @@ default StandardPackageType asStandardPackageType() {
 
     Path predefinedAppImage();
 
+    /**
+     * Returns source app image layout.
+     */
     default ApplicationLayout appLayout() {
         return app().appLayout();
     }
 
+    /**
+     * Returns app image layout inside of the package.
+     */
     default ApplicationLayout packageLayout() {
         var layout = appLayout();
         var pathGroup = layout.pathGroup();
@@ -103,6 +109,9 @@ default ApplicationLayout packageLayout() {
         return layout;
     }
 
+    /**
+     * Returns app image layout of the installed package.
+     */
     default ApplicationLayout installedPackageLayout() {
         Path root = relativeInstallDir();
         if (type() instanceof StandardPackageType type) {
@@ -247,7 +256,7 @@ public Path predefinedAppImage() {
         public Path configuredInstallBaseDir() {
             throw new UnsupportedOperationException();
         }
-        
+
     }
 
     static class Proxy<T extends Package> extends ProxyBase<T> implements Package {

src/jdk.jpackage/share/classes/jdk/jpackage/internal/Workshop.java

@@ -33,9 +33,10 @@ interface Workshop {
     Path resourceDir();
 
     /**
-     * Returns path to application image directory. When building app image this is the path to a
-     * directory where it is assembled. When building a package this is the path to the source app
-     * image.
+     * Returns path to application image directory.
+     *
+     * The return value is supposed to be used as a parameter for
+     * ApplicationLayout#resolveAt function.
      */
     default Path appImageDir() {
         return buildRoot().resolve("image");