* What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
@ 2016-02-09 17:45 Thorsten Jolitz
2016-02-09 18:59 ` John Kitchin
0 siblings, 1 reply; 8+ messages in thread
From: Thorsten Jolitz @ 2016-02-09 17:45 UTC (permalink / raw)
To: emacs-orgmode
Hi List,
just out of curiosity, a few functions in org-element.el contain _ in
their parameter list, but its not used in the body.
What does it stand for?
--
cheers,
Thorsten
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-09 17:45 What does the _ in `(defun org-element-section-parser (_) ...)' stands for? Thorsten Jolitz
@ 2016-02-09 18:59 ` John Kitchin
2016-02-10 20:13 ` Thorsten Jolitz
0 siblings, 1 reply; 8+ messages in thread
From: John Kitchin @ 2016-02-09 18:59 UTC (permalink / raw)
To: Thorsten Jolitz; +Cc: emacs-orgmode
I guess it is a required signature for the function (i.e. some other
function will call it with some argument), and _ indicates it is not
used in the body. If you were to give it the arg a name, then checkdoc
would complain about it not being in the docstring.
Thorsten Jolitz writes:
> Hi List,
> just out of curiosity, a few functions in org-element.el contain _ in
> their parameter list, but its not used in the body.
> What does it stand for?
--
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-09 18:59 ` John Kitchin
@ 2016-02-10 20:13 ` Thorsten Jolitz
2016-02-10 20:47 ` John Kitchin
0 siblings, 1 reply; 8+ messages in thread
From: Thorsten Jolitz @ 2016-02-10 20:13 UTC (permalink / raw)
To: emacs-orgmode
John Kitchin <jkitchin@andrew.cmu.edu> writes:
> I guess it is a required signature for the function (i.e. some other
> function will call it with some argument), and _ indicates it is not
> used in the body. If you were to give it the arg a name, then checkdoc
> would complain about it not being in the docstring.
Sounds reasonable, thanks for the explanation.
But it does not seem to be a true guess, I tried it out with:
#+BEGIN_SRC emacs-lisp
(defun my-foo (_)
"Hello World.
Argument _ unknown argument."
(+ 1 1))
#+END_SRC
and checkdoc asked me to add the "Argument ..." part for "_" to the docstring.
I don't remember that I've seen this before, so maybe this is a rather new
feature/convention?
> Thorsten Jolitz writes:
>
>> Hi List,
>> just out of curiosity, a few functions in org-element.el contain _ in
>> their parameter list, but its not used in the body.
>> What does it stand for?
>
>
> --
> Professor John Kitchin
> Doherty Hall A207F
> Department of Chemical Engineering
> Carnegie Mellon University
> Pittsburgh, PA 15213
> 412-268-7803
> @johnkitchin
> http://kitchingroup.cheme.cmu.edu
>
>
--
cheers,
Thorsten
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-10 20:13 ` Thorsten Jolitz
@ 2016-02-10 20:47 ` John Kitchin
2016-02-11 17:10 ` Thorsten Jolitz
0 siblings, 1 reply; 8+ messages in thread
From: John Kitchin @ 2016-02-10 20:47 UTC (permalink / raw)
To: Thorsten Jolitz; +Cc: emacs-orgmode@gnu.org
[-- Attachment #1: Type: text/plain, Size: 502 bytes --]
On Wed, Feb 10, 2016 at 3:13 PM, Thorsten Jolitz <tjolitz@gmail.com> wrote:
> #+BEGIN_SRC emacs-lisp
> (defun my-foo (_)
> "Hello World.
> Argument _ unknown argument."
> (+ 1 1))
> #+END_SRC
>
strange. in Emacs 25.1, I am pretty sure I get no errors from checkdoc.
John
-----------------------------------
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu
[-- Attachment #2: Type: text/html, Size: 1176 bytes --]
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-10 20:47 ` John Kitchin
@ 2016-02-11 17:10 ` Thorsten Jolitz
2016-02-11 17:20 ` John Kitchin
2016-02-11 17:33 ` Nick Dokos
0 siblings, 2 replies; 8+ messages in thread
From: Thorsten Jolitz @ 2016-02-11 17:10 UTC (permalink / raw)
To: emacs-orgmode
John Kitchin <jkitchin@andrew.cmu.edu> writes:
> On Wed, Feb 10, 2016 at 3:13 PM, Thorsten Jolitz <tjolitz@gmail.com>
> wrote:
>
> #+BEGIN_SRC emacs-lisp
> (defun my-foo (_)
> "Hello World.
> Argument _ unknown argument."
> (+ 1 1))
> #+END_SRC
>
> strange. in Emacs 25.1, I am pretty sure I get no errors from
> checkdoc.
Maybe not so strange, since I'm on:
,----
| GNU Emacs 24.5.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.16.6)
| of 2015-09-10 on foutrelis
`----
And I thought with Archlinux I'm always up-to-date ...
--
cheers,
Thorsten
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-11 17:10 ` Thorsten Jolitz
@ 2016-02-11 17:20 ` John Kitchin
2016-02-11 17:33 ` Nick Dokos
1 sibling, 0 replies; 8+ messages in thread
From: John Kitchin @ 2016-02-11 17:20 UTC (permalink / raw)
To: Thorsten Jolitz; +Cc: emacs-orgmode@gnu.org
[-- Attachment #1: Type: text/plain, Size: 1161 bytes --]
There is up to date ... And up to date😉 funnily enough I run a near
bleeding edge version of Emacs from home brew and org 8.2.10 from Melpa.
On Thursday, February 11, 2016, Thorsten Jolitz <tjolitz@gmail.com> wrote:
> John Kitchin <jkitchin@andrew.cmu.edu <javascript:;>> writes:
>
> > On Wed, Feb 10, 2016 at 3:13 PM, Thorsten Jolitz <tjolitz@gmail.com
> <javascript:;>>
> > wrote:
> >
> > #+BEGIN_SRC emacs-lisp
> > (defun my-foo (_)
> > "Hello World.
> > Argument _ unknown argument."
> > (+ 1 1))
> > #+END_SRC
> >
> > strange. in Emacs 25.1, I am pretty sure I get no errors from
> > checkdoc.
>
> Maybe not so strange, since I'm on:
>
> ,----
> | GNU Emacs 24.5.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.16.6)
> | of 2015-09-10 on foutrelis
> `----
>
> And I thought with Archlinux I'm always up-to-date ...
>
> --
> cheers,
> Thorsten
>
>
>
--
John
-----------------------------------
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu
[-- Attachment #2: Type: text/html, Size: 1819 bytes --]
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-11 17:10 ` Thorsten Jolitz
2016-02-11 17:20 ` John Kitchin
@ 2016-02-11 17:33 ` Nick Dokos
2016-02-14 16:45 ` John Kitchin
1 sibling, 1 reply; 8+ messages in thread
From: Nick Dokos @ 2016-02-11 17:33 UTC (permalink / raw)
To: emacs-orgmode
Thorsten Jolitz <tjolitz@gmail.com> writes:
> John Kitchin <jkitchin@andrew.cmu.edu> writes:
>
>> On Wed, Feb 10, 2016 at 3:13 PM, Thorsten Jolitz <tjolitz@gmail.com>
>> wrote:
>>
>> #+BEGIN_SRC emacs-lisp
>> (defun my-foo (_)
>> "Hello World.
>> Argument _ unknown argument."
>> (+ 1 1))
>> #+END_SRC
>>
>> strange. in Emacs 25.1, I am pretty sure I get no errors from
>> checkdoc.
>
> Maybe not so strange, since I'm on:
>
> ,----
> | GNU Emacs 24.5.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.16.6)
> | of 2015-09-10 on foutrelis
> `----
>
> And I thought with Archlinux I'm always up-to-date ...
Unless you build your own from the upstream git repo, you can never be
up to date; even so, it depends on how often you build - I build from
upstream every six months or so and my current version is
GNU Emacs 25.0.50.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.14.15) of
2015-08-16
It's probably time to rebuild...
--
Nick
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: What does the _ in `(defun org-element-section-parser (_) ...)' stands for?
2016-02-11 17:33 ` Nick Dokos
@ 2016-02-14 16:45 ` John Kitchin
0 siblings, 0 replies; 8+ messages in thread
From: John Kitchin @ 2016-02-14 16:45 UTC (permalink / raw)
To: Nick Dokos; +Cc: emacs-orgmode@gnu.org
[-- Attachment #1: Type: text/plain, Size: 1655 bytes --]
FYI, I found this today:
(To silence byte-compiler warnings about unused variables, just use a
variable name that start with an underscore. The byte-compiler interprets
this as an indication that this is a variable known not to be used.)
https://www.gnu.org/software/emacs/manual/html_node/elisp/Using-Lexical-Binding.html
John
-----------------------------------
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu
On Thu, Feb 11, 2016 at 12:33 PM, Nick Dokos <ndokos@gmail.com> wrote:
> Thorsten Jolitz <tjolitz@gmail.com> writes:
>
> > John Kitchin <jkitchin@andrew.cmu.edu> writes:
> >
> >> On Wed, Feb 10, 2016 at 3:13 PM, Thorsten Jolitz <tjolitz@gmail.com>
> >> wrote:
> >>
> >> #+BEGIN_SRC emacs-lisp
> >> (defun my-foo (_)
> >> "Hello World.
> >> Argument _ unknown argument."
> >> (+ 1 1))
> >> #+END_SRC
> >>
> >> strange. in Emacs 25.1, I am pretty sure I get no errors from
> >> checkdoc.
> >
> > Maybe not so strange, since I'm on:
> >
> > ,----
> > | GNU Emacs 24.5.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.16.6)
> > | of 2015-09-10 on foutrelis
> > `----
> >
> > And I thought with Archlinux I'm always up-to-date ...
>
> Unless you build your own from the upstream git repo, you can never be
> up to date; even so, it depends on how often you build - I build from
> upstream every six months or so and my current version is
>
> GNU Emacs 25.0.50.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.14.15) of
> 2015-08-16
>
> It's probably time to rebuild...
>
> --
> Nick
>
>
>
[-- Attachment #2: Type: text/html, Size: 2995 bytes --]
^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2016-02-14 16:45 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-02-09 17:45 What does the _ in `(defun org-element-section-parser (_) ...)' stands for? Thorsten Jolitz
2016-02-09 18:59 ` John Kitchin
2016-02-10 20:13 ` Thorsten Jolitz
2016-02-10 20:47 ` John Kitchin
2016-02-11 17:10 ` Thorsten Jolitz
2016-02-11 17:20 ` John Kitchin
2016-02-11 17:33 ` Nick Dokos
2016-02-14 16:45 ` John Kitchin
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
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).