From 7f5071b8c9d050cc0262c6b8f0b0c48146114512 Mon Sep 17 00:00:00 2001 From: brain Date: Fri, 13 May 2005 02:04:28 +0000 Subject: Re-added the dot graphs again git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@1372 e03df62e-2008-0410-955e-edbf42e46eb7 --- docs/module-doc/graph_legend.html | 75 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 docs/module-doc/graph_legend.html (limited to 'docs/module-doc/graph_legend.html') diff --git a/docs/module-doc/graph_legend.html b/docs/module-doc/graph_legend.html new file mode 100644 index 000000000..b18649195 --- /dev/null +++ b/docs/module-doc/graph_legend.html @@ -0,0 +1,75 @@ + + +InspIRCd: Graph Legend + + + +

Graph Legend

This page explains how to interpret the graphs that are generated by doxygen.

+Consider the following example:

/*! Invisible class because of truncation */
+class Invisible { };
+
+/*! Truncated class, inheritance relation is hidden */
+class Truncated : public Invisible { };
+
+/* Class not documented with doxygen comments */
+class Undocumented { };
+
+/*! Class that is inherited using public inheritance */
+class PublicBase : public Truncated { };
+
+/*! A template class */
+template<class T> class Templ { };
+
+/*! Class that is inherited using protected inheritance */
+class ProtectedBase { };
+
+/*! Class that is inherited using private inheritance */
+class PrivateBase { };
+
+/*! Class that is used by the Inherited class */
+class Used { };
+
+/*! Super class that inherits a number of other classes */
+class Inherited : public PublicBase,
+                  protected ProtectedBase,
+                  private PrivateBase,
+                  public Undocumented
+                  public Templ<int>
+{
+  private:
+    Used *m_usedClass;
+};
+

If the MAX_DOT_GRAPH_HEIGHT tag in the configuration file is set to 240 this will result in the following graph:

+The boxes in the above graph have the following meaning:

+A filled black box represents the struct or class for which the graph is generated.
+A box with a black border denotes a documented struct or class.
+A box with a grey border denotes an undocumented struct or class.
+A box with a red border denotes a documented struct or class forwhich not all inheritance/containment relations are shown. A graph is truncated if it does not fit within the specified boundaries.

+The arrows have the following meaning:

+A dark blue arrow is used to visualize a public inheritance relation between two classes.
+A dark green arrow is used for protected inheritance.
+A dark red arrow is used for private inheritance.
+A purple dashed arrow is used if a class is contained or used by another class. The arrow is labeled with the variable(s) through which the pointed class or struct is accessible.
+A yellow dashed arrow denotes a relation between a template instance and the template class it was instantiated from. The arrow is labeled with the template parameters of the instance.

Generated on Fri May 13 02:00:22 2005 for InspIRCd by + +

+1.3.3

+ + -- cgit v1.2.3