Add documentation for "deprecate" cycle handling

.htaccess

@@ -52,3 +52,6 @@ version|traits|errors|unittest|garbage|float|iasm|ddoc|interfaceToC|\
 cpp_interface|objc_interface|portability|entity|memory-safe-d|abi|simd)\
 (\.html)?$ \
 spec/$1.html [R=301,L]
+
+# Error pages
+ErrorDocument 404 /404.html

404.dd

@@ -0,0 +1,12 @@
+Ddoc
+
+$(D_S 404 Not Found,
+
+$(P
+Page not found!
+
+If you think there should be something here, please use the "Report a bug" link above to let us know.
+))
+
+Macros:
+    TITLE=404 Not Found

cpptod.dd

@@ -2,7 +2,7 @@ Ddoc
 
 $(COMMUNITY Programming in D for C++ Programmers,
 
-<!--img src="images/cpp1.gif" border="0" align="right" alt="C++"-->
+$(COMMENT img src="images/cpp1.gif" border="0" align="right" alt="C++")
 
 $(P Every experienced C++ programmer accumulates a series of idioms and techniques
 which become second nature. Sometimes, when learning a new language, those
@@ -28,7 +28,7 @@ $(UL
 )
 
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 
 $(H3 <a name="constructors">Defining constructors</a>)
 
@@ -56,7 +56,7 @@ class Foo
 
 	which reflects how they are used in D.
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="baseclass">Base class initialization</a>)
 
 $(H4 The C++ Way)
@@ -125,7 +125,7 @@ class A
 }
 ------
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="structcmp">Comparing structs</a>)
 
 $(H4 The C++ Way)
@@ -188,7 +188,7 @@ if (x == y)
     ...
 ------
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="typedefs">Creating a new typedef'd type</a>)
 
 $(H4 The C++ Way)
@@ -255,7 +255,7 @@ if (h != Handle.init)
 	default initializer can be supplied to $(REF Typedef, std,typecons)
 	as a value of the underlying type.
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="friends">Friends</a>)
 
 $(H4 The C++ Way)
@@ -326,7 +326,7 @@ int abc(A p) { return p.a; }
 	The $(D private) attribute prevents other modules from
 	accessing the members.
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="operatoroverloading">Operator overloading</a>)
 
 $(H4 The C++ Way)
@@ -375,7 +375,7 @@ struct A
 	error prone. Far less code needs to be written to accomplish
 	the same effect.)
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="usingdeclaration">Namespace using declarations</a>)
 
 $(H4 The C++ Way)
@@ -410,7 +410,7 @@ alias x = foo.x;
 	declaration. Alias can be used to rename symbols, refer to
 	template members, refer to nested class types, etc.
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="raii">RAII (Resource Acquisition Is Initialization)</a>)
 
 $(H4 The C++ Way)
@@ -475,7 +475,7 @@ mechanism that lets you run arbitrary statements whenever leaving the current
 scope.)
 
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="properties">Properties</a>)
 
 $(H4 The C++ Way)
@@ -542,7 +542,7 @@ int x = a.property;
 	It's also a way to have interface classes, which do not have
 	data fields, behave syntactically as if they did.
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 $(H3 <a name="recursivetemplates">Recursive Templates</a>)
 
 $(H4 The C++ Way)
@@ -593,7 +593,7 @@ void test()
 }
 ------
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 
 $(H3 <a name="metatemplates">Meta Templates</a>)
 
@@ -745,7 +745,7 @@ int main()
 }
 ------
 
-<hr><!-- -------------------------------------------- -->
+<hr>$(COMMENT  -------------------------------------------- )
 
 $(H3 <a name="typetraits">Type Traits</a>)
 

css/style.css

@@ -1217,6 +1217,16 @@ These classes come from prettify.js:
 .cm-s-eclipse span.cm-link {color: #219;}
 
 
+.ddoc_keyword
+{
+    font-weight: bold;
+}
+
+.ddoc_param
+{
+    font-style: italic;
+}
+
 /* Focal symbol that is being documented */
 .d_psymbol, .ddoc_psymbol
 {
@@ -2103,3 +2113,8 @@ dt.d_decl:hover .decl_anchor {
     text-decoration: none;
     color: #333;
 }
+
+/* Style for the example run buttons on the Phobos library documentation */
+.d_example_buttons {
+    text-align: right;
+}