Ver código fonte

Modify `package` in the README.md to mark unreviewed ideas as provisional. (#2324)

I've filed #2323 to track the design idea for `package`, and #2001 already tracked `import`, but these should be explicitly marked as provisional.
Jon Ross-Perkins 3 anos atrás
pai
commit
4601a9cce8
1 arquivos alterados com 11 adições e 0 exclusões
  1. 11 0
      docs/design/README.md

+ 11 - 0
docs/design/README.md

@@ -2103,6 +2103,11 @@ to coordinate to avoid name conflicts, but not across packages.
 
 
 ### Package declaration
 ### Package declaration
 
 
+> **Note:** This is provisional, designs for a default package, making the
+> package name optional, and omitting the `package` declaration have not been
+> through the proposal process yet. See
+> [#2323](https://github.com/carbon-language/carbon-lang/issues/2323).
+
 Files start with an optional package declaration, consisting of:
 Files start with an optional package declaration, consisting of:
 
 
 -   the `package` keyword introducer,
 -   the `package` keyword introducer,
@@ -2125,8 +2130,10 @@ Parts of this declaration may be omitted:
 -   If the package name is omitted, as in `package library "Main" api;`, the
 -   If the package name is omitted, as in `package library "Main" api;`, the
     file contributes to the default package. No other package may import from
     file contributes to the default package. No other package may import from
     the default package.
     the default package.
+
 -   If the library keyword is not specified, as in `package Geometry api;`, this
 -   If the library keyword is not specified, as in `package Geometry api;`, this
     file contributes to the default library.
     file contributes to the default library.
+
 -   If a file has no package declaration at all, it is the `api` file belonging
 -   If a file has no package declaration at all, it is the `api` file belonging
     to the default package and default library. This is particularly for tests
     to the default package and default library. This is particularly for tests
     and smaller examples. No other library can import this library even from
     and smaller examples. No other library can import this library even from
@@ -2145,6 +2152,10 @@ default package.
 
 
 ### Imports
 ### Imports
 
 
+> **Note:** This is provisional, designs for making the package name optional
+> have not been through the proposal process yet. See
+> [#2001](https://github.com/carbon-language/carbon-lang/issues/2001).
+
 After the package declaration, files may include `import` declarations. These
 After the package declaration, files may include `import` declarations. These
 include the package name and optionally `library` followed by the library name.
 include the package name and optionally `library` followed by the library name.
 If the library is omitted, the default library for that package is imported.
 If the library is omitted, the default library for that package is imported.