From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.devel Subject: Re: Feature Request: Help: Display Relevant Bits First? Date: Sat, 02 Apr 2022 17:36:31 +0300 Message-ID: <871qyf4knk.fsf@tcd.ie> References: <25158.3468.429616.238692@google.com> <87czhzlhbz.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29568"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: "T.V Raman" , emacs-devel@gnu.org To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Apr 02 16:37:31 2022 Return-path: Envelope-to: ged-emacs-devel@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 1naesc-0007Oo-W5 for ged-emacs-devel@m.gmane-mx.org; Sat, 02 Apr 2022 16:37:31 +0200 Original-Received: from localhost ([::1]:45066 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1naesb-0006mF-Dq for ged-emacs-devel@m.gmane-mx.org; Sat, 02 Apr 2022 10:37:29 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:50860) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1naerm-00065X-SE for emacs-devel@gnu.org; Sat, 02 Apr 2022 10:36:38 -0400 Original-Received: from [2a00:1450:4864:20::535] (port=38696 helo=mail-ed1-x535.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1naerk-0005fV-Gx for emacs-devel@gnu.org; Sat, 02 Apr 2022 10:36:38 -0400 Original-Received: by mail-ed1-x535.google.com with SMTP id f18so1017104edc.5 for ; Sat, 02 Apr 2022 07:36:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd.ie; s=google21; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=nyE4f6N25tsp/p34CixXzT0tDURWkrohc6Oiy7JpUlk=; b=OP8F5lzpWPf78KW4HrlT7irEl8qkVTLK3qZ7lYqq5Fi9BCEAIkGcm6jvuil/HrCVGp NhjO2N75s1AhtsoKuw38gNr6zPOV+wJr1z5n4SdW1QVXKpEvXlV6ML/Y8rrtheTIsW8e YJZKU5vLSI9wNsIDuHQMDxShG9r4wa8z36dtsQdLGsui13dPlnbV/CzLU7A/HnMV4200 Xq4zQZ+8GRC06NI4G0M+H9YGW/dET+QMqCxP/RY6tRI9LlFs5kJpxYdtF/f8gwzFfSr8 RQHApJBhMzBNSoVP9NvfIHWDbv7FS2z+p7h0Gbftb+rhi7Vk9FpK8cxddTLMADz6pIo7 4oKw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=nyE4f6N25tsp/p34CixXzT0tDURWkrohc6Oiy7JpUlk=; b=rLOxZW4qg4rMfS12P8eVTi4pRVbv6k9/IyqnbR1nkezljyxh+cYkSviQUw8bZ+IY8X Rd+kajgPKbEDvcRausZMatMfsREhdQhTVSe1rHZYLkf7DEYXeupeiYWon4i1mMEN2zNi 2QKmCm3JILPITpQCRBmfKawv05LVEV9WKDLQ2ZGh3oBuQFZyQGNCrryiyyQaz6P0dDB9 r/TEsxXptMVSqoJwV0wPfNf9sziiFkz4UCYnzA3WSiaIodT1PwWt3AmKIYnYAytQLeUC /xVczm/dlFmwcsNVI94LW35/0WiRy8V4eoaAgdsi+biguju/hRMQQ60H5mtCEGoEcX2h LkxA== X-Gm-Message-State: AOAM5326xlzd/8Cn1syxxdIEBuH3xDGVfIDiK21JdThfenkVlpmQODQv Rhhn6ymRM3fLsvf7g8dUVBjY3w== X-Google-Smtp-Source: ABdhPJwtrN30lhwf5nLMhoWoJGfUvvSjgPz0ph/gXHxMr98NQDJ2XFx4XIcLS44OWYr7Yz82BtEdFg== X-Received: by 2002:a05:6402:35c2:b0:419:9383:4123 with SMTP id z2-20020a05640235c200b0041993834123mr25924118edc.28.1648910193159; Sat, 02 Apr 2022 07:36:33 -0700 (PDT) Original-Received: from localhost ([2a02:587:3287:1e37:d190:f351:e468:6814]) by smtp.gmail.com with ESMTPSA id y8-20020a50d8c8000000b0041c80bb88c7sm2007890edj.8.2022.04.02.07.36.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 02 Apr 2022 07:36:32 -0700 (PDT) In-Reply-To: <87czhzlhbz.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sat, 02 Apr 2022 15:56:16 +0200") X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a00:1450:4864:20::535 (failed) Received-SPF: pass client-ip=2a00:1450:4864:20::535; envelope-from=contovob@tcd.ie; helo=mail-ed1-x535.google.com X-Spam_score_int: -6 X-Spam_score: -0.7 X-Spam_bar: / X-Spam_report: (-0.7 / 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, PDS_HP_HELO_NORDNS=0.659, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:287711 Archived-At: Lars Ingebrigtsen [2022-04-02 15:56 +0200] wrote: > "T.V Raman" writes: > >> At present, if you do describe-function on any command that toggles a >> mode, you get a lot of common boiler-plate, with the salient bits >> about that particular function at the end -- could we reverse this? > > I agree completely, especially as the boilerplate has expanded over the > years. I've now moved it to the end of the doc strings in Emacs 29. Thanks, but the changes in easy-mmode.el don't bootstrap, maybe because they rely on subr-x.el definitions that are autoloaded only after some of easy-mmode.el's clients, such as files.el, are loaded in loadup.el. -- Basil