Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Driver-API: Documentation: Replace deprecated :c:func: Usage

Replace :c:func: with func() as the previous usage is deprecated.

Signed-off-by: Puranjay Mohan <puranjay12@gmail.com>
Link: https://lore.kernel.org/r/20200707053252.32703-1-puranjay12@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Puranjay Mohan and committed by
Jonathan Corbet
3a63e9fc 8b1a17c7

+11 -11
+11 -11
Documentation/driver-api/device-io.rst
··· 36 36 37 37 This address should not be used directly. Instead, to get an address 38 38 suitable for passing to the accessor functions described below, you 39 - should call :c:func:`ioremap()`. An address suitable for accessing 39 + should call ioremap(). An address suitable for accessing 40 40 the device will be returned to you. 41 41 42 42 After you've finished using the device (say, in your module's exit 43 - routine), call :c:func:`iounmap()` in order to return the address 43 + routine), call iounmap() in order to return the address 44 44 space to the kernel. Most architectures allocate new address space each 45 - time you call :c:func:`ioremap()`, and they can run out unless you 46 - call :c:func:`iounmap()`. 45 + time you call ioremap(), and they can run out unless you 46 + call iounmap(). 47 47 48 48 Accessing the device 49 49 -------------------- ··· 60 60 writeb(), writew(), writel() and writeq(). 61 61 62 62 Some devices (such as framebuffers) would like to use larger transfers than 63 - 8 bytes at a time. For these devices, the :c:func:`memcpy_toio()`, 64 - :c:func:`memcpy_fromio()` and :c:func:`memset_io()` functions are 63 + 8 bytes at a time. For these devices, the memcpy_toio(), 64 + memcpy_fromio() and memset_io() functions are 65 65 provided. Do not use memset or memcpy on IO addresses; they are not 66 66 guaranteed to copy data in order. 67 67 ··· 135 135 136 136 Accesses to this space are provided through a set of functions which 137 137 allow 8-bit, 16-bit and 32-bit accesses; also known as byte, word and 138 - long. These functions are :c:func:`inb()`, :c:func:`inw()`, 139 - :c:func:`inl()`, :c:func:`outb()`, :c:func:`outw()` and 140 - :c:func:`outl()`. 138 + long. These functions are inb(), inw(), 139 + inl(), outb(), outw() and 140 + outl(). 141 141 142 142 Some variants are provided for these functions. Some devices require 143 143 that accesses to their ports are slowed down. This functionality is 144 144 provided by appending a ``_p`` to the end of the function. 145 - There are also equivalents to memcpy. The :c:func:`ins()` and 146 - :c:func:`outs()` functions copy bytes, words or longs to the given 145 + There are also equivalents to memcpy. The ins() and 146 + outs() functions copy bytes, words or longs to the given 147 147 port. 148 148 149 149 Public Functions Provided