(#22938) test and document symbolic file modes

No code changes, just some new tests.

I'm not sure that the way I've defined a resource with a symbolic mode is best - let me know if you've got a different idea.