text::tabs(3perl) [debian man page]

Text::Tabs(3perl)					 Perl Programmers Reference Guide					 Text::Tabs(3perl)

NAME

       Text::Tabs -- expand and unexpand tabs per the unix expand(1) and unexpand(1)

SYNOPSIS

	 use Text::Tabs;

	 $tabstop = 4;	# default = 8
	 @lines_without_tabs = expand(@lines_with_tabs);
	 @lines_with_tabs = unexpand(@lines_without_tabs);

DESCRIPTION

       Text::Tabs does about what the unix utilities expand(1) and unexpand(1) do.  Given a line with tabs in it, expand will replace the tabs
       with the appropriate number of spaces.  Given a line with or without tabs in it, unexpand will add tabs when it can save bytes by doing so
       (just like "unexpand -a").  Invisible compression with plain ASCII!

EXAMPLE

	 #!perl
	 # unexpand -a
	 use Text::Tabs;

	 while (<>) {
	   print unexpand $_;
	 }

       Instead of the "expand" comand, use:

	 perl -MText::Tabs -n -e 'print expand $_'

       Instead of the "unexpand -a" command, use:

	 perl -MText::Tabs -n -e 'print unexpand $_'

LICENSE

       Copyright (C) 1996-2002,2005,2006 David Muir Sharnoff.  Copyright (C) 2005 Aristotle Pagaltzis This module may be modified, used, copied,
       and redistributed at your own risk.  Publicly redistributed modified versions must use a different name.

perl v5.14.2							    2010-12-30							 Text::Tabs(3perl)

EXPAND(1)						    BSD General Commands Manual 						 EXPAND(1)

NAME

     expand, unexpand -- expand tabs to spaces, and vice versa

SYNOPSIS

     expand [-t tab1,tab2,...,tabn] [file ...]
     unexpand [-a] [-t tab1,tab2,...,tabn] [file ...]

DESCRIPTION

     The expand utility processes the named files or the standard input writing the standard output with tabs changed into blanks.  Backspace
     characters are preserved into the output and decrement the column count for tab calculations.  The expand utility is useful for pre-process-
     ing character files (before sorting, looking at specific columns, etc.) that contain tabs.

     The unexpand utility puts tabs back into the data from the standard input or the named files and writes the result on the standard output.

     The following options are available:

     -a      (unexpand only) By default, only leading blanks and tabs are reconverted to maximal strings of tabs.  If the -a option is given, then
	     tabs are inserted whenever they would compress the resultant file by replacing two or more characters.

     -t tab1,tab2,...,tabn
	     Set tab stops at column positions tab1, tab2, ..., tabn.  If only a single number is given, tab stops are set that number of column
	     positions apart instead of the default number of 8.

ENVIRONMENT

     The LANG, LC_ALL and LC_CTYPE environment variables affect the execution of expand and unexpand as described in environ(7).

DIAGNOSTICS

     The expand and unexpand utilities exit 0 on success, and >0 if an error occurs.

STANDARDS

     The expand and unexpand utilities conform to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

     The expand command appeared in 3.0BSD.

BSD
								  April 21, 2002							       BSD