SPDX declarations messing up docs on https://pkg.go.dev

ip/address.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 // Internet protocol version
 type Version uint8

ip/address4.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import (
 	"math/bits"

ip/address6.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import (
 	"math/bits"

ip/bigint.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import (
 	"errors"

ip/equality.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 // Tests equality
 func Eq(address0, address1 Address) (areEqual bool) {

ip/family.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 // Basic specification information.
 type Spec interface {

ip/family4.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import "errors"
 

ip/family6.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import "errors"
 

ip/masks.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import (
 	"fmt"

ip/navigation.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import "iter"
 

ip/package.go

@@ -1,6 +1,3 @@
-// Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
-// SPDX-License-Identifier: Apache-2.0
-
 /*
 IP addresses as generic, immutable positive integers.
 Use for arithmetic and bitwise operations.
@@ -15,3 +12,6 @@ Use [Family].FromBytes or [FromBytes] to obtain [Int] from byte slice.
 Use [Parse] or [ParseUnknown] to obtain [Int] from string.
 */
 package ip
+
+// Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
+// SPDX-License-Identifier: Apache-2.0

ip/parse.go

@@ -1,6 +1,7 @@
+package ip
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ip
 
 import (
 	"errors"

ipset/block.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"fmt"

ipset/blocks.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/discrete.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/empty.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/equality.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/interfaces.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/interval.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/intervals.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"github.com/ipfreely-uk/go/ip"

ipset/notation.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"errors"

ipset/order.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import "github.com/ipfreely-uk/go/ip"
 

ipset/package.go

@@ -1,6 +1,3 @@
-// Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
-// SPDX-License-Identifier: Apache-2.0
-
 /*
 Discrete sets and ranges of IP addresses.
 

ipset/seq.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"iter"

ipset/single.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"fmt"

ipset/subnets.go

@@ -1,6 +1,7 @@
+package ipset
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipset
 
 import (
 	"fmt"

ipstd/net.go

@@ -1,25 +1,30 @@
+package ipstd
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipstd
 
 import (
 	"net"
 
 	"github.com/ipfreely-uk/go/ip"
 )
 
+// Numeric type to `net` package
 func ToIP(a ip.Address) net.IP {
 	return a.Bytes()
 }
 
+// `net` package to numeric type
 func FromIP(a net.IP) ip.Address {
 	return ip.MustFromBytes(a...)
 }
 
+// Numeric type to `net` package
 func ToIPMask(a ip.Address) net.IPMask {
 	return a.Bytes()
 }
 
+// `net` package to numeric type
 func FromIPMask(a net.IPMask) ip.Address {
 	return ip.MustFromBytes(a...)
 }

ipstd/netip.go

@@ -1,18 +1,21 @@
+package ipstd
+
 // Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
 // SPDX-License-Identifier: Apache-2.0
-package ipstd
 
 import (
 	"net/netip"
 
 	"github.com/ipfreely-uk/go/ip"
 )
 
+// Numeric type to `netip` package
 func ToAddr(a ip.Address) netip.Addr {
 	r, _ := netip.AddrFromSlice(a.Bytes())
 	return r
 }
 
+// `netip` package to numeric type
 func FromAddr(a netip.Addr) ip.Address {
 	return ip.MustFromBytes(a.AsSlice()...)
 }

ipstd/package.go

@@ -1,7 +1,7 @@
-// Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
-// SPDX-License-Identifier: Apache-2.0
-
 /*
 Convenience functions to convert to & from standard library types.
 */
 package ipstd
+
+// Copyright 2024-2025 https://github.com/ipfreely-uk/go/blob/main/LICENSE
+// SPDX-License-Identifier: Apache-2.0