     pt(1)                                                                 pt(1)
                               Pluto Text utility 0.6

     NAME
          pt - Pluto Text file utility

     SYNOPSIS
          pt [-options] file...

     DESCRIPTION
          pt is a simple and easy to use utility that performs various operation
          on text files. One or many files, wildcard allowed, can be specified
          in command line. If no file is specified, standard input (console) is
          taken as default input, and standard output as output file.

          Each processed file is backed up before operations, unless the -b
          option is specified. The backup files have the name of the original
          filename concatenated with a tilde (~).

          If you want to specifie an input file and an output file, you can
          type:
               pt [-options] <inputfile >outputfile

          When the program starts it loads the file .ptrc looking for it in the
          home directory of the user. In this file there are some default
          settings that the user can change at his own desire. To see the
          possibilities enter
               pt -r
          This will create a default .ptrc in your home directory with
          explanation for each entry.

        OPTIONS
          -L   Convert any character to lowercase.

          -U   Convert any character to uppercase.

          -W   Convert first letter of any word to uppercase.

          -P   Convert first letter of any period to uppercase. Period ends on a
               dot.

          -A   Convert first letter of any paragraph to uppercase. Paragraph
               ends on an enter.

          -S   Switch uppercase to lowercase and vice versa. Can be used with
               other case operations.

          -u   Convert to UN*X text file format. Every enter will be converted
               to a newline character. All format translation functions works on
               all three formats as well.

          -d   Convert to DOS text file format. Every enter will be converted to
               a carriage return plus a newline characters.

                                        - 1 -         Formatted:  March 14, 2000

     pt(1)                                                                 pt(1)
                               Pluto Text utility 0.6

          -m   Convert to MAC text file format. Every enter will be converted to
               a carriage return character.

          -e   Remove Enters that are not at the end of a paragraph. This
               function will transform all the enter found inside a paragraph to
               a space.

          -t   Convert Tabs to Spaces. Tab size can be specified in .ptrc
               configuration file.

          -s   Convert Spaces to Tabs. Tab size can be specified in .ptrc
               configuration file.

          -i   Perform indentation. This function shifts the beginning of each
               line to the right inserting a number of spaces, depending on the
               keywords found inside itself. The keywords will be looked for in
               .ptrc configuration file.

          -c   Encrypt output, using the password stored in .ptrc. WARNING! The
               algorythm is very simple and does not guarantee security. You
               should give no read access to your .ptrc if you want to be sure
               that nobody can read your password.

          -y   Uncrypt input, using the password stored in .ptrc.

          -b   Strip binary part of the file. Simply deletes bytes with 8th bit
               set.

          -y   Strip 8th bit. Clear 8th bit of each byte.

          -l   Deletes each space and tab before a newline or carriage return
               character.

          -b   Don't make backup copies of processed files.

          -r   Create default configuration file .ptrc in user's home directory.

          -v   Verbose mode. Selecting this switch will print the name of each
               processes file.

          -V   Print version information.

     SEE ALSO
          sed, pr, tr

     ACKNOWLEDGEMENTS
          I made pt because i felt the need of a simple and easy to use utility
          to perform some simple operations that i make very often. I need it
          expecially for scripts.

                                        - 2 -         Formatted:  March 14, 2000

     pt(1)                                                                 pt(1)
                               Pluto Text utility 0.6

          Simone Chemelli <genius@chiara.dei.unipd.it> and Gabriele Lamon
          <shark@chiara.dei.unipd.it> give me a lot of useful advices. The
          "Remove Enters that are not at the end of a paragraph" function was
          inspired by shark's suga utility.

     AUTHORS
          Piero Orsoni <pallas@chiara.dei.unipd.it>
          Pluto Italian Linux User Group <linux@chiara.dei.unipd.it>
              http://www.dei.unipd.it/it/linux/pluto

     COPYRIGHT
          Copyright (C) 1996 Piero Orsoni.  This program is free software; you
          can redistribute it and/or modify it under the terms of the GNU
          General Public License as published by the Free Software Foundation;
          either version 2 of the License, or (at your option) any later
          version.

          This program is distributed in the hope that it will be useful, but
          WITHOUT ANY WARRANTY; without even the implied warranty of
          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
          General Public License for more details.

                                        - 3 -         Formatted:  March 14, 2000