Re: [PATCH] fix up kerneldoc in fs/ioctl.c a little bit

[Erez Zadok]

In message <20080209071559.GA30903@xxxxxx>, Christoph Hellwig writes:
>  - remove non-standard in/out markers
>  - use tabs for formatting
> 
> 
> Signed-off-by: Christoph Hellwig <hch@xxxxxx>
> 
> Index: linux-2.6/fs/ioctl.c
> ===================================================================
> --- linux-2.6.orig/fs/ioctl.c	2008-02-09 07:49:02.000000000 +0100
> +++ linux-2.6/fs/ioctl.c	2008-02-09 07:49:20.000000000 +0100
> @@ -18,9 +18,9 @@
>  
>  /**
>   * vfs_ioctl - call filesystem specific ioctl methods
> - * @filp: [in]     open file to invoke ioctl method on
> - * @cmd:  [in]     ioctl command to execute
> - * @arg:  [in/out] command-specific argument for ioctl
> + * @filp:	open file to invoke ioctl method on
> + * @cmd:	ioctl command to execute
> + * @arg:	command-specific argument for ioctl
>   *
>   * Invokes filesystem specific ->unlocked_ioctl, if one exists; otherwise
>   * invokes * filesystem specific ->ioctl method.  If neither method exists,
              ^

I also think this extra '*' in the last comment line above is spurious,
perhaps the result of a paragraph reformatting command that mixed comment
*'s with text.

Erez.
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/