emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

doc-strings in src/ and the first line


From: Pavel Janík
Subject: doc-strings in src/ and the first line
Date: Tue, 13 Nov 2001 09:20:30 +0100
User-agent: Gnus/5.090004 (Oort Gnus v0.04) Emacs/21.1.50 (i386-suse-linux-gnu)

Hi,

as you probably know (and it is now explicitly mentioned in the Elisp
Reference manual), the first line of the documentation string should stand
on its own (this is exact citation ;-). While converting doc-strings to
new syntax, I have fixed many simple and clear cases, but these
remain. Any volunteer to go through them?

./buffer.c:5163:                     doc: /* Default value of 
`scroll-up-aggressively' for buffers that
./buffer.c:5169:                     doc: /* Default value of 
`scroll-down-aggressively' for buffers that
./buffer.c:5176:                     doc: /* Analogous to `mode-line-format', 
but for the mode line that can be
./buffer.c:5293:                     doc: /* *Non-nil means do not display 
continuation lines;
./buffer.c:5335:                     doc: /* Name of file for auto-saving 
current buffer,
./buffer.c:5352:                     doc: /* Non-nil enables selective display:
./category.c:122:       doc: /* Return a category which is not yet defined in 
CATEGORY-TABLE.  If no
./coding.c:7268:               doc: /* Coding system to use with system 
messages.  Also used for decoding
./dispnew.c:6618:              doc: /* A symbol naming the window-system under 
which Emacs is running
./doc.c:465:       doc: /* Used during Emacs initialization, before dumping 
runnable Emacs,
./eval.c:3289:         doc: /* *Non-nil means automatically display a backtrace 
buffer
./fileio.c:3178:       doc: /* Return t if file FILENAME is the name of a 
directory as a file,
./filelock.c:695:       doc: /* Unlock the file visited in the current buffer,
./filelock.c:717:       doc: /* Return nil if the FILENAME is not locked,
./floatfns.c:841:       doc: /* Return the smallest integer no less than ARG.  
(Round toward +inf.)
./floatfns.c:850:       doc: /* Return the largest integer no greater than ARG. 
 (Round towards -inf.)
./print.c:744:       doc: /* Return a string containing the printed 
representation of OBJECT,
./sunfns.c:211:       doc: /* Change the Sun mouse cursor icon.  ICON is a lisp 
vector whose 1st element
./w32fns.c:7184:       doc: /* Return a list of BDF fonts in DIR, suitable for 
appending to
./w32fns.c:14296:               doc: /* Alist linking Emacs character sets to 
Windows fonts
-- 
Pavel Janík

Ask three people which VM is best, and you will get four answers ;)
                  -- Hubert Mantel about VM in 2.4.x



reply via email to

[Prev in Thread] Current Thread [Next in Thread]