document a SNAFU

This commit is contained in:
Joey Hess 2025-01-29 19:04:13 -04:00
parent 5738f5194d
commit 94e177db9d
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38

View file

@ -17,15 +17,14 @@ status.
replacing all the RawFilePath with OsPath, which should be pretty replacing all the RawFilePath with OsPath, which should be pretty
mechanical, with only some wrapper functions in Utility.FileIO and mechanical, with only some wrapper functions in Utility.FileIO and
Utility.RawFilePath needing to be changed. Utility.RawFilePath needing to be changed.
* Utility.FileIO is used for most withFile and openFile, but not yet for
readFile, writeFile, and appendFile on FilePaths. An attempt was made on this, which is in the `ospath` branch. It
Note that the FilePath versions do newline translation on windows, is unfinished and doesn't build. Some of the groundwork for that
which has to be handled when converting to the Utility.FileIO ones. culminated in [[!commit aaf4dd3b9cc71752624dd81352c242eeabe912c2]]
* System.Directory.OsPath is available with OsPath build flag, but which builds and passes the test suite... except for on windows, where it
not yet used, and would eliminate a lot of fromRawFilePaths. fails both with and without the new OsPath build flag it added, in
Make Utility.SystemDirectory import it when built with OsPath, different and both surprising and seemingly difficult to understand ways.
and the remaining 6 hours or work will explain itself.. That has caused me to give up on it for now.
This has been started in the `ospath` branch.
[[!tag confirmed]] [[!tag confirmed]]