title: Should I @Deprecate a Superclass Method?
body: <p>Let's say I'm extending <code>JFileChooser</code> and making an easy-to-use version, which I'm calling <code>SimpleFileChooser</code>.</p>
  
  <p>It is structured such that it can either be <code>DIALOG_TYPE_OPEN</code> or <code>DIALOG_TYPE_SAVE</code> — hence, <code>JFileChooser</code>'s <code>showOpenDialog()</code> and <code>showSaveDialog()</code> methods are superfluous. I replace them with a method called <code>showDialog()</code> which returns a boolean, but this is where I find myself in a dilemma:</p>
  
  <blockquote>
    <p>Should I override the open/save methods and add <code>@Deprecated</code> tags to
    them so that the API user knows they've been superseded? Would that
    violate the annotation's <a href="http://docs.oracle.com/javase/1.5.0/docs/guide/javadoc/deprecation/deprecation.html#what" rel="nofollow">original purpose</a>?</p>
    
    <p>Or would a notice in the documentation be enough? If so, where should
    this notice be placed: in the class summary or above the overridden
    methods? Should I even override the methods in the first place?</p>
  </blockquote>
  
  <p>Thanks in advance.</p>