I’m (slowly) reading through zshexpn and playing with things to learn.  This does not work:

> pedz@MysticSlate my-play-dir % echo /this/is/a/../../path
> /this/is/a/../../path
> pedz@MysticSlate my-play-dir % echo !$:P
> zsh: illegal modifier: P

even if the file specified exists

but this does:

> pedz@MysticSlate my-play-dir % echo /this/is/a/../../path
> /this/is/a/../../path
> pedz@MysticSlate my-play-dir % echo !$:A
> echo /this/path
> /this/path

Is this a documentation bug, code bug, or my misunderstanding?

Thank you,
pedz