Documentation for ThisFolder: ConvertSpacesToUnderscores 1.023

ThisFolder: ConvertSpacesToUnderscores™ is Copyright ©1999-2006 Andrew Davidson. All rights reserved.
ThisFolder™, ThisFolder.com™, and ThisFolder: ConvertSpacesToUnderscores™ are trademarks of Andrew Davidson.
Thank you for purchasing ThisFolder: ConvertSpacesToUnderscores! We hope that you will find it useful.
If you did not purchase this software, please go to http://www.ThisFolder.com/Convert-Spaces-To-Underscores/ to purchase a valid license so you can use ThisFolder: ConvertSpacesToUnderscores legally.
If you have any suggestions to make ThisFolder: ConvertSpacesToUnderscores better, please do not hesitate to email us by clicking the "Email Tech Support..." button in the About box (choose "About" menu command).

Introduction

ThisFolder: ConvertSpacesToUnderscores quickly converts spaces to underscores in the names of all files in a folder you choose. For example, a file My Long File Name.txt will be renamed as My_Long_File_Name.txt. You can preview all operations before doing anything, to make sure files will be renamed properly.

Quick Start

To use ThisFolder: ConvertSpacesToUnderscores, right-click on a folder in Windows Explorer and choose "ThisFolder: ConvertSpacesToUnderscores..." from the context menu.
In the dialog box that appears, just click "Do It" to do it!
That's it!
Do It performs the operation.
Preview previews the operation.
Explore opens the selected folder in Windows Explorer.
Set... chooses a new folder to process.
If Exit When Done is checked, ThisFolder: ConvertSpacesToUnderscores will exit after Doing It.
If Recursive is checked, all folders below the chosen folder will be processed also.
Show Log/Hide Log shows/hides the operations log.
The system menu (in the upper left corner of the window) has a few menu commands:
Preferences allows you to edit the INI file to set additional options.
About displays information about ThisFolder: ConvertSpacesToUnderscores.
Save Log save the the contents of the log to a text file you choose.
Copy Log copies the contents of the log to the clipboard.

More Hints

System Requirements

Windows 98, Windows NT, Windows ME, Windows 2000, Windows XP; 16MB memory; 1MB disk space

Installation

To install ThisFolder: ConvertSpacesToUnderscores, use the installer, ThisFolderConvertSpacesToUnderscores1023.exe.

A standard uninstaller is included. You can uninstall ThisFolder: ConvertSpacesToUnderscores by going to Start > Control Panel > Add/Remove Programs.

Preferences

For most purposes, there is no need to change your preferences. However, there are several useful options available for people who want to control exactly how ThisFolder: ConvertSpacesToUnderscores works.
Preferences for ThisFolder: ConvertSpacesToUnderscores are stored in a standard INI file. You can edit this file and restart ThisFolder: ConvertSpacesToUnderscores to set your preferences. The file "ThisFolder ConvertSpacesToUnderscores.ini" should be located in the same folder as "ThisFolder ConvertSpacesToUnderscores.exe" unless you are using a -pref command line parameter to point to a different INI file. Preferences override command-line options.
If no INI file is found, the following default file will be created:
#------------------------------------------------------------------------
# ThisFolder ConvertSpacesToUnderscores.ini
#------------------------------------------------------------------------

[Settings]

# default folder if other folder not specified at startup
DefaultFolder=

# 0 - main window is a normal window
# 1 - main window is always on top
AlwaysOnTop=0

# 0 - minimize main window to task bar (like normal programs)
# 1 - minimize main window to system tray
MinimizeToSysTray=0

# confirm quit
ConfirmExit=0

# start maximized
StartMaximized=0

# start minimized
StartMinimized=0

# 0 - "Exit When Done" is unchecked by default
# 1 - "Exit When Done" is checked by default
ExitWhenDone=1

# 0 - "Recursive" is unchecked by default
# 1 - "Recursive" is checked by default
Recursive=1

# sound to play when done
AlertSound=

# 0 - normal Browse For Folder dialog box
# 1 - normal Browse For Folder dialog box, show files 
# 2 - use Save As dialog box to choose folders (has create folder button)
ChooseFolderInterface=1

