Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 89435 - Outdated rsync mirror howtos
Summary: Outdated rsync mirror howtos
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-developer
Classification: Unclassified
Component: Guide XML (show other bugs)
Hardware: All Linux
: High trivial (vote)
Assignee: Sven Vermeulen (RETIRED)
URL: http://www.gentoo.org/doc/en/rsync.xml
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-04-17 10:39 UTC by uran238
Modified: 2005-04-24 02:22 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description uran238 2005-04-17 10:39:08 UTC
The config file for the local rsync mirror is wrong. In the howthos it's mentioned that it has to be placed in /etc/rsync/rsyncd.conf for me only /etc/rsyncd.conf works, maybe it has something to do with the versions of rsync. I'm using net-misc/rsync-2.6.4 and there is already an example /etc/rsyncd.conf

affected versions:
http://www.gentoo.org/doc/en/rsync.xml
http://www.gentoo.org/doc/de/rsync.xml
http://www.gentoo.org/doc/nl/rsync.xml
http://www.gentoo.org/doc/fr/rsync.xml
http://www.gentoo.org/doc/it/rsync.xml

Furthermore in the english version is also a small error.
"You do not have to use the hosts allow and hosts deny options."
I'm not an Englishmen, but I'm quite sure that means that I'm not allowed to use these options, but they are optional so it shoulb be:
"You do not need to use the hosts allow and hosts deny options."

Finally there is only the [portage] module in the howtos, the official rsync-servers use the [gentoo-portage] module and it's already in the /etc/rsyncd.conf example it works as well, but it's not up-to-date so maybe it gets synced, too.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.

Actual Results:  
rsync server starts and listens but the portage (or gentoo-portage) module is
not available

Expected Results:  
rsync server should work ;)
Comment 1 Shyam Mani (RETIRED) gentoo-dev 2005-04-17 12:16:36 UTC
"You do not have to use the hosts allow and hosts deny options."

That is actually correct. The guide means to say that by default you don't have to specify anything but use it only when needed.

"You do not have to" & "You do not need to" mean pretty much the same :) and I guess the former is better language.
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2005-04-18 06:37:51 UTC
Actually the document isn't bad (except for the rsyncd.conf file location); the [portage] module is used later on in the "Configuring your Clients" section.

I have updated that one to use gentoo-portage as well though to reflect the Gentoo naming style.
Comment 3 uran238 2005-04-23 14:38:14 UTC
Changing the [portage] module to [gentoo-portage] will also change the output in the Code Listing 4.3. It's just a bit confusing.

affected versions:
http://www.gentoo.org/doc/en/rsync.xml
http://www.gentoo.org/doc/de/rsync.xml
http://www.gentoo.org/doc/fr/rsync.xml
http://www.gentoo.org/doc/it/rsync.xml

ps: the German howto is not fixed yet, but the bug was already closed. I don't know if that was right and it's the job of the translaters. Im also a newbie in bug-submitting, so tell me if I'm doing something wrong.
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2005-04-24 02:22:49 UTC
Ah, thanks; missed those.

Yes, bugs get closed when English documents are fixed. Translations follow shortly, the teams are informed of the changes and process them on their own.