small documentation fixes
tho [Fri, 1 Feb 2008 14:17:48 +0000 (14:17 +0000)]
git-svn-id: https://svn.berlios.de/svnroot/repos/senf/trunk@658 270642c3-0616-0410-b53a-bc976706d245

Examples/RateStuffer/Mainpage.dox
PPI/Mainpage.dox
Packets/MPEGDVBBundle/TransportPacket.hh
Socket/Protocols/INet/MulticastProtocol.hh
Utils/Logger/Config.hh
Utils/Logger/Definitions.hh
Utils/Logger/FileTarget.hh
Utils/Logger/IOStreamTarget.hh
Utils/Logger/StringTarget.hh
Utils/Logger/Target.hh

index c17c9b4..9f02568 100644 (file)
@@ -63,7 +63,7 @@
     \image html ratestuffer.png
 
     Above image depicts the module setup implementing the rate stuffer. A
-    senf::ppi::module::ActiveSocketReader reads the incoming UDP packets and sends them into a
+    senf::ppi::module::ActiveSocketSource reads the incoming UDP packets and sends them into a
     senf::ppi::module::PassiveQueue (via a senf::ppi::module::ThrottleBarrier).
 
     The \a queue feeds the packets into a senf::ppi::module::PriorityJoin. The CloneSource
index 72b5f4b..2491f50 100644 (file)
       CopyPacketGenerator generator (stuffingPacket);
 
       senf::UDPv4ClientSocketHandle inputSocket (1111);
-      senf::ppi::module::ActiveSocketReader udpInput (inputSocket);
+      senf::ppi::module::ActiveSocketSource<> udpInput (inputSocket);
 
       senf::UDPv4ClientSocketHandle outputSocket ("2.3.4.5:2222");
-      senf::ppi::module::PassiveSocketWriter udpOutput (outputSocket);
+      senf::ppi::module::PassiveSocketSink<> udpOutput (outputSocket);
 
       senf::ppi::module::PassiveQueue adaptor;
 
index ead0347..6e9caa2 100644 (file)
@@ -45,15 +45,15 @@ namespace senf {
     {
 #       include SENF_FIXED_PARSER()
 
-        SENF_PARSER_FIELD    ( sync_byte                 , UInt8Parser   );
-        
-        SENF_PARSER_BITFIELD ( transport_error_indicator ,  1 , bool     );
-        SENF_PARSER_BITFIELD ( pusi                      ,  1 , bool     );
-        SENF_PARSER_BITFIELD ( transport_priority        ,  1 , bool     );
-        SENF_PARSER_BITFIELD ( pid                       , 13 , unsigned );
-        SENF_PARSER_BITFIELD ( transport_scrmbl_ctrl     ,  2 , unsigned );
-        SENF_PARSER_BITFIELD ( adaptation_field_ctrl     ,  2 , unsigned );
-        SENF_PARSER_BITFIELD ( continuity_counter        ,  4 , unsigned );
+        SENF_PARSER_FIELD    ( sync_byte,                  UInt8Parser  );
+
+        SENF_PARSER_BITFIELD ( transport_error_indicator,   1, bool     );
+        SENF_PARSER_BITFIELD ( pusi,                        1, bool     );
+        SENF_PARSER_BITFIELD ( transport_priority,          1, bool     );
+        SENF_PARSER_BITFIELD ( pid,                        13, unsigned );
+        SENF_PARSER_BITFIELD ( transport_scrmbl_ctrl,       2, unsigned );
+        SENF_PARSER_BITFIELD ( adaptation_field_ctrl,       2, unsigned );
+        SENF_PARSER_BITFIELD ( continuity_counter,          4, unsigned );
 
         SENF_PARSER_FINALIZE( TransportPacketParser );
     
index 1d3d0f6..3ce6347 100644 (file)
@@ -119,8 +119,7 @@ namespace senf {
                                              multicast groups received. The group is left from the
                                              interface with the given local address.
                                              \param[in] mcAddr address of group to leave
-                                             \param[in] localAddr address of interface to leave
-                                                 from */
+                                             \param[in] iface interface name */
     };
 
     class INet6MulticastProtocol
index 9387444..6c1ae63 100644 (file)
@@ -46,7 +46,7 @@
     <em>Runtime</em> configuration on the other hand deals with routing all those messages, which
     are enabled at compile time to the logging targets. If a message is not routed, it will be
     discarded. This allows to additionally disable messages at run-time. Message routing is managed
-    via the \ref Target interface.
+    via the \ref Targets interface.
 
     \section config_compile Compile time configuration
 
index 0c0fb33..24c32f7 100644 (file)
@@ -110,7 +110,7 @@ namespace log {
     /** \brief Default global log stream */
     SENF_LOG_DEF_STREAM(Debug, MESSAGE, MESSAGE, MESSAGE);
 
-    /** \brief Default global log area */
+    /** \brief Default global %log area */
     SENF_LOG_DEF_AREA(DefaultArea);
 
     ///\}
index 9bc9331..45f1bd0 100644 (file)
 namespace senf {
 namespace log {
 
-    /** \brief Log target writing to a log file.
+    /** \brief Log target writing to a %log file.
 
-        The FileTarget will save all log messages in the given file. Messages will be appended at
+        The FileTarget will save all %log messages in the given file. Messages will be appended at
         the end of the file.
 
-        After log files have been rotated, the reopen() member should be called to create a new log
+        After %log files have been rotated, the reopen() member should be called to create a new %log
         file.
 
         \ingroup targets
@@ -63,8 +63,8 @@ namespace log {
         ///@}
         ///////////////////////////////////////////////////////////////////////////
 
-        void reopen();                  ///< Reopen log after log-file rotation
-        void reopen(std::string file);  ///< Reopen log under a new name
+        void reopen();                  ///< Reopen %log after log-file rotation
+        void reopen(std::string file);  ///< Reopen %log under a new name
 
     private:
         std::string file_;
index d091a37..94e1258 100644 (file)
@@ -37,9 +37,9 @@
 namespace senf {
 namespace log {
 
-    /** \brief Write log messages to arbitrary std::ostream
+    /** \brief Write %log messages to arbitrary std::ostream
 
-        This target will write log messages to an arbitrary std::ostream in the format
+        This target will write %log messages to an arbitrary std::ostream in the format
         <pre>
         <date> [<area>] <message>
         </pre>
index cf81808..c9591de 100644 (file)
@@ -36,7 +36,7 @@
 namespace senf {
 namespace log {
   
-    /** \brief Store log messages in a string buffer
+    /** \brief Store %log messages in a string buffer
 
         This target is mostly useful for debug purposes. 
 
index 74110c9..d8ed8d1 100644 (file)
@@ -56,7 +56,7 @@ namespace log {
 
     /** \brief Logging target base class
         
-        Targets are the final destination of log messages. Every message is eventually routed to one
+        Targets are the final destination of %log messages. Every message is eventually routed to one
         or several targets.
 
         \section target_routing Routing
@@ -383,7 +383,7 @@ namespace log {
                                                  simple logging over NFS or many other network
                                                  protocols.
 
-                                             \param[in] timestamp log message timing information
+                                             \param[in] timestamp %log message timing information
                                              \param[in] stream message stream
                                              \param[in] area message area
                                              \param[in] level message level
@@ -415,7 +415,7 @@ namespace log {
         virtual boost::posix_time::ptime operator()() const = 0;
     };
 
-    /** \brief Default log message time source
+    /** \brief Default %log message time source
 
         This time source is installed by default and uses gettimeofday() (via the Boost.DateTime
         library) to get the current universal time.