[Feature Request] Add multiline description support in user snippets

[zombie110year]

While creating a user snippet, the rule must be like this:

"example": {
	"prefix": "example",
	"body": [
		"line 1",
		"line 2"
	],
	"description": "A single line description"
}

If I want to show a lot of description, I must write a huge string which includes many escape characters like this:

"toctree": {
	"prefix": ".. toctree::",
	"body": [
		".. toctree::",
		"$0"
	],
	"description": "A toctree item, have these options:\n\t:maxdepth: para\n\t:caption: para
\n\t:numbered:\n\t:titlesonly:\n\t:glob:\n\t:reversed:\n\t:hidden:\n\t:includehidden:",
	"scope": "text.restructuredtext"
},

It maybe a good idea that description option receive a list value, like the body:

"toctree": {
	"prefix": ".. toctree::",
	"body": [
		".. toctree::",
		"$0"
	],
	"description": [
		"A toctree item, have these options:",
		":maxdepth: para",
		":caption: para",
		":numbered:",
		":titlesonly:",
		":glob:",
		":reversed:",
		":hidden:",
		":includehidden:"
	],
	"scope": "text.restructuredtext"
},

[zombie110year]

The Version infomations:

• Code Version: 1.30.1 (user setup)
• Commit: dea8705
• Date: 2018-12-18T18:12:07.165Z
• Electron: 2.0.12
• Chrome: 61.0.3163.100
• Node.js: 8.9.3
• V8: 6.1.534.41
• OS: Windows_NT x64 10.0.17763

[jamesgeorge007]

@jrieken Can you guide me on resolving this issue?

[jrieken]

sure, checkout

• https://github.com/Microsoft/vscode/blob/3a0a2e90c740b6f4207f0aaa95d5bcae9d434eb9/src/vs/workbench/parts/snippets/electron-browser/snippetsFile.ts#L123, and
• https://github.com/Microsoft/vscode/blob/3a0a2e90c740b6f4207f0aaa95d5bcae9d434eb9/src/vs/workbench/parts/snippets/electron-browser/snippetsFile.ts#L227