X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=senf%2FPackets%2FPacket.hh;h=15b356b6958c2aa611dc32340ec78e035ad4b701;hb=57daeae6f2e924ce3f16f9677c3474f531cba9e5;hp=cc9c9f29b81fbfc47d5144ba6ac76dffcc0dfb9e;hpb=a518319a80169b48c8dccfeb82ed2834d3eebd75;p=senf.git diff --git a/senf/Packets/Packet.hh b/senf/Packets/Packet.hh index cc9c9f2..15b356b 100644 --- a/senf/Packets/Packet.hh +++ b/senf/Packets/Packet.hh @@ -35,7 +35,7 @@ #include "PacketInterpreter.hh" //#include "Packet.mpp" -///////////////////////////////hh.p//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// namespace senf { @@ -96,7 +96,7 @@ namespace senf { template class ConcretePacket; ///\addtogroup packet_module - ///@{ + //\{ /** \brief Main %Packet class @@ -142,7 +142,7 @@ namespace senf { public boost::equality_comparable { public: - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// // Types typedef void type; ///< Type of the packet. @@ -150,9 +150,9 @@ namespace senf { ///< Unsigned type to represent packet size typedef PacketInterpreterBase::factory_t factory_t; ///< Packet factory type (see below) - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// ///\name Structors and default members - ///@{ + //\{ // default copy constructor // default copy assignment @@ -164,9 +164,9 @@ namespace senf { validity. */ Packet clone() const; ///< Create copy packet /**< clone() will create a complete copy of \c this - packet. The returned packet will have the same data and - packet chain. It does however not share any data with - the original packet. */ + packet. The returned packet will have the same data, + annotations and packet chain. It does however not + share any data with the original packet. */ // conversion constructors @@ -177,11 +177,11 @@ namespace senf { ConcretePacket into a general Packet, loosing the protocol specific interface. */ - ///@} - /////////////////////////////////////////////////////////////////////////// + //\} + //-//////////////////////////////////////////////////////////////////////// ///\name Interpreter chain access - ///@{ + //\{ Packet next() const; ///< Get next packet in chain /**< \throws InvalidPacketChainException if no next packet @@ -313,20 +313,20 @@ namespace senf { /**< This member will throw away the packet chain after the current packet. The payload will be reparsed automatically when calling next() */ - ///@} + //\} ///\name Data access - ///@{ + //\{ PacketData & data() const; ///< Access the packets raw data container size_type size() const; ///< Return size of packet in bytes /**< This size does \e not include the size of any preceding headers/packets/interpreters. It does however include \c this packets payload. */ - ///@} + //\} ///\name Annotations - ///@{ + //\{ template Annotation & annotation(); ///< Get packet annotation @@ -394,10 +394,10 @@ namespace senf { the annotations equates to a new created %packet. \warning all references to existing complex annotations become invalid. */ - ///@} + //\} ///\name Other methods - ///@{ + //\{ bool operator==(Packet const & other) const; ///< Check for packet identity /**< Two packet handles compare equal if they really are the @@ -459,7 +459,7 @@ namespace senf { backwards towards outer packets up to \c this. */ void finalizeAll(); ///< Update calculated fields - /**< The finalize() fammily of members will update + /**< The finalize() family of members will update calculated packet fields: checksums, size fields and so on. This includes any field, which can be set from other information in the packet. Each concrete packet @@ -506,7 +506,7 @@ namespace senf { /**< This method returns true if there is any other packet handle pointing to any header in the packet chain. */ - ///@} + //\} protected: explicit Packet(PacketInterpreterBase::ptr const & packet); @@ -566,15 +566,15 @@ namespace senf { : public Packet { public: - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// // Types typedef PacketType type; typedef typename PacketType::parser Parser; - /////////////////////////////////////////////////////////////////////////// + //-//////////////////////////////////////////////////////////////////////// ///\name Structors and default members - ///@{ + //\{ // default copy constructor // default copy assignment @@ -727,7 +727,7 @@ namespace senf { packet */ static ConcretePacket createInsertBefore(Packet const & packet, senf::NoInit_t); ///< Insert uninitialized empty packet before \a packet - /**< Inserts a completely empty and unitialized packet + /**< Inserts a completely empty and uninitialized packet before \a packet into the header/interpreter chain. \param[in] packet Packet before which to insert the new packet */ @@ -736,8 +736,8 @@ namespace senf { ConcretePacket clone() const; - ///@} - /////////////////////////////////////////////////////////////////////////// + //\} + //-//////////////////////////////////////////////////////////////////////// // Field access @@ -789,11 +789,11 @@ namespace senf { template Parser operator<<(Parser target, ConcretePacket const & packet); - ///@} + //\} } -///////////////////////////////hh.e//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// #endif #if !defined(HH_SENF_Packets_Packets__decls_) && !defined(HH_SENF_Packets_Packet_i_) #define HH_SENF_Packets_Packet_i_