Update Ch14

This commit is contained in:
Unisko PENG 2023-04-23 17:29:08 +08:00
parent beb9dbbbd7
commit 77ec6d6333

View File

@ -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` 函数更易于找到。