* [PATCH 0/1] Documentation: convert sh interfaces to RST
@ 2017-01-19 22:06 Steve Kowalik
2017-02-12 23:35 ` Jonathan Corbet
2017-02-18 7:13 ` Rob Landley
0 siblings, 2 replies; 3+ messages in thread
From: Steve Kowalik @ 2017-01-19 22:06 UTC (permalink / raw)
To: linux-sh
Hi,
The following patch converts the SuperH interfaces DocBook into RST,
however, I've not added it to the toctree, since I'm not 100% clear
where it best fits.
Steve Kowalik (1):
Documentation: convert sh interfaces to RST
Documentation/DocBook/Makefile | 2 +-
Documentation/DocBook/sh.tmpl | 105 ----------------------------------------
Documentation/sh/interfaces.rst | 59 ++++++++++++++++++++++
3 files changed, 60 insertions(+), 106 deletions(-)
delete mode 100644 Documentation/DocBook/sh.tmpl
create mode 100644 Documentation/sh/interfaces.rst
--
2.7.4
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH 0/1] Documentation: convert sh interfaces to RST
2017-01-19 22:06 [PATCH 0/1] Documentation: convert sh interfaces to RST Steve Kowalik
@ 2017-02-12 23:35 ` Jonathan Corbet
2017-02-18 7:13 ` Rob Landley
1 sibling, 0 replies; 3+ messages in thread
From: Jonathan Corbet @ 2017-02-12 23:35 UTC (permalink / raw)
To: linux-sh
On Fri, 20 Jan 2017 09:06:41 +1100
Steve Kowalik <steven@wedontsleep.org> wrote:
> The following patch converts the SuperH interfaces DocBook into RST,
> however, I've not added it to the toctree, since I'm not 100% clear
> where it best fits.
So I have to apologize, this fell through the cracks in the disaster that
is my inbox.
The conversion itself looks mostly OK. There is, however, a copyright
assertion in the original template file that should really be preserved
in the new file as well; usually I put those in as comments at the top of
the RST file.
As for where it fits; it seems maybe we need a subbook for
architecture-specific stuff. Documentation/arch or /arch-guide?
Thanks,
jon
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH 0/1] Documentation: convert sh interfaces to RST
2017-01-19 22:06 [PATCH 0/1] Documentation: convert sh interfaces to RST Steve Kowalik
2017-02-12 23:35 ` Jonathan Corbet
@ 2017-02-18 7:13 ` Rob Landley
1 sibling, 0 replies; 3+ messages in thread
From: Rob Landley @ 2017-02-18 7:13 UTC (permalink / raw)
To: linux-sh
On 02/12/2017 05:35 PM, Jonathan Corbet wrote:
> On Fri, 20 Jan 2017 09:06:41 +1100
> Steve Kowalik <steven@wedontsleep.org> wrote:
>
>> The following patch converts the SuperH interfaces DocBook into RST,
>> however, I've not added it to the toctree, since I'm not 100% clear
>> where it best fits.
>
> So I have to apologize, this fell through the cracks in the disaster that
> is my inbox.
>
> The conversion itself looks mostly OK. There is, however, a copyright
> assertion in the original template file that should really be preserved
> in the new file as well; usually I put those in as comments at the top of
> the RST file.
>
> As for where it fits; it seems maybe we need a subbook for
> architecture-specific stuff. Documentation/arch or /arch-guide?
Documentation/arch mirrors the kernel source layout, and I actually
submitted patches to collate the various arch directories under that
many moons ago. You may remember:
https://lwn.net/Articles/244448/
> Thanks,
>
> jon
Rob
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2017-02-18 7:13 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-01-19 22:06 [PATCH 0/1] Documentation: convert sh interfaces to RST Steve Kowalik
2017-02-12 23:35 ` Jonathan Corbet
2017-02-18 7:13 ` Rob Landley
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.