Re: new *Help* argument highlighting

[Juanma Barranquero]

On Wed, 12 May 2004 22:01:41 +0900 (JST)
Kenichi Handa <address@hidden> wrote:

> I see your point.  The above discussion depends on that
> @var{NAME} much much rarely appears in a docstring than $NAME.

Yes.

> found only this docstring contains $NAME that will be treated
> as an arg unless we prescan usage.

> ------------------------------------------------------------
> copyright is an interactive autoloaded Lisp function in `copyright'.
> (copyright &optional STR ARG)
> 
> Insert a copyright by $ORGANIZATION notice at cursor.
> ------------------------------------------------------------
> 
> We can change it to:
> 
> Insert a copyright by `$ORGANIZATION' notice at cursor.

I'm not sure I understand. Are you assuming `$NAME' could not be a valid
argument reference?

> What do you mean?  The first `sentence' should never be
> broken into multiple lines.  So only the meaningful "fix"
> for fill is to make it recognize the emacs-lisp docstrings
> and keep the first line untouched.

Well, filling for docstrings could work so it doesn't wrap the first
line, but marks chars exceding 80 in a warning face orwhatever. It could
take into account $var{NAME} or $NAME$ expansion (assuming a
length-preserving highlighting) when computing the number of columns,
not only for the first line, but the rest of the docstring.

                                                                Juanma