User Manual TextWrangler THE Text Editor for Anyone who Types Bare Bones Software, Inc. ™ TextWrangler 3.0 Product Design Rich Siegel, Patrick Woolsey, Jim Correia, Steve Kalkwarf Product Engineering Jim Correia, Jon Hueras, Steve Kalkwarf, Rich Siegel, Steve Sisak Documentation Philip Borenstein, Stephen Chernicoff, John Gruber, Simon Jester, Jeff Mattson, Jerry Kindall, Caroline Rose, Rich Siegel, Patrick Woolsey Additional Engineering Seth Dillingham – Macrobyte Resources http://www.macrobyte.net Polaschek Computing http://www.polaschek-computing.com Icon Design Ultra Maroon Design http://www.ultramaroon.com updates by Bryan Bell http://www.bryanbell.com/ PCRE Library Package written by Philip Hazel and © 1997-2004 University of Cambridge, England TextWrangler and the TextWrangler User Manual are copyright ©2003-2009 Bare Bones Software, Inc. All rights reserved. Published and printed in USA. Bare Bones Software, Inc. P. O. Box 1048 Bedford, MA 01730–01048 (978) 251-0500 (978) 251-0525 fax http://www.barebones.com/ Sales information: [email protected] Technical support: [email protected] TextWrangler is a trademark of, and BBEdit and “It Doesn’t Suck” are registered trademarks of Bare Bones Software, Inc. Information in this document is subject to change without notice and does not represent a commitment on the part of the copyright holder. The software described in this document is furnished under a license agreement. Warranty and license information is included on the next page of this user manual. The owner or authorized user of a valid copy of TextWrangler may reproduce this publication for the purpose of learning to use such software. No part of this publication may be reproduced or transmitted for commercial purposes, such as selling copies of this publication or for providing paid-for support services. Macintosh, Mac OS X, Power Macintosh, and AppleScript are trademarks of Apple Computer, Inc. PowerPC is a trademark of International Business Machines Corp. All other trademarks are the property of their respective owners. License Agreement: You, the Licensee, assume responsibility for the selection of the program TextWrangler to achieve your intended results, and for the installation, use, and results obtained from the program. Breaking the package seal and installing the program constitutes your acceptance of these terms and conditions. If you do not accept these terms and conditions, then do not break the package seal or install the software. License: You may use the program and documentation on any desired number of machines and copy the program and documentation into any machine-readable or printed form for backup or support of your use of the program and documentation on those machines, provided that no copy of the program and documentation may be used by anyone other than you. • Your use of the program and documentation is limited solely to internal use. Without limiting the generality of the foregoing, you may not, directly or indirectly, transfer, convey, distribute, or provide the program or access to the program to any third party, whether by means of a bundling, publishing, or hosting arrangement, or otherwise and whether or not for money or other consideration, without the express prior written consent of Bare Bones Software, Inc. • You may not use or copy the program or documentation, or any copy thereof, in whole or in part, except as provided in this Agreement. • You also may not modify the program or documentation, or any copy thereof, in whole or in part. If you use, copy, modify, distribute, or transfer the program or documentation, or any copy thereof, in whole or part, except as expressly provided for in this Agreement, your license is automatically terminated. Term: The license is effective on the date you accept this Agreement, and remains in effect until terminated as indicated above or until you terminate it. If the license is terminated for any reason, you agree to destroy the program and documentation, together with all copies thereof, in whole or in part, in any form, and to cease all use of the program and documentation. Limited Warranty and Limitation of Remedies: The program, documentation and any support from Bare Bones Software, Inc., are provided “as is” and without warranty, express and implied, including but not limited to any implied warranties of merchantability and fitness for a particular purpose. In no event will Bare Bones Software, Inc. be liable for any damages, including lost profits, lost savings, or other incidental or consequential damages, even if Bare Bones Software, Inc. is advised of the possibility of such damages, or for any claim by you or any third party. General Terms: This Agreement can only be modified by a written agreement signed by you and Bare Bones Software, Inc. and changes from the terms and conditions of this Agreement made in any other manner will be of no effect. If any portion of this Agreement shall be held invalid, illegal, or unenforceable, the validity, legality, and enforceability of the remainder of the Agreement shall not in any way be affected or impaired thereby. This Agreement shall be governed by the laws of The Commonwealth of Massachusetts, without giving effect to conflict of laws provisions thereof. As required by United States export regulations, you shall not permit export of the program or any direct products thereof to any country to which export is then controlled by the United States Bureau of Export Administration, unless you have that agency's prior written approval. Use of the program and documentation by military and civilian offices, branches or agencies of the U.S. Government is restricted in accordance with the applicable Federal Acquisition Regulations (under which the program and documentation constitute "restricted computer software" that is "commercial computer software") or Department of Defense Federal Acquisition Regulations Supplement (under which the program and documentation constitute "commercial computer software" and "commercial computer software documentation") to that consistent with only those rights as are granted pursuant to the terms and conditions hereof. Acknowledgment: You acknowledge that you have read this agreement, understand it, and agree to be bound by its terms and conditions. You further agree that it is the complete and exclusive statement of the agreement between you and Bare Bones Software, Inc. which supersedes all proposals or prior agreements, oral or written, and all other communications between you and Bare Bones Software, Inc. relating to the subject matter of this agreement. Contents Chapter 1 Welcome to TextWrangler 15 Getting Started . 15 What Is TextWrangler? . 15 How Can I Use TextWrangler? . 16 Editing Source Code – 16 Editing Text Files – 16 Human Interface Notes . 17 Dynamic Menus – 17 Bypassing Options Dialogs – 17 Keyboard Shortcuts for Commands – 17 Contextual Menus – 18 Snappy Palettes – 18 Dialog Box Key Equivalents – 18 What’s New in this Version . 20 Info on New Features – 20 TextWrangler Discussion Group . 21 Support Services . 21 How to contact us – 21 Chapter 2 Installing TextWrangler 23 Basic Installation . 23 System Requirements – 23 Installing TextWrangler – 23 Updating an Existing Copy – 24 Upgrading from a Previous Version – 24 Welcome Dialog and Registration – 24 TextWrangler’s Application Support Folders . 25 Using the Global Application Support Folder – 25 Using a Local Application Support Folder – 25 Application Support Folder Contents – 26 Language Modules – 26 Menu Scripts – 26 Plug-Ins – 26 Scripts – 27 Shutdown Items – 27 Startup Items – 27 Stationery – 27 Text Factories – 28 Unix Support – 28 Preference Files and Folders . 28 TextWrangler Preferences File – 28 TextWrangler Preferences Folder – 28 v Chapter 3 Working with Files 31 Launching TextWrangler . 31 Startup Items . 32 Creating and Saving Documents . 33 Saving a Copy of a File – 35 File Saving Options – 35 File State – 36 Long File Names – 36 Saving with Authentication – 36 Saving Compressed Files with bz2 and gzip – 37 Opening Existing Documents . 37 Choosing the Encoding for a Document – 37 Using the Open Command – 39 Opening bz2 or gzip Files and Binary plists – 40 Using the Open Hidden Command – 41 Using the Open from FTP/SFTP Server Command – 41 Using the Open Selection Command – 41 Using the Open File by Name Commands – 42 Using the Open Counterpart Command – 42 Using the Open Recent Command – 43 Using the Reopen using Encoding Command – 43 An International Text Primer . 43 International Text in TextWrangler – 43 Unicode – 44 Saving Unicode Files – 44 Opening Unicode Files – 45 Accessing FTP/SFTP Servers . 46 Opening Files from FTP/SFTP Servers – 46 Saving Files to FTP/SFTP Servers – 48 Using TextWrangler from the Command Line . 50 Using Stationery . 50 Hex Dump for Files and Documents . 51 Making Backups . 51 Printing . 52 Text Printing Options – 52 Chapter 4 Editing Text with TextWrangler 55 Basic Editing . 56 Moving Text – 56 Multiple Clipboards – 57 Drag and Drop – 58 Multiple Undo . 58 Window Anatomy . 59 The Tool Bar – 60 The Split Bar – 61 The Navigation Bar – 62 The Documents Drawer – 65 The Status Bar – 66 vi Table of Contents The View Menu . 67 Text Display – 67 Hide/Show Tool Bar – 68 Hide/Show Navigation Bar – 68 Hide/Show Documents Drawer – 68 Balance – 68 Previous Document/Next Document – 68 Open in Separate Window – 68 Get Info – 69 Reveal in Finder – 69 Open in Super Get Info – 69 Cursor Movement and Text Selection . 70 Clicking and Dragging – 70 Arrow Keys – 71 CamelCase Navigation – 72 Rectangular Selections – 72 Working with Rectangular Selections – 72 Scrolling the View – 75 The Delete Key – 75 The Numeric Keypad – 76 Go To Line Command – 77 Function Keys – 77 Resolving URLs – 78 Text Options . 78 Editing Options – 78 Display Options – 79 How TextWrangler Wraps Text . 81 Soft Wrapping – 82 Hard Wrapping – 83 The Insert Submenu . 85 Inserting File Contents – 86 Inserting File & Folder Paths – 86 Inserting a Folder Listing – 86 Inserting a Page Break – 86 Inserting Time Stamps – 86 Comparing Text Files . 87 Compare Against Disk File – 89 Multi-File Compare Options – 89 Using Markers .