GP-4329: Improving javadoc for Program.getExecutablePath()

This commit is contained in:
Ryan Kurtz 2024-06-10 08:09:04 -04:00
parent 195abea7e4
commit d1b0828af9

View file

@ -202,17 +202,19 @@ public interface Program extends DataTypeManagerDomainObject, ProgramArchitectur
public void setPreferredRootNamespaceCategoryPath(String categoryPath); public void setPreferredRootNamespaceCategoryPath(String categoryPath);
/** /**
* Gets the path to the program's executable file. * Gets the path to the program's executable file. For example, {@code /home/user/foo.exe}.
* For example, <code>C:\Temp\test.exe</code>.
* This will allow plugins to execute the program. * This will allow plugins to execute the program.
* * <p>
* NOTE: The format of the path is not guaranteed to follow any standard naming conventions.
* If used for anything other than display purpose, callers of this method should take extra
* steps to ensure the path is in a form suitable for their needs.
*
* @return String path to program's exe file * @return String path to program's exe file
*/ */
public String getExecutablePath(); public String getExecutablePath();
/** /**
* Sets the path to the program's executable file. * Sets the path to the program's executable file. For example, {@code /home/user/foo.exe}.
* For example, <code>C:\Temp\test.exe</code>.
* *
* @param path the path to the program's exe * @param path the path to the program's exe
*/ */