fmt: document existing behavior of nil receivers

If a method called by fmt triggers a panic, the output usually says
so. However, there is heretofore undocumented special treatment for
a panic caused by formatting a nil value with an Error or String
method: the output is simply "<nil>". Document that behavior.

Change-Id: Id0f79dd0b3487f9d1c74a0856727bba5cc342be4
Reviewed-on: https://go-review.googlesource.com/6410
Reviewed-by: David Crawshaw <crawshaw@golang.org>
This commit is contained in:
Rob Pike 2015-03-01 08:56:25 -08:00
parent bc674b3d16
commit 3ee9df799f

View File

@ -225,7 +225,9 @@
%!s(PANIC=bad)
The %!s just shows the print verb in use when the failure
occurred.
occurred. If the panic is caused by a nil receiver to an Error
or String method, however, the output is the undecorated
string, "<nil>".
Scanning