From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.help Subject: Re: RE: Auto Fill Comments Date: Tue, 1 Dec 2020 17:07:42 +0100 Message-ID: References: <871rgd6jzk.fsf@web.de> <87r1oclvkp.fsf@web.de> <87blffzq7f.fsf@web.de> <87wny2r1a1.fsf@web.de> <236fb79f-014c-412f-9c78-fd9c774a57fc@default> <20201201084224.GA26076@tuxteam.de> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25478"; mail-complaints-to="usenet@ciao.gmane.io" Cc: help-gnu-emacs@gnu.org To: tomas@tuxteam.de Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Tue Dec 01 17:11:52 2020 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 1kk8Fr-0006X1-Vt for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 01 Dec 2020 17:11:51 +0100 Original-Received: from localhost ([::1]:47262 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kk8Fq-0006vb-Po for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 01 Dec 2020 11:11:51 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45056) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kk8C0-0005gE-UF for help-gnu-emacs@gnu.org; Tue, 01 Dec 2020 11:07:52 -0500 Original-Received: from mout.gmx.net ([212.227.15.18]:56767) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kk8By-0003wb-WF for help-gnu-emacs@gnu.org; Tue, 01 Dec 2020 11:07:52 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1606838862; bh=bCUTUe8Xo2/Sf9nVmQ5cS140+8ZELOiZBzBip13C6Zg=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=b6abwYq4+m3ieQ+CsxAo9JcfKRxK/qBKaxL+7ZKa7QDdM048Q8jr057GDsHh2Ycb+ Tj/pd3gFtKxeRkbpCp3BnOfjoGngsKAPBz+Z7g54db7QtRCjOsj9rsFTV30yWoXAax q8raVAXixXdpZOBrFIMZ6mGFccbcm+0z9tAL/eo4= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs05.server.lan [172.19.170.173]) (via HTTP); Tue, 1 Dec 2020 17:07:42 +0100 Importance: normal Sensitivity: Normal In-Reply-To: <20201201084224.GA26076@tuxteam.de> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:xdFpNZt7BD1MEKbgGxcAKB2NYYGD4loisd9amwKYF+FHJQy2ZFQ8rGUzZvTlGiUUTLJl2 ck07zNGGbKylfgeIuf1HjVxc6i5gFx6kycOrlyOwrt6CsuE1HJ/Dk4aEqXhI9ygijgaQh1o1d0m/ rOHP59pZCUFJgsJJxQYg6NDhXy1jb3rSNnCQooMlUITrnHQ9k7EAPuLFIPCbL8nCM6QQ5n5N0nnR cwpGAJPU1aLj72KUrhjse6wJJUa0biLG8mZevX4oTbUnYj27z9gS3Z9GeLAr9eV9mLnras6UJY+D Yk= X-UI-Out-Filterresults: notjunk:1;V03:K0:aMrIJmnRkgE=:mpYqYUFW6/z9wolmhp0lUK A3N1RHqQroenTPp7CzvEphPDbcuZLABAYDTGyfCJXD5UFUwnD/fMcj3RU35rYJR3YiMsIZlIP LrU8B4jeb3YxN/raVelFPU0AZIaFjkWqdQgbUEQKAoydPPSCQoDeRQJiLnHiL1O+Hgw7u0XOf qinHRYMHcTYpmmx5dKlOpQCJju2Prsei/5iPnu7BugBE1ovhMdJv6b+QH4JCJD+3AXvFwFS9j UtTvStVfpHL7LM/ByB6DeuiOLjbGYYi5AcEWOYG5z7iH+JB1tGd24CRUqKxkkUbq054KdqPdf uuzJKcyJUOOpCygidOP8lmxMAXQPWfN1cvx4CMlJgwN/EBxbtOy148EZhgVFU8XRz4DzyFfd0 hxfFtPA9waATnDNfmokAFEHF+BIMdhCdRkXe/HIFjisCbsZTMQLaiXrBlH/UPwrBChTpjUtqj sTB+Yw4LKyCuIi3M0Rvqy7cyIeujr9sD4CPCrfuyMF8EnEBKRTZiuJM9SZyNBVLqkGzzzaPVI u/ETjeGfprtWHN4wqIhG88wbZ3KAI0VFU+kAGeVYxuQG2yOnQOqUa+SvRGsPDMX1Vnyo0EGot OXr43C72v1ItM= Received-SPF: pass client-ip=212.227.15.18; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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:125791 Archived-At: > Sent: Tuesday, December 01, 2020 at 9:42 AM > From: tomas@tuxteam.de > To: help-gnu-emacs@gnu.org > Subject: Re: RE: Auto Fill Comments > > On Tue, Dec 01, 2020 at 12:22:11AM +0100, Christopher Dimech wrote: > > That's a great example. We can have a function that sets fill-column > > as buffer-local and hook it to programming mode, c-mode say. > > Why mix a mode in? This makes the example unnecessarily complex. > Just fill-column, buffer-local, that's it. Because we should not kid users by showing an example that we already know is buffer local, and don't have to do anything. Still, perhaps doing that on the reference creates more problems than solves. > > That would > > be a useful example. And users can try it out and see things work. > > > > Yes, it is repeating and RTFM, but with a serious code example to exci= te > > people to write actual code after the prose. > > The interesting challenge is that different people have diverse > approaches at learning. Covering as much ground as possible > without exploding in size (which would hinder learning, too) > is that Herculean task. That's probably why there's more than > 1 book. > > I claim the Emacs folks have done an outstanding job with the > two manuals and the introduction /on top of/ the whole "live" > doc (docstrings, ref to source, etc.). The only software projects > I could name rivalling that doc would be Don Knuth's TeX and > METAFONT, but they are (one? several?) orders of magnitude less > complex than Emacs at this point. > > Cheers > - t >