From mboxrd@z Thu Jan  1 00:00:00 1970
From: l.stelmach@samsung.com (=?utf-8?Q?=C5=81ukasz?= Stelmach)
Subject: Re: org-clock-is-active
Date: Thu, 04 Jul 2013 10:27:07 +0200
Message-ID: <87a9m2n31g.fsf@samsung.com>
References: <87ip0rmzei.fsf@samsung.com> <87d2qz8rv3.fsf@bzg.ath.cx>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:43338)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <l.stelmach@samsung.com>) id 1Uuesr-0001uv-Uj
	for emacs-orgmode@gnu.org; Thu, 04 Jul 2013 04:27:26 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <l.stelmach@samsung.com>) id 1Uuesn-0002CV-US
	for emacs-orgmode@gnu.org; Thu, 04 Jul 2013 04:27:21 -0400
In-reply-to: <87d2qz8rv3.fsf@bzg.ath.cx>
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Bastien <bzg@gnu.org>
Cc: emacs-orgmode@gnu.org

It was <2013-07-03 =C5=9Bro 19:40>, when Bastien wrote:
> l.stelmach@samsung.com (=C5=81ukasz Stelmach) writes:
>
>> (defun org-clock-is-active ()
>>   "Return non-nil if clock is currently running.
>> The return value is actually the clock marker."
>>   (marker-buffer org-clock-marker))
>>
>> Either the docstring is lying or the code does not do what it is said
>> to. (Or it is too late for me?)
>
> I don't understand, what is the problem exactly?

The docstring says the function returns a *marker*. The function does not
return org-clock-marker but only the buffer the clock is ticking in. You
can't:

    (goto-char (org-clock-is-active))

which should be possible according to goto-char's docstring

    (goto-char POSITION)

    Set point to POSITION, a number or *marker*.

This is a minor inaccuracy, however, if you do not browse the code but
only look at functions docstring, you may loose a few minutes.

--=20
=C5=81ukasz Stelmach
Samsung R&D Institute Poland
Samsung Electronics