Instead of having the kernel-doc usage in both comments and in output to
the user, merge them all to one here document. While at it, imrove the
text and make it pretty. Give shoemaker's children some shoes.
Signed-off-by: NJani Nikula <jani.nikula@intel.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

sysrq.c moved to drivers/tty in 2010; update the documentation to match.
Signed-off-by: NRené Nyffenegger <mail@renenyffenegger.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

This fixes several spelling mistakes in the Documentation/ tree, which
are caught by checkpatch.pl's spell checking.
Signed-off-by: NKees Cook <keescook@chromium.org>
Reviewed-by: NPaul E. McKenney <paulmck@linux.vnet.ibm.com>
Acked-by: NRandy Dunlap <rdunlap@infradead.org>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

A small bug with the new autoksyms support showed that there are
two kernel modules in the Documentation directory that qualify
as samples, while all other samples are in the samples/ directory.

This patch was originally meant as a workaround for that bug, but
it has now been solved in a different way. However, I still think
it makes sense as a cleanup to consolidate all sample code in
one place.
Signed-off-by: NArnd Bergmann <arnd@arndb.de>
Acked-by: NHans Verkuil <hans.verkuil@cisco.com>
Acked-by: NMauro Carvalho Chehab <mchehab@osg.samsung.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

A small bug with the new autoksyms support showed that there are
two kernel modules in the Documentation directory that qualify
as samples, while all other samples are in the samples/ directory.

This patch was originally meant as a workaround for that bug, but
it has now been solved in a different way. However, I still think
it makes sense as a cleanup to consolidate all sample code in
one place.
Signed-off-by: NArnd Bergmann <arnd@arndb.de>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
[jc: fixed trailing whitespace errors]
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NEric Engestrom <eric@engestrom.ch>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

devm_input_allocate_device() got introduced with commit 2be975c6
("Input: introduce managed input devices (add devres support)").
Add this function to the list of managed interfaces within the
devres documentation.
Signed-off-by: NAlexander Kurz <akurz@blala.de>
Acked-by: NTejun Heo <tj@kernel.org>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

This is a update of Chinese documentation: Documentation/zh_CN/arm64/booting.txt

It is based on the modifications of Documentation/arm64/booting.txt in submission:
"a7f8de16".
Signed-off-by: NFu Wei <wefu@redhat.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

It has:
a tense correction(led->leads);
a typo(unevitably->inevitably);
Signed-off-by: NCao jin <caoj.fnst@cn.fujitsu.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NAskar Safin <safinaskar@mail.ru>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Homepage url of git in HOWTO document was updated by commit
e234ebf7 ("Documentation/HOWTO: update
git home URL") but not applied to several translations.  This commit
updates them.
Signed-off-by: NSeongJae Park <sj38.park@gmail.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Obsolete info about regression postings were removed by commit
5645a717 ("Documentation: HOWTO: remove
obsolete info about regression postings") but not applied to
translations.  This commit applies the change to translations.
Signed-off-by: NSeongJae Park <sj38.park@gmail.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

break_ctl() is not called from any sort of atomic context, so there is no
problem with it sleeping.
Reported-by: NPeter Hurley <peter@hurleysoftware.com>
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Document that .(un)throttle() are serialized with each other, and with
termios modification by the tty layer.
Reported-by: NPeter Hurley <peter@hurleysoftware.com>
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Document that .throttle() and .unthrottle() are relevant only if
hardware assisted flow control is enabled.
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Commit 834392a7 ("serial: doc: Un-document non-existing
uart_write_console()") removed a paragraph about a helper function that
seemed to never exist.

Peter Hurley pointed out that the function does exist, but is called
differently. Re-add the paragraph, with the function name corrected.

Fixes: 834392a7 ("serial: doc: Un-document non-existing uart_write_console()")
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

The correct value 17 can be found later in this document
and in the kernel-page-flags.h header (KPF_HUGE). I noticed
this while implementing vmprobe's kpageflags support.
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

It tries to "match" drivers for each interface (not "much").
Signed-off-by: NDiego Herranz <diegoherranz@diegoherranz.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NDiego Viola <diego.viola@gmail.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

The URL for "Writing Linux Device Drivers" hasn't been available in some
time. Updating the entry to Michael K. Johnson's "Linux Kernel Hackers'
Guide"
Signed-off-by: NLuis de Bethencourt <luisbg@osg.samsung.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Note that mutex_lock() should not be called with interrupts disabled.
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

uart_info.tmpbuf and uart_info.tmpbuf_sem were removed in v2.6.10, in
full-history-linux commit a797ad7e3ae9cad4 ("[SERIAL] Clean up
serial_core.c write functions.").
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

uart_write_console() never existed, not even when the "new
uart_write_console function" was documented.

Fixes: 67ab7f59 ("[SERIAL] Update serial driver documentation")
Signed-off-by: NGeert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

This patch introduces one mmc test tools called mmc-utils, which is convenient
if someone wants to exercise and test MMC/SD devices from userspace.
Signed-off-by: NBaolin Wang <baolin.wang@linaro.org>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Current URL for "Kernel API changes from 2.0 to 2.2" hasn't been available
for some time, updating. The second article about changes from 2.2 to 2.4
is missing a URL, adding it.
Signed-off-by: NLuis de Bethencourt <luisbg@osg.samsung.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

The current URL has been down for some time, updating it to a working one.
Signed-off-by: NLuis de Bethencourt <luisbg@osg.samsung.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

The Linux Kernel Development book by Robert Love has been recommended to me
by multiple kernel hackers. Worth having in the list of books in
kernel-docs.txt for newbies looking for good learning resources.
Signed-off-by: NLuis de Bethencourt <luisbg@osg.samsung.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Update missing index files in block/00-INDEX.
Signed-off-by: NWei Fang <fangwei1@huawei.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>