gt5(1)							      General Commands Manual							    gt5(1)

NAME

       gt5 - a diff-capable 'du-browser'

SYNOPSIS

       gt5 [ dir | file | dir file | file file2 ] [options]

DESCRIPTION

       gt5  reads  the	output	of  du, compares it with a du-log saved by the last run, converts it into HTML and opens the resulting file with a
       textbrowser.

       If files are given on the commandline they are expected to be (optionally gzip/bzip2-compressed) logfiles of du -akx /some/dir.	It  is	up
       to you to take care that the given directories/files represent the same directory.  gt5 will show lots of new files if you don't. ;-)

OPTIONS

       --cut-at float
	      Files  and  directories that are below float percent of their parents are not shown.  Default is 0.1, gt5 will accept values between
	      0.01 and 30.

       --debug
	      Turn on debug. Generate HTML files and do not run browser.

       --diff-dir directory
	      Use directory instead of ~/.gt5-diffs/ to read/store du-logs.  This switch is ignored if gt5 is only used with files.

       --discard
	      Do not save the current state, in other words: be able to diff against the old state again.  This feature is disabled if gt5 is only
	      used with files.

       --help Display brief help.

       --link-files
	      Also insert links to files to access them from within gt5.  This can be very handy if your browser is configured to handle the files
	      MIME-type correctly.  This feature is disabled if gt5 is only used with files.

       --max-depth int
	      Do not show anything below a depth of int directories. Default is 5 (also see BUGS below).

       --max-lines int
	      Only consider the int biggest files and directories within the output of du.

       --no-diffs
	      Use this if you are not interested in the history of the directories processed, for example in /tmp.

       --save-as file
	      DEPRECATED, use du -akx or du -ak (see --with-mounts), save the output to a file and run gt5 against one (ore two)  of  these  files
	      later.

       --save-state
	      Force saving current state, overwriting a previous --discard.  (Some people seem to have gt5 aliased to 'gt5 --discard'.)

       --verbose
	      Display messages.

       --with-mounts
	      By default gt5 calls du with -akx to ignore mounted filesystems. Use this to inspect mounted partitions too, i.e. call du with -ak

HELPERS

       If  gawk or a textbrowser are missing and you want to install them into ~/bin (or /usr/local/bin if you have write access there), gt5 comes
       with the following helpers:

       --get-gawk
	      Download, compile and install a copy of gawk.

       --get-links
	      Download, compile and install a copy of links.

       --get-links2
	      Download, compile and install a copy of links2.

       --get-elinks
	      Download, compile and install a copy of elinks.

TEXTBROWSERS

       It is recommended to use links with gt5.  Other textbrowsers are also possible but there are several good reasons why links is given prior-
       ity over the others:

       elinks:
	      links is much faster on startup/exit

       lynx:  does not honor a documents coloring

       netrik:
	      no colors, unfavourable cursor navigation

       retawq:
	      no colors, can't handle <a name>-tags

       w3m:   Version  0.5.2  and  later  are known to work. Older versions experienced unfavourable handling of <a name>-tag, unfavourable cursor
	      navigation and no colors

       Only links/links2, elinks and lynx are now considered usable (and also chosen in that order). See ENVIRONMENT/GT5_BROWSER below.

FILES

       ~/.gt5.html
	      contains a copy of the last run
       ~/.gt5-diffs/
	      compressed du-logs are stored here

ENVIRONMENT

       GT5_BROWSER
	      force using a (specific) textbrowser

       GT5_CHARSET
	      force using a (specific) charset for HTML header instead of using $LANG

       GT5_DEBUG_DIR
	      Directory where to write gt5.debug* data if --debug option is set.

BUGS

       Directories at depth max-depth are not browsable and so look like files.

AUTHOR

       Thomas Sattler <gt5 at gmx dot net>

SEE ALSO

       du(1), links(1), elinks(1), lynx(1)

gt5 v1.4.0.1							     July 2009								    gt5(1)