[SPARK-36597][DOCS] Fix issues in SQL function docs

core/src/main/scala/org/apache/spark/errors/SparkCoreErrors.scala

@@ -30,7 +30,7 @@ import org.apache.spark.storage.{BlockId, BlockManagerId, BlockNotFoundException
 /**
  * Object for grouping error messages from (most) exceptions thrown during query execution.
  */
-private[spark] object SparkCoreErrors {
+object SparkCoreErrors {
   def rddBlockNotFoundError(blockId: BlockId, id: Int): Throwable = {
     new Exception(s"Could not compute split, block $blockId of RDD $id not found")
   }

project/SparkBuild.scala

@@ -967,6 +967,7 @@ object Unidoc {
       .map(_.filterNot(_.getCanonicalPath.contains("org/apache/spark/sql/internal")))
       .map(_.filterNot(_.getCanonicalPath.contains("org/apache/spark/sql/hive")))
       .map(_.filterNot(_.getCanonicalPath.contains("org/apache/spark/sql/catalog/v2/utils")))
+      .map(_.filterNot(_.getCanonicalPath.contains("org.apache.spark.errors")))
       .map(_.filterNot(_.getCanonicalPath.contains("org.apache.spark.sql.errors")))
       .map(_.filterNot(_.getCanonicalPath.contains("org/apache/hive")))
       .map(_.filterNot(_.getCanonicalPath.contains("org/apache/spark/sql/v2/avro")))

sql/catalyst/src/main/scala/org/apache/spark/sql/catalyst/expressions/bitwiseExpressions.scala

@@ -233,10 +233,10 @@ object BitwiseGetUtil {
 
 @ExpressionDescription(
   usage = """
-            |_FUNC_(expr, pos) - Returns the value of the bit (0 or 1) at the specified position.
-            |  The positions are numbered from right to left, starting at zero.
-            |  The position argument cannot be negative.
-          """,
+    _FUNC_(expr, pos) - Returns the value of the bit (0 or 1) at the specified position.
+      The positions are numbered from right to left, starting at zero.
+      The position argument cannot be negative.
+  """,
   examples = """
     Examples:
       > SELECT _FUNC_(11, 0);

sql/catalyst/src/main/scala/org/apache/spark/sql/catalyst/expressions/intervalExpressions.scala

@@ -227,7 +227,7 @@ case class DivideInterval(
 
 // scalastyle:off line.size.limit
 @ExpressionDescription(
-  usage = "_FUNC_(years, months, weeks, days, hours, mins, secs) - Make interval from years, months, weeks, days, hours, mins and secs.",
+  usage = "_FUNC_([years[, months[, weeks[, days[, hours[, mins[, secs]]]]]]]) - Make interval from years, months, weeks, days, hours, mins and secs.",
   arguments = """
     Arguments:
       * years - the number of years, positive or negative
@@ -360,7 +360,7 @@ case class MakeInterval(
 
 // scalastyle:off line.size.limit
 @ExpressionDescription(
-  usage = "_FUNC_(days, hours, mins, secs) - Make DayTimeIntervalType duration from days, hours, mins and secs.",
+  usage = "_FUNC_([days[, hours[, mins[, secs]]]]) - Make DayTimeIntervalType duration from days, hours, mins and secs.",
   arguments = """
     Arguments:
       * days - the number of days, positive or negative
@@ -372,6 +372,8 @@ case class MakeInterval(
     Examples:
       > SELECT _FUNC_(1, 12, 30, 01.001001);
        1 12:30:01.001001000
+      > SELECT _FUNC_(2);
+       2 00:00:00.000000000
       > SELECT _FUNC_(100, null, 3);
        NULL
   """,
@@ -436,7 +438,7 @@ case class MakeDTInterval(
 }
 
 @ExpressionDescription(
-  usage = "_FUNC_(years, months) - Make year-month interval from years, months.",
+  usage = "_FUNC_([years[, months]]) - Make year-month interval from years, months.",
   arguments = """
     Arguments:
       * years - the number of years, positive or negative
@@ -450,6 +452,8 @@ case class MakeDTInterval(
        1-0
       > SELECT _FUNC_(-1, 1);
        -0-11
+      > SELECT _FUNC_(2);
+       2-0
   """,
   since = "3.2.0",
   group = "datetime_funcs")