title: Should I write multiple @return tags in javadoc
body: <p>Say I have a java method that returns an array of strings. Inside the method, I have more than one return statements, depending on conditions. </p>
  
  <pre><code>public String[] userLogIn() {
      String[] success = {"You", "are", "the", "king"};
      String[] errorMsg = {"You", "are", "nothing"};
      double ran = Math.random();
      if(ran &lt; 0.33)
          return success;
      else if (ran &lt; 0.66)
          return errorMsg;
      else
          return null;
  }
  </code></pre>
  
  <p>This example might be too naive. But my point is, should/can I use multiple @return tags, like 
  <code>@return this array if condition 1 is met
   @return that array if condition 2 is met
   @return null if condition 3 is met</code>
  ?</p>
  
  <p>I often write one single <code>@return the login message</code> but think this makes less sense when there is a null return.
  Which way is a better coding practice in general?</p>