mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-10-05 22:02:55 +01:00
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.
This commit is contained in:
@@ -2103,6 +2103,11 @@ to coordinate to avoid name conflicts, but not across packages.
|
||||
|
||||
### 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:
|
||||
|
||||
- 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
|
||||
file contributes to the default package. No other package may import from
|
||||
the default package.
|
||||
|
||||
- If the library keyword is not specified, as in `package Geometry api;`, this
|
||||
file contributes to the default library.
|
||||
|
||||
- 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
|
||||
and smaller examples. No other library can import this library even from
|
||||
@@ -2145,6 +2152,10 @@ default package.
|
||||
|
||||
### 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
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user