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: Sat, 20 Dec 2008 18:41:36 -0500 Message-ID: References: <20070401035915.3121.73126.malonedeb@gangotri.ubuntu.com> <20081220225309.GA17257@powdermilk.math.berkeley.edu> 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 1229817822 18818 80.91.229.12 (21 Dec 2008 00:03:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 21 Dec 2008 00:03:42 +0000 (UTC) Cc: 1621@emacsbugs.donarmstrong.com, bug-gnu-emacs@gnu.org To: "Ilya Zakharevich" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 21 01:04:46 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 1LEBoI-00044S-Uf for geb-bug-gnu-emacs@m.gmane.org; Sun, 21 Dec 2008 01:04:43 +0100 Original-Received: from localhost ([127.0.0.1]:36677 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LEBn6-0000LL-Mb for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Dec 2008 19:03:28 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LEBn2-0000Ks-3g for bug-gnu-emacs@gnu.org; Sat, 20 Dec 2008 19:03:24 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LEBn1-0000Kc-BL for bug-gnu-emacs@gnu.org; Sat, 20 Dec 2008 19:03:23 -0500 Original-Received: from [199.232.76.173] (port=57306 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LEBn1-0000KQ-1o for bug-gnu-emacs@gnu.org; Sat, 20 Dec 2008 19:03:23 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:53890) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LEBn0-0001kh-9s for bug-gnu-emacs@gnu.org; Sat, 20 Dec 2008 19:03: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 mBL03Jip019627; Sat, 20 Dec 2008 16:03:19 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mBKNo48i016171; Sat, 20 Dec 2008 15:50:04 -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: Sat, 20 Dec 2008 23:50:04 +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 1621-submit@emacsbugs.donarmstrong.com id=B1621.122981650014705 (code B ref 1621); Sat, 20 Dec 2008 23:50:04 +0000 Original-Received: (at 1621) by emacsbugs.donarmstrong.com; 20 Dec 2008 23:41:40 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from yw-out-2324.google.com (yw-out-2324.google.com [74.125.46.31]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mBKNfa2P014699 for <1621@emacsbugs.donarmstrong.com>; Sat, 20 Dec 2008 15:41:37 -0800 Original-Received: by yw-out-2324.google.com with SMTP id 3so527521ywj.31 for <1621@emacsbugs.donarmstrong.com>; Sat, 20 Dec 2008 15:41:36 -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=dpdBgCoEslxUs4oa/ZNXaVdOYTMLKv8yu7OqJy8u6pQ=; b=NjOmNXPDtJErQZWLet88ATxiyHSGsNnf+8Kpk6hPBmh63fYc4JX1ekk0PWi0m6zBjY tFBi0RCrO2iqeUqWggzTXPsodjKbzb00w4TtJmNs0Gy8tp6o5jdbR6/vlYcBIqzNq6sw 7hOce7/5yVQtu+vbir/vChGAyMzvyoUiD1znY= 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=SY0XS+etdxpfdlW/19Ug9vq58318B7//ELi+5fR4IyAr//dLnG6D78CzfLpED5nwNa M3WaOy0uiiT2siner4Cyq8XXXaPH10DxA4T4OSZMLkk1yW88rALyQQBTsm4Vwy1SPUn6 frsfTJkvdnjjRvIXl6gc0g3R0j13jO4f98hMg= Original-Received: by 10.90.70.15 with SMTP id s15mr2563091aga.82.1229816496233; Sat, 20 Dec 2008 15:41:36 -0800 (PST) Original-Received: by 10.90.120.1 with HTTP; Sat, 20 Dec 2008 15:41:36 -0800 (PST) In-Reply-To: <20081220225309.GA17257@powdermilk.math.berkeley.edu> Content-Disposition: inline X-Google-Sender-Auth: 47b6611e37e8c2a9 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Sat, 20 Dec 2008 19:03:23 -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:23400 Archived-At: 2008/12/20 Ilya Zakharevich : > Could you please explain to me the mental model of people who would > read the code of CPerl, but not the mode help, and would not explore > the mode menu? I don't know why that mental model has happened. But I know it happened to me. I don't expect help to be located halfway through a Lisp file. I expect it to be either in Info format or as docstrings or near the top of the file. :) Remember, the change I am suggesting is an easy one to make.