From: Dan Davison Date: Sun, 26 Apr 2020 02:26:14 +0000 (-0400) Subject: Tweak docstring of eglot-server-programs X-Git-Tag: emacs-29.0.90~1616^2~524^2~4^2~234 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3773b2638f35e39c7040ba86497dcfe62bff1217;p=emacs.git Tweak docstring of eglot-server-programs Co-authored-by: João Távora * eglot.el (eglot-server-programs): Fix typos and phrasing. --- diff --git a/lisp/progmodes/eglot.el b/lisp/progmodes/eglot.el index afb7063c64c..6db0a09f8f8 100644 --- a/lisp/progmodes/eglot.el +++ b/lisp/progmodes/eglot.el @@ -120,27 +120,28 @@ of those modes. CONTACT can be: PROGRAM is called with ARGS and is expected to serve LSP requests over the standard input/output channels. -* A list (HOST PORT [TCP-ARGS...]) where HOST is a string and PORT is - na positive integer number for connecting to a server via TCP. +* A list (HOST PORT [TCP-ARGS...]) where HOST is a string and + PORT is a positive integer for connecting to a server via TCP. Remaining ARGS are passed to `open-network-stream' for upgrading the connection with encryption or other capabilities. -* A list (PROGRAM [ARGS...] :autoport [MOREARGS...]), whereby a - combination of the two previous options is used.. First, an +* A list (PROGRAM [ARGS...] :autoport [MOREARGS...]), whereupon a + combination of the two previous options is used. First, an attempt is made to find an available server port, then PROGRAM is launched with ARGS; the `:autoport' keyword substituted for - that number; and MOREARGS. Eglot then attempts to to establish - a TCP connection to that port number on the localhost. + that number; and MOREARGS. Eglot then attempts to establish a + TCP connection to that port number on the localhost. * A cons (CLASS-NAME . INITARGS) where CLASS-NAME is a symbol designating a subclass of `eglot-lsp-server', for representing experimental LSP servers. INITARGS is a keyword-value plist - used to initialize CLASS-NAME, or a plain list interpreted as - the previous descriptions of CONTACT, in which case it is - converted to produce a plist with a suitable :PROCESS initarg - to CLASS-NAME. The class `eglot-lsp-server' descends - `jsonrpc-process-connection', which you should see for the - semantics of the mandatory :PROCESS argument. + used to initialize the object of CLASS-NAME, or a plain list + interpreted as the previous descriptions of CONTACT. In the + latter case that plain list is used to produce a plist with a + suitable :PROCESS initarg to CLASS-NAME. The class + `eglot-lsp-server' descends from `jsonrpc-process-connection', + which you should see for the semantics of the mandatory + :PROCESS argument. * A function of a single argument producing any of the above values for CONTACT. The argument's value is non-nil if the