COMP: Re-apply change 87cc4c63 to eliminate warnings.

The file lex.yy.c is generated by lex, and was manually changed
to avoid some clang -Wdocumentation warnings.  This commit re-applies
those changes.

Change-Id: I97becf33a870c7ae2fe02dc9475c0f9e62668243
Merge topic 'doc-warnings' into master

5253f73c COMP: Re-apply change 87cc4c63 to eliminate warnings.