Repository: spark
Updated Branches:
  refs/heads/branch-2.3 4de206182 -> be3de8791


[MINOR][DOC] Use raw triple double quotes around docstrings where there are 
occurrences of backslashes.

>From [PEP 257](https://www.python.org/dev/peps/pep-0257/):

> For consistency, always use """triple double quotes""" around docstrings. Use 
> r"""raw triple double quotes""" if you use any backslashes in your 
> docstrings. For Unicode docstrings, use u"""Unicode triple-quoted strings""".

For example, this is what help (kafka_wordcount) shows:

```
DESCRIPTION
    Counts words in UTF8 encoded, '
    ' delimited text received from the network every second.
     Usage: kafka_wordcount.py <zk> <topic>

     To run this on your local machine, you need to setup Kafka and create a 
producer first, see
     http://kafka.apache.org/documentation.html#quickstart

     and then run the example
        `$ bin/spark-submit --jars       
external/kafka-assembly/target/scala-*/spark-streaming-kafka-assembly-*.jar     
  examples/src/main/python/streaming/kafka_wordcount.py       localhost:2181 
test`
```

This is what it shows, after the fix:

```
DESCRIPTION
    Counts words in UTF8 encoded, '\n' delimited text received from the network 
every second.
    Usage: kafka_wordcount.py <zk> <topic>

    To run this on your local machine, you need to setup Kafka and create a 
producer first, see
    http://kafka.apache.org/documentation.html#quickstart

    and then run the example
       `$ bin/spark-submit --jars \
         
external/kafka-assembly/target/scala-*/spark-streaming-kafka-assembly-*.jar \
         examples/src/main/python/streaming/kafka_wordcount.py \
         localhost:2181 test`
```

The thing worth noticing is no linebreak here in the help.

## What changes were proposed in this pull request?

Change triple double quotes to raw triple double quotes when there are 
occurrences of backslashes in docstrings.

## How was this patch tested?

Manually as this is a doc fix.

Author: Shashwat Anand <m...@shashwat.me>

Closes #20497 from ashashwat/docstring-fixes.

(cherry picked from commit 4aaa7d40bf495317e740b6d6f9c2a55dfd03521b)
Signed-off-by: gatorsmile <gatorsm...@gmail.com>


Project: http://git-wip-us.apache.org/repos/asf/spark/repo
Commit: http://git-wip-us.apache.org/repos/asf/spark/commit/be3de879
Tree: http://git-wip-us.apache.org/repos/asf/spark/tree/be3de879
Diff: http://git-wip-us.apache.org/repos/asf/spark/diff/be3de879

Branch: refs/heads/branch-2.3
Commit: be3de87914f29a56137e391d0cf494c0d1a7ba12
Parents: 4de2061
Author: Shashwat Anand <m...@shashwat.me>
Authored: Sat Feb 3 10:31:04 2018 -0800
Committer: gatorsmile <gatorsm...@gmail.com>
Committed: Sat Feb 3 10:31:17 2018 -0800

----------------------------------------------------------------------
 .../src/main/python/sql/streaming/structured_network_wordcount.py  | 2 +-
 .../python/sql/streaming/structured_network_wordcount_windowed.py  | 2 +-
 examples/src/main/python/streaming/direct_kafka_wordcount.py       | 2 +-
 examples/src/main/python/streaming/flume_wordcount.py              | 2 +-
 examples/src/main/python/streaming/kafka_wordcount.py              | 2 +-
 examples/src/main/python/streaming/network_wordcount.py            | 2 +-
 examples/src/main/python/streaming/network_wordjoinsentiments.py   | 2 +-
 examples/src/main/python/streaming/sql_network_wordcount.py        | 2 +-
 examples/src/main/python/streaming/stateful_network_wordcount.py   | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/sql/streaming/structured_network_wordcount.py
----------------------------------------------------------------------
diff --git 
a/examples/src/main/python/sql/streaming/structured_network_wordcount.py 
b/examples/src/main/python/sql/streaming/structured_network_wordcount.py
index afde255..c3284c1 100644
--- a/examples/src/main/python/sql/streaming/structured_network_wordcount.py
+++ b/examples/src/main/python/sql/streaming/structured_network_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text received from the network.
  Usage: structured_network_wordcount.py <hostname> <port>
    <hostname> and <port> describe the TCP server that Structured Streaming

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/sql/streaming/structured_network_wordcount_windowed.py
----------------------------------------------------------------------
diff --git 
a/examples/src/main/python/sql/streaming/structured_network_wordcount_windowed.py
 
b/examples/src/main/python/sql/streaming/structured_network_wordcount_windowed.py
index 02a7d33..db67255 100644
--- 
a/examples/src/main/python/sql/streaming/structured_network_wordcount_windowed.py
+++ 
b/examples/src/main/python/sql/streaming/structured_network_wordcount_windowed.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text received from the network 
over a
  sliding window of configurable duration. Each line from the network is tagged
  with a timestamp that is used to determine the windows into which it falls.

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/direct_kafka_wordcount.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/direct_kafka_wordcount.py 
b/examples/src/main/python/streaming/direct_kafka_wordcount.py
index 7097f7f..425df30 100644
--- a/examples/src/main/python/streaming/direct_kafka_wordcount.py
+++ b/examples/src/main/python/streaming/direct_kafka_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text directly received from 
Kafka in every 2 seconds.
  Usage: direct_kafka_wordcount.py <broker_list> <topic>
 

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/flume_wordcount.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/flume_wordcount.py 
b/examples/src/main/python/streaming/flume_wordcount.py
index d75bc6d..5d6e6dc 100644
--- a/examples/src/main/python/streaming/flume_wordcount.py
+++ b/examples/src/main/python/streaming/flume_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text received from the network 
every second.
  Usage: flume_wordcount.py <hostname> <port>
 

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/kafka_wordcount.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/kafka_wordcount.py 
b/examples/src/main/python/streaming/kafka_wordcount.py
index 8d697f6..704f660 100644
--- a/examples/src/main/python/streaming/kafka_wordcount.py
+++ b/examples/src/main/python/streaming/kafka_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text received from the network 
every second.
  Usage: kafka_wordcount.py <zk> <topic>
 

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/network_wordcount.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/network_wordcount.py 
b/examples/src/main/python/streaming/network_wordcount.py
index 2b48bcf..9010faf 100644
--- a/examples/src/main/python/streaming/network_wordcount.py
+++ b/examples/src/main/python/streaming/network_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text received from the network 
every second.
  Usage: network_wordcount.py <hostname> <port>
    <hostname> and <port> describe the TCP server that Spark Streaming would 
connect to receive data.

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/network_wordjoinsentiments.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/network_wordjoinsentiments.py 
b/examples/src/main/python/streaming/network_wordjoinsentiments.py
index b309d9f..d51a380 100644
--- a/examples/src/main/python/streaming/network_wordjoinsentiments.py
+++ b/examples/src/main/python/streaming/network_wordjoinsentiments.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Shows the most positive words in UTF8 encoded, '\n' delimited text directly 
received the network
  every 5 seconds. The streaming data is joined with a static RDD of the AFINN 
word list
  (http://neuro.imm.dtu.dk/wiki/AFINN)

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/sql_network_wordcount.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/sql_network_wordcount.py 
b/examples/src/main/python/streaming/sql_network_wordcount.py
index 398ac8d..7f12281 100644
--- a/examples/src/main/python/streaming/sql_network_wordcount.py
+++ b/examples/src/main/python/streaming/sql_network_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Use DataFrames and SQL to count words in UTF8 encoded, '\n' delimited text 
received from the
  network every second.
 

http://git-wip-us.apache.org/repos/asf/spark/blob/be3de879/examples/src/main/python/streaming/stateful_network_wordcount.py
----------------------------------------------------------------------
diff --git a/examples/src/main/python/streaming/stateful_network_wordcount.py 
b/examples/src/main/python/streaming/stateful_network_wordcount.py
index f8bbc65..d7bb61e 100644
--- a/examples/src/main/python/streaming/stateful_network_wordcount.py
+++ b/examples/src/main/python/streaming/stateful_network_wordcount.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 #
 
-"""
+r"""
  Counts words in UTF8 encoded, '\n' delimited text received from the
  network every second.
 


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@spark.apache.org
For additional commands, e-mail: commits-h...@spark.apache.org

Reply via email to