linux-toradex.git/Documentation/DocBook/Makefile, branch v3.16-rc7

documentation: docbook: document process of writing an musb glue layer

2014-05-12T17:34:47+00:00

Document the process of writing an musb glue layer by taking the
Ingenic JZ4740 glue layer as an example, as it seems more simple than
most glue layers due to the basic feature set of the JZ4740 USB device
controller.

Signed-off-by: Apelete Seketeli 
Signed-off-by: Felipe Balbi

Merge branch 'kbuild' of git://git.kernel.org/pub/scm/linux/kernel/git/mmarek/kbuild

2014-04-08T00:52:31+00:00

Pull kbuild changes from Michal Marek:
 - cleanups in the main Makefiles and Documentation/DocBook/Makefile
 - make O=...  directory is automatically created if needed
 - mrproper/distclean removes the old include/linux/version.h to make
   life easier when bisecting across the commit that moved the version.h
   file

* 'kbuild' of git://git.kernel.org/pub/scm/linux/kernel/git/mmarek/kbuild:
  kbuild: docbook: fix the include error when executing "make help"
  kbuild: create a build directory automatically for out-of-tree build
  kbuild: remove redundant '.*.cmd' pattern from make distclean
  kbuild: move "quote" to Kbuild.include to be consistent
  kbuild: docbook: use $(obj) and $(src) rather than specific path
  kbuild: unconditionally clobber include/linux/version.h on distclean
  kbuild: docbook: specify KERNELDOC dependency correctly
  kbuild: docbook: include cmd files more simply
  kbuild: specify build_docproc as a phony target

kbuild: docbook: fix the include error when executing "make help"

2014-04-01T08:49:21+00:00

The commit ec3fadd64b99 (kbuild: docbook: use $(obj) and $(src) rather
than specific path) replaces the specific path with $(src). But when
executing "make help", the $(src) is null and then causes an include
error. Fix it by restoring the specific path.

Signed-off-by: Kevin Hao 
Signed-off-by: Michal Marek

kbuild: docbook: use $(obj) and $(src) rather than specific path

2014-03-29T20:30:17+00:00

Signed-off-by: Masahiro Yamada 
Signed-off-by: Michal Marek

kbuild: docbook: specify KERNELDOC dependency correctly

2014-03-14T17:06:47+00:00

It is not a good idea to describe

  %.xml: %.tmpl FORCE
    ...

and

  $(BOOKS): $(KERNELDOC)

separately. This cannot detect missing template files.

For example, add something to DOCBOOKS variable:
  DOCBOOKS += foobar.xml
and run
  make xmldocs

It will succeed even if Documention/DocBook/foobar.tmpl
does not exist.

Signed-off-by: Masahiro Yamada 
Signed-off-by: Michal Marek

kbuild: docbook: include cmd files more simply

2014-03-14T17:06:47+00:00

Signed-off-by: Masahiro Yamada 
Signed-off-by: Michal Marek

w1: format for DocBook and fixes

2014-02-07T23:40:18+00:00

Switch the code documentation format style to DocBook format, enable
DocBook documentation generation, and fix some comments.

Signed-off-by: David Fries 
Acked-by: Evgeniy Polyakov 
Signed-off-by: Greg Kroah-Hartman

DocBook: Make mandocs parallel-safe

2013-12-02T13:46:37+00:00

Two concurrent calls to cmd_db2man may attempt to compress manual
pages generated by each other.  gzip can then fail due to an input
file having already been compressed and removed.

Move the gzip command to the top-level mandocs target.

Signed-off-by: Ben Hutchings 
Cc: Bastian Blank 
Acked-by: Rob Landley 
Signed-off-by: Jiri Kosina

work around xmlto bug in htmldocs

2013-12-02T13:45:58+00:00

Trying to generate xhtml causes all functions to show up with a prefix
of "fsfunc" in the output, so just back off to html until someone
fixes the toolchain.

Note that this is not a problem with kernel-doc, it's an issue with
however "xmlto" renders xhtml output.

Signed-off-by: Robert P. J. Day 
Acked-by: Rob Landley 
Signed-off-by: Jiri Kosina

MCA: delete all remaining traces of microchannel bus support.

2012-05-17T23:06:13+00:00

Hardware with MCA bus is limited to 386 and 486 class machines
that are now 20+ years old and typically with less than 32MB
of memory.  A quick search on the internet, and you see that
even the MCA hobbyist/enthusiast community has lost interest
in the early 2000 era and never really even moved ahead from
the 2.4 kernels to the 2.6 series.

This deletes anything remaining related to CONFIG_MCA from core
kernel code and from the x86 architecture.  There is no point in
carrying this any further into the future.

One complication to watch for is inadvertently scooping up
stuff relating to machine check, since there is overlap in
the TLA name space (e.g. arch/x86/boot/mca.c).

Cc: Thomas Gleixner 
Cc: James Bottomley 
Cc: x86@kernel.org
Acked-by: Ingo Molnar 
Acked-by: H. Peter Anvin 
Signed-off-by: Paul Gortmaker