[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#66267: Document cl-print.el in the CL manual.
From: |
Eli Zaretskii |
Subject: |
bug#66267: Document cl-print.el in the CL manual. |
Date: |
Tue, 10 Oct 2023 21:54:23 +0300 |
> Date: Tue, 10 Oct 2023 16:49:29 +0000
> Cc: monnier@iro.umontreal.ca, 66267@debbugs.gnu.org
> From: Alan Mackenzie <acm@muc.de>
>
> > > +should respect @code{print-length}, @code{print-level}, and
> > > +@code{cl-print-string-length}. @var{limit} may be @code{nil} or zero
> > > +in which case @var{print-function} will be called with these settings
> > > +bound to @code{nil}, and it can also be @code{t} in which case
> > > +@var{print-function} will be called with their current values.
> > > +
> > > +Use this function with @code{cl-prin1} to print an object,
> > > +abbreviating it with ellipses to fit within a size limit.
> > ^^^^^^^^
> > "ellipsis"
>
> No. "EllipsEs" is the plural of "ellipsIs".
??? You say "abbreviating it with ellipses". "It" is singular, so it
gets abbreviated with only one ellipsis, not with several ones.
> > > +@code{cl-defgeneric} which is defined for several types of
>
> > Please add here a cross-reference to where cl-defgeneric is described.
>
> There is no documentation for cl-defgeneric and cl-defmethod except,
> perhaps, in their doc strings.
Of course, there is: see "(elisp) Generic Functions".
> > > +You can write @code{cl-print-object} @code{cl-defmethod}s for other
> > > +types of @var{object}, thus extending @code{cl-prin1}. If you write
> > > +such a method which uses ellipses, you should also write a
> > ^^^^^^^^
> > "ellipsis"
>
> See above.
See above.