From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Thierry Volpiatto Newsgroups: gmane.emacs.bugs Subject: bug#70163: 29.3; hexl-mode incorrect docstring Date: Wed, 03 Apr 2024 17:04:04 +0000 Message-ID: <87a5mal6nv.fsf@posteo.net> References: <871q7mlc9v.fsf@posteo.net> <86plv68myf.fsf@gnu.org> <878r1ucsgq.fsf@igel.home> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6659"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 70163@debbugs.gnu.org, Eli Zaretskii , Stefan Monnier To: Andreas Schwab Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Apr 03 19:03:21 2024 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 1rs41A-0001UE-LX for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 03 Apr 2024 19:03:20 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rs40t-0003dq-Mo; Wed, 03 Apr 2024 13:03:03 -0400 Original-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 1rs40q-0003dE-T2 for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2024 13:03:00 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rs40q-0004YW-K5 for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2024 13:03:00 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rs40v-0005Cm-1l for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2024 13:03:05 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Thierry Volpiatto Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 03 Apr 2024 17:03:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 70163 X-GNU-PR-Package: emacs Original-Received: via spool by 70163-submit@debbugs.gnu.org id=B70163.171216378219985 (code B ref 70163); Wed, 03 Apr 2024 17:03:04 +0000 Original-Received: (at 70163) by debbugs.gnu.org; 3 Apr 2024 17:03:02 +0000 Original-Received: from localhost ([127.0.0.1]:59411 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rs40q-0005Bw-O2 for submit@debbugs.gnu.org; Wed, 03 Apr 2024 13:03:02 -0400 Original-Received: from mout01.posteo.de ([185.67.36.65]:33979) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rs40o-0005BX-9v for 70163@debbugs.gnu.org; Wed, 03 Apr 2024 13:02:59 -0400 Original-Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id B5140240029 for <70163@debbugs.gnu.org>; Wed, 3 Apr 2024 19:02:47 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1712163767; bh=WUVCbVEb7e5W7/CxRn2E1hVC6SVv4rK42kpl4AM6taA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type: Autocrypt:OpenPGP:From; b=ho7pa9b/oALGIY03DvHyQ9OvYIQtuaNeiu8Vm92MWi1U74Fv3lLmf9FrjbPQxXff3 kBoejXuAtTgFfURWvdILdVvSH1GAGn90CpyTUFQAO+OK5VPAB8lOCKJXJD7ULe8j/S jQ27E0GvsS5grPqyzhCPM/OvhrM16DAzvRjT8DfAOZ6xsvsMEmeZiCbYCez7DqYf6K 0VXRg4KEk4NG/qSayNRKQBqJtotd9WRhiguWGc4+6S6tBlMOuxSYy6uh6HFSEU//Vv pgLlWwWoIwi8Q09wCmlx4ZCHYbdA5j/DUG7bP8/6j5d8ptkxMm9fWABwSaWgXOLIfj iDzcI3ZOMbzzA== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4V8rfD57fhz9rxP; Wed, 3 Apr 2024 19:02:44 +0200 (CEST) In-Reply-To: <878r1ucsgq.fsf@igel.home> (Andreas Schwab's message of "Wed, 03 Apr 2024 18:37:57 +0200") Autocrypt: addr=thievol@posteo.net; prefer-encrypt=mutual; keydata=xsDNBF8ylcIBDADG+hy+zR6L4/vbdDDZuSaMmSrU3A5QZJpeBCvxTr7MpzzruZbhLPW1K3R6N2MA edi8Y+C8o27FVRIjpdbaKMGu9je7JV/TbUQYo3SOwCK1vM4LUn4V6ZLzSYkuiEt4eyMoiDdyvN0p kcK6P9x9DCetcEVszXzQg+yzCVrQ2hXWDXWT4M18EC3wtO7RHPouMqGiwBFhBAYErCqFWFxQHkfb tG/4yGyJ58rglb65O3qijjMWvYwcWZun9/7qm8Z4/4mHopmo2zgU+OrptnLSZfkZGz3Y7Uf452xQ GVq0Fv75NPvQru7y+DYVhuVXXyAmGxt+vf4rIiixMBbhKEPjcxEPAa2LTzex2IsTZR+QVG9uDnqC WcgaOEQ58fzXNvNhtwwF/Rgio2XWAJVdmFWS59/k9W58CIUSNKBMZh2XeGdEmtHvDtCxW3z6FJha 36RzOM3fMNNiAGdFZJA84gcdloJR+sHCDTTPT3784fjr+V8An7sI581NGFzkRQqPvEQCZbUAEQEA Ac0SdGhpZXZvbEBwb3N0ZW8ubmV0wsEOBBMBCgA4AhsDBQsJCAcCBhUKCQgLAgQWAgMBAh4BAheA FiEEI9twfRN7r3nig/xwDsVtFB0W75MFAmL3HCoACgkQDsVtFB0W75OVEAv/f6XxmtIFz08fUb8h Bp/zJP6IC4/rhhh+0GMRIRzLN8DK0jV8JCzYdFHiRJOy2lNIOpmrrCmjRRxferc2G42+ePFIsslx hU46VSz1Z83NwIG3mpdYNV5WUTUdgzxExHTNTFCd7NKv0nlHKQaA OpenPGP: url=https://posteo.de/keys/thievol@posteo.net.asc; preference=encrypt X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:282577 Archived-At: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Andreas Schwab writes: > On Apr 03 2024, Eli Zaretskii wrote: > >>> From: Thierry Volpiatto >>> Date: Wed, 03 Apr 2024 15:02:52 +0000 >>>=20 >>>=20 >>> Hexl-mode docstring specify "\" in its first line, this >>> to specify some keybinding related to this map at end, as a result the >>> documentation command returns a three line string, the first line beeing >>> a blank line until hexl.el is loaded. I think docstrings generally >>> should not have this specification in their first line. >>>=20 >>> (defun hexl-mode (&optional arg) >>> "\\A mode for editing binary files in hex dump for= mat. >>> [...]=20 >>> Most cursor movement bindings are the same: use \\[hexl-backward-= char], >>> [...] >> >> What do you suggest to do instead? > > Customary is to put it directly before the (first) keymap reference. Exactly. =2D-=20 Thierry --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQHHBAEBCgAxFiEEI9twfRN7r3nig/xwDsVtFB0W75MFAmYNjAUTHHRoaWV2b2xA cG9zdGVvLm5ldAAKCRAOxW0UHRbvk8skC/4ix8gOKschXiWcCOBvN5B8Shn/H5yz e9InuUPmENhWB4kToe4bKNPGXZT2tH/OsBZoedsD3MNRcVuY84A+2i4Kk7pVnXji PpnpYsugEDkp+L7rc5yELOtA0/6qkTdjrxswNBN7N3grR/wGZpM2gWAaQY5+FmdF W4UU/Vw/grEBkPjB6aOLWIV5oezIpBfQQobn1j9CWfz8XECE0h8TM5FvK1g5ItPW dQnLNtA1KgWbV8h0WATzbhW4c6J2T/32eISJFsOdpTvN8dLOFKsyCneKpS55xB/3 2IOxhy45oRbdtkjYTr9MkBFrZtHPX8nMzsW+WScN/+jjEInPWSuxpExULIgUHIW/ NhTMfqI6AkKJGzxUDq42YmRuj0r67JvsHImtyrK9j00wqHumim1Dwkwt1aUiF3V1 OQNs7LqORRF1kHzXQDnW53BScMxpwwEOUYKFKnuBJaQRu926viqDZdUUpJwbLqr6 FKjTpWMTGTm2Ccz0WLxwid8kSBckYifipeA= =KpT7 -----END PGP SIGNATURE----- --=-=-=--