Small docstring cleanups

Author: jdlangs

src/pubsub.jl

@@ -36,8 +36,9 @@ end
     Subscriber{T}(topic, callback, cb_args=(); kwargs...)
     Subscriber(topic, T, callback, cb_args=(); kwargs...)
 
-Create a subscription to a topic with a callback to use when a message is received, which can be any
-callable type. Keyword arguments are directly passed to rospy.
+Create a subscription to a topic with message type `T` with a callback to use when a message is
+received, which can be any callable type. Extra arguments provided to the callback when invoked
+can be provided in the `cb_args` tuple. Keyword arguments are directly passed to rospy.
 """
 type Subscriber{MsgType<:AbstractMsg}
     callback

src/rospy.jl

@@ -25,7 +25,7 @@ get_ros_root()         = __rospy__[:get_ros_root]()
 """
     spin()
 
-Block execution and only process callbacks/service calls until the node is shut down.
+Block execution and process callbacks/service calls until the node is shut down.
 """
 function spin()
     #Have to make sure both Julia tasks and python threads can wake up so

src/time.jl

@@ -95,15 +95,15 @@ to_nsec{T<:TVal}(t::T) = 1_000_000_000*t.secs + t.nsecs
 convert{T<:TVal}(::Type{Float64}, t::T) = to_sec(t)
 
 #Comparisons
-=={T<:TVal}(t1::T, t2::T)     = (t1.secs == t2.secs) && (t1.nsecs == t2.nsecs)
+=={T<:TVal}(t1::T, t2::T) = (t1.secs == t2.secs) && (t1.nsecs == t2.nsecs)
 isless{T<:TVal}(t1::T, t2::T) = to_nsec(t1) < to_nsec(t2)
 
 """
     Rate(hz::Real), Rate(d::Duration)
 
 Used to allow a loop to run at a fixed rate. Construct with a frequency or `Duration` and use with
 `rossleep` or `sleep`. The rate object will record execution time of other work in the loop and
-modify the sleep time to compensate and keep the loop rate as consistent as possible.
+modify the sleep time to compensate, keeping the loop rate as consistent as possible.
 """
 type Rate
     duration::Duration
@@ -136,7 +136,8 @@ now() = get_rostime()
 """
     rossleep(t)
 
-Call the ROS sleep function with a number of seconds, a `Duration` or a `Rate` object.
+Sleep and process callbacks for a number of seconds implied by the type and value of `t`, which may
+be a real-value, a `Duration` object, or a `Rate` object.
 """
 function rossleep(td::Duration)
     #Busy sleep loop needed to allow both julia and python async activity
@@ -166,8 +167,7 @@ end
 """
     sleep(t::Duration), sleep(t::Rate)
 
-Call the ROS sleep function with a `Duration` or `Rate` object. Use `rossleep` to specify sleep time
-directly.
+Call `rossleep` with a `Duration` or `Rate` object. Use `rossleep` to specify sleep time directly.
 """
 sleep(t::Duration) = rossleep(t)
 sleep(t::Rate) = rossleep(t)