TypeScript/tests/cases/fourslash/formatDocumentWithJSDoc.ts

/// <reference path="fourslash.ts" />

/////**
//// * JSDoc for things
//// */
////function f() {
////    /** more
////        jsdoc */
////    var t;
////    /**
////     * multiline
////     */
////    var multiline;
////}

format.document();

verify.currentFileContentIs(`/**
 * JSDoc for things
 */
function f() {
    /** more
        jsdoc */
    var t;
    /**
     * multiline
     */
    var multiline;
}`);
Merge existing JSDoc comments (#27978) * Correct indentation, using correct (I hope) indentation code Note that part of the code, in formatting.ts, is cloned but should be extracted to a function instead. * Remove some possibly-superfluous code But I see 4 failures with whitespace, so perhaps not. * Restrict indentation change to avoid breaking baselines The indentation code is very complex so I'm just going to avoid breaking our single-line tests for now, plus add a simple jsdoc test to show that multiline jsdoc indentation isn't destroyed in the common case. * Switched over to construction for @return/@type Still doesn't merge correctly though * Add @return tags to emitter * Merge multiple jsdocs (not for @param yet) * Merge multiple jsdoc for parameters too * Emit more jsdoc tags Not all of them; I got cold feet since I'll have to write tests for them. I'll do that tomorrow. * Many fixes to JSDoc emit And single tests (at least) for all tags * Cleanup in textChanges.ts * Cleanup in formatting.ts (Plus a little more in textChanges.ts) * Cleanup in inferFromUsage.ts * Fix minor omissions * Separate merged top-level JSDoc comments with \n instead of space. * Don't delete intrusive non-jsdoc comments * Cleanup from PR comments 1. Refactor emit code into smaller functions. 2. Preceding-whitespace utility is slightly easier to use. 3. Better casts and types in inferFromUsage make it easier to read. * Fix bogus newline * Use @andy-ms' cleanup annotateJSDocParameters 2018-10-25 01:14:52 +02:00			`/// <reference path="fourslash.ts" />`

			`/////**`
			`//// * JSDoc for things`
			`//// */`
			`////function f() {`
			`//// /** more`
			`//// jsdoc */`
			`//// var t;`
			`//// /**`
			`//// * multiline`
			`//// */`
			`//// var multiline;`
			`////}`

			`format.document();`

			verify.currentFileContentIs(`/**
			`* JSDoc for things`
			`*/`
			`function f() {`
			`/** more`
			`jsdoc */`
			`var t;`
			`/**`
			`* multiline`
			`*/`
			`var multiline;`
			}`);