all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Van L <van@scratch.space>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 31683-done@debbugs.gnu.org
Subject: bug#31683: emacs-lisp-intro.texi - opportunity to link eintr to elisp
Date: Sat, 2 Jun 2018 23:30:35 +1000	[thread overview]
Message-ID: <BDEB9AB7-3073-47F8-B1A0-C12676C518EF@scratch.space> (raw)
In-Reply-To: <83bmcte7yr.fsf@gnu.org>


> Eli Zaretskii writes:
> 
>> From: Van L <van@scratch.space>
>> Date: Sat, 2 Jun 2018 20:39:49 +1000
>> 
>> The footnote at line 2150 *indirectly* links to (elisp) Printed Representation, which details what an expression is.
>> 
>> : 8cda6f8f44b (Glenn Morris             2007-09-06  2150) learn how to read it.@footnote{@code{(quote hello)} is an expansion of
> 
> I don't think I agree: the relation to expressions is too far-fetched
> here.

#+BEGIN_EXAMPLE
8cda6f8f44b (Glenn Morris             2007-09-06  1151) The printed representation of both atoms and lists are called
8cda6f8f44b (Glenn Morris             2007-09-06  1152) @dfn{symbolic expressions} or, more concisely, @dfn{s-expressions}.
8cda6f8f44b (Glenn Morris             2007-09-06  1153) The word @dfn{expression} by itself can refer to either the printed
8cda6f8f44b (Glenn Morris             2007-09-06  1154) representation, or to the atom or list as it is held internally in the
8cda6f8f44b (Glenn Morris             2007-09-06  1155) computer.  Often, people use the term @dfn{expression}
8cda6f8f44b (Glenn Morris             2007-09-06  1156) indiscriminately.  (Also, in many texts, the word @dfn{form} is used
8cda6f8f44b (Glenn Morris             2007-09-06  1157) as a synonym for expression.)

b8d4c8d0e93 doc/lispref/objects.texi (Glenn Morris        2007-09-06   95)   In other languages, an expression is text; it has no other form.  In
b8d4c8d0e93 doc/lispref/objects.texi (Glenn Morris        2007-09-06   96) Lisp, an expression is primarily a Lisp object and only secondarily the
b8d4c8d0e93 doc/lispref/objects.texi (Glenn Morris        2007-09-06   97) text that is the object's read syntax.  Often there is no need to
b8d4c8d0e93 doc/lispref/objects.texi (Glenn Morris        2007-09-06   98) emphasize this distinction, but you must keep it in the back of your
b8d4c8d0e93 doc/lispref/objects.texi (Glenn Morris        2007-09-06   99) mind, or you will occasionally be very confused.

#+END_EXAMPLE

Anyway. I find the above two snippets useful to link.

>> (I will re-open this bug number for future opportunities to link eintr, elisp after it is closed.)
> 
> Please don't, as each issue should be a separate bug report.

I won’t.






  reply	other threads:[~2018-06-02 13:30 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-06-02 10:39 bug#31683: emacs-lisp-intro.texi - opportunity to link eintr to elisp Van L
2018-06-02 11:36 ` Eli Zaretskii
2018-06-02 13:30   ` Van L [this message]
2018-06-02 14:13     ` Eli Zaretskii
2018-06-03  2:11       ` Van L
2018-06-03 15:19         ` Eli Zaretskii
2018-06-04  1:26           ` Van L

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=BDEB9AB7-3073-47F8-B1A0-C12676C518EF@scratch.space \
    --to=van@scratch.space \
    --cc=31683-done@debbugs.gnu.org \
    --cc=eliz@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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.