Conditionalize keyboard layout change
[ikiwiki.git] / hammerscript / index.mdwn
index b1b5ed9..0e4b0f1 100644 (file)
@@ -79,7 +79,7 @@ HAMMER recipes, a guide for the impatient. (jcs)
 
 Are you impatient?  Are you sold on Hammer and just want to try it out?  Did you just delete something really, really important and need to get it back?  Here's some simple use cases for Hammer to show just what you can do.
 
-Simple case: I scrambled a file
+*Simple case: I scrambled a file*
 
 The most simple case: you've scrambled a file. Maybe you rewrote several lines and saved it, or accidentally mashed the keyboard, but either way, the file is still present - just wrong.
 
@@ -94,10 +94,18 @@ By default, the undo tool will output the previous version of a file with a note
 
 Other options exist, like using -i to iterate over all previous versions saved to disk, or way to generate a diff. What if you delete the file? It'll still work. 
 
-Help!  I filled up the disk!
+*Help!  I filled up the disk!*
 
-* Freeing disk space
+File history takes up space on disk.  Remember, the amount of history data isn't determined by the quantity of files, but rather how frequently they change.  Those changes are what makes up filesystem history.  It's possible to fill a disk because of that history, yet the df command will still report less than 100% usage.
 
-How to create a snapshot
+Each pseudo-file-system (PFS) on a Hammer volume is part of that volume's space.  If a particular PFS is very busy, it can eat up all space on the disk and make every PFS unusable.  You can prune older history entries from each volume using 'hammer prune /PFSname', or if you don't care about losing recent fine-grained history entries, 'hammer prune-everything'.  That command may take a few minutes to complete.
 
-* Creating a snapshot
+For a long-term fix, you may want to change the amount of history retained in any given PFS with 'hammer viconfig'.  That same config controls what 'hammer prune' will remove.
+
+*How to create a snapshot*
+
+By and large, you never need to create a snapshot manually.  Hammer volumes are set up to do so, once a day by default, and saved for 60 days.  Snapshots happen at the PFS level and automatic snapshots are configured with 'hammer viconfig', see the cleanup section of the hammer(8) manpage for details.
+
+These snapshots can be found in /var/hammer, in directories named after the matching PFS.  So, if you happen to delete an important log file in /usr, chances are good you can find an older version of it in /var/hammer/usr/.  Each snapshot is named by the time at which it is taken, i.e. 'snap-YYYYMMDD-HHMM'.  Treat them as read-only backup volume that you can copy from at any time.
+
+If you do want to create a snapshot at an arbitrary time, 'hammer snap PATH' will take an immediate snapshot of the PFS that contains PATH.