lkml.org 
[lkml]   [2004]   [Apr]   [24]   [last100]   RSS Feed
Views: [more markup]  [less markup]  [headers]  [forward] 
 
Messages in this thread
/
DateSat, 24 Apr 2004 17:41:19 +0200
FromAdrian Bunk <>
SubjectRe: [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/

\
 
 \ /
  Last update: 2005-03-22 13:02    [from the cache]
©2003-2008