11README for CCCC versions 3.2.x
22==============================
33
4- [ ![ Github CI] ( https://github.com/sarnold/cccc/actions/workflows/ci.yml/badge.svg )] ( https://github.com/sarnold/cccc/actions/workflows/ci.yml )
5- [ ![ Conda CI] ( https://github.com/sarnold/cccc/actions/workflows/conda.yml/badge.svg )] ( https://github.com/sarnold/cccc/actions/workflows/conda.yml )
6- [ ![ Debian packages] ( https://github.com/sarnold/cccc/actions/workflows/debs.yml/badge.svg )] ( https://github.com/sarnold/cccc/actions/workflows/debs.yml )
7- [ ![ Release CI] ( https://github.com/sarnold/cccc/actions/workflows/release.yml/badge.svg )] ( https://github.com/sarnold/cccc/actions/workflows/release.yml )
4+ |ci | |conda | |debs | |release |
85
9- [ ![ CCCC License] ( https://img.shields.io/badge/license-GPL2-green.svg?dummy )] ( https://github.com/sarnold/cccc/blob/master/cccc/COPYING )
10- ![ GitHub tag (latest SemVer pre-release)] ( https://img.shields.io/github/v/tag/sarnold/cccc?include_prereleases )
11- [ ![ Github Issues] ( https://img.shields.io/github/issues/sarnold/cccc )] ( https://github.com/sarnold/cccc/issues?q=is:issue+is:open )
6+ |tag | |license | |issues |
127
13- [ ![ Conda Version] ( https://img.shields.io/conda/vn/conda-forge/cccc.svg )] ( https://anaconda.org/conda-forge/cccc )
14- [ ![ Conda Platforms] ( https://img.shields.io/conda/pn/conda-forge/cccc.svg )] ( https://anaconda.org/conda-forge/cccc )
8+ |vconda | |pconda |
9+
10+ What is it?
11+ -----------
1512
1613This is a maintenance update of the last (sourceforge) release of the program
1714CCCC (C and C++ Code Counter). This software performs analysis and reports
@@ -21,12 +18,22 @@ Ada95, which were supported in previous versions are presently not supported
2118new site for CCCC development is: https://github.com/sarnold/cccc and for
2219current documentation see: http://sarnold.github.io/cccc/
2320
24- * [ Github Action] ( https://github.com/marketplace/actions/cccc-action ) - Now available as a github action!
25- * [ Quick Install] ( https://github.com/sarnold/cccc/blob/master/README_install.rst ) - Quick start install instructions
26- * [ User Guide] ( http://sarnold.github.io/cccc/CCCC_User_Guide.html ) - User guide (updated)
27- * [ Release Notes] ( https://github.com/sarnold/cccc/blob/master/CHANGELOG.md ) - Autogenerated changelog for github releases (with a little SVN history for context)
28- * [ Software API docs] ( http://sarnold.github.io/cccc/api/html/index.html ) - Software API documentation with design diagrams, etc
29- * [ Complexity Metrics] ( http://sarnold.github.io/cccc/metrics/cccc.html ) - Source code metrics for a source code metrics tool... ;)
21+ * `Github Action `_ - Now available as a github action!
22+ * `Quick Install `_ - Quick start install instructions
23+ * `User Guide `_ - User guide (updated)
24+ * `Release Notes `_ - Autogenerated changelog for github releases (with a little SVN history for context)
25+ * `Software API docs `_ - Software API documentation with design diagrams, etc
26+ * `Complexity Metrics `_ - Source code metrics for a source code metrics tool... ;)
27+
28+ .. _Github Action : https://github.com/marketplace/actions/cccc-action
29+ .. _Quick Install : https://github.com/sarnold/cccc/blob/master/README_install.rst
30+ .. _User Guide : http://sarnold.github.io/cccc/CCCC_User_Guide.html
31+ .. _Release Notes : https://github.com/sarnold/cccc/blob/master/CHANGELOG.md
32+ .. _Software API docs : http://sarnold.github.io/cccc/api/html/index.html
33+ .. _Complexity Metrics : http://sarnold.github.io/cccc/metrics/cccc.html
34+
35+ Background
36+ ----------
3037
3138CCCC is a command line tool, originally implemented for Linux and other
3239POSIX-style platforms, but also buildable on the Win32 platform. Files
@@ -67,6 +74,9 @@ to which you have and whether it is installed at the default position
6774in the filesystem). On Linux and similar platforms the shell script
6875build_posixgcc.sh should still work.
6976
77+ Historical
78+ ----------
79+
7080As of the last upstream release (ver 3.1.4) the reference build tool for the
7181Win32 platform is the freely distributed Microsoft Visual C++ Toolkit 2003.
7282As this toolkit does not contain a 'make' style program the script
@@ -125,7 +135,10 @@ domain with no restrictions, other than the pious hope that should anyone
125135base a derivative work on it I will be given due credit. The current version
126136is released under the GNU Public License (including the bundled PCCTS source).
127137
128- The upcoming 3.1.5 release will be a maintenance release to clean up the build and
138+ Notes from the maintainer
139+ -------------------------
140+
141+ The initial 3.1.5 release was a maintenance release to clean up the build and
129142makefile config (enabling parallel make) and fix a build error with recent gcc.
130143The pccts build target "mini" builds only the tools required to build cccc,
131144while the make target "pccts" builds the complete toolset, and "all" will build
@@ -137,10 +150,8 @@ of (expensive) commercial engineering tools. It has a simple CLI and other
137150support like Jenkins plugins. Use it to find out your own complexity metrics.
138151You might be surprised...
139152
140- The above updates by Stephen L Arnold.
141-
142153Notes from the original author
143- ==============================
154+ ------------------------------
144155
145156CCCC was originally developed as a proof-of-concept tool for some ideas
146157relating to software metrics which I was investigating as an academic
@@ -169,13 +180,38 @@ available for the forseeable future from https://github.com/sarnold/cccc
169180as well as the original home at http://cccc.sourceforge.net
170181
171182
183+ .. |ci | image :: https://github.com/sarnold/cccc/actions/workflows/ci.yml/badge.svg
184+ :target: https://github.com/sarnold/cccc/actions/workflows/ci.yml
185+ :alt: CI Status
172186
187+ .. |conda | image :: https://github.com/sarnold/cccc/actions/workflows/conda.yml/badge.svg
188+ :target: https://github.com/sarnold/cccc/actions/workflows/conda.yml
189+ :alt: Conda Status
173190
191+ .. |ci | image :: https://github.com/sarnold/cccc/actions/workflows/debs.yml/badge.svg
192+ :target: https://github.com/sarnold/cccc/actions/workflows/release.yml
193+ :alt: Debian packages
174194
195+ .. |release | image :: https://github.com/sarnold/cccc/actions/workflows/release.yml/badge.svg
196+ :target: https://github.com/sarnold/cccc/actions/workflows/release.yml
197+ :alt: Release Status
175198
199+ .. |license | image :: https://img.shields.io/badge/license-GPL2-green.svg?dummy
200+ :target: https://github.com/sarnold/cccc/blob/master/cccc/COPYING
201+ :alt: License
176202
203+ .. |tag | image :: https://img.shields.io/github/v/tag/sarnold/cccc?include_prereleases
204+ :target: https://github.com/sarnold/cccc/releases
205+ :alt: GitHub tag (latest SemVer pre-release)
177206
207+ .. |issues | image :: https://img.shields.io/github/issues/sarnold/cccc
208+ :target: https://github.com/sarnold/cccc/issues?q=is:issue+is:open
209+ :alt: Issues
178210
211+ .. |vconda | image :: https://img.shields.io/conda/vn/conda-forge/cccc.svg
212+ :target: https://anaconda.org/conda-forge/cccc
213+ :alt: Conda Version
179214
180-
181-
215+ .. |pconfa | image :: https://img.shields.io/conda/pn/conda-forge/cccc.svg
216+ :target: https://anaconda.org/conda-forge/cccc
217+ :alt: Conda Platforms
0 commit comments