doc: java links

Author: scivision

+stdlib/+fileio/absolute_path.m

@@ -1,5 +1,5 @@
 function abspath = absolute_path(p)
-
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getAbsolutePath()
 arguments
   p string {mustBeScalarOrEmpty}
 end

+stdlib/+fileio/canonical.m

@@ -1,5 +1,5 @@
 function c = canonical(p)
-
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getCanonicalPath()
 arguments
   p string {mustBeScalarOrEmpty}
 end
@@ -32,8 +32,6 @@
 % REQUIRES path to exist, while java method does not.
 % c = builtin('_canonicalizepath', c);
 
-% https://docs.oracle.com/javase/9/docs/api/java/io/File.html#getCanonicalPath--
-
 c = stdlib.fileio.posix(string(java.io.File(c).getCanonicalPath()));
 
 end % function

+stdlib/+fileio/file_checksum.m

@@ -4,10 +4,10 @@
 %
 % method:  "MD5", "SHA-1", "SHA-256", etc.
 %
-% Reference: https://docs.oracle.com/javase/8/docs/api/java/security/MessageDigest.html
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/MessageDigest.html#getInstance(java.lang.String)
 arguments
-    file (1,1) string {mustBeFile}
-    method (1,1) string {mustBeNonzeroLengthText}
+  file (1,1) string {mustBeFile}
+  method (1,1) string {mustBeNonzeroLengthText}
 end
 
 if any(method == ["sha256", "SHA256"])
@@ -22,10 +22,12 @@
 assert(fid > 0, "could not open " + file)
 
 while ~feof(fid)
+  % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/MessageDigest.html#update(byte)
   inst.update(fread(fid, file_chunk, '*uint8'))
 end
 fclose(fid);
 
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/MessageDigest.html#digest()
 hash = typecast(inst.digest, 'uint8');
 
 hash = string(sprintf('%.2x', hash));

+stdlib/+fileio/homedir.m

@@ -1,5 +1,6 @@
 function home = homedir()
-
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/System.html#getProperty(java.lang.String)
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/System.html#getProperties()
 persistent h;
 
 if ~isempty(h)

+stdlib/+fileio/is_absolute_path.m

@@ -1,5 +1,5 @@
 function isabs = is_absolute_path(apath)
-
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#isAbsolute()
 arguments
   apath string {mustBeScalarOrEmpty}
 end

+stdlib/+fileio/is_exe.m

@@ -1,4 +1,6 @@
 function ok = is_exe(file)
+%% is_exe is file executable
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#canExecute()
 
 arguments
   file string {mustBeScalarOrEmpty}

+stdlib/+fileio/normalize.m

@@ -1,5 +1,6 @@
 function n = normalize(p)
 % normalize(p) remove redundant elements of path p
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Path.html#normalize()
 arguments
   p string {mustBeScalarOrEmpty}
 end
@@ -9,7 +10,6 @@
   return
 end
 
-n = stdlib.fileio.posix(string(...
-    java.io.File(stdlib.fileio.expanduser(n)).toPath().normalize()));
+n = stdlib.fileio.posix(java.io.File(stdlib.fileio.expanduser(n)).toPath().normalize());
 
 end

+stdlib/+fileio/resolve.m

@@ -26,7 +26,7 @@
 % REQUIRES path to exist, while java method does not.
 % c = builtin('_canonicalizepath', c);
 
-% https://docs.oracle.com/javase/9/docs/api/java/io/File.html#getCanonicalPath--
+% % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getCanonicalPath()
 
 c = stdlib.fileio.posix(string(java.io.File(c).getCanonicalPath()));
 

+stdlib/+fileio/samepath.m

@@ -1,5 +1,5 @@
 function issame = samepath(path1, path2)
-
+% https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html#isSameFile(java.nio.file.Path,java.nio.file.Path)
 arguments
   path1 string {mustBeScalarOrEmpty}
   path2 string {mustBeScalarOrEmpty}

+stdlib/+sys/cpu_load.m

@@ -1,13 +1,14 @@
 function L = cpu_load()
 %% CPU_LOAD get total physical CPU load
-% https://docs.oracle.com/javase/9/docs/api/com/sun/management/OperatingSystemMXBean.html#getSystemCpuLoad--
+% https://docs.oracle.com/en/java/javase/21/docs/api/jdk.management/com/sun/management/OperatingSystemMXBean.html#getCpuLoad()
 % Returns the "recent cpu usage" for the whole system.
 % This value is a double in the [0.0,1.0] interval.
 % A value of 0.0 means that all CPUs were idle during the recent period of time observed, while a value of 1.0 means that all CPUs were actively running 100% of the time during the recent period being observed.
 % All values betweens 0.0 and 1.0 are possible depending of the activities going on in the system.
 % If the system recent cpu usage is not available, the method returns a negative value.
 
 b = java.lang.management.ManagementFactory.getOperatingSystemMXBean();
-L = b.getSystemCpuLoad();
+
+L = b.getSystemCpuLoad(); % deprecated, but Matlab R2023b didn't have getCpuLoad() yet
 
 end