From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Jason A. Spiro" Newsgroups: gmane.emacs.bugs Subject: bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file Date: Fri, 19 Dec 2008 01:06:44 -0500 Message-ID: References: <20070401035915.3121.73126.malonedeb@gangotri.ubuntu.com> Reply-To: "Jason A. Spiro" , 1621@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1229678626 30988 80.91.229.12 (19 Dec 2008 09:23:46 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 19 Dec 2008 09:23:46 +0000 (UTC) Cc: 1621@emacsbugs.donarmstrong.com, bug-gnu-emacs@gnu.org To: cpan@ilyaz.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Dec 19 10:24:51 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LDbb8-0003fh-QN for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 Dec 2008 10:24:43 +0100 Original-Received: from localhost ([127.0.0.1]:45785 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LDbZw-00059G-ET for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 Dec 2008 04:23:28 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LDbZr-00058M-JA for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 04:23:23 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LDbZq-00057r-NF for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 04:23:22 -0500 Original-Received: from [199.232.76.173] (port=58431 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LDbZq-00057m-89 for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 04:23:22 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:40866) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LDbZp-0000Gl-OE for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 04:23:22 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mBJ9NJI5004519; Fri, 19 Dec 2008 01:23:20 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mBJ9K3xt003076; Fri, 19 Dec 2008 01:20:03 -0800 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Jason A. Spiro" Original-Sender: jasonspiro@gmail.com Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 19 Dec 2008 09:20:03 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 1621 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: wontfix Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.1229678094896 (code B ref -1); Fri, 19 Dec 2008 09:20:03 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 19 Dec 2008 09:14:54 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mBJ66nQG029170 for ; Thu, 18 Dec 2008 22:06:50 -0800 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LDYVc-0008Lm-QO for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 01:06:48 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LDYVb-0008LP-Qp for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 01:06:48 -0500 Original-Received: from [199.232.76.173] (port=45799 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LDYVb-0008LM-MN for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 01:06:47 -0500 Original-Received: from yw-out-1718.google.com ([74.125.46.153]:51634) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LDYVb-0005cG-8H for bug-gnu-emacs@gnu.org; Fri, 19 Dec 2008 01:06:47 -0500 Original-Received: by yw-out-1718.google.com with SMTP id 9so313756ywk.66 for ; Thu, 18 Dec 2008 22:06:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:sender :to:subject:cc:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:references :x-google-sender-auth; bh=yLFIDJDCbIOgoWCjEsW9GD4MpJnnY+RYNZBvG4As+W8=; b=JddV9E0OCvJK5mB5/OIasL6TGWA+HEsKpAtWvSOfm7IR6v75fXiV3yVPM9HNKpR/uc kiXZBOVQaYG6TsyPBDmA5XmMBked8e+vsibL6245LKUt1KEa0z2eKAfCArZN1DlVwF4D d4h79QFq2X9lJCG3afMF9q57YuYRV+P5jEICA= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :references:x-google-sender-auth; b=gRpQrc8bYNQbDPqy83POifO23eWfwIiux9judbbQP3lSDhageG+C/rMT4zMEv/IBf4 ciwBExivNiKl3h51QR0Ur8PGOaBIwxxkKLyM32eFm7JHUTARpujmEInc47RE1jmYcuI1 +q960L2kFFoI9JYz6ADa1ZYmY9dIz3fihofL8= Original-Received: by 10.90.90.4 with SMTP id n4mr1602323agb.103.1229666804367; Thu, 18 Dec 2008 22:06:44 -0800 (PST) Original-Received: by 10.90.120.1 with HTTP; Thu, 18 Dec 2008 22:06:44 -0800 (PST) In-Reply-To: Content-Disposition: inline X-Google-Sender-Auth: 4d6c523e42d9f02c X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Fri, 19 Dec 2008 04:23:22 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:23371 Archived-At: 2008/12/18 Stefan Monnier wrote: >> Please move the cperl micro-docs from the middle of the cperl-mode.el >> Elisp file to the top of the file. This will make more people see them. > > I suggest we add some text in the Commentary that point people to the > docstrings below. Moving the docstrings wholesale will increase the > merge burden when syncing with Ilya's version. Ilya, could you too please move the micro-docs from the middle of the your cperl-mode.el Elisp file to the top of the file? This will make more people see the micro-docs. And then I hope the GNU Emacs maintainers will adopt your change downstream. Please Reply to All. By the way, I sent mail to this address @ilyaz.org because I could not find any non-Perl-related address to write to. -- Jason Spiro: software/web developer, packager, trainer, IT consultant. I support Linux, UNIX, Windows, and more. Contact me to discuss your needs. +1 (416) 992-3445 / www.jspiro.com