unofficial mirror of emacs-tangents@gnu.org
 help / color / mirror / Atom feed
* 2016-04-18 Emacs News
@ 2016-04-18 15:09 Sacha Chua
  2016-04-18 16:19 ` Drew Adams
  0 siblings, 1 reply; 4+ messages in thread
From: Sacha Chua @ 2016-04-18 15:09 UTC (permalink / raw)
  To: emacs-tangents


[-- Attachment #1.1: Type: text/plain, Size: 5240 bytes --]

2016-04-18 Emacs News
  - Org Mode:
    - [Blogging with Emacs, Jekyll and Nikola] (http://cestlaz.github.io/posts/2016-04-17-emacs-jekyll-nikola/#.VxQbzRjLGKI.reddit)
    - [helm-org-rifle updated with new commands] (https://github.com/alphapapa/helm-org-rifle) ([Reddit] (https://www.reddit.com/r/emacs/comments/4ekohs/helmorgrifle_updated_with_new_commands/))
    - [About frustrations from erraneous science papers and Emacs to the rescue] (https://ogbe.net/blog/sloppy_papers.html) ([Reddit] (https://www.reddit.com/r/emacs/comments/4efhmv/about_frustrations_from_erraneous_science_papers/))
    - [Org as a word processor] (http://www.howardism.org/Technical/Emacs/orgmode-wordprocessor.html) ([Hacker News] (https://news.ycombinator.com/item?id=11515336))
  - Coding:
    - [Showing some of those Async Shell Command buffers] (http://mbork.pl/2016-04-12_Showing_some_of_those_Async_Shell_Command_buffers)
    - [Improving Projectile with extra commands] (http://endlessparentheses.com/improving-projectile-with-extra-commands.html?source=rss)
    - [A nice and clear summary of Emacs Lisp] (http://www.fincher.org/tips/Languages/Emacs.shtml) ([Reddit] (https://www.reddit.com/r/emacs/comments/4f7q0f/a_nice_and_clear_summary_of_emacs_lisp/))
    - [cl-format - Common Lisp format for Emacs] (https://github.com/alvinfrancis/cl-format)
    - [Step-by-step guide to C++ navigation and completion with Emacs and the Clang-based rtags] (https://vxlabs.com/2016/04/11/step-by-step-guide-to-c-navigation-and-completion-with-emacs-and-the-clang-based-rtags/) ([Reddit] (https://www.reddit.com/r/emacs/comments/4ecq1c/stepbystep_guide_to_c_navigation_and_completion/))
  - Emacs development:
    - [Added external socket launching support] (http://git.savannah.gnu.org/cgit/emacs.git/commit/etc/NEWS?id=e390b7b54651d3c5a4c36168e84e96e197631f41)
    - [Added time zone conversion functions] (http://git.savannah.gnu.org/cgit/emacs.git/commit/etc/NEWS?id=fdb1ba144ca61185e6457f092f38f59dd9bbe6a0)
    - [Discussion of docstrings and manuals] (http://lists.gnu.org/archive/html/emacs-devel/2016-04/msg00452.html)
    - [Re-introducing the Emacsmirror] (https://www.reddit.com/r/emacs/comments/4f17ba/reintroducing_the_emacsmirror/)
  - Other:
    - [Atreus, Windows, and Emacs] (https://alexschroeder.ch/wiki/2016-04-11_Atreus%2c_Windows%2c_and_Emacs): keyboards
    - [Efficient use of multi-button mice with emacs] (https://www.reddit.com/r/emacs/comments/4f2iee/efficient_use_of_multibutton_mice_with_emacs/)
    - [Pragmatic Emacs: Undo-send and schedule email in mu4e] (http://pragmaticemacs.com/emacs/undo-send-and-schedule-email-in-mu4e/)
    - [neato-graph-bar.el - htop-like CPU and memory graphs for Emacs] (https://gitlab.com/RobertCochran/neato-graph-bar)
    - ["Emacs beta is now available on chromebooks (and in chrome)!"] (https://plus.google.com/118416397954909331171/posts/8dt2sM8YeeM) ([Reddit] (https://www.reddit.com/r/emacs/comments/4ep0hd/emacs_beta_is_now_available_on_chromebooks_and_in/))
    - [Koeeoadi: A Theme Creator for Emacs and Vim] (http://thescratchcastle.com/koeeoadi/) ([Reddit] (https://www.reddit.com/r/emacs/comments/4eipyc/koeeoadi_a_theme_creator_for_emacs_and_vim/))
    - [Check out which-key!] (https://www.reddit.com/r/emacs/comments/4ec9n4/check_out_whichkey/)
  - New packages:
    - cl-format <http://melpa.org/#/cl-format>: CL format routine.
    - clomacs <http://melpa.org/#/clomacs>: Simplifies Emacs Lisp interaction with Clojure.
    - closql <http://melpa.org/#/closql>: store EIEIO objects using EmacSQL
    - counsel-projectile <http://melpa.org/#/counsel-projectile>: Ivy integration for Projectile
    - devdocs <http://melpa.org/#/devdocs>: Launch DevDocs search
    - epkg <http://melpa.org/#/epkg>: browse the Emacsmirror package database
    - euslisp-mode <http://melpa.org/#/euslisp-mode>: Major mode for Euslisp-formatted text
    - helm-notmuch <http://melpa.org/#/helm-notmuch>: Search emails with Notmuch and Helm
    - labburn-theme <http://melpa.org/#/labburn-theme>: A lab color space zenburn theme.
    - liso-theme <http://melpa.org/#/liso-theme>: Eclectic Dark Theme for GNU Emacs
    - micgoline <http://melpa.org/#/micgoline>: powerline mode, color schemes from microsoft and google's logo.
    - niceify-info <http://melpa.org/#/niceify-info>: improve usability of Info pages
    - ob-lua <http://melpa.org/#/ob-lua>: Execute Lua code within org-mode blocks.
    - vue-mode <http://melpa.org/#/vue-mode>: Major mode for vue component based on web-mode and mmm-mode
    - weechat-alert <http://melpa.org/#/weechat-alert>: Weechat notifier using alerts

  Links from [reddit.com/r/emacs] (http://reddit.com/r/emacs/new), [/r/orgmode] (http://reddit.com/r/orgmode), [Hacker News] (https://hn.algolia.com/?query=emacs&sort=byDate&prefix&page=0&dateRange=all&type=story), [planet.emacsen.org] (http://planet.emacsen.org), [Youtube] (https://www.youtube.com/results?search_query=emacs&search_sort=video_date_uploaded), the changes to the [Emacs NEWS file] (http://git.savannah.gnu.org/cgit/emacs.git/log/etc/NEWS), and [emacs-devel] (http://lists.gnu.org/archive/html/emacs-devel/2016-04).

  [Past Emacs News round-ups] (http://sachachua.com/blog/category/emacs-news)


[-- Attachment #1.2: Type: text/html, Size: 6605 bytes --]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: emacs-news.org --]
[-- Type: text/x-org; name=emacs-news.org, Size: 5056 bytes --]

* 2016-04-18 Emacs News                                               :emacs:
- Org Mode:
  - [[http://cestlaz.github.io/posts/2016-04-17-emacs-jekyll-nikola/#.VxQbzRjLGKI.reddit][Blogging with Emacs, Jekyll and Nikola]]
  - [[https://github.com/alphapapa/helm-org-rifle][helm-org-rifle updated with new commands]] ([[https://www.reddit.com/r/emacs/comments/4ekohs/helmorgrifle_updated_with_new_commands/][Reddit]])
  - [[https://ogbe.net/blog/sloppy_papers.html][About frustrations from erraneous science papers and Emacs to the rescue]] ([[https://www.reddit.com/r/emacs/comments/4efhmv/about_frustrations_from_erraneous_science_papers/][Reddit]])
  - [[http://www.howardism.org/Technical/Emacs/orgmode-wordprocessor.html][Org as a word processor]] ([[https://news.ycombinator.com/item?id=11515336][Hacker News]])
- Coding:
  - [[http://mbork.pl/2016-04-12_Showing_some_of_those_Async_Shell_Command_buffers][Showing some of those Async Shell Command buffers]]
  - [[http://endlessparentheses.com/improving-projectile-with-extra-commands.html?source=rss][Improving Projectile with extra commands]]
  - [[http://www.fincher.org/tips/Languages/Emacs.shtml][A nice and clear summary of Emacs Lisp]] ([[https://www.reddit.com/r/emacs/comments/4f7q0f/a_nice_and_clear_summary_of_emacs_lisp/][Reddit]])
  - [[https://github.com/alvinfrancis/cl-format][cl-format - Common Lisp format for Emacs]]
  - [[https://vxlabs.com/2016/04/11/step-by-step-guide-to-c-navigation-and-completion-with-emacs-and-the-clang-based-rtags/][Step-by-step guide to C++ navigation and completion with Emacs and the Clang-based rtags]] ([[https://www.reddit.com/r/emacs/comments/4ecq1c/stepbystep_guide_to_c_navigation_and_completion/][Reddit]])
- Emacs development:
  - [[http://git.savannah.gnu.org/cgit/emacs.git/commit/etc/NEWS?id=e390b7b54651d3c5a4c36168e84e96e197631f41][Added external socket launching support]]
  - [[http://git.savannah.gnu.org/cgit/emacs.git/commit/etc/NEWS?id=fdb1ba144ca61185e6457f092f38f59dd9bbe6a0][Added time zone conversion functions]]
  - [[http://lists.gnu.org/archive/html/emacs-devel/2016-04/msg00452.html][Discussion of docstrings and manuals]]
  - [[https://www.reddit.com/r/emacs/comments/4f17ba/reintroducing_the_emacsmirror/][Re-introducing the Emacsmirror]]
- Other:
  - [[https://alexschroeder.ch/wiki/2016-04-11_Atreus%2c_Windows%2c_and_Emacs][Atreus, Windows, and Emacs]]: keyboards
  - [[https://www.reddit.com/r/emacs/comments/4f2iee/efficient_use_of_multibutton_mice_with_emacs/][Efficient use of multi-button mice with emacs]]
  - [[http://pragmaticemacs.com/emacs/undo-send-and-schedule-email-in-mu4e/][Pragmatic Emacs: Undo-send and schedule email in mu4e]]
  - [[https://gitlab.com/RobertCochran/neato-graph-bar][neato-graph-bar.el - htop-like CPU and memory graphs for Emacs]]
  - [[https://plus.google.com/118416397954909331171/posts/8dt2sM8YeeM]["Emacs beta is now available on chromebooks (and in chrome)!"]] ([[https://www.reddit.com/r/emacs/comments/4ep0hd/emacs_beta_is_now_available_on_chromebooks_and_in/][Reddit]])
  - [[http://thescratchcastle.com/koeeoadi/][Koeeoadi: A Theme Creator for Emacs and Vim]] ([[https://www.reddit.com/r/emacs/comments/4eipyc/koeeoadi_a_theme_creator_for_emacs_and_vim/][Reddit]])
  - [[https://www.reddit.com/r/emacs/comments/4ec9n4/check_out_whichkey/][Check out which-key!]]
- New packages:
  - http://melpa.org/#/cl-format: CL format routine.
  - http://melpa.org/#/clomacs: Simplifies Emacs Lisp interaction with Clojure.
  - http://melpa.org/#/closql: store EIEIO objects using EmacSQL
  - http://melpa.org/#/counsel-projectile: Ivy integration for Projectile
  - http://melpa.org/#/devdocs: Launch DevDocs search
  - http://melpa.org/#/epkg: browse the Emacsmirror package database
  - http://melpa.org/#/euslisp-mode: Major mode for Euslisp-formatted text
  - http://melpa.org/#/helm-notmuch: Search emails with Notmuch and Helm
  - http://melpa.org/#/labburn-theme: A lab color space zenburn theme.
  - http://melpa.org/#/liso-theme: Eclectic Dark Theme for GNU Emacs
  - http://melpa.org/#/micgoline: powerline mode, color schemes from microsoft and google's logo.
  - http://melpa.org/#/niceify-info: improve usability of Info pages
  - http://melpa.org/#/ob-lua: Execute Lua code within org-mode blocks.
  - http://melpa.org/#/vue-mode: Major mode for vue component based on web-mode and mmm-mode
  - http://melpa.org/#/weechat-alert: Weechat notifier using alerts

Links from [[http://reddit.com/r/emacs/new][reddit.com/r/emacs]], [[http://reddit.com/r/orgmode][/r/orgmode]], [[https://hn.algolia.com/?query=emacs&sort=byDate&prefix&page=0&dateRange=all&type=story][Hacker News]], [[http://planet.emacsen.org][planet.emacsen.org]], [[https://www.youtube.com/results?search_query=emacs&search_sort=video_date_uploaded][Youtube]], the changes to the [[http://git.savannah.gnu.org/cgit/emacs.git/log/etc/NEWS][Emacs NEWS file]], and [[http://lists.gnu.org/archive/html/emacs-devel/2016-04][emacs-devel]].

[[http://sachachua.com/blog/category/emacs-news][Past Emacs News round-ups]]


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

* RE: 2016-04-18 Emacs News
  2016-04-18 15:09 2016-04-18 Emacs News Sacha Chua
@ 2016-04-18 16:19 ` Drew Adams
  2016-04-18 16:48   ` Sacha Chua
  0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2016-04-18 16:19 UTC (permalink / raw)
  To: Sacha Chua, emacs-tangents

> A nice and clear summary of Emacs Lisp (Reddit)
> http://www.fincher.org/tips/Languages/Emacs.shtml

Hm.  It's generally good to see such summaries.  But
this one is not as nice and clear as it might be, IMO.
It is also somewhat out of date.

 (set 'fname "Mitch")

Not a great example of what `set' is used for.  If this
were a common use case then we would need only `setq'.

 (setq fname "Mitch")

Doesn't bring much attention to the fact that the second
arg is evaluated and its value is used.  IOW, something
like a string, which is self-quoting, is not the best
thing to show in such an example.

 (list 'a 'x "asdf" 6) => (list a x "asdf" 6)

Should be => (a x "asdf" 6) - no "list".  But even that
would not bring much attention to the fact that each arg
is evaluated.

 (sort '(5 3 9 27) '<) => (3 5 9 27)

Well yes, but, especially if introducing this to newbies,
the destructive nature of `sort' is really important to
point out.

 (concat "I " "went to " "the woods ")=> "I went to the woods "

