summaryrefslogtreecommitdiffstats
path: root/source
diff options
context:
space:
mode:
authorjsmall-nvidia <jsmall@nvidia.com>2021-03-11 17:56:03 -0500
committerGitHub <noreply@github.com>2021-03-11 14:56:03 -0800
commit9ffe2f3ef245034a2dae42017a9059dfe4d02647 (patch)
treea19de69cb4e039edc2f25b28515cb4d7da31e2d6 /source
parent5bcb342962634e9c36fe399a822e685bb2eb8d76 (diff)
MarkDown -> Markdown (#1748)
* #include an absolute path didn't work - because paths were taken to always be relative. * MarkDown -> Markdown slang-doc-mark-down -> slang-doc-markdown-writer
Diffstat (limited to 'source')
-rw-r--r--source/slang/slang-doc-markdown-writer.cpp (renamed from source/slang/slang-doc-mark-down.cpp)61
-rw-r--r--source/slang/slang-doc-markdown-writer.h (renamed from source/slang/slang-doc-mark-down.h)10
-rw-r--r--source/slang/slang.cpp6
3 files changed, 38 insertions, 39 deletions
diff --git a/source/slang/slang-doc-mark-down.cpp b/source/slang/slang-doc-markdown-writer.cpp
index 384759474..259762e88 100644
--- a/source/slang/slang-doc-mark-down.cpp
+++ b/source/slang/slang-doc-markdown-writer.cpp
@@ -1,5 +1,5 @@
-// slang-doc-mark-down.cpp
-#include "slang-doc-mark-down.h"
+// slang-doc-markdown-writer.cpp
+#include "slang-doc-markdown-writer.h"
#include "../core/slang-string-util.h"
@@ -8,8 +8,7 @@
namespace Slang {
-
-struct DocMarkDownWriter::StringListSet
+struct DocMarkdownWriter::StringListSet
{
Index add(const HashSet<String>& set)
{
@@ -91,7 +90,7 @@ static void _appendAsSingleLine(const UnownedStringSlice& in, StringBuilder& out
StringUtil::join(lines.getBuffer(), lines.getCount(), ' ', out);
}
-void DocMarkDownWriter::_appendAsBullets(const List<NameAndText>& values, char wrapChar)
+void DocMarkdownWriter::_appendAsBullets(const List<NameAndText>& values, char wrapChar)
{
auto& out = m_builder;
for (const auto& value : values)
@@ -125,7 +124,7 @@ void DocMarkDownWriter::_appendAsBullets(const List<NameAndText>& values, char w
}
}
-void DocMarkDownWriter::_appendAsBullets(const List<String>& values, char wrapChar)
+void DocMarkdownWriter::_appendAsBullets(const List<String>& values, char wrapChar)
{
auto& out = m_builder;
for (const auto& value : values)
@@ -150,14 +149,14 @@ void DocMarkDownWriter::_appendAsBullets(const List<String>& values, char wrapCh
}
}
-String DocMarkDownWriter::_getName(Decl* decl)
+String DocMarkdownWriter::_getName(Decl* decl)
{
StringBuilder buf;
ASTPrinter::appendDeclName(decl, buf);
return buf.ProduceString();
}
-String DocMarkDownWriter::_getName(InheritanceDecl* decl)
+String DocMarkdownWriter::_getName(InheritanceDecl* decl)
{
StringBuilder buf;
buf.Clear();
@@ -165,7 +164,7 @@ String DocMarkDownWriter::_getName(InheritanceDecl* decl)
return buf.ProduceString();
}
-DocMarkDownWriter::NameAndText DocMarkDownWriter::_getNameAndText(DocMarkup::Entry* entry, Decl* decl)
+DocMarkdownWriter::NameAndText DocMarkdownWriter::_getNameAndText(DocMarkup::Entry* entry, Decl* decl)
{
NameAndText nameAndText;
@@ -181,13 +180,13 @@ DocMarkDownWriter::NameAndText DocMarkDownWriter::_getNameAndText(DocMarkup::Ent
return nameAndText;
}
-DocMarkDownWriter::NameAndText DocMarkDownWriter::_getNameAndText(Decl* decl)
+DocMarkdownWriter::NameAndText DocMarkdownWriter::_getNameAndText(Decl* decl)
{
DocMarkup::Entry* entry = m_markup->getEntry(decl);
return _getNameAndText(entry, decl);
}
-List<DocMarkDownWriter::NameAndText> DocMarkDownWriter::_getAsNameAndTextList(const List<Decl*>& in)
+List<DocMarkdownWriter::NameAndText> DocMarkdownWriter::_getAsNameAndTextList(const List<Decl*>& in)
{
List<NameAndText> out;
for (auto decl : in)
@@ -197,7 +196,7 @@ List<DocMarkDownWriter::NameAndText> DocMarkDownWriter::_getAsNameAndTextList(co
return out;
}
-List<String> DocMarkDownWriter::_getAsStringList(const List<Decl*>& in)
+List<String> DocMarkdownWriter::_getAsStringList(const List<Decl*>& in)
{
List<String> strings;
for (auto decl : in)
@@ -207,7 +206,7 @@ List<String> DocMarkDownWriter::_getAsStringList(const List<Decl*>& in)
return strings;
}
-void DocMarkDownWriter::_appendCommaList(const List<String>& strings, char wrapChar)
+void DocMarkdownWriter::_appendCommaList(const List<String>& strings, char wrapChar)
{
for (Index i = 0; i < strings.getCount(); ++i)
{
@@ -228,7 +227,7 @@ void DocMarkDownWriter::_appendCommaList(const List<String>& strings, char wrapC
}
}
-/* static */void DocMarkDownWriter::getSignature(const List<Part>& parts, Signature& outSig)
+/* static */void DocMarkdownWriter::getSignature(const List<Part>& parts, Signature& outSig)
{
const Index count = parts.getCount();
for (Index i = 0; i < count; ++i)
@@ -279,7 +278,7 @@ void DocMarkDownWriter::_appendCommaList(const List<String>& strings, char wrapC
}
}
-void DocMarkDownWriter::writeVar(const DocMarkup::Entry& entry, VarDecl* varDecl)
+void DocMarkdownWriter::writeVar(const DocMarkup::Entry& entry, VarDecl* varDecl)
{
writePreamble(entry);
auto& out = m_builder;
@@ -296,7 +295,7 @@ void DocMarkDownWriter::writeVar(const DocMarkup::Entry& entry, VarDecl* varDecl
writeDescription(entry);
}
-void DocMarkDownWriter::writeSignature(CallableDecl* callableDecl)
+void DocMarkdownWriter::writeSignature(CallableDecl* callableDecl)
{
auto& out = m_builder;
@@ -399,7 +398,7 @@ void DocMarkDownWriter::writeSignature(CallableDecl* callableDecl)
}
}
-List<DocMarkDownWriter::NameAndText> DocMarkDownWriter::_getUniqueParams(const List<Decl*>& decls)
+List<DocMarkdownWriter::NameAndText> DocMarkdownWriter::_getUniqueParams(const List<Decl*>& decls)
{
List<NameAndText> out;
@@ -476,7 +475,7 @@ static void _addRequirements(Decl* decl, HashSet<String>& outRequirements)
}
}
-void DocMarkDownWriter::_maybeAppendSet(const UnownedStringSlice& title, const StringListSet& set)
+void DocMarkdownWriter::_maybeAppendSet(const UnownedStringSlice& title, const StringListSet& set)
{
auto& out = m_builder;
@@ -553,7 +552,7 @@ static bool _isFirstOverridden(Decl* decl)
return false;
}
-void DocMarkDownWriter::writeCallableOverridable(const DocMarkup::Entry& entry, CallableDecl* callableDecl)
+void DocMarkdownWriter::writeCallableOverridable(const DocMarkup::Entry& entry, CallableDecl* callableDecl)
{
auto& out = m_builder;
@@ -761,7 +760,7 @@ void DocMarkDownWriter::writeCallableOverridable(const DocMarkup::Entry& entry,
}
}
-void DocMarkDownWriter::writeEnum(const DocMarkup::Entry& entry, EnumDecl* enumDecl)
+void DocMarkdownWriter::writeEnum(const DocMarkup::Entry& entry, EnumDecl* enumDecl)
{
writePreamble(entry);
@@ -782,7 +781,7 @@ void DocMarkDownWriter::writeEnum(const DocMarkup::Entry& entry, EnumDecl* enumD
writeDescription(entry);
}
-void DocMarkDownWriter::_appendEscaped(const UnownedStringSlice& text)
+void DocMarkdownWriter::_appendEscaped(const UnownedStringSlice& text)
{
auto& out = m_builder;
@@ -826,7 +825,7 @@ void DocMarkDownWriter::_appendEscaped(const UnownedStringSlice& text)
}
-void DocMarkDownWriter::_appendDerivedFrom(const UnownedStringSlice& prefix, AggTypeDeclBase* aggTypeDecl)
+void DocMarkdownWriter::_appendDerivedFrom(const UnownedStringSlice& prefix, AggTypeDeclBase* aggTypeDecl)
{
auto& out = m_builder;
@@ -849,7 +848,7 @@ void DocMarkDownWriter::_appendDerivedFrom(const UnownedStringSlice& prefix, Agg
}
}
-void DocMarkDownWriter::_appendAggTypeName(AggTypeDeclBase* aggTypeDecl)
+void DocMarkdownWriter::_appendAggTypeName(AggTypeDeclBase* aggTypeDecl)
{
auto& out = m_builder;
@@ -881,7 +880,7 @@ void DocMarkDownWriter::_appendAggTypeName(AggTypeDeclBase* aggTypeDecl)
}
}
-void DocMarkDownWriter::writeAggType(const DocMarkup::Entry& entry, AggTypeDeclBase* aggTypeDecl)
+void DocMarkdownWriter::writeAggType(const DocMarkup::Entry& entry, AggTypeDeclBase* aggTypeDecl)
{
writePreamble(entry);
@@ -1002,7 +1001,7 @@ void DocMarkDownWriter::writeAggType(const DocMarkup::Entry& entry, AggTypeDeclB
}
}
-void DocMarkDownWriter::writePreamble(const DocMarkup::Entry& entry)
+void DocMarkdownWriter::writePreamble(const DocMarkup::Entry& entry)
{
SLANG_UNUSED(entry);
auto& out = m_builder;
@@ -1012,7 +1011,7 @@ void DocMarkDownWriter::writePreamble(const DocMarkup::Entry& entry)
out << toSlice("\n");
}
-void DocMarkDownWriter::writeDescription(const DocMarkup::Entry& entry)
+void DocMarkdownWriter::writeDescription(const DocMarkup::Entry& entry)
{
auto& out = m_builder;
@@ -1032,7 +1031,7 @@ void DocMarkDownWriter::writeDescription(const DocMarkup::Entry& entry)
}
}
-void DocMarkDownWriter::writeDecl(const DocMarkup::Entry& entry, Decl* decl)
+void DocMarkdownWriter::writeDecl(const DocMarkup::Entry& entry, Decl* decl)
{
// Skip these they will be output as part of their respective 'containers'
if (as<ParamDecl>(decl) || as<EnumCaseDecl>(decl) || as<AssocTypeDecl>(decl) || as<InheritanceDecl>(decl))
@@ -1071,12 +1070,12 @@ void DocMarkDownWriter::writeDecl(const DocMarkup::Entry& entry, Decl* decl)
}
}
-bool DocMarkDownWriter::isVisible(const Name* name)
+bool DocMarkdownWriter::isVisible(const Name* name)
{
return name == nullptr || !name->text.startsWith(toSlice("__"));
}
-bool DocMarkDownWriter::isVisible(const DocMarkup::Entry& entry)
+bool DocMarkdownWriter::isVisible(const DocMarkup::Entry& entry)
{
// For now if it's not public it's not visible
if (entry.m_visibility != MarkupVisibility::Public)
@@ -1088,7 +1087,7 @@ bool DocMarkDownWriter::isVisible(const DocMarkup::Entry& entry)
return decl == nullptr || isVisible(decl->getName());
}
-bool DocMarkDownWriter::isVisible(Decl* decl)
+bool DocMarkdownWriter::isVisible(Decl* decl)
{
if (!isVisible(decl->getName()))
{
@@ -1099,7 +1098,7 @@ bool DocMarkDownWriter::isVisible(Decl* decl)
return entry == nullptr || entry->m_visibility == MarkupVisibility::Public;
}
-void DocMarkDownWriter::writeAll()
+void DocMarkdownWriter::writeAll()
{
for (const auto& entry : m_markup->getEntries())
{
diff --git a/source/slang/slang-doc-mark-down.h b/source/slang/slang-doc-markdown-writer.h
index c42d406dc..93607d5f4 100644
--- a/source/slang/slang-doc-mark-down.h
+++ b/source/slang/slang-doc-markdown-writer.h
@@ -1,6 +1,6 @@
-// slang-doc-markdown.h
-#ifndef SLANG_DOC_MARK_DOWN_H
-#define SLANG_DOC_MARK_DOWN_H
+// slang-doc-markdown-writer.h
+#ifndef SLANG_DOC_MARKDOWN_WRITER_H
+#define SLANG_DOC_MARKDOWN_WRITER_H
#include "slang-doc-extractor.h"
#include "slang-ast-print.h"
@@ -9,7 +9,7 @@ namespace Slang {
class ASTBuilder;
-struct DocMarkDownWriter
+struct DocMarkdownWriter
{
typedef ASTPrinter::Part Part;
typedef ASTPrinter::PartPair PartPair;
@@ -52,7 +52,7 @@ struct DocMarkDownWriter
const StringBuilder& getOutput() const { return m_builder; }
/// Ctor.
- DocMarkDownWriter(DocMarkup* markup, ASTBuilder* astBuilder) :
+ DocMarkdownWriter(DocMarkup* markup, ASTBuilder* astBuilder) :
m_markup(markup),
m_astBuilder(astBuilder)
{
diff --git a/source/slang/slang.cpp b/source/slang/slang.cpp
index de47c48ee..2ad5d25f8 100644
--- a/source/slang/slang.cpp
+++ b/source/slang/slang.cpp
@@ -31,7 +31,7 @@
#include "slang-serialize-container.h"
#include "slang-doc-extractor.h"
-#include "slang-doc-mark-down.h"
+#include "slang-doc-markdown-writer.h"
#include "slang-check-impl.h"
@@ -275,7 +275,7 @@ SlangResult Session::compileStdLib(slang::CompileStdLibFlags compileFlags)
RefPtr<DocMarkup> markup(new DocMarkup);
DocMarkupExtractor::extract(stdlibModule->getModuleDecl(), sourceManager, &sink, markup);
- DocMarkDownWriter writer(markup, astBuilder);
+ DocMarkdownWriter writer(markup, astBuilder);
writer.writeAll();
docStrings.add(writer.getOutput());
}
@@ -1859,7 +1859,7 @@ SlangResult FrontEndCompileRequest::executeActionsInner()
String fileName = Path::getFileNameWithoutExt(path);
fileName.append(".md");
- DocMarkDownWriter writer(markup, astBuilder);
+ DocMarkdownWriter writer(markup, astBuilder);
writer.writeAll();
File::writeAllText(fileName, writer.getOutput());