use @internal comment consistenlly

mhegazy · mhegazy · commit 13ef271831af · 2015-04-10T16:32:02.000-07:00
diff --git a/src/compiler/declarationEmitter.ts b/src/compiler/declarationEmitter.ts
@@ -1,6 +1,6 @@
 /// <reference path="checker.ts"/>
 
-/** @internal */
+/* @internal */
 module ts {
     interface ModuleElementDeclarationEmitInfo {
         node: Node;
@@ -1561,7 +1561,7 @@ module ts {
         }
     }
     
-    // @internal
+    /* @internal */
     export function writeDeclarationFile(jsFilePath: string, sourceFile: SourceFile, host: EmitHost, resolver: EmitResolver, diagnostics: Diagnostic[]) {
         let emitDeclarationResult = emitDeclarations(host, resolver, diagnostics, jsFilePath, sourceFile);
         // TODO(shkamat): Should we not write any declaration file if any of them can produce error,
diff --git a/src/compiler/types.ts b/src/compiler/types.ts
@@ -1573,15 +1573,15 @@ module ts {
         (t: Type): Type;
     }
 
-    // @internal
+    /* @internal */
     export interface TypeInferences {
         primary: Type[];    // Inferences made directly to a type parameter
         secondary: Type[];  // Inferences made to a type parameter in a union type
         isFixed: boolean;   // Whether the type parameter is fixed, as defined in section 4.12.2 of the TypeScript spec
                             // If a type parameter is fixed, no more inferences can be made for the type parameter
     }
 
-    // @internal
+    /* @internal */
     export interface InferenceContext {
         typeParameters: TypeParameter[];    // Type parameters for which inferences are made
         inferUnionTypes: boolean;           // Infer union types for disjoint candidates (otherwise undefinedType)
@@ -1860,7 +1860,7 @@ module ts {
         newLength: number;
     }
 
-    // @internal
+    /* @internal */
     export interface DiagnosticCollection {
         // Adds a diagnostic to this diagnostic collection.
         add(diagnostic: Diagnostic): void;
diff --git a/src/compiler/utilities.ts b/src/compiler/utilities.ts
@@ -1,6 +1,6 @@
 /// <reference path="binder.ts" />
 
-/** @internal */
+/* @internal */
 module ts {
     export interface ReferencePathMatchResult {
         fileReference?: FileReference
@@ -1379,7 +1379,7 @@ module ts {
         return node;
     }
 
-    // @internal
+    /* @internal */
     export function createDiagnosticCollection(): DiagnosticCollection {
         let nonFileDiagnostics: Diagnostic[] = [];
         let fileDiagnostics: Map<Diagnostic[]> = {};
diff --git a/src/services/breakpoints.ts b/src/services/breakpoints.ts
@@ -3,7 +3,7 @@
 
 /// <reference path='services.ts' />
 
-/** @internal */
+/* @internal */
 module ts.BreakpointResolver {
     /**
      * Get the breakpoint span in given sourceFile
diff --git a/src/services/formatting/formatting.ts b/src/services/formatting/formatting.ts
@@ -3,7 +3,7 @@
 ///<reference path='rulesProvider.ts' />
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
 
     export interface TextRangeWithKind extends TextRange {
diff --git a/src/services/formatting/formattingContext.ts b/src/services/formatting/formattingContext.ts
@@ -1,6 +1,6 @@
 /// <reference path="references.ts"/>
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class FormattingContext {
         public currentTokenSpan: TextRangeWithKind;
diff --git a/src/services/formatting/formattingRequestKind.ts b/src/services/formatting/formattingRequestKind.ts
@@ -1,6 +1,6 @@
 /// <reference path="references.ts"/>
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export const enum FormattingRequestKind {
         FormatDocument,
diff --git a/src/services/formatting/formattingScanner.ts b/src/services/formatting/formattingScanner.ts
@@ -1,7 +1,7 @@
 /// <reference path="formatting.ts"/>
 /// <reference path="..\..\compiler\scanner.ts"/>
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     let scanner = createScanner(ScriptTarget.Latest, /*skipTrivia*/ false);
 
diff --git a/src/services/formatting/rule.ts b/src/services/formatting/rule.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class Rule {
         constructor(
diff --git a/src/services/formatting/ruleAction.ts b/src/services/formatting/ruleAction.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export const enum RuleAction {
         Ignore      = 0x00000001,
diff --git a/src/services/formatting/ruleDescriptor.ts b/src/services/formatting/ruleDescriptor.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class RuleDescriptor {
         constructor(public LeftTokenRange: Shared.TokenRange, public RightTokenRange: Shared.TokenRange) {
diff --git a/src/services/formatting/ruleFlag.ts b/src/services/formatting/ruleFlag.ts
@@ -1,7 +1,7 @@
 ///<reference path='references.ts' />
 
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export const enum RuleFlags {
         None,
diff --git a/src/services/formatting/ruleOperation.ts b/src/services/formatting/ruleOperation.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class RuleOperation {
         public Context: RuleOperationContext;
diff --git a/src/services/formatting/ruleOperationContext.ts b/src/services/formatting/ruleOperationContext.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
 
     export class RuleOperationContext {
diff --git a/src/services/formatting/rules.ts b/src/services/formatting/rules.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class Rules {
         public getRuleName(rule: Rule) {
diff --git a/src/services/formatting/rulesMap.ts b/src/services/formatting/rulesMap.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class RulesMap {
         public map: RulesBucket[];
diff --git a/src/services/formatting/rulesProvider.ts b/src/services/formatting/rulesProvider.ts
@@ -1,6 +1,6 @@
 /// <reference path="references.ts"/>
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export class RulesProvider {
         private globalRules: Rules;
diff --git a/src/services/formatting/smartIndenter.ts b/src/services/formatting/smartIndenter.ts
@@ -1,6 +1,6 @@
 ///<reference path='..\services.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export module SmartIndenter {
 
diff --git a/src/services/formatting/tokenRange.ts b/src/services/formatting/tokenRange.ts
@@ -1,6 +1,6 @@
 ///<reference path='references.ts' />
 
-/** @internal */
+/* @internal */
 module ts.formatting {
     export module Shared {
         export interface ITokenAccess {
diff --git a/src/services/navigateTo.ts b/src/services/navigateTo.ts
@@ -1,4 +1,4 @@
-/** @internal */
+/* @internal */
 module ts.NavigateTo {
     type RawNavigateToItem = { name: string; fileName: string; matchKind: PatternMatchKind; isCaseSensitive: boolean; declaration: Declaration };
 
diff --git a/src/services/navigationBar.ts b/src/services/navigationBar.ts
@@ -1,6 +1,6 @@
 /// <reference path='services.ts' />
 
-/** @internal */
+/* @internal */
 module ts.NavigationBar {
     export function getNavigationBarItems(sourceFile: SourceFile): ts.NavigationBarItem[]  {
         // If the source file has any child items, then it included in the tree
diff --git a/src/services/outliningElementsCollector.ts b/src/services/outliningElementsCollector.ts
@@ -1,4 +1,4 @@
-/** @internal */
+/* @internal */
 module ts {
     export module OutliningElementsCollector {
         export function collectElements(sourceFile: SourceFile): OutliningSpan[] {
diff --git a/src/services/patternMatcher.ts b/src/services/patternMatcher.ts
@@ -1,4 +1,4 @@
-/** @internal */
+/* @internal */
 module ts {
     // Note(cyrusn): this enum is ordered from strongest match type to weakest match type.
     export enum PatternMatchKind {
diff --git a/src/services/signatureHelp.ts b/src/services/signatureHelp.ts
@@ -1,5 +1,5 @@
 ///<reference path='services.ts' />
-/** @internal */
+/* @internal */
 module ts.SignatureHelp {
 
     // A partially written generic type expression is not guaranteed to have the correct syntax tree. the expression could be parsed as less than/greater than expression or a comma expression
diff --git a/src/services/utilities.ts b/src/services/utilities.ts
@@ -1,5 +1,5 @@
 // These utilities are common to multiple language service features.
-/** @internal */
+/* @internal */
 module ts {
     export interface ListItemInfo {
         listItemIndex: number;
@@ -501,7 +501,7 @@ module ts {
 }
 
 // Display-part writer helpers
-/** @internal */
+/* @internal */
 module ts {
     export function isFirstDeclarationOfSymbolParameter(symbol: Symbol) {
         return symbol.declarations && symbol.declarations.length > 0 && symbol.declarations[0].kind === SyntaxKind.Parameter;

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`/// <reference path="checker.ts"/>`
`2`	`2`
`3`		`-/** @internal */`
	`3`	`+/* @internal */`
`4`	`4`	`module ts {`
`5`	`5`	`interface ModuleElementDeclarationEmitInfo {`
`6`	`6`	`node: Node;`
`@@ -1561,7 +1561,7 @@ module ts {`
`1561`	`1561`	`}`
`1562`	`1562`	`}`
`1563`	`1563`
`1564`		`- // @internal`
	`1564`	`+ /* @internal */`
`1565`	`1565`	`export function writeDeclarationFile(jsFilePath: string, sourceFile: SourceFile, host: EmitHost, resolver: EmitResolver, diagnostics: Diagnostic[]) {`
`1566`	`1566`	`let emitDeclarationResult = emitDeclarations(host, resolver, diagnostics, jsFilePath, sourceFile);`
`1567`	`1567`	`// TODO(shkamat): Should we not write any declaration file if any of them can produce error,`