From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alexis Newsgroups: gmane.emacs.devel Subject: Re: 4K Bugs Date: Sat, 09 Jan 2016 13:52:25 +1100 Message-ID: <87fuy7piqe.fsf@gmail.com> References: <87mvszdp6b.fsf@gnus.org> <8737u9kv6f.fsf@russet.org.uk> <87oacwq240.fsf@gmail.com> <8737u8i5jr.fsf@gmx.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; format=flowed X-Trace: ger.gmane.org 1452307978 4697 80.91.229.3 (9 Jan 2016 02:52:58 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Jan 2016 02:52:58 +0000 (UTC) Cc: emacs-devel@gnu.org To: Michael Albinus Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jan 09 03:52:47 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aHje2-0006XU-HG for ged-emacs-devel@m.gmane.org; Sat, 09 Jan 2016 03:52:46 +0100 Original-Received: from localhost ([::1]:38752 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHjdy-0007jM-9N for ged-emacs-devel@m.gmane.org; Fri, 08 Jan 2016 21:52:42 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44114) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHjdu-0007j1-QP for emacs-devel@gnu.org; Fri, 08 Jan 2016 21:52:39 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aHjdr-0003o6-Jo for emacs-devel@gnu.org; Fri, 08 Jan 2016 21:52:38 -0500 Original-Received: from mail-pf0-x233.google.com ([2607:f8b0:400e:c00::233]:33320) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHjdr-0003mY-DG for emacs-devel@gnu.org; Fri, 08 Jan 2016 21:52:35 -0500 Original-Received: by mail-pf0-x233.google.com with SMTP id e65so17801448pfe.0 for ; Fri, 08 Jan 2016 18:52:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=references:from:to:cc:subject:in-reply-to:date:message-id :mime-version:content-type; bh=0o6AUSYtIQBd5uTyjYAQClXSKYXO1kHsIiSwoSulNQI=; b=lPOe+ezW1jcr7Wn6gqYAHZXMdid2/BUKAp5A7CpaB2648izVsXqJxVFOYlIMsOKJag 5CZZhyzqwRmLyMy9FIW8JCEe/F61M9UjIVJ1HvnF/de7ABIooq1OoRpHYm4f1q9SM6Q8 lq+49KqjuxhHQuL3U4+tYp1/peWmf5AoB0ToXmnVTW91nYJ14hb8SYmNV2ymndPcTlDB GMydaQASITuMtB5ef5Q52Y3JxueCLyndboIixJXXfK+aWc4atw/XqjIbwsMfobtr1LqY cwM1nh7ty6LzlJGLuNTGx7jG/UHy0SWcaDtt/5hJjUlvRnIBjYSCpP2ch744P7Or9RnV xaCw== X-Received: by 10.98.32.156 with SMTP id m28mr9020540pfj.74.1452307952559; Fri, 08 Jan 2016 18:52:32 -0800 (PST) Original-Received: from localhost ([120.21.212.14]) by smtp.gmail.com with ESMTPSA id q89sm7613807pfa.70.2016.01.08.18.52.29 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 08 Jan 2016 18:52:31 -0800 (PST) In-reply-to: <8737u8i5jr.fsf@gmx.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c00::233 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:197866 Archived-At: Hi Michael, Thanks for your response! Michael Albinus writes: > Again, there is the README. i didn't even think to actively look for a distinct README! i typically look for such information by moving point to the package name in the `package-list-packages` list, then pressing RET (`describe-package`). For the packages i maintain, doing so opens a buffer showing, amongst other things, the 'Commentary' section of the package headers, which is where i maintain user-level documentation. (i use the `el2markdown` package to create a README.md file from this section for GitHub.) When i do that for the `debbugs` package, the 'Commentary' section of `debbugs.el` isn't displayed at all, for some reason. And although `debbugs-gnu.el` does have an extensive 'Commentary' section, that's not accessible via `describe-package`. At any rate, thanks for the heads-up about the README; i'll certainly remember to look for such docs in the future. > As said, for bugs marked "done" this might be the better > default. Bugs marked "unreproducible" are prominent candidates > to be marked also as "done", therefore they shouldn't be > suppressed I believe. *nod* Okay, good point. > Yes, a short message "Control message foo sent" might > beuseful. Will do. Thanks! > I've mentioned the User Guide in the README now. And in the > Programmer's Guide, I've added a link to the User Guide. Great, thank you. :-) Alexis.