Fix.

Author: csyonghe

source/slang/hlsl.meta.slang

@@ -380,15 +380,16 @@ vector<T,N+1> __makeVector(vector<T,N> vec, T scalar);
 /// @see `Texture1D`, `Texture2D`, `Texture3D`, `TextureCube`, `Texture1DArray`,
 /// `Texture2DArray`, `TextureCubeArray`, `Sampler1D`, `Sampler2D`, `Sampler3D`, `SamplerCube`, `Sampler1DArray`, `Sampler2DArray`, `SamplerCubeArray`,
 /// `Texture2DMS`, `Texture2DMSArray`, `RWTexture1D`, `RWTexture2D`, `RWTexture3D`, `RWTexture1DArray`, `RWTexture2DArray`,
-/// `RWTexture2DMS`, `RWTexture2DMSArray`, `RWTextureBuffer`, `FeedbackTexture2D`, `FeedbackTexture2DArray`.
+/// `RWTexture2DMS`, `RWTexture2DMSArray`, `Buffer`, `RWBuffer`, `FeedbackTexture2D`, `FeedbackTexture2DArray`.
 /// @remarks
 /// HLSL texture types are implemented as typealiases to the builtin `_Texture` type. Users
 /// are advised to use the HLSL-specific texture types instead of `_Texture` directly.
 ///
 /// For read-write textures, Slang will automatically infer `format` from `T`.
 /// To explicitly specify texel storage formats for read-write textures,
-/// use the `[format("...")]` attribute on the texture parameter declaration.
-/// Allowed `format` values are:
+/// use the `[format("formatString")]` attribute on the texture parameter declaration.
+/// Allowed `formatString` values are:
+///
 /// |id | Format string        | Meaning           |
 /// |:--|:---------------------|:------------------|
 /// |1  |`"rgba32f"`           | 4 channel 32-bit floating point texture |

source/slang/slang-doc-markdown-writer.cpp

@@ -1679,6 +1679,17 @@ void DocMarkdownWriter::writeAggType(DocumentPage* page, const ASTMarkup::Entry&
                         }
                     }
                 }
+
+                if (paramList[i].text.getLength() == 0)
+                {
+                    ParamDocumentation paramDoc;
+                    if (declDoc.parameters.tryGetValue(getText(param->getName()), paramDoc))
+                    {
+                        StringBuilder sb;
+                        sb << paramDoc.description.ownedText;
+                        paramList[i].text = sb.produceString();
+                    }
+                }
             }
             _appendAsBullets(paramList, false, 0);
             out << toSlice("\n");
@@ -1849,6 +1860,16 @@ String DocMarkdownWriter::translateToMarkdownWithLinks(String text, bool strictC
     for (; !reader.IsEnd(); )
     {
         auto token = reader.ReadToken();
+
+        // If the token is a string literal, we want to treat it as an identifier.
+        if (token.Type == Slang::Misc::TokenType::StringLiteral)
+        {
+            token.Type = Slang::Misc::TokenType::Identifier;
+            StringBuilder stringSB;
+            StringEscapeUtil::appendQuoted(StringEscapeUtil::getHandler(StringEscapeUtil::Style::Cpp), token.Content.getUnownedSlice(), stringSB);
+            token.Content = stringSB.produceString();
+        }
+
         if (token.Type == Slang::Misc::TokenType::Identifier)
         {
             if (requireSpaceBeforeNextToken)
@@ -2083,7 +2104,7 @@ void DeclDocumentation::writeSection(StringBuilder& out, DocMarkdownWriter* writ
     }
     if (sectionDoc && sectionDoc->ownedText.getLength() > 0)
     {
-        out << "## \"" << getSectionTitle(section) << "\n\n";
+        out << "## " << getSectionTitle(section) << "\n\n";
         sectionDoc->write(writer, out);
     }
 }