update docs to reflect new long-string reindent feature about janet-lang.org HOT 9 CLOSED

Please don't choose "longstrings", i.e. please do not run the words together with nothing in between.

@GrayJack and I have already been putting something between the two words in our tree-sitter grammars:

• https://github.com/GrayJack/tree-sitter-janet/blob/39422ae34badf1e6fa0ac1f748cc47ca214f6314/grammar.js#L4
• https://github.com/sogaiu/tree-sitter-janet-simple/blob/45418f750c44f409c698733e4b9276eeac91eaaa/grammar.js#L36

from janet-lang.org.

I also think "long-string" is better (and "re-indent" over "reindent", where the latter sounds like it has something to do with reindeer :) ).

from janet-lang.org.

@uvtc IIUC you have the power to close this issue :)

from janet-lang.org.

Come to think of it, the long-strings feature doesn't ever indent (or re-indent) anything, does it? It always un-indents --- removing indentation. Maybe that term would fit better for describing long-string behaviour.

from janet-lang.org.

I think it unindents only in the docstring.

from janet-lang.org.

Long-string sounds good to me. The basic way the indentation works is to try and remove leading indentation, only if nothing is indented left of the opening delimiter.

from janet-lang.org.

IIUC, some relevant code for this feature is here: https://github.com/janet-lang/janet/blob/40ae2e812ff5e186ba578d441de9f3d2bebd93fb/src/core/parse.c#L323-L367

from janet-lang.org.

Since the newish Documentation page already addresses re/de/un-indenting of long-strings when used as docstrings, I think that the commits in #154 should wrap this up so this issue can be closed.

from janet-lang.org.

Gotcha. Thanks, @sogaiu .

from janet-lang.org.