docstrings.lisp, texinfo macros, plus &whole and &environment
Bug #543935 reported by
mon_key
This bug affects 1 person
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
SBCL |
Won't Fix
|
Low
|
Douglas Katzman |
Bug Description
missing texinfo macros for `&whole' and `&environment
The texinfo macros in the auto-generated file:
/doc/manual/
for the `@&' do not generate for `&whole' and `&environment' e.g.
,----
| @macro &whole
| &whole
| @end macro
|
| @macro &environment
| &environment
| @end macro
`----
While this may not be a bug if/when these do not appear in SBCL docstrings their
provision in docstrings.lisp would benefit third party tools (such as
alexandria) wich rely on sb-texinfo's docdumping utilities.
/s_P\
To post a comment you must log in.
sbcl.texinfo is not autogenerated, but rather a part of the manually maintained connective tissue.
Also, &whole and &environment should not appear in documentation at all as they are not part of the interface: their presence in the lambda-list should not matter to the user. If anything, docstrings.lisp should make sure not to have them in its output at all. :)
Additionally, it would be good if docstrings.lisp did spit out an ifnottex.texinfo include instead of forcing it to be copy-pasted everywhere.