Wrapping a $(ref:...) in <code></code> outputs broken links and style

[rdcronin]

Check out bluetoothSocket.CreateInfo, which is generated from this file. The description in the file is:

    // The ID of the newly created socket. Note that socket IDs created
    // from this API are not compatible with socket IDs created from other APIs,
    // such as the <code>$(ref:sockets.tcp)</code> API.

Wrapping the $(ref:sockets.tcp) in <code> tags results in broken output in the server.

We should either a) remove all instances of tags wrapping $(refs) and add a warning or b) have the output handle it appropriately.

[jpmedley]

@rdcronin Thanks for letting us know.

[jpmedley]

I'm reviving this. For reasons related to a years worth of cleanup and more that's coming, this could start to stand out soon.