There is no man for rsync

There is no man for rsync

[Vlado]

Hello, rsync maintainer!

Package rsync 3.1.3+20200429+gitf7746d0-1 is offered by setup as best 
choice, but this package has no manual pages inside.
Consider to rebuild rsync 3.1.3 package, please. (nothing urgent, 
3.1.2-1 works fine for me)

Thank you.
Vlado

Re: There is no man for rsync

[Brian Inglis]

On 2020-06-01 03:13, Vlado via Cygwin wrote:
> Hello, rsync maintainer!
> 
> Package rsync 3.1.3+20200429+gitf7746d0-1 is offered by setup as best choice,
> but this package has no manual pages inside.
> Consider to rebuild rsync 3.1.3 package, please. (nothing urgent, 3.1.2-1 works
> fine for me)
Looks like a packaging problem as the man dirs are created but not populated:

https://cygwin.com/cgi-bin2/package-cat.cgi?file=x86_64%2Frsync%2Frsync-3.1.3%2B20200429%2Bgitf7746d0-1&grep=rsync

    2020-05-05 12:11           0 usr/share/man/
    2020-05-05 12:11           0 usr/share/man/man1/
    2020-05-05 12:11           0 usr/share/man/man5/

but the previous releases include the man pages:

https://cygwin.com/cgi-bin2/package-cat.cgi?file=x86_64%2Frsync%2Frsync-3.1.2-1&grep=rsync

    2016-01-29 06:33       57288 usr/share/man/man1/rsync.1.gz
    2016-01-29 06:33       16128 usr/share/man/man5/rsyncd.conf.5.gz

https://cygwin.com/cgi-bin2/package-cat.cgi?file=x86_64%2Frsync%2Frsync-3.1.1-1&grep=rsync

    2015-02-13 17:13       57154 usr/share/man/man1/rsync.1.gz
    2015-02-13 17:13       16029 usr/share/man/man5/rsyncd.conf.5.gz

-- 
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.
[Data in IEC units and prefixes, physical quantities in SI.]

Re: There is no man for rsync

[Wayne Davison]

On Tue, Jun 2, 2020 at 12:36 PM Brian Inglis wrote:
> Looks like a packaging problem as the man dirs are created but not populated:

What undoubtedly happened was that the git checkout used for the
release does not include pre-generated man pages, and the build
required the yodl document processor to create them. At the time the
configure & make would have just mentioned that it wasn't able to
build the manpages, but the build would not have failed, making that
issue easy to miss. (And the "./prepare-source fetchgen" command would
not have worked since samba.org switched over to requiring ssl for the
rsync daemon copy commands and the script wasn't fixed to handle that
yet.)

In the upcoming 3.2.0 release the man page source files have changed
from .yo files to .md files, their build process only requires python3
and python3-commonmark (which Cygwin has), and the configure & make
rules now fail if there are no man pages and no way to build them.
This should hopefully mean that the issue won't recur should another
git release be needed in the future.

On the subject of the pending 3.2.0 release, it would be nice to get
the xxHash library turned into normal & dev packages so that the
Cygwin rsync can ship with xxhash checksum support.  I've installed
xxHash manually for testing and it's working fine (and I just got the
project to fix a Cygwin install issue in the Makefile). For anyone
wanting to test it manually, you can grab the latest git or zip file
from github (https://github.com/Cyan4973/xxHash) and run "PREFIX=/usr
make install". If nobody else gets around to it I'll see what I can do
once I get done with the rsync release process.

..wayne..