gnu-emacs-sources
[Top][All Lists]
Advanced

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

RE: scan-info-node-length.el


From: Drew Adams
Subject: RE: scan-info-node-length.el
Date: Fri, 25 May 2018 07:43:56 -0700 (PDT)

>     > (657 "Sequence Functions")
>     > (481 "GNU Free Documentation License")
>     > (372 "pcase Macro")
>     > (363 "Special Properties")
>     > (329 "Frame Layout")
>     > (304 "Garbage Collection")
>     > (303 "Low-Level Font")
>     > (301 "Changing Files")
> 
> These modes really ought to be subdiided.

Sequence Functions and pcase Macro are recent additions.
Perhaps there is a tendency toward long nodes in an
initial attempt to doc something, with such long nodes
being refactored later.

BTW, `count-lines' counts blank lines too.  Maybe
`scan-info-node-length' or similar could offer counts
of more than just lines (e.g., using optional args).

`count-words-region' offers lines, words, and chars
(interactively, at least).  Each of those gives some
(and a different) indication of the complexity of doc.
 
> Splitting a node well is not a mechanical task -- it calls for real
> writing.

Indeed.  And thank you to TTN for recently trying to
improve the `pcase' doc (bug #31311).



reply via email to

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