Usage modified by Matt Heyse

Matt Heyse — Sat, 14 Sep 2013 17:43:51 -0000

--- v1
+++ v2
@@ -7,63 +7,63 @@

    Commands are

-   S   Seed (synonyms s and a)
-       Seeds a grove of trees from a file. Only uses the first
-       filename given as the input file.
-
-   V   View (synonyms v and x)
-       aligns a grove of trees and builds an output file from the
-       line of sight. filenames are the trees
-
-
-   Options: All options that don't apply to the current command are
-      simply ignored. All options must start with '-' or '/' 
-      characters. Any that don't are considered to be filenames and
-      are added to the list of trees (v) or is the input file (s).
-      The special filename '-' indicates that this is a file pipe
-      from or to an external program./
-      
-
-      'o'   output filename
-            defines the name given to the output of the view command.
-            this can be a pipe "-o-". 
-   
-      's'   stimulate overgrowth
-            defines the amount of overgrowth allowed (2x this value).
-            the number can have 'k' for KB, 'm' for MB, g for GB and
-            '%' for a percentage of the input file. '%' is ignored
-            for incoming file pipes. values can be combined "4m6k"  
-
-      'g'   grove tree names {prefix}{delimiter}{extension}
-            Options (-gp, -gd, -ge)
-
-            'p' Tree Name prefix
+    S   Seed (synonyms s and a)
+        Seeds a grove of trees from a file. Only uses the first
+        filename given as the input file.
+    
+    V   View (synonyms v and x)
+        aligns a grove of trees and builds an output file from the
+        line of sight. filenames are the trees
+ 
+ 
+    Options: All options that don't apply to the current command are
+       simply ignored. All options must start with '-' or '/' 
+       characters. Any that don't are considered to be filenames and
+       are added to the list of trees (v) or is the input file (s).
+       The special filename '-' indicates that this is a file pipe
+       from or to an external program./
+        
+ 
+       'o'   output filename
+             defines the name given to the output of the view command.
+             this can be a pipe "-o-". 
+    
+       's'   stimulate overgrowth
+             defines the amount of overgrowth allowed (2x this value).
+             the number can have 'k' for KB, 'm' for MB, g for GB and
+             '%' for a percentage of the input file. '%' is ignored
+             for incoming file pipes. values can be combined "4m6k"  
+ 
+       'g'   grove tree names {prefix}{delimiter}{extension}
+             Options (-gp, -gd, -ge)
+ 
+             'p' Tree Name prefix
                 Defines the static start of the treenames

-            'd' Tree Name delimiter
-                Defines how the trees are numbered/lettered
-                  a -> a,b,c..y,z,aa,ab
-                  1 -> a,2,3..8,9,10,11
-                 01 -> 01,02,03..09,10,11
-                 0x -> 0x,0y,0z,aa,ab
-                 eX -> eX,eY,eZ,AA,AB 
+             'd' Tree Name delimiter
+                 Defines how the trees are numbered/lettered
+                   a -> a,b,c..y,z,aa,ab
+                   1 -> a,2,3..8,9,10,11
+                  01 -> 01,02,03..09,10,11
+                  0x -> 0x,0y,0z,aa,ab
+                  eX -> eX,eY,eZ,AA,AB 
+ 
+             'e' Tree Name extension
+                 Defines the static end of the treenames

-            'e' Tree Name extension
-                Defines the static end of the treenames
+       't'   trees to grow
+             defined the grove size. defaults to 4.

-      't'   trees to grow
-            defined the grove size. defaults to 4.
-
-   For MS Windows drag-n-drop compatibility, a special non-command mode is 
-   present. If the only argument is not a command, it is asumed to be a
-   filename and the following equivelent command is run:
-       forest.exe s (filename)
-   If there is no command, and there are at lest 4 arguments, its asummed 
-   that they are tree names, and the following equivelent command is run:
-       forest.exe v (tree name list)
-   This allows the windows user to drag a file onto forest.exe to plant a 
-   grove based on it, or to drag a group of trees onto forest.exe to see 
-   through them.
+    For MS Windows drag-n-drop compatibility, a special non-command mode is 
+    present. If the only argument is not a command, it is asumed to be a
+    filename and the following equivelent command is run:
+        forest.exe s (filename)
+    If there is no command, and there are at lest 4 arguments, its asummed 
+    that they are tree names, and the following equivelent command is run:
+        forest.exe v (tree name list)
+    This allows the windows user to drag a file onto forest.exe to plant a 
+    grove based on it, or to drag a group of trees onto forest.exe to see 
+    through them.

Usage modified by Matt Heyse

Matt Heyse — Sat, 14 Sep 2013 17:42:04 -0000

Usage:

forest {command} [options|filenames]

forest [1x filename | 4+x filenames]

Commands are

S Seed (synonyms s and a)
Seeds a grove of trees from a file. Only uses the first
filename given as the input file.

V View (synonyms v and x)
aligns a grove of trees and builds an output file from the
line of sight. filenames are the trees

Options: All options that don't apply to the current command are
simply ignored. All options must start with '-' or '/'
characters. Any that don't are considered to be filenames and
are added to the list of trees (v) or is the input file (s).
The special filename '-' indicates that this is a file pipe
from or to an external program./

  'o'   output filename
        defines the name given to the output of the view command.
        this can be a pipe "-o-".

  's'   stimulate overgrowth
        defines the amount of overgrowth allowed (2x this value).
        the number can have 'k' for KB, 'm' for MB, g for GB and
        '%' for a percentage of the input file. '%' is ignored
        for incoming file pipes. values can be combined "4m6k"

  'g'   grove tree names {prefix}{delimiter}{extension}
        Options (-gp<text>, -gd<text>, -ge<text>)

        'p' Tree Name prefix
            Defines the static start of the treenames

        'd' Tree Name delimiter
            Defines how the trees are numbered/lettered
              a -> a,b,c..y,z,aa,ab
              1 -> a,2,3..8,9,10,11
             01 -> 01,02,03..09,10,11
             0x -> 0x,0y,0z,aa,ab
             eX -> eX,eY,eZ,AA,AB

        'e' Tree Name extension
            Defines the static end of the treenames

  't'   trees to grow
        defined the grove size. defaults to 4.

For MS Windows drag-n-drop compatibility, a special non-command mode is
present. If the only argument is not a command, it is asumed to be a
filename and the following equivelent command is run:
forest.exe s (filename)
If there is no command, and there are at lest 4 arguments, its asummed
that they are tree names, and the following equivelent command is run:
forest.exe v (tree name list)
This allows the windows user to drag a file onto forest.exe to plant a
grove based on it, or to drag a group of trees onto forest.exe to see
through them.

Recent changes to Usage

Usage modified by Matt Heyse

Usage modified by Matt Heyse