changeset 417:4c185817cc45

Describe the canonical way to track folders: .keep files.
author drak@kaverne
date Thu, 18 Sep 2014 10:56:45 +0200
parents 38f7971e54a9
children 005d07dfce2b
files templates/guide/index.html
diffstat 1 files changed, 15 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/templates/guide/index.html	Thu Sep 18 10:56:20 2014 +0200
+++ b/templates/guide/index.html	Thu Sep 18 10:56:45 2014 +0200
@@ -583,6 +583,21 @@
 You also have to commit after a merge when there are no conflicts, because merging creates new history and you might want to attach a specific message to the merge (like "merge feature1").
 </div>
 
+
+<div class="note">
+<p class="note-title">Note: Tracking empty folders</p>
+
+If you need empty folders which are available after clone, add
+a <code>.keep</code> file in the folder and add that.
+
+<pre>$ mkdir emptyfolder
+$ touch emptyfolder/.keep
+$ hg add emptyfolder/.keep
+$ hg commit -m "ensure that emptyfolder is available." emptyfolder/.keep
+
+</pre>
+</div>
+
 <h5>Rollback mistakes</h5>
 
 <p>Now you can work on different features in parallel, but from time to time a bad commit might sneak in. Naturally you could then just go back one revision and merge the stray error, keeping all mistakes out of the merged revision. However, there's an easier way, if you realize your error before you do another <em>commit</em> or <em>pull</em>: <em>rollback</em>.</p>