NAME
    cleanse-path - remove duplicate entries from given path(s).

SYNOPSIS
      cleanse-path
        [ -no-current-dir | -n ] [ -sanity-check | -c ] \
        [ /path:/entries [ /more:/path ] ]

      To remove current directory from $PATH ...

        cleanse-path -no-current-dir

      To remove '/to' (and get "/path:/to:/cleanse:.") ...

        cleanse-path  /path:/to  /cleanse:/to:.

      To remove current directory (and get "/path:/to:/cleanse") ...

        cleanse-path -no-current-dir /path:/to:/cleanse:/to:.

DESCRIPTION
    This program removes duplicate entries from given path(s) and produces a
    (path) string in the order each entry appread in given arguments.

    If the program is run without any arguments, value of environment
    variable "PATH" is used.

OPTIONS
    -help | -usage
      Shows this message.

    -no-current-dir | -n
      Remove current (.) directory. (Default is to keep.)

    -sanity-check | --c
      Keep only those path entries which are directories and are executable
      (in other words, searchable).

ENVIRONMENT
    If no arguments are given PATH value is used.

ERROR CONDITION
    If no arguments are given or PATH is empty, program exits with error.

BUGS
    Let me know.

SEE ALSO
    (There must be something.)

AUTHOR, LICENSE, DISTRIBUTION, ETC.
    Parv, parv(at)pair(dot)com

    MODIFIED: Feb 12 2006

    This software is free to be used in any form only if proper credit is
    given. I am not responsible for any kind of damage or loss. Use it at
    your own risk.