From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: =?UTF-8?Q?Cl=C3=A9ment?= Pit-Claudel Newsgroups: gmane.emacs.bugs Subject: bug#40784: Clarifying the difference between fringe bitmaps and XBM images Date: Thu, 23 Apr 2020 11:44:13 -0400 Message-ID: <94200480-37e9-14c9-14e6-ab1275512171@gmail.com> References: <15c13a13-efad-aee4-ac0e-f2630dc7ca11@gmail.com> <831roee0ko.fsf@gnu.org> <2e4d8eaf-5e7a-fc71-f515-a2513e47d615@gmail.com> <83ftcucjzw.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="59980"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.7.0 Cc: 40784@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Apr 23 19:36:51 2020 Return-path: Envelope-to: geb-bug-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 1jRfmM-000FTo-DU for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 23 Apr 2020 19:36:50 +0200 Original-Received: from localhost ([::1]:45892 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jRe2a-0001lU-Dd for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 23 Apr 2020 11:45:28 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57178) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jRe2A-0001Jc-TM for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2020 11:45:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jRe2A-0003Uf-D5 for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2020 11:45:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44210) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jRe29-0003RK-VU for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2020 11:45:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jRe29-0001AA-PP for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2020 11:45:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: =?UTF-8?Q?Cl=C3=A9ment?= Pit-Claudel Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 23 Apr 2020 15:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 40784 X-GNU-PR-Package: emacs Original-Received: via spool by 40784-submit@debbugs.gnu.org id=B40784.15876566634401 (code B ref 40784); Thu, 23 Apr 2020 15:45:01 +0000 Original-Received: (at 40784) by debbugs.gnu.org; 23 Apr 2020 15:44:23 +0000 Original-Received: from localhost ([127.0.0.1]:55756 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jRe1X-00018u-ED for submit@debbugs.gnu.org; Thu, 23 Apr 2020 11:44:23 -0400 Original-Received: from mail-qv1-f49.google.com ([209.85.219.49]:43925) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jRe1V-00018f-MI for 40784@debbugs.gnu.org; Thu, 23 Apr 2020 11:44:22 -0400 Original-Received: by mail-qv1-f49.google.com with SMTP id di6so3080751qvb.10 for <40784@debbugs.gnu.org>; Thu, 23 Apr 2020 08:44:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=bj4wKWEsoFl89tX6kkKHRxgPB8mzxhMk7gcQ2vg60AE=; b=fOkXzyQ5WnhhRvcWtXN/f826yppwUrZ3Dh/bhg3RP0ire4qAnuInDaL8zZ9VdhjoT9 tAVP/vXlOMZvScjmTP2z2lAcNc+4VEbs/k9GygGy+ihIbXo+rsx4YXlnDG2Y/ZEnr1z2 Yz/81O+3bd2G8LYGvWE0StuLh4SUoqtKnPSi7mOGP4Dkb7moaduZeigBPdUe4BQr5Wpb MI7YimnxDOcbJV3SSsVK4NbT/Em5DwoHpzy2i8/hOKOFpAHMqLp6XLHjQOjzdgThWJyH kTxB4cUjzN9izUoUyB31v1x19kI8gycPhqJeBFO/ta10OpGLmcW0tZeeEJN0ieQXg7NY 3qKw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=bj4wKWEsoFl89tX6kkKHRxgPB8mzxhMk7gcQ2vg60AE=; b=AlbhkAnBWGIodcVQsAKNPaZaZPxBUjmUzFzLN2yYlwaqOHXE9x3VWYAmRTD55zfYQi uhman6ao24HL3pisaK0TCur0dzTPkwcg0lmNk0ClCASRGakCvX1rVodeusdh26N5Faak Kv1AH8EGC26HruTWxyXlrG7mttnnYoDsfTr/FsXojetBq6JJt2VtL9kHenDbPlrLCG9N FKeO7bzR2RB8Rwn6dISDQYei8SnKxNgf+xqXNqPUunjL5xe8o5/AahfZ2C3s+3wxbC+q u8fa/kPFUIMf99RaJdK7Hfr7MRkPEONrUbpJbvI8hJQz8FTAC8PmpeEaEusnUQCXZFQ7 3MPA== X-Gm-Message-State: AGi0PuZf7Yw1UqeL/vSh0O7wVEFT3VzEXzIfD6bI0UKQiUARtmtPiKhA aRujA672Uj23Ns2996FoxM65P3X9 X-Google-Smtp-Source: APiQypIvN4C/bRenV/kZYhti73yiHhNM3Yhg6wNsw/etAzSanOh0YqLzjdzuYiGyKy6YrUnJBqwuug== X-Received: by 2002:a0c:e844:: with SMTP id l4mr4591698qvo.247.1587656655837; Thu, 23 Apr 2020 08:44:15 -0700 (PDT) Original-Received: from ?IPv6:2601:184:4180:66e7:54d6:bfeb:aa49:9d3b? ([2601:184:4180:66e7:54d6:bfeb:aa49:9d3b]) by smtp.googlemail.com with ESMTPSA id j9sm1736581qkk.99.2020.04.23.08.44.14 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 23 Apr 2020 08:44:15 -0700 (PDT) In-Reply-To: <83ftcucjzw.fsf@gnu.org> Content-Language: en-GB X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:178863 Archived-At: On 23/04/2020 11.14, Eli Zaretskii wrote: >> Cc: 40784@debbugs.gnu.org >> From: Clément Pit-Claudel >> Date: Thu, 23 Apr 2020 10:35:54 -0400 >> >> Of course: I am currently writing a mode that displays indicators either in the margins or in the fringes, depending on the value of a defcustom. >> By default, I intended to use the same bitmaps in the margins and in the fringes. It took me a while to understand what I was doing wrong: I was seeing reversed bitmaps, but I hadn't considered the possibility that the two places where Emacs supports monochrome bitmaps would accept the same representation (unibyte strings) but use a different bit order. >> The proposed patch updates the documentation to save the next person from experiencing the same pain. > > If so, then why do we need to mention this in the doc string? Won't > the manual be enough? It is strange to mention just this factoid in > the doc strings, when one can shoot themselves in the foot with > bitmapped images in many exciting ways. The docstrings are usually good enough that I seldom read the manuals :/ Having a brief warning in the docstring is useful in that case. But I'm happy to yield to your judgement. Clément.