mirror of
https://github.com/gnu4cn/rust-lang-zh_CN.git
synced 2025-03-27 04:21:37 +08:00
Update Ch14
This commit is contained in:
parent
beb9dbbbd7
commit
77ec6d6333
@ -291,14 +291,14 @@ fn main() {
|
||||
art = { path = "../art" }
|
||||
```
|
||||
|
||||
清单 14-4 中,使用了 `art` 代码箱代码的作者,就必须找出那个 `PrimaryColor` 是在 `kinds` 模组里,以及 `mix` 函数是在 `utils` 模组里。那个 `art` 代码箱的模组结构(即模组树),和要用到该代码箱的开发者相比,与那些在 `art` 代码箱上编写代码的开发者要更为密切。对于那些试图搞清楚怎样使用这个 `art` 代码箱的人来说,他的内部组织结构并未包含任何有用信息,而由于用到他开发者,必须搞明白要在那里去查看,并必须在 `use` 语句中指明那些模组名字,因此他的内部组织结构,反而会造成混乱。
|
||||
清单 14-4 中用到 `art` 代码箱代码的作者,不得不搞清楚 `PrimaryColor` 是在 `kinds` 模组中,及 `mix` 函数是在 `utils` 模组中。`art` 代码箱的模组结构(即模组树),相比于用到该代码箱的开发者,与在 `art` 代码箱上编写代码的开发者要更为密切。对于试图搞清楚怎样使用 `art` 代码箱的人来说,其内部组织结构并未包含任何有用信息,而因为要用到他的开发者,不得不搞明白要在那里去查看,且必须在 `use` 语句中指明那些模组名字,这反而会造成混乱。
|
||||
|
||||
要从公开 API 中消除内部的组织结构,咱们可以将清单 14-3 中那个 `art` 代码箱的代码,修改为在其顶层出添加上一些 `pub use` 语句,来重新导出那些程序项目,如下清单 14-5 中所示:
|
||||
要从公开 API 中移除内部组织结构,咱们可把清单 14-3 中 `art` 代码箱的代码,修改为添加一些 `pub use` 语句,来在顶层处重导出程序项目,to re-export the iems at the top level,如下清单 14-5 中所示:
|
||||
|
||||
文件名:`src/lib.rs`
|
||||
|
||||
```rust
|
||||
//! # 美术
|
||||
//! # art
|
||||
//!
|
||||
//! 建模诸多美术概念的一个库。
|
||||
|
||||
@ -310,7 +310,7 @@ pub mod kinds;
|
||||
pub mod utils;
|
||||
```
|
||||
|
||||
*清单 14-5:添加一些 `pub use` 语句来重新导出程序项目*
|
||||
*清单 14-5:添加 `pub use` 语句来重导出程序项目*
|
||||
|
||||
如下图 14-04 中所示,`cargo doc` 为此代码箱所产生出的 API 文档,现在就会在首页上,列出并链接到那些重导出的程序项目,令到 `PrimaryColor` 与 `SecondaryColor` 两个类型,以及那个 `mix` 函数更易于找到。
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user