Author: crossley
Date: Mon Aug 22 04:38:54 2005
New Revision: 234471
URL: http://svn.apache.org/viewcvs?rev=234471&view=rev
Log:
Start to clarify the whitespace issues.
Modified:
forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-dev.xml
Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-dev.xml
URL:
http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-dev.xml?rev=234471&r1=234470&r2=234471&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-dev.xml
(original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-dev.xml Mon
Aug 22 04:38:54 2005
@@ -203,17 +203,27 @@
<section id="whitespace">
<title>Whitespace</title>
<p>
- Use spaces instead of tabs (java files have four-space indentation,
+ For new file, use spaces instead of tabs (java files have four-space
indentation,
xml files and other text files have two-space indentation).
- Don't let your editor automatically change the whitespace.
+ </p>
+ <p>
+ Don't let your editor automatically change the whitespace for
existing
+ files.
</p>
<p>
We know that many files in SVN do not have consistent whitespace.
This issue is continually being addressed. Please don't attempt
to rectify whitespace mixed up with other changes. This makes the
important changes difficult to see. Occasionally committers will
- rectify whitespace for a set of files.
+ rectify whitespace for a set of files, when they know that no-one
+ else is working on that set.
</p>
+ <fixme author="open">
+ The issues of whitespace and line endings needs to be very clearly
described.
+ See some
+ <a
href="http://marc.theaimsgroup.com/?l=forrest-dev&m=112450886218545";>mail
discussion</a>
+ references.
+ </fixme>
</section>
<section id="line-length">
