Re: [ELPA] New package: use-package

[Philip Kaludercic <philipk@posteo.net>]

Payas Relekar <relekarpayas@gmail.com> writes:

> Philip Kaludercic <philipk@posteo.net> writes:
>
>> John Wiegley <johnw@gnu.org> writes:
>>
>>>>>>>> Philip Kaludercic <philipk@posteo.net> writes:
>>>
>>>> John, what do you say? With use-package added to ELPA, the documentation
>>>> would automatically be made available on elpa.gnu.org, so there might not be
>>>> a need for a special website.
>>>
>>> That's quite fine with me!
>>
>> Payas, will you take care of that?
>
> Thanks for confirmation John!
>
> I created another PR to remove doc/ and bump version.
>
> The build seems to complete without any errors on my local for bind-key.
> Still haven't figured out why bubblewrap cannot find texinfo. Probably
> something to do with how NixOS builds stuff.
>
> Anyway, I hope this will be the last set of changes on road to ELPA.

Before this is done, I have a few comments on the current manual.  In
the section "Installing from an Elpa Archive", goes into how to
configure MELPA/MELPA-Stable.  Is this still necessary?  It might also
be a good idea to replace ".emacs" with "init.el", as this is the
preferred configuration file AFAIK.  I don't know how important this is,
but there are minor typographical issues such as the inconsistent type
setting of "use-package" (sometimes with @code, sometimes without), the
overuse of @code when @var, @key or @kbd would be better or writing "see
@ref" instead of using @xref/@pxref.

Also, it appears I was mistaken in assuming the manual was finished.
There are still large holes:

--8<---------------cut here---------------start------------->8---
@node Getting Started
@chapter Getting Started

TODO@. For now, see @code{README.md}.
--8<---------------cut here---------------end--------------->8---

--8<---------------cut here---------------start------------->8---
@node Debugging Tools
@chapter Debugging Tools

TODO
--8<---------------cut here---------------end--------------->8---