(#22938) test and document symbolic file modes
Merge branch 'djmitche-bug22938'

* djmitche-bug22938:
  (#22938) test and document symbolic file modes

Closes GH-2016