Fix documentation on BitstreamService.replace

Author: ybnd

dspace-api/src/main/java/org/dspace/content/service/BitstreamService.java

@@ -86,9 +86,11 @@ public Bitstream create(Context context, Bundle bundle, InputStream is)
         throws IOException, SQLException, AuthorizeException;
 
     /**
-     * Replaces {@code oldBitstream} with Replaces {@code oldBitstream}.
-     * Copies all metadata from {@code oldBitstream} to {@code oldBitstream}
+     * Replaces {@code oldBitstream} with {@code newBitstream}.
+     * Copies all metadata from {@code oldBitstream} to {@code newBitstream}
      * and sets in the same order in the bundle list.
+     * <br>
+     * The {@code oldBitstream} is deleted, along with any Bitstreams derived from it via {@code filter-media}.
      *
      * @param context the current DSpace context
      * @param oldBitstream the bitstream object we want to replace