diff mbox

[media] DocBook: Fix docbook compilation

Message ID 1347567100-2256-1-git-send-email-mchehab@redhat.com (mailing list archive)
State New, archived
Headers show

Commit Message

Mauro Carvalho Chehab Sept. 13, 2012, 8:11 p.m. UTC
changeset 1248c7cb66d734b60efed41be7c7b86909812c0e broke html compilation:

Documentation/DocBook/v4l2.xml:584: parser error : Entity 'sub-subdev-g-edid' not defined
Documentation/DocBook/v4l2.xml:626: parser error : chunk is not well balanced
Documentation/DocBook/media_api.xml:74: parser error : Failure to process entity sub-v4l2
Documentation/DocBook/media_api.xml:74: parser error : Entity 'sub-v4l2' not defined

I suspect that one file was simply missed at the patch. Yet, keeping
it broken is a very bad idea, so we should either remove the broken
patch or to remove just the invalid include. Let's take the latter
approach.

Due to that, a warning is now produced:

Error: no ID for constraint linkend: v4l2-subdev-edid.

Cc: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
---
 Documentation/DocBook/media/v4l/v4l2.xml | 1 -
 1 file changed, 1 deletion(-)

Comments

Hans Verkuil Sept. 13, 2012, 9 p.m. UTC | #1
On Thu September 13 2012 22:11:40 Mauro Carvalho Chehab wrote:
> changeset 1248c7cb66d734b60efed41be7c7b86909812c0e broke html compilation:
> 
> Documentation/DocBook/v4l2.xml:584: parser error : Entity 'sub-subdev-g-edid' not defined
> Documentation/DocBook/v4l2.xml:626: parser error : chunk is not well balanced
> Documentation/DocBook/media_api.xml:74: parser error : Failure to process entity sub-v4l2
> Documentation/DocBook/media_api.xml:74: parser error : Entity 'sub-v4l2' not defined
> 
> I suspect that one file was simply missed at the patch.

Indeed. The missing vidioc-subdev-g-edid.xml file is here:

https://patchwork.kernel.org/patch/1209461/

I forgot to do a git add when I made the RFCv3, but that documentation file
hasn't changed since RFCv2, so you can just use the one from RFCv2 and revert
this patch.

My apologies, I haven't found a good way yet to check that I didn't forgot to
add a file.

Regards,

	Hans

> Yet, keeping
> it broken is a very bad idea, so we should either remove the broken
> patch or to remove just the invalid include. Let's take the latter
> approach.
> 
> Due to that, a warning is now produced:
> 
> Error: no ID for constraint linkend: v4l2-subdev-edid.
> 
> Cc: Hans Verkuil <hans.verkuil@cisco.com>
> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
> ---
>  Documentation/DocBook/media/v4l/v4l2.xml | 1 -
>  1 file changed, 1 deletion(-)
> 
> diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml
> index 10ccde9..0292ed1 100644
> --- a/Documentation/DocBook/media/v4l/v4l2.xml
> +++ b/Documentation/DocBook/media/v4l/v4l2.xml
> @@ -581,7 +581,6 @@ and discussions on the V4L mailing list.</revremark>
>      &sub-subdev-enum-frame-size;
>      &sub-subdev-enum-mbus-code;
>      &sub-subdev-g-crop;
> -    &sub-subdev-g-edid;
>      &sub-subdev-g-fmt;
>      &sub-subdev-g-frame-interval;
>      &sub-subdev-g-selection;
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Mauro Carvalho Chehab Sept. 25, 2012, 11:25 a.m. UTC | #2
Em Qui, 2012-09-13 às 23:00 +0200, Hans Verkuil escreveu:
> On Thu September 13 2012 22:11:40 Mauro Carvalho Chehab wrote:
> > changeset 1248c7cb66d734b60efed41be7c7b86909812c0e broke html compilation:
> > 
> > Documentation/DocBook/v4l2.xml:584: parser error : Entity 'sub-subdev-g-edid' not defined
> > Documentation/DocBook/v4l2.xml:626: parser error : chunk is not well balanced
> > Documentation/DocBook/media_api.xml:74: parser error : Failure to process entity sub-v4l2
> > Documentation/DocBook/media_api.xml:74: parser error : Entity 'sub-v4l2' not defined
> > 
> > I suspect that one file was simply missed at the patch.
> 
> Indeed. The missing vidioc-subdev-g-edid.xml file is here:
> 
> https://patchwork.kernel.org/patch/1209461/
> 
> I forgot to do a git add when I made the RFCv3, but that documentation file
> hasn't changed since RFCv2, so you can just use the one from RFCv2 and revert
> this patch.
> 
> My apologies, I haven't found a good way yet to check that I didn't forgot to
> add a file.

The above patch is not 100%:

Warning: multiple "IDs" for constraint linkend: v4l2-dv-tx-mode.
Warning: multiple "IDs" for constraint linkend: v4l2-dv-rgb-range.
Warning: multiple "IDs" for constraint linkend: v4l2-dv-tx-mode.
Warning: multiple "IDs" for constraint linkend: v4l2-dv-rgb-range.

Please fix it and re-send.

Thanks!
Mauro


> 
> Regards,
> 
> 	Hans
> 
> > Yet, keeping
> > it broken is a very bad idea, so we should either remove the broken
> > patch or to remove just the invalid include. Let's take the latter
> > approach.
> > 
> > Due to that, a warning is now produced:
> > 
> > Error: no ID for constraint linkend: v4l2-subdev-edid.
> > 
> > Cc: Hans Verkuil <hans.verkuil@cisco.com>
> > Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
> > ---
> >  Documentation/DocBook/media/v4l/v4l2.xml | 1 -
> >  1 file changed, 1 deletion(-)
> > 
> > diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml
> > index 10ccde9..0292ed1 100644
> > --- a/Documentation/DocBook/media/v4l/v4l2.xml
> > +++ b/Documentation/DocBook/media/v4l/v4l2.xml
> > @@ -581,7 +581,6 @@ and discussions on the V4L mailing list.</revremark>
> >      &sub-subdev-enum-frame-size;
> >      &sub-subdev-enum-mbus-code;
> >      &sub-subdev-g-crop;
> > -    &sub-subdev-g-edid;
> >      &sub-subdev-g-fmt;
> >      &sub-subdev-g-frame-interval;
> >      &sub-subdev-g-selection;
> > 
> --
> To unsubscribe from this list: send the line "unsubscribe linux-media" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html

--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

diff --git a/Documentation/DocBook/media/v4l/v4l2.xml b/Documentation/DocBook/media/v4l/v4l2.xml
index 10ccde9..0292ed1 100644
--- a/Documentation/DocBook/media/v4l/v4l2.xml
+++ b/Documentation/DocBook/media/v4l/v4l2.xml
@@ -581,7 +581,6 @@  and discussions on the V4L mailing list.</revremark>
     &sub-subdev-enum-frame-size;
     &sub-subdev-enum-mbus-code;
     &sub-subdev-g-crop;
-    &sub-subdev-g-edid;
     &sub-subdev-g-fmt;
     &sub-subdev-g-frame-interval;
     &sub-subdev-g-selection;