package cygwin-d-... case sensitivity problems --

package cygwin-d-... case sensitivity problems --

[Townsend, Paul]

The cygwin-doc-... package has several problems in at least the /usr/share/man/man3 directory where multiple file names differ only in case, i.e., the tar file contains, in this order,


  usr/share/man/man3/jN.3.gz

  usr/share/man/man3/jn.3.gz


The jN.3.gz file contains the roff text and the jn.3.gz file contains a roff .so directive pointing at jN.3.  The file that ends up in man3 is jn.3.gz and jN.3.gz disappears.


The simplest solution would be to just remove jn.3.gz and similar .so files from the tarball.  This would at least allow the roff text files to exist.


-- Thanks,

--    Paul Townsend


FMI - where was the tarball created?  It certainly was not on a computer with Windows and case insensitivity.

--
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: package cygwin-d-... case sensitivity problems --

[Townsend, Paul]

--The NAME section line for the jN.3 man page is


jN, jNf, yN, yNf, j0, j0f, j1, j1f, jn, jnf, y0, y0f, y1, y1f, yn, ynf - Bessel functions


In a quick perusal of the available Cygwin math functions, I could find no available function with the first four names above although a C call to jN() does link successfully. In addition, the man page itself does not explicitly describe those four.  Again, a quick google internet search did not find jN although I did find Jn.


My original "simplest solution" would not work.


New suggestion:  Rename the jN.3 file bessel.3 and replace the first four names in the roff source file with bessel.



--  Thanks,

--    Paul Townsend


________________________________
From: Townsend, Paul
Sent: Tuesday, June 18, 2019 1:46:20 PM
To: cygwin@cygwin.com
Cc: Townsend, Paul
Subject: package cygwin-d-... case sensitivity problems --


The cygwin-doc-... package has several problems in at least the /usr/share/man/man3 directory where multiple file names differ only in case, i.e., the tar file contains, in this order,


  usr/share/man/man3/jN.3.gz

  usr/share/man/man3/jn.3.gz


The jN.3.gz file contains the roff text and the jn.3.gz file contains a roff .so directive pointing at jN.3.  The file that ends up in man3 is jn.3.gz and jN.3.gz disappears.


The simplest solution would be to just remove jn.3.gz and similar .so files from the tarball.  This would at least allow the roff text files to exist.


-- Thanks,

--    Paul Townsend


FMI - where was the tarball created?  It certainly was not on a computer with Windows and case insensitivity.

--
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: package cygwin-d-... case sensitivity problems --

[Brian Inglis]

On 2019-06-18 11:46, Townsend, Paul wrote:
> The cygwin-doc-... package has several problems in at least the 
> /usr/share/man/man3 directory where multiple file names differ only in case, 
> i.e., the tar file contains, in this order,
>   usr/share/man/man3/jN.3.gz
>   usr/share/man/man3/jn.3.gz
> The jN.3.gz file contains the roff text and the jn.3.gz file contains a roff 
> .so directive pointing at jN.3.  The file that ends up in man3 is jn.3.gz
> and jN.3.gz disappears.
> The simplest solution would be to just remove jn.3.gz and similar .so files 
> from the tarball.  This would at least allow the roff text files to exist.
> FMI - where was the tarball created?  It certainly was not on a computer
> with Windows and case insensitivity.

A lot of package maintainers work on Linux and test in Windows VMs.
These conflicts should be picked up by the setup program tar extract.

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.

--
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: package cygwin-d-... case sensitivity problems --

[Brian Inglis]

On 2019-06-19 20:45, Brian Inglis wrote:
> 
> On 2019-06-18 11:46, Townsend, Paul wrote:
>> The cygwin-doc-... package has several problems in at least the 
>> /usr/share/man/man3 directory where multiple file names differ only in case, 
>> i.e., the tar file contains, in this order,
>>   usr/share/man/man3/jN.3.gz
>>   usr/share/man/man3/jn.3.gz
>> The jN.3.gz file contains the roff text and the jn.3.gz file contains a roff 
>> .so directive pointing at jN.3.  The file that ends up in man3 is jn.3.gz
>> and jN.3.gz disappears.
>> The simplest solution would be to just remove jn.3.gz and similar .so files 
>> from the tarball.  This would at least allow the roff text files to exist.
>> FMI - where was the tarball created?  It certainly was not on a computer
>> with Windows and case insensitivity.
> 
> A lot of package maintainers work on Linux and test in Windows VMs.
> These conflicts should be picked up by the setup program tar extract.

As most if not all of the math library and docs are part of and shared with
newlib, most of the maintenance will be done in Linux, where these .so refs are
necessary.

The Cygwin doc packaging will have to patch this to avoid using the other cased
variants of any man pages which are symlinks or only contain .so refs: the only
file currently matching those criteria is jn.3.gz.

Anyone can fix this locally by extracting the newlib doc from your Cygwin
mirror's downloaded tar case sensitively to your Cygwin root as:
$ /bin/tar -xvf
...mirror/x86_64/release/cygwin/cygwin-doc/cygwin-doc-3.0.7-1.tar.xz
usr/share/man/man3/jN.3.gz -C /

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.

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