Add a bit about socket REPLs

Open
#271 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
50/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
clojure
Domain
documentation

Research direction

Start with the REPL and Main page at https://clojurescript.org/reference/repl-and-main and compare its structure with the linked Clojure reference. Document the Clojure 1.10 socket-server command, explain connecting to port 5555, and note that other shipping REPLs can replace cljs.server.browser/repl. Done means the page clearly covers this workflow.

Written by the indexing model from the issue text.

Description

major

This page https://clojurescript.org/reference/repl-and-main can be updated for Socket REPLs (a bit like, or referring to https://clojure.org/reference/repl_and_main#_launching_a_socket_server)

In particular, it can explain how, with Clojure 1.10, you can

clj -J-Dclojure.server.repl='{:port 5555 :accept cljs.server.browser/repl}'

Replacing cljs.server.browser/repl with any of the other shipping REPLs, and then connecting to port 5555 to launch the REPL.

Dominant language
Shell
Stars
107
Forks
130
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from clojure/clojurescript-site

All issues in clojure/clojurescript-site

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.