Missing arglist for char-after

Missing arglist for char-after

[Whitfield Diffie]

    I typed <esc>help<cr>fchar-after<cr>

and got the following result:

char-after is a built-in function.
[Missing arglist.  Please make a bug report.]

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)

[back]




In GNU Emacs 22.1.1 (sparc-sun-solaris2.8, GTK+ Version 2.11.1)
 of 2007-06-11 on pkg-build
configured using `configure  '--prefix=/pkg/gnu' '--x-includes=/pkg/gnome/include:/usr/X11/include:/usr/openwin/include:/usr/dt/include:/pkg/X11/include' '--x-libraries=/pkg/gnome/lib:/usr/X11/lib:/usr/openwin/lib:/usr/dt/lib:/pkg/X11/lib' '--with-x' '--with-x-toolkit=gtk' '--with-pkg-config-prog=/usr/bin/pkg-config' '--with-xpm' '--with-jpeg' '--with-tiff' '--with-gif' '--with-png' 'CC=gcc' 'CFLAGS= -O3 -mv8 -mtune=ultrasparc' 'LDFLAGS=-L/pkg/local/lib -R/pkg/local/lib -L/pkg/gnu/lib -R/pkg/gnu/lib' 'CPPFLAGS=-I/pkg/local/include -I/pkg/local/include/libpng -I/pkg/gnu/include''

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: nil
  locale-coding-system: nil
  default-enable-multibyte-characters: t

Major mode: Fundamental

Minor modes in effect:
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  unify-8859-on-encoding-mode: t
  utf-translate-cjk-mode: t
  auto-compression-mode: t
  column-number-mode: t
  line-number-mode: t

Recent input:
s t SPC f o r SPC c h a r - a f t e r RET ESC < C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-p C-x o C-x b 
* H TAB RET C-x h C-w C-x o C-x o C-x o ESC x h e l 
p RET d c h a r - a f t e r RET ESC x h e l p RET f 
c h a r - a f t e r RET C-x o ESC > C-w C-x o C-y C-x 
C-x C-o C-o SPC SPC SPC SPC I SPC t y p e d SPC h e 
= DEL DEL DEL < e s c > SPC DEL h e l p SPC f o l l 
DEL DEL DEL DEL DEL f c h a r - a f t e r < c r > RET 
RET a n d SPC g o t SPC t h e SPC f o l l o w i n g 
SPC r e s u l t : C-a C-n C-n C-n C-n C-n C-n C-n C-p 
C-p C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n C-v 
C-n C-n C-n C-n C-n C-p C-p C-n C-n C-n C-x h C-w C-x 
k RET y e s RET C-x 1 C-p C-n C-p C-x k RET C-x k RET 
C-x b f o o RET ESC C-g ESC x C-g ESC x e DEL h e l 
p RET f c h a r - a f t e r RET ESC x r e p o r t - 
e m a c s - b u g RET

Recent messages:
185 messages, 1 new, 0 unread. [2 times]
Type C-x 1 to remove help window.  
Loading emacsbug...done
Modification-flag cleared
Mark set [3 times]
Loading apropos...done
No apropos matches for `char-after'
Mark set [4 times]
Quit
Type C-x 1 to remove help window.  
				Tuesday  12 June 2007  at 17:22

Re: Missing arglist for char-after

[Nick Roberts]

 >     I typed <esc>help<cr>fchar-after<cr>
 
C-h f <RET> char-after <RET>?

 > and got the following result:
 > 
 > char-after is a built-in function.
 > [Missing arglist.  Please make a bug report.]
 > 
 > 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)
 > 
 > [back]

Someone else might know more than me, but until they say something, what does
your entry for char-after look like in etc/DOC-22.1.1?

In between control characters my DOC file looks like this:

    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)

i.e Is the optional argument POS present?

-- 
Nick                                           http://www.inet.net.nz/~nickrob

 > In GNU Emacs 22.1.1 (sparc-sun-solaris2.8, GTK+ Version 2.11.1)
 >  of 2007-06-11 on pkg-build
 > configured using `configure  '--prefix=/pkg/gnu' '--x-includes=/pkg/gnome/include:/usr/X11/include:/usr/openwin/include:/usr/dt/include:/pkg/X11/include' '--x-libraries=/pkg/gnome/lib:/usr/X11/lib:/usr/openwin/lib:/usr/dt/lib:/pkg/X11/lib' '--with-x' '--with-x-toolkit=gtk' '--with-pkg-config-prog=/usr/bin/pkg-config' '--with-xpm' '--with-jpeg' '--with-tiff' '--with-gif' '--with-png' 'CC=gcc' 'CFLAGS= -O3 -mv8 -mtune=ultrasparc' 'LDFLAGS=-L/pkg/local/lib -R/pkg/local/lib -L/pkg/gnu/lib -R/pkg/gnu/lib' 'CPPFLAGS=-I/pkg/local/include -I/pkg/local/include/libpng -I/pkg/gnu/include''

> ....

Re: Missing arglist for char-after

[Nick Roberts]

[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)\x1fFeolp
 >     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)\x1fFchar-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)\x1fFchar-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 <RET> char-after <RET>
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