X-Recipient: archive-cygwin AT delorie DOT com
X-Spam-Check-By: sourceware.org
Date: Mon, 12 Apr 2010 13:19:07 +0200
From: Corinna Vinschen <corinna-cygwin AT cygwin DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: Updated: cygwin-doc-1.7-1
Message-ID: <20100412111907.GZ28908@calimero.vinschen.de>
Reply-To: cygwin AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
References: <4bc25bad DOT 071abc0a DOT 2742 DOT ffff92f4SMTPIN_ADDED AT mx DOT google DOT com>  <o2r6910a61004120156y7b7167ecua91f23e20afa21f2 AT mail DOT gmail DOT com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <o2r6910a61004120156y7b7167ecua91f23e20afa21f2@mail.gmail.com>
User-Agent: Mutt/1.5.20 (2009-06-14)
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
List-Id: <cygwin.cygwin.com>
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com

On Apr 12 10:56, Reini Urban wrote:
> 2010/4/12 Christopher Faylor:
> > I have just uploaded a long-overdue update to the Cygwin documentation
> > package.  This package provides man and info pages for cygwin utilities
> > and *some* of the Cygwin api.  It reflects the current state of Cygwin
> > and newlib as of this date.
> 
> http://cygwin.com/cygwin-api/std-notes.html
> "lseek only works properly on binary files."
> 
> Shouldn't that say:
> "lseek only works properly on files mounted or opened binary, and not
> in textmode."
> 
> textfiles mounted or opened binary do work fine IMHO.

I see what you mean but I don't quite understand your last sentence.
Do you mean this?

  mounted binary, opened modeless -> lseek works fine
  mounted binary, opened binary   -> lseek works fine
  mounted binary, opened text     -> lseek is unreliable
  mounted text  , opened modeless -> lseek is unreliable
  mounted text  , opened binary   -> lseek works fine
  mounted text  , opened text     -> lseek is unreliable

That's what we're trying to say.  So I changed this locally to

  <para><function>lseek</function> only works properly on files opened in
  binary mode.  On files opened in textmode (via mount mode or explicit
  open flag) its positioning is potentially unreliable.</para>

Does that sound ok?  If so, I check it in.


Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader          cygwin AT cygwin DOT com
Red Hat

--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple