all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#49785: [DOC] About Lisp Data Types
@ 2021-07-30 18:52 Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
  2021-07-31 11:18 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 3+ messages in thread
From: Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2021-07-30 18:52 UTC (permalink / raw)
  To: 49785

Some expressions about data types are convoluted or could be more
expressive.

[[info:elisp#Some Terms]]

    [...] that convert textual representations of Lisp objects into
    actual Lisp objects, and vice versa.

[[info:elisp#Lisp Data Types]]

    Objects of the same type have similar structures and may usually be
    used in the same contexts.

    [...] the primitive type of each object is implicit in the object
    itself.

    [...] Such type declarations do not exist in Emacs Lisp. A Lisp
    variable can have any type of value, and it remembers whatever value
    you store in it, type and all.

I would have phrased it differently.

“The representation of a Lisp program is fundamental. At a high level,
the operation of the program is represented by its components. At a low
level, a Lisp program is a collection of routines which process data
found in the source files. Globally, a Lisp program is a set of
expressions formed with objects: data structures, lists and symbols.”





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#49785: [DOC] About Lisp Data Types
  2021-07-30 18:52 bug#49785: [DOC] About Lisp Data Types Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2021-07-31 11:18 ` Lars Ingebrigtsen
  2021-07-31 16:46   ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
  0 siblings, 1 reply; 3+ messages in thread
From: Lars Ingebrigtsen @ 2021-07-31 11:18 UTC (permalink / raw)
  To: Kevin Vigouroux; +Cc: 49785

Kevin Vigouroux <ke.vigouroux@laposte.net> writes:

> I would have phrased it differently.
>
> “The representation of a Lisp program is fundamental. At a high level,
> the operation of the program is represented by its components. At a low
> level, a Lisp program is a collection of routines which process data
> found in the source files. Globally, a Lisp program is a set of
> expressions formed with objects: data structures, lists and symbols.”

Sorry; I don't see any problems with the original text, and I don't
think the proposed text explains anything much to people who are
interested in what Emacs Lisp is.

Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#49785: [DOC] About Lisp Data Types
  2021-07-31 11:18 ` Lars Ingebrigtsen
@ 2021-07-31 16:46   ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
  0 siblings, 0 replies; 3+ messages in thread
From: Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2021-07-31 16:46 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 49785

It is written in black on white: we explain what constitutes a Lisp
program using the syntax as a thread.

[[info:elisp#Lisp Data Types]]

    This chapter describes the purpose, printed representation and read
    syntax of each of the standard types in GNU Emacs Lisp.

The problem is that it's not well presented. What is the link between a
variable, objects, what can be displayed and the Lisp syntax?

Nothing.

Best Regards,
Kevin Vigouroux





^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2021-07-31 16:46 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-07-30 18:52 bug#49785: [DOC] About Lisp Data Types Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-07-31 11:18 ` Lars Ingebrigtsen
2021-07-31 16:46   ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.