Hi Michael,

1. Showing a docstring on hover is a standard VSCode behavior. I don't 
think any extension should change it without a good reason.

2. I will investigate if it is possible to run repl from within VSCode. On 
the other hand, this behavior can be unexpected for some users. I believe, 
many users are willing to connect to a remote repl and need an explicit way 
to say which repl they want to use. Also note that if you open a Leiningen 
project and repl is running in console the extension will automatically 
connect to it.

3. I added an output channel for evaluation results in the latest extension 
version. You can try it out. I will investigate other options though.

On Monday, September 19, 2016 at 11:50:08 PM UTC+6, Michael Ball wrote:
> On Saturday, September 17, 2016 at 4:32:39 AM UTC+6, Michael Ball wrote:
>>> - Explicit docs/instructions on how to start and connect to the repl 
>>> would be good. I was able to get it connected but it was unclear if the 
>>> repl should be started from within VS code, or from a terminal then only 
>>> connect to it from VS code.
>> The instructions can be found in the "How to Use?" section of readme 
>> file. Not sure I understand your point about where the repl should be 
>> started. Do you mean you mean you expected repl will be run by VSCode on 
>> connect like it happens in Emacs?
> Yes, in LightTable and Cider generally the repl is started up from within 
> the editor, and it was unclear if there was an editor action that would do 
> this, or if the repl needed to be started in a terminal, then connected to.
> - Docstrings don't seem to work for thread first  (-> xxx)? I also noticed 
>>> that it took some time after initial repl connect for the docstrings to 
>>> become available, probably some indexing delay because my laptop is 
>>> old+slow, initially they showed "Docstring not found". Also the docstring 
>>> not found message pops up for all characters on hover of mouse over things 
>>> such as parenthesis.
>> You're right about the thread first docstring. It looks like I need to 
>> adjust the regex for finding Clojure words. Will fix it soon.
>> About docstrings. There shouldn't be snoticable time between pointing a 
>> thing and getting its documentation. However, the is a subtly aspect you 
>> should be aware of. If you have a namespace definition in the beginning of 
>> a file you should eval the file first. Say, you have a file with the 
>> following content:
>> (ns foo)
>> (println "Hello World")
>>  When you point println you won't see the docstring. The reason is the 
>> extension sends the following message to the repl: "Give me a docstring for 
>> the function println from foo namespace." But at the moment repl *know 
>> nothing *about foo namespace! So you neen to eval the file. This will 
>> result adding foo namespace to the repl and importing everything from 
>> clojure.core namespace to it (this is a sideeffect of ns macro). I believe, 
>> this is the common behaviour for all solutions based on cider-nrepl (I've 
>> checked it is true for Emacs Cider and Vim Fireplace). Though I admit it's 
>> not the most intuitive one. So I'm open to suggestions.
> Ah, you're probably right on the eval. Also was thinking that perhaps 
> doc-string could/should be shown on a keystroke instead of mouse-over?
>> - If I had one feature request it would be for inline results a-la 
>>> LightTable. Any plans for something like that?
>> It's definetly a useful feature and I can add it easily. The only thing 
>> I'm not sure about is where to show an evaluation result :) Do you have any 
>> ideas. Maybe you've seen the similar feature in other VSCode plugins and 
>> know how to do it right?
> I don't know if there's a really good way to do it right now, but in some 
> very timely news just this morning a feature got some attention and we 
> hopefully should see it in October. Probably should watch this issue and 
> then use whatever they come up with. You could comment on that issue with 
> your use case as jrieken requested.
> https://github.com/Microsoft/vscode/issues/3220#issuecomment-248040912 
> <https://www.google.com/url?q=https%3A%2F%2Fgithub.com%2FMicrosoft%2Fvscode%2Fissues%2F3220%23issuecomment-248040912&sa=D&sntz=1&usg=AFQjCNGQvx2MxuvxtXE4foy1SesErwMwzg>
> You might also have look at LightTable(my personal favorite for inline 
> results), and atom proto-repl for ideas on how to add inline results. In 
> proto-repl, I have to admit for larger data-structures, the expandable 
> data-structure inspector looks pretty nice. 
> https://atom.io/packages/proto-repl

You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
For more options, visit this group at
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to