Comment aware eval top

[pinealan]

Modifies the behavior of :IcedEvalOuterTopList and Plug(iced_eval_outer_top_list) when the cursor is inside forms that have a root comment form. Evaluation will be of the topmost form inside the comment, instead of evaluating all forms in the comment as a do.

When the cursor is directly inside the comment form, the current behavior of eval as do is preserved.

As example to illustrate:

(comment
  (print (📍"Hello"))
  (print ("world")))
; => hello

(comment
📍(print ("hello"))
  (print ("world")))
; => helloworld

[codecov-commenter]

Codecov Report

Merging #333 (526121b) into main (0a96584) will decrease coverage by 0.11%.
The diff coverage is 60.41%.

@@            Coverage Diff             @@
##             main     #333      +/-   ##
==========================================
- Coverage   77.41%   77.30%   -0.12%     
==========================================
  Files          74       74              
  Lines        6687     6733      +46     
==========================================
+ Hits         5177     5205      +28     
- Misses       1510     1528      +18     

Impacted Files	Coverage Δ
autoload/iced/socket_repl.vim	44.37% <0.00%> (ø)
autoload/iced/paredit.vim	82.38% <60.86%> (-6.74%)	⬇️
autoload/iced/nrepl/eval.vim	85.27% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0a96584...526121b. Read the comment docs.

[liquidz]

@pinealan Thanks for your great work!
Overall looks good :)

[liquidz]

It may be helpful there is an examples like the following.
https:/liquidz/vim-iced/blob/3.1.3/doc/vim-iced.txt#L400

Also if you don't mind, could you update the following document page?
https:/liquidz/vim-iced/blob/3.1.3/doc/pages/configuration/evaluation.adoc#evaluation

[pinealan]

sure, I've put the example in the adoc and linked to it from vim doc

[liquidz]

@pinealan Awesome! Thank you so much.

I'll cut a new release.