README.rdoc in ipaddress-0.7.0 vs README.rdoc in ipaddress-0.7.5

- old
+ new

@@ -79,11 +79,11 @@ documentation with Rake: ipaddress$ rake rdoc The latest documentation can be found online at -{this address}[http://rubydoc.info/github/bluemonk/ipaddress/master/frames] +{this address}[http://rubydoc.info/gems/ipaddress/0.7.0/frames] == IPv4 Class IPAddress::IPv4 is used to handle IPv4 type addresses. IPAddress is similar to other IP Addresses libraries, like Ruby's own @@ -106,11 +106,11 @@ ip = IPAddress.parse "172.16.10.1/24" which accepts and parses any kind of IP (IPv4, IPV6 and IPv4 IPv6 Mapped addresses). -If you like sintactic sugar, you can use the wrapper method +If you like syntactic sugar, you can use the wrapper method IPAddress(), which is built around IPAddress::parse: ip = IPAddress "172.16.10.1/24" You can specify an IPv4 address in any of two ways: @@ -244,11 +244,11 @@ the network number has all zeroes in the host portion, the broadcast address has all one's. For example, ip "172.16.10.1/24" has broadcast "172.16.10.255/24", where ip "172.16.10.1/16" has broadcast "172.16.255.255/16". -Method IPv4#broadcast has the same behaviour as is #network +Method IPv4#broadcast has the same behavior as is #network counterpart: it creates a new IPv4 object to handle the broadcast address: ip = IPAddress "172.16.10.1/24" @@ -275,11 +275,11 @@ It is important to note that it doesn't matter if the original IP is a host IP or a network number (or a broadcast address): the #each method only considers the range that the original IP specifies. -If you only want to iterate over hosts IP, use the Ipv4#each_host +If you only want to iterate over hosts IP, use the IPv4#each_host method: ip = IPAddress "172.16.10.1/24" ip.each_host do |host| @@ -325,11 +325,11 @@ ip.to_u32 #=> 2886732289 This method is the equivalent of the Unix call pton(), expressing an IP address in the so called +network byte order+ notation. However, if -you want to trasmit your IP over a network socket, you might need to +you want to transmit your IP over a network socket, you might need to transform it in data format using the IPv4#data method: ip.data #=> "\254\020\n\001" @@ -380,11 +380,11 @@ ip = IPAddress("192.168.1.1/30") ip.c? #=> true Remember that these methods are only checking the address portion of an IP, and are -indipendent from its prefix, as classful networks have no concept of prefix. +independent from its prefix, as classful networks have no concept of prefix. For more information on CLASSFUL networks visit the {Wikipedia page}[http://en.wikipedia.org/wiki/Classful_network] === Network design with IPAddress @@ -428,11 +428,11 @@ #=> ["172.16.10.0/26", "172.16.10.64/26", "172.16.10.128/26", "172.16.10.192/26"] Usually, subnetting implies dividing a network to a number of subnets which is a power of two: in this way, you can be sure that the network -will be divived evenly, and all the subnets will have the same number +will be divided evenly, and all the subnets will have the same number of hosts. ==== Uneven subnetting IPAddress also handles un-even subnetting: if you specify any number @@ -458,11 +458,11 @@ "172.16.10.48/28", "172.16.10.64/28", "172.16.10.80/28", "172.16.10.96/28", "172.16.10.112/28", "172.16.10.128/27", "172.16.10.160/27", "172.16.10.192/26"] As you can see, most of the networks are /28, with a few /27 and one -/26 to fill up the remaning space. +/26 to fill up the remaining space. ==== Summarization Summarization (or aggregation) is the process when two or more networks are taken together to check if a supernet, including @@ -567,11 +567,11 @@ === IPv6 addresses IPv6 addresses are 128 bits long, in contrast with IPv4 addresses which are only 32 bits long. An IPv6 address is generally written as eight groups of four hexadecimal digits, each group representing 16 -bits or two octect. For example, the following is a valid IPv6 +bits or two octet. For example, the following is a valid IPv6 address: 1080:0000:0000:0000:0008:0800:200c:417a Letters in an IPv6 address are usually written downcase, as per @@ -579,11 +579,11 @@ they will be converted. ==== Compression Since IPv6 addresses are very long to write, there are some -semplifications and compressions that you can use to shorten them. +simplifications and compressions that you can use to shorten them. * Leading zeroes: all the leading zeroes within a group can be omitted: "0008" would become "8" * A string of consecutive zeroes can be replaced by the string @@ -763,11 +763,11 @@ #=> "2001:db8::8:800:200c:417a/64" === Special IPv6 addresses Some IPv6 have a special meaning and are expressed in a special form, -quite different than an usual IPv6 address. IPAddress has builtin +quite different than an usual IPv6 address. IPAddress has built-in support for unspecified, loopback and mapped IPv6 addresses. ==== Unspecified address The address with all zero bits is called the +unspecified+ address @@ -919,16 +919,17 @@ IPAddress future development, features and provide some kind of support. Feel free to join us and tell us what you think! == Thanks to -Thanks to Luca Russo (vargolo) and Simone Carletti (weppos) for all -the support and technical review. Thanks to Marco Beri, Bryan T. Richardson, -Nicolas Fevrier, jdpace, Daniele Alessandri and Steve Rawlinson for -their support, feedback and bug reports. +Thanks to Luca Russo (vargolo) and Simone Carletti +(weppos) for all the support and technical review. Thanks to Marco Beri, +Bryan T. Richardson, Nicolas Fevrier, jdpace, Daniele Alessandri, jrdioko, +Ghislain Charrier, Pawel Krzesniak, Mark Sullivan, Erik Ahlström and +Steve Rawlinson for their support, feedback and bug reports. == Copyright -Copyright (c) 2009-2010 Marco Ceresa. See LICENSE for details. +Copyright (c) 2009-2011 Marco Ceresa. See LICENSE for details. \ No newline at end of file