diff --git a/CHANGES b/CHANGES index 1cd654e320..61e37731e9 100644 --- a/CHANGES +++ b/CHANGES @@ -1,3 +1,5 @@ +3503. [doc] Clarify size_spec syntax. [RT #32449] + 3502. [func] zone-statistics: "no" is now a synonym for "none", instead of "terse". [RT #29165] diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index e90305a9cd..7a8e3da7a7 100644 --- a/doc/arm/Bv9ARM-book.xml +++ b/doc/arm/Bv9ARM-book.xml @@ -3406,31 +3406,45 @@ $ORIGIN 0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa. - A number, the word unlimited, - or the word default. - - - An unlimited size_spec requests unlimited - use, or the maximum available amount. A default size_spec uses - the limit that was in force when the server was started. + A 64-bit unsigned integer, or the keywords + unlimited or + default. - A number can optionally be - followed by a scaling factor: + Integers may take values + 0 <= value <= 18446744073709551615, though + certain parameters may use a more limited range + within these extremes. In most cases, setting a + value to 0 does not literally mean zero; it means + "undefined" or "as big as psosible", depending on + the context. See the expalantions of particular + parameters that use size_spec + for details on how they interpret its use. + + + Numeric values can optionally be followed by a + scaling factor: K or k for kilobytes, M or m for megabytes, and - G or g for gigabytes, - which scale by 1024, 1024*1024, and 1024*1024*1024 - respectively. + G or g + for gigabytes, which scale by 1024, 1024*1024, and + 1024*1024*1024 respectively. - - The value must be representable as a 64-bit unsigned integer - (0 to 18446744073709551615, inclusive). - Using unlimited is the best - way - to safely set a really large number. + + unlimited generally means + "as big as possible", though in certain contexts, + (including ), it may + mean the largest possible 32-bit unsigned integer + (0xffffffff); this distinction can be important when + dealing with larger quantities. + unlimited is usually the best way + to safely set a very large number. + + + default + uses the limit that was in force when the server was started.