manpagez: man pages & more
man lowercase(1)
Home | html | info | man
lowercase(1)                                                      lowercase(1)




NAME

       lowercase - rename files to all lowercase filenames


SYNOPSIS

       lowercase  [-h(elp)]  [-q(uiet)] [-x(tension_only)] [-X(tensions_only)]
       [-v(erbose)[ file...


DESCRIPTION

       lowercase renames files to all lowercase filenames.  If a filespec con-
       taining  path  information is send to lowercase, only the filename por-
       tion itself will be renamed.


OPTIONS

       -h     Print help and quit.

       -q     Be quiet.   Suppress  the  usual  messages  that  describe  file
              renames that actually occur.

       -v     Be verbose.  Generate messages for file renames that are skipped
              because the name does not change.

       -x     Change the case of the main file extension  only.   This  yields
              different results from the -X option only when a file has multi-
              ple extensions, e.g.  ".Tar.Lz".   Files  that  begin  with  "."
              (e.g. ".bashrc") will not be renamed.

       -X     Change  the  case of all file extensions.  This yields different
              results from the -x option only when a file has multiple  exten-
              sions,   like  ".Tar.Lz".   Files  that  begin  with  "."  (like
              ".bashrc") will be renamed.


EXAMPLES

       lowercase is quite simple to use, as shown in the examples below:

           lowercase FOObar_A.JPG fooBAR_B.png
           lowercase -x Source.Tar.Lz
           lowercase -X Source.Tar.Lz

       However, if you're trying to  rename  an  entire  directory  hierarchy,
       including  the  directories,  the  best way to handle it is probably as
       follows:

           find . -depth -mindepth 1 -type d -print0 | xargs -0 lowercase
           find . -type f -print0 | xargs -0 lowercase



BUGS

       Symbolic links are not well handled by lowercase.  For example, suppose
       you  have  a  file  called "FOObar" and a symbolic link called "BARfoo"
       pointing to it.  If you rename both of them using lowercase,  the  sym-
       link will become broken, as it will still point to "FOObar".


SEE ALSO

       convmv(1)


COPYRIGHT

       Copyright  (C) 2005-2020 by Brian Lindholm.  This program is free soft-
       ware; you can use it, redistribute it, and/or modify it under the terms
       of  the  GNU  General  Public License as published by the Free Software
       Foundation; either version 3, 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 MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  General
       Public License for more details.



littleutils                       2020 Oct 19                     lowercase(1)

littleutils 1.2.3 - Generated Mon Nov 30 18:49:57 CST 2020
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.