[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <4DF1593A.6080306@oracle.com>
Date: Thu, 09 Jun 2011 16:37:30 -0700
From: Randy Dunlap <randy.dunlap@...cle.com>
To: Mauro Carvalho Chehab <mchehab@...hat.com>
CC: Stephen Rothwell <sfr@...b.auug.org.au>,
linux-media@...r.kernel.org, linux-next@...r.kernel.org,
LKML <linux-kernel@...r.kernel.org>
Subject: Re: linux-next: Tree for June 8 (docbook/media)
On 06/09/11 16:32, Mauro Carvalho Chehab wrote:
> Em 09-06-2011 17:32, Randy Dunlap escreveu:
>> On 06/09/11 12:43, Mauro Carvalho Chehab wrote:
>>> Em 09-06-2011 16:25, Mauro Carvalho Chehab escreveu:
>>>> Em 08-06-2011 16:52, Randy Dunlap escreveu:
>>>>> The DocBook/media/Makefile seems to be causing too much noise:
>>>>>
>>>>> ls: cannot access linux-next-20110608/Documentation/DocBook/media/*/*.gif: No such file or directory
>>>>> ls: cannot access linux-next-20110608/Documentation/DocBook/media/*/*.png: No such file or directory
>>>>>
>>>>> Maybe the cleanmediadocs target could be made silent?
>>>>
>>>> I'll take a look on it.
>>>>
>>>> FYI, The next build will probably be noisier, as it is now pointing to some
>>>> documentation gaps at the DVB API. Those gaps should take a longer time to fix,
>>>> as we need to discuss upstream about what should be done with those API's,
>>>> that seems to be abandoned upstream (only one legacy DVB driver uses them).
>>>> However, I was told that some out-of-tree drivers and some drivers under development
>>>> are using them.
>>>>
>>>> So, I intend to wait until the next merge window before either dropping those
>>>> legacy API specs (or moving them to a deprecated section) or to merge those
>>>> out-of-tree drivers, with the proper documentation updates.
>>>>
>>>>> also, where is the mediaindexdocs target defined?
>>>>
>>>> Thanks for noticing it. We don't need this target anymore. I'll write a patch
>>>> removing it.
>>>
>>> This patch should remove the undesired noise.
>>
>>
>> Doesn't work for me. Did you test it?
>
> Yes:
>
> $ make htmldocs
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//v4l2.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//media-entities.tmpl
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//media-indices.tmpl
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//videodev2.h.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//audio.h.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//ca.h.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//dmx.h.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//frontend.h.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//net.h.xml
> GEN /home/v4l/v4l/patchwork/Documentation/DocBook//video.h.xml
> DOCPROC Documentation/DocBook/media_api.xml
> HTML Documentation/DocBook/media_api.html
> Error: no ID for constraint linkend: AUDIO_GET_PTS.
> Error: no ID for constraint linkend: AUDIO_BILINGUAL_CHANNEL_SELECT.
> Error: no ID for constraint linkend: CA_RESET.
> Error: no ID for constraint linkend: CA_GET_CAP.
> Error: no ID for constraint linkend: CA_GET_SLOT_INFO.
> Error: no ID for constraint linkend: CA_GET_DESCR_INFO.
> Error: no ID for constraint linkend: CA_GET_MSG.
> Error: no ID for constraint linkend: CA_SEND_MSG.
> Error: no ID for constraint linkend: CA_SET_DESCR.
> Error: no ID for constraint linkend: CA_SET_PID.
> Error: no ID for constraint linkend: DMX_GET_PES_PIDS.
> Error: no ID for constraint linkend: DMX_GET_CAPS.
> Error: no ID for constraint linkend: DMX_SET_SOURCE.
> Error: no ID for constraint linkend: DMX_ADD_PID.
> Error: no ID for constraint linkend: DMX_REMOVE_PID.
> Error: no ID for constraint linkend: NET_ADD_IF.
> Error: no ID for constraint linkend: NET_REMOVE_IF.
> Error: no ID for constraint linkend: NET_GET_IF.
> Error: no ID for constraint linkend: VIDEO_GET_SIZE.
> Error: no ID for constraint linkend: VIDEO_GET_FRAME_RATE.
> Error: no ID for constraint linkend: VIDEO_GET_PTS.
> Error: no ID for constraint linkend: VIDEO_GET_FRAME_COUNT.
> Error: no ID for constraint linkend: VIDEO_COMMAND.
> Error: no ID for constraint linkend: VIDEO_TRY_COMMAND.
> rm -rf Documentation/DocBook/index.html; echo '<h1>Linux Kernel HTML Documentation</h1>' >> Documentation/DocBook/index.html && echo '<h2>Kernel Version: 3.0.0-rc1</h2>' >> Documentation/DocBook/index.html && cat Documentation/DocBook/80211.html Documentation/DocBook/alsa-driver-api.html Documentation/DocBook/debugobjects.html Documentation/DocBook/device-drivers.html Documentation/DocBook/deviceiobook.html Documentation/DocBook/drm.html Documentation/DocBook/filesystems.html Documentation/DocBook/gadget.html Documentation/DocBook/genericirq.html Documentation/DocBook/kernel-api.html Documentation/DocBook/kernel-hacking.html Documentation/DocBook/kernel-locking.html Documentation/DocBook/kgdb.html Documentation/DocBook/libata.html Documentation/DocBook/librs.html Documentation/DocBook/lsm.html Documentation/DocBook/mcabook.html Documentation/DocBook/media_api.html Documentation/DocBook/mtdnand.html Documentation/DocBook/networking.html Documentation/DocBook/rapidio.html Doc
um
> entation/DocBook/regulator.html Documentation/DocBook/s390-drivers.html Documentation/DocBook/scsi.html Documentation/DocBook/sh.html Documentation/DocBook/tracepoint.html Documentation/DocBook/uio-howto.html Documentation/DocBook/usb.html Documentation/DocBook/writing-an-alsa-driver.html Documentation/DocBook/writing_usb_driver.html Documentation/DocBook/z8530book.html >> Documentation/DocBook/index.html
> v4l@...ra ~/v4l/patchwork $ make cleandocs
> make[1]: [cleanmediadocs] Erro 1 (ignorado)
> v4l@...ra ~/v4l/patchwork $ make cleanmediadocs
> make[1]: [cleanmediadocs] Erro 1 (ignorado)
>
> (the above linkend errors are due to the lack of documentation for those ioctls, as I've
> explained before).
>
>>
>> Even this does not silence the noise for me:
>>
>> cleanmediadocs:
>> -@rm `find $(MEDIA_OBJ_DIR) -type l` $(GENFILES) $(IMGFILES) >/dev/null 2>&1
>
> Weird.
> The errors should be doing to stderr, so 2>/dev/null should be working.
Big hint: I see these errors not during "make htmldocs" but during a kernel code build
when CONFIG_BUILD_DOCSRC=y.
Sorry, I should have mentioned this earlier.
--
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
Powered by blists - more mailing lists