Document that AccessFs::WriteFile may also require Truncate

[mrcnski]

Hello, I recently ran into a case where I was trying to use std::fs::write on a file with the AccessFs::WriteFile access right. This doesn't work, because std::fs::write first truncates:

This is a convenience function for using File::create and write_all with fewer imports.

I had only ever used ABI::V1 before, where this isn't an issue. When I tried ABI::V4 this was suddenly breaking.

Suggested Fix

Under AccessFs::WriteFile, document something like:

Certain operations (such as std::fs::write) may also require Truncate since ABI::V3.

If that sounds reasonable, I could do that along with #53 in one PR. :)

[l0kod]

Hello, I recently ran into a case where I was trying to use std::fs::write on a file with the AccessFs::WriteFile access right. This doesn't work, because std::fs::write first truncates:

This is a convenience function for using File::create and write_all with fewer imports.

I had only ever used ABI::V1 before, where this isn't an issue. When I tried ABI::V4 this was suddenly breaking.

Suggested Fix

Under AccessFs::WriteFile, document something like:

Certain operations (such as std::fs::write) may also require Truncate since ABI::V3.

That would be useful.

If that sounds reasonable, I could do that along with #53 in one PR. :)

Yes please!