SlickEdit Tools Getting Started Guide
Transcription
SlickEdit Tools Getting Started Guide
SlickEditToolsCDCase2008 3/7/08 12:40 PM Page 1 SlickEdit Tools ® ® ® for Microsoft Visual Studio 1.919.473.0070 1.800.934.EDIT 1.919.473.0080 fax ® SlickEdit Tools SlickEdit Inc. 3000 Aerial Center Parkway, Suite 120 Morrisville, NC 27560 USA [email protected] www.slickedit.com Code Quick | Think Slick ® SlickEdit, Visual SlickEdit, Clipboard Inheritance, DIFFzilla, SmartPaste, Context Tagging, Slick-C, and Code Quick | Think Slick are registered trademarks of SlickEdit Inc. All other products or company names are used for identification purposes only and may be trademarks of their respective owners. Protected by U.S. Patent 5,710,926. Copyright 1988-2008 SlickEdit Inc. All rights reserved. ® SlickEdit Tools v2.0 ® ® for Microsoft Visual Studio Getting Started Guide Information in this documentation is subject to change without notice and does not represent a commitment on the part of SlickEdit Inc. The software described in this documentation is protected by U.S. and international copyright laws and by other applicable laws, and may be used or copied only in accordance with the terms of the license or nondisclosure agreement that accompanies the software. It is against the law to copy the software on any medium except as specifically allowed in the license or nondisclosure agreement. The licensee may make one copy of the software for backup purposes. No part of this documentation may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other than the licensee's personal use, without the express written permission of SlickEdit Inc. Copyright 1988-2008 SlickEdit Inc. Cover design copyright by SlickEdit Inc. Produced in the United States of America. SlickEdit, Visual SlickEdit, Clipboard Inheritance, DIFFzilla, SmartPaste, Context Tagging, Slick-C, and Code Quick | Think Slick are registered trademarks of SlickEdit Inc. All other products or company names are used for identification purposes only and may be trademarks of their respective owners. Protected by U.S. Patent 5,710,926. TABLE OF CONTENTS Table of Contents Licensing, Terms, and Conditions 5 End User License Agreement for SlickEdit Tools Software Maintenance and Support Terms and Conditions 7 Welcome 11 Installation and Setup 5 13 Installing SlickEdit Tools 13 Licensing 13 Activation 14 Deactivation 14 Repairing a License 15 Adjusting the System Date - Trial Licenses Only 15 What’s Next? 15 Review the Quick Start 15 Set Keyboard Shortcuts 16 Uninstalling SlickEdit Tools Features in SlickEdit Tools 16 17 Editing Toolbox 17 Versioning Toolbox 18 Documentation and Product Support 19 Documentation 19 Product Support 19 Other Resources 19 Index 21 SlickEdit® Tools - Getting Started Guide 3 TABLE OF CONTENTS 4 SlickEdit® Tools - Getting Started Guide LICENSING, TERMS, AND CONDITIONS Licensing, Terms, and Conditions End User License Agreement for SlickEdit Tools Software IMPORTANT THIS IS A LEGAL AGREEMENT BETWEEN YOU ("YOU") AND SLICKEDIT INC. ("COMPANY"). COMPANY IS WILLING TO LICENSE THE SLICKEDIT SOFTWARE TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS SOFTWARE LICENSE AGREEMENT ("AGREEMENT"). PLEASE READ THE TERMS CAREFULLY BEFORE OPENING THIS PACKAGE, OR IF DOWNLOADED, INSTALLING THE SOFTWARE, AS OPENING THE PACKAGE, OR IN THE CASE OF DOWNLOADED SOFTWARE, INSTALLING IT, WILL INDICATE YOUR ASSENT TO THEM. IF YOU DO NOT AGREE TO THESE TERMS, THEN COMPANY IS UNWILLING TO LICENSE THE SOFTWARE TO YOU, IN WHICH EVENT YOU MAY RETURN THE UNOPENED PACKAGE TO THE PLACE FROM WHICH IT WAS ACQUIRED WITHIN 14 DAYS OF THE DATE OF PURCHASE, AND YOUR MONEY WILL BE REFUNDED. IF YOU ARE VIEWING THIS AGREEMENT ELECTRONICALLY, SELECT THE "ACCEPT" BUTTON AT THE BOTTOM OF THIS PAGE TO INDICATE YOUR ACCEPTANCE TO THE TERMS OF THIS AGREEMENT. IF YOU ARE NOT WILLING TO BE BOUND BY ITS TERMS, SELECT THE "DECLINE" BUTTON AT THE BOTTOM OF THIS PAGE AND THE REGISTRATION OR INSTALLATION PROCESS WILL NOT CONTINUE. 1. The Company grants to You a nonexclusive, nontransferable license to use the SlickEdit Software computer program (the "Software"), and any accompanying documentation ("Documentation") solely for your own internal business needs pursuant to the terms and conditions of this Agreement. If you have acquired a trial version of the Software, the Software is for evaluation use only. Your trial version will expire after a period of 15 days. This license to use the Software is conditioned upon Your compliance with the terms of this Agreement. You shall be solely responsible for installation of the Software. Your use of the Software is limited to the licensing option purchased by You and indicated by the part number on Your invoice. Each licensing option is defined as follows. (i) Named User License. Software provided to You under this option may only be installed on any computer owned or controlled by You, but in no event shall the Software be (i) used by any person other than You and (ii) used on more than one computer at the same time. (ii) Concurrent User License. Software provided under this option may be installed on and processed by the Server computer located at a site indicated on the invoice, and may be installed on and simultaneously processed by the number of workstation and/or personal computers ("Concurrent Users") indicated on the invoice, which have electronic access to the Server computer located at any site indicated on the invoice and which are accessing the same data concurrently from more than one computer up to the predefined limit. 2. You may not transfer the Software to another entity or person. Any such transfer terminates your license under this Agreement. You shall not modify, translate, reverse assemble or reverse compile in whole or in part the Software that is provided in object code only (the "Object Code"). You shall not rent, sell, timeshare, lease, sublicense, transfer, publish, disclose, display or otherwise make available the Object Code or copies thereof to others. You may not copy the Object Code except as provided herein. You shall not tamper with, bypass or alter any security features of the Software or attempt to do so. 3. This license is not a sale. Title, ownership rights, and intellectual property rights in and to the Software and Documentation shall remain in Company. You agree to abide by the copyright laws and all other applicable laws of the United States. You acknowledge that the Software in source code remains a SlickEdit® Tools - Getting Started Guide 5 LICENSING, TERMS, AND CONDITIONS confidential trade secret of Company. Failure to comply with the above restrictions will result in automatic termination of this license and will make available to Company other legal remedies. You may not disclose any of Company’s proprietary or trade secret information relating to the Software to any third party. You agree to secure and protect the Software, Documentation and copies thereof in a manner consistent with the maintenance of Company's rights therein and to take appropriate action by instruction or agreement with your employees or consultants who are permitted access to the Software to satisfy your obligations hereunder. You may make one copy of the Software for backup or archival purposes in support of your permitted use of the Software. 4. Company warrants that the Software will perform substantially in accordance with its Documentation for 30 days after the date of receipt. Your exclusive remedy for breach of this limited warranty and Company’s entire liability shall be, in Company’s discretion, either return of the price paid to Company by You for the Software or repair or replacement of the Software after the Software and documentation are returned to Company with an applicable receipt. Company’s warranty is void if failure of the Software has resulted from accident, abuse or misapplication. COMPANY MAKES NO OTHER WARRANTIES, EXPRESS OR IMPLIED, WITH RESPECT TO THE SOFTWARE AND DOCUMENTATION AND SPECIFICALLY DISCLAIMS THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. COMPANY DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE. 5. TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL COMPANY BE LIABLE FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL OR PUNITIVE DAMAGES WHATSOEVER, INCLUDING ANY CLAIMS FOR LOST PROFITS, BUSINESS INTERRUPTION, LOST INFORMATION OR OTHER DAMAGES ARISING OUT OF THE USE OF INABILITY TO USE THE SOFTWARE. IN ALL EVENTS, COMPANY'S SOLE OBLIGATION OR LIABILITY UNDER THIS LICENSE IS THE REPLACEMENT OR REPAIR OF THE SOFTWARE OR A REFUND OF THE PURCHASE PRICE. 6. The Software and its documentation are "commercial computer software" and "commercial computer software documentation", respectively, and are provided with RESTRICTED RIGHTS under Federal Acquisition Regulations and agency supplements to them. Use, duplication or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 et seq. and DFARS 252.227-7015, and subparagraphs (a) through (d) of the Commercial Computer Software Restricted Rights at FAR 52.227-19, as applicable, or similar clauses in the NASA FAR Supplement. Manufacturer is SlickEdit Inc. 3000 Aerial Center Parkway, Suite 120, Morrisville, NC 27560. 7. You may terminate the license granted in Section 1 of this Agreement at any time by destroying or erasing your copy of the Software. Company may terminate this Agreement immediately and without notice if you fail to comply with any term or condition of this Agreement. In the event of termination of this Agreement, all the sections of this Agreement will survive except for Section 1. 8. This Agreement shall be governed by and construed in accordance with the laws of the State of North Carolina, U.S.A., without reference to conflicts of laws provisions or the 1980 U.N. Convention on Contracts for the International Sale of Goods and, as to matters affecting copyrights, trademarks and patents, by U.S. federal law. Any dispute with respect to this Agreement shall be brought and heard either in the North Carolina state courts located in Wake County, North Carolina, or the federal district court for the Eastern District of North Carolina located in Raleigh, North Carolina. In such event, the parties to this Agreement each consent to the in personam jurisdiction and venue of such courts. The parties agree that service of process upon them in any such action may be made if delivered in person, by courier service, by telegram, by telefacsimile or by first class mail, and shall be deemed effectively given upon receipt. 9. This Agreement sets forth the entire agreement between you and Company pertaining to the licensing of the Software, and supercedes in its entirety any and all written or oral agreements previously existing between the parties with respect to such subject matter. If any provision of this Agreement is held invalid or unenforceable, such provision shall be revised to the extent necessary to cure the invalidity or 6 SlickEdit® Tools - Getting Started Guide LICENSING, TERMS, AND CONDITIONS unenforceability, and the remainder of this Agreement shall continue in full force and effect. In the event of any conflict between any provision of this Agreement and any applicable law, the provision or provisions of this Agreement affected shall be modified to remove such conflict and permit compliance with such law and as so modified this Agreement shall continue in full force and effect. This Agreement may not be assigned without the consent of Company. CORP-SET2.0-07 Maintenance and Support Terms and Conditions These Maintenance and Support Terms and Conditions (the "Terms and Conditions") set forth the terms and conditions under which SlickEdit Inc. ("SlickEdit") will provide You ("Licensee") with maintenance and support services ("Services") for SlickEdit’s products indicated on Licensee’s invoice for which Licensee has purchased Services (the "Software"). 1. Obligations of SlickEdit. 1.1 Scope of Services. SlickEdit shall use commercially reasonable efforts to correct or replace the Software or provide the services necessary to remedy any Software function that does not operate in substantial conformance to the applicable documentation (an "Error"). SlickEdit’s technical support staff shall provide Licensee with "hotline" telephone and email consultation during the hours of 9:00 a.m. through 6:00 p.m. US Eastern Time, Monday through Friday, except observed SlickEdit holidays. Please refer to the SlickEdit web site for holiday listing. Such consultation shall include technical advice concerning the use and operation of the Software, including clarification of functions and features of any Software, and clarification of documentation, as well as Error verification, analysis, corrections and work-arounds. 1.2 Updates. SlickEdit shall make available to Licensee on its web site any new releases, revisions, corrections, and upgrades of the Software with version numbers that are incremented either by whole integers or in the tenths and patches that are made available by SlickEdit to its other licensees free of charge ("Updates"). Licensee may download Updates by following SlickEdit's then-current procedures set forth on its web site. Updates do not include new software that (i) port Software to new hardware or software platforms, or (ii) which provide significant new functionality on new hardware or software platforms. 2. Obligations of Licensee. Licensee shall provide SlickEdit with sufficient documentation, information, assistance, support and test time on Licensee's computer system as necessary, to duplicate the problem, certify that the problem is with the Software, and certify that the problem has been corrected. Licensee shall perform Error definition activities, and any remedial or corrective actions, as described in the Software user manuals and other system documentation provided to Licensee by SlickEdit, prior to seeking assistance from SlickEdit. 3. Excluded Services and Software. 3.1 Exclusions. SlickEdit will not be required to perform any Services where an Error relates to (a) incorporation or attachment of a feature, program or device to the Software or any part thereof; (b) accident, transportation, neglect, misuse, alteration, modification or enhancement of the Software; (c) the failure to provide a suitable installation environment; (d) use of the Software for other than the specific purpose for which the Software is designed; (e) use of the Software on any systems other than the specified hardware platform for such Software; or (f) failure to incorporate any Updates previously provided by SlickEdit. Corrections for difficulties or defects traceable by SlickEdit to the foregoing may, in SlickEdit’s sole discretion, be billed to Licensee at SlickEdit's then standard time and material charges. In addition, SlickEdit shall not be responsible for services relating to: (i) any hardware or peripheral devices; (ii) recreation or reentry of data lost for SlickEdit® Tools - Getting Started Guide 7 LICENSING, TERMS, AND CONDITIONS any reason whatsoever; (iii) performance of the generalized duties of a network administrator; or (iv) performance of the generalized duties of a software developer engaged to create miscellaneous software applications. 3.2 Supported Versions. The Services provided by SlickEdit hereunder shall be limited to the current version of the Software and the immediately preceding major release. A major release is generally denoted in the version number by a change to the number to the left of the first decimal point (e.g., a change from 2.x to 3.x). 4. Service Fees And Payment. 4.1 Service Fees. In exchange for the Services, Licensee will pay to SlickEdit an annual maintenance and support fee equal to 20% of the then-current list price for the Software licensed by Licensee ("Support Fees"). SlickEdit shall invoice Licensee for the Support Fees on the Effective Date. All Support Fees and other fees hereunder are due and payable in accordance with the payment terms listed on the invoice. Licensee shall, in addition to the other amounts payable for Services, pay all sales and other taxes, Federal, state, or otherwise, however designated, which are levied or imposed by reason of the transactions set forth in these Terms and Conditions, excluding only taxes based on SlickEdit’s income, according to the terms and conditions contained herein. 4.2 Late Payments. Any late payments will be subject to a late fee that will accrue at a monthly rate equal to the lesser of one and one-half percent (1¾%) of the outstanding balance, or the maximum rate allowable under applicable law. In the event that Licensee fails to pay amounts due hereunder on a timely basis, SlickEdit reserves the right to suspend the provision of all Services under these Terms and Conditions until such outstanding Service Fees (including applicable late fees) have been paid in full. 5. Term. The obligation of SlickEdit to provide Services will be for the term set forth in the applicable purchase order or invoice, unless earlier terminated pursuant to these Terms and Conditions. Upon the breach by Licensee of these Terms and Conditions or the License Agreement for the applicable Software, SlickEdit may, without payment or penalty, terminate its obligation to provide Services hereunder if such breach is not cured within 14 days of notice from SlickEdit. Reinstatement of Services following termination of the provisions of Services shall only be upon the mutual written agreement of the parties on terms and conditions determined by SlickEdit in its sole discretion. 6. LIMITED WARRANTY. SLICKEDIT WARRANTS THAT THE SERVICES WILL BE PERFORMED IN A WORKMANLIKE MANNER WITH THE ORDINARY DEGREE OF SKILL PREVALENT IN THE INDUSTRY. LICENSEE’S SOLE AND EXCLUSIVE REMEDY, AND SLICKEDIT’S ENTIRE LIABILITY, FOR SLICKEDIT’S BREACH OF THIS WARRANTY IS FOR SLICKEDIT TO PERFORM THE SERVICES IN A MANNER CONSISTENT WITH THIS WARRANTY. EXCEPT AS SPECIFICALLY SET FORTH IN THE PREVIOUS PARAGRAPH, THE SERVICES ARE PROVIDED "AS IS" WITHOUT WARRANTIES OF ANY KIND. WITHOUT LIMITING THE FOREGOING, SLICKEDIT DISCLAIMS ANY AND ALL WARRANTIES AND REPRESENTATIONS OF ANY KIND, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NONINFRINGEMENT. BOTH PARTIES ACKNOWLEDGE THAT THEY HAVE NOT ENTERED INTO THESE TERMS AND CONDITIONS IN RELIANCE UPON ANY WARRANTY OR REPRESENTATION OTHER THAN THOSE SET FORTH ABOVE IN THE IMMEDIATELY PRECEDING PARAGRAPH. 7. LIMITATION OF LIABILITY. 8 SlickEdit® Tools - Getting Started Guide LICENSING, TERMS, AND CONDITIONS IN NO EVENT WILL EITHER PARTY BE LIABLE FOR LOST PROFITS OR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR RELATED TO THESE TERMS AND CONDITIONS (WHETHER FROM BREACH OF CONTRACT, BREACH OF WARRANTY, OR FROM NEGLIGENCE, STRICT LIABILITY, OR ANY OTHER FORM OF ACTION), EVEN IF IT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THIS LIMITATION OF LIABILITY SHALL APPLY NOTWITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY HEREIN. IN NO EVENT WILL SLICKEDIT’S AGGREGATE, CUMULATIVE LIABILITY ARISING OUT OF OR RELATED TO THESE TERMS AND CONDITIONS EXCEED THE SUM OF ALL SUPPORT FEES ACTUALLY PAID TO SLICKEDIT BY LICENSEE UNDER THESE TERMS AND CONDITIONS DURING THE TWELVE (12) MONTH PERIOD IMMEDIATELY PRECEDING THE FIRST EVENT GIVING RISE TO LIABILITY. THIS LIMITATION OF LIABILITY IS CUMULATIVE, WITH ALL LIABILITY PAYMENTS BEING AGGREGATED TO DETERMINE SATISFACTION OF THE LIMIT. THE PARTIES ACKNOWLEDGE THAT THE PRICING SPECIFIED IN THESE TERMS AND CONDITIONS REFLECTS THE ALLOCATION OF RISK SET FORTH IN THESE TERMS AND CONDITIONS AND THAT SLICKEDIT WOULD NOT ENTER INTO THESE TERMS AND CONDITIONS WITHOUT THE FOREGOING LIMITATIONS OF ITS LIABILITY AND THE WARRANTY DISCLAIMERS CONTAINED HEREIN. 8. General Provisions. 8.1 Governing Law. These Terms and Conditions and the provision of Services will be governed in all respects by the laws of the State of North Carolina, without regard to North Carolina’s principles of conflict of laws. Both parties consent to jurisdiction in North Carolina and further agree that any cause of action arising out of or relating to these Terms and Conditions or the Services may be brought only in a state court in Wake County, North Carolina, or in a federal court in the Eastern District of North Carolina. 8.2 Independent Contractors. Each party will perform its obligations hereunder as an independent contractor and, except as expressly provided to the contrary in these Terms and Conditions, will be solely responsible for its own financial obligations. Nothing contained herein shall be construed to imply a joint venture or principal-agent relationship between the parties, and neither party will have any right, power, or authority to create any obligation, express or implied, on behalf of the other in connection with performance of its obligations hereunder. 8.3 Severability; Waiver. If any provision of these Terms and Conditions is held to be invalid or unenforceable for any reason by a court of competent jurisdiction, the remaining provisions will continue in full force without being impaired or invalidated in any way. The failure of either party to insist upon strict performance of any provision of these Terms and Conditions, or to exercise any right provided for herein, shall not be deemed to be a waiver of the future enforcement of such provision or right, and no waiver of any provision or right shall affect the right of the waiving party to enforce any other provision or right herein. 8.4 Notices. Any notice or communication permitted or required hereunder will be in writing and will be delivered by facsimile transmission with confirmation of receipt, in person or by courier, or mailed by certified or registered mail, postage prepaid, return receipt requested, and addressed to such facsimile number or address as either party may provide from time to time to the other. If notice is given in person, by courier, or by facsimile, it will be effective upon receipt; and if notice is given by mail, it will be effective three (3) business days after deposit in the mail. 8.5 Force Majeure. If performance of these Terms and Conditions, or any obligation hereunder (other than the obligation to pay) is prevented, restricted, or interfered with by any act or condition whatsoever beyond the reasonable control of the affected party (including without limitation the failure of any suppliers to perform), the party so affected, upon giving prompt notice to the non- SlickEdit® Tools - Getting Started Guide 9 LICENSING, TERMS, AND CONDITIONS affected party, will be excused from such performance to the extent of such prevention, restriction, or interference. 8.6 Assignment. No right or obligation of Licensee under these Terms and Conditions will be assigned, delegated, or otherwise transferred, whether by agreement, operation of law, or otherwise, without the express prior written consent of SlickEdit. Any purported assignment, delegation, or transfer in violation of this paragraph will be null and void. Subject to the foregoing, these Terms and Conditions in its entirety will bind each party and its permitted successors and assigns. 8.7 Amendments. Any amendments, modifications, supplements, or other changes to these Terms and Conditions must be in writing and signed by duly authorized representatives of each party. 8.8 Entire Agreement. These Terms and Conditions and the applicable purchase order and invoice constitute the entire agreement between the parties with respect to the subject matter hereof, and supersedes all prior or contemporaneous representations, understandings, agreements, communications, or purchase orders between the parties, whether written or oral, relating to the subject matter hereof. Effective February 1, 2006 10 SlickEdit® Tools - Getting Started Guide WELCOME Welcome At SlickEdit, our goal is to provide high performance tools with innovative features that increase developer productivity. For over twenty years, our commitment to you, our customer, has been to provide you with superior products and services that dramatically increase your ability to meet your aggressive software development deadlines. SlickEdit Tools offers a robust set of features that integrate into the Visual Studio environment, making SlickEdit Tools an essential productivity tool for power programmers. Developers are passionate about development tools. We share that passion. Therefore, we use our products daily in our own development activities and continually strive to exceed your expectations. Thank you for purchasing SlickEdit Tools v2.0. Please contact us if we can be of assistance. The SlickEdit Team SlickEdit® Tools - Getting Started Guide 11 WELCOME 12 SlickEdit® Tools - Getting Started Guide INSTALLATION AND SETUP Installation and Setup SlickEdit Tools v2.0 introduces two “toolboxes”: the Editing Toolbox and the Versioning Toolbox. Each toolbox is a separate product and is purchased separately. The Editing Toolbox is comprised of features that help you write and edit code. The Versioning Toolbox contains features that help you manage and control your source code. Installing SlickEdit Tools NOTES • SlickEdit Tools v2.0 now integrates with Microsoft Visual Studio 2008 as well as Microsoft Visual Studio 2005. • When trying out SlickEdit Tools, licensing covers both toolboxes, so both the Editing Toolbox and the Versioning Toolbox can be installed. The installer for SlickEdit Tools contains both toolboxes. Each toolbox can be added and removed individually. If only one toolbox is licensed, you should only install that toolbox. If you install a toolbox that is not licensed, SlickEdit operations and features for that toolbox appear in the editor, but they are disabled and menu items are dimmed. You can remove the features and disabled menu items by uninstalling the unlicensed toolbox (see Uninstalling SlickEdit Tools). Before installing the SlickEdit Tools toolboxes, review the Visual Studio system requirements. Installing SlickEdit Tools with both toolboxes requires an additional 50 MB of hard disk space. To install SlickEdit Tools, complete the following steps: 1. Close all instances of Visual Studio (devenv.exe) and the MSDN Help Viewer (dexplore.exe). 2. Locate and double-click the Windows installer package (.msi file) for SlickEdit Tools. 3. If you have a previous version of SlickEdit Tools, you will be prompted to uninstall it. 4. Read the Welcome information. Click Next. 5. Read the Note on Configuration Settings. Click Save to copy these instructions to your hard drive. Click Next to continue. 6. Review and accept the EULA (End User License Agreement). Click Next. 7. Enter your product key(s) and click Next. If this is a trial, you may request a Trial License at this stage. 8. On the Custom Setup screen, click Browse if you want to change the installation location. Click Next to continue. 9. Click Install. When the status message Merging packages with Visual Studio appears on the progress window, it can take up to one minute to complete the merge process. 10. Click Finish. Licensing SlickEdit Tools v2.0 uses FLEXnet™ Publisher from Macrovision manage licenses. SlickEdit® Tools - Getting Started Guide 13 INSTALLATION AND SETUP When Visual Studio with SlickEdit Tools is run, it checks for an activated license. If one can’t be found, the SlickEdit License Manager wizard is run. You can also manually run the SlickEdit License Manager by selecting SlickEdit > License Manager. The License Manager provides you with the following options: • Request a Trial License - This option you to a Web page where you can register for a trial. A license key will be e-mailed to you to activate the product. A trial can be converted to Full License by entering a Full License key at any time in the SlickEdit License Manager. • Purchase a license - This option takes you to a Web page where you can purchase a license. You can also visit the SlickEdit Web site at www.slickedit.com. Once you have purchased a license, use the Enter a license key option to activate it. • Enter a license key - To enter a license key and activate SlickEdit Tools, use this option after obtaining a license key from either of the above options. • Deactivate a license - This option appears only after a machine has been activated. You can use this option to return one of your activations to the pool, making it available for use on another computer. Activation After you enter a license key to activate the product, SlickEdit Tools contacts the license server over the Internet. You are permitted up to five concurrent activations of SlickEdit Tools, initially. You can contact SlickEdit Sales to get additional activations at no additional cost, if you need more. Activating SlickEdit Tools enables it to run on a particular machine. You can deactivate a license if you want to use it on a different machine. Uninstalling SlickEdit Tools does not automatically deactivate the license. Your license key is good for this version of the product. New versions will be released with a change to the major version number, like v2.0 or v3.0, or with changes to the minor version number, like v2.1 or v2.2. Fixes for a given version will use the third digit, like v2.0.1 or v2.0.2. Your license key will work for any versions that match the first two digits. Once you have activated a machine, you will not need to reactivate it until you upgrade to a new version of SlickEdit Tools. When a new version is released, you will need a new license key. Each machine will need to be reactivated using that key. Deactivation Once you have activated SlickEdit Tools on five machines, you will not be able to activate it on another machine until you have deactivated one of the other five. If you need more than five machines activated at one time, you can contact SlickEdit Sales to request additional activations at no cost. You can deactivate a license using the SlickEdit License Manager. Select SlickEdit > License Manager and then select the Deactivate a license option. You can also deactivate a license using a stand-alone utility shipped with SlickEdit Tools: vsact.exe in the flex subdirectory of your SlickEdit Tools installation directory. You can copy the flex directory from one machine to another and run vsact.exe. You can also download these utilities from the SlickEdit Web site. To deactivate a license with vsact.exe, type: vsact deactivate 14 SlickEdit® Tools - Getting Started Guide INSTALLATION AND SETUP If you have more than one license active on this machine, perhaps for other SlickEdit products, you will need to specify an ID for the license to deactivate. Run vsact list to display a list of the licenses and their IDs. NOTE Uninstalling SlickEdit Tools does not deactivate the license. If you have uninstalled SlickEdit Tools, you can copy the utilities in the flex subdirectory of another installation and run vsact to deactivate this license. Repairing a License FLEXnet Publisher identifies your machine using a combination of information about the hardware on this machine. No personal data is used in creating this ID. Small changes to your machine, like switching display cards, upgrading memory, or changing hard drives can cause the license to become “damaged”. A license can also be damaged by changing the system date by more than one day. When this happens you will need to repair the license. SlickEdit Tools automatically detects damaged licenses and launches the SlickEdit License Manager. You will be prompted to start the repair process. The number of repairs is limited, but enough are available to handle any reasonable hardware changes. If you run out of repairs, please contact Product Support. If enough hardware is changed, then this will appear to be a different machine and you will have to activate the license as though this was the first time Visual Studio with SlickEdit Tools was run. In that case, you will lose the activation you had previously. Therefore, we strongly recommend that you deactivate your license prior to making substantial changes to your computer’s hardware. Adjusting the System Date - Trial Licenses Only Changing the system date on your computer could damage your license. The SlickEdit License Manager records the date each time the product is run. If you run Visual Studio with SlickEdit Tools with a system date that is more than one day earlier than a previous run then your license will be damaged. This is part of the tamper protection on time-limited licenses, like a Trial License, and does not affect a Full License. Changing your system date is a normal part of testing time-based behavior in the software you are developing. For example, you may need to set your clock ahead to test alerts on a task management program. As long as you don’t run Visual Studio with SlickEdit Tools (or another FLEXnet licensed product) while your clock is set ahead, you will not have any repair issues. If you do need to run SlickEdit Tools, your license will be damaged when you run again at the current date. When this occurs, you can repair the license as described in Repairing a License. The number of repairs is limited, so you should be cautious about running SlickEdit Tools when your clock is set ahead. If you run out of repairs, please contact Product Support. Daylight savings time will not cause this to occur since it is only adjusting the date by one day. Only changes larger than one day will trigger this. What’s Next? Review the Quick Start After installation and activation, you may want to review the Quick Start. It provides a short walk-through of some of the major features to help you get up and running quickly. The Quick Start is a PDF, accessible from the SlickEdit Tools Start menu item and located in the C:\Program Files\SlickEdit Tools\docs directory. SlickEdit® Tools - Getting Started Guide 15 INSTALLATION AND SETUP Set Keyboard Shortcuts Many of the commands in SlickEdit Tools become much more useful if there are key bindings associated with them. While SlickEdit Tools defines default keyboard shortcuts for several commands already, after installing the product, you are strongly encouraged to assign keyboard shortcuts to the features you use most frequently. See the Help system (SlickEdit > SlickEdit Tools Help) for more information about what shortcuts are predefined and how to assign your own. Uninstalling SlickEdit Tools To remove SlickEdit Tools completely, including any installed toolboxes, double-click on the original .msi installation file and select Remove. This will delete the installation directory as well as any registry settings. You may be prompted to reboot for the removal to take effect. Alternatively, you can use Add/Remove Programs in Windows to uninstall. If an entry for SlickEdit Tools does not appear in the Add/Remove Programs list, you can uninstall it by completing the following steps: 1. Open a Command Prompt window. 2. Run the following, where [installer path] is the full path and file name of the original SlickEdit Tools installation file: msiexec /x "[installer path]" For example, to remove SlickEdit Tools v1.1.2 if the installer is in "c:\", run: msiexec /x "c:\st_010102_win_trial.msi" 3. A generic Windows Installer message is displayed, asking if you want to uninstall the program. Click OK. To uninstall an individual toolbox in SlickEdit Tools, double-click on the original .msi installation file and select Change. 16 SlickEdit® Tools - Getting Started Guide FEATURES IN SLICKEDIT TOOLS Features in SlickEdit Tools SlickEdit Tools improves developer productivity by extending and enhancing the functionality of Visual Studio. Rather than replacing the Visual Studio editor, we augment it with new capabilities that are seamlessly integrated into the Visual Studio environment. Features from the original version of SlickEdit Tools have been split into the two toolboxes. Features that make up each toolbox are listed below, with new features noted. See the Help system that is installed with each product for more information on any feature (SlickEdit > SlickEdit Tools Help). The Help system includes documentation for both toolboxes. In addition to a common Help system, the toolboxes share the SlickEdit Tools Assistant. The SlickEdit Tools Assistant is a new tool window that helps you learn more about all of the features available in both toolboxes. Each feature is summarized, with links to Help, options, tool windows, and videos provided when available. The tool window is displayed and docked to the right side of the editor window by default. Editing Toolbox The Editing Toolbox contains the following features: • Aliases and Acronyms - Use directory aliases to save keystrokes and mouse use when opening files. Use acronym expansion to save keystrokes when typing class, namespace, or function names in your code. After setting up the aliases and acronyms you want to use, aliases can be expanded with Ctrl+Space and acronyms with Ctrl+‘ (backtick). • Auto Code Doc Viewer - Extract header comments into MSDN-like documentation, fully linked HTML Help that can be browsed in Visual Studio as a tool window and exported for sharing with others. To use this feature, from the main menu, click SlickEdit > Show Auto Code Doc Viewer. • (New!) Code Annotations - Insert a comment or note about code at a certain location in the code, without actually modifying the source code. To work with Code Annotations, from the main menu, click SlickEdit > Show Code Annotations. • Code Navigation - Use keyboard shortcuts to jump from a symbol to its definition and to list all references for the current symbol. See the Help system for a list of available commands. • Comment Wrapping - Enable automatic wrapping of any type of multi-line comment as you type. You can also reflow existing comments in the current file. To enable wrapping, from the main menu, click Tools > Options, then in the tree, select SlickEdit > Editing Toolbox > Comment Wrapping. • Icon Extractor - Simplify the task of finding quality icons and applying them to your applications. To work with this feature, from the main menu, click SlickEdit > Show Icon Extractor. • Quick Launch and Load Files - Launch Visual Studio files or solutions into the SlickEdit application from within Visual Studio. Quickly load multiple files without having to search for them in the Solution Explorer tree. See the Help for instructions about using these features. • Quick Profiling - Fine-tune your profiling to get information about a specific section of code. This feature allows you to time many cases that aren’t possible with standard profilers, such as timing complex loops, recursive functions, and the time between an object’s creation and disposal. See the Help for information about using this feature. • Regex Evaluator - Interactively create and test regular expressions, which are used to express text patterns for searching. To use this feature, from the main menu, click SlickEdit > Show Regex Evaluator. SlickEdit® Tools - Getting Started Guide 17 FEATURES IN SLICKEDIT TOOLS • Word Completion - Use commands to search for and insert additional text from a matching string. See the Help for a list of available completion commands. Versioning Toolbox The Versioning Toolbox contains the following features: NOTE Some features in the Versioning Toolbox require initial configuration before the menu items are available for use. See the Help (SlickEdit > SlickEdit Tools Help) for more information. 18 • Backup History - View, compare, and restore versions of files without having to use source control. To use this feature, from the main menu, click SlickEdit > Show Backup History. • (New!) CVS/SVN Source Control Integration - Use CVS and Subversion source control commands directly in Solution Explorer. • DIFFzilla® - Graphically compare differences in files or directories. To use DIFFzilla, from the main menu, click SlickEdit > Show Diff. • (New!) Find Version - Find the versions of one or more files that match specific criteria, such as which files were checked in by a certain user over a certain amount of time. To use this feature, from the main menu, click SlickEdit > Find Version. • (New!) Line Version Info - View details about the check-in that last affected any specific line in a source file. To see version information for a line in the current file, right-click in the source file and select Versioning Toolbox > Line Version Info. • (New!) Version Graphs - View graphs depicting different historical aspects and trends of selected files. To view a graph for the current file, from the main menu, click SlickEdit > Version Graphs. • (New!) Version History - View the history of each version of a source file, including check-in comments, date, author, branches, and labels. To use this feature, from the main menu, click SlickEdit > Version History. • (New!) Visualizations - See different historical aspects for each line of a source file at a glance, side-by-side with that file's content. Each type of information is denoted by different configurable colors and schemes. Use the Version Visualizer to view a visualization—from the main menu, click SlickEdit > Visualizations. Five visualizations are available: o Fixed Date - Instantly determine when any part of a file was written. o Floating Date - Quickly see code that has changed during the last n days. o Label - Determine which parts of code are associated with a source control label range. o Relative Age - See the relative age of each line of code in a source file. This visualization answers the question, “How old is this?”. o User - See who wrote which lines of code in a source file. This visualization answers the question, “Who wrote this?”. SlickEdit® Tools - Getting Started Guide DOCUMENTATION AND PRODUCT SUPPORT Documentation and Product Support Documentation The SlickEdit Tools Help system is accessible through the menu item SlickEdit > SlickEdit Tools Help. Additionally, shortcuts to the readme, license agreement, and PDFs of the Quick Start and this Getting Started Guide are placed on the Windows Start menu for easy accessibility. These files are located in the C:\Program Files\SlickEdit Tools\docs directory. Please send documentation feedback to [email protected]. Product Support The Product Support Web site at www.slickedit.com/support provides a list of frequently asked questions and answers as well as information about upgrades and hot fixes. To contact Product Support, use the menu item SlickEdit > Contact Product Support. This will automatically gather your program information, such as the current version and serial number, that helps us to better answer your questions. You can also send e-mail to [email protected]. For problem reports, please provide the following information: • A description of the problem. • The language you are working in (C/C++, Java, etc.). • Your SlickEdit Tools program information. Select Help > About Microsoft Visual Studio, then select your version of SlickEdit Tools in the Installed products list. Copy the product details and paste the information in the problem report. • A code snippet to help us reproduce it (if possible). To speak to a member of our Product Support team, call the Support line at 1.919.473.0100. Telephone support is only available during business hours for customers with a valid Maintenance and Support Service Agreement. Other Resources Exchange ideas and get help from other SlickEdit Tools users in the SlickEdit Community Forums at http://community.slickedit.com. Also check out "Hello World" - the SlickEdit Developer Blog at http://blog.slickedit.com. SlickEdit® Tools - Getting Started Guide 19 DOCUMENTATION AND PRODUCT SUPPORT 20 SlickEdit® Tools - Getting Started Guide INDEX Index A about SlickEdit Tools 11 activation/licensing 13 Aliases and Acronyms 17 Auto Code Doc Viewer 17 B Backup History 18 blog 19 C Code Annotations 17 Code Navigation 17 Comment Wrapping 17 compatability with Visual Studio 13 completion 18 CVS/SVN Source Control Integration 18 D DIFFzilla® 18 documentation 19 feedback 19 Quick Start 15 E Editing Toolbox 17 EULA 5 expansion 17 F feature listing 17 Find Version 18 Fixed Date visualization 18 Floating Date visualization 18 forums 19 licensing/activation 13 repairing 15 Line Version Info 18 M Microsoft Visual Studio 2005 and 2008 13 msiexec 16 O other resources 19 P profiling 17 Q Quick Launch and Load Files 17 Quick Profiling 17 Quick Start 15 R readme 19 Regex Evaluator 17 Relative Age visualization 18 S shortcuts 16 Start menu 15 Subversion 18 support 19 terms and conditions 7 system requirements 13 T toolboxes 17 U graphs 18 uninstalling SlickEdit Tools 16 upgrades 19 User visualization 18 H V G header comments 17 Help system 19 How old is this? 18 I Icon Extractor 17 installing SlickEdit Tools 13 K keyboard shortcuts 16, 17 Version Graphs 18 Version History 18 Version Visualizer 18 Visualizations 18 W welcome 11 Who wrote this? 18 Word Completion 18 wrapping 17 L Label visualization 18 licensing license agreement 5 SlickEdit® Tools - Getting Started Guide 21 INDEX 22 SlickEdit® Tools - Getting Started Guide SlickEditToolsCDCase2008 3/7/08 12:40 PM Page 1 SlickEdit Tools ® ® ® for Microsoft Visual Studio 1.919.473.0070 1.800.934.EDIT 1.919.473.0080 fax ® SlickEdit Tools SlickEdit Inc. 3000 Aerial Center Parkway, Suite 120 Morrisville, NC 27560 USA [email protected] www.slickedit.com Code Quick | Think Slick ® SlickEdit, Visual SlickEdit, Clipboard Inheritance, DIFFzilla, SmartPaste, Context Tagging, Slick-C, and Code Quick | Think Slick are registered trademarks of SlickEdit Inc. All other products or company names are used for identification purposes only and may be trademarks of their respective owners. Protected by U.S. Patent 5,710,926. Copyright 1988-2008 SlickEdit Inc. All rights reserved.