About SmartWrap
SmartWrap analyzes your text, detects paragraphs and lists within your text, and rewraps your text so it wraps naturally within your document or message. SmartWrap comes in many varieties so it is always available where you need it most. The following SmartWrap programs and plug-ins are available:
SmartWrap 2 includes a preferences panel that allows you to specify formatting options for text after it has been wrapped. For example, if you'd like your wrapped text to be hard-wrapped to 40 characters per line and indented 10 spaces, no problem. Simply specify these options in the SmartWrap Preferences. Lots of other options are available too.
Professional programmers can specify the insertion of special HTML formatting so text that has been through SmartWrap can be pasted directly into their web pages. Or perhaps you are a basic programmer and you need to insert "REM" statements before each line of a comment or remark. Just specify "REM" to be inserted before each line, and you're done.
These features and lots of others are discussed throughout this manual. Please click on the page numbers in the index to advance to any of the topics in which you are interested.
How to Upgrade from Previous Versions
To unsinatll older versions of SmartWrap simply find them and throw them in the trash. Some SmartWrap modules, like the item in the Services menu, will not be uninstalled until you log-out and log back in.
To upgrade plug-ins, you can just install the newer ones. SmartWrap will uninstall the older ones. You may have to log-out and log back in for the upgrade to take effect.
If an old TextService still appears in the Services menu, a log-out and log-in will be required.
Registering SmartWrap 2.x
After you purchase SmartWrap you'll receive an e-mail. Follow the instructions within this e-mail to register SmartWrap on your computer.
SmartWrap can also be ordered directly from the SmartWrap application by selecting "Register or Purchase" from the SmartWrap menu.
SmartWrap Installation
(SmartWrap requires Mac OS X 10.3.9 or later.)
Open the downloaded disk image and drag the SmartWrap folder icon to the Applications folder icon. Double-click the Applications folder and run SmartWrap.
To install the various SmartWrap Modules:
- Launch SmartWrap
- Select the module to install from the "Install" menu
- You're done
- Installations of plug-ins may be performed form the "Install" menu.
SmartWrap Preferences
Installation
The SmartWrap preferences are avaialble from the "Application" ("SmartWrap") menu of the SmartWrap application.
Use
The SmartWrap Preferences allows users to configure preferences for all of the SmartWrap modules.
While performing a SmartWrap operation from any of the SmartWrap modules, users can hold down different combinations of keys on the keyboard. SmartWrap, when executed, reads the keyboard to see which keys are down, and performs the SmartWrap according to the preferences set for those keys.
The modifier keys on the keyboard that are of significance to SmartWrap are:
- The Shift Key
- The Command Key (apple)
- The Option Key
There are eight combinations of modifier keys. They are all available from the popup menu in the SmartWrap Preferences window. Each combination of modifier keys has its own preference. "None" represents the default behavior if no modifier keys are depressed.
SmartWrap Text Service
The SmartWrap Text Service provides SmartWrap capability to any program that supports Apple's Text Services API. So if there is a program available for Mac OS X with which you would like to use SmartWrap, be sure to tell its developers that you want them to support Text Services!
Installation
The SmartWrap Text Service is built into the SmartWrap application. If the application is not in your Applications folder, the system will not find it, and thus will not be available in the Services menu. (The SmartWrap application can be inside of a folder that is nested inside the Applications folder.)
Use
- Launch a program that supports Text Services, like "Text Edit" or "Mail.app".
- Select some text that you would like to see SmartWrapped.
- Select "SmartWrap Selection" from the "Application-Name > Services" menu. (This menu is next to the Apple menu. There may be a very short delay the very first time you perform this operation.)
- You're done!
- If the program you're performing the wrap in doesn't allow services to modify selected text, select "SmartWrap to New Window" instead.
SmartWrap Automator Action
The SmartWrap Automator Action provides an automator step built right in to Automator!
Installation
The SmartWrap Automator Action is built into the SmartWrap application. If the application is not in your Applications folder, the system will not find it, and thus will not be available to Automator.
Use
- Quit and re-run Automator after installing SmartWrap.
- Click "SmartWrap" from the "Application" column and "SmartWrap" from the action column.
- Drag the action after text output and input.
- You're done!
SmartWrap Mail.app Plug-in
SmartWrap really works with Mail.app!
Installation
- Run the SmartWrap application.
- Select "Install Mail.app Plug-in" from the "Install" menu.
- You're done.
Use
- Open an EDITABLE message. (A new outgoing message or a replied to message.)
- Select text before using SmartWrap.
- Select "SmartWrap" from the "Edit" menu.
- You're done!
SmartWrap Eudora™ Plug-in
SmartWrap really works great with Eudora. You can even add a SmartWrap button to your Eudora toolbar! (The SmartWrap developer actually uses Eudora™.)
Installation
- Run the SmartWrap application.
- Select "Install Eudora Plug-in" from the "Install" menu.
- You're done.
Use
- Open a poorly wrapped e-mail message.
- Select "SmartWrap" from the "Edit > Message Plug-ins" menu.
- You're done!
- (Optional) Select text before using SmartWrap to wrap only the selection.
|
Tip: To add SmartWrap to your Eudora toolbar simply command-click the toolbar anywhere, then select SmartWrap from the "Edit > Message Plug-ins" menu.
|
SmartWrap BBEdit, MailSmith or TextWrangler Plug-in
The SmartWrap BBEdit™ Plug-in works in any program that supports BBEdit™ Plug-ins. This includes BBEdit, MailSmith, and the CodeWarrior IDE.
Installation
- Run the SmartWrap application.
- Select "Install BBEdit Plug-in" from the "Install" menu.
- You're done.
Use
- Open a text document or message, and select "SmartWrap" from the "Tools" menu.
- You're done!
- (Optional) Select text before using SmartWrap to wrap only the selection.
SmartWrap Scripting Addition
The SmartWrap Scripting Addition adds the "SmartWrap" command to the AppleScript language.
Installation
- Run the SmartWrap application.
- Select "Install Scripting Addition" from the "Install" menu.
- You're done.
Use
The Scripting Addition adds a SmartWrap command to the AppleScript language. The syntax is as follows:
set Output to SmartWrap of Input
or
set Output to SmartWrap of Input using preference for X
Where X should be substituted for one of the following texts:
- the keys depressed
- no keys
- option key
- command key
- shift key
- shift option keys
- shift command keys
- shift option command keys
- option command keys
SmartWrap for TextMate
SmartWrap works well with the TextMate Editor.
Installation
- Run the SmartWrap application.
- Select "Install TextMate Plug-in" from the "Install" menu.
- You're done.
Use
- Select poorly wrapped text in a TextMate window. Select "SmartWrap" from the "Text" menu.
- You're done!
SmartWrap for PowerMail
SmartWrap works well with PowerMail! However the only interface PowerMail provides for external manipulation is a scripts menu. So SmartWrap allows users to install a script in to this menu.
Installation
- Run the SmartWrap application.
- Select "Install PowerMail Script" from the "Install" menu.
- You're done.
Use
- Select poorly wrapped text in an outgoing PowerMail message window. Select "SmartWrap" from the "Scripts" menu.
- You're done!