Re: [PATCH] Best Practices

Karl Fogel wrote:
>>+@subsection Line endings
>>+
>>+Different platforms (Unix, Windows, MacOS) have different conventions for
>>+marking the line endings of text files. Simple editors may rewrite line
>>+endings, causing problems with diff and merge. This is a subset of the
>>+formatting problems.
>>+
>>+Subversion has built-in support for normalizing line endings. To enable it,
>>+set the @samp{svn:eol-style} property to ``native''. @xref{Properties}.
>
>
> "normalizing" doesn't mean much by itself. I think it would be better
> to describe what it actually does, and why it helps solve the problem.

I was trying to avoid duplicating the @samp{svn:eol-style} subsubsection
of the properties node, which already does that. In fact, the cross
reference to it is pretty much the point of this subsection.

Is there a way to do a cross reference to a specific spot within a node?
Otherwise, I might just move much of that to this chapter.

> Okay. Maybe one more iteration, then we can commit this material and
> work on it inline?

Sure. No big objections to the rest of your proposed changes.

-- 
Scott Lamb
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org