drivers/pps: aesthetic tweaks to PPS-related content

Collection of aesthetic adjustments to various PPS-related files,
directories and Documentation, some quite minor just for the sake of
consistency, including:

 * Updated example of pps device tree node (courtesy Rodolfo G.)
 * "PPS-API" -> "PPS API"
 * "pps_source_info_s" -> "pps_source_info"
 * "ktimer driver" -> "pps-ktimer driver"
 * "ppstest /dev/pps0" -> "ppstest /dev/pps1" to match example
 * Add missing PPS-related entries to MAINTAINERS file
 * Other trivialities

Link: http://lkml.kernel.org/r/alpine.LFD.2.20.1708261048220.8106@localhost.localdomain
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
Acked-by: Rodolfo Giometti <giometti@enneenne.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

1 files changed, 7 insertions, 9 deletions

diff --git a/include/linux/pps_kernel.h b/include/linux/pps_kernel.h
index 35ac903956c7..80a980cc8d95 100644
--- a/include/linux/pps_kernel.h
+++ b/include/linux/pps_kernel.h
@@ -22,7 +22,6 @@
 #define LINUX_PPS_KERNEL_H
 
 #include <linux/pps.h>
-
 #include <linux/cdev.h>
 #include <linux/device.h>
 #include <linux/time.h>
@@ -35,9 +34,9 @@ struct pps_device;
 
 /* The specific PPS source info */
 struct pps_source_info {
-        char name[PPS_MAX_NAME_LEN];            /* simbolic name */
+        char name[PPS_MAX_NAME_LEN];            /* symbolic name */
         char path[PPS_MAX_NAME_LEN];            /* path of connected device */
-        int mode;                               /* PPS's allowed mode */
+        int mode;                               /* PPS allowed mode */
 
         void (*echo)(struct pps_device *pps,
                         int event, void *data); /* PPS echo function */
@@ -57,10 +56,10 @@ struct pps_event_time {
 struct pps_device {
         struct pps_source_info info;            /* PSS source info */
 
-        struct pps_kparams params;              /* PPS's current params */
+        struct pps_kparams params;              /* PPS current params */
 
-        __u32 assert_sequence;                  /* PPS' assert event seq # */
-        __u32 clear_sequence;                   /* PPS' clear event seq # */
+        __u32 assert_sequence;                  /* PPS assert event seq # */
+        __u32 clear_sequence;                   /* PPS clear event seq # */
         struct pps_ktime assert_tu;
         struct pps_ktime clear_tu;
         int current_mode;                       /* PPS mode at event time */
@@ -69,7 +68,7 @@ struct pps_device {
         wait_queue_head_t queue;                /* PPS event queue */
 
         unsigned int id;                        /* PPS source unique ID */
-        void const *lookup_cookie;              /* pps_lookup_dev only */
+        void const *lookup_cookie;              /* For pps_lookup_dev() only */
         struct cdev cdev;
         struct device *dev;
         struct fasync_struct *async_queue;      /* fasync method */
@@ -101,7 +100,7 @@ extern struct pps_device *pps_register_source(
 extern void pps_unregister_source(struct pps_device *pps);
 extern void pps_event(struct pps_device *pps,
                 struct pps_event_time *ts, int event, void *data);
-/* Look up a pps device by magic cookie */
+/* Look up a pps_device by magic cookie */
 struct pps_device *pps_lookup_dev(void const *cookie);
 
 static inline void timespec_to_pps_ktime(struct pps_ktime *kt,
@@ -132,4 +131,3 @@ static inline void pps_sub_ts(struct pps_event_time *ts, struct timespec64 delta
 }
 
 #endif /* LINUX_PPS_KERNEL_H */
-