Might be good to use some arguments that are characters
and lists of chars - especially characters.

 (length "I went to the woods ")=> 20

Yes, but `string-width' is typically more appropriate for
strings (and there is `string-bytes').  A more typical
`length' use case would be with a list or a vector.

 (aref s i)
 returns the ith char (0 based)
 (aref "abcd" 2)=> 99

It's not about counting characters.  `aref' is for any
array, not just a string.  Same for `aset' description.

Section "Logical functions (and, or, not, eq)" does not
say what constitutes a "true" or a "false" value.  In
particular, it does not say that non-nil is treated as
true by most predicates (including `and', `or', and `not').

 "equal takes two args and tests if the values are equal"

Doesn't say what it means for two values to be "equal".

Section "Function Template" is really a command-definition
template.

 "Commands and functions can also have hooks. These are
  created using 'defadvice'."

Kind of.  But they are not called "hooks" in Emacs (e.g.
in the doc).  And `defadvice' is now deprecated, in favor
of the new advice system.

  `let': "uninitialized variables may also be used...  This
   creates temporary variables "c" and "d", but assigns no
   value."

That is wrong - vars `c' and `d' are bound to nil.

  "let* ;; forces sequential execution"

No, sequential (i.e., dependent) bindings.  Execution of
the body of `let' is also sequential.

 "if the documentation string begins with a "*", the variable
  is user definable with the M-xset-variable command"

No.  This behavior was (unfortunately, IMO) removed long ago.

Introducing `reduce', regexps, and macros is too advanced,
and too unexplained, for this high-level intro.  It can
erroneously give the impression of authority or expertise.

