From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: inasprecali Newsgroups: gmane.emacs.help Subject: Re: insert string at point with emacs-version Date: Tue, 01 Feb 2022 17:33:50 +0100 Message-ID: <87sft2r1g1.fsf@piccione> References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="23539"; mail-complaints-to="usenet@ciao.gmane.io" To: goncholden , goncholden via Users list for the GNU Emacs text editor Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 01 20:24:44 2022 Return-path: 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 ) id 1nEylg-0005ve-Aa for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 01 Feb 2022 20:24:44 +0100 Original-Received: from localhost ([::1]:46542 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nEyle-0005E5-U3 for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 01 Feb 2022 14:24:43 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:44222) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEw6h-0003gD-Ai for help-gnu-emacs@gnu.org; Tue, 01 Feb 2022 11:34:15 -0500 Original-Received: from knopi.disroot.org ([178.21.23.139]:48358) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEw6f-0000B3-CD for help-gnu-emacs@gnu.org; Tue, 01 Feb 2022 11:34:14 -0500 Original-Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 7130E18700; Tue, 1 Feb 2022 17:34:02 +0100 (CET) X-Virus-Scanned: SPAM Filter at disroot.org Original-Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with UTF8SMTP id I8a2Yqfc1q4s; Tue, 1 Feb 2022 17:34:01 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1643733232; bh=yMrYxsS6OB4Gfb0wdaJxzbBHmm/hiqxhb7SAgGXhULs=; h=From:To:Subject:In-Reply-To:References:Date; b=EZaRUYbOzeUGMbeOeEtY5kucyM5Tx9XZhql/N1UA5wAsqnRMYsCNmSHRtSEulVTjF ADXFTTyw6WuVVZpOgM+kC9TYQQA8ZFzpdj9Rw372xW2+1wXT3LvucClZeGQ39G+K5F 7jtokzQhcSsE3stgZ8b8D6y5NmpRNbpTQlTePsDDoLW/eLG0g9i8wan1iZCwhQOMI5 yeHaaUWlvIr8XMtLWAiIcn9cM+nlvpu31CWC5MLWFQPgph5Fd2G1RI2nkg2Ud87Est QfvHelayoYrKdbpVxn9ESuo/f3YtD2opnboXIdHE4JdFTX7fTultsS8h6tVEjlHhyf wADQl82GlB4gg== In-Reply-To: Received-SPF: pass client-ip=178.21.23.139; envelope-from=inasprecali@disroot.org; helo=knopi.disroot.org X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:135634 Archived-At: goncholden via Users list for the GNU Emacs text editor writes: > I am looking up documentation for emacs-version. But cannot understand the meaning of > > If optional argument HERE is non-nil, insert string at point. > > -------- > Doc: > > (emacs-version &optional HERE) > > Probably introduced at or before Emacs version 19.20. > > Return string describing the version of Emacs that is running. > If optional argument HERE is non-nil, insert string at point. In Emacs jargon, "point" means something like "the current cursor position". Try executing (emacs-version nil) and (emacs-version t) in a scratch buffer and see for yourself (C-x C-e runs the command eval-last-sexp, which you may find useful for this). When ARG is not provided or nil, emacs-version returns a string describing your current Emacs version as a value, if ARG is not NIL, emacs-version returns NIL and inserts said string wherever the cursor is currently located (that is, it inserts it at point).