From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 2042 invoked by alias); 5 Apr 2007 17:27:28 -0000 Received: (qmail 2031 invoked by uid 22791); 5 Apr 2007 17:27:27 -0000 X-Spam-Check-By: sourceware.org Received: from nile.gnat.com (HELO nile.gnat.com) (205.232.38.5) by sourceware.org (qpsmtpd/0.31) with ESMTP; Thu, 05 Apr 2007 18:27:22 +0100 Received: from localhost (localhost [127.0.0.1]) by filtered-nile.gnat.com (Postfix) with ESMTP id 8EA6448CCB5; Thu, 5 Apr 2007 13:25:50 -0400 (EDT) Received: from nile.gnat.com ([127.0.0.1]) by localhost (nile.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 03532-01-3; Thu, 5 Apr 2007 13:25:50 -0400 (EDT) Received: from joel.gnat.com (unknown [70.71.0.212]) by nile.gnat.com (Postfix) with ESMTP id 1731B48CDA0; Thu, 5 Apr 2007 13:25:50 -0400 (EDT) Received: by joel.gnat.com (Postfix, from userid 1000) id 556D6E7B43; Thu, 5 Apr 2007 10:27:20 -0700 (PDT) Date: Thu, 05 Apr 2007 17:27:00 -0000 From: Joel Brobecker To: gcc-patches@gcc.gnu.org Cc: gdb-patches@sourceware.org Subject: [RFA/libiberty] Fix documentation issues in filename_cmp.c Message-ID: <20070405172720.GB9281@adacore.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="d6Gm4EdcadzBjdND" Content-Disposition: inline User-Agent: Mutt/1.4.2.2i Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2007-04/txt/msg00020.txt.bz2 --d6Gm4EdcadzBjdND Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 302 Hello, The attached patch incorporates all the documentation changes that Eli has recommended. No code change. 2007-04-05 Joel Brobecker * filename_cmp.c (filename_cmp): Improve documentation. Tested on x86-linux by rebuilding GDB. OK to apply? Thanks, -- Joel --d6Gm4EdcadzBjdND Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="filename_cmp.2.diff" Content-length: 1377 Index: libiberty/filename_cmp.c =================================================================== RCS file: /cvs/src/src/libiberty/filename_cmp.c,v retrieving revision 1.2 diff -u -p -r1.2 filename_cmp.c --- libiberty/filename_cmp.c 2 Apr 2007 11:20:52 -0000 1.2 +++ libiberty/filename_cmp.c 5 Apr 2007 17:21:47 -0000 @@ -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 --d6Gm4EdcadzBjdND--