Fix #1. update documentation about this exception

chfw · chfw · commit 7020982ef438 · 2015-03-19T23:57:44.000Z
diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -56,7 +56,7 @@ A minimal application may look like this::
     @app.route("/upload", methods=['GET', 'POST'])
     def upload_file():
         if request.method == 'POST':
-            return jsonify({"result": request.get_array('file')})
+            return jsonify({"result": request.get_array(field_name='file')})
         return '''
         <!doctype html>
         <title>Upload an excel file</title>
@@ -80,6 +80,9 @@ The tiny application exposes two urls: one for file upload and the other for fil
 
     <input ... name=file>
 
+.. warning::
+   If 'field_name' was not specified, for example `request.get_array('file')` in upload_file() function, your browser would display "Bad Request: The browser (or proxy) sent a request that this server could not understand."
+
 The latter simply throws back a csv file whenever a http request is made to http://localhost:50000/download/. `excel.make_response_from_array` takes a list of lists and a file type as parameters and sets up the mime type of the http response. If you would like to give 'tsvz' a go, please change "csv" to "tsvz".
 
 More excel file formats
diff --git a/examples/README.rst b/examples/README.rst
@@ -1,11 +1,13 @@
 For tiny_example.py, please upload only file that ends with 'csv', 'tsv', 'csvz', 'tsvz'. And if you upload any other formats, your browser will get::
 
-    Bad Request
+    Internal Server Error
 
-    The browser (or proxy) sent a request that this server could not understand.
+    The server encountered an internal error and was unable to complete your request. Either the server is overloaded or there is an error in the application.
 
 So in these cases, please insert in the tiny_example.py the following imports according to your file:
 
 import pyexcel.ext.xls # for xls file
 import pyexcel.ext.xlsx # for xlsx file
 import pyexcel.ext.ods # for ods file
+
+If 'field_name' is omitted in any of the function
