# Feature request / RFC: Improve the documentation for paragraph Object Libraries
**URL:** https://discourse.cmake.org/t/feature-request-rfc-improve-the-documentation-for-paragraph-object-libraries/9062
**Category:** Development
**Created:** [September 23, 2023, 3:17pm UTC](https://discourse.cmake.org/t/feature-request-rfc-improve-the-documentation-for-paragraph-object-libraries/9062 "2023-09-23T15:17:24Z")
**Posts on this page:** 3
**Page:** 1
### Author:  [@mihi32](https://discourse.cmake.org/u/mihi32)
#### Post date: [September 23, 2023, 3:17pm UTC](https://discourse.cmake.org/t/feature-request-rfc-improve-the-documentation-for-paragraph-object-libraries/9062/1 "2023-09-23T15:17:24Z")
Object Libraries
add\_library( OBJECT […])
Creates an Object Library. An object library compiles source files but does not archive or link their object files into a library. Instead other targets created by `add_library` or [`add_executable()`] may reference the objects using an expression of the form [`$`] as a source, where `objlib` is the object library name.
I wan to change
… may reference the **objects** using …
into
… may reference the **object library** using …
As a C++ developer, I associate the word “objects” with object files like codec.obj, mixer.obj and filter.obj, not with with the object libraries.
Is my understanding of the documentation correct?
Where should I send these suggestions?
---
### Author:  [@craig.scott](https://discourse.cmake.org/u/craig.scott)
#### Post date: [September 23, 2023, 7:04pm UTC](https://discourse.cmake.org/t/feature-request-rfc-improve-the-documentation-for-paragraph-object-libraries/9062/2 "2023-09-23T19:04:56Z")
The documentation is correct in this case.
> [@mihi32](#):
>
> I wan to change
> … may reference the **objects** using …
> into
> … may reference the **object library** using …
> As a C++ developer, I associate the word “objects” with object files like codec.obj, mixer.obj and filter.obj, not with with the object libraries.
The expression `$` does literally paste in the set of object files. The prose says “…targets… may reference the objects using an expression of the form [`$`] as a source…”, which is quite literally what it is doing. If you changed the wording to say “…reference the **object library** …”, some might misinterpret that to also bringing across transitive dependencies, but you only get that behavior if you link to the object library. The distinction is subtle, but the existing wording is more correct than your proposed change.
---
### Author:  [@mihi32](https://discourse.cmake.org/u/mihi32)
#### Post date: [September 23, 2023, 7:27pm UTC](https://discourse.cmake.org/t/feature-request-rfc-improve-the-documentation-for-paragraph-object-libraries/9062/3 "2023-09-23T19:27:01Z")
Thank you for the detailed explanation.
I’ll have to explore the documentation more carefully.