Commit 0e056eb5 authored by mchehab@s-opensource.com's avatar mchehab@s-opensource.com Committed by Jonathan Corbet

kernel-api.rst: fix a series of errors when parsing C files

./lib/string.c:134: WARNING: Inline emphasis start-string without end-string.
./mm/filemap.c:522: WARNING: Inline interpreted text or phrase reference start-string without end-string.
./mm/filemap.c:1283: ERROR: Unexpected indentation.
./mm/filemap.c:3003: WARNING: Inline interpreted text or phrase reference start-string without end-string.
./mm/vmalloc.c:1544: WARNING: Inline emphasis start-string without end-string.
./mm/page_alloc.c:4245: ERROR: Unexpected indentation.
./ipc/util.c:676: ERROR: Unexpected indentation.
./drivers/pci/irq.c:35: WARNING: Block quote ends without a blank line; unexpected unindent.
./security/security.c:109: ERROR: Unexpected indentation.
./security/security.c:110: WARNING: Definition list ends without a blank line; unexpected unindent.
./block/genhd.c:275: WARNING: Inline strong start-string without end-string.
./block/genhd.c:283: WARNING: Inline strong start-string without end-string.
./include/linux/clk.h:134: WARNING: Inline emphasis start-string without end-string.
./include/linux/clk.h:134: WARNING: Inline emphasis start-string without end-string.
./ipc/util.c:477: ERROR: Unknown target name: "s".
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
Acked-by: default avatarBjorn Helgaas <bhelgaas@google.com>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 40bf19a8
...@@ -271,16 +271,17 @@ void blkdev_show(struct seq_file *seqf, off_t offset) ...@@ -271,16 +271,17 @@ void blkdev_show(struct seq_file *seqf, off_t offset)
/** /**
* register_blkdev - register a new block device * register_blkdev - register a new block device
* *
* @major: the requested major device number [1..255]. If @major=0, try to * @major: the requested major device number [1..255]. If @major = 0, try to
* allocate any unused major number. * allocate any unused major number.
* @name: the name of the new block device as a zero terminated string * @name: the name of the new block device as a zero terminated string
* *
* The @name must be unique within the system. * The @name must be unique within the system.
* *
* The return value depends on the @major input parameter. * The return value depends on the @major input parameter:
*
* - if a major device number was requested in range [1..255] then the * - if a major device number was requested in range [1..255] then the
* function returns zero on success, or a negative error code * function returns zero on success, or a negative error code
* - if any unused major number was requested with @major=0 parameter * - if any unused major number was requested with @major = 0 parameter
* then the return value is the allocated major number in range * then the return value is the allocated major number in range
* [1..255] or a negative error code otherwise * [1..255] or a negative error code otherwise
*/ */
......
...@@ -132,8 +132,8 @@ int clk_get_phase(struct clk *clk); ...@@ -132,8 +132,8 @@ int clk_get_phase(struct clk *clk);
* @q: clk compared against p * @q: clk compared against p
* *
* Returns true if the two struct clk pointers both point to the same hardware * Returns true if the two struct clk pointers both point to the same hardware
* clock node. Put differently, returns true if struct clk *p and struct clk *q * clock node. Put differently, returns true if @p and @q
* share the same struct clk_core object. * share the same &struct clk_core object.
* *
* Returns false otherwise. Note that two NULL clks are treated as matching. * Returns false otherwise. Note that two NULL clks are treated as matching.
*/ */
......
...@@ -474,7 +474,7 @@ void ipc_rcu_free(struct rcu_head *head) ...@@ -474,7 +474,7 @@ void ipc_rcu_free(struct rcu_head *head)
* Check user, group, other permissions for access * Check user, group, other permissions for access
* to ipc resources. return 0 if allowed * to ipc resources. return 0 if allowed
* *
* @flag will most probably be 0 or S_...UGO from <linux/stat.h> * @flag will most probably be 0 or ``S_...UGO`` from <linux/stat.h>
*/ */
int ipcperms(struct ipc_namespace *ns, struct kern_ipc_perm *ipcp, short flag) int ipcperms(struct ipc_namespace *ns, struct kern_ipc_perm *ipcp, short flag)
{ {
...@@ -672,10 +672,12 @@ int ipc_update_perm(struct ipc64_perm *in, struct kern_ipc_perm *out) ...@@ -672,10 +672,12 @@ int ipc_update_perm(struct ipc64_perm *in, struct kern_ipc_perm *out)
* *
* This function does some common audit and permissions check for some IPC_XXX * This function does some common audit and permissions check for some IPC_XXX
* cmd and is called from semctl_down, shmctl_down and msgctl_down. * cmd and is called from semctl_down, shmctl_down and msgctl_down.
* It must be called without any lock held and * It must be called without any lock held and:
*
* - retrieves the ipc with the given id in the given table. * - retrieves the ipc with the given id in the given table.
* - performs some audit and permission check, depending on the given cmd * - performs some audit and permission check, depending on the given cmd
* - returns a pointer to the ipc object or otherwise, the corresponding error. * - returns a pointer to the ipc object or otherwise, the corresponding
* error.
* *
* Call holding the both the rwsem and the rcu read lock. * Call holding the both the rwsem and the rcu read lock.
*/ */
......
...@@ -131,7 +131,7 @@ EXPORT_SYMBOL(strncpy); ...@@ -131,7 +131,7 @@ EXPORT_SYMBOL(strncpy);
* @src: Where to copy the string from * @src: Where to copy the string from
* @size: size of destination buffer * @size: size of destination buffer
* *
* Compatible with *BSD: the result is always a valid * Compatible with ``*BSD``: the result is always a valid
* NUL-terminated string that fits in the buffer (unless, * NUL-terminated string that fits in the buffer (unless,
* of course, the buffer size is zero). It does not pad * of course, the buffer size is zero). It does not pad
* out the result like strncpy() does. * out the result like strncpy() does.
......
...@@ -519,7 +519,7 @@ EXPORT_SYMBOL(filemap_write_and_wait); ...@@ -519,7 +519,7 @@ EXPORT_SYMBOL(filemap_write_and_wait);
* *
* Write out and wait upon file offsets lstart->lend, inclusive. * Write out and wait upon file offsets lstart->lend, inclusive.
* *
* Note that `lend' is inclusive (describes the last byte to be written) so * Note that @lend is inclusive (describes the last byte to be written) so
* that this function can be used to write to the very end-of-file (end = -1). * that this function can be used to write to the very end-of-file (end = -1).
*/ */
int filemap_write_and_wait_range(struct address_space *mapping, int filemap_write_and_wait_range(struct address_space *mapping,
...@@ -1277,12 +1277,14 @@ EXPORT_SYMBOL(find_lock_entry); ...@@ -1277,12 +1277,14 @@ EXPORT_SYMBOL(find_lock_entry);
* *
* PCG flags modify how the page is returned. * PCG flags modify how the page is returned.
* *
* FGP_ACCESSED: the page will be marked accessed * @fgp_flags can be:
* FGP_LOCK: Page is return locked *
* FGP_CREAT: If page is not present then a new page is allocated using * - FGP_ACCESSED: the page will be marked accessed
* - FGP_LOCK: Page is return locked
* - FGP_CREAT: If page is not present then a new page is allocated using
* @gfp_mask and added to the page cache and the VM's LRU * @gfp_mask and added to the page cache and the VM's LRU
* list. The page is returned locked and with an increased * list. The page is returned locked and with an increased
* refcount. Otherwise, %NULL is returned. * refcount. Otherwise, NULL is returned.
* *
* If FGP_LOCK or FGP_CREAT are specified then the function may sleep even * If FGP_LOCK or FGP_CREAT are specified then the function may sleep even
* if the GFP flags specified for FGP_CREAT are atomic. * if the GFP flags specified for FGP_CREAT are atomic.
...@@ -3001,7 +3003,7 @@ EXPORT_SYMBOL(generic_file_write_iter); ...@@ -3001,7 +3003,7 @@ EXPORT_SYMBOL(generic_file_write_iter);
* @gfp_mask: memory allocation flags (and I/O mode) * @gfp_mask: memory allocation flags (and I/O mode)
* *
* The address_space is to try to release any data against the page * The address_space is to try to release any data against the page
* (presumably at page->private). If the release was successful, return `1'. * (presumably at page->private). If the release was successful, return '1'.
* Otherwise return zero. * Otherwise return zero.
* *
* This may also be called if PG_fscache is set on a page, indicating that the * This may also be called if PG_fscache is set on a page, indicating that the
......
...@@ -4242,7 +4242,8 @@ EXPORT_SYMBOL(free_pages_exact); ...@@ -4242,7 +4242,8 @@ EXPORT_SYMBOL(free_pages_exact);
* nr_free_zone_pages() counts the number of counts pages which are beyond the * nr_free_zone_pages() counts the number of counts pages which are beyond the
* high watermark within all zones at or below a given zone index. For each * high watermark within all zones at or below a given zone index. For each
* zone, the number of pages is calculated as: * zone, the number of pages is calculated as:
* managed_pages - high_pages *
* nr_free_zone_pages = managed_pages - high_pages
*/ */
static unsigned long nr_free_zone_pages(int offset) static unsigned long nr_free_zone_pages(int offset)
{ {
......
...@@ -1540,7 +1540,7 @@ void vfree_atomic(const void *addr) ...@@ -1540,7 +1540,7 @@ void vfree_atomic(const void *addr)
* have CONFIG_ARCH_HAVE_NMI_SAFE_CMPXCHG, but making the calling * have CONFIG_ARCH_HAVE_NMI_SAFE_CMPXCHG, but making the calling
* conventions for vfree() arch-depenedent would be a really bad idea) * conventions for vfree() arch-depenedent would be a really bad idea)
* *
* NOTE: assumes that the object at *addr has a size >= sizeof(llist_node) * NOTE: assumes that the object at @addr has a size >= sizeof(llist_node)
*/ */
void vfree(const void *addr) void vfree(const void *addr)
{ {
......
...@@ -103,10 +103,14 @@ static int lsm_append(char *new, char **result) ...@@ -103,10 +103,14 @@ static int lsm_append(char *new, char **result)
* to avoid security registration races. This method may also be used * to avoid security registration races. This method may also be used
* to check if your LSM is currently loaded during kernel initialization. * to check if your LSM is currently loaded during kernel initialization.
* *
* Return true if: * Returns:
* -The passed LSM is the one chosen by user at boot time, *
* -or the passed LSM is configured as the default and the user did not * true if:
*
* - The passed LSM is the one chosen by user at boot time,
* - or the passed LSM is configured as the default and the user did not
* choose an alternate LSM at boot time. * choose an alternate LSM at boot time.
*
* Otherwise, return false. * Otherwise, return false.
*/ */
int __init security_module_enable(const char *module) int __init security_module_enable(const char *module)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment