From 9c9f3646ff7ec4f6aa25603169ec61da2d0cda69 Mon Sep 17 00:00:00 2001
From: Miek Gieben <miek@miek.nl>
Date: Sun, 21 Sep 2014 09:07:26 +0100
Subject: [PATCH] More naming and some docs

---
 example_test.go   |  2 +-
 privaterr.go      | 14 ++++++++++++--
 privaterr_test.go |  4 ++--
 3 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/example_test.go b/example_test.go
index 0dd37973..cefe3d71 100644
--- a/example_test.go
+++ b/example_test.go
@@ -102,7 +102,7 @@ func (rd *APAIR) Unpack(buf []byte) (int, error) {
 	return len(buf), nil
 }
 
-func (rd *APAIR) PasteRdata(dest dns.PrivateRdata) error {
+func (rd *APAIR) CopyRdata(dest dns.PrivateRdata) error {
 	cp := make([]byte, rd.RdataLen())
 	_, err := rd.Pack(cp)
 	if err != nil {
diff --git a/privaterr.go b/privaterr.go
index 2618d7b8..dae20f59 100644
--- a/privaterr.go
+++ b/privaterr.go
@@ -1,3 +1,11 @@
+/*
+PRIVATE RR
+
+RFC 6895 sets aside a range of type codes for private use. This range
+is 65,280 - 65,534 (0xFF00 - 0xFFFE). When experimenting with new Resource Records these
+can be used, before requesting an official type code from IANA.
+
+*/
 package dns
 
 import (
@@ -11,13 +19,15 @@ import (
 type PrivateRdata interface {
 	// String returns the text presentaton of the Rdata of the Private RR.
 	String() string
+	// ParseTextSlice parses the Rdata of the private RR.
 	ParseTextSlice([]string) error
 	// Pack is used when packing a private RR into a buffer.
 	Pack([]byte) (int, error)
 	// Unpack is used when unpacking a private RR from a buffer.
 	// TODO(miek): diff. signature than Pack, see edns0.go for instance.
 	Unpack([]byte) (int, error)
-	PasteRdata(PrivateRdata) error
+	// CopyRdata copies the Rdata.
+	CopyRdata(PrivateRdata) error
 	// RdataLen returns the length in octets of the Rdata.
 	RdataLen() int
 }
@@ -55,7 +65,7 @@ func (r *PrivateRR) copy() RR {
 	newh := r.Hdr.copyHeader()
 	rr.Hdr = *newh
 
-	err := r.Data.PasteRdata(rr.Data)
+	err := r.Data.CopyRdata(rr.Data)
 	if err != nil {
 		panic("dns: got value that could not be used to copy Private rdata")
 	}
diff --git a/privaterr_test.go b/privaterr_test.go
index d19dcb70..033bf800 100644
--- a/privaterr_test.go
+++ b/privaterr_test.go
@@ -37,7 +37,7 @@ func (rd *ISBN) Unpack(buf []byte) (int, error) {
 	return len(buf), nil
 }
 
-func (rd *ISBN) PasteRdata(dest dns.PrivateRdata) error {
+func (rd *ISBN) CopyRdata(dest dns.PrivateRdata) error {
 	isbn, ok := dest.(*ISBN)
 	if !ok {
 		return dns.ErrRdata
@@ -127,7 +127,7 @@ func (rd *VERSION) Unpack(buf []byte) (int, error) {
 	return len(buf), nil
 }
 
-func (rd *VERSION) PasteRdata(dest dns.PrivateRdata) error {
+func (rd *VERSION) CopyRdata(dest dns.PrivateRdata) error {
 	isbn, ok := dest.(*VERSION)
 	if !ok {
 		return dns.ErrRdata