emacs-devel
[Top][All Lists]
Advanced

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

Re: Trunk still not open


From: Eli Zaretskii
Subject: Re: Trunk still not open
Date: Mon, 17 Mar 2014 19:25:39 +0200

> From: Juanma Barranquero <address@hidden>
> Date: Mon, 17 Mar 2014 18:03:33 +0100
> Cc: Eli Zaretskii <address@hidden>, Stephen Turnbull <address@hidden>, 
>       Emacs developers <address@hidden>, Dmitry Gutov <address@hidden>
> 
> > Well it does. This just seems obvious to me, if you want people to
> > actually use it.
> 
> Well, framesets aren't documented in the elisp reference, but they are
> hardly undocumented. In fact, once I start writing the info docs for
> it, I don't think I'm going to say much, if anything, that isn't
> already in the docstrings or the comments. frameset.el has a bit more
> of 1100 non-empty lines, and ~56% of that is comments or docstrings.

Try not to document the commands at all, and none of the user-level
facets of the feature.  Only document the functions and variables that
can be used as infrastructure for other similar features.  Then you
won't need to repeat so much of the doc strings.



reply via email to

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