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
..
irq	Documentation: irqdomain: Fix typo of "at least once"	2022-08-18 11:11:52 -06:00
wrappers	docs: put atomic*.txt and memory-barriers.txt into the core-api book	2022-09-29 12:55:06 -06:00
asm-annotations.rst	docs: move x86 documentation into Documentation/arch/	2023-03-30 12:58:51 -06:00
assoc_array.rst
boot-time-mm.rst
cachetlb.rst	mm: remove ARCH_IMPLEMENTS_FLUSH_DCACHE_FOLIO	2023-08-24 16:20:19 -07:00
circular-buffers.rst
cleanup.rst	cleanup: Add usage and style documentation	2024-08-05 16:54:41 +02:00
cpu_hotplug.rst	arch: Remove Itanium (IA-64) architecture	2023-09-11 08:13:17 +00:00
debug-objects.rst
debugging-via-ohci1394.rst	Documentation: Drop or replace remaining mentions of IA64	2023-09-11 08:13:18 +00:00
dma-api-howto.rst	docs: dma: correct dma_set_mask() sample code	2024-04-02 10:07:15 -06:00
dma-api.rst	docs: dma-api: Fix description of the sync_sg API	2023-11-17 08:52:13 -07:00
dma-attributes.rst	Reinstate some of "swiotlb: rework "fix info leak with DMA_FROM_DEVICE""	2022-03-28 11:37:05 -07:00
dma-isa-lpc.rst	docs: core-api: avoid using ReST :doc:foo markup	2021-06-17 13:24:37 -06:00
entry.rst	Docs: typos/spelling	2024-05-02 10:02:29 -06:00
errseq.rst
floating-point.rst	arch: add ARCH_HAS_KERNEL_FPU_SUPPORT	2024-05-19 14:36:17 -07:00
genalloc.rst
generic-radix-tree.rst
genericirq.rst	Docu: genericirq.rst: fix irq-example	2023-08-28 12:45:31 -06:00
gfp_mask-from-fs-io.rst
idr.rst	IDR: Note that the IDR API is deprecated	2022-07-10 21:17:30 -04:00
index.rst	cleanup: Add usage and style documentation	2024-08-05 16:54:41 +02:00
kernel-api.rst	Documentation: core-api: Drop :export: for int_log.h	2023-07-25 17:40:25 +01:00
kobject.rst	kobject documentation: remove default_attrs information	2022-01-07 11:23:37 +01:00
kref.rst
librs.rst
local_ops.rst	timers: Update the documentation to reflect on the new timer_shutdown() API	2022-11-24 15:09:12 +01:00
maple_tree.rst	maple_tree: update the documentation of maple tree	2023-12-10 16:51:32 -08:00
memory-allocation.rst	mm/slab: document kfree() as allowed for kmem_cache_alloc() objects	2023-03-29 10:35:41 +02:00
memory-hotplug.rst	mm/memory_hotplug: remove HIGHMEM leftovers	2021-11-06 13:30:42 -07:00
mm-api.rst	mm/slab, docs: switch mm-api docs generation from slab.c to slub.c	2023-12-05 11:11:34 +01:00
netlink.rst	doc/netlink: Update genetlink-legacy documentation	2023-08-27 17:17:09 -07:00
packing.rst	Documentation: core-api: packing: correct spelling	2023-02-15 21:40:54 -08:00
padata.rst	Documentation: core-api: padata: correct spelling	2023-02-16 16:58:01 -07:00
pin_user_pages.rst	Documentation/gpu: VM_BIND locking document	2023-11-29 20:54:43 +01:00
printk-basics.rst	printk: Move the printk() kerneldoc comment to its new home	2021-07-26 12:36:44 +02:00
printk-formats.rst	printk changes for 6.6	2023-09-04 13:20:19 -07:00
printk-index.rst	docs:core-api: fixed typos and grammar in printk-index page	2024-05-07 08:01:11 -06:00
protection-keys.rst	Documentation/protection-keys: Clean up documentation for User Space pkeys	2022-06-07 16:06:22 -07:00
rbtree.rst
refcount-vs-atomic.rst
swiotlb.rst	Documentation/core-api: correct reference to SWIOTLB_DYNAMIC	2024-05-27 16:52:09 +02:00
symbol-namespaces.rst	doc: module: update file references	2022-07-01 14:50:01 -07:00
this_cpu_ops.rst	arch: Remove cmpxchg_double	2023-06-05 09:36:39 +02:00
timekeeping.rst	timekeeping: Introduce fast accessor to clock tai	2022-04-14 16:19:30 +02:00
tracepoint.rst
unaligned-memory-access.rst
watch_queue.rst	Documentation: move watch_queue to core-api	2022-04-22 09:47:25 -06:00
workqueue.rst	Documentation/core-api: Update events_freezable_power references.	2024-04-03 08:45:18 -10:00
xarray.rst	XArray: Document the locking requirement for the xa_state	2022-02-03 15:56:50 -05:00