Message-ID: <399949B2.C4B706A7@softhome.net>
Date: Tue, 15 Aug 2000 15:46:26 +0200
From: Laurynas Biveinis <lauras AT softhome DOT net>
X-Mailer: Mozilla 4.74 [en] (Win98; U)
X-Accept-Language: lt,en
MIME-Version: 1.0
To: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
CC: djgpp-workers AT delorie DOT com
Subject: Re: Patch: lstat() adjustments for symlinks
References: <399844B1 DOT 9A99D08F AT softhome DOT net> <9743-Tue15Aug2000085950+0300-eliz AT is DOT elta DOT co DOT il> <39991815 DOT 18D22ABE AT softhome DOT net> <4634-Tue15Aug2000151854+0300-eliz AT is DOT elta DOT co DOT il>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Reply-To: djgpp-workers AT delorie DOT com

Eli Zaretskii wrote:
> Yes, this is also okay, but: the common "Symlink support" entry will
> require you to put all functions in that category together; if you, or
> someone else, forgets, the users lose.

I think I will use simple

@findex readlink AT r{, added to the library}
@findex __solve_symlinks@{r, added to the library}
...

@findex symlink AT r{, changed behaviour}
...

entries.

> If you think that index entries such as "Symlink support..."  are
> useful on their own right, perhaps it would be better to add a
> paragraph that talks only about the fact that symlinks are supported,
> and have this @cindex entry point to that paragraph.  You may put
> @xref's there to the docs of the relevant functions in libc.info.

Also I will replace (at later point) the chapter in features.txi 
talking about hard & symbolic links, which currently has all wanted 
index entries.

Below is my proposed patch to wc204.txi. If it is OK, I'm checking in
all lstat() stuff.

Any comments?

Laurynas

Index: wc204.txi
===================================================================
RCS file: /cvs/djgpp/djgpp/src/docs/kb/wc204.txi,v
retrieving revision 1.18
diff -u -r1.18 wc204.txi
--- wc204.txi	2000/08/14 08:51:29	1.18
+++ wc204.txi	2000/08/15 13:43:52
@@ -84,9 +84,7 @@
 @email{restone@@skypoint.com, Richard E. Stone}.
 
 @findex lchown AT r{, added to the library}
-@findex lstat AT r{, added to the library}
-New functions @code{lchown} and @code{lstat} have been added for 
-UNIX compatibility.
+New function @code{lchown} has been added for UNIX compatibility.
 
 @findex setitimer AT r{, and zero @code{it_interval.tv_usec}}
 Calling the @code{setitimer} function with both
@@ -95,14 +93,15 @@
 as if @code{it_interval.tv_usec} were set to the system clock
 granularity (55 AT dmn{msec} by default).
 
-@findex __solve_symlinks AT r{, and symlink support}
 @findex __solve_symlinks AT r{, added to the library}
-@findex readlink AT r{, and symlink support}
+@findex lstat AT r{, added to the library}
 @findex readlink AT r{, added to the library}
+@findex S_ISLNK AT r{, added to the library}
+@findex S_IFLNK AT r{, added to the library}
 UNIX-style symbolic links are fully emulated by library. As a part of this,
-new functions @code{__solve_symlinks} and @code{readlink} have been 
-added to library.
+new functions @code{__solve_symlinks}, @code{lstat} and @code{readlink};
+new macros @code{S_ISLNK} and @code{S_IFLNK} have been added to library.
 
-@findex symlink AT r{, and symlink support}
+@findex symlink AT r{, changed behaviour}
 As a part of symlink emulation, @code{symlink} no longer emulates symlinks
 to executables by creating stubs. It creates symlinks to all files instead.