Update text surrounding objc2::foundation

Author: madsmtm

README.md

@@ -12,9 +12,8 @@ appreciated!
 ## Crate overview
 
 The core crate is [`objc2`], which contains everything you need to interface
-with Objective-C. We use it in [`objc2-foundation`] to provide a safe
-abstraction over some core objects from the Foundation Framework, since these
-are used in almost all other Objective-C frameworks.
+with Objective-C. It also provides safe abstraction over (parts of) the
+Foundation Framework, since that is used in almost all Objective-C code.
 
 [`block2`] has a bit of a weird position in all of this: Apple's C language
 extension of blocks is _technically_ not limited to being used in Objective-C,
@@ -27,7 +26,6 @@ separate crate to help people cutting down on unneeded dependencies.
 runtime libraries.
 
 [`objc2`]: ./objc2
-[`objc2-foundation`]: ./objc2-foundation
 [`block2`]: ./block2
 [`objc2-encode`]: ./objc2-encode
 [`objc-sys`]: ./objc-sys
@@ -126,21 +124,27 @@ Work is in progress to make it dual-licensed under the Apache License
 
 ## Acknowledgements
 
-This repository is originally a fork of [`objc`] (hence the name `objc2`),
-with the following projects merged into it (see reasoning for the fork
-[here][origin-issue-101]):
+This repository is a merge of the following projects, see reasoning for the
+fork [here][origin-issue-101]:
+- [`objc`](https://github.com/SSheldon/rust-objc)
+  - Renamed to `objc2`.
 - [`objc-encode`](https://github.com/SSheldon/rust-objc-encode)
+  - Renamed to `objc2-encode`.
 - [`objc_exception`](https://github.com/SSheldon/rust-objc-exception)
+  - Moved to `objc2::exception`.
 - [`objc_id`](https://github.com/SSheldon/rust-objc-id)
+  - Moved to `objc2::rc`.
 - [`objc-foundation`](https://github.com/SSheldon/rust-objc-foundation)
+  - Moved to `objc2::foundation`.
 - [`block`](https://github.com/SSheldon/rust-block)
+  - Renamed to `block2`.
 
 These were created almost solely by [@SSheldon](https://github.com/SSheldon),
 so a huge thanks for their fantastic work on these crates!
 
-This project also draws heavy inspiration from [`fruity`] and [`objrs`].
+This project also draws heavy inspiration from [`fruity`], the [`core-foundation-rs` project] and [`objrs`].
 
-[`objc`]: https://github.com/SSheldon/rust-objc
 [origin-issue-101]: https://github.com/SSheldon/rust-objc/issues/101
 [`fruity`]: https://github.com/nvzqz/fruity
+[`core-foundation-rs` project]: https://github.com/servo/core-foundation-rs
 [`objrs`]: https://gitlab.com/objrs/objrs

objc2/src/foundation/mod.rs

@@ -1,14 +1,10 @@
-//! # Bindings to the Objective-C Cocoa `Foundation` framework
+//! Bindings to the `Foundation` framework.
 //!
-//! The [`std`] equivalent for Objective-C, containing essential data types,
-//! collections, and operating-system services.
+//! This is the [`std`] equivalent for Objective-C, containing essential data
+//! types, collections, and operating-system services.
 //!
 //! See [Apple's documentation](https://developer.apple.com/documentation/foundation?language=objc).
 //!
-//! **NOTICE: This library is very much in progress, consider using the more
-//! battle-tested [`cocoa-foundation`] crate in the meantime.**
-//!
-//! [`cocoa-foundation`]: https://crates.io/crates/cocoa-foundation
 //!
 //! ## Philosophy
 //!
@@ -18,12 +14,13 @@
 //! on conversion methods, to allow easily using them from Rust.
 //!
 //! If you find some API that an object doesn't expose (but should), we gladly
-//! accept [pull requests]. Anyhow, if it is something that is out of scope,
-//! these objects implement the [`objc2::Message`] trait, so you can always
-//! just manually implement call a method using the [`objc2::msg_send!`]
-//! macro.
+//! accept [pull requests]. If it is something that is out of scope, these
+//! objects implement the [`Message`] trait, so you can always just manually
+//! call a method on them using the [`msg_send!`] family of macros.
 //!
 //! [pull requests]: https://github.com/madsmtm/objc2/pulls
+//! [`Message`]: crate::Message
+//! [`msg_send!`]: crate::msg_send
 
 // TODO: Remove these
 #![allow(missing_docs)]

objc2/src/lib.rs

@@ -75,7 +75,7 @@
 //! other type, and this would trigger undefined behaviour!
 //!
 //! Making the ergonomics better is something that is currently being worked
-//! on, see e.g. the [`objc2-foundation`] crate for more ergonomic usage of at
+//! on, the [`objc2::foundation`] module contains more ergonomic usage of at
 //! least parts of the `Foundation` framework.
 //!
 //! Anyhow, all of this `unsafe` nicely leads us to another feature that this
@@ -85,7 +85,6 @@
 //! [`runtime::Object`]: crate::runtime::Object
 //! [`rc::Owned`]: crate::rc::Owned
 //! [`rc::Id`]: crate::rc::Id
-//! [`objc2-foundation`]: https://crates.io/crates/objc2-foundation
 //!
 //!
 //! ## Encodings and message type verification