C++lint FAQs Last update: 2-Aug-07 ------------ UNIX/LINUX Q: How to I install the product? A: See the uinstall.txt file on this page. Q: When I click on a hyperlink, the editor I installed using seteditor jumps to the line one past the indicated line! A: Kwrite appears to start counting lines at 0 rather than line 1 like every other editor we've tested. For now, the workaround is for users to be aware of this situation. If your editor behaves this way as well, please notify support@cleanscape.net. If this issue is widespread, we will have to add a seteditor field to indicate whether the start count is 0 or 1. ---------------------------------------------------------------------- WINDOWS Installation/Un-installation Q: Why is a logfile opened after install (and uninstall)? A: Extensive changes were made to this installer, mostly by automating all installation and un-installation tasks. It has been tested on Win98, NT, 2k, XP, and Vista, but we would like to know any installation issues in the field. Q: What happens specifically when I run an installation? A: Five things may occur: 1. A directory subtree is created under %PROGRAMFILES%, specifically %PROGRAMFILES%\cleanscape\cpplint. 2. For Win98/XP/Vista, a registry backup or system restore point is created. 3. The 'main' subdirectory is added to the system PATH via the Registry (or autoexec.bat in Win98). 4. For WinNT+, the three versions of Visual Studio (see below) are searched for, and if found, the Cleanscape macros are added to each version via the Registry. 5. A Cleanscape GUI shortcut icon and shortcut to the PC-lint command summary are placed on the All Users desktop. Q: What happens if I reinstall the product? A: We do not recommend this; instead, uninstall and then install the product over again. In any case, be sure to save your 01.lic and serno.txt files from your 'main' subdirectory! (We will re-supply these at no charge if a problem occurs, but the license may be out of commission for up to one business day.) If you DO reinstall, the latest installers perform the following: - If the directory exists already, no files are copied. - If a registry backup or restore point already exists, no new one is made. - The desktop icons are rebuilt. - Visual Studio macros are searched for, and if found, you are given the option to delete and reinstall them. - The system PATH is checked and if the 'main' subdirec- tory is not found, it is added. Q: I installed the product but when I run cpplint from the command line or Explorer, I get "file not found". Why is that? A: In WinNT+, you must exit your command prompt or close your Explorer window and start a new one. In Win98, you must log out of Windows, re-run autoexec.bat, and restart Windows. These are Windows limitations. Q: I ran the installer on my Win64 machine and when I get "file not found" messages. What do I do? A: We are currently assessing a native 64-bit implementation; for now, run the following commands in a DOS box: cd c:\progra~1 mklink /D cleanscape c:\progra~2\cleanscape Q: Where is the uninstaller and what can it do? A: %PROGRAMFILES%\cleanscape\cpplint\main\uncpp.exe Since that directory is in your PATH already, you can simply enter uncpp and it should kick off for you. Confirmation dialogs will appear before taking each step. By default, uncpp will step through the four installations that took place, or you can specify them one-by-one using command-line parameters -ICON, -PATH, -VS, or -DIRS. If you want/need to roll back to a restore point as described above, use the Windows tool to accomplish it (scanreg in Win98 or System Restore in XP/Vista). Look for the entry containing "C++lint" in its description. Visual Studio Integration Q: What versions of Microsoft Visual Studio are supported? A: VS6, VS 2003.NET, VS2005 VCX2008, and VS2008. Q: I ran the installer. Now what? A: 1. Open your preferred version of Visual Studio. 2. Look in the Tools Dropdown. You should see a series of Cleanscape macros (currently 5). 3. Read the C++lint Users Guide for usage information. Q: How do I fine-tune the analysis for my project? A: 1. Run the Project Setup macro. As part of the process, a file called "std.lnt" is created and placed in your project directory. As of version 1.3, you have the option of using the Cleanscape GUI to create the analysis controls file (std.lnt) for you. 2. Edit this file to customize your analysis options. For details on analysis commands, read the PC-Lint Users Guide in your doc subdirectory. For your convenience, a command summary shortcut has been placed on your desktop (as of 21-Apr-07 release). 3. To edit your settings later, run the Edit LNT macro from the Tools dropdown in Visual Studio. Q: In VS 6, if I try to run a 2nd (or subsequent) analysis, I get this "File Save As" dialog box. What gives? A: The VS 6 IDE recognizes that there is text in the output window (i.e., the lint analysis results) that you are about to overwrite. It's giving you a chance to save it first. The best way to overcome this is to close the Output window (small 'x' in upper left corner), then rerun the analysis. Q: I set -wlib(4) in my std.lnt and I don't get the detailed messages I expect. What's going on? A: Cleanscape has paired the correct compiler options file (co-msc##.lnt) with the version of Visual Studio you're using. The co-msc##.lnt file by default sets -wlib(1) (errors only). To override this, remove that line from the compiler options file associated with your VS, loca- ted in %PROGRAMFILES%\cleanscape\cpplint\main\lbin\lf: VS 6 co-msc60.lnt VS.NET 2003 co-msc71.lnt VS 2005 co-msc80.lnt VCX2008/VS2008 co-msc90.lnt Cleanscape GUI Q: When I try to run the GUI, I get a warning from my firewall about port 5757. Whazzat? A: UPGRADE TO THE LATEST VERSION (21-Apr-07 or later). Previous GUI releases on Win2k+ needed an external stack for interprocess communication. Stacks are implemented using sockets, and this may alert the latest firewall / internet security programs. The latest version has been re-implemented without the stack. Command Line Q: How do I fine-tune the analysis for my program? A: 1. A "std.lnt" file in your source code root directory is best. As of version 1.3, you have the option of using the Cleanscape GUI to create this analysis controls file for you. 2. Edit this file to customize your analysis options. For details on analysis commands, read the PC-Lint Users Guide in your doc subdirectory. For your convenience, a command summary shortcut has been placed on your desktop (as of 21-Apr-07 release).