unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* Missing arglist for char-after
@ 2007-06-13  0:24 Whitfield Diffie
  2007-06-13  4:08 ` Nick Roberts
  0 siblings, 1 reply; 3+ messages in thread
From: Whitfield Diffie @ 2007-06-13  0:24 UTC (permalink / raw)
  To: bug-gnu-emacs

    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

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Missing arglist for char-after
  2007-06-13  0:24 Missing arglist for char-after Whitfield Diffie
@ 2007-06-13  4:08 ` Nick Roberts
       [not found]   ` <200706131744.l5DHiDUg014876@ushabti.sfbay.sun.com>
  0 siblings, 1 reply; 3+ messages in thread
From: Nick Roberts @ 2007-06-13  4:08 UTC (permalink / raw)
  To: Whitfield Diffie; +Cc: bug-gnu-emacs

 >     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''

> ....

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Missing arglist for char-after
       [not found]   ` <200706131744.l5DHiDUg014876@ushabti.sfbay.sun.com>
@ 2007-06-13 23:45     ` Nick Roberts
  0 siblings, 0 replies; 3+ messages in thread
From: Nick Roberts @ 2007-06-13 23:45 UTC (permalink / raw)
  To: Whitfield Diffie; +Cc: bug-gnu-emacs

[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

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2007-06-13 23:45 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2007-06-13  0:24 Missing arglist for char-after Whitfield Diffie
2007-06-13  4:08 ` Nick Roberts
     [not found]   ` <200706131744.l5DHiDUg014876@ushabti.sfbay.sun.com>
2007-06-13 23:45     ` Nick Roberts

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).