Hi all,
After merging the usb tree, today's linux-next build (htmldocs) produced
this warning:
Documentation/ABI/testing/configfs-usb-gadget-uac2:2: WARNIN
G: Malformed table.
Text in column margin in table line 27.
===================== =======================================
c_chmask capture channel mask
c_srate capture sampling rate
c_ssize capture sample size (bytes)
c_sync capture synchronization type
(async/adaptive)
c_mute_present capture mute control enable
c_volume_present capture volume control enable
c_volume_min capture volume control min value
(in 1/256 dB)
c_volume_max capture volume control max value
(in 1/256 dB)
c_volume_res capture volume control resolution
(in 1/256 dB)
fb_max maximum extra bandwidth in async mode
p_chmask playback channel mask
p_srate playback sampling rate
p_ssize playback sample size (bytes)
p_mute_present playback mute control enable
p_volume_present playback volume control enable
_volume_present playback volume control enable
p_volume_min playback volume control min value
(in 1/256 dB)
p_volume_max playback volume control max value
(in 1/256 dB)
p_volume_res playback volume control resolution
(in 1/256 dB)
req_number the number of pre-allocated requests for both capture
and playback
===================== =======================================
Introduced by commit
e3088ebc1b97 ("docs: ABI: added missing num_requests param to UAC2")
--
Cheers,
Stephen Rothwell
On Fri, Jan 07, 2022 at 02:48:15AM +1100, Stephen Rothwell wrote:
> Hi all,
>
> After merging the usb tree, today's linux-next build (htmldocs) produced
> this warning:
>
> Documentation/ABI/testing/configfs-usb-gadget-uac2:2: WARNIN
> G: Malformed table.
> Text in column margin in table line 27.
>
> ===================== =======================================
> c_chmask capture channel mask
> c_srate capture sampling rate
> c_ssize capture sample size (bytes)
> c_sync capture synchronization type
> (async/adaptive)
> c_mute_present capture mute control enable
> c_volume_present capture volume control enable
> c_volume_min capture volume control min value
> (in 1/256 dB)
> c_volume_max capture volume control max value
> (in 1/256 dB)
> c_volume_res capture volume control resolution
> (in 1/256 dB)
> fb_max maximum extra bandwidth in async mode
> p_chmask playback channel mask
> p_srate playback sampling rate
> p_ssize playback sample size (bytes)
> p_mute_present playback mute control enable
> p_volume_present playback volume control enable
> _volume_present playback volume control enable
> p_volume_min playback volume control min value
> (in 1/256 dB)
> p_volume_max playback volume control max value
> (in 1/256 dB)
> p_volume_res playback volume control resolution
> (in 1/256 dB)
> req_number the number of pre-allocated requests for both capture
> and playback
> ===================== =======================================
>
> Introduced by commit
>
> e3088ebc1b97 ("docs: ABI: added missing num_requests param to UAC2")
>
Pavel, can you send a follow-on patch to fix this up?
thanks,
greg k-h
Dne 06. 01. 22 v 17:10 Greg KH napsal(a):
> On Fri, Jan 07, 2022 at 02:48:15AM +1100, Stephen Rothwell wrote:
>> Hi all,
>>
>> After merging the usb tree, today's linux-next build (htmldocs) produced
>> this warning:
>>
>> Documentation/ABI/testing/configfs-usb-gadget-uac2:2: WARNIN
>> G: Malformed table.
>> Text in column margin in table line 27.
>>
>> ===================== =======================================
>> c_chmask capture channel mask
>> c_srate capture sampling rate
>> c_ssize capture sample size (bytes)
>> c_sync capture synchronization type
>> (async/adaptive)
>> c_mute_present capture mute control enable
>> c_volume_present capture volume control enable
>> c_volume_min capture volume control min value
>> (in 1/256 dB)
>> c_volume_max capture volume control max value
>> (in 1/256 dB)
>> c_volume_res capture volume control resolution
>> (in 1/256 dB)
>> fb_max maximum extra bandwidth in async mode
>> p_chmask playback channel mask
>> p_srate playback sampling rate
>> p_ssize playback sample size (bytes)
>> p_mute_present playback mute control enable
>> p_volume_present playback volume control enable
>> _volume_present playback volume control enable
>> p_volume_min playback volume control min value
>> (in 1/256 dB)
>> p_volume_max playback volume control max value
>> (in 1/256 dB)
>> p_volume_res playback volume control resolution
>> (in 1/256 dB)
>> req_number the number of pre-allocated requests for both capture
>> and playback
>> ===================== =======================================
>>
>> Introduced by commit
>>
>> e3088ebc1b97 ("docs: ABI: added missing num_requests param to UAC2")
>>
>
> Pavel, can you send a follow-on patch to fix this up?
>
Greg, sorry for the inconvenience, of course I will do so. Please can
you point me to some doc describing the correct ABI format? There are
varying numbers of tabs in those files.
Thanks a lot,
Pavel.
On Fri, Jan 07, 2022 at 11:02:34AM +0100, Pavel Hofman wrote:
>
> Dne 06. 01. 22 v 17:10 Greg KH napsal(a):
> > On Fri, Jan 07, 2022 at 02:48:15AM +1100, Stephen Rothwell wrote:
> > > Hi all,
> > >
> > > After merging the usb tree, today's linux-next build (htmldocs) produced
> > > this warning:
> > >
> > > Documentation/ABI/testing/configfs-usb-gadget-uac2:2: WARNIN
> > > G: Malformed table.
> > > Text in column margin in table line 27.
> > >
> > > ===================== =======================================
> > > c_chmask capture channel mask
> > > c_srate capture sampling rate
> > > c_ssize capture sample size (bytes)
> > > c_sync capture synchronization type
> > > (async/adaptive)
> > > c_mute_present capture mute control enable
> > > c_volume_present capture volume control enable
> > > c_volume_min capture volume control min value
> > > (in 1/256 dB)
> > > c_volume_max capture volume control max value
> > > (in 1/256 dB)
> > > c_volume_res capture volume control resolution
> > > (in 1/256 dB)
> > > fb_max maximum extra bandwidth in async mode
> > > p_chmask playback channel mask
> > > p_srate playback sampling rate
> > > p_ssize playback sample size (bytes)
> > > p_mute_present playback mute control enable
> > > p_volume_present playback volume control enable
> > > _volume_present playback volume control enable
> > > p_volume_min playback volume control min value
> > > (in 1/256 dB)
> > > p_volume_max playback volume control max value
> > > (in 1/256 dB)
> > > p_volume_res playback volume control resolution
> > > (in 1/256 dB)
> > > req_number the number of pre-allocated requests for both capture
> > > and playback
> > > ===================== =======================================
> > >
> > > Introduced by commit
> > >
> > > e3088ebc1b97 ("docs: ABI: added missing num_requests param to UAC2")
> > >
> >
> > Pavel, can you send a follow-on patch to fix this up?
> >
>
> Greg, sorry for the inconvenience, of course I will do so. Please can you
> point me to some doc describing the correct ABI format? There are varying
> numbers of tabs in those files.
I don't know, try the build yourself and see what works!
greg k-h