Commit 461afb27 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

media: dvb_net: stop abusing /** for comments

The comments that start with "/**" aren't kernel-doc stuff.
So, just start them with "/*".
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent c4365922
...@@ -125,7 +125,7 @@ struct dvb_net_priv { ...@@ -125,7 +125,7 @@ struct dvb_net_priv {
}; };
/** /*
* Determine the packet's protocol ID. The rule here is that we * Determine the packet's protocol ID. The rule here is that we
* assume 802.3 if the type field is short enough to be a length. * assume 802.3 if the type field is short enough to be a length.
* This is normal practice and works for any 'now in use' protocol. * This is normal practice and works for any 'now in use' protocol.
...@@ -155,7 +155,7 @@ static __be16 dvb_net_eth_type_trans(struct sk_buff *skb, ...@@ -155,7 +155,7 @@ static __be16 dvb_net_eth_type_trans(struct sk_buff *skb,
rawp = skb->data; rawp = skb->data;
/** /*
* This is a magic hack to spot IPX packets. Older Novell breaks * This is a magic hack to spot IPX packets. Older Novell breaks
* the protocol design and runs IPX over 802.3 without an 802.2 LLC * the protocol design and runs IPX over 802.3 without an 802.2 LLC
* layer. We look for FFFF which isn't a used 802.2 SSAP/DSAP. This * layer. We look for FFFF which isn't a used 802.2 SSAP/DSAP. This
...@@ -164,7 +164,7 @@ static __be16 dvb_net_eth_type_trans(struct sk_buff *skb, ...@@ -164,7 +164,7 @@ static __be16 dvb_net_eth_type_trans(struct sk_buff *skb,
if (*(unsigned short *)rawp == 0xFFFF) if (*(unsigned short *)rawp == 0xFFFF)
return htons(ETH_P_802_3); return htons(ETH_P_802_3);
/** /*
* Real 802.2 LLC * Real 802.2 LLC
*/ */
return htons(ETH_P_802_2); return htons(ETH_P_802_2);
...@@ -215,7 +215,8 @@ static int ule_exthdr_padding(struct dvb_net_priv *p) ...@@ -215,7 +215,8 @@ static int ule_exthdr_padding(struct dvb_net_priv *p)
return 0; return 0;
} }
/** Handle ULE extension headers. /*
* Handle ULE extension headers.
* Function is called after a successful CRC32 verification of an ULE SNDU to complete its decoding. * Function is called after a successful CRC32 verification of an ULE SNDU to complete its decoding.
* Returns: >= 0: nr. of bytes consumed by next extension header * Returns: >= 0: nr. of bytes consumed by next extension header
* -1: Mandatory extension header that is not recognized or TEST SNDU; discard. * -1: Mandatory extension header that is not recognized or TEST SNDU; discard.
...@@ -291,7 +292,7 @@ static int handle_ule_extensions( struct dvb_net_priv *p ) ...@@ -291,7 +292,7 @@ static int handle_ule_extensions( struct dvb_net_priv *p )
} }
/** Prepare for a new ULE SNDU: reset the decoder state. */ /* Prepare for a new ULE SNDU: reset the decoder state. */
static inline void reset_ule( struct dvb_net_priv *p ) static inline void reset_ule( struct dvb_net_priv *p )
{ {
p->ule_skb = NULL; p->ule_skb = NULL;
...@@ -304,7 +305,7 @@ static inline void reset_ule( struct dvb_net_priv *p ) ...@@ -304,7 +305,7 @@ static inline void reset_ule( struct dvb_net_priv *p )
p->ule_bridged = 0; p->ule_bridged = 0;
} }
/** /*
* Decode ULE SNDUs according to draft-ietf-ipdvb-ule-03.txt from a sequence of * Decode ULE SNDUs according to draft-ietf-ipdvb-ule-03.txt from a sequence of
* TS cells of a single PID. * TS cells of a single PID.
*/ */
...@@ -1005,7 +1006,7 @@ static int dvb_net_sec_callback(const u8 *buffer1, size_t buffer1_len, ...@@ -1005,7 +1006,7 @@ static int dvb_net_sec_callback(const u8 *buffer1, size_t buffer1_len,
{ {
struct net_device *dev = filter->priv; struct net_device *dev = filter->priv;
/** /*
* we rely on the DVB API definition where exactly one complete * we rely on the DVB API definition where exactly one complete
* section is delivered in buffer1 * section is delivered in buffer1
*/ */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment