DDoc tweaks and fixes

Author: CyberShadow

changelog.dd

@@ -110,7 +110,7 @@ $(VERSION 060, ddd mm, 2012, =================================================,
         $(LI $(BUGZILLA 4629): BufferedFile.printf() wants char[] as first argument)
         $(LI $(BUGZILLA 4695): std.range.zip is broken)
         $(LI $(BUGZILLA 4744): std.conv: string->enum doesn't look for longer match)
-        $(LI $(BUGZILLA 4822): Problem with std.stdio.File.writef("%c")
+        $(LI $(BUGZILLA 4822): Problem with std.stdio.File.writef("%c"))
         $(LI $(BUGZILLA 5011): std.container: SList linearRemove produces wrong results)
         $(LI $(BUGZILLA 5089): feqrel does not compile for floats)
         $(LI $(BUGZILLA 5260): std.math.feqrel() returns negative number)

std/algorithm.d

@@ -146,7 +146,7 @@ until a specific value is found.)
 $(LEADINGROW Comparison
 )
 $(TR $(TDNW $(LREF cmp)) $(TD $(D cmp("abc", "abcd")) is $(D
--1), $(D cmp("abc", aba")) is $(D 1), and $(D cmp("abc", "abc")) is
+-1), $(D cmp("abc", "aba")) is $(D 1), and $(D cmp("abc", "abc")) is
 $(D 0).)
 )
 $(TR $(TDNW $(LREF equal)) $(TD Compares ranges for

std/file.d

@@ -4,7 +4,7 @@
 Utilities for manipulating files and scanning directories. Functions
 in this module handle files as a unit, e.g., read or write one _file
 at a time. For opening files and manipulating them via handles refer
-to module $(D $(LINK2 std_stdio.html,std.stdio)).
+to module $(LINK2 std_stdio.html,$(D std.stdio)).
 
 Macros:
 WIKI = Phobos/StdFile
@@ -2904,7 +2904,7 @@ unittest
 Returns the path to a directory for temporary files.
 
 On Windows, this function returns the result of calling the Windows API function
-$(D $(LINK2 http://msdn.microsoft.com/en-us/library/windows/desktop/aa364992.aspx, GetTempPath)).
+$(LINK2 http://msdn.microsoft.com/en-us/library/windows/desktop/aa364992.aspx, $(D GetTempPath)).
 
 On POSIX platforms, it searches through the following list of directories
 and returns the first one which is found to exist:
@@ -2927,7 +2927,7 @@ environment variables and directory structures have changed in the
 meantime.
 
 The POSIX $(D tempDir) algorithm is inspired by Python's
-$(D $(LINK2 http://docs.python.org/library/tempfile.html#tempfile.tempdir, tempfile.tempdir)).
+$(LINK2 http://docs.python.org/library/tempfile.html#tempfile.tempdir, $(D tempfile.tempdir)).
 */
 string tempDir()
 {

std/format.d

@@ -2280,7 +2280,7 @@ if (!is(StringTypeOf!T) && !is(CharTypeOf!T) || is(T == enum))
 }
 
 /**
-   Associative arrays are formatted by using $(D ':') and $(D ', ') as
+   Associative arrays are formatted by using $(D ':') and $(D ", ") as
    separators, and enclosed by $(D '[') and $(D ']').
  */
 void formatValue(Writer, T, Char)(Writer w, T obj, ref FormatSpec!Char f)

std/path.d

@@ -13,7 +13,7 @@
     To differentiate between these cases, use $(XREF file,isDir) and
     $(XREF file,exists).
 
-    Note that on Windows, both the backslash ($(D '\')) and the slash ($(D '/'))
+    Note that on Windows, both the backslash ($(D `\`)) and the slash ($(D `/`))
     are in principle valid directory separators.  This module treats them
     both on equal footing, but in cases where a $(I new) separator is
     added, a backslash will be used.  Furthermore, the $(LREF buildNormalizedPath)
@@ -91,8 +91,8 @@ else static assert (0, "unsupported platform");
 
 /** Determines whether the given character is a directory separator.
 
-    On Windows, this includes both $(D '\') and $(D '/').
-    On POSIX, it's just $(D '/').
+    On Windows, this includes both $(D `\`) and $(D `/`).
+    On POSIX, it's just $(D `/`).
 */
 bool isDirSeparator(dchar c)  @safe pure nothrow
 {
@@ -1703,7 +1703,7 @@ unittest
     ---
 
     On Windows, an absolute path starts at the root directory of
-    a specific drive.  Hence, it must start with $(D "d:\") or $(D "d:/"),
+    a specific drive.  Hence, it must start with $(D `d:\`) or $(D `d:/`),
     where $(D d) is the drive letter.  Alternatively, it may be a
     network path, i.e. a path starting with a double (back)slash.
     ---
@@ -1834,14 +1834,14 @@ unittest
     taken to be the current working directory.  If specified,
     $(D base) must be an absolute _path, and it is always assumed
     to refer to a directory.  If $(D path) and $(D base) refer to
-    the same directory, the function returns $(D ".").
+    the same directory, the function returns $(D `.`).
 
     The following algorithm is used:
     $(OL
         $(LI If $(D path) is a relative directory, return it unaltered.)
         $(LI Find a common root between $(D path) and $(D base).
             If there is no common root, return $(D path) unaltered.)
-        $(LI Prepare a string with as many $(D "../") or $(D "..\") as
+        $(LI Prepare a string with as many $(D `../`) or $(D `..\`) as
             necessary to reach the common root from base path.)
         $(LI Append the remaining segments of $(D path) to the string
             and return.)
@@ -1975,7 +1975,7 @@ unittest
     which, if not specified, is given by
     $(LREF CaseSensitive)$(D .osDefault).
 
-    On Windows, the backslash and slash characters ($(D '\') and $(D '/'))
+    On Windows, the backslash and slash characters ($(D `\`) and $(D `/`))
     are considered equal.
 
     Examples:

std/range.d

@@ -233,8 +233,8 @@ $(BOOKTABLE ,
 
 Ranges whose elements are sorted afford better efficiency with certain
 operations. For this, the $(D $(LREF assumeSorted)) function can be used to
-construct a $(D $(LREF SortedRange)) from a pre-sorted _range. The $(D $(LINK2
-std_algorithm.html#sort, std.algorithm.sort)) function also conveniently
+construct a $(D $(LREF SortedRange)) from a pre-sorted _range. The $(LINK2
+std_algorithm.html#sort, $(D std.algorithm.sort)) function also conveniently
 returns a $(D SortedRange). $(D SortedRange) objects provide some additional
 _range operations that take advantage of the fact that the _range is sorted.
 

std/string.d

@@ -2982,7 +2982,7 @@ unittest
     $(D to).
 
     Both $(D from) and $(D to) may contain ranges using the $(D '-') character
-    (e.g. $(D "a-d") is synonymous with $(D "abcd).) Neither accept a leading
+    (e.g. $(D "a-d") is synonymous with $(D "abcd").) Neither accept a leading
     $(D '^') as meaning the complement of the string (use the $(D 'c') modifier
     for that).
   +/