From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755262AbcEYDqk (ORCPT ); Tue, 24 May 2016 23:46:40 -0400 Received: from mail1.bemta8.messagelabs.com ([216.82.243.194]:27128 "EHLO mail1.bemta8.messagelabs.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755170AbcEYDqf (ORCPT ); Tue, 24 May 2016 23:46:35 -0400 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrDIsWRWlGSWpSXmKPExsVywNY2Q1dCwTX c4MVGc4uFbUtYLC7vmsPmwOTxeZNcAGMUa2ZeUn5FAmvGvj+hBT/5K+43f2NtYFzF28XIxSEk sJtRouHsQkYI5wCjxK51r9kgnMuMEmcv3GeGcNYxSrTOOMUO4WxhlDjx9geQw8nBJmAgMfPOX TBbROA8i8TTW7kgtrBAlsTv/8/YQGwWAVWJ09u3gdm8Al4Si6ctAquXEJCTOHlsMiuIzQkU39 DwjQnEFhLwlHh/u4EVwlaTOHz2ERtEfbDEpK3PWSHmCEqcnPmEBcRmFpCQOPjiBfMERsFZSFK zkKQWMDKtYlQvTi0qSy3SNdVLKspMzyjJTczM0TU0sNDLTS0uTkxPzUlMKtZLzs/dxAgMVQYg 2ME4ucH5EKMkB5OSKO/BJy7hQnxJ+SmVGYnFGfFFpTmpxYcYZTg4lCR4F8i5hgsJFqWmp1akZ eYAowYmLcHBoyTC+wYkzVtckJhbnJkOkTrFqCglzvsNJCEAksgozYNrg0XqJUZZKWFeRqBDhH gKUotyM0tQ5V8xinMwKgnz7gCZwpOZVwI3/RXQYiagxf5fnEEWlyQipKQaGG3WnZ6w/OaFvfM crl7sjt64QPuY722jebtjQ6bbKvy9PmX21Q0XOMVdv2jwaKw9wTY10/i86PxV+9h/83peiq7+ uvKG5GoTfosTiz68k/qyYoOHaudWx9Dymc0KN870LLYWfaonYaL1femRzdtmJUimB+m8fcpi+ Dvw+vd5fmKd3s/r73yK1pNSYinOSDTUYi4qTgQAzbaDYM8CAAA= X-Env-Sender: David.Kershner@unisys.com X-Msg-Ref: server-8.tower-75.messagelabs.com!1464147992!20503574!2 X-Originating-IP: [192.61.61.104] X-StarScan-Received: X-StarScan-Version: 8.34; banners=-,-,- X-VirusChecked: Checked From: David Kershner To: , , , , , , , , , , , , , , , , , , , , , Subject: [PATCH 14/24] staging: unisys: visorbus: vbusdeviceinfo function descriptions more kerneldoc-like Date: Tue, 24 May 2016 23:45:52 -0400 Message-ID: <1464147962-26650-15-git-send-email-david.kershner@unisys.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1464147962-26650-1-git-send-email-david.kershner@unisys.com> References: <1464147962-26650-1-git-send-email-david.kershner@unisys.com> X-OriginalArrivalTime: 25 May 2016 03:46:24.0776 (UTC) FILETIME=[028E5080:01D1B638] 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 --- 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