Re: use-package documentation

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > It is a relatively large manual (2K lines of Texinfo), so adding it is
  > somewhat problematic.  It is also half-way between user-level and
  > Lisp-level, so which manual should mention it is not clear.

People expect the Emacs Lisp Reference Manual to tell all about Emacs
Lisp except for things that are somewhat obscure.  People have said
that use-package is much more convenient than `require' for the .emacs
file.  If that is so, we can expect it to become widely used if we
make the community aware of it.

This argues that at least the most important/most widely used features
of `use-package' should be described in the Emacs Lisp Reference
Manual.  The rest of the could be left in a separate manual.

Where in the Emacs Lisp Reference Manual should those aspects of
`use-package' go?  Perhaps in the node, The Init File.  Or in a new
node, added just after that one, to contain "useful things to use in
your init file".

-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)