From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: John Shahid Newsgroups: gmane.emacs.bugs Subject: bug#10754: define-minor-mode and doc of derived mode Date: Thu, 07 Jun 2018 11:20:07 +0000 Message-ID: <87po12g7x4.fsf@gmail.com> References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1528370347 22646 195.159.176.226 (7 Jun 2018 11:19:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 7 Jun 2018 11:19:07 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 10754@debbugs.gnu.org To: Glenn Morris Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jun 07 13:19:03 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQswY-0005nK-PV for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Jun 2018 13:19:02 +0200 Original-Received: from localhost ([::1]:56995 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQsyf-0003oE-Sj for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Jun 2018 07:21:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54507) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQsyZ-0003o9-Hn for bug-gnu-emacs@gnu.org; Thu, 07 Jun 2018 07:21:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fQsyU-0006X2-Ux for bug-gnu-emacs@gnu.org; Thu, 07 Jun 2018 07:21:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:57828) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fQsyU-0006Wq-Pu for bug-gnu-emacs@gnu.org; Thu, 07 Jun 2018 07:21:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fQsyU-00029i-H8 for bug-gnu-emacs@gnu.org; Thu, 07 Jun 2018 07:21:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: John Shahid Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 07 Jun 2018 11:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10754 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10754-submit@debbugs.gnu.org id=B10754.15283704228204 (code B ref 10754); Thu, 07 Jun 2018 11:21:02 +0000 Original-Received: (at 10754) by debbugs.gnu.org; 7 Jun 2018 11:20:22 +0000 Original-Received: from localhost ([127.0.0.1]:37492 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQsxq-00028G-Le for submit@debbugs.gnu.org; Thu, 07 Jun 2018 07:20:22 -0400 Original-Received: from mail-qk0-f177.google.com ([209.85.220.177]:34930) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQsxp-000283-9t for 10754@debbugs.gnu.org; Thu, 07 Jun 2018 07:20:21 -0400 Original-Received: by mail-qk0-f177.google.com with SMTP id d130-v6so6211926qkc.2 for <10754@debbugs.gnu.org>; Thu, 07 Jun 2018 04:20:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version; bh=RD4ABsNPCCoR3aJpJGsMLiNAaE0hv7gcnn9gPwIsVmA=; b=TvPF+fvUYmA6oRtF4gmjrLct/mnaOAYJzZ1BqPJKAb2hLZTMeVYp/WK94lUmrgjz89 m7QidLztsWMSPh7+AK1b5NFLbRxBDcMSsx4Q4gJVBFNpPo/6spsUeGeduuQ97E5RC01w KhT2DQ5K2w6fgs1J24hqPNU4pXVddg5huQyw/LvblGR3MrH84tfSHnAPWkheMpG3hJN2 n5ABpMlhzcFnsQKAE7ioRA+xOr3B691T7eWpy+G1x9UdcHBh8JBrQlzUaipY/WdzuP26 atqwCgKJuUI5uGg19bI9D/IdMuhElF0p0a5wr44wakEa3AWyX5LDCHNGcNfLmIpOka+Q bSpQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references :user-agent:date:message-id:mime-version; bh=RD4ABsNPCCoR3aJpJGsMLiNAaE0hv7gcnn9gPwIsVmA=; b=IINOicpQ2tR5ZQCroFE5dV8T0XEPYcebene7AvO6hpWBWy3W38Z3uvG/yy2lhCobhR 18g6IbfcjhY7pDIhRQDwKx1VH9hEiJuJ7NLdDdhijDey7KF+6JHQ3SIwaPabQHS/tUUl fS9SYg6MdJd0wMydLyi568csqNCVn+PqDkzhxU8HQmK9rxQ3cGLwxV6oZS9XzgJPThsE xy5E/plNloK5nHJV/XZGsirFYCJ4r3svMmM4bZYt2qUDhusd4os707OtLJzu0bW63vft rMRbAmbYhzSrrcTCglr51CaKJstJb3ZcABdj5m5Wx2bW+c8eI2xzhgfMbDIUJwWsfIZ0 S0WA== X-Gm-Message-State: APt69E2evLRKz4oyprC/EtnoRo7pFuCk92jzrHxpEycDtFZeo3pGL81g 54cBenE7isi5QTr7jhHY4cy1mh1j X-Google-Smtp-Source: ADUXVKKmJyLiN1R/OMMfBUeu3rAKTdz8VGsvumsVAgc+gEFCwXMlnvjgp1+K4fBPy92qidiB+Cl4Dw== X-Received: by 2002:ac8:3578:: with SMTP id z53-v6mr1191093qtb.323.1528370415262; Thu, 07 Jun 2018 04:20:15 -0700 (PDT) Original-Received: from aac4ac2463d3 (cpe-184-152-55-93.nyc.res.rr.com. [184.152.55.93]) by smtp.gmail.com with ESMTPSA id h43-v6sm15070157qth.6.2018.06.07.04.20.13 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 07 Jun 2018 04:20:14 -0700 (PDT) In-Reply-To: (Glenn Morris's message of "Tue, 07 Feb 2012 15:27:55 -0500") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:147128 Archived-At: Reposting to the thread instead of sending this just to Glenn. There are over 200 modes that use define-minor-mode. I'm not sure how many of those docstring have argument documentation. For some of those modes documenting arg doesn't make much sense. For those who have an arg document, does it make sense to do them all in a single patch ? Also, is there any consensus on using %{arg} ? I have a local patch with linum-mode changed, which I can send for review.