Dan Williams d5934e7631 cleanup: Add usage and style documentation ... When proposing that PCI grow some new cleanup helpers for pci_dev_put() and pci_dev_{lock,unlock} [1], Bjorn had some fundamental questions about expectations and best practices. Upon reviewing an updated changelog with those details he recommended adding them to documentation in the header file itself. Add that documentation and link it into the rendering for Documentation/core-api/. Signed-off-by: Dan Williams <dan.j.williams@intel.com> Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org> Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Reviewed-by: Kevin Tian <kevin.tian@intel.com> Link: https://lore.kernel.org/r/171175585714.2192972.12661675876300167762.stgit@dwillia2-xfh.jf.intel.com		2024-08-05 16:54:41 +02:00
..
ABI	Networking changes for 6.11. Not much excitement - a handful of large	2024-07-16 19:28:34 -07:00
accel
accounting
admin-guide	Scheduler changes for v6.11:	2024-07-16 17:00:50 -07:00
arch	- Add support for running the kernel in a SEV-SNP guest, over a Secure	2024-07-16 11:12:25 -07:00
block	block: fix spelling and grammar for in writeback_cache_control.rst	2024-06-20 06:53:14 -06:00
bpf	bpf, docs: Address comments from IETF Area Directors	2024-06-23 09:10:26 -07:00
cdrom	scsi: sr: Fix unintentional arithmetic wraparound	2024-05-15 10:05:24 -04:00
core-api	cleanup: Add usage and style documentation	2024-08-05 16:54:41 +02:00
cpu-freq
crypto
dev-tools	linux_kselftest-next-6.11-rc1	2024-07-16 17:45:33 -07:00
devicetree	Networking changes for 6.11. Not much excitement - a handful of large	2024-07-16 19:28:34 -07:00
doc-guide	doc: fix spelling about ReStructured Text	2024-04-02 10:07:51 -06:00
driver-api	spi: Updates for v6.11	2024-07-15 18:03:43 -07:00
fault-injection
fb
features
filesystems	vfs-6.11.iomap	2024-07-15 13:28:14 -07:00
firmware_class
firmware-guide	Documentation: firmware-guide: ACPI: Fix namespace typo	2024-04-26 18:58:13 +02:00
fpga
gpu	Merge tag 'drm-misc-next-2024-04-19' of https://gitlab.freedesktop.org/drm/misc/kernel into drm-next	2024-04-22 12:29:18 +10:00
hid	Merge branch 'for-6.10/intel-ish' into for-linus	2024-05-14 13:53:15 +02:00
hwmon	hwmon updates for v6.11-rc1	2024-07-15 17:39:13 -07:00
i2c	docs: i2c: summary: be clearer with 'controller/target' and 'adapter/client' pairs	2024-06-22 10:11:56 +02:00
iio	docs: iio: ad7944: add documentation for chain mode	2024-04-29 20:53:25 +01:00
images
infiniband
input
isdn
kbuild	kbuild: doc: Update default INSTALL_MOD_DIR from extra to updates	2024-06-26 00:18:57 +09:00
kernel-hacking
leds
litmus-tests	Documentation/litmus-tests: Make cmpxchg() tests safe for klitmus	2024-05-06 14:29:21 -07:00
livepatch
locking
maintainer
mhi
misc-devices
mm	The usual shower of singleton fixes and minor series all over MM,	2024-05-19 09:21:03 -07:00
netlabel
netlink	doc: netlink: specs: tc: flower: add enc-flags	2024-07-15 09:14:39 -07:00
networking	Merge branch '40GbE' of git://git.kernel.org/pub/scm/linux/kernel/git/tnguy/next-queue	2024-07-13 16:04:52 -07:00
nvdimm
nvme
PCI	Merge branch 'pci/enumeration'	2024-05-16 18:14:10 -05:00
pcmcia
peci
power	regulator: core: Add helper for allow HW access to enable/disable regulator	2024-06-26 18:17:05 +01:00
process	docs: netdev: Fix typo in Signed-off-by tag	2024-05-27 17:15:22 -07:00
RCU	Merge branches 'doc.2024.06.06a', 'fixes.2024.07.04a', 'mb.2024.06.28a', 'nocb.2024.06.03a', 'rcu-tasks.2024.06.06a', 'rcutorture.2024.06.06a' and 'srcu.2024.06.18a' into HEAD	2024-07-04 13:54:17 -07:00
rust	RISC-V Patches for the 6.10 Merge Window, Part 1	2024-05-22 09:56:00 -07:00
scheduler	Linux 6.9-rc1	2024-03-25 11:32:29 +01:00
scsi	scsi: documentation: Clean up scsi_mid_low_api.rst	2024-04-08 22:10:05 -04:00
security	Another not-too-busy cycle for documentation, including:	2024-05-13 10:51:53 -07:00
sound	Documentation: sound: Fix trailing whitespaces	2024-05-16 16:00:30 +02:00
sphinx	docs: kernel_include.py: Cope with docutils 0.21	2024-05-02 09:50:59 -06:00
sphinx-static
spi	spi: pxa2xx: Drop the stale entry in documentation TOC	2024-05-07 23:53:21 +09:00
staging
target
tee	Documentation: tee: Add TS-TEE driver	2024-04-03 14:03:09 +02:00
timers	sched/isolation: Prevent boot crash when the boot CPU is nohz_full	2024-04-28 10:07:12 +02:00
tools	rtla: Documentation: Fix -t, --trace	2024-05-16 16:52:16 +02:00
trace	Char/Misc and other driver subsystem changes for 6.10-rc1	2024-05-22 12:26:46 -07:00
translations	gpio: Remove legacy API documentation	2024-05-27 16:50:03 +02:00
usb
userspace-api	gpio updates for v6.11-rc1	2024-07-15 17:53:24 -07:00
virt	- Add support for running the kernel in a SEV-SNP guest, over a Secure	2024-07-16 11:12:25 -07:00
w1
watchdog
wmi	platform/x86: wmi: Add MSI WMI Platform driver	2024-04-29 12:06:21 +02:00
.gitignore
atomic_bitops.txt
atomic_t.txt	Documentation/atomic_t: Emphasize that failed atomic operations give no ordering	2024-05-06 14:29:04 -07:00
Changes
CodingStyle
conf.py	compiler_types: add Endianness-dependent __counted_by_{le,be}	2024-03-28 18:50:47 -07:00
docutils.conf
dontdiff
index.rst	doc: fix spelling about ReStructured Text	2024-04-02 10:07:51 -06:00
Kconfig
Makefile	Kbuild updates for v6.10	2024-05-18 12:39:20 -07:00
memory-barriers.txt
SubmittingPatches
subsystem-apis.rst