From unknown Fri Jun 20 07:18:25 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#58894 <58894@debbugs.gnu.org> To: bug#58894 <58894@debbugs.gnu.org> Subject: Status: Comments on Eglot manual Reply-To: bug#58894 <58894@debbugs.gnu.org> Date: Fri, 20 Jun 2025 14:18:25 +0000 retitle 58894 Comments on Eglot manual reassign 58894 emacs submitter 58894 Augusto Stoffel severity 58894 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 30 07:05:36 2022 Received: (at submit) by debbugs.gnu.org; 30 Oct 2022 11:05:36 +0000 Received: from localhost ([127.0.0.1]:37412 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1op68G-00011y-F9 for submit@debbugs.gnu.org; Sun, 30 Oct 2022 07:05:36 -0400 Received: from lists.gnu.org ([209.51.188.17]:39090) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1op68E-00011q-MC for submit@debbugs.gnu.org; Sun, 30 Oct 2022 07:05:35 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1op68E-0002aI-E4 for bug-gnu-emacs@gnu.org; Sun, 30 Oct 2022 07:05:34 -0400 Received: from mail-ed1-x52b.google.com ([2a00:1450:4864:20::52b]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1op68C-0004fG-MO for bug-gnu-emacs@gnu.org; Sun, 30 Oct 2022 07:05:34 -0400 Received: by mail-ed1-x52b.google.com with SMTP id a5so13789722edb.11 for ; Sun, 30 Oct 2022 04:05:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:user-agent:message-id:date :subject:to:from:from:to:cc:subject:date:message-id:reply-to; bh=+yJOMQ/HFzvTKOl0aZ+m7qwOihvLw1wyR1dEthNE2XQ=; b=DLl9tbMlpjUA8+WXAskFuwPS7V7PjzRchiOZtymfztefoq2UOHL0yaP7snBHMj4Uyv b8rPu8d327e/BVFjqEzA0wQ0bp8RhZoT6ZGjEHrG46RW4avOfTm8GvYFDNtCRi3JQltt 220TZwKE4hE6DT9JW8dbizyYIuxq8F8ixjLaoZMlPXIlKpvOU8yWk71sjwht3V80si29 7vJT2+RhkWTL2Wm7HgirG5MofSLgAzSIzwqhZ1UX8kO8WNNuMYvASnMfVQ5UdjlEzRGk 71WXZiqIYdAl5zZD+SBaHjHeL8PpXzyoQwyKinVVhmBiIkB/mv63zzVR0wHD4edQWVUX YP/Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:user-agent:message-id:date :subject:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=+yJOMQ/HFzvTKOl0aZ+m7qwOihvLw1wyR1dEthNE2XQ=; b=W93j11iCo74hmer0b2ZEQJTiXMO9T+uBdOeiE3gLMFs6sTgv6OQ4w5EqsnlXLeoo0v yHcuQhk+hWWh9VEoyJLiydJ02sCoIqEUwv4YiaXsu7uBA1GqYGy5ijfx+db9+0U0nP4W f/Wqddf3RcqooqLLGfFzq/Uj9w7UeBzWG8TnW8Rtp+/FWPUbA0DqXJxyP3J1Q1NLPMqa MRR/peBnHqe/F2QVc8vk+/pfvqyBWbQbLuXCdc/V3seb+dR1XWS6x4rRdKTSqIW6FfBU HTcXb2ZfSkq6FVvSsnyU299K9fI1S1H/bdauQlMLHUFzFr4nOon/5ucXFLZzropMdOHq vXwg== X-Gm-Message-State: ACrzQf0LcHmwUkDgVkVtyACqv0DmIzZDYvIoVI4DrhjElXOv/ILw6D40 D1DQ5BYGiPC8CjHP9tI81DlIiusSvnU= X-Google-Smtp-Source: AMsMyM5USd/6lY9iGkpBAIyYnPTss8eCb0/XQEAX+lJGHZ+au01GRqUbQQQlsmESHzwkRfoso3B8dQ== X-Received: by 2002:aa7:c054:0:b0:453:98c6:f6c4 with SMTP id k20-20020aa7c054000000b0045398c6f6c4mr8331776edo.2.1667127930360; Sun, 30 Oct 2022 04:05:30 -0700 (PDT) Received: from ars3 ([2a02:8109:8ac0:56d0::89aa]) by smtp.gmail.com with ESMTPSA id qo14-20020a170907874e00b00773f3cb67ffsm1764320ejc.28.2022.10.30.04.05.28 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 30 Oct 2022 04:05:29 -0700 (PDT) From: Augusto Stoffel To: bug-gnu-emacs@gnu.org Subject: Comments on Eglot manual Date: Sun, 30 Oct 2022 12:05:27 +0100 Message-ID: <87a65dtvuw.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a00:1450:4864:20::52b; envelope-from=arstoffel@gmail.com; helo=mail-ed1-x52b.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Find below some comments on the "Customizing Eglot" section of the manual: > [...] via the variable =E2=80=98eglot-workspace-configuration=E2=80=99. = Eglot sends the > portion of the settings contained in this variable to each server for > which such settings were defined in the variable. This is not true. The entire `eglot-workspace-configuration' is sent to the server; presumably, severs ignore everything which is not under its own prefix, but that's just a convention. > JSON values =E2=80=98true=E2=80=99, =E2=80=98false=E2=80=99, =E2=80=98nul= l=E2=80=99 and =E2=80=98{}=E2=80=99 are represented by the > Lisp values =E2=80=98t=E2=80=99, =E2=80=98:json-false=E2=80=99, =E2=80=98= nil=E2=80=99, and =E2=80=98eglot-{}=E2=80=99, respectively. Unless something has been renamed recently, it's `eglot--{}', not `eglot-{}'. > Alternatively, the same configuration could be defined as follows: >=20 > ((nil > . ((eglot-workspace-configuration > . (:pylsp (:plugins (:jedi_completion (:include_params t > :fuzzy t) > :pylint (:enabled :json-false))) > :gopls (:usePlaceholders t)))))) This is more or less obvious, if you know how dir-local variables work. So I would suggest mentioning a different configuration method: Alternatively, you can set a default workspace configuration globally by adding the following to your init file: (setq-default eglot-workspace-configuration '(:pylsp (:plugins (:jedi_completion (:include_params t :fuzzy t) :pylint (:enabled :json-false))) :gopls (:usePlaceholders t)) > This is an equivalent setup which sets the value for all the > major-modes inside the project; Eglot will use for each server only the > section of the parameters intended for that server. Again, this is not true. Rather, each sever will presumably ignore any settings not under its own "namespace". From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 03 09:52:07 2022 Received: (at 58894) by debbugs.gnu.org; 3 Nov 2022 13:52:07 +0000 Received: from localhost ([127.0.0.1]:48403 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqadb-0006b7-Eh for submit@debbugs.gnu.org; Thu, 03 Nov 2022 09:52:07 -0400 Received: from eggs.gnu.org ([209.51.188.92]:33288) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqadY-0006aE-PT for 58894@debbugs.gnu.org; Thu, 03 Nov 2022 09:52:05 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqadT-0003dw-D3; Thu, 03 Nov 2022 09:51:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=Aiusy0zylnRWvmZ2cJkYzwVj20BRN/4lmFQZwKEQYAs=; b=hWDSPZzLxgaJ0t0x7wBi NQ9UYgLnSNfFQ43pzlCDxjpVMRGJeKtn7W6pGFbK/gNtHDxefjjN/7IaG5AezkU0R+NezbrWdp+hu rBEEfPC7HOuAQcsEpZJkYZRgGRR4JICgpMWs/Xar54SIuult721TqCtozeyckLJcwFvL59NY0sFN4 Hw5zZnwUqcqJeH5HjRJ6byANQujUXTBk8FuQchQQDN+flBtw9hOIsviPUIaLIvopCFTYYEWDKhGHG 0caaWT6IMUrS6fg/dvSoTLnrpfdwjWbFW/oirgPzAINe6Ks+R0OH53JJ3pUg04wse1W3Ws17nWZUX RTLGtBrYNiKgUQ==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqadS-0004DG-S1; Thu, 03 Nov 2022 09:51:59 -0400 Date: Thu, 03 Nov 2022 15:51:51 +0200 Message-Id: <83sfj06t8o.fsf@gnu.org> From: Eli Zaretskii To: Augusto Stoffel , =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= In-Reply-To: <87a65dtvuw.fsf@gmail.com> (message from Augusto Stoffel on Sun, 30 Oct 2022 12:05:27 +0100) Subject: Re: bug#58894: Comments on Eglot manual References: <87a65dtvuw.fsf@gmail.com> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 58894 Cc: 58894@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Augusto Stoffel > Date: Sun, 30 Oct 2022 12:05:27 +0100 > > Find below some comments on the "Customizing Eglot" section of the manual: > > > [...] via the variable ‘eglot-workspace-configuration’. Eglot sends the > > portion of the settings contained in this variable to each server for > > which such settings were defined in the variable. > > This is not true. The entire `eglot-workspace-configuration' is sent to > the server; presumably, severs ignore everything which is not under its > own prefix, but that's just a convention. > > > JSON values ‘true’, ‘false’, ‘null’ and ‘{}’ are represented by the > > Lisp values ‘t’, ‘:json-false’, ‘nil’, and ‘eglot-{}’, respectively. > > Unless something has been renamed recently, it's `eglot--{}', not > `eglot-{}'. > > > Alternatively, the same configuration could be defined as follows: > > > > ((nil > > . ((eglot-workspace-configuration > > . (:pylsp (:plugins (:jedi_completion (:include_params t > > :fuzzy t) > > :pylint (:enabled :json-false))) > > :gopls (:usePlaceholders t)))))) > > This is more or less obvious, if you know how dir-local variables work. > So I would suggest mentioning a different configuration method: > > Alternatively, you can set a default workspace configuration globally by > adding the following to your init file: > > (setq-default > eglot-workspace-configuration > '(:pylsp (:plugins (:jedi_completion (:include_params t > :fuzzy t) > :pylint (:enabled :json-false))) > :gopls (:usePlaceholders t)) > > > > > This is an equivalent setup which sets the value for all the > > major-modes inside the project; Eglot will use for each server only the > > section of the parameters intended for that server. > > Again, this is not true. Rather, each sever will presumably ignore any > settings not under its own "namespace". João, any comments? From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 03 12:09:01 2022 Received: (at 58894) by debbugs.gnu.org; 3 Nov 2022 16:09:01 +0000 Received: from localhost ([127.0.0.1]:50073 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqcm5-0000ab-2b for submit@debbugs.gnu.org; Thu, 03 Nov 2022 12:09:01 -0400 Received: from mail-oa1-f45.google.com ([209.85.160.45]:37456) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqcm3-0000aO-ER for 58894@debbugs.gnu.org; Thu, 03 Nov 2022 12:09:00 -0400 Received: by mail-oa1-f45.google.com with SMTP id 586e51a60fabf-12c8312131fso2687344fac.4 for <58894@debbugs.gnu.org>; Thu, 03 Nov 2022 09:08:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=MsCRVkHLImPm0z6skGS2Dv3uMHkOTllz022C2Ez3c50=; b=VjPafGXDbCTH48tFvLGS6Us3fhm9IbIk0q+HG+SBpIm39W+PTxCWtqxa1o/Ey6zOoh 3P2wqGU2sg2qZxXKCXBOrToZjEJvDnJ78hRjmdTrIOays2kAdyBJ8ba64MwrwiryB4Gv SZs7dSVFb3T8Bc7eASTu7JyuMAGKKLM9Hm0Ts9GhKOq+8bs6E03wYsCfSGhCbVpxNUUL xURxEkzfIGPVOCLZQ/nyeh/mAXmBoVFkJ/BpDgqbEWeWOAyRIcXFSLgK2gMOY8grU+1P oXfXwF0M9SLaHfQGcleykbez/OaQALA8pBydLGNZusnkq2Mnf7GBdm5IMrLJ7vosp+WV S3CA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=MsCRVkHLImPm0z6skGS2Dv3uMHkOTllz022C2Ez3c50=; b=YI6uZrdfY7l2ML0CpCJBnkndcWRh6Sa7eg9/R1rH5M6VR94+Rk/4fBsRDfg2T3K+Bv sqR5cJYBqxJRFYUwBrXCi+75Rboo7mwc6t+dIkSNQ3SncK6Ly4dNCvj1bZfW+DU3lrI4 XG84Q19TFVkI1j40mRrgRu2eKFXyFYZPN6JrUjdZPJm2I1Df3gkE1mUGbVzE6luCOwxf OlkM80e7iLxEbI17vX9F5UvmaucH4yFolNzhV3MnoQxiyCGU74sY0nWfOfMHMXjMyVVM QgZTfpH0pNRJ15BYl9KrdrKSLp36O4gtdBOxWLSOJCUX9EudAEbe4OWxSiF/dgD02DBV LvZA== X-Gm-Message-State: ACrzQf2hkDxbycm54fmFWasjbdrpZxbOu+uVKWrvB7f7e0Y4YRWEsnRZ J5+4yDOnhO/Ov2A8sankGaG4ZdrvlklpI7ESRfI= X-Google-Smtp-Source: AMsMyM5D68m/g93qEQg/nfsV6eFWL6AfmXR6DiLBzw1iWt4A+oY2U+LQMjcwFYk4w5s6mft+dOuiyL/IE/AcWaVG1tQ= X-Received: by 2002:a05:6870:e242:b0:13b:d561:ad02 with SMTP id d2-20020a056870e24200b0013bd561ad02mr18842202oac.215.1667491733733; Thu, 03 Nov 2022 09:08:53 -0700 (PDT) MIME-Version: 1.0 References: <87a65dtvuw.fsf@gmail.com> <83sfj06t8o.fsf@gnu.org> In-Reply-To: <83sfj06t8o.fsf@gnu.org> From: =?UTF-8?B?Sm/Do28gVMOhdm9yYQ==?= Date: Thu, 3 Nov 2022 16:08:41 +0000 Message-ID: Subject: Re: bug#58894: Comments on Eglot manual To: Eli Zaretskii Content-Type: multipart/alternative; boundary="00000000000074882f05ec932c7e" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 58894 Cc: 58894@debbugs.gnu.org, Augusto Stoffel X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --00000000000074882f05ec932c7e Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hello, my comments: On Thu, Nov 3, 2022, 13:51 Eli Zaretskii wrote: > > From: Augusto Stoffel . > > > > This is not true. The entire `eglot-workspace-configuration' is sent t= o > > the server; presumably, severs ignore everything which is not under its > > own prefix, but that's just a convention. > Augusto is correct. His phrasing is acceptably clear for the manual imo. > > JSON values =E2=80=98true=E2=80=99, =E2=80=98false=E2=80=99, =E2=80=98n= ull=E2=80=99 and =E2=80=98{}=E2=80=99 are represented by the > > > Lisp values =E2=80=98t=E2=80=99, =E2=80=98:json-false=E2=80=99, =E2= =80=98nil=E2=80=99, and =E2=80=98eglot-{}=E2=80=99, respectively. > > > > Unless something has been renamed recently, it's `eglot--{}', not > > `eglot-{}'. > Something has been renamed recently. eglot--{} is an alias. > > Alternatively, the same configuration could be defined as follows: > > > > > > ((nil > > > . ((eglot-workspace-configuration > > > . (:pylsp (:plugins (:jedi_completion (:include_params t > > > :fuzzy t) > > > :pylint (:enabled :json-false))) > > > :gopls (:usePlaceholders t)))))) > > > > This is more or less obvious, if you know how dir-local variables work. > Many people don't, judging from a substantial amount of interactions on this topic. > So I would suggest mentioning a different configuration method: > > > > Alternatively, you can set a default workspace configuration globally b= y > > adding the following to your init file: > > > > (setq-default > > eglot-workspace-configuration > > '(:pylsp (:plugins (:jedi_completion (:include_params t > > :fuzzy t) > > :pylint (:enabled :json-false))) > > :gopls (:usePlaceholders t)) > This is purposedly not mentioned because it is not recommended and confusing. Workspace settings are project-specific by definition. Your idea probably works, but is better implemented as initializationOptions, command-line switches or other means of configuring the server independently of the workspace it is meant to operate on. > > This is an equivalent setup which sets the value for all the > > > major-modes inside the project; Eglot will use for each server only t= he > > > section of the parameters intended for that server. > > > > Again, this is not true. Rather, each sever will presumably ignore any > > settings not under its own "namespace". > Yes, that is the correct idea. Jo=C3=A3o, any comments? > See above. Also, I think this information should migrate to a separate sub-section, alongside a sub-section devoted to the "workspace folders" topic. Jo=C3=A3o > --00000000000074882f05ec932c7e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hello, my comments:

