From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jean Louis Newsgroups: gmane.emacs.help Subject: Re: [External] : Supplying DOC string in a `defun' using `defvar' Date: Thu, 3 Jun 2021 09:52:05 +0300 Message-ID: References: <871r9ly7v3.fsf@web.de> <8735tzj34v.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3350"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mutt/2.0.7+183 (3d24855) (2021-05-28) Cc: Michael Heerdegen , help-gnu-emacs@gnu.org To: Christopher Dimech Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jun 03 08:52:58 2021 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 1lohDt-0000fs-PK for geh-help-gnu-emacs@m.gmane-mx.org; Thu, 03 Jun 2021 08:52:57 +0200 Original-Received: from localhost ([::1]:36754 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lohDs-0002rO-S9 for geh-help-gnu-emacs@m.gmane-mx.org; Thu, 03 Jun 2021 02:52:56 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49974) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lohDa-0002rG-N8 for help-gnu-emacs@gnu.org; Thu, 03 Jun 2021 02:52:38 -0400 Original-Received: from stw1.rcdrun.com ([217.170.207.13]:40525) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lohDY-0008UI-SL for help-gnu-emacs@gnu.org; Thu, 03 Jun 2021 02:52:38 -0400 Original-Received: from localhost ([::ffff:197.157.0.35]) (AUTH: PLAIN admin, TLS: TLS1.3,256bits,ECDHE_RSA_AES_256_GCM_SHA384) by stw1.rcdrun.com with ESMTPSA id 00000000000AE2D9.0000000060B87C31.000017EC; Wed, 02 Jun 2021 23:52:32 -0700 Mail-Followup-To: Christopher Dimech , Michael Heerdegen , help-gnu-emacs@gnu.org Content-Disposition: inline In-Reply-To: Received-SPF: pass client-ip=217.170.207.13; envelope-from=bugs@gnu.support; helo=stw1.rcdrun.com X-Spam_score_int: -3 X-Spam_score: -0.4 X-Spam_bar: / X-Spam_report: (-0.4 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_SORBS_WEB=1.5, SPF_HELO_PASS=-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 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:130524 Archived-At: * Christopher Dimech [2021-06-03 01:57]: > Have changed to lexical binding because I find that the > :documentation strategy offers great capability. Personal experience: - before lexical bindings all my software functioned well, and I had no problems whatsoever; I did not think about it, it did not practically bother me; Problems were more or less cosmetical, and through discussions I could learn only that I could easier find some errors, missing variables, unused variables and similar if lexical binding is turned on and if I follow the workflow to find such issues. In the end compiler warnings are those which are helping me find issues. Thus my workflow now is following: 1. modify the program; 2. M-x emacs-lisp-byte-compile or 2. M-x emacs-lisp-byte-compile-and-load, as that gives clues by byte compiler if there is any problem. Issues are solved at this step. 3. Press a key for revision control record. In my case the program is recorded in the database and new version number is raised. That makes program ready to be installed. 4. M-x package-install-from-buffer or package-install-file, as this command may give me more clues if there is any problem. 5. Later would come testing with emacs -Q and or with other Emacs versions. And I have a package as RCD Template Interpolation System for Emacs https://hyperscope.link/3/7/1/3/3/RCD-Template-Interpolation-System-for-Emacs.html that is separate package because I keep it dynamically not lexically, with intention. It is used in business to personalize emails and communication, like yesterday 756 times. There is no lexical bindings involved and currently I don't know how would I implement it with lexical bindings involved. I hope dynamic bindings will never go. -- Jean Take action in Free Software Foundation campaigns: https://www.fsf.org/campaigns Sign an open letter in support of Richard M. Stallman https://stallmansupport.org/