README

Wed, 31 May 2017 11:40:07 +0200

author
Mike Becker <universe@uap-core.de>
date
Wed, 31 May 2017 11:40:07 +0200
changeset 47
e5455e692b45
parent 46
e0928e4b9a59
child 48
0d2c13c24fd0
permissions
-rw-r--r--

replaces Makefiles with autoconf files

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

mercurial