bug#5267: 23.1; doc string of defstruct

bug#5267: 23.1; doc string of defstruct

[Drew Adams]

Doc string says:

"(defstruct (NAME OPTIONS...) (SLOT SLOT-OPTS...)...)"

That's not correct (not complete):
 (NAME OPTIONS...) can also be just NAME.
 (SLOT SLOT-OPTS...) can also be just SLOT.

Also, the rest of the doc string is not understandable:

"This macro defines a new Lisp data type called NAME, which contains data
stored in SLOTs.  This defines a `make-NAME' constructor, a `copy-NAME'
copier, a `NAME-p' predicate, and setf-able `NAME-SLOT' accessors."

NAME and SLOT are not described before this paragraph, and they are
not adequately described by the (incorrect) syntax description.
"Stored in SLOTs" should be "Stored in slots" (cannot substitute for
the parameter name to get anything that makes sense).  And what a slot
is needs to be explained a bit (minimal description).


In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600)
 of 2009-07-29 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4)'

bug#5267: 23.1; doc string of defstruct

[Chong Yidong]

> Doc string says:
>
> "(defstruct (NAME OPTIONS...) (SLOT SLOT-OPTS...)...)"
>
> That's not correct (not complete):
>  (NAME OPTIONS...) can also be just NAME.
>  (SLOT SLOT-OPTS...) can also be just SLOT.
>
> Also, the rest of the doc string is not understandable:

I have tweaked the docstring to make it more understandable.  Thanks.