Github user kiszk commented on a diff in the pull request:
https://github.com/apache/spark/pull/10488#discussion_r48534614
--- Diff:
sql/catalyst/src/main/scala/org/apache/spark/sql/catalyst/expressions/misc.scala
---
@@ -57,9 +57,10 @@ case class Md5(child: Expression) extends
UnaryExpression with ImplicitCastInput
* the hash length is not one of the permitted values, the return value is
NULL.
*/
@ExpressionDescription(
- usage = "_FUNC_(input, bitLength) - Returns a checksum of SHA-2 family
as a hex string of the " +
- "input. SHA-224, SHA-256, SHA-384, and SHA-512 are supported. Bit
length of 0 is equivalent " +
- "to 256",
+ usage =
+ """_FUNC_(input, bitLength) - Returns a checksum of SHA-2 family as a
hex string of the input.
+ SHA-224, SHA-256, SHA-384, and SHA-512 are supported. Bit length of
0 is equivalent to 256."""
+ ,
--- End diff --
@yhuai, it sounds good to use multi-line string for ``usage`` and
``extended``. How about this policy?
1. First, we use raw string literal to remove concatenations.
2. If we still want to use a line with more than 100 characters, ``//
scalastyle:off`` and ``// scalastyle:on`` can be used.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
