[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Changes in revision 114466
From: |
Xue Fuqiao |
Subject: |
Re: Changes in revision 114466 |
Date: |
Mon, 30 Sep 2013 12:55:47 +0800 |
On Sun, Sep 29, 2013 at 3:24 PM, Thien-Thi Nguyen <address@hidden> wrote:
> () Eli Zaretskii <address@hidden>
> () Sun, 29 Sep 2013 05:36:08 +0300
>
> > >> address@hidden FIXME: Document these functions:
> > >> address@hidden `bool-vector-exclusive-or'
> > >> address@hidden `bool-vector-union'
> > >> address@hidden `bool-vector-intersection'
> > >> address@hidden `bool-vector-set-difference'
> > >> address@hidden `bool-vector-not'
> > >> address@hidden `bool-vector-subset'
> > >> address@hidden `bool-vector-count-matches'
> > >> address@hidden `bool-vector-count-matches-at'
>
> Nothing to be sorry about, and thank you.
>
> If the names of these functions were produced by some scanning program,
> this is a good opportunity to add that code to the repo (under admin/).
>
> If they were produced by hand, then i guess the zeroth step would be to
> write a program that likewise produces them.
>
> The overall meta-goals are to make doc coverage easy to determine for
> everyone, and to render the selection criteria (for surely, some things
> do not warrant "full" documentation) explicit and consequently subject
> to refinement.
>
> With this in place, the overall goal of improving the doc coverage is
> most easily realizable, not just once, but also as an ongoing basis, as
> Emacs gains new features over time.
Agreed. The name of these functions were produced by hand. To make doc
coverage, the only solution that I see is scanning the Emacs repo for
keywords like these:
(def\\(var\\|const\\|custom\\)
(def\\(un\\|subst\\|macro\\|advice\\)
(def\\(type\\|struct\\|class\\|ine-condition\\)
DEFUN ("
maybe also for defgroup, defmath, defalias, cl-{defun, defmacro,
defsubst}, ...
although `defadvice' should not be used for Lisp code in Emacs proper.
But I see one problem: not every {functions, variables, ...} needs
documenting. E.g., some functions/variables use two hyphens to separate
prefix. These functions/variables usually don't needs documenting.
IMO every user option and every command needs documentation.
--
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/
- Changes in revision 114466, Eli Zaretskii, 2013/09/28
- Re: Changes in revision 114466, Xue Fuqiao, 2013/09/28
- Re: Changes in revision 114466, Eli Zaretskii, 2013/09/28
- Re: Changes in revision 114466, Thien-Thi Nguyen, 2013/09/29
- Re: Changes in revision 114466,
Xue Fuqiao <=
- RE: Changes in revision 114466, Drew Adams, 2013/09/30
- Re: Changes in revision 114466, Stephen Berman, 2013/09/30
- RE: Changes in revision 114466, Drew Adams, 2013/09/30
- Re: Changes in revision 114466, Thien-Thi Nguyen, 2013/09/30
- RE: Changes in revision 114466, Stephen J. Turnbull, 2013/09/30
- Re: Changes in revision 114466, Eli Zaretskii, 2013/09/30
- Re: Changes in revision 114466, Andreas Röhler, 2013/09/30
- Re: Changes in revision 114466, Eli Zaretskii, 2013/09/30
- RE: Changes in revision 114466, Drew Adams, 2013/09/30
- Re: Changes in revision 114466, Xue Fuqiao, 2013/09/30