Summary
Define uninterned symbols in the manual
Metadata
- Id: 27ccef484d34203b90a349c5fea6caa00b35af98
- Trac id: 908
- Type: enhancement
- Reporter: iraikov
- Owner: felix
- Cc:
- Status: closed
- Component: documentation
- Estimated difficulty:
- Resolution: fixed
- Priority: minor
- Milestone: 4.9.0
- Version: 4.8.x
- Changetime: 2012-09-24 21:47:48 UTC
- Created: 2012-08-27 02:58:38 UTC
- Keywords:
Attachments
- 27ccef484d34203b90a349c5fea6caa00b35af98/attachments/Unit-library-symbols-section.diff
Description
The Chicken manual lists procedures gensym, string->uninterned-symbol and symbol-append under section "Generating uninterned symbols" but never explains what uninterned symbols are. It would be helpful if somebody who is familiar with the internals of Chicken writes a paragraph or two on what uninterned symbols are and about the implications of their use. Furthermore, although symbol-append is listed under that section, its documentation says that it generates a "new interned symbol", so perhaps it should be moved to a different section.
Changes and comments
[2012-08-27 21:27:45 UTC] felix changed status from new to assigned
[2012-08-27 21:27:45 UTC] felix set owner to felix
[2012-08-30 09:54:00 UTC] felix attached Unit-library-symbols-section.diff (description=#f)
[2012-08-30 09:55:07 UTC] felix wrote:
I have attached a diff to the manual. Is this sufficient, or should it go into more detail?
[2012-08-30 10:12:36 UTC] iraikov wrote:
This looks good. There are a couple of misspellings: "and so mulitple symbols" should become "and so multiple symbols" and "uninterned symbols loose their" should become "uninterned symbols lose their".
Replying to felix: > I have attached a diff to the manual. Is this sufficient, or should it go into more detail?
[2012-08-30 11:52:25 UTC] felix changed status from assigned to closed
[2012-08-30 11:52:25 UTC] felix set resolution to fixed
[2012-08-30 11:52:25 UTC] felix wrote:
Thanks. I have fixed the typos and pushed the diff into master.
[2012-09-24 21:47:48 UTC] felix wrote:
Milestone 4.8.0 deleted