docs(path-uri): clarify host path conversion

This commit is contained in:
Adam Perry
2026-07-10 01:43:28 +00:00
parent 721120a968
commit fb9e9b82e5

View File

@@ -83,9 +83,10 @@ impl LegacyAppPathString {
/// Parses this API string as an absolute path native to the current host.
///
/// Use this for legacy app or wire path text that must be validated as
/// native to the current host. Constructing [`AbsolutePathBuf`] directly
/// can misclassify foreign-platform spelling as a local path.
/// Use this when legacy app or wire path text denotes a file on the
/// coordinator host and a host-only filesystem API needs an
/// [`AbsolutePathBuf`]. Constructing [`AbsolutePathBuf`] directly can
/// misclassify foreign-platform spelling as a local path.
///
/// Host-specific path namespaces are normalized. Relative and
/// foreign-platform paths are rejected.