@@ -79,14 +79,23 @@ sort on arbitrary column of visually aligned text data such as output of
7979 ![ Sorting lines by entire content] ( images/sort-lines-whole.gif )
8080- Sort lines by selected parts<br >
8181 ![ Sorting lines by selected parts] ( images/sort-lines-part.gif )
82-
83- ## Gallery
84-
85- - Sorting targets of ` import ` of TypeScript:<br >
86- ![ Sorting imports] ( images/sort-imports.gif )
87- - Sorting visually aligned text data is (relatively) easy:<br >
88- ![ Sorting visually aligned] ( images/sort-visually-aligned.gif )
89-
82+ - Sort visually aligned lines by specific "column"<br >
83+ ![ Sorting lines by selected parts] ( images/sort-visually-aligned.gif )
84+
85+ ## Sorting Words Spread over Multiple Lines
86+
87+ By default you cannot sort words spread over multiple lines. If the selection
88+ covers multiple lines, those lines touched by the selection will be sorted.
89+ To change this behavior, set ` true ` to ` stableSort.preferWordSorting ` option.
90+ Doing so makes this extension sort selected words if start or end of the
91+ selection is in the middle of a line. Note that even if this option was enabled
92+ you can sort multiple words by placing both start and end of the selection at
93+ the beginning of a line (as in the example animation above.)
94+
95+ - For example, we can sort import target in Julia language:<br >
96+ ![ Sorting words spread over multiple lines] ( images/sort-words-multiline.gif ) <br >
97+ In this example, we don't need to care about where to insert a new target; just
98+ appending one and sorting them will move it to the right place.
9099
91100# Background
92101
0 commit comments