SPLITENV(1)							  SPLITENV(1)



NAME
       splitenv - formats readably output of setenv.

SYNOPSIS
       splitenv [-h|-c|-u|-l number_of_columns|-n]

TYPICAL APPLICATION
       setenv | splitenv

DESCRIPTION
       The command splitenv is a small C++ program, which is designed to pro-
       vide readable printing of the whole set of environment variables, sup-
       plied by the command setenv.  This command setenv outputs variables in
       a strange unpredictable mixed order, and each variable is output in  a
       single line without any spliting like provided by splitpath program.

       The  command  splitenv  , first of all, applyes the idea of splitpath,
       but with a necessary modification, namely with indentation by  such  a
       way that the content of environment variable is clearly separated from
       its name, which is printed too (while splitpath	does  not  print  the
       environment variable name).

       Second,	splitenv  sets the "=" signs in one column, filling necessary
       number of blanks before them.

       Last, splitenv can and by default does sorting of  variable  names  in
       alphabet order.

       The typical run of program is:
       shell> setenv | splitenv
       Alternatively one can send the result to a file by
       shell> setenv | splitenv > filename
       The  program  determines	 itself to where its output is going.  In the
       case of terminal it formats the output according to the current number
       of  columns, which it can determine automatically.  In the second case
       it "thinks" that the number of columns is 10000.	 In  both  cases  the
       number of colunms can be set manually via an option.

       Options	of  sdir are one-character words started from "-".  All argu-
       ments are considered as options.


OPTIONS
       -h     Prints help and quits.

       -c     Prints copyright and quits.

       -u     Instructs do not split information at ":" sign  like  splitpath
	      do  this.	  By  default  it splits (which is more convenient in
	      general case).  As explained in splitpath manual, the principle
	      of  its  actions	is  that  it splits input string into several
	      strings according to : signs, by	which  different  directories
	      and  other  information  is  divided  in PATH and in many other
	      environment variables.

       -l     Indicate that the	 next  argument	 is  the  number  of  columns
	      according to which it should format output.

       -n     Not  sort	 output	 according  to enviromnent variable names and
	      alphabet.	 Otherwise it will sort it.  In	 practice  you	might
	      meet cases when this or otherwise that possibility is useful.



VERSION
       This description is valid for version 1.1 issued 19.08.2008.

AUTHOR
       Igor B. Smirnov

REPORTING BUGS
       ibsmirnov@mail.ru

COPYRIGHT
       Copyright (c) 2007, I. B. Smirnov
       This  program can be used, copied, modified, and distributed according
       to the terms of GNU General Public License version 3 published by  the
       Free  Software  Foundation  29  June 2007, and provided that the above
       copyright notice, this permission notice, and notices about any	modi-
       fications  of the original text appear in all copies and in supporting
       documentation.  The program is provided "as  is"	 without  express  or
       implied warranty.

SEE ALSO
       Documentation on splitpath(1),




								  SPLITENV(1)