* [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-04-24 15:35 [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references Herakliusz Lipiec
@ 2019-04-24 15:35 ` Herakliusz Lipiec
2019-04-24 18:52 ` Rami Rosen
` (2 subsequent siblings)
3 siblings, 0 replies; 10+ messages in thread
From: Herakliusz Lipiec @ 2019-04-24 15:35 UTC (permalink / raw)
To: Bruce Richardson, Vladimir Medvedkin, John McNamara, Marko Kovacevic
Cc: dev, Herakliusz Lipiec, bernard.iremonger, stable
Bugzilla ID: 235
Fixes: fc1f2750a3ec ("doc: programmers guide")
Cc: bernard.iremonger@intel.com
Cc: stable@dpdk.org
Signed-off-by: Herakliusz Lipiec <herakliusz.lipiec@intel.com>
---
doc/guides/prog_guide/lpm_lib.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/doc/guides/prog_guide/lpm_lib.rst b/doc/guides/prog_guide/lpm_lib.rst
index 99563a4a6..1609a57d0 100644
--- a/doc/guides/prog_guide/lpm_lib.rst
+++ b/doc/guides/prog_guide/lpm_lib.rst
@@ -195,4 +195,4 @@ References
`http://www.ietf.org/rfc/rfc1519 <http://www.ietf.org/rfc/rfc1519>`_
* Pankaj Gupta, Algorithms for Routing Lookups and Packet Classification, PhD Thesis, Stanford University,
- 2000 (`http://klamath.stanford.edu/~pankaj/thesis/ thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/%20thesis_1sided.pdf>`_ )
+ 2000 (`http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf>`_ )
--
2.17.2
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-04-24 15:35 [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references Herakliusz Lipiec
2019-04-24 15:35 ` Herakliusz Lipiec
@ 2019-04-24 18:52 ` Rami Rosen
2019-04-24 18:52 ` Rami Rosen
2019-04-25 10:21 ` Medvedkin, Vladimir
2019-05-01 14:12 ` Mcnamara, John
3 siblings, 1 reply; 10+ messages in thread
From: Rami Rosen @ 2019-04-24 18:52 UTC (permalink / raw)
To: Herakliusz Lipiec
Cc: Bruce Richardson, Vladimir Medvedkin, John McNamara,
Marko Kovacevic, dev, bernard.iremonger, stable
Acked-by: Rami Rosen <ramirose@gmail.com>
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-04-24 15:35 [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references Herakliusz Lipiec
2019-04-24 15:35 ` Herakliusz Lipiec
2019-04-24 18:52 ` Rami Rosen
@ 2019-04-25 10:21 ` Medvedkin, Vladimir
2019-04-25 10:21 ` Medvedkin, Vladimir
2019-05-01 14:12 ` Mcnamara, John
3 siblings, 1 reply; 10+ messages in thread
From: Medvedkin, Vladimir @ 2019-04-25 10:21 UTC (permalink / raw)
To: Herakliusz Lipiec, Bruce Richardson, John McNamara, Marko Kovacevic
Cc: dev, bernard.iremonger, stable
Acked-by: Vladimir Medvedkin <vladimir.medvedkin@intel.com>
On 24/04/2019 16:35, Herakliusz Lipiec wrote:
> Bugzilla ID: 235
> Fixes: fc1f2750a3ec ("doc: programmers guide")
> Cc: bernard.iremonger@intel.com
> Cc: stable@dpdk.org
> Signed-off-by: Herakliusz Lipiec <herakliusz.lipiec@intel.com>
> ---
> doc/guides/prog_guide/lpm_lib.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/doc/guides/prog_guide/lpm_lib.rst b/doc/guides/prog_guide/lpm_lib.rst
> index 99563a4a6..1609a57d0 100644
> --- a/doc/guides/prog_guide/lpm_lib.rst
> +++ b/doc/guides/prog_guide/lpm_lib.rst
> @@ -195,4 +195,4 @@ References
> `http://www.ietf.org/rfc/rfc1519 <http://www.ietf.org/rfc/rfc1519>`_
>
> * Pankaj Gupta, Algorithms for Routing Lookups and Packet Classification, PhD Thesis, Stanford University,
> - 2000 (`http://klamath.stanford.edu/~pankaj/thesis/ thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/%20thesis_1sided.pdf>`_ )
> + 2000 (`http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf>`_ )
--
Regards,
Vladimir
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-04-25 10:21 ` Medvedkin, Vladimir
@ 2019-04-25 10:21 ` Medvedkin, Vladimir
0 siblings, 0 replies; 10+ messages in thread
From: Medvedkin, Vladimir @ 2019-04-25 10:21 UTC (permalink / raw)
To: Herakliusz Lipiec, Bruce Richardson, John McNamara, Marko Kovacevic
Cc: dev, bernard.iremonger, stable
Acked-by: Vladimir Medvedkin <vladimir.medvedkin@intel.com>
On 24/04/2019 16:35, Herakliusz Lipiec wrote:
> Bugzilla ID: 235
> Fixes: fc1f2750a3ec ("doc: programmers guide")
> Cc: bernard.iremonger@intel.com
> Cc: stable@dpdk.org
> Signed-off-by: Herakliusz Lipiec <herakliusz.lipiec@intel.com>
> ---
> doc/guides/prog_guide/lpm_lib.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/doc/guides/prog_guide/lpm_lib.rst b/doc/guides/prog_guide/lpm_lib.rst
> index 99563a4a6..1609a57d0 100644
> --- a/doc/guides/prog_guide/lpm_lib.rst
> +++ b/doc/guides/prog_guide/lpm_lib.rst
> @@ -195,4 +195,4 @@ References
> `http://www.ietf.org/rfc/rfc1519 <http://www.ietf.org/rfc/rfc1519>`_
>
> * Pankaj Gupta, Algorithms for Routing Lookups and Packet Classification, PhD Thesis, Stanford University,
> - 2000 (`http://klamath.stanford.edu/~pankaj/thesis/ thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/%20thesis_1sided.pdf>`_ )
> + 2000 (`http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf>`_ )
--
Regards,
Vladimir
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-04-24 15:35 [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references Herakliusz Lipiec
` (2 preceding siblings ...)
2019-04-25 10:21 ` Medvedkin, Vladimir
@ 2019-05-01 14:12 ` Mcnamara, John
2019-05-01 14:12 ` Mcnamara, John
2019-05-04 21:41 ` Thomas Monjalon
3 siblings, 2 replies; 10+ messages in thread
From: Mcnamara, John @ 2019-05-01 14:12 UTC (permalink / raw)
To: Lipiec, Herakliusz, Richardson, Bruce, Medvedkin, Vladimir,
Kovacevic, Marko
Cc: dev, Iremonger, Bernard, stable
> -----Original Message-----
> From: Lipiec, Herakliusz
> Sent: Wednesday, April 24, 2019 4:36 PM
> To: Richardson, Bruce <bruce.richardson@intel.com>; Medvedkin, Vladimir
> <vladimir.medvedkin@intel.com>; Mcnamara, John <john.mcnamara@intel.com>;
> Kovacevic, Marko <marko.kovacevic@intel.com>
> Cc: dev@dpdk.org; Lipiec, Herakliusz <herakliusz.lipiec@intel.com>;
> Iremonger, Bernard <bernard.iremonger@intel.com>; stable@dpdk.org
> Subject: [PATCH] doc: fix broken link in programmers guide lpm library
> references
>
> Bugzilla ID: 235
The fix is good and should be applied.
However, if viewed strictly, that `Link text <https://url/>`_ syntax is only required if the link text and the url are different.
So in this case you could (or the original author) just use a simple url without any additional syntax.
However, better still would be if we did something like this to put the links inline in the text:
diff --git a/doc/guides/prog_guide/lpm_lib.rst b/doc/guides/prog_guide/lpm_lib.rst
index 99563a4..375e666 100644
--- a/doc/guides/prog_guide/lpm_lib.rst
+++ b/doc/guides/prog_guide/lpm_lib.rst
@@ -191,8 +191,10 @@ The LPM algorithm is used to implement Classless Inter-Domain Routing (CIDR) str
References
~~~~~~~~~~
-* RFC1519 Classless Inter-Domain Routing (CIDR): an Address Assignment and Aggregation Strategy,
- `http://www.ietf.org/rfc/rfc1519 <http://www.ietf.org/rfc/rfc1519>`_
+* `RFC1519 <http://www.ietf.org/rfc/rfc1519>`_ Classless Inter-Domain Routing
+ (CIDR): an Address Assignment and Aggregation Strategy.
-* Pankaj Gupta, Algorithms for Routing Lookups and Packet Classification, PhD Thesis, Stanford University,
- 2000 (`http://klamath.stanford.edu/~pankaj/thesis/ thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/%20thesis_1sided.pdf>`_ )
+
+* Pankaj Gupta, `Algorithms for Routing Lookups and Packet Classification
+ <http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf>`_, PhD
+ Thesis, Stanford University, 2000.
However, the fix is better than a broken link so:
Acked-by: John McNamara <john.mcnamara@intel.com>
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-05-01 14:12 ` Mcnamara, John
@ 2019-05-01 14:12 ` Mcnamara, John
2019-05-04 21:41 ` Thomas Monjalon
1 sibling, 0 replies; 10+ messages in thread
From: Mcnamara, John @ 2019-05-01 14:12 UTC (permalink / raw)
To: Lipiec, Herakliusz, Richardson, Bruce, Medvedkin, Vladimir,
Kovacevic, Marko
Cc: dev, Iremonger, Bernard, stable
> -----Original Message-----
> From: Lipiec, Herakliusz
> Sent: Wednesday, April 24, 2019 4:36 PM
> To: Richardson, Bruce <bruce.richardson@intel.com>; Medvedkin, Vladimir
> <vladimir.medvedkin@intel.com>; Mcnamara, John <john.mcnamara@intel.com>;
> Kovacevic, Marko <marko.kovacevic@intel.com>
> Cc: dev@dpdk.org; Lipiec, Herakliusz <herakliusz.lipiec@intel.com>;
> Iremonger, Bernard <bernard.iremonger@intel.com>; stable@dpdk.org
> Subject: [PATCH] doc: fix broken link in programmers guide lpm library
> references
>
> Bugzilla ID: 235
The fix is good and should be applied.
However, if viewed strictly, that `Link text <https://url/>`_ syntax is only required if the link text and the url are different.
So in this case you could (or the original author) just use a simple url without any additional syntax.
However, better still would be if we did something like this to put the links inline in the text:
diff --git a/doc/guides/prog_guide/lpm_lib.rst b/doc/guides/prog_guide/lpm_lib.rst
index 99563a4..375e666 100644
--- a/doc/guides/prog_guide/lpm_lib.rst
+++ b/doc/guides/prog_guide/lpm_lib.rst
@@ -191,8 +191,10 @@ The LPM algorithm is used to implement Classless Inter-Domain Routing (CIDR) str
References
~~~~~~~~~~
-* RFC1519 Classless Inter-Domain Routing (CIDR): an Address Assignment and Aggregation Strategy,
- `http://www.ietf.org/rfc/rfc1519 <http://www.ietf.org/rfc/rfc1519>`_
+* `RFC1519 <http://www.ietf.org/rfc/rfc1519>`_ Classless Inter-Domain Routing
+ (CIDR): an Address Assignment and Aggregation Strategy.
-* Pankaj Gupta, Algorithms for Routing Lookups and Packet Classification, PhD Thesis, Stanford University,
- 2000 (`http://klamath.stanford.edu/~pankaj/thesis/ thesis_1sided.pdf <http://klamath.stanford.edu/~pankaj/thesis/%20thesis_1sided.pdf>`_ )
+
+* Pankaj Gupta, `Algorithms for Routing Lookups and Packet Classification
+ <http://klamath.stanford.edu/~pankaj/thesis/thesis_1sided.pdf>`_, PhD
+ Thesis, Stanford University, 2000.
However, the fix is better than a broken link so:
Acked-by: John McNamara <john.mcnamara@intel.com>
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-05-01 14:12 ` Mcnamara, John
2019-05-01 14:12 ` Mcnamara, John
@ 2019-05-04 21:41 ` Thomas Monjalon
2019-05-04 21:41 ` Thomas Monjalon
1 sibling, 1 reply; 10+ messages in thread
From: Thomas Monjalon @ 2019-05-04 21:41 UTC (permalink / raw)
To: Lipiec, Herakliusz
Cc: dev, Mcnamara, John, Richardson, Bruce, Medvedkin, Vladimir,
Kovacevic, Marko, Iremonger, Bernard, stable
01/05/2019 16:12, Mcnamara, John:
> From: Lipiec, Herakliusz
> >
> > Bugzilla ID: 235
>
> The fix is good and should be applied.
>
> However, if viewed strictly, that `Link text <https://url/>`_ syntax is only required if the link text and the url are different.
>
> So in this case you could (or the original author) just use a simple url without any additional syntax.
>
> However, better still would be if we did something like this to put the links inline in the text:
Yes, that would be good to do this kind of cleanup in the guides.
[...]
> However, the fix is better than a broken link so:
>
> Acked-by: John McNamara <john.mcnamara@intel.com>
Applied, thanks
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [dpdk-dev] [PATCH] doc: fix broken link in programmers guide lpm library references
2019-05-04 21:41 ` Thomas Monjalon
@ 2019-05-04 21:41 ` Thomas Monjalon
0 siblings, 0 replies; 10+ messages in thread
From: Thomas Monjalon @ 2019-05-04 21:41 UTC (permalink / raw)
To: Lipiec, Herakliusz
Cc: dev, Mcnamara, John, Richardson, Bruce, Medvedkin, Vladimir,
Kovacevic, Marko, Iremonger, Bernard, stable
01/05/2019 16:12, Mcnamara, John:
> From: Lipiec, Herakliusz
> >
> > Bugzilla ID: 235
>
> The fix is good and should be applied.
>
> However, if viewed strictly, that `Link text <https://url/>`_ syntax is only required if the link text and the url are different.
>
> So in this case you could (or the original author) just use a simple url without any additional syntax.
>
> However, better still would be if we did something like this to put the links inline in the text:
Yes, that would be good to do this kind of cleanup in the guides.
[...]
> However, the fix is better than a broken link so:
>
> Acked-by: John McNamara <john.mcnamara@intel.com>
Applied, thanks
^ permalink raw reply [flat|nested] 10+ messages in thread