# window rect (left,top,right,bottom)
# e.g. WindowRect=10,10,250,300
# leave blank to use default rect
WindowRect=

# window width
# leave blank to use default width
WindowWidth=

# window height
# leave blank to use default height
WindowHeight=

# On exit, save window size and/or position:
# 0 - don't save anything
# 1 - save exact window rect
# 2 - save window width
# 3 - save window height
# 4 - save window width & height
SaveWindowPosition=4

# 0 = can only run one copy of application at once... for multi-file explorer
# selection, only first file or folder is used.
# 1 = can run more than one copy of application at once... but will open
# many copies of the application if run on multiple files/folders.
AllowMultipleInstances=0

# 0 - hide log at startup (user must press "Show Log" to see log)
# 1 - show log at startup
ShowLog=0

# 0 - hide Exit button (click window close box to exit, or chose Close, or type Alt+F4)
# 1 - show Exit button
ShowExitButton=0

# 0 - hide ToolTips
# 1 - show ToolTips
ShowToolTips=1

# 0 - do it without asking for confirmation
# 1 - ask to confirm after user clicks "Do It"
ConfirmDoIt=0

# 0 - Wait until user clicks "Do It" 
# 1 - Do It immediately after running.  Do not wait for user to click "Do It"
# NOTE: If you hold down the Control key when running, this preference is ignored.
DoItImmediately=0

#------------------------------------------------------------------------
# ThisFolder ConvertSpacesToUnderscores.ini - Preferences file for ThisFolder: ConvertSpacesToUnderscores
#
# http://www.ThisFolder.com/ConvertSpacesToUnderscores/
#
# This file should be located in the same folder as "ThisFolder ConvertSpacesToUnderscores.exe"
# unless you are using a -pref command line parameter to point to a different
# INI file.  Note that these preferences override command-line options.
#------------------------------------------------------------------------
# EOF
#------------------------------------------------------------------------

Command Line Options

-pref "C:\Path To File\SettingsFile.ini" = location of preference (INI) file
-settings "C:\Path To File\SettingsFile.ini" = location of preference (INI) file
-preferences "C:\Path To File\SettingsFile.ini"= location of preference (INI) file
-doit = do it immediately when launched (no need to click "Do It") This is the same as the "DoItImmediately" preference.
-minimizetosystemtray = when application is minimized, show up as an icon in the system tray (instead of in the task bar)
-alwaysontop = window is always on top of other windows
-confirmexit = ask user before exiting application
-windowrect = window rect to use
-recursive = "Recursive" is checked by default
-log = turn on log
-logfile = location of log file

Release Information

Name: ThisFolder: ConvertSpacesToUnderscores
Version: 1.023
EXE Build Date: April 26, 2006

Contact

Email us at ThisFolder@ThisFolder.com

Web Links

ThisFolder: ConvertSpacesToUnderscores is part of the ThisFolder collection of Windows utilities.
ThisFolder: ConvertSpacesToUnderscores - Official Home Page:
Visit this page for information about ThisFolder: ConvertSpacesToUnderscores.
http://www.ThisFolder.com/Convert-Spaces-To-Underscores/
ThisFolder - Products Page
Visit this page to learn about all ThisFolder utilities.
http://www.ThisFolder.com/Products/
ThisFolder - Official Home Page:
Visit this page to learn about ThisFolder.
http://www.ThisFolder.com/

Copyright

ThisFolder: ConvertSpacesToUnderscores is copyrighted commercial software and you cannot legally use it without purchasing a valid license. You are not allowed to distribute ThisFolder: ConvertSpacesToUnderscores.
ThisFolder: ConvertSpacesToUnderscores™ is Copyright ©1999-2006 Andrew Davidson. All rights reserved.
All ThisFolder™ utilities are Copyright ©1999-2006 Andrew Davidson. All rights reserved.
ThisFolder™, ThisFolder.com™, and ThisFolder: ConvertSpacesToUnderscores™ are trademarks of Andrew Davidson.
You are allowed to use ThisFolder: ConvertSpacesToUnderscores only under the terms of the ThisFolder: ConvertSpacesToUnderscores License Agreement.
The current ThisFolder: ConvertSpacesToUnderscores License Agreement is available online at http://www.ThisFolder.com/Convert-Spaces-To-Underscores/license/
###