On Thu, Nov 3, 2022, 13:51 Eli Zare= tskii <eliz@gnu.org> wrote:
> From: Augusto Stoffel .
>
> This is not true.=C2=A0 The entire `eglot-workspace-configuration'= is sent to
> the server; presumably, severs ignore everything which is not under it= s
> own prefix, but that's just a convention.

Augusto is correct. His p= hrasing is acceptably clear for the manual imo.

=
> > JSON values =E2=80=98true=E2=80=99, =E2=80=98false=E2=80=99, =E2= =80=98null=E2=80=99 and =E2=80=98{}=E2=80=99 are represented by the
> > Lisp values =E2=80=98t=E2=80=99, =E2=80=98:json-false=E2=80=99, = =E2=80=98nil=E2=80=99, and =E2=80=98eglot-{}=E2=80=99, respectively.
>
> Unless something has been renamed recently, it's `eglot--{}', = not
> `eglot-{}'.

Something has been renamed recently. eglot--{} is an al= ias.

> >=C2=A0 =C2=A0 Alternatively, the same configuration could be defin= ed as follows:
> >
> >=C2=A0 =C2=A0 =C2=A0 ((nil
> >=C2=A0 =C2=A0 =C2=A0 =C2=A0 . ((eglot-workspace-configuration
> >=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 . (:pylsp (:plugins (:je= di_completion (:include_params t
> >=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0:fuzzy t)
> >=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0:pylint (:enabled :json= -false)))
> >=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0:gopls (:us= ePlaceholders t))))))
>
> This is more or less obvious, if you know how dir-local variables work= .

Many people don't, judging from a substantial amount of interactions o= n this topic.

> So I would suggest mentioning a different configuration method:
>
> Alternatively, you can set a default workspace configuration globally = by
> adding the following to your init file:
>
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 (setq-default
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 eglot-workspace-configuration
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 '(:pylsp (:plugins (:jedi_comple= tion (:include_params t
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 :fuzzy t)
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 :pylint (:enabled :json-false)))
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 :gopls (:usePlaceholders t))<= br>

T= his is purposedly not mentioned because it is not recommended and confusing= . Workspace settings are project-specific by definition. Your idea probably= works, but is better implemented as initializationOptions, command-line sw= itches or other means of configuring the server independently of the worksp= ace it is meant to operate on.

> >=C2=A0 =C2=A0 This is an equivalent setup which sets the value for= all the
> > major-modes inside the project; Eglot will use for each server on= ly the
> > section of the parameters intended for that server.
>
> Again, this is not true.=C2=A0 Rather, each sever will presumably igno= re any
> settings not under its own "namespace".

Yes, that is the corr= ect idea.

Jo=C3=A3o, any comments?

=
See above.=C2=A0

<= div dir=3D"auto">Also, I think this information should migrate to a separat= e sub-section, alongside a sub-section devoted to the "workspace folde= rs" topic.

Jo=C3=A3= o
--00000000000074882f05ec932c7e-- From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 06 02:47:40 2022 Received: (at 58894-done) by debbugs.gnu.org; 6 Nov 2022 07:47:40 +0000 Received: from localhost ([127.0.0.1]:58599 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oraNX-0001TE-JA for submit@debbugs.gnu.org; Sun, 06 Nov 2022 02:47:40 -0500 Received: from eggs.gnu.org ([209.51.188.92]:44052) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oraNT-0001St-Cs for 58894-done@debbugs.gnu.org; Sun, 06 Nov 2022 02:47:38 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oraNN-0002lV-GB; Sun, 06 Nov 2022 02:47:30 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=rdkA6CH0EnyjUb4iPpY/OUX0jR6lQzPggnE8bys0lCE=; b=S4aKkk0h1FwbkvtqEglQ 8gt3ZW9fcuQnRj7aj3koCe9DqjPfjm1eKUK5oVFG3RA5nse2Zvvx4iPX6t2GSwl+D6K8ShPtedsqq /7AKTSg59As2XAsEbXaBvZ3nxXwiQG7x42kx9ZFQhjm7ZBwWlc1PpfCDcn14Ew+ND4sfLJ9u0ZncV CuQ7Qd5eHrjU1169fd/S21VVI0AP4CokxSJ36cf7WSyvY+Jt9gNrise3tF98Uv0h4fz5XCGm7rzDV NXzhoecO88DOiMt44UDa1TW5O77f2WXRyMZD6VzpT51vh0avVqkIg3tdN2qL586Gj1ad75E17aI3+ P4hF/bsCuk6pbA==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oraNM-0002kf-QH; Sun, 06 Nov 2022 02:47:29 -0500 Date: Sun, 06 Nov 2022 09:47:10 +0200 Message-Id: <831qqg34ox.fsf@gnu.org> From: Eli Zaretskii To: =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= In-Reply-To: (message from =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= on Thu, 3 Nov 2022 16:08:41 +0000) Subject: Re: bug#58894: Comments on Eglot manual References: <87a65dtvuw.fsf@gmail.com> <83sfj06t8o.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 58894-done Cc: 58894-done@debbugs.gnu.org, arstoffel@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: João Távora > Date: Thu, 3 Nov 2022 16:08:41 +0000 > Cc: Augusto Stoffel , 58894@debbugs.gnu.org > > Hello, my comments: > > On Thu, Nov 3, 2022, 13:51 Eli Zaretskii wrote: > > > From: Augusto Stoffel . > > > > This is not true. The entire `eglot-workspace-configuration' is sent to > > the server; presumably, severs ignore everything which is not under its > > own prefix, but that's just a convention. > > Augusto is correct. His phrasing is acceptably clear for the manual imo. > > > > JSON values ‘true’, ‘false’, ‘null’ and ‘{}’ are represented by the > > > Lisp values ‘t’, ‘:json-false’, ‘nil’, and ‘eglot-{}’, respectively. > > > > Unless something has been renamed recently, it's `eglot--{}', not > > `eglot-{}'. > > Something has been renamed recently. eglot--{} is an alias. > > > > Alternatively, the same configuration could be defined as follows: > > > > > > ((nil > > > . ((eglot-workspace-configuration > > > . (:pylsp (:plugins (:jedi_completion (:include_params t > > > :fuzzy t) > > > :pylint (:enabled :json-false))) > > > :gopls (:usePlaceholders t)))))) > > > > This is more or less obvious, if you know how dir-local variables work. > > Many people don't, judging from a substantial amount of interactions on this topic. > > > So I would suggest mentioning a different configuration method: > > > > Alternatively, you can set a default workspace configuration globally by > > adding the following to your init file: > > > > (setq-default > > eglot-workspace-configuration > > '(:pylsp (:plugins (:jedi_completion (:include_params t > > :fuzzy t) > > :pylint (:enabled :json-false))) > > :gopls (:usePlaceholders t)) > > This is purposedly not mentioned because it is not recommended and confusing. Workspace settings are > project-specific by definition. Your idea probably works, but is better implemented as initializationOptions, > command-line switches or other means of configuring the server independently of the workspace it is meant > to operate on. > > > > This is an equivalent setup which sets the value for all the > > > major-modes inside the project; Eglot will use for each server only the > > > section of the parameters intended for that server. > > > > Again, this is not true. Rather, each sever will presumably ignore any > > settings not under its own "namespace". > > Yes, that is the correct idea. > > João, any comments? > > See above. Thanks, I fixed the wording regarding sending of the settings. > Also, I think this information should migrate to a separate sub-section, alongside a sub-section devoted to the > "workspace folders" topic. The eglot-workspace-configuration settings are an important part of the Eglot customization, so I don't see why we should move that into a separate section. It sounds unnatural to me. I consider this bug done, so I'm closing it. Thanks for the feedback. From unknown Fri Jun 20 07:18:25 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 04 Dec 2022 12:24:09 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator