Merge #1313

1313: Update `gen_lsp_server` examples r=matklad a=dmoonfire

- updated the documentation with an example that has no errors with current compiler
- added two example code to test compilation and show in use
  - one example is the bare bones version in documentation
  - the other example is the same but with logging statements to show flow

Co-authored-by: Dylan Moonfire <[email protected]>

1 files changed, 4 insertions, 9 deletions

diff --git a/crates/gen_lsp_server/src/lib.rs b/crates/gen_lsp_server/src/lib.rs
index edbdda6c8..1cd5a3a7c 100644
--- a/crates/gen_lsp_server/src/lib.rs
+++ b/crates/gen_lsp_server/src/lib.rs
@@ -2,21 +2,16 @@
 //! This crate handles protocol handshaking and parsing messages, while you
 //! control the message dispatch loop yourself.
 //!
-//! Run with `RUST_LOG=sync_lsp_server=debug` to see all the messages.
+//! Run with `RUST_LOG=gen_lsp_server=debug` to see all the messages.
 //!
 //! ```no_run
-//! extern crate gen_lsp_server;
-//! extern crate lsp_types;
-//! extern crate failure;
-//! extern crate crossbeam_channel;
-//!
 //! use crossbeam_channel::{Sender, Receiver};
 //! use lsp_types::{ServerCapabilities, InitializeParams, request::{GotoDefinition, GotoDefinitionResponse}};
 //! use gen_lsp_server::{run_server, stdio_transport, handle_shutdown, RawMessage, RawResponse};
 //!
 //! fn main() -> Result<(), failure::Error> {
 //!     let (receiver, sender, io_threads) = stdio_transport();
-//!     gen_lsp_server::run_server(
+//!     run_server(
 //!         ServerCapabilities::default(),
 //!         receiver,
 //!         sender,
@@ -38,13 +33,13 @@
 //!                     None => return Ok(()),
 //!                     Some(req) => req,
 //!                 };
-//!                 let req = match req.cast::<GotoDefinition>() {
+//!                 match req.cast::<GotoDefinition>() {
 //!                     Ok((id, _params)) => {
 //!                         let resp = RawResponse::ok::<GotoDefinition>(
 //!                             id,
 //!                             &Some(GotoDefinitionResponse::Array(Vec::new())),
 //!                         );
-//!                         sender.send(RawMessage::Response(resp));
+//!                         sender.send(RawMessage::Response(resp))?;
 //!                         continue;
 //!                     },
 //!                     Err(req) => req,