Skip to contentSkip to conversation

Can not generate ALSA driver documentation via Makefile

DISCUSSION Robin Steven 2 participants 3 messages Dec 19, 2009

lore
Share & tools
lore
#0 lore raw

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

#1 lore raw
Quoted 7 lines · 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:

Quoted 7 lines
$ 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

#2 lore raw

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

Quoted 28 lines · Randy Dunlap
Quoted 7 lines · 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:

Quoted 7 lines
$ 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