bug#49785: [DOC] About Lisp Data Types

bug#49785: [DOC] About Lisp Data Types

[Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors]

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.”

bug#49785: [DOC] About Lisp Data Types

[Lars Ingebrigtsen]

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

bug#49785: [DOC] About Lisp Data Types

[Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors]

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