Revert r18700, documentation of deprecated functions might be useful for

people trying to update to the new API.

Log of r18700:
Remove documentation from deprecated fields, they should not be used,
thus there is no sense in documenting them.

Originally committed as revision 18708 to svn://svn.ffmpeg.org/ffmpeg/trunk