title: Escape characters and @code tag in doc comments
body: <p>I am trying to put the following line</p>
  
  <pre><code>{@code object.foo()} is equivalent to {@code Bar.foo(object.baz())}.
  </code></pre>
  
  <p>inside a javadoc comment. IntelliJ tells me that the left bracket after <code>baz</code> is an illegal character, and I can get rid of the warning by writing</p>
  
  <pre><code>{@code object.foo()} is equivalent to {@code Bar.foo&amp;#40;object.baz())}.
  </code></pre>
  
  <p>instead. The left bracket I replaced by <code>&amp;#40;</code> is not the one that gave the warning. This works, but I don't understand why only one of the left brackets in the line causes a problem. Why is this? When do I have to write <code>&amp;#40;</code> instead of <code>(</code>?</p>