Skip to content

Commit 2c12c21

Browse files
committed
Update README.md for 6.70 release.
Also list versions in reverse order (newest first), and provide better annotations for most of the versions.
1 parent 6344666 commit 2c12c21

File tree

1 file changed

+34
-11
lines changed

1 file changed

+34
-11
lines changed

README.md

+34-11
Original file line numberDiff line numberDiff line change
@@ -4,24 +4,47 @@ SCC: Strip C Comments — Snapshots
44
This repository contains the code for the SCC (Strip C Comments) program described in
55
[Remove Comments from C/C++ Code](http://stackoverflow.com/questions/2394017/) on Stack Overflow.
66

7-
There are currently 6 releases:
8-
* 4.03 (2008-06-07)
9-
* 4.04 (2008-11-27)
10-
* 5.05 (2012-01-23)
11-
* 6.16 (2016-01-19) — pre-release
7+
There are currently 7 releases:
8+
* 6.70 (2017-10-17) - stable release
9+
* 6.60 (2016-06-12) - stable release
1210
* 6.50 (2016-06-12) — pre-release
13-
* 6.60 (2016-06-12)
11+
* 6.16 (2016-01-19) — pre-release
12+
* 5.05 (2012-01-23) - stable release
13+
* 4.04 (2008-11-27) - stable release
14+
* 4.03 (2008-06-07) - stable release
1415

1516
These are tagged release/x.yz. The code is all on branch master.
1617

18+
Versions 4.03 and 4.04 are preliminary versions, possibly of historical
19+
interest.
20+
Functionally, they're almost identical, with minor code cleanups between
21+
the two versions.
22+
The meaning of the `-C` option was the opposite of the more modern
23+
versions; it enabled the removal of C++ style comments.
24+
1725
Version 5.05 handles C and older C++ code.
18-
It does not understand raw strings, or some of the other new features in C++
19-
(binary constants, punctuation in numbers, etc.).
26+
It does not understand raw strings, or some of the other new features in
27+
C++ (binary constants, punctuation in numbers, etc.).
28+
Compared to the earlier versions, it adds the `-s str` and `-q rep`
29+
options to replace the bodies of strings or character literals; it adds
30+
the `-c` option to print the comments instead of the code; it adds the
31+
`-n` option to preserve newlines in comments, to make it easier to
32+
back-track from stripped source to the original code.
2033

2134
Version 6.60 handles C and newer C++ code.
2235
It understands raw strings, binary constants and punctuation in numbers.
2336
It has a different, slightly more complex interface compared with version 5.05.
2437

25-
Neither version handles trigraphs (and neither version needs to handle digraphs).
26-
There are separate programs for adding or removing trigraphs and digraphs (called,
27-
unimaginatively, `trigraphs` and `digraphs`).
38+
Version 6.70 provides some occasionally useful new functionality.
39+
The `-e` option emits empty comments `/* */` or `//` (followed by a
40+
newline) instead of a space.
41+
This can simplify some code analyses.
42+
The `-c` option has been upgraded to generate a newline after each line
43+
of comments.
44+
This makes the output (much) easier to read.
45+
The flags (`-f`) option has more systematic names for the features.
46+
47+
No version of SCC handles trigraphs (and no version needs to handle
48+
digraphs).
49+
There are separate programs for adding or removing trigraphs and
50+
digraphs (called, unimaginatively, `trigraphs` and `digraphs`).

0 commit comments

Comments
 (0)