[Chapel Merge] Deprecate/replace file methods in `Path`, remove p

[e-kayrakli1]

Branch: refs/heads/main
Revision: 3b3db99
Author: e-kayrakli
Log Message:

Merge pull request #18009 from e-kayrakli/file-functions-in-path

Deprecate/replace file methods in Path, remove previously deprecated ones

This PR mainly

• Implements the proposal in Path-related methods on `file` type · Issue #16748 · chapel-lang/chapel · GitHub,
  which
  • deprecates file.getParentName
  • deprecates file.{relPath,realPath,absPath} in favor of relPath(file),
    realPath(file), absPath(file)
• It removes functions that were deprecated in
  Change some Formal Names in Path Module by Maxrimus · Pull Request #17023 · chapel-lang/chapel · GitHub

It also makes test and doc adjustments for those.

[Reviewed by @lydia-duncan]

Test:

• [x] standard

  Modified Files:
  A test/deprecated/pathFile.chpl
  A test/deprecated/pathFile.good
  R test/deprecated/formalNameChange.chpl
  R test/deprecated/formalNameChange.good
  R test/library/standard/Path/saru/getParentName/parentName.chpl
  R test/library/standard/Path/saru/getParentName/parentName.preexec
  R test/library/standard/Path/saru/getParentName/testFile.txt
  M modules/standard/IO.chpl
  M modules/standard/Path.chpl
  M test/library/standard/Path/dlongnecke/absPath/fileAbsPath.chpl
  M test/library/standard/Path/lydia/realpath/fileNotValid.chpl
  M test/library/standard/Path/lydia/realpath/fileVersion.chpl
  M test/library/standard/Path/lydia/realpath/onFileInDir.chpl
  M test/library/standard/Path/lydia/realpath/resultSameAsFilePath.chpl
  M test/library/standard/Path/relPath/fileRelPath.chpl

  Compare: Comparing 6ec575439c3e...3b3db9935534 · chapel-lang/chapel · GitHub