[PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[lakshmi.sowjanya.d]

From: Pandith N <pandith.n@intel.com>

PPS documentation has a generalized section for generators. Update the
section so any new generator documentation can be appended.

Signed-off-by: Pandith N <pandith.n@intel.com>
Signed-off-by: Lakshmi Sowjanya D <lakshmi.sowjanya.d@intel.com>
---
 Documentation/driver-api/pps.rst | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/Documentation/driver-api/pps.rst b/Documentation/driver-api/pps.rst
index 2d6b99766ee8..78dded03e5d8 100644
--- a/Documentation/driver-api/pps.rst
+++ b/Documentation/driver-api/pps.rst
@@ -200,11 +200,17 @@ Generators
 
 Sometimes one needs to be able not only to catch PPS signals but to produce
 them also. For example, running a distributed simulation, which requires
-computers' clock to be synchronized very tightly. One way to do this is to
-invent some complicated hardware solutions but it may be neither necessary
-nor affordable. The cheap way is to load a PPS generator on one of the
-computers (master) and PPS clients on others (slaves), and use very simple
-cables to deliver signals using parallel ports, for example.
+computers' clock to be synchronized very tightly.
+
+
+Parallel port generator
+------------------------
+
+One way to do this is to invent some complicated hardware solutions but it
+may be neither necessary nor affordable. The cheap way is to load a PPS
+generator on one of the computers (master) and PPS clients on others
+(slaves), and use very simple cables to deliver signals using parallel
+ports, for example.
 
 Parallel port cable pinout::
 
-- 
2.17.1

Re: [PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[Rodolfo Giometti]

On 06/10/23 14:15, lakshmi.sowjanya.d@intel.com wrote:
> From: Pandith N <pandith.n@intel.com>
> 
> PPS documentation has a generalized section for generators. Update the
> section so any new generator documentation can be appended.
> 
> Signed-off-by: Pandith N <pandith.n@intel.com>
> Signed-off-by: Lakshmi Sowjanya D <lakshmi.sowjanya.d@intel.com>
> ---
>   Documentation/driver-api/pps.rst | 16 +++++++++++-----
>   1 file changed, 11 insertions(+), 5 deletions(-)
> 
> diff --git a/Documentation/driver-api/pps.rst b/Documentation/driver-api/pps.rst
> index 2d6b99766ee8..78dded03e5d8 100644
> --- a/Documentation/driver-api/pps.rst
> +++ b/Documentation/driver-api/pps.rst
> @@ -200,11 +200,17 @@ Generators
>   
>   Sometimes one needs to be able not only to catch PPS signals but to produce
>   them also. For example, running a distributed simulation, which requires
> -computers' clock to be synchronized very tightly. One way to do this is to
> -invent some complicated hardware solutions but it may be neither necessary
> -nor affordable. The cheap way is to load a PPS generator on one of the
> -computers (master) and PPS clients on others (slaves), and use very simple
> -cables to deliver signals using parallel ports, for example.
> +computers' clock to be synchronized very tightly.
> +
> +
> +Parallel port generator
> +------------------------
> +
> +One way to do this is to invent some complicated hardware solutions but it
> +may be neither necessary nor affordable. The cheap way is to load a PPS
> +generator on one of the computers (master) and PPS clients on others
> +(slaves), and use very simple cables to deliver signals using parallel
> +ports, for example.
>   
>   Parallel port cable pinout::
>   

Acked-by: Rodolfo Giometti <giometti@enneenne.com>

-- 
GNU/Linux Solutions                  e-mail: giometti@enneenne.com
Linux Device Driver                          giometti@linux.it
Embedded Systems                     phone:  +39 349 2432127
UNIX programming                     skype:  rodolfo.giometti

Re: [PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[Andy Shevchenko]

On Fri, Oct 06, 2023 at 05:45:31PM +0530, lakshmi.sowjanya.d@intel.com wrote:
> From: Pandith N <pandith.n@intel.com>
> 
> PPS documentation has a generalized section for generators. Update the
> section so any new generator documentation can be appended.

Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>

You forgot to include the Documentation maintainer...

I suggest to try my "smart" script [1] that has a heuristics on whom
to send the changes.

[1]: https://github.com/andy-shev/home-bin-tools/blob/master/ge2maintainer.sh

-- 
With Best Regards,
Andy Shevchenko

[PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[lakshmi.sowjanya.d]

From: Pandith N <pandith.n@intel.com>

PPS documentation has a generalized section for generators. Update the
section so any new generator documentation can be appended.

Signed-off-by: Pandith N <pandith.n@intel.com>
Signed-off-by: Lakshmi Sowjanya D <lakshmi.sowjanya.d@intel.com>
Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Acked-by: Rodolfo Giometti <giometti@enneenne.com>
---
 Documentation/driver-api/pps.rst | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/Documentation/driver-api/pps.rst b/Documentation/driver-api/pps.rst
index 2d6b99766ee8..78dded03e5d8 100644
--- a/Documentation/driver-api/pps.rst
+++ b/Documentation/driver-api/pps.rst
@@ -200,11 +200,17 @@ Generators
 
 Sometimes one needs to be able not only to catch PPS signals but to produce
 them also. For example, running a distributed simulation, which requires
-computers' clock to be synchronized very tightly. One way to do this is to
-invent some complicated hardware solutions but it may be neither necessary
-nor affordable. The cheap way is to load a PPS generator on one of the
-computers (master) and PPS clients on others (slaves), and use very simple
-cables to deliver signals using parallel ports, for example.
+computers' clock to be synchronized very tightly.
+
+
+Parallel port generator
+------------------------
+
+One way to do this is to invent some complicated hardware solutions but it
+may be neither necessary nor affordable. The cheap way is to load a PPS
+generator on one of the computers (master) and PPS clients on others
+(slaves), and use very simple cables to deliver signals using parallel
+ports, for example.
 
 Parallel port cable pinout::
 
-- 
2.17.1

Re: [PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[Andy Shevchenko]

On Mon, Oct 16, 2023 at 03:49:53PM +0530, lakshmi.sowjanya.d@intel.com wrote:
> From: Pandith N <pandith.n@intel.com>
> 
> PPS documentation has a generalized section for generators. Update the
> section so any new generator documentation can be appended.

It should be v2 with a changelog.

-- 
With Best Regards,
Andy Shevchenko

Re: [PATCH v1] Documentation: driver-api: pps: Update PPS generator documentation

[Jonathan Corbet]

lakshmi.sowjanya.d@intel.com writes:

> From: Pandith N <pandith.n@intel.com>
>
> PPS documentation has a generalized section for generators. Update the
> section so any new generator documentation can be appended.
>
> Signed-off-by: Pandith N <pandith.n@intel.com>
> Signed-off-by: Lakshmi Sowjanya D <lakshmi.sowjanya.d@intel.com>
> Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> Acked-by: Rodolfo Giometti <giometti@enneenne.com>
> ---
>  Documentation/driver-api/pps.rst | 16 +++++++++++-----
>  1 file changed, 11 insertions(+), 5 deletions(-)

Applied, thanks.

jon