emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/eglot 15b00c6400: Rework "What is Eglot?" introductory


From: ELPA Syncer
Subject: [elpa] externals/eglot 15b00c6400: Rework "What is Eglot?" introductory manual section
Date: Sun, 2 Oct 2022 05:57:34 -0400 (EDT)

branch: externals/eglot
commit 15b00c640093f83a5dd9e0f95aa44b664efe3828
Author: João Távora <joaotavora@gmail.com>
Commit: João Távora <joaotavora@gmail.com>

    Rework "What is Eglot?" introductory manual section
    
    * MANUAL.md (What is Eglot?): Rework.
    
    * NEWS.md: Mention new manual.
---
 MANUAL.md | 33 ++++++++++++++++-----------------
 NEWS.md   |  2 ++
 2 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/MANUAL.md b/MANUAL.md
index cba0e71c7c..20f3d74fd6 100644
--- a/MANUAL.md
+++ b/MANUAL.md
@@ -26,29 +26,28 @@ Eglot -- *E*macs Poly*glot* -- is the Emacs LSP client that 
stays out
 of your way.
 
 The [Language Server Protocol (LSP)][language-server-protocol] defines
-standardized communication between *client programs*, typically source
-code editors, and *server programs*, which analyze that source code on
-behalf of the clients.
-
-LSP enables a single language server to be useful in many different
+standardized communication between source code editors and language
+server programs, which analyze that source code on behalf of the
 editors.
 
-Likewise, many different language servers exist, each specializing in
-a different programming language.  LSP enables a single editor to
-speak to all of them.
+Using Eglot, Emacs may be enriched with a language server and its
+findings, such as the location of functions calls, types of variables,
+class definitions or syntactic mistakes.  This enables new editing
+features and significantly enhances Emacs existing features such as
+[automatic code completion, go-to definition, at-point documentation,
+automatic refactoring, diagnostics, and more][readme-pretty-gifs].
 
-Server programs advertise the results of their analysis to the client,
-such as where in the source code there is a call to a specific
-function, a variable definition or a syntactic mistake.  Clients
-present these results to the user without specific knowledge of the
-language.  As the user edits, creates and deletes source file clients
+As the user edits, creates and deletes source files, clients
 continuously inform the server of this, so that the server can update
 its analysis.
 
-When using Emacs as a source code editor, combining Eglot with a
-suitable language server program enables many common useful features
-such as [completion, go-to definition, at-point documentation,
-diagnostics, etc.][readme-pretty-gifs].
+LSP enables a single language server to be useful to many different
+editors and a single editor to speak to many different language
+servers.
+
+As long as there is a server language to connect to, Eglot doesn't
+require Emacs to know anything about a particular programming language
+to enable these features.
 
 ## Setting up Eglot
 
diff --git a/NEWS.md b/NEWS.md
index a4883329f6..ef00302e22 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,5 +1,7 @@
 # (upcoming)
 
+#### Manual now lives in a separate MANUAL.md file
+
 #### Support for "single server, multiple modes" ([#681][github#681])
 
 Previously, if an entry such as `((c++-mode c-mode) . ("clangd)")` was



reply via email to

[Prev in Thread] Current Thread [Next in Thread]