%++++++++
%.IDENTIFICATION trim.tex
%.PURPOSE        Man page of "trim"
%.AUTHOR         Francois Ochsenbein
%.VERSION   1.0  21-Feb-1995
%.VERSION   1.5  21-May-1996
%.VERSION   1.6  13-Apr-1999
%----------

\def\pgm{{\bf trim}\ }
\begin{manpage} {1}{trim}{remove trailing spaces}
	{August-2010}{Edition}
\def\pfile{{\em file}}
\syntax{ \pgm  [{\bf--v}] 
	[{\bf --b}|{\bf --bs}]
	[{\bf --t}]
	[{\em file...}] }

\mansec{ Description }
The \pgm just removes the trailing spaces from the specified
file, or the standard input; the result is printed on the standard output.
\pgm is noticeably faster than {\tt sed 's/  *\$//'}, especially
for file with long lines.

With the {\bf--v} option, \pgm prints also a line of statistics for each
file: number of lines, of empty lines, number of stripped bytes,
and the length of the longest record.

\mansec{Options}

\option{--v} asks for a line of statistics for each
file: number of lines, of empty lines, number of stripped bytes,
and the length of the longest record.

\option{--b} asks to remove the {\em blanks} only --- by defaults,
all trailing space characters (especially tabs) are removed.

\option{--bs} asks to {\em squeeze} the {blanks}: multiple blanks
are replaced by a single blank. 

\option{--t} asks to {\em expand} the tabs as in {\em expand(1)}

\mansec{Returned Status}
\pgm retuns 0 in case of success, and 1 if something failed
(inexistant or inaccessible file)
\seealso{expand(1) sed(1)}
\end{manpage}
