From unknown Tue Jun 17 20:21:23 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#8568 <8568@debbugs.gnu.org> To: bug#8568 <8568@debbugs.gnu.org> Subject: Status: 24.0.50; fringe-indicator-alist doc Reply-To: bug#8568 <8568@debbugs.gnu.org> Date: Wed, 18 Jun 2025 03:21:23 +0000 retitle 8568 24.0.50; fringe-indicator-alist doc reassign 8568 emacs submitter 8568 "Drew Adams" severity 8568 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 27 16:31:38 2011 Received: (at submit) by debbugs.gnu.org; 27 Apr 2011 20:31:38 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QFBOb-0000xv-OO for submit@debbugs.gnu.org; Wed, 27 Apr 2011 16:31:38 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QFBOa-0000xj-0b for submit@debbugs.gnu.org; Wed, 27 Apr 2011 16:31:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QFBOO-00005Z-Fs for submit@debbugs.gnu.org; Wed, 27 Apr 2011 16:31:30 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:45352) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QFBOO-00005P-Dy for submit@debbugs.gnu.org; Wed, 27 Apr 2011 16:31:24 -0400 Received: from eggs.gnu.org ([140.186.70.92]:48956) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QFBON-0004xQ-1m for bug-gnu-emacs@gnu.org; Wed, 27 Apr 2011 16:31:24 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QFBOM-000058-0f for bug-gnu-emacs@gnu.org; Wed, 27 Apr 2011 16:31:23 -0400 Received: from rcsinet10.oracle.com ([148.87.113.121]:21131) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QFBOL-0008WK-P3 for bug-gnu-emacs@gnu.org; Wed, 27 Apr 2011 16:31:21 -0400 Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p3RKVGQU004093 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 27 Apr 2011 20:31:18 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p3RKVFsR006246 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 27 Apr 2011 20:31:15 GMT Received: from abhmt017.oracle.com (abhmt017.oracle.com [141.146.116.26]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p3RKVF5t008694 for ; Wed, 27 Apr 2011 15:31:15 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 27 Apr 2011 13:31:15 -0700 From: "Drew Adams" To: Subject: 24.0.50; fringe-indicator-alist doc Date: Wed, 27 Apr 2011 13:31:14 -0700 Message-ID: <03DEE9B750A94AE78B2D48363056C0EC@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcwFGg3IV7Ae0FptR4+n/UUyoZ4LIg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6090 X-Source-IP: rcsinet15.oracle.com [148.87.113.117] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4DB87D16.0074:SCFMA4539811,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -6.5 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.5 (------) 1. (elisp) Fringe Indicators: "`top-bottom" is missing the closing single-quote, for some reason: "...used only for the `bottom' and `top-bottom indicators when the...". 2. There is no real explanation of LEFT1 and RIGHT1. The pseudo explanation is unintelligible: "The LEFT1 or RIGHT1 bitmaps are used only for the `bottom' and `top-bottom' indicators when the last (only) line has no final newline." That talks about the situation when they are used, but it doesn't explain what they are or how they are used. 3. This var maps logical indicators to bitmaps. But we need to describe each logical indicator. What does it mean? When is it appropriate to use it? For some you can guess, based on the short description: "empty line indicator" is no doubt appropriate for indicating an empty line. But what about `overlay-arrow'? Its description is "Overlay arrow indicator" Well, duh, but what does that mean? When do you use it? What is it intended for? 4. The node ends with "Standard fringe bitmaps for indicators:" and a list of bitmap symbols. A bitmap symbol such as `bottom-left-angle' is meaningless as just a name. If we can't have images then at least provide one-line descriptions of what each looks like. It would also help to show the default mapping, that is, the default value of `fringe-indicator-alist'. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-04-25 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt --cflags -Ic:/imagesupport/include' From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 27 16:53:44 2011 Received: (at 8568) by debbugs.gnu.org; 27 Apr 2011 20:53:45 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QFBk0-0001V3-Fx for submit@debbugs.gnu.org; Wed, 27 Apr 2011 16:53:44 -0400 Received: from mtaout23.012.net.il ([80.179.55.175]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QFBjx-0001Up-Qx for 8568@debbugs.gnu.org; Wed, 27 Apr 2011 16:53:43 -0400 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0LKB00300VMNE100@a-mtaout23.012.net.il> for 8568@debbugs.gnu.org; Wed, 27 Apr 2011 23:53:35 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.124.19.140]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LKB003HPWP99790@a-mtaout23.012.net.il>; Wed, 27 Apr 2011 23:53:35 +0300 (IDT) Date: Wed, 27 Apr 2011 23:53:41 +0300 From: Eli Zaretskii Subject: Re: bug#8568: 24.0.50; fringe-indicator-alist doc In-reply-to: <03DEE9B750A94AE78B2D48363056C0EC@us.oracle.com> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <837haf8lgq.fsf@gnu.org> References: <03DEE9B750A94AE78B2D48363056C0EC@us.oracle.com> X-Spam-Score: -1.8 (-) X-Debbugs-Envelope-To: 8568 Cc: 8568@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.8 (-) > From: "Drew Adams" > Date: Wed, 27 Apr 2011 13:31:14 -0700 > > 1. (elisp) Fringe Indicators: "`top-bottom" is missing the closing > single-quote, for some reason: "...used only for the `bottom' and > `top-bottom indicators when the...". Yep, a missing quote. > 2. There is no real explanation of LEFT1 and RIGHT1. The pseudo > explanation is unintelligible: "The LEFT1 or RIGHT1 bitmaps are used > only for the `bottom' and `top-bottom' indicators when the last (only) > line has no final newline." That talks about the situation when they > are used, but it doesn't explain what they are This is supposed to be explained in the beginning of the section: Emacs can indicate the buffer boundaries--that is, the first and last line in the buffer--with angle icons when they appear on the screen. In addition, Emacs can display an up-arrow in the fringe to show that there is text above the screen, and a down-arrow to show there is text below the screen. Are the names of each of these all that's missing to fill in the blanks? > or how they are used. This part I actually don't understand. What do you mean "_how_ they are used"? by drawing them in the fringes, of course! What am I missing? > 3. This var maps logical indicators to bitmaps. But we need to describe > each logical indicator. What does it mean? When is it appropriate to > use it? Same answer as for #2, and the same text that's supposed to explain that. > But what about `overlay-arrow'? Its description is "Overlay arrow > indicator" Well, duh, but what does that mean? When do you use it? > What is it intended for? Type "i overlay-arrow RET" and you will see. Will a cross-reference there be enough? > 4. The node ends with "Standard fringe bitmaps for indicators:" and a > list of bitmap symbols. A bitmap symbol such as `bottom-left-angle' is > meaningless as just a name. If we can't have images then at least > provide one-line descriptions of what each looks like. We _can_ have images, it's just a bit tedious to produce them. As for description... it's not easy. Perhaps you could suggest the proper descriptions, after looking at each one of the bitmaps. From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 27 17:48:56 2011 Received: (at 8568) by debbugs.gnu.org; 27 Apr 2011 21:48:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QFCbP-0002jX-PU for submit@debbugs.gnu.org; Wed, 27 Apr 2011 17:48:56 -0400 Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QFCbN-0002jM-UC for 8568@debbugs.gnu.org; Wed, 27 Apr 2011 17:48:54 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p3RLmkAw030971 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 27 Apr 2011 21:48:48 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p3RLmiRf027738 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 27 Apr 2011 21:48:45 GMT Received: from abhmt009.oracle.com (abhmt009.oracle.com [141.146.116.18]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p3RLmiNP001640; Wed, 27 Apr 2011 16:48:44 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 27 Apr 2011 14:48:44 -0700 From: "Drew Adams" To: "'Eli Zaretskii'" References: <03DEE9B750A94AE78B2D48363056C0EC@us.oracle.com> <837haf8lgq.fsf@gnu.org> Subject: RE: bug#8568: 24.0.50; fringe-indicator-alist doc Date: Wed, 27 Apr 2011 14:48:44 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <837haf8lgq.fsf@gnu.org> Thread-Index: AcwFHS8k6LzSu489R2WdFvg9WxniOgAA2lxg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6090 X-Source-IP: acsinet15.oracle.com [141.146.126.227] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090206.4DB88F40.0051:SCFMA922111,ss=1,fgs=0 X-Spam-Score: -6.5 (------) X-Debbugs-Envelope-To: 8568 Cc: 8568@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.5 (------) > > 2. There is no real explanation of LEFT1 and RIGHT1. The pseudo > > explanation is unintelligible: "The LEFT1 or RIGHT1 bitmaps are used > > only for the `bottom' and `top-bottom' indicators when the > > last (only) line has no final newline." That talks about the > > situation when they are used, but it doesn't explain what they are > > This is supposed to be explained in the beginning of the section: > > Emacs can indicate the buffer boundaries--that is, the first and > last line in the buffer--with angle icons when they appear on the > screen. In addition, Emacs can display an up-arrow in the fringe > to show that there is text above the screen, and a down-arrow to > show there is text below the screen. That is _not_ at the beginning of the section. That is part of the description of a different variable, user option `indicate-buffer-boundaries'. That seems to pertain only to fringe that indicates buffer boundaries, not to fringe in general. > Are the names of each of these all that's missing to fill in the > blanks? I guess so. We mention names (for `fringe-indicator-alist' INDICATOR values) and we give some description (for `indicate-buffer-boundaries'), but we don't link the description to the indicator names. My reading of this node and the uses I see of `fringe-indicator-alist' in the source code suggest that this variable is general, for use with fringe in general and not just for use with fringe that indicates buffer boundaries. So I certainly would not expect the description of buffer-boundary indication to apply to the possible INDICATOR values for `fringe-indicator-alist'. Am I wrong about that? [BTW, I just noticed that "is list of symbols" should be "is a list of symbols".] > > or how they are used. > > This part I actually don't understand. What do you mean "_how_ they > are used"? by drawing them in the fringes, of course! What am I > missing? I meant when it is appropriate to use them. I am thinking of the general, not just the default case - that is, use of `fringe-indicator-alist' in general, whatever its current value might be. But linking specific indicators to their use in `indicate-buffer-boundaries behaviors is a help, I suppose. That at least explains what those indicators are meant for in the default case. BTW, is it the case that the _only_ possible values of INDICATOR for `fringe-indicator-list' are those symbols listed? I don't have the C source, but if that is the case then in Lisp the :type for the defcustom would restrict the values to truncation, continuation, ..., unknown. If these are the only possible values, then the doc should say so. Especially since there is no limit to the values for BITMAPS (users can add their own fringe BITMAPS, but presumably not logical INDICATORS). > > 3. This var maps logical indicators to bitmaps. But we > > need to describe each logical indicator. What does it mean? > > When is it appropriate to use it? > > Same answer as for #2, and the same text that's supposed to explain > that. See above. Each logical INDICATOR needs to be described, in terms of its generally intended use/meaning. > > But what about `overlay-arrow'? Its description is "Overlay arrow > > indicator" Well, duh, but what does that mean? When do > > you use it? What is it intended for? > > Type "i overlay-arrow RET" and you will see. Will a cross-reference > there be enough? It's certainly necessary. And probably sufficient, though we should still give a few-words description of it in this node, just as for each of the other fringe indicators (each needs a one-liner). A fringe indicator value of `overlay-arrow' is not necessarily related, a priori, to the variables `overlay-arrow-string' etc. And a user would not necessarily think to look for the undefined term in the index. > > 4. The node ends with "Standard fringe bitmaps for > > indicators:" and a list of bitmap symbols. A bitmap symbol such as > > `bottom-left-angle' is meaningless as just a name. If we can't > > have images then at least provide one-line descriptions of what > > each looks like. > > We _can_ have images, it's just a bit tedious to produce them. Let's have an image plus a one-line (phrase) description for each. The description is important for displays that might not support images (yes, one can imagine development on such a display for use by users with displays that can show the bitmaps). > As for description... it's not easy. Perhaps you could > suggest the proper descriptions, after looking at each one > of the bitmaps. How can I see each of the bitmaps? If I could see them then yes, I could try to give you a one-liner describing each. FWIW, professional doc nearly always _requires_ each image to be accompanied by a description, for accessibility reasons. The wording describes what is shown in the image (not its significance etc.). E.g., "Two circles left and right, the left one with label `Foo' and the right one with label `Bar'. An arrow from the `Foo' circle to the `Bar' circle, labeled `Toto'.". From debbugs-submit-bounces@debbugs.gnu.org Sat Jan 28 08:50:11 2012 Received: (at 8568) by debbugs.gnu.org; 28 Jan 2012 13:50:11 +0000 Received: from localhost ([127.0.0.1]:47621 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rr8fS-00072w-Ro for submit@debbugs.gnu.org; Sat, 28 Jan 2012 08:50:11 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:45408 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rr8fQ-00072p-6B for 8568@debbugs.gnu.org; Sat, 28 Jan 2012 08:50:09 -0500 Received: from bb121-7-229-69.singnet.com.sg ([121.7.229.69]:45105 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Rr8eh-0003DY-7f; Sat, 28 Jan 2012 08:49:24 -0500 From: Chong Yidong To: "Drew Adams" Subject: Re: bug#8568: 24.0.50; fringe-indicator-alist doc References: <03DEE9B750A94AE78B2D48363056C0EC@us.oracle.com> Date: Sat, 28 Jan 2012 21:49:15 +0800 In-Reply-To: <03DEE9B750A94AE78B2D48363056C0EC@us.oracle.com> (Drew Adams's message of "Wed, 27 Apr 2011 13:31:14 -0700") Message-ID: <87fwf0j5t0.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: 8568 Cc: 8568@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) "Drew Adams" writes: > 1. (elisp) Fringe Indicators: "`top-bottom" is missing the closing > single-quote > > 2. There is no real explanation of LEFT1 and RIGHT1. > > 3. This var maps logical indicators to bitmaps. But we need to describe > each logical indicator. Fixed in trunk. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Sat Jan 28 08:50:23 2012 Received: (at control) by debbugs.gnu.org; 28 Jan 2012 13:50:23 +0000 Received: from localhost ([127.0.0.1]:47624 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rr8ff-00073L-6f for submit@debbugs.gnu.org; Sat, 28 Jan 2012 08:50:23 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:45411 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rr8fe-00073G-NE for control@debbugs.gnu.org; Sat, 28 Jan 2012 08:50:22 -0500 Received: from bb121-7-229-69.singnet.com.sg ([121.7.229.69]:45109 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Rr8ew-0003Du-Ir for control@debbugs.gnu.org; Sat, 28 Jan 2012 08:49:39 -0500 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 8568 Date: Sat, 28 Jan 2012 21:49:31 +0800 Message-ID: <871uqkndhw.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) close 8568 thanks From unknown Tue Jun 17 20:21:23 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 26 Feb 2012 12:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator