* [PATCH] Documentation: add link to stm32mp157 docs
@ 2019-08-27 12:19 Gerald BAEZA
2019-08-27 13:48 ` Jonathan Corbet
0 siblings, 1 reply; 8+ messages in thread
From: Gerald BAEZA @ 2019-08-27 12:19 UTC (permalink / raw)
To: corbet, mcoquelin.stm32, Alexandre TORGUE, linux-doc,
linux-stm32, linux-arm-kernel, linux-kernel
Cc: Gerald BAEZA
Link to the online stm32mp157 documentation added
in the overview.
Signed-off-by: Gerald Baeza <gerald.baeza@st.com>
---
Documentation/arm/stm32/stm32mp157-overview.rst | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst
index f62fdc8..8d5a476 100644
--- a/Documentation/arm/stm32/stm32mp157-overview.rst
+++ b/Documentation/arm/stm32/stm32mp157-overview.rst
@@ -14,6 +14,12 @@ It features:
- Standard connectivity, widely inherited from the STM32 MCU family
- Comprehensive security support
+Resources
+---------
+
+Datasheet and reference manual are publicly available on ST website:
+.. _STM32MP157: https://www.st.com/en/microcontrollers-microprocessors/stm32mp157.html
+
:Authors:
- Ludovic Barre <ludovic.barre@st.com>
--
2.7.4
^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: add link to stm32mp157 docs
2019-08-27 12:19 [PATCH] Documentation: add link to stm32mp157 docs Gerald BAEZA
@ 2019-08-27 13:48 ` Jonathan Corbet
2019-08-27 15:23 ` Alexandre Torgue
0 siblings, 1 reply; 8+ messages in thread
From: Jonathan Corbet @ 2019-08-27 13:48 UTC (permalink / raw)
To: Gerald BAEZA
Cc: mcoquelin.stm32, Alexandre TORGUE, linux-doc, linux-stm32,
linux-arm-kernel, linux-kernel
On Tue, 27 Aug 2019 12:19:32 +0000
Gerald BAEZA <gerald.baeza@st.com> wrote:
> Link to the online stm32mp157 documentation added
> in the overview.
>
> Signed-off-by: Gerald Baeza <gerald.baeza@st.com>
> ---
> Documentation/arm/stm32/stm32mp157-overview.rst | 6 ++++++
> 1 file changed, 6 insertions(+)
>
> diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst
> index f62fdc8..8d5a476 100644
> --- a/Documentation/arm/stm32/stm32mp157-overview.rst
> +++ b/Documentation/arm/stm32/stm32mp157-overview.rst
> @@ -14,6 +14,12 @@ It features:
> - Standard connectivity, widely inherited from the STM32 MCU family
> - Comprehensive security support
>
> +Resources
> +---------
> +
> +Datasheet and reference manual are publicly available on ST website:
> +.. _STM32MP157: https://www.st.com/en/microcontrollers-microprocessors/stm32mp157.html
> +
Adding the URL is a fine idea. But you don't need the extra syntax to
create a link if you're not going to actually make a link out of it. So
I'd take the ".. _STM32MP157:" part out and life will be good.
Thanks,
jon
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: add link to stm32mp157 docs
2019-08-27 13:48 ` Jonathan Corbet
@ 2019-08-27 15:23 ` Alexandre Torgue
2019-08-29 15:44 ` Jonathan Corbet
2019-10-03 10:05 ` Gerald BAEZA
0 siblings, 2 replies; 8+ messages in thread
From: Alexandre Torgue @ 2019-08-27 15:23 UTC (permalink / raw)
To: Jonathan Corbet, Gerald BAEZA
Cc: mcoquelin.stm32, linux-doc, linux-stm32, linux-arm-kernel, linux-kernel
Hi Jonathan,
On 8/27/19 3:48 PM, Jonathan Corbet wrote:
> On Tue, 27 Aug 2019 12:19:32 +0000
> Gerald BAEZA <gerald.baeza@st.com> wrote:
>
>> Link to the online stm32mp157 documentation added
>> in the overview.
>>
>> Signed-off-by: Gerald Baeza <gerald.baeza@st.com>
>> ---
>> Documentation/arm/stm32/stm32mp157-overview.rst | 6 ++++++
>> 1 file changed, 6 insertions(+)
>>
>> diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst
>> index f62fdc8..8d5a476 100644
>> --- a/Documentation/arm/stm32/stm32mp157-overview.rst
>> +++ b/Documentation/arm/stm32/stm32mp157-overview.rst
>> @@ -14,6 +14,12 @@ It features:
>> - Standard connectivity, widely inherited from the STM32 MCU family
>> - Comprehensive security support
>>
>> +Resources
>> +---------
>> +
>> +Datasheet and reference manual are publicly available on ST website:
>> +.. _STM32MP157: https://www.st.com/en/microcontrollers-microprocessors/stm32mp157.html
>> +
>
> Adding the URL is a fine idea. But you don't need the extra syntax to
> create a link if you're not going to actually make a link out of it. So
> I'd take the ".. _STM32MP157:" part out and life will be good.
>
We also did it for older stm32 product. Idea was to not have the "full"
address but just a shortcut of the link when html file is read. It maybe
makes no sens ? (if yes we will have to update older stm32 overview :))
thanks
Alex
> Thanks,
>
> jon
>
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: add link to stm32mp157 docs
2019-08-27 15:23 ` Alexandre Torgue
@ 2019-08-29 15:44 ` Jonathan Corbet
2019-10-03 10:05 ` Gerald BAEZA
1 sibling, 0 replies; 8+ messages in thread
From: Jonathan Corbet @ 2019-08-29 15:44 UTC (permalink / raw)
To: Alexandre Torgue
Cc: Gerald BAEZA, mcoquelin.stm32, linux-doc, linux-stm32,
linux-arm-kernel, linux-kernel
On Tue, 27 Aug 2019 17:23:30 +0200
Alexandre Torgue <alexandre.torgue@st.com> wrote:
> >> +Datasheet and reference manual are publicly available on ST website:
> >> +.. _STM32MP157: https://www.st.com/en/microcontrollers-microprocessors/stm32mp157.html
> >> +
> >
> > Adding the URL is a fine idea. But you don't need the extra syntax to
> > create a link if you're not going to actually make a link out of it. So
> > I'd take the ".. _STM32MP157:" part out and life will be good.
> >
>
> We also did it for older stm32 product. Idea was to not have the "full"
> address but just a shortcut of the link when html file is read. It maybe
> makes no sens ? (if yes we will have to update older stm32 overview :))
Did you actually run it through Sphinx to see what you get? If I
understand the effect you're after, you want something like this:
The datasheet and reference manual are publicly available on
STM32MP157_.
.. _STM32MP157: https://www.st.com/en/microcontrollers-microprocessors/stm32mp157.html
IOW you have to actually *use* the label you are setting up. That's a fine
way to do it, I guess, though I'm not really convinced it's better than
just putting the URL in directly.
Thanks,
jon
^ permalink raw reply [flat|nested] 8+ messages in thread
* RE: [PATCH] Documentation: add link to stm32mp157 docs
2019-08-27 15:23 ` Alexandre Torgue
2019-08-29 15:44 ` Jonathan Corbet
@ 2019-10-03 10:05 ` Gerald BAEZA
2019-10-07 15:32 ` Jonathan Corbet
1 sibling, 1 reply; 8+ messages in thread
From: Gerald BAEZA @ 2019-10-03 10:05 UTC (permalink / raw)
To: Alexandre TORGUE, Jonathan Corbet
Cc: mcoquelin.stm32, linux-doc, linux-stm32, linux-arm-kernel, linux-kernel
Hi Jonathan
> From: Alexandre TORGUE <alexandre.torgue@st.com>
> Hi Jonathan,
>
> On 8/27/19 3:48 PM, Jonathan Corbet wrote:
> > On Tue, 27 Aug 2019 12:19:32 +0000
> > Gerald BAEZA <gerald.baeza@st.com> wrote:
> >
> >> Link to the online stm32mp157 documentation added in the overview.
> >>
> >> Signed-off-by: Gerald Baeza <gerald.baeza@st.com>
> >> ---
> >> Documentation/arm/stm32/stm32mp157-overview.rst | 6 ++++++
> >> 1 file changed, 6 insertions(+)
> >>
> >> diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst
> >> b/Documentation/arm/stm32/stm32mp157-overview.rst
> >> index f62fdc8..8d5a476 100644
> >> --- a/Documentation/arm/stm32/stm32mp157-overview.rst
> >> +++ b/Documentation/arm/stm32/stm32mp157-overview.rst
> >> @@ -14,6 +14,12 @@ It features:
> >> - Standard connectivity, widely inherited from the STM32 MCU family
> >> - Comprehensive security support
> >>
> >> +Resources
> >> +---------
> >> +
> >> +Datasheet and reference manual are publicly available on ST website:
> >> +.. _STM32MP157:
> >> +https://www.st.com/en/microcontrollers-
> microprocessors/stm32mp157.ht
> >> +ml
> >> +
> >
> > Adding the URL is a fine idea. But you don't need the extra syntax to
> > create a link if you're not going to actually make a link out of it.
> > So I'd take the ".. _STM32MP157:" part out and life will be good.
> >
>
> We also did it for older stm32 product. Idea was to not have the "full"
> address but just a shortcut of the link when html file is read. It maybe makes
> no sens ? (if yes we will have to update older stm32 overview :))
Example in https://www.kernel.org/doc/html/latest/arm/stm32/stm32h743-overview.html
Do you agree to continue like this ?
Best regards,
Gérald
> thanks
> Alex
>
>
> > Thanks,
> >
> > jon
> >
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: add link to stm32mp157 docs
2019-10-03 10:05 ` Gerald BAEZA
@ 2019-10-07 15:32 ` Jonathan Corbet
2019-10-08 9:19 ` Gerald BAEZA
2019-10-25 9:42 ` Alexandre Torgue
0 siblings, 2 replies; 8+ messages in thread
From: Jonathan Corbet @ 2019-10-07 15:32 UTC (permalink / raw)
To: Gerald BAEZA
Cc: Alexandre TORGUE, mcoquelin.stm32, linux-doc, linux-stm32,
linux-arm-kernel, linux-kernel
On Thu, 3 Oct 2019 10:05:46 +0000
Gerald BAEZA <gerald.baeza@st.com> wrote:
> > > Adding the URL is a fine idea. But you don't need the extra syntax to
> > > create a link if you're not going to actually make a link out of it.
> > > So I'd take the ".. _STM32MP157:" part out and life will be good.
> > >
> >
> > We also did it for older stm32 product. Idea was to not have the "full"
> > address but just a shortcut of the link when html file is read. It maybe makes
> > no sens ? (if yes we will have to update older stm32 overview :))
>
> Example in https://www.kernel.org/doc/html/latest/arm/stm32/stm32h743-overview.html
>
> Do you agree to continue like this ?
If you actually use the reference then it's OK, I guess; in the posted
document that wasn't happening. I still think it might be a bit more
straightforward to just put the URL; that will make the plain-text file a
little more readable. In the end, though, it's up to you, go with
whichever you prefer.
Thanks,
jon
^ permalink raw reply [flat|nested] 8+ messages in thread
* RE: [PATCH] Documentation: add link to stm32mp157 docs
2019-10-07 15:32 ` Jonathan Corbet
@ 2019-10-08 9:19 ` Gerald BAEZA
2019-10-25 9:42 ` Alexandre Torgue
1 sibling, 0 replies; 8+ messages in thread
From: Gerald BAEZA @ 2019-10-08 9:19 UTC (permalink / raw)
To: Jonathan Corbet
Cc: Alexandre TORGUE, mcoquelin.stm32, linux-doc, linux-stm32,
linux-arm-kernel, linux-kernel
Hi Jonathan
> From: Jonathan Corbet <corbet@lwn.net>
>
> On Thu, 3 Oct 2019 10:05:46 +0000
> Gerald BAEZA <gerald.baeza@st.com> wrote:
>
> > > > Adding the URL is a fine idea. But you don't need the extra
> > > > syntax to create a link if you're not going to actually make a link out of it.
> > > > So I'd take the ".. _STM32MP157:" part out and life will be good.
> > > >
> > >
> > > We also did it for older stm32 product. Idea was to not have the "full"
> > > address but just a shortcut of the link when html file is read. It
> > > maybe makes no sens ? (if yes we will have to update older stm32
> > > overview :))
> >
> > Example in
> > https://www.kernel.org/doc/html/latest/arm/stm32/stm32h743-
> overview.ht
> > ml
> >
> > Do you agree to continue like this ?
>
> If you actually use the reference then it's OK, I guess; in the posted
> document that wasn't happening. I still think it might be a bit more
> straightforward to just put the URL; that will make the plain-text file a little
> more readable. In the end, though, it's up to you, go with whichever you
> prefer.
So I prefer to keep the patch as it, for better consistency with the others stm32 overviews.
Thank you.
>
> Thanks,
>
> jon
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: add link to stm32mp157 docs
2019-10-07 15:32 ` Jonathan Corbet
2019-10-08 9:19 ` Gerald BAEZA
@ 2019-10-25 9:42 ` Alexandre Torgue
1 sibling, 0 replies; 8+ messages in thread
From: Alexandre Torgue @ 2019-10-25 9:42 UTC (permalink / raw)
To: Jonathan Corbet, Gerald BAEZA
Cc: mcoquelin.stm32, linux-doc, linux-stm32, linux-arm-kernel, linux-kernel
Hi Jonathan
On 10/7/19 5:32 PM, Jonathan Corbet wrote:
> On Thu, 3 Oct 2019 10:05:46 +0000
> Gerald BAEZA <gerald.baeza@st.com> wrote:
>
>>>> Adding the URL is a fine idea. But you don't need the extra syntax to
>>>> create a link if you're not going to actually make a link out of it.
>>>> So I'd take the ".. _STM32MP157:" part out and life will be good.
>>>>
>>>
>>> We also did it for older stm32 product. Idea was to not have the "full"
>>> address but just a shortcut of the link when html file is read. It maybe makes
>>> no sens ? (if yes we will have to update older stm32 overview :))
>>
>> Example in https://www.kernel.org/doc/html/latest/arm/stm32/stm32h743-overview.html
>>
>> Do you agree to continue like this ?
>
> If you actually use the reference then it's OK, I guess; in the posted
> document that wasn't happening. I still think it might be a bit more
> straightforward to just put the URL; that will make the plain-text file a
> little more readable. In the end, though, it's up to you, go with
> whichever you prefer.
>
Do you take this patch or do I have to add it in my STM32 pull request ?
Thanks in advance
Alex
> Thanks,
>
> jon
>
^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2019-10-25 9:42 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-08-27 12:19 [PATCH] Documentation: add link to stm32mp157 docs Gerald BAEZA
2019-08-27 13:48 ` Jonathan Corbet
2019-08-27 15:23 ` Alexandre Torgue
2019-08-29 15:44 ` Jonathan Corbet
2019-10-03 10:05 ` Gerald BAEZA
2019-10-07 15:32 ` Jonathan Corbet
2019-10-08 9:19 ` Gerald BAEZA
2019-10-25 9:42 ` Alexandre Torgue
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).