Messages in this thread | | | Date | Sat, 24 Apr 2004 17:41:19 +0200 | From | Adrian Bunk <> | Subject | Re: [2.6 patch] Canonically reference files in Documentation/ code comments part |
| |
On Sat, Apr 24, 2004 at 09:56:28AM +0100, Russell King wrote: > On Sat, Apr 24, 2004 at 01:10:58AM +0200, Adrian Bunk wrote: > > Below is an updated version of a patch by > > Hans Ulrich Niedermann <linux-kernel@n-dimensional.de> to > > change all references in comments to files in Documentation/ to start > > with Documentation/ . > > I'd prefer to include the 'linux/' part so its obvious that we're > referring to the kernel tree. I've given people pointers to files > in the past, and just giving "Documentation/foo/bar" usually results > in "I've looked on the web here, there and somewhere else and can't > find the file."
Arguments in favor of this patch: - it's more common in the kernel to start the reference at the top of the kernel source - the name of the directory os not linux but linux-<version>
But I don't have a that strong opinion on this issue.
cu Adrian
--
"Is there not promise of rain?" Ling Tan asked suddenly out of the darkness. There had been need of rain for many days. "Only a promise," Lao Er said. Pearl S. Buck - Dragon Seed
- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
| |