From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Nick Roberts Newsgroups: gmane.emacs.bugs Subject: Re: Missing arglist for char-after Date: Thu, 14 Jun 2007 11:45:06 +1200 Message-ID: <18032.33154.129481.151929@kahikatea.snap.net.nz> References: <18031.28097.22717.134047@kahikatea.snap.net.nz> <200706131744.l5DHiDUg014876@ushabti.sfbay.sun.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1181778327 14069 80.91.229.12 (13 Jun 2007 23:45:27 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 13 Jun 2007 23:45:27 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org To: Whitfield Diffie Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jun 14 01:45:25 2007 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 1HycWi-0001eD-PP for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jun 2007 01:45:25 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HycWi-0005sp-3k for geb-bug-gnu-emacs@m.gmane.org; Wed, 13 Jun 2007 19:45:24 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HycWf-0005si-Rj for bug-gnu-emacs@gnu.org; Wed, 13 Jun 2007 19:45:21 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HycWd-0005sW-7Z for bug-gnu-emacs@gnu.org; Wed, 13 Jun 2007 19:45:20 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HycWd-0005sT-53 for bug-gnu-emacs@gnu.org; Wed, 13 Jun 2007 19:45:19 -0400 Original-Received: from viper.snap.net.nz ([202.37.101.8]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1HycWb-0006Ad-Sm for bug-gnu-emacs@gnu.org; Wed, 13 Jun 2007 19:45:18 -0400 Original-Received: from kahikatea.snap.net.nz (85.62.255.123.dynamic.snap.net.nz [123.255.62.85]) by viper.snap.net.nz (Postfix) with ESMTP id 239663D90D2; Thu, 14 Jun 2007 11:45:09 +1200 (NZST) Original-Received: by kahikatea.snap.net.nz (Postfix, from userid 1000) id 037118F9DD; Thu, 14 Jun 2007 11:45:06 +1200 (NZST) In-Reply-To: <200706131744.l5DHiDUg014876@ushabti.sfbay.sun.com> X-Mailer: VM 7.19 under Emacs 22.1.50.1 X-detected-kernel: Linux 2.4-2.6 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:15873 Archived-At: [2nd attempt] [please cc the mailing list, other people might have better ideas] > Well in mine > > /pkg/gnu/share/emacs/22.1/etc/DOC-22.1.1 > > it looks a little different. I am not certain how to read it so I have > included a bit of context. Mine looks the same. I just left out the control characters (because I wasn't sure what mail would do to them). > (fn)Feolp > Return t if point is at the end of a line. > `End of a line' includes point being at the end of the buffer. > > (fn)Fchar-after > Return character in current buffer at position POS. > POS is an integer or a marker and defaults to point. > If POS is out of range, the value is nil. > > (fn &optional POS)Fchar-before > Return character in current buffer preceding position POS. > POS is an integer or a marker and defaults to point. > If POS is out of range, the value is nil. > > The context makes it look as though char-after is screwed up but char-before > is ok. However, asking for a description of the function char-before > produces the same result No this is alright. The arglist comes _after_ the documentation, so the (fn &optional POS) you see is for Fchar-after and the one for Fchar-before (not shown) is attached to Fuser-login-name. I'm afrraid I don't know why it doesn't work for you. You need to use Edebug on describe-function-1: 1) Do `C-u ESC C-x' inside describe-function-1. 2) C-h f char-after 3) The function describe-function-1 should appear in a buffer. Move to the beggining of the line: (let* ((arglist (help-function-arglist def)) and press h. 4) Step through describe-function-1 (press SPC). 5) See what value the variable `usage' has. I suspect that it is nil but it should be: ("(char-after &optional POS)" . "Return character in current buffer at position POS.\nPOS is an integer or a marker and defaults to point.\nIf POS is out of range, the value is nil.") This value comes from the DOC file through help-split-fundoc and documentation. -- Nick http://www.inet.net.nz/~nickrob