The following convenience constructors should be added:

  PrintWriter(File file)
  PrintWriter(File file, String csn)
  PrintStream(File file)
  PrintWriter(File file, String csn)
  Formatter(File file)
  Formatter(File file, String csn)
  Formatter(File file, String csn, Locale l)
  Formatter(OutputStream os)
  Formatter(OutputStream, String csn)
  Formatter(OutputStream, String csn, Locale l)

These constructors are parallel to those which take a String fileName (e.g.
PrintStream(String fileName), Formatter(String fileName, String csn, Locale l),
etc.).

The existing specification for the fileName constructors need to be modified
as follows:
  - the output is buffered (currently it states that it is not).
  - the text for @throws FileNotFoundException should be modified to be more
    consistent with the changes applied for 4722178
  - in Print{Stream,Writer}(String) remove reference to the "specified" charset
    and "this formatter"
  - remove duplicate documentation for SecurityException
  - in Formatter(String), remove all references to UnsupportedEncodingException
    (the default encoding should always be supported)

-- iag@sfbay 2004-01-27