[docs] Clarify SetURLVars (#335)

* [docs] Clarify SetURLVars

Clarify in documentation that SetURLVars does not modify the given
*htttp.Request, provide an example of usage.

* Short and sweet function doc, example test.
This commit is contained in:
Franklin Harding
2018-01-19 22:28:49 -08:00
committed by Kamil Kisiel
parent 077b44c2cf
commit 0fdf828bb2
2 changed files with 11 additions and 1 deletions

View File

@@ -7,7 +7,8 @@ package mux
import "net/http"
// SetURLVars sets the URL variables for the given request, to be accessed via
// mux.Vars for testing route behaviour.
// mux.Vars for testing route behaviour. Arguments are not modified, a shallow
// copy is returned.
//
// This API should only be used for testing purposes; it provides a way to
// inject variables into the request context. Alternatively, URL variables