[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.
- Re: Trunk still not open, (continued)
- Re: Trunk still not open, Dmitry Gutov, 2014/03/14
- Re: Trunk still not open, Eli Zaretskii, 2014/03/15
- Re: Trunk still not open, Juanma Barranquero, 2014/03/15
- Re: Trunk still not open, Eli Zaretskii, 2014/03/15
- Re: Trunk still not open, Juanma Barranquero, 2014/03/15
- Re: Trunk still not open, Glenn Morris, 2014/03/15
- Re: Trunk still not open, Juanma Barranquero, 2014/03/15
- Re: Trunk still not open, martin rudalics, 2014/03/16
- Re: Trunk still not open, Glenn Morris, 2014/03/17
- Re: Trunk still not open, Juanma Barranquero, 2014/03/17
- Re: Trunk still not open,
Eli Zaretskii <=
- Re: Trunk still not open, Juanma Barranquero, 2014/03/17
- Re: Trunk still not open, Glenn Morris, 2014/03/18
- Re: Trunk still not open, Juanma Barranquero, 2014/03/18
- Re: Trunk still not open, David Kastrup, 2014/03/18
- Re: Trunk still not open, Juanma Barranquero, 2014/03/18
- Re: Trunk still not open, Stephen J. Turnbull, 2014/03/19
- Re: Trunk still not open, Stephen J. Turnbull, 2014/03/17
- Re: Trunk still not open, Juanma Barranquero, 2014/03/17
- Re: Trunk still not open, Eli Zaretskii, 2014/03/17
- Re: Trunk still not open, Stephen J. Turnbull, 2014/03/18