From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 21 09:37:36 2023 Received: (at submit) by debbugs.gnu.org; 21 Jul 2023 13:37:36 +0000 Received: from localhost ([127.0.0.1]:60949 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMqK8-0001eI-D3 for submit@debbugs.gnu.org; Fri, 21 Jul 2023 09:37:36 -0400 Received: from lists.gnu.org ([2001:470:142::17]:47648) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMqK5-0001e4-8P for submit@debbugs.gnu.org; Fri, 21 Jul 2023 09:37:35 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qMqJz-0001RM-QP for bug-gnu-emacs@gnu.org; Fri, 21 Jul 2023 09:37:27 -0400 Received: from mail-0301.mail-europe.com ([188.165.51.139]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qMqJw-0000uI-3W for bug-gnu-emacs@gnu.org; Fri, 21 Jul 2023 09:37:27 -0400 Date: Fri, 21 Jul 2023 13:37:02 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1689946639; x=1690205839; bh=jcydCt1X34Fy+g6Sz3TK/poX0+yfTL5C/qefbWrWay4=; h=Date:To:From:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector; b=NGreeKK1bkw52P353f5z1jstVcFAB0PDm3RBhkuygHJzB7u+Ku4dbq6BOD2lU2rDr vlrorK4Iwc2/SioZPWqqyyvDm8URPFUHakHnebZDkHQF+ZlN5uzgIXyd9cDdjjWRRf 6e3WLSQpsypmhvPvAtSGz7srcMY1YX9Tsnh9d5Kuc+fT0BjXKP9n4M9avzQb8yelKf JRRDPL4hxpZZmuDa4wZ6nZuX35xx0jsDwymyCl5+Ct4cdQW4ZVzztF2mHOYgp5zb1g P23IUbABjjr1ETlt0rEcg3G2V732qi8y0ZPhNbuI4Co3ENNwpKCiI3X7kpROMxi0HK 1FCvmveWtlnHQ== To: "bug-gnu-emacs@gnu.org" From: uzibalqa Subject: Docstrings made to print specfied lines in colour Message-ID: Feedback-ID: 52887082:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=188.165.51.139; envelope-from=uzibalqa@proton.me; helo=mail-0301.mail-europe.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) It would be an improvement if docstrings can be made to print specfied line= s in colour. Currently everything is one colour, except executable commands = that are not expected to have whitespaces. From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 21 10:27:47 2023 Received: (at 64769) by debbugs.gnu.org; 21 Jul 2023 14:27:47 +0000 Received: from localhost ([127.0.0.1]:34352 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMr6e-0003RY-1s for submit@debbugs.gnu.org; Fri, 21 Jul 2023 10:27:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMr6Z-0003RJ-5s for 64769@debbugs.gnu.org; Fri, 21 Jul 2023 10:27:43 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qMr6T-0006jp-NS; Fri, 21 Jul 2023 10:27:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=K4LpOgRh19i8ijDHxhCHtav0JxhRYWF7TJh2FSciNxE=; b=e6iet0y6FDsB emOmW4z/r5Hha7+tuUzYQSPuXVUCmpPdFNOzTQNjIxNvP2UR+3SDV/44xlikM/L6E56s6vNRz0WkH BHnKfm9k7SEoE/1ZfZrD/zI2LwundQZhHL9AeHd3vJ36yiUtRfZM5Vn55T9IdXAnc3QgC1TamLFwR n8iuhPSJTZC3gppwH8JinLXK13YDqiGBqo7M1M46Hw6HhIWVypzy0Jnl3eBZfBjGywh1+85Hf4h43 d0RfEFwxC0DiFRsfYRMX8EwZ/6jlvYw1KKe0bUDWwo/E8E8FT7UgeXDAgq5whPP/XiWJj1pcT/JVo 4JaShnZRr3cqkOfHcPeQoQ==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qMr6R-0001P7-Pb; Fri, 21 Jul 2023 10:27:33 -0400 Date: Fri, 21 Jul 2023 17:28:05 +0300 Message-Id: <83cz0lbaq2.fsf@gnu.org> From: Eli Zaretskii To: uzibalqa In-Reply-To: (bug-gnu-emacs@gnu.org) Subject: Re: bug#64769: Docstrings made to print specfied lines in colour References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 64769 Cc: 64769@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 21 Jul 2023 13:37:02 +0000 > From: uzibalqa via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > > It would be an improvement if docstrings can be made to print specfied lines > in colour. Currently everything is one colour, except executable commands that > are not expected to have whitespaces. *Help* buffers do have faces, and you can customize them to use non-default colors. Beyond that, it is not clear what behavior you are asking for. How will the "specified lines" be specified, and by whom? Doc strings are general Emacs feature, so if it's desirable to have specific parts of them highlighted in certain ways, the first question to ask is which parts will those be, and how will they be identified? From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 21 11:26:43 2023 Received: (at 64769) by debbugs.gnu.org; 21 Jul 2023 15:26:43 +0000 Received: from localhost ([127.0.0.1]:34512 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMs1i-00053Q-Ol for submit@debbugs.gnu.org; Fri, 21 Jul 2023 11:26:43 -0400 Received: from mail-40138.protonmail.ch ([185.70.40.138]:41649) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMs1g-000536-9s for 64769@debbugs.gnu.org; Fri, 21 Jul 2023 11:26:42 -0400 Date: Fri, 21 Jul 2023 15:26:19 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1689953193; x=1690212393; bh=0a957h64n1mfOyhnhOs5ZepB9XmScGg5XjKkEfA+9Ng=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=GjKGbNJymAPvFknIIteLIaKOnwAC3BYs7GaG0wuTpngjuwuHzALf0U0+5GP+Asj+u gupgWXI/8dnjl1ON5q821E8BWGav26euO5xvppmM6LFSPnUt4My4m1gHKqSLugvL8V 9rRpWdVtxt93rp5tHHeMF8Lmc9fc3vAz6uFWXAuJrB79pLn6INSYyWOoAIsam9C3UU h+6aIm4FWsxDhBsziuXaQ7C+PwijPFLk/WcdgdR2OLyQfJ+vLraMwLngO6W5AT6b+Q GhLXlw0zhQz5IZwZm/KWfoejxdrwVATOmzI8nJgE1BmsNP7jqIITjRwNdX9V7q+UDc Fwg3WQMRpZ2+g== To: Eli Zaretskii From: uzibalqa Subject: Re: bug#64769: Docstrings made to print specfied lines in colour Message-ID: In-Reply-To: <83cz0lbaq2.fsf@gnu.org> References: <83cz0lbaq2.fsf@gnu.org> Feedback-ID: 52887082:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 64769 Cc: 64769@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ------- Original Message ------- On Saturday, July 22nd, 2023 at 2:28 AM, Eli Zaretskii wrote= : > > Date: Fri, 21 Jul 2023 13:37:02 +0000 > > From: uzibalqa via "Bug reports for GNU Emacs, > > the Swiss army knife of text editors" bug-gnu-emacs@gnu.org > >=20 > > It would be an improvement if docstrings can be made to print specfied = lines > > in colour. Currently everything is one colour, except executable comman= ds that > > are not expected to have whitespaces. >=20 >=20 > Help buffers do have faces, and you can customize them to use > non-default colors. >=20 > Beyond that, it is not clear what behavior you are asking for. How > will the "specified lines" be specified, and by whom? >=20 > Doc strings are general Emacs feature, so if it's desirable to have > specific parts of them highlighted in certain ways, the first question > to ask is which parts will those be, and how will they be identified? Quite Right. How to identify them is the hard part. A sensible way is to have specific variables or functions that instruct how doc strings get colored (rather than having coloured instructions embedded in the docstring itself). How to specify the colouring instructions is the essential part for how to customise the appearance and behavior of doc strings in Emacs.= =20 Whilst I generally criticise implementation of features, it is evident that other people would have much clever schemes of how things are actually done= . Although I give the impression that I know better, I hardly ever discuss on how an actual implementation should be done in Emacs.=20 A basic start on this would be to provide a list on which lines (or pattern= s) in the docstring need to be coloured differently. One needs to see how oth= ers could approach it with benefits and difficulties pointed out. =20