8283730: Improve discussion of modeling of packages and modules

Reviewed-by: jjg, jlahoda
This commit is contained in:
Joe Darcy 2022-04-05 18:21:54 +00:00
parent 20acea41cc
commit e9e3aa7b82
5 changed files with 94 additions and 15 deletions

View file

@ -135,6 +135,9 @@ import java.io.IOException;
* @since 1.6
*/
public interface Filer {
// Maintenance note: if the ability to create module-info files
// through the Filer is added, add link to this method from
// ModuleElement interface-level discussion.
/**
* Creates a new source file and returns an object to allow
* writing to it. A source file for a class, interface, or a
@ -217,6 +220,9 @@ public interface Filer {
JavaFileObject createSourceFile(CharSequence name,
Element... originatingElements) throws IOException;
// Maintenance note: if the ability to create module-info files
// through the Filer is added, add link to this method from
// ModuleElement interface-level discussion.
/**
* Creates a new class file, and returns an object to allow
* writing to it. A class file for a class, interface, or a package can