code review 7000052: fmt: document width and flags a bit more

fmt: document width and flags a bit more

Fixes issue 4581.

[rsc, 2012-12-22 15:37:28]

Hello golang-dev@googlegroups.com,

I'd like you to review this change to
https://code.google.com/p/go/

[bradfitz, 2012-12-22 16:51:23]

LGTM

On Sat, Dec 22, 2012 at 7:37 AM, <rsc@golang.org> wrote:

> Reviewers: golang-dev_googlegroups.com,
>
> Message:
> Hello golang-dev@googlegroups.com,
>
> I'd like you to review this change to
> https://code.google.com/p/go/
>
>
> Description:
> fmt: document width and flags a bit more
>
> Fixes issue 4581.
>
> Please review this at
https://codereview.appspot.**com/7000052/<https://codereview.appspot.com/7000...
>
> Affected files:
>   M src/pkg/fmt/doc.go
>
>
> Index: src/pkg/fmt/doc.go
> ==============================**==============================**=======
> --- a/src/pkg/fmt/doc.go
> +++ b/src/pkg/fmt/doc.go
> @@ -63,9 +63,10 @@
>         The default precision for %e and %f is 6; for %g it is the smallest
>         number of digits necessary to identify the value uniquely.
>
> -       For strings, width is the minimum number of characters to output,
> -       padding with spaces if necessary, and precision is the maximum
> -       number of characters to output, truncating if necessary.
> +       For most values, width is the minimum number of characters to
> output,
> +       padding the formatted form with spaces if necessary.
> +       For strings, precision is the maximum number of characters to
> output,
> +       truncating if necessary.
>
>         Other flags:
>                 +       always print a sign for numeric values;
> @@ -77,7 +78,12 @@
>                         write e.g. U+0078 'x' if the character is
> printable for %U (%#U).
>                 ' '     (space) leave a space for elided sign in numbers
> (% d);
>                         put spaces between bytes printing strings or
> slices in hex (% x, % X)
> -               0       pad with leading zeros rather than spaces
> +               0       pad with leading zeros rather than spaces;
> +                       for numbers, this moves the padding after the sign
> +
> +       Flags are ignored by verbs that do not expect them.
> +       For example there is no alternate decimal format, so %#d and %d
> +       behave identically.
>
>         For each Printf-like function, there is also a Print function
>         that takes no format and is equivalent to saying %v for every
>
>
>

[rsc, 2012-12-22 18:36:45]

*** Submitted as https://code.google.com/p/go/source/detail?r=0e46a7190338 ***

fmt: document width and flags a bit more

Fixes issue 4581.

R=golang-dev, bradfitz
CC=golang-dev
https://codereview.appspot.com/7000052