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

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

[Pedro Andres Aranda Gutierrez]

[-- Attachment #1: Type: text/plain, Size: 1017 bytes --]

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.

-- 
Fragen sind nicht da, um beantwortet zu werden,
Fragen sind da um gestellt zu werden
Georg Kreisler

Headaches with a Juju log:
unit-basic-16: 09:17:36 WARNING juju.worker.uniter.operation we should run
a leader-deposed hook here, but we can't yet

[-- Attachment #2: Type: text/html, Size: 1439 bytes --]

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

[Eli Zaretskii]

> From: Pedro Andres Aranda Gutierrez <paaguti@gmail.com>
> Date: Sat, 15 Jun 2024 18:27:02 +0200
> 
> I would have saved some time, because I understood changing=>setq. I think customising
> is a bit more precise.

Thanks, done.

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

[Philip Kaludercic]

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.

-- 
	Philip Kaludercic on peregrine

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

[Eli Zaretskii]

> 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.

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

[Drew Adams]

> > 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.

Technical debt; legacy.  "Option" is clearer,
unambiguous.  It would be good to even replace
"user variable" with "user option" (or even
just "option") wherever the former still occurs.