More doc

common/net/packet.go

@@ -4,12 +4,14 @@ import (
 	"github.com/v2ray/v2ray-core/common/alloc"
 )
 
+// Packet is a network packet to be sent to destination.
 type Packet interface {
 	Destination() Destination
 	Chunk() *alloc.Buffer // First chunk of this commnunication
 	MoreChunks() bool
 }
 
+// NewPacket creates a new Packet with given destination and payload.
 func NewPacket(dest Destination, firstChunk *alloc.Buffer, moreChunks bool) Packet {
 	return &packetImpl{
 		dest:     dest,

common/net/transport.go

@@ -6,6 +6,8 @@ import (
 	"github.com/v2ray/v2ray-core/common/alloc"
 )
 
+// ReadFrom reads from a reader and put all content to a buffer.
+// If buffer is nil, ReadFrom creates a new normal buffer.
 func ReadFrom(reader io.Reader, buffer *alloc.Buffer) (*alloc.Buffer, error) {
 	if buffer == nil {
 		buffer = alloc.NewBuffer()