From 61fae4997db3dc0011e9015f4f69f57c81e9ce4a Mon Sep 17 00:00:00 2001
From: "Manu Mtz.-Almeida" <manu.valladolid@gmail.com>
Date: Tue, 26 Jan 2016 22:40:29 +0100
Subject: [PATCH] Improves documentation

---
 context.go  | 23 ++++++++++++++---------
 errors.go   | 12 +++++-------
 mode.go     |  6 ++----
 recovery.go |  2 +-
 4 files changed, 22 insertions(+), 21 deletions(-)

diff --git a/context.go b/context.go
index 532152ee..5b457588 100644
--- a/context.go
+++ b/context.go
@@ -185,7 +185,8 @@ func (c *Context) MustGet(key string) interface{} {
 
 // Query is a shortcut for c.Request.URL.Query().Get(key)
 // It is used to return the url query values.
-// ?id=1234&name=Manu
+// It returns an empty string ("") when the value does not exist.
+// /path?id=1234&name=Manu
 // c.Query("id") == "1234"
 // c.Query("name") == "Manu"
 // c.Query("wtf") == ""
@@ -195,12 +196,18 @@ func (c *Context) Query(key string) string {
 }
 
 // PostForm is a shortcut for c.Request.PostFormValue(key)
+// It returns an empty string ("") when the value does not exist.
 func (c *Context) PostForm(key string) string {
 	value, _ := c.postForm(key)
 	return value
 }
 
-// Param is a shortcut for c.Params.ByName(key)
+// Param returns the value of the URL param.
+// It is a shortcut for c.Params.ByName(key)
+//		router.GET("/user/:id", func(c *gin.Context) {
+//			// a GET request to /user/john
+//			id := c.Param("id") // id == "john"
+//		})
 func (c *Context) Param(key string) string {
 	return c.Params.ByName(key)
 }
@@ -214,11 +221,9 @@ func (c *Context) DefaultPostForm(key, defaultValue string) string {
 
 // DefaultQuery returns the keyed url query value if it exists, othewise it returns the
 // specified defaultValue.
-// ```
-// /?name=Manu
-// c.DefaultQuery("name", "unknown") == "Manu"
-// c.DefaultQuery("id", "none") == "none"
-// ```
+// 		//?name=Manu
+// 		c.DefaultQuery("name", "unknown") == "Manu"
+// 		c.DefaultQuery("id", "none") == "none"
 func (c *Context) DefaultQuery(key, defaultValue string) string {
 	if value, ok := c.query(key); ok {
 		return value
@@ -250,8 +255,8 @@ func (c *Context) postForm(key string) (string, bool) {
 
 // Bind checks the Content-Type to select a binding engine automatically,
 // Depending the "Content-Type" header different bindings are used:
-// "application/json" --> JSON binding
-// "application/xml"  --> XML binding
+// 		"application/json" --> JSON binding
+// 		"application/xml"  --> XML binding
 // otherwise --> returns an error
 // If Parses the request's body as JSON if Content-Type == "application/json" using JSON or XML  as a JSON input.
 // It decodes the json payload into the struct specified as a pointer.
diff --git a/errors.go b/errors.go
index e829c886..bced19aa 100644
--- a/errors.go
+++ b/errors.go
@@ -109,13 +109,11 @@ func (a errorMsgs) Last() *Error {
 }
 
 // Returns an array will all the error messages.
-// Example
-// ```
-// c.Error(errors.New("first"))
-// c.Error(errors.New("second"))
-// c.Error(errors.New("third"))
-// c.Errors.Errors() // == []string{"first", "second", "third"}
-// ``
+// Example:
+// 		c.Error(errors.New("first"))
+// 		c.Error(errors.New("second"))
+// 		c.Error(errors.New("third"))
+// 		c.Errors.Errors() // == []string{"first", "second", "third"}
 func (a errorMsgs) Errors() []string {
 	if len(a) == 0 {
 		return nil
diff --git a/mode.go b/mode.go
index 4e2ba46e..bf9e995b 100644
--- a/mode.go
+++ b/mode.go
@@ -29,10 +29,8 @@ const (
 // Note that both Logger and Recovery provides custom ways to configure their
 // output io.Writer.
 // To support coloring in Windows use:
-// ```
-// import "github.com/mattn/go-colorable"
-// gin.DefaultWriter = colorable.NewColorableStdout()
-// ```
+// 		import "github.com/mattn/go-colorable"
+// 		gin.DefaultWriter = colorable.NewColorableStdout()
 var DefaultWriter io.Writer = os.Stdout
 var DefaultErrorWriter io.Writer = os.Stderr
 
diff --git a/recovery.go b/recovery.go
index 67c504c5..c502f355 100644
--- a/recovery.go
+++ b/recovery.go
@@ -23,7 +23,7 @@ var (
 
 // Recovery returns a middleware that recovers from any panics and writes a 500 if there was one.
 func Recovery() HandlerFunc {
-	return RecoveryWithWriter(DefaultWriter)
+	return RecoveryWithWriter(DefaultErrorWriter)
 }
 
 func RecoveryWithWriter(out io.Writer) HandlerFunc {