tree c60f7dc9a11ac4e1aa68abbfe31b39fa9c521e76
parent 760e66a8d75e7bb5dd19b1b2f607b7d48a449fe6
author Ed Tanous <edtanous@google.com> 1672944452 -0800
committer Patrick Williams <patrick@stwcx.xyz> 1672973648 +0000

Fix a bunch of docstrings

Clang correctly notes that a bunch of our docstrings are wrong.  We
don't really use doxygen, but it's useful to be able to run a compiler
without warnings.  The failures fall into a couple categories.

First, when using variadic templates, the type is the variable name (ie
T), not including variadic expansion. (ie T...).  In these cases, the
... is removed from the definition.

Templatized structs should not use the @struct keyword.  They are a
template as far as doxygen is concerned, so remove the keyword.

A number of functions docstrings are just wrong in terms of argument
names, or whether or not they have return types.

Signed-off-by: Ed Tanous <edtanous@google.com>
Change-Id: Iab6f76b422a9568b7ad19d3f725a9c1b870784d9