address comments

Author: huaxingao

docs/sql-ref-ansi-compliance.md

@@ -69,7 +69,7 @@ When `spark.sql.ansi.enabled` is set to `true` and an overflow occurs in numeric
 ```sql
 -- `spark.sql.ansi.enabled=true`
 SELECT 2147483647 + 1;
-  java.lang.ArithmeticException: integer overflow
+java.lang.ArithmeticException: integer overflow
 
 -- `spark.sql.ansi.enabled=false`
 SELECT 2147483647 + 1;
@@ -94,10 +94,10 @@ In future releases, the behaviour of type coercion might change along with the o
 
 -- `spark.sql.ansi.enabled=true`
 SELECT CAST('a' AS INT);
-  java.lang.NumberFormatException: invalid input syntax for type numeric: a
+java.lang.NumberFormatException: invalid input syntax for type numeric: a
 
 SELECT CAST(2147483648L AS INT);
-  java.lang.ArithmeticException: Casting 2147483648 to int causes overflow
+java.lang.ArithmeticException: Casting 2147483648 to int causes overflow
 
 -- `spark.sql.ansi.enabled=false` (This is a default behaviour)
 SELECT CAST('a' AS INT);
@@ -119,8 +119,8 @@ CREATE TABLE t (v INT);
 
 -- `spark.sql.storeAssignmentPolicy=ANSI`
 INSERT INTO t VALUES ('1');
-  org.apache.spark.sql.AnalysisException: Cannot write incompatible data to table '`default`.`t`':
-  - Cannot safely cast 'v': StringType to IntegerType;
+org.apache.spark.sql.AnalysisException: Cannot write incompatible data to table '`default`.`t`':
+- Cannot safely cast 'v': StringType to IntegerType;
 
 -- `spark.sql.storeAssignmentPolicy=LEGACY` (This is a legacy behaviour until Spark 2.x)
 INSERT INTO t VALUES ('1');

docs/sql-ref-identifier.md

@@ -57,16 +57,16 @@ Note: If `spark.sql.ansi.enabled` is set to true, ANSI SQL reserved keywords can
 ```sql
 -- This CREATE TABLE fails with ParseException because of the illegal identifier name a.b
 CREATE TABLE test (a.b int);
-  org.apache.spark.sql.catalyst.parser.ParseException:
-  no viable alternative at input 'CREATE TABLE test (a.'(line 1, pos 20)
+org.apache.spark.sql.catalyst.parser.ParseException:
+no viable alternative at input 'CREATE TABLE test (a.'(line 1, pos 20)
 
 -- This CREATE TABLE works
 CREATE TABLE test (`a.b` int);
 
 -- This CREATE TABLE fails with ParseException because special character ` is not escaped
 CREATE TABLE test1 (`a`b` int);
-  org.apache.spark.sql.catalyst.parser.ParseException:
-  no viable alternative at input 'CREATE TABLE test (`a`b`'(line 1, pos 23)
+org.apache.spark.sql.catalyst.parser.ParseException:
+no viable alternative at input 'CREATE TABLE test (`a`b`'(line 1, pos 23)
 
 -- This CREATE TABLE works
 CREATE TABLE test (`a``b` int);

docs/sql-ref-literals.md

@@ -36,12 +36,12 @@ A string literal is used to specify a character string value.
 #### Syntax
 
 ```sql
-'c [ ... ]' | "c [ ... ]"
+'char [ ... ]' | "char [ ... ]"
 ```
 
 #### Parameters
 
-* **c**
+* **char**
 
     One character from the character set. Use `\` to escape special characters (e.g., `'` or `\`).
 
@@ -77,14 +77,14 @@ A binary literal is used to specify a byte sequence value.
 #### Syntax
 
 ```sql
-X { 'c [ ... ]' | "c [ ... ]" }
+X { 'num [ ... ]' | "num [ ... ]" }
 ```
 
 #### Parameters
 
-* **c**
+* **num**
 
-    One character from the character set.
+    Any hexadecimal number from 0 to F.
 
 #### Examples
 

docs/sql-ref-syntax-aux-show-table.md

@@ -170,8 +170,8 @@ SHOW TABLE EXTENDED  IN default LIKE `employee` PARTITION (`grade=1`);
 
 -- show partition file system details with regex fails as shown below
 SHOW TABLE EXTENDED  IN default LIKE `empl*` PARTITION (`grade=1`);
-  Error: Error running query: org.apache.spark.sql.catalyst.analysis.NoSuchTableException:
-   Table or view 'emplo*' not found in database 'default'; (state=,code=0)
+Error: Error running query: org.apache.spark.sql.catalyst.analysis.NoSuchTableException:
+ Table or view 'emplo*' not found in database 'default'; (state=,code=0)
 ```
 
 ### Related Statements

docs/sql-ref-syntax-ddl-drop-function.md

@@ -79,9 +79,9 @@ DROP FUNCTION test_avg;
 
 -- Try to drop Permanent function which is not present
 DROP FUNCTION test_avg;
-  Error: Error running query:
-  org.apache.spark.sql.catalyst.analysis.NoSuchPermanentFunctionException:
-  Function 'default.test_avg' not found in database 'default'; (state=,code=0)
+Error: Error running query:
+org.apache.spark.sql.catalyst.analysis.NoSuchPermanentFunctionException:
+Function 'default.test_avg' not found in database 'default'; (state=,code=0)
 
 -- List the functions after dropping, it should list only temporary function
 SHOW USER FUNCTIONS;

docs/sql-ref-syntax-ddl-drop-table.md

@@ -56,8 +56,8 @@ DROP TABLE userdb.employeetable;
 -- Assumes a table named `employeetable` does not exists.
 -- Throws exception
 DROP TABLE employeetable;
-  Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeetable;
-  (state=,code=0)
+Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeetable;
+(state=,code=0)
 
 -- Assumes a table named `employeetable` does not exists,Try with IF EXISTS
 -- this time it will not throw exception

docs/sql-ref-syntax-ddl-drop-view.md

@@ -53,8 +53,8 @@ DROP VIEW userdb.employeeView;
 -- Assumes a view named `employeeView` does not exists.
 -- Throws exception
 DROP VIEW employeeView;
-  Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeeView;
-  (state=,code=0)
+Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeeView;
+(state=,code=0)
 
 -- Assumes a view named `employeeView` does not exists,Try with IF EXISTS
 -- this time it will not throw exception

docs/sql-ref-syntax-qry-select-limit.md

@@ -91,7 +91,7 @@ SELECT name, age FROM person ORDER BY name LIMIT length('SPARK');
 
 -- A non-foldable expression as an input to LIMIT is not allowed.
 SELECT name, age FROM person ORDER BY name LIMIT length(name);
-  org.apache.spark.sql.AnalysisException: The limit expression must evaluate to a constant value ...
+org.apache.spark.sql.AnalysisException: The limit expression must evaluate to a constant value ...
 ```
 
 ### Related Statements

docs/sql-ref-syntax-qry-select-usedb.md

@@ -46,7 +46,8 @@ USE userdb;
 
 -- Use the 'userdb1' which doesn't exist
 USE userdb1;
-  Error: org.apache.spark.sql.catalyst.analysis.NoSuchDatabaseException: Database 'userdb1' not found;(state=,code=0)
+Error: org.apache.spark.sql.catalyst.analysis.NoSuchDatabaseException: Database 'userdb1' not found;
+(state=,code=0)
 ```
 
 ### Related Statements