Any way to document a shell alias?

[Marcos Cruz]

I think the Mercurial's help system is great, it even detects and
integrates ordinary aliases with their definitions and all details, but
of course shell aliases are listed with "(no help text available)".

Is there any way to document a shell alias, i.e. to add its description
and usage instructions to the help system?

I guess the only way is to write a Python wrapper to call the shell
script, simulating an actual extension. Has anybody done it and would
like to share an example?

-- 
Marcos Cruz
http://programandala.net