From 34d8f01b8064f205026ae3fe3649b9218eed8694 Mon Sep 17 00:00:00 2001 From: Joel Brobecker Date: Fri, 6 Apr 2007 06:01:54 +0000 Subject: * filename_cmp.c (filename_cmp): Improve documentation. --- libiberty/filename_cmp.c | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) (limited to 'libiberty/filename_cmp.c') diff --git a/libiberty/filename_cmp.c b/libiberty/filename_cmp.c index d2052b4..59bb726 100644 --- a/libiberty/filename_cmp.c +++ b/libiberty/filename_cmp.c @@ -31,12 +31,13 @@ @deftypefn Extension int filename_cmp (const char *@var{s1}, const char *@var{s2}) -Return zero if the two paths @var{s1} and @var{s2} are equivalent. -If not equivalent, the returned value is similar to what strcmp would -return. In other words, it returns a negative value if @var{s1} is less -than @var{s2}, or a positive value if @var{s2} is greater than @var{s2}. +Return zero if the two file names @var{s1} and @var{s2} are equivalent. +If not equivalent, the returned value is similar to what @code{strcmp} +would return. In other words, it returns a negative value if @var{s1} +is less than @var{s2}, or a positive value if @var{s2} is greater than +@var{s2}. -This function does not normalize path names. As a result, this function +This function does not normalize file names. As a result, this function will treat filenames that are spelled differently as different even in the case when the two filenames point to the same underlying file. However, it does handle the fact that on DOS-like file systems, forward -- cgit v1.1