Dan Streetman
6e099f557d
Documentation: expand/clarify debug documentation
...
The pr_debug() and related debug print macros all differ from the normal
pr_XXX() macros, in that the normal ones print unconditionally, while
the debug macros are compiled out unless DEBUG is defined or
CONFIG_DYNAMIC_DEBUG is set. This isn't obvious, and the only way to
find this out is either to review the actual printk.h code or to read
CodingStyle, and the message there doesn't highlight the fact.
Change Documentation/CodingStyle to clearly indicate that pr_debug() and
related debug printing macros behave differently than all other pr_XXX()
macros, and attempt to clarify when and where the different debug
printing methods might be used.
Add short comment to printk.h above the pr_XXX() macros indicating that
while these macros print unconditionally, pr_debug() does not.
Signed-off-by: Dan Streetman <ddstreet@ieee.org>
Cc: Joe Perches <joe@perches.com>
Cc: Fabian Frederick <fabf@skynet.be>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2014-06-04 16:54:17 -07:00
..
ABI
ACPI and power management updates for 3.16-rc1
2014-06-04 08:57:16 -07:00
accounting
acpi
Documentation / ACPI: Fix location of GPIO documentation
2014-05-23 14:39:26 +02:00
aoe
arm
Despite relatively young Berlin SoC support, we already have support
2014-05-26 13:41:02 -07:00
arm64
- Documentation clarification on CPU topology and booting requirements
2014-04-08 12:06:03 -07:00
auxdisplay
backlight
blackfin
block
blockdev
zram: propagate error to user
2014-04-07 16:36:02 -07:00
bus-devices
cdrom
cgroups
Documentation/memcg: warn about incomplete kmemcg state
2014-06-04 16:54:00 -07:00
connector
w1: optional bundling of netlink kernel replies
2014-05-27 13:56:21 -07:00
console
cpu-freq
PM / OPP: Move cpufreq specific OPP functions out of generic OPP library
2014-05-07 00:39:03 +02:00
cpuidle
cris
crypto
development-process
device-mapper
dm thin: add 'no_space_timeout' dm-thin-pool module param
2014-05-20 14:30:36 -04:00
devicetree
DeviceTree for 3.16:
2014-06-04 10:02:38 -07:00
DocBook
USB driver patches for 3.16-rc1
2014-06-03 09:11:20 -07:00
driver-model
Staging driver patches for 3.16-rc1
2014-06-03 08:34:00 -07:00
dvb
early-userspace
EDID
extcon
fault-injection
fb
doc: spelling error changes
2014-05-05 15:32:05 +02:00
filesystems
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
firmware_class
fmc
frv
gpio
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
hid
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
hwmon
New driver for NCT6683D
2014-06-03 11:09:43 -07:00
i2c
Documentation: i2c: improve section about flags mangling the protocol
2014-04-06 13:53:48 +02:00
i2o
ia64
ide
infiniband
input
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
ioctl
isdn
ja_JP
Documentation: Update stable address in Chinese and Japanese translations
2014-04-16 14:13:27 -07:00
kbuild
kconfig: make allnoconfig disable options behind EMBEDDED and EXPERT
2014-04-07 16:36:09 -07:00
kdump
ko_KR
laptops
leds
m68k
make
memory-devices
metag
mic
mips
misc-devices
mmc
mn10300
mtd
doc: spelling error changes
2014-05-05 15:32:05 +02:00
namespaces
netlabel
networking
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
nfc
parisc
PCI
pcmcia
phy
power
Merge branch 'pm-cpufreq'
2014-06-03 23:13:20 +02:00
powerpc
doc: spelling error changes
2014-05-05 15:32:05 +02:00
pps
prctl
pti
ptp
rapidio
rapidio: rework device hierarchy and introduce mport class of devices
2014-04-07 16:36:07 -07:00
RCU
documentation: Update API documentation
2014-04-29 08:38:53 -07:00
s390
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
scheduler
asm/system.h: clean asm/system.h from docs
2014-04-07 16:36:11 -07:00
scsi
security
doc: spelling error changes
2014-05-05 15:32:05 +02:00
serial
tty/serial: Add GPIOLIB helpers for controlling modem lines
2014-05-28 12:49:14 -07:00
sh
sound
doc: spelling error changes
2014-05-05 15:32:05 +02:00
spi
sysctl
Documentation/sysctl/vm.txt: clarify vfs_cache_pressure description
2014-06-04 16:54:13 -07:00
target
thermal
timers
tpm
trace
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
usb
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
vDSO
video4linux
virtual
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
vm
mm/memory-failure.c: support use of a dedicated thread to handle SIGBUS(BUS_MCEERR_AO)
2014-06-04 16:54:13 -07:00
w1
w1: optional bundling of netlink kernel replies
2014-05-27 13:56:21 -07:00
watchdog
wimax
x86
doc: spelling error changes
2014-05-05 15:32:05 +02:00
xtensa
zh_CN
driver core fixes for 3.15-rc2
2014-04-18 16:59:52 -07:00
.gitignore
00-INDEX
Merge branch 'x86-nuke-platforms-for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip
2014-04-02 13:15:58 -07:00
applying-patches.txt
assoc_array.txt
atomic_ops.txt
arch,doc: Convert smp_mb__*()
2014-04-18 14:20:48 +02:00
bad_memory.txt
basic_profiling.txt
bcache.txt
binfmt_misc.txt
braille-console.txt
bt8xxgpio.txt
btmrvl.txt
BUG-HUNTING
bus-virt-phys-mapping.txt
cachetlb.txt
Changes
doc: Note need of bc in the kernel build from 3.10 onwards
2014-05-19 16:27:20 +02:00
circular-buffers.txt
clk.txt
coccinelle.txt
CodingStyle
Documentation: expand/clarify debug documentation
2014-06-04 16:54:17 -07:00
cpu-hotplug.txt
cpu-load.txt
cputopology.txt
crc32.txt
dcdbas.txt
debugging-modules.txt
debugging-via-ohci1394.txt
firewire: revert to 4 GB RDMA, fix protocols using Memory Space
2014-05-29 15:50:30 +02:00
dell_rbu.txt
devices.txt
Merge branch 'v4l_for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media
2014-04-04 09:50:07 -07:00
digsig.txt
DMA-API-HOWTO.txt
DMA-API: Update dma_pool_create ()and dma_pool_alloc() descriptions
2014-05-26 17:28:28 -06:00
DMA-API.txt
DMA-API: Capitalize "CPU" consistently
2014-05-26 17:28:27 -06:00
DMA-attributes.txt
doc: spelling error changes
2014-05-05 15:32:05 +02:00
dma-buf-sharing.txt
doc: spelling error changes
2014-05-05 15:32:05 +02:00
DMA-ISA-LPC.txt
DMA-API: Clarify physical/bus address distinction
2014-05-20 16:54:21 -06:00
dmaengine.txt
dmatest.txt
dontdiff
Documentation: LLVMLinux: Update Documentation/dontdiff
2014-04-09 13:44:34 -07:00
dynamic-debug-howto.txt
doc: spelling error changes
2014-05-05 15:32:05 +02:00
edac.txt
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial into next
2014-06-04 08:50:34 -07:00
efi-stub.txt
eisa.txt
email-clients.txt
Documentation: update thunderbird email client settings
2014-05-25 12:39:00 -07:00
flexible-arrays.txt
futex-requeue-pi.txt
gcov.txt
highuid.txt
HOWTO
hsi.txt
Documentation: HSI: Add some general description for the HSI subsystem
2014-05-04 09:49:46 +02:00
hw_random.txt
hwspinlock.txt
init.txt
initrd.txt
Intel-IOMMU.txt
intel_txt.txt
io-mapping.txt
io_ordering.txt
iostats.txt
IPMI.txt
IRQ-affinity.txt
IRQ-domain.txt
IRQ.txt
irqflags-tracing.txt
asm/system.h: clean asm/system.h from docs
2014-04-07 16:36:11 -07:00
isapnp.txt
java.txt
Documentation: update java sample wrapper for java 7
2014-05-25 12:39:00 -07:00
kernel-doc-nano-HOWTO.txt
kernel-docs.txt
kernel-parameters.txt
cma: add placement specifier for "cma=" kernel parameter
2014-06-04 16:53:57 -07:00
kernel-per-CPU-kthreads.txt
kmemcheck.txt
kmemleak.txt
Documentation/kmemleak.txt: updates
2014-04-03 16:21:27 -07:00
kobject.txt
kprobes.txt
kref.txt
ldm.txt
local_ops.txt
lockdep-design.txt
lockstat.txt
lockup-watchdogs.txt
logo.gif
logo.txt
magic-number.txt
Documentation/serial: Delete obsolete driver documentation
2014-04-16 14:20:34 -07:00
Makefile
ManagementStyle
md.txt
media-framework.txt
memory-barriers.txt
arch,doc: Convert smp_mb__*()
2014-04-18 14:20:48 +02:00
memory-hotplug.txt
memory-hotplug: update documentation to hide information about SECTIONS and remove end_phys_index
2014-06-04 16:53:58 -07:00
module-signing.txt
Nothing major: the stricter permissions checking for sysfs broke
2014-04-06 09:38:07 -07:00
mono.txt
mutex-design.txt
nommu-mmap.txt
numastat.txt
oops-tracing.txt
padata.txt
parport-lowlevel.txt
parport.txt
percpu-rw-semaphore.txt
phy.txt
pi-futex.txt
pinctrl.txt
pnp.txt
preempt-locking.txt
printk-formats.txt
doc: printk-formats: do not mention casts for u64/s64
2014-05-05 15:32:42 +02:00
pwm.txt
ramoops.txt
rbtree.txt
doc: spelling error changes
2014-05-05 15:32:05 +02:00
remoteproc.txt
rfkill.txt
doc: spelling error changes
2014-05-05 15:32:05 +02:00
robust-futex-ABI.txt
robust-futexes.txt
doc: spelling error changes
2014-05-05 15:32:05 +02:00
rpmsg.txt
rt-mutex-design.txt
rt-mutex.txt
rtc.txt
SAK.txt
SecurityBugs
serial-console.txt
sgi-ioc4.txt
SM501.txt
smsc_ece1099.txt
sparse.txt
spinlocks.txt
stable_api_nonsense.txt
stable_kernel_rules.txt
stable_kernel_rules: spelling/word usage
2014-04-16 14:13:26 -07:00
static-keys.txt
SubmitChecklist
SubmittingDrivers
SubmittingPatches
Documentation/SubmittingPatches: update some dead URLs
2014-04-03 16:21:27 -07:00
svga.txt
sysfs-rules.txt
sysrq.txt
this_cpu_ops.txt
unaligned-memory-access.txt
unicode.txt
unshare.txt
vfio.txt
VGA-softcursor.txt
vgaarbiter.txt
video-output.txt
vme_api.txt
volatile-considered-harmful.txt
workqueue.txt
ww-mutex-design.txt
xz.txt
zorro.txt