linux/Documentation/DocBook
Randy Dunlap 3794f3e812 docsrc: build Documentation/ sources
Currently source files in the Documentation/ sub-dir can easily bit-rot
since they are not generally buildable, either because they are hidden in
text files or because there are no Makefile rules for them.  This needs to
be fixed so that the source files remain usable and good examples of code
instead of bad examples.

Add the ability to build source files that are in the Documentation/ dir.
Add to Kconfig as "BUILD_DOCSRC" config symbol.

Use "CONFIG_BUILD_DOCSRC=1 make ..." to build objects from the
Documentation/ sources.  Or enable BUILD_DOCSRC in the *config system.
However, this symbol depends on HEADERS_CHECK since the header files need
to be installed (for userspace builds).

Built (using cross-tools) for x86-64, i386, alpha, ia64, sparc32,
sparc64, powerpc, sh, m68k, & mips.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Reviewed-by: Sam Ravnborg <sam@ravnborg.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2008-08-12 16:07:30 -07:00
..
.gitignore [PATCH] DocBook: add .gitignore file 2006-01-10 08:01:52 -08:00
debugobjects.tmpl debugobjects: add documentation 2008-04-30 08:29:53 -07:00
deviceiobook.tmpl Add recommended section IDs to deviceiobook.tmpl 2007-10-17 08:43:07 -07:00
filesystems.tmpl docbook: move pipe and splice to filesystems docbook 2008-02-13 16:21:19 -08:00
gadget.tmpl usb gadget serial: split out generic serial function 2008-07-21 15:16:07 -07:00
genericirq.tmpl Add missing section IDs to genericirq.tmpl 2008-02-07 08:42:16 -08:00
kernel-api.tmpl docbook: fix bitops fatal filename error 2008-04-28 10:26:51 -07:00
kernel-hacking.tmpl docbook/kernel-hacking: fixup x86 path/file names 2007-10-13 09:52:26 -07:00
kernel-locking.tmpl Remove mention of semaphores from kernel-locking 2008-07-24 08:29:40 -04:00
kgdb.tmpl kgdb: fix kgdb_validate_break_address to perform a mem write 2008-08-01 08:39:34 -05:00
libata.tmpl [SCSI] libsas: fix scr_read/write users and update the libata documentation 2007-07-20 15:52:08 -05:00
librs.tmpl docbook: librs typo fixes 2007-05-08 11:15:15 -07:00
lsm.tmpl Add missing section ID to lsm.tmpl 2008-02-07 08:42:16 -08:00
mac80211.tmpl mac80211: add documentation book 2008-03-06 15:30:47 -05:00
Makefile docsrc: build Documentation/ sources 2008-08-12 16:07:30 -07:00
mcabook.tmpl docbook/mcabook: fixup x86 path/file names 2007-10-13 09:52:26 -07:00
mtdnand.tmpl Add section IDs to mtdnand.tmpl 2008-02-07 08:42:16 -08:00
networking.tmpl docbook: make a networking book and fix a few errors 2008-02-13 16:21:19 -08:00
procfs_example.c Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
procfs-guide.tmpl procfs-guide: drop pointless &nbsp; entities 2008-07-25 10:53:35 -07:00
rapidio.tmpl docbook: fix fatal rapidio yet again (and more to come) 2008-04-29 20:40:00 -07:00
s390-drivers.tmpl docbook: fix s390 fatal error after header files moved 2008-08-05 16:56:29 -07:00
scsi.tmpl [SCSI] update my email address 2008-02-07 18:02:42 -06:00
sh.tmpl sh: Add documentation and integrate into docbook build. 2008-08-04 12:53:55 +09:00
stylesheet.xsl [PATCH] DocBook/HTML: Generate chapter/section level TOCs for functions 2007-02-11 10:51:30 -08:00
uio-howto.tmpl uio-howto.tmpl: use unique output names 2008-07-21 21:54:58 -07:00
usb.tmpl USB: remove usb DocBook warnings 2007-05-22 23:45:48 -07:00
videobook.tmpl docbook: fix v4l fatal filename error 2008-08-06 10:32:49 -07:00
wanbook.tmpl Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
writing_usb_driver.tmpl DOC: A couple corrections and clarifications in USB doc. 2008-04-21 22:57:50 +00:00
z8530book.tmpl WAN: don't mention syncppp in z8530 DocBook. 2008-07-23 23:05:56 +02:00