From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Michael Heerdegen <michael_heerdegen@web.de>
Newsgroups: gmane.emacs.help
Subject: Re: Supplying DOC string in a `defun' using `defvar'
Date: Tue, 01 Jun 2021 16:31:12 +0200
Message-ID: <871r9ly7v3.fsf@web.de>
References: <trinity-90d53942-c0cd-437d-b9af-5b3f1ba9e76e-1622502005218@3c-app-mailcom-bs01>
 <YLVtfINYzywDoHwr@protected.localdomain>
 <jwvbl8qmfkc.fsf-monnier+emacs@gnu.org>
 <trinity-cdde68c5-c585-455e-91e4-d1b89e262bfd-1622524777444@3c-app-mailcom-bs01>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="29346"; mail-complaints-to="usenet@ciao.gmane.io"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)
To: help-gnu-emacs@gnu.org
Cancel-Lock: sha1:dedfvaaGyrPIxB64fmTvxOVFBcs=
Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jun 01 16:32:31 2021
Return-path: <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>
Envelope-to: geh-help-gnu-emacs@m.gmane-mx.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1lo5RW-0007Pl-Rm
	for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 01 Jun 2021 16:32:30 +0200
Original-Received: from localhost ([::1]:59220 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1lo5RV-0002xJ-UJ
	for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 01 Jun 2021 10:32:29 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57700)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <geh-help-gnu-emacs@m.gmane-mx.org>)
 id 1lo5QR-0001bY-A1
 for help-gnu-emacs@gnu.org; Tue, 01 Jun 2021 10:31:23 -0400
Original-Received: from ciao.gmane.io ([116.202.254.214]:50858)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <geh-help-gnu-emacs@m.gmane-mx.org>)
 id 1lo5QP-0008Bp-Mm
 for help-gnu-emacs@gnu.org; Tue, 01 Jun 2021 10:31:23 -0400
Original-Received: from list by ciao.gmane.io with local (Exim 4.92)
 (envelope-from <geh-help-gnu-emacs@m.gmane-mx.org>)
 id 1lo5QN-0005v2-63
 for help-gnu-emacs@gnu.org; Tue, 01 Jun 2021 16:31:19 +0200
X-Injected-Via-Gmane: http://gmane.org/
Received-SPF: pass client-ip=116.202.254.214;
 envelope-from=geh-help-gnu-emacs@m.gmane-mx.org; helo=ciao.gmane.io
X-Spam_score_int: -13
X-Spam_score: -1.4
X-Spam_bar: -
X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9,
 FREEMAIL_FORGED_FROMDOMAIN=0.248, FREEMAIL_FROM=0.001,
 HEADER_FROM_DIFFERENT_DOMAINS=0.249, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-BeenThere: help-gnu-emacs@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Users list for the GNU Emacs text editor <help-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/help-gnu-emacs>,
 <mailto:help-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/help-gnu-emacs>
List-Post: <mailto:help-gnu-emacs@gnu.org>
List-Help: <mailto:help-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/help-gnu-emacs>,
 <mailto:help-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org
Original-Sender: "help-gnu-emacs"
 <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.help:130452
Archived-At: <http://permalink.gmane.org/gmane.emacs.help/130452>

Christopher Dimech <dimech@gmx.com> writes:

> > Try:
> >
> >     (defvar my-doc "foobar")
> >     (defun (x)
> >       (:documentation my-doc)
> >       (+ x 42))
>
> Have tried this but emacs is still saying "Not documented."

Stefan typed too quickly, he forgot the function name in the defun - so
it probably should be

(defun my-fun (x)
  (:documentation my-doc)
  (+ x 42))

Michael.