Add Long Descriptions to templates for Android, CSharp, and PHP

Author: Caitlin Bales (MSFT)

Templates/Android/BaseModel.template.tt

@@ -619,6 +619,7 @@ public {1} {2}{3}{4} {{";
         var format =
 @"    /**
      * The {0}.
+	 * {4}
      */
     @SerializedName(""{1}"")
     @Expose
@@ -628,6 +629,7 @@ public {1} {2}{3}{4} {{";
         var collectionFormat =
 @"    /**
      * The {0}.
+	 * {4}
      */
     public transient {2} {3};
 
@@ -659,7 +661,8 @@ public {1} {2}{3}{4} {{";
                 propertyName.SplitCamelCase(),
                 property.Name,
                 propertyType,
-                property.Name.SanitizePropertyName(property).ToLowerFirstChar());
+                property.Name.SanitizePropertyName(property).ToLowerFirstChar(),
+				property.LongDescription);
         }
         return sb.ToString();
     }
@@ -671,17 +674,19 @@ public {1} {2}{3}{4} {{";
         var format =
 @"    /**
      * The {0}.
+	 * {1}
      */
-    @SerializedName(""{1}"")
+    @SerializedName(""{2}"")
     @Expose
-    public {2} {3};
+    public {3} {4};
 
 ";
         foreach (var p in parameters)
         {
             sb.AppendFormat(
                 format,
                 ParamName(p).SplitCamelCase(),
+				p.LongDescription,
                 ParamName(p),
                 ParamType(p),
                 ParamName(p).SanitizePropertyName(p).ToLowerFirstChar()

Templates/CSharp/Model/ComplexType.cs.tt

@@ -59,6 +59,10 @@ namespace <#=complex.Namespace.GetNamespaceName()#>
 
         /// <summary>
         /// Gets or sets <#=property.Name#>.
+<# if (property.LongDescription != null) {
+#>
+		/// <#=property.LongDescription#>
+<# } #>
         /// </summary>
         <#=attributeDefinition#>
         public <#=propertyType#> <#=propertyName#> { get; set; }
@@ -70,6 +74,10 @@ namespace <#=complex.Namespace.GetNamespaceName()#>
 
         /// <summary>
         /// Gets or sets <#=property.Name#>.
+<# if (property.LongDescription != null) {
+#>
+		/// <#=property.LongDescription#>
+<# } #>
         /// </summary>
         <#=attributeDefinition#>
         public <#=propertyType#>? <#=propertyName#> { get; set; }

Templates/CSharp/Model/EntityType.cs.tt

@@ -70,7 +70,11 @@ namespace <#=entity.Namespace.GetNamespaceName()#>
     #>
 
         /// <summary>
-        /// Gets or sets <#=property.Name.SplitCamelCase().ToLower()#>.
+		/// Gets or sets <#=property.Name.SplitCamelCase().ToLower()#>.
+<# if (property.LongDescription != null) {
+#>
+		/// <#=property.LongDescription#>
+<# } #>
         /// </summary>
         <#=attributeDefinition#>
         public I<#=propertyCollectionPage#> <#=propertyName.GetSanitizedPropertyName(null, true)#> { get; set; }
@@ -81,7 +85,11 @@ namespace <#=entity.Namespace.GetNamespaceName()#>
     #>
 
         /// <summary>
-        /// Gets or sets <#=property.Name.SplitCamelCase().ToLower()#>.
+		/// Gets or sets <#=property.Name.SplitCamelCase().ToLower()#>.
+<# if (property.LongDescription != null) {
+#>
+		/// <#=property.LongDescription#>
+<# } #>
         /// </summary>
         <#=attributeDefinition#>
         public IEnumerable<<#=propertyType#>> <#=propertyName.GetSanitizedPropertyName(null, true)#> { get; set; }
@@ -93,7 +101,11 @@ namespace <#=entity.Namespace.GetNamespaceName()#>
     #>
 
         /// <summary>
-        /// Gets or sets <#=property.Name.SplitCamelCase().ToLower()#>.
+		/// Gets or sets <#=property.Name.SplitCamelCase().ToLower()#>.
+<# if (property.LongDescription != null) {
+#>
+		/// <#=property.LongDescription#>
+<# } #>
         /// </summary>
         <#=attributeDefinition#>
         public <#=propertyType#> <#=propertyName.GetSanitizedPropertyName(null, true)#> { get; set; }

Templates/PHP/Model/ComplexType.php.tt

@@ -29,6 +29,10 @@ foreach(var property in complex.Properties.Where(prop => prop.Type.GetTypeString
 
     /**
     * Gets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @return <#=property.Type.GetTypeString()#> The <#=property.Name#>
     */
@@ -53,6 +57,10 @@ foreach(var property in complex.Properties.Where(prop => prop.Type.GetTypeString
 
     /**
     * Sets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @param <#=property.Type.GetTypeString()#> $val The value of the <#=property.Name#>
     *
@@ -80,6 +88,10 @@ foreach(var property in complex.Properties.Where(prop => prop.Type.GetTypeString
 
     /**
     * Gets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @return <#=property.Type.GetTypeString()#> The <#=property.Name#>
     */
@@ -98,6 +110,10 @@ foreach(var property in complex.Properties.Where(prop => prop.Type.GetTypeString
 
     /**
     * Sets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @param <#=property.Type.GetTypeString()#> $val The value to assign to the <#=property.Name#>
     *

Templates/PHP/Model/EntityType.php.tt

@@ -67,6 +67,10 @@ foreach(var property in entity.Properties.Where(prop => prop.Type.GetTypeString(
 
      /** 
      * Gets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
      *
      * @return array The <#=property.Name#>
      */
@@ -81,6 +85,10 @@ foreach(var property in entity.Properties.Where(prop => prop.Type.GetTypeString(
 
     /** 
     * Sets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @param string $val The <#=property.Name#>
     *
@@ -98,6 +106,10 @@ foreach(var property in entity.Properties.Where(prop => prop.Type.GetTypeString(
 
     /**
     * Gets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @return <#=property.Type.GetTypeString()#> The <#=property.Name#>
     */
@@ -116,6 +128,10 @@ foreach(var property in entity.Properties.Where(prop => prop.Type.GetTypeString(
 
     /**
     * Sets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @param string $val The <#=property.Name#>
     *
@@ -139,6 +155,10 @@ foreach(var property in entity.Properties.Where(prop => prop.Type.GetTypeString(
 
     /**
     * Gets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @return <#=property.Type.GetTypeString()#> The <#=property.Name#>
     */
@@ -163,6 +183,10 @@ foreach(var property in entity.Properties.Where(prop => prop.Type.GetTypeString(
 
     /**
     * Sets the <#=property.Name#>
+<# if (property.LongDescription != null) {
+#>
+    * <#=property.LongDescription#>
+<# } #>
     *
     * @param <#=property.Type.GetTypeString()#> $val The <#=property.Name#>
     *