moved Sniffer into new Examples directory

Doxyfile

 @INCLUDE = "$(TOPDIR)/doclib/Doxyfile.global"
 
-PROJECT_NAME           = Overview
-PROJECT_NUMBER         = "(Revision $(REVISION), generated $(TODAY))"
+PROJECT_NAME      = Overview
+PROJECT_NUMBER    = "(Revision $(REVISION), generated $(TODAY))"
 
-EXAMPLE_PATH           = Sniffer
+HTML_HEADER       = doclib/doxy-header-overview.html
+GENERATE_XML      = NO
 
-HTML_HEADER            = doclib/doxy-header-overview.html
-GENERATE_XML           = NO
+GENERATE_TAGFILE  = doc/overview.tag
\ No newline at end of file

Examples/Doxyfile

+@INCLUDE 		  = "$(TOPDIR)/doclib/Doxyfile.global"
+
+PROJECT_NAME 	  = Examples
+TAGFILES          = "$(TOPDIR)/Utils/doc/Utils.tag" "$(TOPDIR)/Socket/doc/Socket.tag" "$(TOPDIR)/Packets/doc/Packets.tag" "$(TOPDIR)/Scheduler/doc/Scheduler.tag" "$(TOPDIR)/doc/overview.tag"
+GENERATE_TAGFILE  = doc/Examples.tag
+
+EXAMPLE_PATH      = "Sniffer"
\ No newline at end of file

Example.dox → Examples/Mainpage.dox

-/** \page example Sniffer: A simple example application
+/** \mainpage Examples
+    \anchor Examples_Main
+    
+    \ref sniffer
+*/
+
+/** \page sniffer Sniffer: A simple example application
 
     \dontinclude Sniffer.cc
 
@@ -57,8 +63,6 @@
     specific type of socket which returns ethernet packets directly from the network wire. By
     uncommenting the last line, you may switch the interface into promiscuous mode.
 
-    \until //
-
     We will now read packets from the socket forever, that is until the user hits Ctrl-C
 
     \skip while
@@ -160,6 +164,7 @@
          <a href="../../Utils/doc/html/index.html"><b>libUtils API reference</b></a>
  */
 
+
 
 // Local Variables:
 // mode: c++

Examples/SConscript

+import sys, glob, os.path, datetime
+sys.path.append('senfscons')
+Import('env')
+import SENFSCons
+
+###########################################################################
+
+SConscript(glob.glob("*/SConscript"))
+
+SENFSCons.Doxygen(env)
\ No newline at end of file

Mainpage.dox

@@ -44,7 +44,7 @@
     want to contribute, read the docs and \e please adhere to the \ref conventions.
 
     \see \ref usage\n
-         \ref example
+         <a href="../../Examples/doc/html/index.html">Examples</a>
 */
 
 /** \page usage Using the SENF framework
@@ -323,7 +323,7 @@
 
     The simplest way to get started is: copy the Sniffer application and start to modify it.
 
-    \see \ref example \n
+    \see <a href="../../Examples/doc/html/index.html">Examples</a> \n
          \ref components \n
          \ref svnsetup \n
          \ref build

SConstruct

@@ -37,7 +37,7 @@ SConscript(glob.glob("*/SConscript"))
 SENFSCons.StandardTargets(env)
 SENFSCons.GlobalTargets(env)
 SENFSCons.Doxygen(env, extra_sources = [
-    'Sniffer/Sniffer.cc',
+    'Examples/Sniffer/Sniffer.cc',
 ])
 SENFSCons.DoxyXRef(env,
                    HTML_HEADER = '#/doclib/doxy-header-overview.html',

doclib/doxy-header-overview.html

@@ -24,6 +24,7 @@ div.tabs ul li.$projectname a { background-color: #EDE497; }
         <li class="libPackets"><a href="../../Packets/doc/html/index.html">libPackets</a></li>
         <li class="libScheduler"><a href="../../Scheduler/doc/html/index.html">libScheduler</a></li>
         <li class="libUtils"><a href="../../Utils/doc/html/index.html">libUtils</a></li>
+        <li class="Examples"><a href="../../Examples/doc/html/index.html">Examples</a></li>
         <li class="SENFSCons"><a href="../../senfscons/doc/html/index.html">SENFSCons</a></li>
       </ul>
     </div>

doclib/doxy-header.html

@@ -24,6 +24,7 @@ div.tabs ul li.$projectname a { background-color: #EDE497; }
         <li class="libPackets"><a href="../../../Packets/doc/html/index.html">libPackets</a></li>
         <li class="libScheduler"><a href="../../../Scheduler/doc/html/index.html">libScheduler</a></li>
         <li class="libUtils"><a href="../../../Utils/doc/html/index.html">libUtils</a></li>
+        <li class="Examples"><a href="../../../Examples/doc/html/index.html">Examples</a></li>
         <li class="SENFSCons"><a href="../../../senfscons/doc/html/index.html">SENFSCons</a></li>
       </ul>
     </div>

senfscons/Doxyfile

@@ -6,3 +6,5 @@ FILE_PATTERNS = *.dox *.py
 EXCLUDE_PATTERNS += __init__.py
 OPTIMIZE_OUTPUT_JAVA = YES
 ALPHABETICAL_INDEX = NO
+
+GENERATE_TAGFILE  = doc/senfscons.tag
\ No newline at end of file

senfscons/Doxygen.py

@@ -344,7 +344,7 @@ def DoxyGenerator(source, target, env, for_signature):
 def generate(env):
    """
    Add builders and construction variables for the
-   Doxygen tool.  This is currently for Doxygen 1.4.6.
+   Doxygen tool. This is currently for Doxygen 1.4.6.
    """
    doxyfile_scanner = env.Scanner(
       DoxySourceScan,

senfscons/Mainpage.dox

@@ -151,9 +151,14 @@ namespace senfscons {
     To configure the build environment to the local environment, a \c SConfig file may be created in
     the projects root directory. The supported parameters are
 
-    <dl><dt>\c CXX</dt><dd>C++ compiler to use</dd>
-    <dt>\c EXTRA_DEFINES</dt><dd>preprocessor symbols to be defined locally</dd>
-    <dt>\c EXTRA_LIBS</dt><dd>additional libraries needed for a local build</dd></dl>
+    <dl>
+        <dt>\c CXX</dt>
+            <dd>C++ compiler to use</dd>
+        <dt>\c EXTRA_DEFINES</dt>
+            <dd>preprocessor symbols to be defined locally</dd>
+        <dt>\c EXTRA_LIBS</dt>
+            <dd>additional libraries needed for a local build</dd>
+    </dl>
 
     Additionally, the \ref use define additional configuration variables which may be set here.
  */