// .TH capitize 1 "16 may 97"
// .IX capitize
// .\" See the copyright notice at the end of this file.
// .SH Name
// capitize \- Capitalize All Words In A File
// 
// .SH Syntax
// .B  capitize 
// .RB [ -k ]
// .RB [ 
// .IR wordchars ]
// .R < 
// .I infile 
// .R > 
// .I outfile
// .SH Description
// .B capitize
// reads standard input, 
// replaces the first letter of every word by its uppercase
// equivalent, replaces all other letters by their lowercase
// equivalents, and writes the result to standard output.
// .PP
// A word is defined as a maximal sequence of one or more
// consecutive bytes from the
// .I wordchars
// string, which defaults to the decimal digits and all letters
// in the ISO-8859-1 (ISO
// Latin-1) encoding. That includes all accented letters as well as
// es-zet, y-umlaut, n-cedilla, c-cedilla, and Icelandic thorn and edh.
// .PP 
// Non-word characters, and characters that have no 
// uppercase equivalent in ISO-8859-1 (such as digits, es-zet and y-umlaut) are 
// passed throug hunchanged.
// .PP
// Note that 
// .B all
// words are capitalized, including isolated letters,
// acronyms, hexadecimal digits, etc.
// .SH Options
// .TP 6
// .B \-k
// Keeps non-initial uppercase letters unchanged.
// .SH Bugs
// Likely.
// 
// .SH Author
// Jorge Stolfi
// 
// .\"
// .\" (****************************************************************************)
// .\" (* (C) Copyright 1992 Universidade Estadual de Campinas (UNICAMP)           *)
// .\" (*                    Campinas, SP, Brazil                                  *)
// .\" (*                                                                          *)
// .\" (* Author:                                                                  *)
// .\" (*                                                                          *)
// .\" (*   Jorge Stolfi        - CS Dept, UNICAMP <stolfi@dcc.unicamp.br>         *)
// .\" (*                                                                          *)
// .\" (* This file can be freely distributed, modified, and used for any          *)
// .\" (*   purpose, provided that this copyright and authorship notice is         *)
// .\" (*    included in any copy or derived version of this file.                 *)
// .\" (*                                                                          *)
// .\" (* DISCLAIMER: This software is offered ``as is'', without any guarantee    *)
// .\" (*   as to fitness for any particular purpose.  Neither the copyright       *)
// .\" (*   holder nor the authors or their employers can be held responsible for  *)
// .\" (*   any damages that may result from its use.                              *)
// .\" (****************************************************************************)
// .\"
// .\" Last edited on 2006-03-14 19:23:07 by stolfi