docs: let go of &ast;

Since we are no longer using sgml mode, using /&ast; &ast;/ to
escape block comments inside examples does not work anymore.
Switch to using line comments with //
docs: Remove some unneeded decorations

@var is not expanded inside literal `` blocks.
Just remove those @ characters.
docs: Remove a few trailing <literal>s