From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S964803AbcFAC21 (ORCPT ); Tue, 31 May 2016 22:28:27 -0400 Received: from mail1.bemta12.messagelabs.com ([216.82.251.2]:13838 "EHLO mail1.bemta12.messagelabs.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757398AbcFAC2V (ORCPT ); Tue, 31 May 2016 22:28:21 -0400 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrLIsWRWlGSWpSXmKPExsVywNY2U9fOwy/ c4NJSfouFbUtYLC7vmsPmwOTxeZNcAGMUa2ZeUn5FAmvGo4+XWQpWClTMOvGfrYHxGm8XIxeH kMBuRolvv/6zdDFyAjkHGCVOLbWGSFxmlDi85RA7hLOOUeL5zs/MEM4WRomt+x4yg7SwCRhIz Lxzlx3EFhE4zyLx9FYuiC0skCuxdN9nsDiLgKrE865fYDavgJfEnf9bmEBsCQE5iZPHJrOC2J xA8a2T3zNCnOEp0fzwH5StJnH47CM2iPpgiTWbNrJCzBGUODnzCdjZzAISEgdfvGCewCg4C0l qFpLUAkamVYwaxalFZalFuobGeklFmekZJbmJmTm6hoZGermpxcWJ6ak5iUnFesn5uZsYgcFa z8DAuIPx+GmXQ4ySHExKorw/XPzChfiS8lMqMxKLM+KLSnNSiw8xynBwKEnw1rgB5QSLUtNTK 9Iyc4BxA5OW4OBREuFlcgdK8xYXJOYWZ6ZDpE4xKkqJ804C6RMASWSU5sG1wWL1EqOslDAvIw MDgxBPQWpRbmYJqvwrRnEORiVh3v0gU3gy80rgpr8CWswEtDg+wwdkcUkiQkqqgfFwYcnMhgj bY70VKhzf5Pe8XVs8bZvirCU5bh8SuxOi7d+8ulUrf/Sgb+qHieUm3w8fm9Risfufx6Krq5fa uIjo1i2ezfbvWXmZa3bP2rI3rdyc36ZdnvXmrGz5ZYOpjValU5dc33Yzu78uyK2C5dmR03lac tnPWs7PfG7B075J+rHnH0nT6dFKLMUZiYZazEXFiQC3U2+O0AIAAA== X-Env-Sender: David.Kershner@unisys.com X-Msg-Ref: server-16.tower-164.messagelabs.com!1464748087!18478766!15 X-Originating-IP: [192.61.61.105] X-StarScan-Received: X-StarScan-Version: 8.34; banners=-,-,- X-VirusChecked: Checked From: David Kershner To: , , , , , , , , , , , , , , , , , , , , , Subject: [PATCH v2 17/27] staging: unisys: visorbus: vbusdeviceinfo function descriptions more kerneldoc-like Date: Tue, 31 May 2016 22:26:43 -0400 Message-ID: <1464748013-31309-18-git-send-email-david.kershner@unisys.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1464748013-31309-1-git-send-email-david.kershner@unisys.com> References: <1464748013-31309-1-git-send-email-david.kershner@unisys.com> X-OriginalArrivalTime: 01 Jun 2016 02:27:05.0178 (UTC) FILETIME=[16818BA0:01D1BBAD] MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: David Binder Per audit feedback from Thomas Gleixner, function descriptions in vbusdeviceinfo.h now utilize a more kerneldoc-like formatting. The affected comments do not implement other kerneldoc requirements. Signed-off-by: David Binder Signed-off-by: David Kershner Reviewed-by: Tim Sell --- drivers/staging/unisys/visorbus/vbusdeviceinfo.h | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/drivers/staging/unisys/visorbus/vbusdeviceinfo.h b/drivers/staging/unisys/visorbus/vbusdeviceinfo.h index abdab4a..010ea68 100644 --- a/drivers/staging/unisys/visorbus/vbusdeviceinfo.h +++ b/drivers/staging/unisys/visorbus/vbusdeviceinfo.h @@ -34,7 +34,8 @@ struct ultra_vbus_deviceinfo { #pragma pack(pop) -/* Reads chars from the buffer at for bytes, and writes to +/** + * Reads chars from the buffer at for bytes, and writes to * the buffer at

, which is bytes long, ensuring never to * overflow the buffer at

, using the following rules: * - printable characters are simply copied from the buffer at to the @@ -92,7 +93,8 @@ vbuschannel_sanitize_buffer(char *p, int remain, char *src, int srcmax) p++; chars++; remain--; \ } while (0) -/* Converts the non-negative value at to an ascii decimal string +/** + * Converts the non-negative value at to an ascii decimal string * at

, writing at most bytes. Note there is NO '\0' termination * written to

. * @@ -141,8 +143,9 @@ vbuschannel_itoa(char *p, int remain, int num) return digits; } -/* Reads , and converts its contents to a printable string at

, - * writing at most bytes. Note there is NO '\0' termination +/** + * Reads , and converts its contents to a printable string at

, + * writing at most bytes. Note there is NO '\0' termination * written to

. * * Pass >= 0 if you want a device index presented. -- 1.9.1