From af781e23b4c9cd605d18fe0b521688b25e637e52 Mon Sep 17 00:00:00 2001
From: Steven Schveighoffer <schveiguy@yahoo.com>
Date: Wed, 1 Apr 2020 13:53:08 -0400
Subject: [PATCH] Turn on markdown. Fix issue where D example code was
 delineated with underscores instead of dashes.

---
 posix.mak                          |  2 +-
 src/core/sys/darwin/mach/getsect.d | 32 +++++++++++++++---------------
 src/rt/dwarfeh.d                   |  6 +++---
 3 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/posix.mak b/posix.mak
index 6d9833a197..b6c03c3de7 100644
--- a/posix.mak
+++ b/posix.mak
@@ -65,7 +65,7 @@ LINKDL=$(if $(findstring $(OS),linux),-L-ldl,)
 
 MAKEFILE = $(firstword $(MAKEFILE_LIST))
 
-DDOCFLAGS=-conf= -c -w -o- -Isrc -Iimport -version=CoreDdoc
+DDOCFLAGS=-conf= -c -w -o- -Isrc -Iimport -version=CoreDdoc -preview=markdown
 
 # Set CFLAGS
 CFLAGS=$(MODEL_FLAG) -fPIC -DHAVE_UNISTD_H
diff --git a/src/core/sys/darwin/mach/getsect.d b/src/core/sys/darwin/mach/getsect.d
index 98eaf06852..fd1a8e4ea3 100644
--- a/src/core/sys/darwin/mach/getsect.d
+++ b/src/core/sys/darwin/mach/getsect.d
@@ -44,7 +44,7 @@ version (CoreDdoc)
      * Returns the section data of the given section in the given segment in the
      * mach executable it is linked into.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
@@ -52,7 +52,7 @@ version (CoreDdoc)
      *      assert(getsectdata("__TEXT", "__text", &size));
      *      assert(size > 0);
      * }
-     * ___
+     * ---
      *
      * Params:
      *  segname = the name of the segment
@@ -74,7 +74,7 @@ version (CoreDdoc)
      * Returns the section data of the given section in the given segment in the
      * given framework.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
@@ -82,7 +82,7 @@ version (CoreDdoc)
      *      assert(getsectdatafromFramework("Foundation", "__TEXT", "__text", &size));
      *      assert(size > 0);
      * }
-     * ___
+     * ---
      *
      * Params:
      *  FrameworkName = the name of the framework to get the section data from
@@ -115,13 +115,13 @@ version (CoreDdoc)
      * Returns the section structure of the given section in the given segment
      * in the mach executable it is linked into.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
      *      assert(getsectbyname("__TEXT", "__text"));
      * }
-     * ___
+     * ---
      *
      * Params:
      *  segname = the name of the segment
@@ -140,7 +140,7 @@ version (CoreDdoc)
      * Returns the section data of the given section in the given segment in the
      * image pointed to by the given mach header.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
@@ -151,7 +151,7 @@ version (CoreDdoc)
      *      assert(getsectdata(mph, "__TEXT", "__text", &size));
      *      assert(size > 0);
      * }
-     * ___
+     * ---
      *
      * Params:
      *  mhp = the mach header to get the section data from
@@ -175,13 +175,13 @@ version (CoreDdoc)
      * Returns the segment structure of the given segment in the mach executable
      * it is linked into.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
      *      assert(getsegbyname("__TEXT"));
      * }
-     * ___
+     * ---
      *
      * Params:
      *  segname = the name of the segment
@@ -198,7 +198,7 @@ version (CoreDdoc)
      * Returns the segment data of the given segment in the image pointed to by
      * the given mach header.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
@@ -209,7 +209,7 @@ version (CoreDdoc)
      *      assert(getsegmentdata(mph, "__TEXT", &size));
      *      assert(size > 0);
      * }
-     * ___
+     * ---
      *
      * Params:
      *  mhp = the mach header to get the section data from
@@ -236,7 +236,7 @@ version (CoreDdoc)
      * Returns the section data of the given section in the given segment in the
      * image pointed to by the given mach header.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
@@ -247,7 +247,7 @@ version (CoreDdoc)
      *      assert(getsectdatafromheader(mph, "__TEXT", "__text", &size));
      *      assert(size > 0);
      * }
-     * ___
+     * ---
      *
      * Params:
      *  mhp = the mach header to get the section data from
@@ -280,7 +280,7 @@ version (CoreDdoc)
      * Returns the section structure of the given section in the given segment
      * in image pointed to by the given mach header.
      *
-     * ___
+     * ---
      * void main()
      * {
      *      import core.sys.darwin.mach.getsect;
@@ -289,7 +289,7 @@ version (CoreDdoc)
      *      auto mph = _NSGetMachExecuteHeader();
      *      assert(getsectbynamefromheader(mph, "__TEXT", "__text"));
      * }
-     * ___
+     * ---
      *
      * Params:
      *  mhp = the mach header to get the section from
diff --git a/src/rt/dwarfeh.d b/src/rt/dwarfeh.d
index da38e52bf0..1cdc3ec5e6 100644
--- a/src/rt/dwarfeh.d
+++ b/src/rt/dwarfeh.d
@@ -746,9 +746,9 @@ LsdaResult scanLSDA(const(ubyte)* lsda, _Unwind_Ptr ip, _Unwind_Exception_Class
  *      exceptionClass = which language threw the exception
  *      lsda = pointer to LSDA table
  * Returns:
- *      >=1 means the handler index of the classType
- *      0 means classType is not in the Action Table
- *      <0 means corrupt
+ *      - &gt;=1 means the handler index of the classType
+ *      - 0 means classType is not in the Action Table
+ *      - &lt;0 means corrupt
  */
 int actionTableLookup(_Unwind_Exception* exceptionObject, uint actionRecordPtr, const(ubyte)* pActionTable,
                       const(ubyte)* tt, ubyte TType, _Unwind_Exception_Class exceptionClass, const(ubyte)* lsda)