From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] widen-limits c331b66: Implement buffer-widen-limits functionality Date: Thu, 24 Mar 2016 05:37:17 +0200 Message-ID: <838u1835si.fsf@gnu.org> References: <20160322022539.16038.77264@vcs.savannah.gnu.org> <8737riqouj.fsf@gmail.com> <221845e0-b194-433e-bfbc-105272ae5752@default> <87twjyp21k.fsf@gmail.com> <56F242E0.7060004@online.de> <877fgtpfrw.fsf@gmail.com> <56F293E7.2000703@online.de> <87a8lpnusg.fsf@gmail.com> <83r3f12oo5.fsf@gnu.org> <56F2D156.9040401@online.de> <83k2kt2i51.fsf@gnu.org> <56F2E643.4060903@online.de> <592bbafa-76ae-49d9-b5cd-644b3619a0d8@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1458790680 10530 80.91.229.3 (24 Mar 2016 03:38:00 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 24 Mar 2016 03:38:00 +0000 (UTC) Cc: spinuvit@gmail.com, andreas.roehler@online.de, emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Mar 24 04:37:55 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aiw5n-0002su-Eh for ged-emacs-devel@m.gmane.org; Thu, 24 Mar 2016 04:37:51 +0100 Original-Received: from localhost ([::1]:47362 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aiw5l-00049y-Hk for ged-emacs-devel@m.gmane.org; Wed, 23 Mar 2016 23:37:49 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50229) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aiw5Y-00049p-OD for emacs-devel@gnu.org; Wed, 23 Mar 2016 23:37:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aiw5V-0002RX-IW for emacs-devel@gnu.org; Wed, 23 Mar 2016 23:37:36 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:38508) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aiw5V-0002RT-FB; Wed, 23 Mar 2016 23:37:33 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2767 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aiw5U-0007Nj-Mq; Wed, 23 Mar 2016 23:37:33 -0400 In-reply-to: <592bbafa-76ae-49d9-b5cd-644b3619a0d8@default> (message from Drew Adams on Wed, 23 Mar 2016 14:57:49 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:202159 Archived-At: > Date: Wed, 23 Mar 2016 14:57:49 -0700 (PDT) > From: Drew Adams > Cc: spinuvit@gmail.com, emacs-devel@gnu.org > > And the text about indentation and the use of sub-mode for only a given > chunk of text in a buffer is incomprehensible without some explanation. > Normally, a major mode, no matter whether it is derived from some other > major mode, has its effect on the entire buffer. > > It seems there is some non-negligible functionality/behavior/feature > that has not been documented. Not up to Emacs standards, it appears. > > It looks like someone perhaps implemented something and just tossed > some minimal doc into the manual, in the form of doc-string-like text > for a couple functions. Insufficient. "Compliments" such as these for something that caused me a considerable effort to produce where no documentation by the code developers existed in the first place is a very efficient method of convincing me never to make such efforts again. Not for this community, anyway. Thanks a lot!