🚀 go-pugleaf

In article <9007232241.AA09881@noname>, eric%yamada-sun writes:
| The documentation for the function `up-list' reads like this:
| 	up-list:
| 	Move forward out of one level of parentheses.
| 	With argument, do this that many times.
| 	A negative argument means move backward but still to a less deep spot.
| This gives the impression that the argument is optional.  However, the
| code reads like this:
| 	(defun up-list (arg) 
| which says to me that the argument is required, not optional.

The argument is required from elisp, but optional from the keyboard.
In general, a doc-string talks about ARG being optional if it means
the elisp argument, rather than "the argument is optional", which
nearly always means the prefix argument if the function is
keybindable; that is, the function contains an "(interactive...)".

Just another elisp hacker,
-- 
/=Randal L. Schwartz, Stonehenge Consulting Services (503)777-0095 ==========\
| on contract to Intel's iWarp project, Beaverton, Oregon, USA, Sol III      |
| merlyn@iwarp.intel.com ...!any-MX-mailer-like-uunet!iwarp.intel.com!merlyn |
\=Cute Quote: "Welcome to Portland, Oregon, home of the California Raisins!"=/