[Top][All Lists]
[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
- doc-strings in src/ and the first line,
Pavel Janík <=
- Re: doc-strings in src/ and the first line, Stefan Monnier, 2001/11/13
- Re: doc-strings in src/ and the first line, Richard Stallman, 2001/11/13
- Re: doc-strings in src/ and the first line, Eli Zaretskii, 2001/11/14
- Re: doc-strings in src/ and the first line, Richard Stallman, 2001/11/15
- Re: doc-strings in src/ and the first line, Eli Zaretskii, 2001/11/15
- Re: doc-strings in src/ and the first line, Richard Stallman, 2001/11/15
- Re[2]: doc-strings in src/ and the first line, Eric M. Ludlam, 2001/11/15