------------------------------------------------------------------------------
PHATstar Society [www.phatstar.net] society@phatstar.net #phatstar [MRC]
------------------------------------------------------------------------------

BBS MOD: "Un-Unicode File Renamer" (for File Listings In Mystic BBS; though it
	 would work whereever)
BBS MOD: "rename-crossplatform-safe.sh" (a general renaming utility for when
         people want to remove excess baggage from their file's file names.
CODERs: MeaTLoTioN [version 1.o & 2.o] & Anonymous Silent Partner v 3.0

Description: This BBS mod converts poorly named files into ASCII text so that
the file listings in Mystic BBS displays properly.  Unicode characters do not
display properly on BBSes as by their very nature they use ANSI and ASCII
rather than UTF-8 or UTF-16.

In LINUX: Place the Python (.py) and BASH (.sh) file in your /usr/bin/
directory.  Then type 
"chmod +x un-unicode-v1-filter-bash.sh"  After that
do the same with the Python code, entering:
"chmod +x un-unicode-v2-filter-python.py"
do the same with the updated Python code, entering:
"chmod +x rename-crosspatform-safe.py"
do the same with the updated BASH code, entering:
"chmod +x rename-crossplatform-safe.sh"

Then go to whatever directory you want to rename the files from and run the
commands:

un-unicode-v1-filter-bash.sh
or
un-unicode-v2-filter-python.py
or
rename-crossplatform-safe.py
or
rename-crossplatform-safe.sh

Be sure to note that you are on the base folder of where you'd like the files
renamed as all sub-directories will have the same renaming done to them.  This
is fully recursive.

MeaTLoTioN recommends using the Python script only, as the code is more
comprehensive in completely renaming stuff, but I think that its important to
see how you can use BASH scripting to produce a similar result.  I really
like it when coders include multiple methods of doing the same task, so that
is one reason both methods are included here.  Proper respect to MeaTLoTioN
for allowing both versions to be released here.  Props to Anon SilentPartner
for the p0wnage of mad ninja coding skills. :)


------------------------------------------------------------------------------
This code is released into the Libre under the GNU General Public License GPL.
The GPL license is included in this archive.  The specific version of the GPL
that it is licensed under is Version 2 of the GNU GPL.
------------------------------------------------------------------------------
