Re:Updated: cygwin-doc-1.7-1

Re:Updated: cygwin-doc-1.7-1

[Rodrigo Medina]

HI,

Bugs:
(1) Most of the info files of the package have not a proper format
     Only libc.info and libm.info are OK.

(2) The files in  /usr/share/doc/cygwin-doc-1.7/ don't appear in
     /etc/setup/cygwin-doc.lst

(3) The file cygwin-api.html is incomplete (sub topics are missing).

Bye
RM


--
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

Re: Updated: cygwin-doc-1.7-1

[Christopher Faylor]

On Tue, Apr 13, 2010 at 07:07:38PM -0430, Rodrigo Medina wrote:
>HI,
>
>Bugs:
>(1) Most of the info files of the package have not a proper format
>     Only libc.info and libm.info are OK.

I'll fix this.

>(2) The files in  /usr/share/doc/cygwin-doc-1.7/ don't appear in
>     /etc/setup/cygwin-doc.lst

That's because the package doesn't install anything in
/usr/share/doc/cygwin-doc-1.7/ .

>(3) The file cygwin-api.html is incomplete (sub topics are missing).

cygwin-api.html is not included in cygwin-doc.

cgf

--
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

Re: Updated: cygwin-doc-1.7-1

[Reini Urban]

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.
-- 
Reini Urban
http://phpwiki.org/           http://murbreak.at/

--
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

Re: Updated: cygwin-doc-1.7-1

[Corinna Vinschen]

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

Re: Updated: cygwin-doc-1.7-1

[Christopher Faylor]

On Mon, Apr 12, 2010 at 01:19:07PM +0200, Corinna Vinschen wrote:
>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.

That sounds good but I don't really see what this has to do with the
cygwin-doc package.  That is the consumer of these types of changes,
not the driver.

cgf

--
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