Forest in the Trees Wiki
A file utillity based off seeing a forest through the trees
Brought to you by:
mpheyse
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.