From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Tino Calancha Newsgroups: gmane.emacs.devel Subject: Re: debbugs-0.10: doc fixes Date: Fri, 23 Sep 2016 16:42:26 +0900 (JST) Message-ID: References: <8737l5sin0.fsf@gmx.de> <8760q0dmxh.fsf@gmx.de> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; format=flowed; charset=US-ASCII X-Trace: blaine.gmane.org 1474620907 3709 195.159.176.226 (23 Sep 2016 08:55:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 23 Sep 2016 08:55:07 +0000 (UTC) User-Agent: Alpine 2.20 (DEB 67 2015-01-07) Cc: larsi@gnus.org, Emacs developers , Tino Calancha To: Michael Albinus Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Sep 23 10:55:03 2016 Return-path: Envelope-to: ged-emacs-devel@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 1bnMFz-000839-Cw for ged-emacs-devel@m.gmane.org; Fri, 23 Sep 2016 10:54:55 +0200 Original-Received: from localhost ([::1]:42375 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bnMFx-0001W6-LU for ged-emacs-devel@m.gmane.org; Fri, 23 Sep 2016 04:54:53 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38169) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bnL8y-0007j9-Eo for emacs-devel@gnu.org; Fri, 23 Sep 2016 03:43:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bnL8s-0000If-GU for emacs-devel@gnu.org; Fri, 23 Sep 2016 03:43:35 -0400 Original-Received: from mail-pa0-f66.google.com ([209.85.220.66]:34022) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bnL8s-0000IZ-At for emacs-devel@gnu.org; Fri, 23 Sep 2016 03:43:30 -0400 Original-Received: by mail-pa0-f66.google.com with SMTP id i5so1553639pad.1 for ; Fri, 23 Sep 2016 00:43:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:date:to:cc:subject:in-reply-to:message-id:references :user-agent:mime-version; bh=SZRZ5qQ4bpj20rURo19jwgUfuMuXtH6mVuyk8ejm6nA=; b=GncUV5pR2DdkcoJ7nkvliV8l+Ohm6by5K13ynkIecbraG0STdi1FS520AQoS/T0dtH 4pcbT191n7umoSxtzq5M2aaDge4BLDRbBGIhFzAdRxLTCd9cjZu5/rY5dHn2gC7aappz A5Bcu2vpN/9MEOx44pC/CaqafiwYS2J2XiFpchkpS7MYgP66wYEIhIr37+ffnmHzPRgX f/o2qz2ytcuBVqnqk5B4hT0cQIQD5hAg88P42/lsQClReX6tKGe3GFNp7DMJdtzTCzfh vrio2DQGuZdpOsV3hHeWRvgHOglYlR6yl3Db2Dzg59TXMYtewR+aPMF3CVEo76C98b6C Q1xw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:date:to:cc:subject:in-reply-to:message-id :references:user-agent:mime-version; bh=SZRZ5qQ4bpj20rURo19jwgUfuMuXtH6mVuyk8ejm6nA=; b=GH80q3TXB0dPbr8hjuIb60m9hqTEpdqtAN37rlemQ2MlhFzAeva7lG03lZuA9uQ+i0 l/t57uZo8hGW8Kb8uztzoWDIGzExK6SJ2QEy/EnidXQDke0OSUj9MmhY4+LCvm1Ne6Dv EN3t7nVPBOB0NjE6cUu2+nkTLqHc76ydFfU5EgvJb0HLPz0DXx5LTfJWzTSAF5G1KfVS PrU/iYrFR5AzilCSPCULgzNfPFBcKSPoq+YUIfTco1Q73nqLruhlGezmcx5diYm6BQdb qp0QdJFu+5IDbvEy8741r+j2CjjIXScDT0U+9BIGEIJs23LYejTV0NjD7y0QiGq5D1rN rL6A== X-Gm-Message-State: AE9vXwP2mHfG1QMdAqEpKgrTngHLr1SH/tedyLVrGMbgqv/YSfY1/L3kEIVPLzH3knienw== X-Received: by 10.66.52.42 with SMTP id q10mr10233662pao.34.1474616549583; Fri, 23 Sep 2016 00:42:29 -0700 (PDT) Original-Received: from calancha-pc (57.92.100.220.dy.bbexcite.jp. [220.100.92.57]) by smtp.gmail.com with ESMTPSA id h82sm9048643pfh.22.2016.09.23.00.42.27 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 23 Sep 2016 00:42:29 -0700 (PDT) X-Google-Original-From: Tino Calancha X-X-Sender: calancha@calancha-pc In-Reply-To: <8760q0dmxh.fsf@gmx.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.220.66 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:207721 Archived-At: On Tue, 13 Sep 2016, Michael Albinus wrote: > I've pushed this to the elpa repository, you might play with it. Within > a week or so, I will release debbugs 0.11. Hi Michal, it looks good. Thank you. I have few suggestions to make the doc strings more clear. See below. >From 6d3d28162e0b3e956a531dd60380243cc5dfd481 Mon Sep 17 00:00:00 2001 From: Tino Calancha Date: Fri, 23 Sep 2016 16:37:01 +0900 Subject: [PATCH] debbugs-gnu.el: Doc fixes * packages/debbugs/debbugs-gnu.el (debbugs-gnu-expand-bug-number-list): Fix typo in doc string. (debbugs-gnu-default-bug-number-list): Explain the meaning of a value like '-N'. (debbugs-gnu-bugs): Clarify in doc string the input format for interactive calls. Show default value in the prompt, i.e., 'debbugs-gnu-default-bug-number-list'. --- packages/debbugs/debbugs-gnu.el | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/packages/debbugs/debbugs-gnu.el b/packages/debbugs/debbugs-gnu.el index 4a69f2b..f8b8726 100644 --- a/packages/debbugs/debbugs-gnu.el +++ b/packages/debbugs/debbugs-gnu.el @@ -1421,7 +1421,7 @@ MERGED is the list of bugs merged with this one." "Dynamic completion table for reading bug numbers.") (defun debbugs-gnu-expand-bug-number-list (bug-number-list) - "Expand BUG-NUMBER-LIST to a list of singe bug numbers. + "Expand BUG-NUMBER-LIST to a list of single bug numbers. BUG-NUMBER-LIST is a list of bug numbers or bug number ranges, as returned by `debbugs-gnu-bugs'." (let (result) @@ -1659,20 +1659,25 @@ The following commands are available: (defcustom debbugs-gnu-default-bug-number-list "-10" "The default value used in interactive call of `debbugs-gnu-bugs'. -It must be a string, containing a comma separated list of bugs or bug ranges." +It must be a string, containing a comma separated list of bugs or bug ranges. +A negative value, -N, means the newest N bugs." :group 'debbugs-gnu :type 'string :version "25.2") ;;;###autoload (defun debbugs-gnu-bugs (&rest bugs) - "List all BUGS, a list of bug numbers." + "List all BUGS, a list of bug numbers. +In interactive calls, prompt for a comma separated list of bugs +or bug ranges, with default to `debbugs-gnu-default-bug-number-list'." (interactive (mapcar 'string-to-number (debbugs-gnu-expand-bug-number-list (or - (completing-read-multiple "Bug numbers: " debbugs-gnu-completion-table) + (completing-read-multiple + (format "Bug numbers (%s): " debbugs-gnu-default-bug-number-list) + debbugs-gnu-completion-table) (split-string debbugs-gnu-default-bug-number-list "," t))))) (dolist (elt bugs) (unless (natnump elt) (signal 'wrong-type-argument (list 'natnump elt)))) -- 2.9.3 Repository revision: 1c1ee85d183daee1d409413226ec739f35499918