¿Ya existe soporte para Documentación XML dentro de TypeScript?

Question

¿Ya existe soporte para la documentación XML dentro de TypeScript? Parece que no, pero tal vez estoy pasando por alto algo.

me gustaría algo como esto:

export class Point { 
    /// <summary>This is a Point class.</summary> 

    constructor (public x: number, public y: number) { 
     /// <summary>Creates a new Point object</summary> 
     /// <param name="x"></param> 
     /// <param name="y"></param> 
    } 
} 

Answer 1

No hay ninguna mención de esto en la especificación del lenguaje, por lo que actualmente no hay soporte para esta característica.

El único comentario de sintaxis en uso es la creación de una dependencia de un archivo de origen:

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

Puede suggest features such as this on the project page - por lo que se podría añadir a la lengua en el futuro si la idea ganancias de tracción.

Answer 2

Por si vale la pena, las muestras de Microsoft sí incluyen este estilo de comentario. De la muestra de paralaje:

constructor(scrollableContent: HTMLElement, perspective: number) { 
     /// <param name="scrollableContent">The container that will be parallaxed.</param> 
     /// <param name="perspective">The ratio of how much back content should be 
     /// scrolled relative to forward content. For example, if this value is 
     /// 0.5, and there are 2 surfaces, the front-most surface would be scrolled 
     /// normally, and the surface behind it would be scrolled half as much.</param> 
     this.perspective = perspective; 
     this.surface = []; 
     this.content = scrollableContent; 

     $(scrollableContent).scroll((event: JQueryEventObject) => { 
      this.onContainerScroll(event); 
     }); 
    } 

Answer 3

Al parecer jsdoc ahora es compatible, por lo menos en código de Visual Studio, ya que estoy usando actualmente allí y se nota en las ventanas emergentes de IntelliSense.