The man pages are intended for human and are not meant to be specs. An advanced NLP program is required to parse man pages and infer appropriate types and combinations and I suspect it would not be perfect.

I agree that this might lead to something which is not in Unix spirit but already shell completion provide such information and this shows the need for such specs.