It might be different if (a) these things were actually
described/explained here and (b) there was not so much
that is wrong or misleading in the basic stuff presented.

 "defunst - defunst works like defun but "inlines" the function.
  Works like "Inline" in C++."

No.  `defunst' does not exist in Emacs Lisp.  `defsubst'
was presumably meant.

 `interactive': "r - the hilighted region"

No; it is the region, active (highlighted) or not.

`C-h a' is not `command-apropos' but `apropos-command'.

`C-h C-k' is not `Info-goto-emacs-key-command-node'.

`E-!' should be `M-!' (or `ESC !').

The link to the W3 web browser is broken.  And `eww' might
be a better choice now (?).

The commands bound to `C-x (', `C-x )', and `C-x e' have been
different for years now (kmacro was introduced in Emacs 22!).

In sum, again, it's good that people post such summaries, but
they can also be harmful/misleading.  If they are posted to
a community place such as Emacs Wiki then they at least have
a better chance of getting corrected and updated.

And I really recommend _asking Emacs_ itself, including the
manuals.  There is a good intro manual to learning Emacs Lisp
that comes with Emacs.



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

* Re: 2016-04-18 Emacs News
  2016-04-18 16:19 ` Drew Adams
@ 2016-04-18 16:48   ` Sacha Chua
  2016-04-25 18:08     ` Mitch Fincher
  0 siblings, 1 reply; 4+ messages in thread
From: Sacha Chua @ 2016-04-18 16:48 UTC (permalink / raw)
  To: Drew Adams, fincherdotorg; +Cc: emacs-tangents

Drew Adams <drew.adams@oracle.com> writes:

>> A nice and clear summary of Emacs Lisp (Reddit)
>> http://www.fincher.org/tips/Languages/Emacs.shtml
> Hm.  It's generally good to see such summaries.  But
> this one is not as nice and clear as it might be, IMO.
> It is also somewhat out of date.

Thanks for the detailed feedback, Drew! I'm looping in the author here
so that the tutorial can be updated - see Drew's notes below.
https://www.reddit.com/r/emacs/comments/4f7q0f/a_nice_and_clear_summary_of_emacs_lisp/
also has more comments.

>  (set 'fname "Mitch")
>
> Not a great example of what `set' is used for.  If this
> were a common use case then we would need only `setq'.
>
>  (setq fname "Mitch")
>
> Doesn't bring much attention to the fact that the second
> arg is evaluated and its value is used.  IOW, something
> like a string, which is self-quoting, is not the best
> thing to show in such an example.
>
>  (list 'a 'x "asdf" 6) => (list a x "asdf" 6)
>
> Should be => (a x "asdf" 6) - no "list".  But even that
> would not bring much attention to the fact that each arg
> is evaluated.
>
>  (sort '(5 3 9 27) '<) => (3 5 9 27)
>
> Well yes, but, especially if introducing this to newbies,
> the destructive nature of `sort' is really important to
> point out.
>
>  (concat "I " "went to " "the woods ")=> "I went to the woods "
>
> Might be good to use some arguments that are characters
> and lists of chars - especially characters.
>
>  (length "I went to the woods ")=> 20
>
> Yes, but `string-width' is typically more appropriate for
> strings (and there is `string-bytes').  A more typical
> `length' use case would be with a list or a vector.
>
>  (aref s i)
>  returns the ith char (0 based)
>  (aref "abcd" 2)=> 99
>
> It's not about counting characters.  `aref' is for any
> array, not just a string.  Same for `aset' description.
>
> Section "Logical functions (and, or, not, eq)" does not
> say what constitutes a "true" or a "false" value.  In
> particular, it does not say that non-nil is treated as
> true by most predicates (including `and', `or', and `not').
>
>  "equal takes two args and tests if the values are equal"
>
> Doesn't say what it means for two values to be "equal".
>
> Section "Function Template" is really a command-definition
> template.
>
>  "Commands and functions can also have hooks. These are
>   created using 'defadvice'."
>
> Kind of.  But they are not called "hooks" in Emacs (e.g.
> in the doc).  And `defadvice' is now deprecated, in favor
> of the new advice system.
>
>   `let': "uninitialized variables may also be used...  This
>    creates temporary variables "c" and "d", but assigns no
>    value."
>
> That is wrong - vars `c' and `d' are bound to nil.
>
>   "let* ;; forces sequential execution"
>
> No, sequential (i.e., dependent) bindings.  Execution of
> the body of `let' is also sequential.
>
>  "if the documentation string begins with a "*", the variable
>   is user definable with the M-xset-variable command"
>
> No.  This behavior was (unfortunately, IMO) removed long ago.
>
> Introducing `reduce', regexps, and macros is too advanced,
> and too unexplained, for this high-level intro.  It can
> erroneously give the impression of authority or expertise.
>
> It might be different if (a) these things were actually
> described/explained here and (b) there was not so much
> that is wrong or misleading in the basic stuff presented.
>
>  "defunst - defunst works like defun but "inlines" the function.
>   Works like "Inline" in C++."
>
> No.  `defunst' does not exist in Emacs Lisp.  `defsubst'
> was presumably meant.
>
>  `interactive': "r - the hilighted region"
>
> No; it is the region, active (highlighted) or not.
>
> `C-h a' is not `command-apropos' but `apropos-command'.
>
> `C-h C-k' is not `Info-goto-emacs-key-command-node'.
>
> `E-!' should be `M-!' (or `ESC !').
>
> The link to the W3 web browser is broken.  And `eww' might
> be a better choice now (?).
>
> The commands bound to `C-x (', `C-x )', and `C-x e' have been
> different for years now (kmacro was introduced in Emacs 22!).
>
> In sum, again, it's good that people post such summaries, but
> they can also be harmful/misleading.  If they are posted to
> a community place such as Emacs Wiki then they at least have
> a better chance of getting corrected and updated.
>
> And I really recommend _asking Emacs_ itself, including the
> manuals.  There is a good intro manual to learning Emacs Lisp
> that comes with Emacs.



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

* Re: 2016-04-18 Emacs News
  2016-04-18 16:48   ` Sacha Chua
@ 2016-04-25 18:08     ` Mitch Fincher
  0 siblings, 0 replies; 4+ messages in thread
From: Mitch Fincher @ 2016-04-25 18:08 UTC (permalink / raw)
  To: Sacha Chua; +Cc: emacs-tangents, Drew Adams

[-- Attachment #1: Type: text/plain, Size: 5264 bytes --]

Hi All,

Thanks so much for your comments!  It's wonderful to have such good,
detailed feedback.
I appreciate this more than you know.
I wrote this page a long time ago when learning Emacs lisp, so it's no
surprise it may be a little out of date.
I will carefully evaluate your comments and update the page soon - I'm in
the middle of a job search now, so it may be a little bit.

Thanks again!
Sincerely,
Mitch Fincher

On Mon, Apr 18, 2016 at 11:48 AM, Sacha Chua <sacha@sachachua.com> wrote:

> Drew Adams <drew.adams@oracle.com> writes:
>
> >> A nice and clear summary of Emacs Lisp (Reddit)
> >> http://www.fincher.org/tips/Languages/Emacs.shtml
> > Hm.  It's generally good to see such summaries.  But
> > this one is not as nice and clear as it might be, IMO.
> > It is also somewhat out of date.
>
> Thanks for the detailed feedback, Drew! I'm looping in the author here
> so that the tutorial can be updated - see Drew's notes below.
>
> https://www.reddit.com/r/emacs/comments/4f7q0f/a_nice_and_clear_summary_of_emacs_lisp/
> also has more comments.
>
> >  (set 'fname "Mitch")
> >
> > Not a great example of what `set' is used for.  If this
> > were a common use case then we would need only `setq'.
> >
> >  (setq fname "Mitch")
> >
> > Doesn't bring much attention to the fact that the second
> > arg is evaluated and its value is used.  IOW, something
> > like a string, which is self-quoting, is not the best
> > thing to show in such an example.
> >
> >  (list 'a 'x "asdf" 6) => (list a x "asdf" 6)
> >
> > Should be => (a x "asdf" 6) - no "list".  But even that
> > would not bring much attention to the fact that each arg
> > is evaluated.
> >
> >  (sort '(5 3 9 27) '<) => (3 5 9 27)
> >
> > Well yes, but, especially if introducing this to newbies,
> > the destructive nature of `sort' is really important to
> > point out.
> >
> >  (concat "I " "went to " "the woods ")=> "I went to the woods "
> >
> > Might be good to use some arguments that are characters
> > and lists of chars - especially characters.
> >
> >  (length "I went to the woods ")=> 20
> >
> > Yes, but `string-width' is typically more appropriate for
> > strings (and there is `string-bytes').  A more typical
> > `length' use case would be with a list or a vector.
> >
> >  (aref s i)
> >  returns the ith char (0 based)
> >  (aref "abcd" 2)=> 99
> >
> > It's not about counting characters.  `aref' is for any
> > array, not just a string.  Same for `aset' description.
> >
> > Section "Logical functions (and, or, not, eq)" does not
> > say what constitutes a "true" or a "false" value.  In
> > particular, it does not say that non-nil is treated as
> > true by most predicates (including `and', `or', and `not').
> >
> >  "equal takes two args and tests if the values are equal"
> >
> > Doesn't say what it means for two values to be "equal".
> >
> > Section "Function Template" is really a command-definition
> > template.
> >
> >  "Commands and functions can also have hooks. These are
> >   created using 'defadvice'."
> >
> > Kind of.  But they are not called "hooks" in Emacs (e.g.
> > in the doc).  And `defadvice' is now deprecated, in favor
> > of the new advice system.
> >
> >   `let': "uninitialized variables may also be used...  This
> >    creates temporary variables "c" and "d", but assigns no
> >    value."
> >
> > That is wrong - vars `c' and `d' are bound to nil.
> >
> >   "let* ;; forces sequential execution"
> >
> > No, sequential (i.e., dependent) bindings.  Execution of
> > the body of `let' is also sequential.
> >
> >  "if the documentation string begins with a "*", the variable
> >   is user definable with the M-xset-variable command"
> >
> > No.  This behavior was (unfortunately, IMO) removed long ago.
> >
> > Introducing `reduce', regexps, and macros is too advanced,
> > and too unexplained, for this high-level intro.  It can
> > erroneously give the impression of authority or expertise.
> >
> > It might be different if (a) these things were actually
> > described/explained here and (b) there was not so much
> > that is wrong or misleading in the basic stuff presented.
> >
> >  "defunst - defunst works like defun but "inlines" the function.
> >   Works like "Inline" in C++."
> >
> > No.  `defunst' does not exist in Emacs Lisp.  `defsubst'
> > was presumably meant.
> >
> >  `interactive': "r - the hilighted region"
> >
> > No; it is the region, active (highlighted) or not.
> >
> > `C-h a' is not `command-apropos' but `apropos-command'.
> >
> > `C-h C-k' is not `Info-goto-emacs-key-command-node'.
> >
> > `E-!' should be `M-!' (or `ESC !').
> >
> > The link to the W3 web browser is broken.  And `eww' might
> > be a better choice now (?).
> >
> > The commands bound to `C-x (', `C-x )', and `C-x e' have been
> > different for years now (kmacro was introduced in Emacs 22!).
> >
> > In sum, again, it's good that people post such summaries, but
> > they can also be harmful/misleading.  If they are posted to
> > a community place such as Emacs Wiki then they at least have
> > a better chance of getting corrected and updated.
> >
> > And I really recommend _asking Emacs_ itself, including the
> > manuals.  There is a good intro manual to learning Emacs Lisp
> > that comes with Emacs.
>



-- 
Gravity never sleeps..

[-- Attachment #2: Type: text/html, Size: 7328 bytes --]

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

end of thread, other threads:[~2016-04-25 18:08 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-04-18 15:09 2016-04-18 Emacs News Sacha Chua
2016-04-18 16:19 ` Drew Adams
2016-04-18 16:48   ` Sacha Chua
2016-04-25 18:08     ` Mitch Fincher

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).