README

Fri, 28 Dec 2012 17:15:23 +0100

author
Mike Becker <universe@uap-core.de>
date
Fri, 28 Dec 2012 17:15:23 +0100
changeset 38
7ded3ec4c417
parent 37
cf65b0ddd030
child 46
e0928e4b9a59
permissions
-rw-r--r--

added build instructions and example to README

universe@37 1 cline
universe@37 2 _________________________________________
universe@37 3 Copyright (C) 2013 Mike Becker
universe@37 4
universe@37 5 Contents:
universe@38 6 1) About ................................................................... 13
universe@38 7 2) Build instructions ...................................................... 25
universe@38 8 3) Usage example ........................................................... 41
universe@38 9 4) Contact Information ..................................................... 50
universe@38 10 5) License ................................................................. 56
universe@37 11
universe@37 12
universe@37 13 1) About ______________________________________________________________________
universe@37 14
universe@37 15 cline is a command line tool that counts code lines in your project folder. It
universe@37 16 is designed to recursively find any source file matching specific rules and
universe@37 17 count the line breaks within that file. You may specify file suffixes to include
universe@37 18 or exclude as well as regular expressions for code lines that shall be excluded
universe@37 19 (e.g. to exclude comments). By default a heuristic algorithm skips binary files.
universe@37 20 You may configure the restrictiveness of this algorithm with command line
universe@37 21 options.
universe@37 22
universe@37 23 Type cline --help for further information.
universe@37 24
universe@38 25 2) Build instructions _________________________________________________________
universe@38 26
universe@38 27 To build cline with gcc navigate to the root directory of the project and type:
universe@38 28 make
universe@38 29
universe@38 30 To rebuild cline type:
universe@38 31 make clean all
universe@38 32
universe@38 33 To install cline type (as root):
universe@38 34 make install
universe@38 35
universe@38 36 If you build cline with mingw under Windows, you need to type:
universe@38 37 make CONF=mingw
universe@38 38 or
universe@38 39 make CONF=mingw clean all
universe@38 40
universe@38 41 3) Example usage ______________________________________________________________
universe@38 42
universe@38 43 You can test cline right away with the cline project files. Just type:
universe@38 44 cline -rms .c,.h --exclude-cstyle-comments
universe@38 45
universe@38 46 This will find any .c or .h file recursively in the cline project folder and
universe@38 47 won't display other files (-m option). It will also skip comments when counting
universe@38 48 lines.
universe@38 49
universe@38 50 4) Contact Information ________________________________________________________
universe@37 51
universe@37 52 You can contact us by either one of the following mail addresses:
universe@37 53 universe@uap-core.de - Direct developer contact
universe@37 54 info@uap-core.de - Generic mail address
universe@37 55
universe@38 56 5) License ____________________________________________________________________
universe@37 57
universe@37 58 Copyright 2013 Mike Becker. All rights reserved.
universe@37 59
universe@37 60 Redistribution and use in source and binary forms, with or without
universe@37 61 modification, are permitted provided that the following conditions are met:
universe@37 62
universe@37 63 1. Redistributions of source code must retain the above copyright
universe@37 64 notice, this list of conditions and the following disclaimer.
universe@37 65
universe@37 66 2. Redistributions in binary form must reproduce the above copyright
universe@37 67 notice, this list of conditions and the following disclaimer in the
universe@37 68 documentation and/or other materials provided with the distribution.
universe@37 69
universe@37 70 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
universe@37 71 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
universe@37 72 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
universe@37 73 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
universe@37 74 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
universe@37 75 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
universe@37 76 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
universe@37 77 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
universe@37 78 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
universe@37 79 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
universe@38 80

mercurial