gt5(1)                                                                  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  (option-
       ally  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 par-
              ents are not shown.  Default is  0.1,  gt5  will  accept  values
              between 0.01 and 30.

       --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.

       --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 direc-
              tories 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'.)

       --with-mounts
              By  default  gt5  calls du with -akx, ignoring mountpoints.  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 priority
       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:   unfavourable handling of <a name>-tag, unfavourable cursor navi-
              gation 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

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

AUTHOR
       Thomas Sattler

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



gt5 v1.3c                         January 2007                           gt5(1)