packages icon



 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:  October 7, 2024






 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:  October 7, 2024






 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:  October 7, 2024