Re: [PATCH]: package-user-dir is a defcustom

[Eli Zaretskii <eliz@gnu.org>]

> From: Philip Kaludercic <philipk@posteo.net>
> Cc: emacs-devel <emacs-devel@gnu.org>
> Date: Sat, 15 Jun 2024 17:13:42 +0000
> 
> Pedro Andres Aranda Gutierrez <paaguti@gmail.com> writes:
> 
> > Hi,
> > I would have saved some time, because I understood changing=>setq. I think
> > customising
> > is a bit more precise.
> >
> > Best, /PA
> >
> > diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi
> > index fd445805068..a98af7abdc1 100644
> > --- a/doc/emacs/package.texi
> > +++ b/doc/emacs/package.texi
> > @@ -566,7 +566,7 @@ Package Files
> >  @vindex package-user-dir
> >    Once installed, the contents of a package are placed in a
> >  subdirectory of @file{~/.emacs.d/elpa/} (you can change the name of
> > -that directory by changing the variable @code{package-user-dir}).  The
> > +that directory by customising the variable @code{package-user-dir}).  The
> >  package subdirectory is named @file{@var{name}-@var{version}}, where
> >  @var{name} is the package name and @var{version} is its version
> >  string.
> 
> I think the clearer change would have been to replace the noun
> "variable" with "user option", instead of relying on the implicit
> information in the verb.

We use "customize the variable" all over the place in the user manual,
so it is quite common.