2009-12-19 10:14:35

by Robin Steven

Subject: Can not generate ALSA driver documentation via Makefile

Hi, guy:

I am hacking ALSA driver for my customized board, and want to study
the document "writing_an_alsa_driver" in
"Documentation/sound/alsa/DocBook", in the top directory of kernel
source and run:

$ make htmldocs

I can get all the html format document in "Documentation/DocBook", and
no any html document in
"Documentation/sound/alsa/DocBook" was converted for .tmpl to html.

Thanks in advenced for any one can give me any idea!

= Robin

2009-12-19 18:22:07

by Randy Dunlap

Subject: Re: Can not generate ALSA driver documentation via Makefile

On Sat, 19 Dec 2009 18:14:33 +0800 Robin Steven wrote:

> Hi, guy:
>
> I am hacking ALSA driver for my customized board, and want to study
> the document "writing_an_alsa_driver" in
> "Documentation/sound/alsa/DocBook", in the top directory of kernel
> source and run:
>
> $ make htmldocs
>
> I can get all the html format document in "Documentation/DocBook", and
> no any html document in
> "Documentation/sound/alsa/DocBook" was converted for .tmpl to html.
>
> Thanks in advenced for any one can give me any idea!

I guess it depends on what kernel version you are trying to use
(and you omitted that info).

With 2.6.32-git14, I see all of the input & generated alsa files
under Documentation/DocBook/, including "writing_an_alsa_driver".

Can you try a more recent (or current) kernel version?

---
~Randy

2009-12-19 18:46:22

by Robin Steven

Subject: Re: Can not generate ALSA driver documentation via Makefile

Thanks, Dunlap:

Sorry for my negligence! the issue is on default kernel version 2.6.28
of my target embedded board,
now I get the document "writing-an-alsa-driver.html" via my Linux host
gentoo, it currently use
Kernel 2.6.31-gentoo-r31.

Best regard !

= Robin

On Sun, Dec 20, 2009 at 2:22 AM, Randy Dunlap <[email protected]> wrote:
> On Sat, 19 Dec 2009 18:14:33 +0800 Robin Steven wrote:
>
>> Hi, guy:
>>
>> I am hacking ALSA driver for my customized board, and want to study
>> the document "writing_an_alsa_driver" in
>> "Documentation/sound/alsa/DocBook", in the top directory of kernel
>> source and run:
>>
>> $ make htmldocs
>>
>> I can get all the html format document in "Documentation/DocBook", and
>> no any html document in
>> "Documentation/sound/alsa/DocBook" was converted for .tmpl to html.
>>
>> Thanks in advenced for any one can give me any idea!
>
> I guess it depends on what kernel version you are trying to use
> (and you omitted that info).
>
> With 2.6.32-git14, I see all of the input & generated alsa files
> under Documentation/DocBook/, including "writing_an_alsa_driver".
>
> Can you try a more recent (or current) kernel version?
>
> ---
> ~Randy
>