documentation for OS specific tasks

[David Crossley <cr...@apache.org>]

Gav... wrote:
> <quote who="David Crossley">
> > Gav.... wrote:
> >> > Thorsten Scherler qrote:
> >> > > >
> >> > > > Nice, you can commit. :)
> >> > > >
> >> > > > However your environment does not seem to be configured correctly.
> >> Did
> >> > > > you use the configuration
> >> http://www.apache.org/dev/svn-eol-style.txt
> >> > > > described in
> >> http://www.apache.org/dev/version-control.html#https-svn?
> >> > >
> >> > > Yes, I looked at that, I can not see such a configure file on the
> >> > windows
> >> > > version I have, I'll keep looking, but will add eol manually.
> >> >
> >> > Hmm, see below.
> >> >
> >> > > > See as well FOR-124 for some forrest specific discussion about it.
> >> > >
> >> > > Looking, thanks.
> >> >
> >> > See Dave comment:
> >> > "If no svn:eol-style is specified, it's not native. We want native for
> >> > many files. You can modify ~/.subversion/config (%USERPROFILE
> >> > %/Application Data/Subversion/config in Windows)
> >>
> >> Ah, there it is, is this documented elsewhere other than the Jira?
> >
> > Do you mean apart from the documentation that Thorsten
> > provided above? i.e. the last paragraph of
> > http://www.apache.org/dev/version-control.html#https-svn
> 
> Yes, the Jira issue mentions where to look or where to add it for Windows,
> the last paragraph of that page does not mention this.
> 
> There is lots that is different for windows than for *nix - and I suspect
> for you MAC users too, these diferernces should be doc'ed somewhere 
> prefereably either a windows only page or as windows alternatate configs
> in infoboxes beneath any *nix specific configs. I guess a job for me as
> and when I come across them.

I disagree with that approach. Documentation becomes extremely
cumbersome when we try to explain to people how to use their
own Operating System. We should simply say see the "SVN Book"
and let them figure it out.
http://svnbook.red-bean.com/
http://svnbook.red-bean.com/nightly/en/svn.advanced.html#svn.advanced.confarea

-David