linux-kernel - Re: [PATCH 21/35] Unionfs: Inode operations

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <20061205135017.3be94142.akpm@osdl.org>
Date:	Tue, 5 Dec 2006 13:50:17 -0800
From:	Andrew Morton <akpm@...l.org>
To:	Jan Engelhardt <jengelh@...ux01.gwdg.de>
Cc:	"Josef 'Jeff' Sipek" <jsipek@...sunysb.edu>,
	linux-kernel@...r.kernel.org, torvalds@...l.org, hch@...radead.org,
	viro@....linux.org.uk, linux-fsdevel@...r.kernel.org,
	mhalcrow@...ibm.com
Subject: Re: [PATCH 21/35] Unionfs: Inode operations

On Tue, 5 Dec 2006 22:27:10 +0100 (MET)
Jan Engelhardt <jengelh@...ux01.gwdg.de> wrote:

> 
> On Dec 4 2006 07:30, Josef 'Jeff' Sipek wrote:
> >+	if (!hidden_dentry) {
> >+		/* if hidden_dentry is NULL, create the entire
> >+		 * dentry directory structure in branch 'bindex'.
> >+		 * hidden_dentry will NOT be null when bindex == bstart
> >+		 * because lookup passed as a negative unionfs dentry
> >+		 * pointing to a lone negative underlying dentry */
> >+		hidden_dentry = create_parents(parent, dentry, bindex);
> 
> Someone refresh me: what's the correct[preferred] kdoc style?

This isn't part of kernel-doc, if that's what you mean.

> (A)
> 	/* Lorem ipsum dolor sit amet, consectetur
> 	 * adipisicing elit, sed do eiusmod tempor
> 	 * incididunt ut labore et dolore magna aliqua. */
> 
> (B)
> 	/* Lorem ipsum dolor sit amet, consectetur
> 	   adipisicing elit, sed do eiusmod tempor
> 	   incididunt ut labore et dolore magna aliqua. */
> 
> (C)
> 	/* Lorem ipsum dolor sit amet, consectetur
> 	adipisicing elit, sed do eiusmod tempor incididunt
> 	ut labore et dolore magna aliqua. */

You forgot (D), (E), (F), (G) and a whole lot more besides.

It doesn't matter a lot what we do, but we should do it one way and not 38
ways.

Documentation/CodingStyle doesn't mention commenting at all (eyes roll
heavenwards).

This

	/*
	 * Lorem ipsum dolor sit amet, consectetur
	 * adipisicing elit, sed do eiusmod tempor
	 * incididunt ut labore et dolore magna aliqua.
	 */

is probably the most common, and is what I use when forced to descrog
comments.
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/