Re: [PATCH 29/32] docs: dt: update writing-schema.rst references

From: Mauro Carvalho Chehab
Date: Wed Apr 07 2021 - 04:06:42 EST


Em Tue, 6 Apr 2021 10:04:57 -0500
Rob Herring <robh+dt@xxxxxxxxxx> escreveu:

> On Thu, Apr 1, 2021 at 7:17 AM Mauro Carvalho Chehab
> <mchehab+huawei@xxxxxxxxxx> wrote:
> >
> > Changeset b83db5b84900 ("docs: dt: Group DT docs into relevant sub-sections")
> > renamed: Documentation/devicetree/writing-schema.rst
> > to: Documentation/devicetree/bindings/writing-schema.rst.
> >
> > Update the cross-references accordingly.
> >
> > Fixes: b83db5b84900 ("docs: dt: Group DT docs into relevant sub-sections")
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> > ---
> > Documentation/devicetree/bindings/submitting-patches.rst | 2 +-
> > scripts/checkpatch.pl | 2 +-
> > 2 files changed, 2 insertions(+), 2 deletions(-)
> >
> > diff --git a/Documentation/devicetree/bindings/submitting-patches.rst b/Documentation/devicetree/bindings/submitting-patches.rst
> > index ee4feb53f8d0..104fa8fb2c17 100644
> > --- a/Documentation/devicetree/bindings/submitting-patches.rst
> > +++ b/Documentation/devicetree/bindings/submitting-patches.rst
> > @@ -25,7 +25,7 @@ I. For patch submitters
> >
> > make dt_binding_check
> >
> > - See Documentation/devicetree/writing-schema.rst for more details about
> > + See Documentation/devicetree/bindings/writing-schema.rst for more details about
>
> We should make this a rSt link instead.

It shouldn't be needed, as Documentation/sphinx/automarkup.py has a rule
which converts Documentation/* into a cross reference using this
regex:

RE_doc = re.compile(r'(\bDocumentation/)?((\.\./)*[\w\-/]+)\.(rst|txt)')


Thanks,
Mauro