| 1 |
Release Notes for cloc version 2.08 |
| 2 |
https://github.com/AlDanial/cloc |
| 3 |
Jan. 24, 2026 |
| 4 |
|
| 5 |
New Languages and File Types: |
| 6 |
o Activiti Business Process |
| 7 |
o Aria |
| 8 |
o AXAML |
| 9 |
o Bicep |
| 10 |
o BitBake |
| 11 |
o Clarity |
| 12 |
o Haskell Boot |
| 13 |
o Hibernate |
| 14 |
o JSP Tag Library Definition |
| 15 |
o Jasper Report XML/Template |
| 16 |
o Justfile |
| 17 |
o Liquibase |
| 18 |
o Magik |
| 19 |
o VSCode Workspace |
| 20 |
o Yarn |
| 21 |
|
| 22 |
Updates: |
| 23 |
o Support input through process substitution on Unix-like |
| 24 |
operating systems (example: cloc <(git diff HEAD~1 HEAD --name-only) ) |
| 25 |
o Improve Perl filter for POD (plain old documentation) handling. |
| 26 |
o --quiet now suppresses all output including error messages unless |
| 27 |
--show-errors is also given. |
| 28 |
o Add .cts extension for TypeScript. |
| 29 |
o Renamed "VB for Applications" to "VBA" |
| 30 |
o Add .vbhtml extension for Visual Basic .NET |
| 31 |
o Renamed "Visual Basic Script" to "VBScript" |
| 32 |
o New switch --include-submodules (applies to --vcs=git) to include |
| 33 |
git submodule files in the count. |
| 34 |
o Revert back to manual build of Windows executable to avoid |
| 35 |
issues with symlinks seen with winget on executables created |
| 36 |
in Github Actions. |
| 37 |
|
| 38 |
Bug fixes: |
| 39 |
o Handle empty files when using --git --diff. |
| 40 |
o Replace "Nothing to count." output with valid formatted output |
| 41 |
(JSON, etc) when no files are found to count. |
| 42 |
o Fix language definition parse errors with --read-lang-def, --force-lang-def |
| 43 |
(specifically, update matching regex to allow leading '.' as in .NET) |
| 44 |
|
| 45 |
============================================================================ |
| 46 |
Release Notes for cloc version 2.06 |
| 47 |
https://github.com/AlDanial/cloc |
| 48 |
June 24, 2025 |
| 49 |
|
| 50 |
New Languages and File Types: |
| 51 |
o Cangjie |
| 52 |
o Elixir Script |
| 53 |
o Fortran 2003 |
| 54 |
o Jsonnet |
| 55 |
o Nextflow |
| 56 |
o Nushell |
| 57 |
o Org Mode |
| 58 |
o Rego |
| 59 |
o UXML, USS (Unity) |
| 60 |
|
| 61 |
Updates: |
| 62 |
o First attempt at using Github Actions to package a release |
| 63 |
including making a Windows executable that works with |
| 64 |
symlinks as used by winget |
| 65 |
o Add column headers for --show-lang and --show-ext output |
| 66 |
o Remove '->' separator in --show-ext output |
| 67 |
o Remove leading blank space for --fmt output written to STDOUT |
| 68 |
o New switch --files-from as a synonym for --vcs |
| 69 |
o New switch --ksep/--thousands-delimiter to show a separator (default |
| 70 |
is a comma) between thousands in output counts |
| 71 |
o Change sequence of Python language filters so that docstrings are |
| 72 |
handled before # |
| 73 |
o Jenkinsfile now recognized as Groovy |
| 74 |
o Improve Windows/Unix path conflicts when using --git --diff in |
| 75 |
git-bash terminal |
| 76 |
o New switch --percent as a shortcut to '--by-percent t' to show |
| 77 |
percentage of totals in blank, comment, code columns |
| 78 |
o Add backtick and C++ style comment support for Svelte |
| 79 |
o Write results in multiple formats if multiple output format |
| 80 |
switches are given (for example --json --yaml --xml) |
| 81 |
|
| 82 |
Bug fixes: |
| 83 |
o Remove file 'irregular"file2.md' from the test suite as filenames |
| 84 |
with embedded double quotes are illegal in Windows and cause git |
| 85 |
pull problems (among other issues). This file is created dynamically |
| 86 |
during testing on non-Windows operating systems. |
| 87 |
o On Windows use zip format instead of tar for the 'git archive' command |
| 88 |
used when running with --git --diff |
| 89 |
o Remove duplicate "percent" entry in options handling |
| 90 |
o Support --exclude-lang in --diff mode |
| 91 |
o Fix --exclude-lang option when used in diff mode and when all files |
| 92 |
are additions or deletions |
| 93 |
o On Windows, remove temporary "SCALAR(0x..)" files created when |
| 94 |
using --fmt |
| 95 |
o Handle --by-file for JSON and YAML outputs with single and double |
| 96 |
quotes in file names |
| 97 |
|
| 98 |
============================================================================ |
| 99 |
Release Notes for cloc version 2.04 |
| 100 |
https://github.com/AlDanial/cloc |
| 101 |
Jan. 31, 2025 |
| 102 |
|
| 103 |
New Languages and File Types: |
| 104 |
o Blueprint |
| 105 |
o MoonBit |
| 106 |
o SurrealQL |
| 107 |
o Pkl |
| 108 |
o Civet |
| 109 |
o Cadence |
| 110 |
o Pek |
| 111 |
|
| 112 |
Updates: |
| 113 |
o Follow file renames when pairing files for --git --diff. |
| 114 |
o Arch Linux now has an AUR package for cloc. |
| 115 |
o New switch --ignore-regex to exclude files whose content matches a regex. |
| 116 |
o New switch --unique to identify unique files found. |
| 117 |
o Descriptive message at the end of a run if timeouts were encountered. |
| 118 |
o Slight performance improvement for --help by installing temporary |
| 119 |
modules later. |
| 120 |
|
| 121 |
Bug fixes: |
| 122 |
o Better handling of Vuejs. |
| 123 |
o Better handling of Oracle PL/SQL. |
| 124 |
o Better error message on failure to count .src.rpm files if external |
| 125 |
tools are not installed. |
| 126 |
o Identify non-Glade .ui files as 'XML (Qt/GTK)' instead of 'Qt'. |
| 127 |
o Apply file filter rules with --no-recurse. |
| 128 |
|
| 129 |
============================================================================ |
| 130 |
Release Notes for cloc version 2.02 |
| 131 |
https://github.com/AlDanial/cloc |
| 132 |
Aug. 2, 2024 |
| 133 |
|
| 134 |
New Languages and File Types: |
| 135 |
o Arturo |
| 136 |
o Glimmer JavaScript |
| 137 |
o Glimmer TypeScript |
| 138 |
o Luau |
| 139 |
o Modelica |
| 140 |
o Mojo |
| 141 |
o Nickel |
| 142 |
o Pawn |
| 143 |
o Processing |
| 144 |
o Templ |
| 145 |
o Yang |
| 146 |
|
| 147 |
Updates: |
| 148 |
o Support SQL output with --diff |
| 149 |
o Support counting in .git repo directories not owned by the user. |
| 150 |
o Eliminate the need to write temporary files when using --fmt. |
| 151 |
o Restore Dockerfile CI by fixing CPAN module setup that somehow stopped |
| 152 |
installing Parallel::ForkManager. |
| 153 |
o Improve handling of C comments in Go strings. |
| 154 |
|
| 155 |
Bug fixes: |
| 156 |
o Improve --fmt output column alignments. |
| 157 |
o Handle --no-match when combined with --fullpath and --vcs. |
| 158 |
|
| 159 |
============================================================================ |
| 160 |
Release Notes for cloc version 2.00 |
| 161 |
https://github.com/AlDanial/cloc |
| 162 |
Feb. 17, 2024 |
| 163 |
|
| 164 |
|
| 165 |
** Note: There are no breaking changes between the ** |
| 166 |
** 1.xx versions and this 2.00 release. ** |
| 167 |
|
| 168 |
|
| 169 |
New Languages and File Types: |
| 170 |
o AnsProlog |
| 171 |
o AppleScript |
| 172 |
o ArkTs |
| 173 |
o Astro |
| 174 |
o Dafny |
| 175 |
o PlusCal |
| 176 |
o Prisma Schema |
| 177 |
o PRQL |
| 178 |
o Slint |
| 179 |
o Snakemake |
| 180 |
o TLA+ |
| 181 |
o vyper |
| 182 |
|
| 183 |
Updates: |
| 184 |
o Five new output formats with the new --fmt switch. Includes the often- |
| 185 |
requested addition of language name with --by-file counts. |
| 186 |
o *.o.d files are ignored |
| 187 |
o Added .j2 as a Jinja Template extension. |
| 188 |
o Added .mts as a TypeScript extension. |
| 189 |
o Added .iuml, .pu. .plantuml, .wsd as as PlantUML extensions. |
| 190 |
o Support Java block comments. |
| 191 |
o More consistent and accurate results from --diff. |
| 192 |
o Disambiguate .inc files among PHP, Pascal, and Fortran. |
| 193 |
o Ignore .gitattribute files. |
| 194 |
o Improved support for --exclude-list-file. |
| 195 |
o Fix JSON output generator which inserted a superfluous comma. |
| 196 |
o Recognize autogenerated C# SpecFlow files and ignore them with |
| 197 |
--no-autogen. |
| 198 |
o Support --list-file with --git-diff-*. |
| 199 |
o SQL output: add foreign key 'id' to table t referencing 'id' |
| 200 |
in the metadata table. The key value is Unix epoch seconds when |
| 201 |
cloc was invoked. |
| 202 |
o Support // comments in ReasonML. |
| 203 |
o Support directories in exclusion list files; all files below the |
| 204 |
named directories are excluded. |
| 205 |
o Support --exclude-file-list with --git --diff. |
| 206 |
o New switch, --strip-code, which attempts to only leave comments in |
| 207 |
the output file. |
| 208 |
|
| 209 |
Bug fixes: |
| 210 |
o More accurate counts of XML with block comments. |
| 211 |
o More accurate counts of Java with block comments and comment markers |
| 212 |
within strings. |
| 213 |
o Fix improper handling of --match-d and --not-match-d. |
| 214 |
|
| 215 |
============================================================================ |
| 216 |
Release Notes for cloc version 1.98 |
| 217 |
https://github.com/AlDanial/cloc |
| 218 |
Aug. 19, 2023 |
| 219 |
|
| 220 |
New Languages and File Types: |
| 221 |
o Asymptote |
| 222 |
o CoCoA 5 |
| 223 |
o Constraint Grammar |
| 224 |
o Hare |
| 225 |
o Jai |
| 226 |
o Linker Script |
| 227 |
o NetLogo |
| 228 |
o Typst |
| 229 |
|
| 230 |
Updates: |
| 231 |
o Added .editorconfig as an INI extension. |
| 232 |
o Added .cppm, .ixx, .ccm, .cxxm, .c++m as C++ extensions. |
| 233 |
o Improved handling of trailing slash with --match-d |
| 234 |
o --exclude-list-file with --git now works as expected. |
| 235 |
o --not-match-d, --not-match-f can now be repeated. |
| 236 |
o --quiet mode is now enabled when STDOUT is not a terminal. |
| 237 |
This makes for cleaner output when piping to other programs. |
| 238 |
o New switch --include-content=regex to only count files whose |
| 239 |
content matches the given regex. |
| 240 |
o New switch --only-count-files to only count files. Counts for |
| 241 |
blank, comment, and code lines will be zero. |
| 242 |
|
| 243 |
Bug fixes: |
| 244 |
o --no-recurse on Windows |
| 245 |
o Improved exclusion of autogenerated files on Windows. |
| 246 |
o Improved handling of path separators with git in PowerShell. |
| 247 |
o Resolve nondeterministic --diff output. |
| 248 |
o --hide-rate supports all output file types |
| 249 |
o Fixed --diff-list-file with unknown listed file. |
| 250 |
o Fixed parsing of verbose option in the cloc configuration file. |
| 251 |
|
| 252 |
NOTE: The next release of cloc will be 2.00. Despite the major version |
| 253 |
number bump, there will be no breaking changes. |
| 254 |
|
| 255 |
============================================================================ |
| 256 |
Release Notes for cloc version 1.96 |
| 257 |
https://github.com/AlDanial/cloc |
| 258 |
Dec. 18, 2022 |
| 259 |
|
| 260 |
New Languages and File Types: |
| 261 |
o Cairo |
| 262 |
o Carbon |
| 263 |
o Circom |
| 264 |
o Containerfile |
| 265 |
o HolyC |
| 266 |
o kvlang |
| 267 |
o Nunjucks |
| 268 |
o OpenSCAD |
| 269 |
o P4 |
| 270 |
o Pest |
| 271 |
o Pony |
| 272 |
o TEAL |
| 273 |
o WGSL |
| 274 |
|
| 275 |
Updates: |
| 276 |
o New switch --diff-list-files to run diff given two list |
| 277 |
files. |
| 278 |
o Handle comments embedded in OCaml strings. |
| 279 |
o Write empty JSON and XML structures if the inputs yield zero |
| 280 |
counts. |
| 281 |
o Including Win32::LongPath to support long paths on Windows. |
| 282 |
o Better support for building and running Docker image on Windows |
| 283 |
o Better output file names when running with --count-and-diff |
| 284 |
and --out. |
| 285 |
o Resolve internal file handle conflict when running --diff with |
| 286 |
--sdir or --categorized. |
| 287 |
|
| 288 |
============================================================================ |
| 289 |
Release Notes for cloc version 1.94 |
| 290 |
https://github.com/AlDanial/cloc |
| 291 |
July 4, 2022 |
| 292 |
|
| 293 |
New Languages and File Types: |
| 294 |
o Derw |
| 295 |
o Finite State Language |
| 296 |
o Flatbuffers |
| 297 |
o Futhark |
| 298 |
o Godot Shaders |
| 299 |
o HTML EEx |
| 300 |
o Lem |
| 301 |
o PEG, peg.js, peggy, tspeg |
| 302 |
o Text (.txt and .text) |
| 303 |
o Visual Studio Module |
| 304 |
o X++ |
| 305 |
|
| 306 |
Updates: |
| 307 |
o Handle empty Unicode files which contain only a BOM (byte |
| 308 |
order mark). |
| 309 |
o The arguments to --include-lang are now case insensitive. |
| 310 |
o .cjs added as JavaScript extension. |
| 311 |
o Switches --git and --xml together now include additional git |
| 312 |
metadata (origin, branch, commit hash) in the XML output. Future |
| 313 |
releases will include these additions in YAML, JSON, SQL, and |
| 314 |
Markdown output as well. |
| 315 |
o New switch --no-recurse prevents recursive directory traversal. |
| 316 |
|
| 317 |
============================================================================ |
| 318 |
Release Notes for cloc version 1.92 |
| 319 |
https://github.com/AlDanial/cloc |
| 320 |
Dec. 5, 2021 |
| 321 |
|
| 322 |
New Languages and File Types: |
| 323 |
o GraphQL |
| 324 |
o Metal Shading Language |
| 325 |
o PlantUML |
| 326 |
o Properties |
| 327 |
o Umka |
| 328 |
|
| 329 |
Updates: |
| 330 |
o The .bzl and .bazel extensions are now associated with Starlark. |
| 331 |
o Added support for Puppet functions and type aliases. |
| 332 |
o Removed reliance on XML definition with --force-lang-def |
| 333 |
o Fixed broken --csv-delimiter handling. |
| 334 |
o Fixed broken interaction of --vcs=git with --max-file-size; |
| 335 |
support floating point value for --max-file-size. |
| 336 |
o Improved support for uniform handling of uppercase and |
| 337 |
lowercase filenames and extensions on Windows. |
| 338 |
o Recognize CMakeLists.txt on Windows. |
| 339 |
o Fixed handling of --unicode for small files. |
| 340 |
o Updated Dockerfile to produce a smaller image. |
| 341 |
o Improved contents of --ignored file (now includes skipped |
| 342 |
binary files and does not include directory names). |
| 343 |
o Identify SCSS separately from Sass. |
| 344 |
o Updated Sass filters to handle C++ style comments. |
| 345 |
o Improved support for Assembly. |
| 346 |
o Recognize :: comments in DOS batch files. |
| 347 |
o Properly handle explicitly-excluded files (for example, |
| 348 |
.gitignore) with --diff. |
| 349 |
|
| 350 |
|
| 351 |
============================================================================ |
| 352 |
Release Notes for cloc version 1.90 |
| 353 |
https://github.com/AlDanial/cloc |
| 354 |
May 1, 2021 |
| 355 |
|
| 356 |
New Languages and File Types: |
| 357 |
o BizTalk Orchestration |
| 358 |
o BizTalk Pipeline |
| 359 |
o Cake Build Script |
| 360 |
o C# Designer |
| 361 |
o CSV |
| 362 |
o Delphi Form |
| 363 |
o Gleam |
| 364 |
o Godot Resource |
| 365 |
o Godot Scene |
| 366 |
o Juniper Junos |
| 367 |
o ReScript |
| 368 |
o Ring |
| 369 |
o Visual Studio Solution |
| 370 |
o Web Services Description |
| 371 |
o Zig |
| 372 |
|
| 373 |
Updates: |
| 374 |
o Dockerfile: add .[dD]ockerfile as an extension; treat |
| 375 |
files named Dockerfile.ext as Dockerfile unless ext |
| 376 |
maps to a recognized language other than cmake or m4. |
| 377 |
o Identify autogenerated C# files. |
| 378 |
o If getting input from a list file or using a language |
| 379 |
definition file, also check for (and use, if it exists) |
| 380 |
an options.txt file in the same directory. |
| 381 |
o Use --csv-delimiter for --ignored, --categorized output. |
| 382 |
o Support diff summation in csv format. |
| 383 |
o Update cloc's Unix Makefile to support macOS |
| 384 |
o Rename Junos to Juniper Junos |
| 385 |
o Stratify Visual Basic to for Applications, .NET, Script |
| 386 |
o Use tar on Windows 10 instead of zip with --git --diff |
| 387 |
o Track upper/lowercase file names on Windows to permit |
| 388 |
consistent diffs. |
| 389 |
o Support nested Elm comments. |
| 390 |
o Update to Regexp::Common 2017060201. |
| 391 |
o Minimum Perl version is now 5.10.0 |
| 392 |
o New options --skip-leading, --summary-cutoff |
| 393 |
o Refine comment definitions for ASP.NET, Razor |
| 394 |
o Handle Julia docstrings. |
| 395 |
o Adjust timeout and diff_timeout values to avoid alarm |
| 396 |
overflows. |
| 397 |
o Add extensions .btproj, .msbuild for MSBuild script |
| 398 |
|
| 399 |
Bug Fixes: |
| 400 |
o Add missing Raku_or_Prolog() subroutine. |
| 401 |
o Handle UTF encoded list files (file given to --list-file). |
| 402 |
o Improved support for options parsing from config file. |
| 403 |
o Catch unidentified files via --diff-list-file. |
| 404 |
o Don't insert extra newlines when stripping with --unicode. |
| 405 |
o Strip literal '\x' from JSON output strings. |
| 406 |
o Improve logic for detecting Unicode files less than |
| 407 |
90 bytes in size. |
| 408 |
o Fix divide by zero classifying nonreadable .b files. |
| 409 |
o Escape backslash for 'report_file' entry in JSON, YAML on |
| 410 |
Windows. |
| 411 |
|
| 412 |
============================================================================ |
| 413 |
Release Notes for cloc version 1.88 |
| 414 |
https://github.com/AlDanial/cloc |
| 415 |
Sept. 12, 2020 |
| 416 |
|
| 417 |
New Languages and File Types: |
| 418 |
o LLVM IR |
| 419 |
o Logos |
| 420 |
o Meson |
| 421 |
o Mojo |
| 422 |
o Odin |
| 423 |
o Jinja Templates |
| 424 |
o WXML |
| 425 |
o WXSS |
| 426 |
|
| 427 |
Updates: |
| 428 |
o Support MATLAB block comments. |
| 429 |
o More flexible matching of git hashes. |
| 430 |
o Case insensitive diff file alignment on Windows. |
| 431 |
o Add .BAS as a Visual Basic extension |
| 432 |
o Rename Objective C to Objective-C |
| 433 |
|
| 434 |
Bug Fixes: |
| 435 |
o Add missing Raku_or_Prolog() subroutine. |
| 436 |
o Handle UTF encoded list files (file given to --list-file). |
| 437 |
o Improved support for options parsing from config file. |
| 438 |
o Catch unidentified files via --diff-list-file. |
| 439 |
o Don't insert extra newlines when stripping with --unicode. |
| 440 |
|
| 441 |
============================================================================ |
| 442 |
Release Notes for cloc version 1.86 |
| 443 |
https://github.com/AlDanial/cloc |
| 444 |
May 17, 2020 |
| 445 |
|
| 446 |
New Languages and File Types: |
| 447 |
o ASP.NET Core Blazor WASM (*.razor) |
| 448 |
o Bazel |
| 449 |
o dhall |
| 450 |
o Raku (renamed from Perl6) |
| 451 |
o Squirrel |
| 452 |
o SugarSS |
| 453 |
o Svelte |
| 454 |
o TNSDL |
| 455 |
o Remove .tsv as a RobotFramework extension |
| 456 |
o Add .inl as a C++ extension. |
| 457 |
o Add #_ as a Closure comment marker. |
| 458 |
|
| 459 |
Updates: |
| 460 |
o Provide alternate algorithms for --git --diff: |
| 461 |
--git-diff-rel computes differences of only files that have changed |
| 462 |
between the two git commits (this is now the default |
| 463 |
action with "--git --diff") |
| 464 |
--git-diff-all computes differences between all files in the repo |
| 465 |
between the two git commits (this was the default |
| 466 |
action with "--git --diff" behavior in 1.84) |
| 467 |
o New cloc releases will be accompanied by Docker instances on |
| 468 |
Dockerhub. |
| 469 |
o Support reading file names from a STDIN pipe. |
| 470 |
o Check unrecognized files to see if they contain XML. |
| 471 |
o Switch --vcs supports an 'auto' option to automatically determine |
| 472 |
if one is counting in a subversion or git repository. |
| 473 |
o Expand git archives in user-provided scratch directory with --sdir. |
| 474 |
o Mask comment markers in Kotlin raw strings. |
| 475 |
o Make output more deterministic with secondary sort of results. |
| 476 |
o Avoid computation of log(0). |
| 477 |
o Improve --strip-str-comments logic. |
| 478 |
o Improve handling of triple quotes (Python, Groovy, Gradle). |
| 479 |
o New switch --diff-list-file, to perform diff's using a provided |
| 480 |
list file containing file pairs to compare. |
| 481 |
o New switch --ignore-case-ext to ignore upper/lowercase of |
| 482 |
file extension. |
| 483 |
|
| 484 |
Bug Fixes: |
| 485 |
o Fix --exclude-list-file with --diff. |
| 486 |
o Fix creation of empty tar file if this happens during --git --diff. |
| 487 |
o Restore --exclude-lang functionality with --diff. |
| 488 |
|
| 489 |
============================================================================ |
| 490 |
Release Notes for cloc version 1.84 |
| 491 |
https://github.com/AlDanial/cloc |
| 492 |
September 22, 2019 |
| 493 |
|
| 494 |
New Languages and File Types: |
| 495 |
o APL |
| 496 |
o Apache Thrift |
| 497 |
o Imba |
| 498 |
o IPL |
| 499 |
o SaltStack |
| 500 |
|
| 501 |
Updates: |
| 502 |
o Improved handling of --git --diff |
| 503 |
o Add .podspec as a Ruby file extension. |
| 504 |
o New switch, --stat, to force a stat check of |
| 505 |
directories. This enables traversal of directory |
| 506 |
types whose nlink count does not match the count |
| 507 |
of subdirectories (examples: CD-ROM, FAT, AFS). |
| 508 |
o Force stat on top level directories. This is |
| 509 |
companion logic to the new --stat switch. |
| 510 |
o Add file extensions defined by the Linguist project. |
| 511 |
o New switch, --exclude-content, to exclude files if |
| 512 |
any of their lines match a regex. |
| 513 |
o New switch, --timeout, to give control over timeouts |
| 514 |
on direct counts (as opposed to diff timeouts). |
| 515 |
o On Windows, lower batch size on git archive |
| 516 |
commands to 100 files (the value is 1,000 on *nix). |
| 517 |
o Better identification of Smarty .tpl template files. |
| 518 |
|
| 519 |
Bug Fixes: |
| 520 |
o On Windows, use double quotes for git archive entries. |
| 521 |
o On Windows, double slash path separators with --by-file |
| 522 |
and JSON output. |
| 523 |
o On Windows, replace / with \\ in results only when |
| 524 |
running with --by-file. |
| 525 |
o Fix header line metrics for files/sec and lines/sec |
| 526 |
when doing --diff. |
| 527 |
o Python: handle cases of /* or */ embedded in strings |
| 528 |
(this conflicted with internal logic which replaced |
| 529 |
docstring triple quotes with C comments). |
| 530 |
o Fix mishandling of --exclude-dir with --follow-link. |
| 531 |
o Fix doubly-counted #! line |
| 532 |
o Support --hide-rate with csv output. |
| 533 |
|
| 534 |
============================================================================ |
| 535 |
Release Notes for cloc version 1.82 |
| 536 |
https://github.com/AlDanial/cloc |
| 537 |
May 3, 2019 |
| 538 |
|
| 539 |
New Languages and File Types: |
| 540 |
o Apex Class |
| 541 |
o DIET |
| 542 |
o Fennel |
| 543 |
o FXML |
| 544 |
o Jupyter notebook files (.ipynb) |
| 545 |
o Python wheel files (.whl) |
| 546 |
o SVG |
| 547 |
o reStructuredText |
| 548 |
|
| 549 |
Updates: |
| 550 |
o Handle backslashed quotes in strings to improve --strip-str-comments |
| 551 |
logic. |
| 552 |
o Improve Perl v. Prolog identification. |
| 553 |
o New switch --docstring-as-code to count Python docstrings as code. |
| 554 |
o Partial support for Lua nested comments. |
| 555 |
o Renamed Skylark to Starlark. |
| 556 |
o Modified Java filter to try to handle embedded comments better. |
| 557 |
o Recognize groovy as one of the #! languages. |
| 558 |
o Add .pyw as a file extension for Python. |
| 559 |
o Update comment definitions for Velocity Template Language. |
| 560 |
o Override file alignment logic with --diff when only two files are |
| 561 |
given. |
| 562 |
o Identify TeX v. Visual Basic for .cls file extension. |
| 563 |
o Include result summation line with --csv output. |
| 564 |
o Support --csv, --json, --md, --xml, --yaml output types for the |
| 565 |
--ignored debug file. |
| 566 |
o Force IO encoding to allow wider Unicode characters for creating |
| 567 |
Windows exe's with PAR::Packer |
| 568 |
|
| 569 |
============================================================================ |
| 570 |
Release Notes for cloc version 1.80 |
| 571 |
https://github.com/AlDanial/cloc |
| 572 |
Oct. 5, 2018 |
| 573 |
|
| 574 |
This is a bug-fix release to solve mishandling of git inputs for |
| 575 |
straight counts in 1.78 (--git --diff works ok in 1.78), |
| 576 |
https://github.com/AlDanial/cloc/issues/328. |
| 577 |
|
| 578 |
New Languages: |
| 579 |
o ReasonML |
| 580 |
|
| 581 |
Updates: |
| 582 |
o New SQL output style option with "--sql-style Named_Columns". This |
| 583 |
includes the table "t" column names in each insert statement. |
| 584 |
o New option --file-encoding to create all output files using the |
| 585 |
given file encoding (for example "--file-encoding |
| 586 |
o Add escript as script language for Erlang. |
| 587 |
o Improved handling of custom Smarty definitions through |
| 588 |
--read-lang-def. |
| 589 |
o Better diff logic when comparing two files. |
| 590 |
o Faster program start on the Unix-tuned version of cloc when |
| 591 |
multiple processors are not used. |
| 592 |
|
| 593 |
============================================================================ |
| 594 |
|
| 595 |
Release Notes for cloc version 1.78 |
| 596 |
https://github.com/AlDanial/cloc |
| 597 |
Sept. 7, 2018 |
| 598 |
|
| 599 |
New Languages: |
| 600 |
o EJS |
| 601 |
o Gradle |
| 602 |
o Igor Pro |
| 603 |
o JSON5 |
| 604 |
o Nix |
| 605 |
o R Markdown |
| 606 |
o SparForte |
| 607 |
o Xtend |
| 608 |
|
| 609 |
Updates: |
| 610 |
o Interpret "--diff-timeout 0" as allowing unlimited time to compute |
| 611 |
diffs. |
| 612 |
o Add .inl extension for C++ |
| 613 |
o Improve language rules for Assembly and JCL. |
| 614 |
o Better handling of OCaml comments (don't just use Pascal rules). |
| 615 |
o Handle unusual file names with --use-sloccount. |
| 616 |
o Remove GNU grep specific -P option with --use-sloccount (fall back |
| 617 |
to simpler BSD grep options). |
| 618 |
o Handle OCaml nested comments. |
| 619 |
o Remove debug print statement for counts of Rmd (R markdown) files. |
| 620 |
o New switch --include-ext to only count files with the given extension. |
| 621 |
o New switch --config to load command line switches from a file. |
| 622 |
o New switch --hide-rate to suppress header line (makes the output |
| 623 |
deterministic). |
| 624 |
o Skip header line when combining diff reports. |
| 625 |
o Allow any number (including just one) of diff reports to be summed. |
| 626 |
o Exit early if --diff arguments are the same. |
| 627 |
o New switch --strip-str-comments to (try to) avoid 'Complex regular |
| 628 |
subexpression recursion limit' warning. |
| 629 |
o Run cleanly under Perl 5.28 and 5.32 by backslashing braces in regex. |
| 630 |
o Suppord Idris block comments. |
| 631 |
o Set UTF-8 encoding on XML and XSL files generated by cloc. |
| 632 |
o New switch --write-lang-def-incl-dup to include files with extension |
| 633 |
collisions (but should be used with care because the resulting language |
| 634 |
definition file will be rejected by cloc until all collisions have been |
| 635 |
resolved). |
| 636 |
|
| 637 |
Bug Fixes: |
| 638 |
o Correctly handle --not-match-d and --follow-links together. |
| 639 |
o Fix --git --diff handling of large file sets. |
| 640 |
o Remove \$ from git pathspec filename-cleansing regex as git already |
| 641 |
handles such filename mangling |
| 642 |
o Remove debug die() invocation in make_file_list(). |
| 643 |
o Fix improperly formatted JSON emitted with --by-file-by-lang. |
| 644 |
o Improve accuracy of C#/Smalltalk disambuguator (was biased toward |
| 645 |
counting .cs files as Smalltalk). |
| 646 |
o Improve accuracy of TypeScript/Qt Linguist disambuguator. |
| 647 |
o More robust YAML output by quoting file and language names. |
| 648 |
o Handle more unusual file names with --git --diff |
| 649 |
|
| 650 |
============================================================================ |
| 651 |
Release Notes for cloc version 1.76 |
| 652 |
https://github.com/AlDanial/cloc |
| 653 |
February 9, 2018 |
| 654 |
|
| 655 |
New Languages: |
| 656 |
o Agda |
| 657 |
o AsciiDoc |
| 658 |
o Chapel |
| 659 |
o Fish Shell |
| 660 |
o Gencat NLS |
| 661 |
o Lean |
| 662 |
o HCL |
| 663 |
o Oracle PL/SQL |
| 664 |
o PL/M |
| 665 |
o ProGuard |
| 666 |
o RAML |
| 667 |
o Skylark |
| 668 |
o SWIG |
| 669 |
|
| 670 |
Updates: |
| 671 |
o Performance improvement by using multiple cores for both |
| 672 |
straight counts and --diff via the new --processes option |
| 673 |
added by Sietse Snel, https://github.com/stsnel. |
| 674 |
o Support --git on Windows. |
| 675 |
o Improve identification of Qt Project files (instead of IDL). |
| 676 |
o Fix language determination logic so that languages that map |
| 677 |
to the same file extension and have ties in the number of |
| 678 |
accumulated points always return the same result. |
| 679 |
o Add support for replace_between_regex in --write_lang_def and |
| 680 |
--read_lang_def. |
| 681 |
o Add SUM section to JSON, YAML output with --diff. |
| 682 |
o Make numeric values in JSON output numbers instead of strings. |
| 683 |
o Optionally exclude autogenerated files with new --no-autogen |
| 684 |
(currently only supports the Go language). |
| 685 |
|
| 686 |
Bug Fixes: |
| 687 |
o Remove temp directory prefix for YAML and JSON output when |
| 688 |
counting git archives with --by-file. |
| 689 |
o Properly handle git files with spaces embedded in the file name. |
| 690 |
o Remove a debug regex inadvertently included in v1.74. |
| 691 |
|
| 692 |
============================================================================ |
| 693 |
Release Notes for cloc version 1.74 |
| 694 |
https://github.com/AlDanial/cloc |
| 695 |
September 8, 2017 |
| 696 |
|
| 697 |
New Languages: |
| 698 |
o BrightScript |
| 699 |
o Cucumber |
| 700 |
o Drools |
| 701 |
o F# Script |
| 702 |
o GraphQL |
| 703 |
o Idris |
| 704 |
o Literate Idris |
| 705 |
o Smalltalk |
| 706 |
o Solidity |
| 707 |
o Stata |
| 708 |
o TOML |
| 709 |
|
| 710 |
Updates: |
| 711 |
o New option, --git, to allow git commit hashes and branch |
| 712 |
names as inputs (issue 205). |
| 713 |
o Add .asd extension for Lisp. |
| 714 |
o Add .snapshot to the list of excluded directories. |
| 715 |
o New option --no-autogen to ignore files generated |
| 716 |
by code production systems like GNU autoconf. |
| 717 |
o Rename "ASP.Net" to "ASP.NET". |
| 718 |
o Improvements to Specman e parsing (issue 175). |
| 719 |
o Support uppercase CPP extension (issue 177). |
| 720 |
o Support triple extensions. |
| 721 |
o Improve language distinction between C# and Smalltalk (issue 160). |
| 722 |
o Consider Elixir docs as comments. |
| 723 |
o Handle Python docstrings made with single quotes. |
| 724 |
o Replace built-in "is it a file?" and "is it a directory?" |
| 725 |
with native Perl -f and -d operators (these were unreliable |
| 726 |
on older versions of Perl on Windows). |
| 727 |
o Put timeout around Regexp::Common regex evaluation to prevent |
| 728 |
hangs on unbalanced comment markers within huge strings (issue 206). |
| 729 |
o Fix Pascal regex with '{' for Perl version >= 5.26 (issue 209) |
| 730 |
and '(*', '*)' comment matching (issue 212). |
| 731 |
o Rename Antlr to ANTLR Grammar. |
| 732 |
o Add .g4 extension for ANTLR Grammar. |
| 733 |
o Replace soon-to-be deprecated File::Glob::glob() with |
| 734 |
File::Glob::bsd_glob() (issue 214). |
| 735 |
o Revert from charset=iso-8859-1 to charset=utf-8 on undocumented |
| 736 |
--html option. |
| 737 |
o For Assembly, process # comments before C++ comments. |
| 738 |
|
| 739 |
Bug Fixes: |
| 740 |
o Correct handling of remove_between_general and |
| 741 |
remove_between_regex when running with --read-lang-def (issue 166) |
| 742 |
o Fix bug handling balanced parentheses in Forth (issue 183) |
| 743 |
o Force legal output filenames with --count-and-diff and --out |
| 744 |
(issue #220). |
| 745 |
|
| 746 |
============================================================================ |
| 747 |
Release Notes for cloc version 1.72 |
| 748 |
https://github.com/AlDanial/cloc |
| 749 |
January 14, 2017 |
| 750 |
|
| 751 |
New Languages: |
| 752 |
o Antlr |
| 753 |
o Dockerfile |
| 754 |
o Glade |
| 755 |
o GLSL |
| 756 |
o Lisp Flavored Erlang |
| 757 |
o Mako |
| 758 |
o PO files (used for translations in GTK programming) |
| 759 |
o RapydScript |
| 760 |
o Slice interface specification language |
| 761 |
o Specman e |
| 762 |
o Vue.js Component |
| 763 |
|
| 764 |
Updates: |
| 765 |
o Support for Lua --[[ ]] block comments. |
| 766 |
o Improve --not-match-d support. |
| 767 |
o Add extension .tsx for TypeScript. |
| 768 |
o Renamed SASS to Sass. |
| 769 |
o '--vcs git' now ignores code in git submodules. |
| 770 |
o Add .p6 and .pm6 extensions for Perl 6. |
| 771 |
o Add .phtml extension for PHP. |
| 772 |
o Add .psm1 and .psd1 extensions for PowerShell. |
| 773 |
o Only print a small usage summary when running cloc without |
| 774 |
arguments. Now have to run 'cloc --help' to get the huge |
| 775 |
output. |
| 776 |
|
| 777 |
Bug Fixes: |
| 778 |
o Filter updates for Assembly, Groovy to prevent infinite recursion in |
| 779 |
regex. |
| 780 |
o Correct handling of Julia block comments. |
| 781 |
o Correct output when running with '--diff --json' or '--diff --yaml'. |
| 782 |
o Fix logic error in code that handled --exclude-dir. |
| 783 |
o Fix error in handling of '--vcs X' where X is a user-provided |
| 784 |
command to generate a list of files. |
| 785 |
|
| 786 |
============================================================================ |
| 787 |
Release Notes for cloc version 1.70 |
| 788 |
https://github.com/AlDanial/cloc |
| 789 |
July 1, 2016 |
| 790 |
|
| 791 |
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * |
| 792 |
* v1.70 is a bugfix release to correct the "which: no abc in" * |
| 793 |
* problem seen on non-Debian based Linux distributions; ref. * |
| 794 |
* https://github.com/AlDanial/cloc/issues/105 * |
| 795 |
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * |
| 796 |
|
| 797 |
New Languages: |
| 798 |
o Freemarker Template |
| 799 |
o Haxe |
| 800 |
o Nim |
| 801 |
o TeX |
| 802 |
|
| 803 |
Updates: |
| 804 |
o Improved handling for Forth comments. |
| 805 |
|
| 806 |
Bug Fixes: |
| 807 |
o Fixed "which: no abc in" bug; issue 105 |
| 808 |
https://github.com/AlDanial/cloc/issues/105 |
| 809 |
|
| 810 |
============================================================================ |
| 811 |
Release Notes for cloc version 1.68 |
| 812 |
https://github.com/AlDanial/cloc |
| 813 |
June 3, 2016 |
| 814 |
|
| 815 |
New Languages: |
| 816 |
o Blade |
| 817 |
o Brainfuck |
| 818 |
o builder |
| 819 |
o Clean |
| 820 |
o INI |
| 821 |
o JSX |
| 822 |
o liquid |
| 823 |
o Logtalk |
| 824 |
o Markdown |
| 825 |
o Mathematica |
| 826 |
o Pug |
| 827 |
o Qt Linguist |
| 828 |
o Slim |
| 829 |
o TTCN |
| 830 |
|
| 831 |
Updates: |
| 832 |
o --help output now goes to STDOUT instead of STDERR. |
| 833 |
o Shortened cloc's output header line by removing "https:" from the |
| 834 |
github repository URL. |
| 835 |
o Add block comment support to CoffeeScript. |
| 836 |
o Improve Coq/Verilog disambiguator by recognizing more Coq keywords. |
| 837 |
o Improve handling of HAML block comments. |
| 838 |
o Improve Pascal/Puppet disambiguator. |
| 839 |
o Improve Perl/Prolog disambiguator by recognizing Perl HERE documents. |
| 840 |
o Add .cuh extension for CUDA. |
| 841 |
o Add .hxx extension for C/C++ header files. |
| 842 |
o Associate .mk extension with make. |
| 843 |
|
| 844 |
New options and features: |
| 845 |
|
| 846 |
--use-sloccount If SLOCCount is installed, use its compiled |
| 847 |
executables c_count, java_count, pascal_count, |
| 848 |
php_count, and xml_count instead of cloc's |
| 849 |
counters. SLOCCount's compiled counters are |
| 850 |
substantially faster than cloc's and may give |
| 851 |
a performance improvement when counting projects |
| 852 |
with large files. However, these cloc-specific |
| 853 |
features will not be available: --diff, |
| 854 |
--count-and-diff, --strip-comments, --unicode. |
| 855 |
--vcs=<VCS> Invoke a system call to <VCS> to obtain a list of |
| 856 |
files to work on. If <VCS> is 'git', then will |
| 857 |
invoke 'git ls-files'. If <VCS> is 'svn' then |
| 858 |
will invoke 'svn list -R'. The primary benefit |
| 859 |
is that cloc will then skip files explicitly |
| 860 |
excluded by the versioning tool in question, |
| 861 |
ie, those in .gitignore or have the svn:ignore |
| 862 |
property. |
| 863 |
Alternatively <VCS> may be any system command |
| 864 |
that generates a list of files. |
| 865 |
Note: cloc must be in a directory which can read |
| 866 |
the files as they are returned by <VCS>. cloc |
| 867 |
will not download files from remote repositories. |
| 868 |
'svn list -R' may refer to a remote repository |
| 869 |
to obtain file names (and therefore may require |
| 870 |
authentication to the remote repository), but |
| 871 |
the files themselves must be local. |
| 872 |
|
| 873 |
|
| 874 |
o Handle .deb archive files on Unix-like operating systems that have |
| 875 |
the Debian 'dpkg-deb' command. This is only useful for counting |
| 876 |
lines in Debian packages that contain source code--most contain |
| 877 |
only compiled executables. |
| 878 |
|
| 879 |
Bug Fixes: |
| 880 |
o Updated documentation for --exclude-dir to prohibit path separators. |
| 881 |
o Correct file path normalization problem when directory contains |
| 882 |
trailing slash. |
| 883 |
o --list-file: Return an empty list if the file cannot be read. |
| 884 |
o --exclude-dir: correctly handle command line input consisting of a |
| 885 |
file with leading directory names, eg abc/def/hello.c, by first |
| 886 |
checking that parent directories aren't in exclusion list. |
| 887 |
o Expand behavior of --fullpath to also work with --not-match-d. |
| 888 |
o Split into two statements expressions like "scalar(split(..))" |
| 889 |
which are deprecated in Perl 5.22. |
| 890 |
o --sum-reports: Give a useful error message when encountering an unknown |
| 891 |
language during report summation. |
| 892 |
|
| 893 |
============================================================================ |
| 894 |
Release Notes for cloc version 1.66 |
| 895 |
https://github.com/AlDanial/cloc |
| 896 |
January 23, 2016 |
| 897 |
|
| 898 |
New Languages: |
| 899 |
o AspectJ |
| 900 |
o Coq |
| 901 |
o CSON (CoffeeScript Object Notation) |
| 902 |
o Crystal |
| 903 |
o DOORS Extension Language |
| 904 |
o EEx (Embedded Elixir) |
| 905 |
o Elm |
| 906 |
o Forth |
| 907 |
o GDScript |
| 908 |
o Jam |
| 909 |
o Nemerle |
| 910 |
o PowerBuilder |
| 911 |
o Stylus |
| 912 |
o Twig |
| 913 |
o XHTML |
| 914 |
o XMI (XML Metadata Interchange) |
| 915 |
o zsh |
| 916 |
|
| 917 |
Updates: |
| 918 |
o Add block comment support to CoffeeScript. |
| 919 |
o .xhtml is no longer associated with JavaServer Faces; instead |
| 920 |
it is counted as XHTML |
| 921 |
o Remove association of .config to ASP.Net (.config is too |
| 922 |
general to be appropriated by one language). |
| 923 |
o Support .hlsl extension for HLSL. |
| 924 |
o Changes to support Perl v5.22: |
| 925 |
* Remove references to deprecated "defined(@array)". |
| 926 |
* Remove "no warnings 'deprecated'" as it is no longer needed. |
| 927 |
o Greater reliance on Regexp::Common's C++ regex instead of |
| 928 |
using internal // filter. |
| 929 |
o Update code pulled from Regexp::Common 2.120 to 2013031301. |
| 930 |
o Support .f and .for extensions for Forth and disambiguate |
| 931 |
between Fortran and Forth. |
| 932 |
o Better output with --explain for languages that share file |
| 933 |
extensions. |
| 934 |
o Ignore .o.cmd files as they are Linux kernel compilation |
| 935 |
optimization files. |
| 936 |
o Add .kts extension for Kotlin. |
| 937 |
o Add .cljc extension for ClojureC. |
| 938 |
o Add .ui extension for Qt. |
| 939 |
o Support php and php5 as #! scripting languages. |
| 940 |
|
| 941 |
New options and features: |
| 942 |
|
| 943 |
--json Write the results as JavaScript Object Notation |
| 944 |
(JSON) formatted output. |
| 945 |
--fullpath Modifies the behavior of --match-f or |
| 946 |
--not-match-f to include the file's path |
| 947 |
in the regex, not just the file's basename. |
| 948 |
(This does not expand each file to include its |
| 949 |
absolute path, instead it uses as much of |
| 950 |
the path as is passed in to cloc.) |
| 951 |
--md Write the results as Markdown-formatted text. |
| 952 |
--verbose Synonym for -v. |
| 953 |
|
| 954 |
|
| 955 |
Bug Fixes: |
| 956 |
o Don't write language definition for "(unknown)" (via --write-lang-def). |
| 957 |
o Fix length of hyphen line with --sum-reports. |
| 958 |
o Fix uninitialized variable bug when --explain is given an unknown |
| 959 |
language. |
| 960 |
o Force files ending with .smarty to be counted as Smarty (unless over- |
| 961 |
ridden by --force-lang=X). |
| 962 |
o Fix hash reference bug triggered with '--csv --by-percent' combination . |
| 963 |
o Correctly recognize R files on Windows. |
| 964 |
|
| 965 |
============================================================================ |
| 966 |
Release Notes for cloc version 1.64 |
| 967 |
http://cloc.sourceforge.net |
| 968 |
June 27, 2015 |
| 969 |
|
| 970 |
New Languages: |
| 971 |
o DITA |
| 972 |
o dtrace |
| 973 |
o Elixir |
| 974 |
o Embedded Ruby |
| 975 |
o Julia |
| 976 |
o Mercury |
| 977 |
o Prolog |
| 978 |
o Protocol Buffers |
| 979 |
o PureScript |
| 980 |
o Qt Project |
| 981 |
o Racket |
| 982 |
o SAS |
| 983 |
o Standard ML |
| 984 |
o Titanium Style Sheet |
| 985 |
o Visual FoxPro |
| 986 |
o Windows Module Definition |
| 987 |
|
| 988 |
Updates: |
| 989 |
o Add support for sharpsign vertical bar block comments in Lisp. |
| 990 |
o Added python, python2.6, python2.7, python3, python3.3, python3.4 |
| 991 |
as script executables to identify Python files that don't end in .py. |
| 992 |
o Added rexx and regina as script executables for Rexx. |
| 993 |
o Extend Assembly filters to include !, |, @, --. |
| 994 |
o Add for, FOR, ftn, FTN extensions for Fortran 77. |
| 995 |
o Improve --show-lang so that it exactly matches a language instead of |
| 996 |
finding the language in a regex (eg 'C' matched nearly everything). |
| 997 |
o Update --explain to also print language extensions. |
| 998 |
o Change --sql schema by adding fields File_dirname, File_basename to |
| 999 |
table 't' of SQL output to simplify obtaining per-directory metrics |
| 1000 |
o Escape embedded single quotes in file names (bug #127) for SQL output. |
| 1001 |
o Improved language detection for Objective C (earlier misidentified |
| 1002 |
as MATLAB or other .m languages). |
| 1003 |
o Sort duplicate file lists by full path instead of basename to give |
| 1004 |
repeatable output. |
| 1005 |
o Change SQL schema 'text' type to more standard 'varchar(500)'. |
| 1006 |
o Added .gradle extension for Groovy. |
| 1007 |
o Better handling of files ending with .d (could be Linux init scripts). |
| 1008 |
o Added .robot extension for RobotFramework. |
| 1009 |
o Support Python unicode docstrings, patch by <[email protected]>. |
| 1010 |
o Ignore line ending styles when diff'ing Windows and Unix files. |
| 1011 |
|
| 1012 |
|
| 1013 |
New options and features: |
| 1014 |
|
| 1015 |
--count-and-diff <set1> <set2> |
| 1016 |
First perform direct code counts of source file(s) |
| 1017 |
of <set1> and <set2> separately, then perform a |
| 1018 |
diff of these. Inputs may be pairs of files, |
| 1019 |
directories, or archives. See also --diff, |
| 1020 |
--diff-alignment, --diff-timeout, --ignore-case, |
| 1021 |
--ignore-whitespace. |
| 1022 |
|
| 1023 |
--include-lang=<L1>[,L2,] |
| 1024 |
Count only the given comma separated languages |
| 1025 |
L1, L2, L3, et cetera. |
| 1026 |
Patch by Ryan Lindeman. |
| 1027 |
|
| 1028 |
--by-percent X Instead of comment and blank line counts, show |
| 1029 |
these values as percentages based on the value |
| 1030 |
of X in the denominator: |
| 1031 |
X = 'c' -> # lines of code |
| 1032 |
X = 'cm' -> # lines of code + comments |
| 1033 |
X = 'cb' -> # lines of code + blanks |
| 1034 |
X = 'cmb' -> # lines of code + comments + blanks |
| 1035 |
For example, if using method 'c' and your code |
| 1036 |
has twice as many lines of comments as lines |
| 1037 |
of code, the value in the comment column will |
| 1038 |
be 200%. The code column remains a line count. |
| 1039 |
Patch by Ryan Lindeman. |
| 1040 |
|
| 1041 |
--sql-style=<style> Write SQL statements in the given style instead |
| 1042 |
of the default SQLite format. Currently, the |
| 1043 |
only style option is Oracle. |
| 1044 |
|
| 1045 |
|
| 1046 |
Bug Fixes: |
| 1047 |
o Added a more sophisticated method to align top level directories |
| 1048 |
for --diff. |
| 1049 |
o Fixes XML output when running with --sum-reports and --xml so the |
| 1050 |
.lang file ends with <languages/> and the .file file ends with |
| 1051 |
<files/> (previously both ended with <languages/>). |
| 1052 |
o Fix logig error when handling HAML block comments. |
| 1053 |
o Fix language filter for Groovy. |
| 1054 |
o Fix some forward and backslash issues with file name parsing |
| 1055 |
in Windows filenames during --diff. |
| 1056 |
o Handle --exclude-file-list when running with --diff. |
| 1057 |
o Fix regex error for detecting double extensions (eg .sproc.sql) |
| 1058 |
provided by Super Dave <[email protected]> |
| 1059 |
|
| 1060 |
============================================================================ |
| 1061 |
Release Notes for cloc version 1.62 |
| 1062 |
http://cloc.sourceforge.net |
| 1063 |
July 29 2014 |
| 1064 |
|
| 1065 |
New Languages: |
| 1066 |
o CUDA |
| 1067 |
o ECPP |
| 1068 |
o F# |
| 1069 |
o Grails |
| 1070 |
o Haml |
| 1071 |
o Handlebars |
| 1072 |
o Harbour |
| 1073 |
o HLSL |
| 1074 |
o JSON |
| 1075 |
o Kotlin |
| 1076 |
o Mustache |
| 1077 |
o PL/I |
| 1078 |
o Puppet manifest |
| 1079 |
o R |
| 1080 |
o Racket |
| 1081 |
o Rake |
| 1082 |
o RobotFramework |
| 1083 |
o Swift |
| 1084 |
o TypeScript |
| 1085 |
o Unity-Prefab |
| 1086 |
o Velocity Template Language |
| 1087 |
o Windows Message |
| 1088 |
o Windows Module Definition |
| 1089 |
o Windows Resource |
| 1090 |
o WiX include |
| 1091 |
o WiX source |
| 1092 |
o WiX string localization |
| 1093 |
o xBase |
| 1094 |
o xBase Header |
| 1095 |
o XQuery |
| 1096 |
|
| 1097 |
Updates: |
| 1098 |
o JSP Added extension .jspf |
| 1099 |
o MSBuild script Added extensions .vcproj, .wixproj, .vbproj |
| 1100 |
o DOS Batch Added extensions .cmd, .btm |
| 1101 |
o C++ Added extension .c++ |
| 1102 |
o Pascal Lines that begin with {! are counted as code as |
| 1103 |
some compilers treat these as a compiler directives. |
| 1104 |
o Lisp Treat text between #| and |# as a block comment. |
| 1105 |
o Suppress progress rate display if --quiet is set. |
| 1106 |
o --exclude-dir directories are pruned before the file search |
| 1107 |
descends into those directories instead of just ignoring |
| 1108 |
files there |
| 1109 |
o The logic that aligns file pairs between --diff sets was |
| 1110 |
rewritten. Corner cases such as diff between one file and |
| 1111 |
a set of files are handled much more precisely. |
| 1112 |
|
| 1113 |
New options and features: |
| 1114 |
|
| 1115 |
--explain=LANG Print the filters used to remove comments for |
| 1116 |
language LANG and exit. In some cases the |
| 1117 |
filters refer to Perl subroutines rather than |
| 1118 |
regular expressions. An examination of the |
| 1119 |
source code may be needed for further explanation. |
| 1120 |
|
| 1121 |
Added new filter macros: |
| 1122 |
o remove_between_general, which accepts start and end comment marker. |
| 1123 |
o remove_between_regex, which accepts start and end comment regexes. |
| 1124 |
|
| 1125 |
Properly handle text files that begin with Unicode Byte Order Marks. |
| 1126 |
|
| 1127 |
Bug Fixes: |
| 1128 |
|
| 1129 |
Remove spurious newlines produced by bad comment removal regexes |
| 1130 |
which could cause incorrect diff's. |
| 1131 |
Correctly handle file extensions with non-alphanumeric characters. |
| 1132 |
Show file count with --sum-reports. |
| 1133 |
Properly encode characters &,<,>,",' in XML output. |
| 1134 |
Properly read and write entries for the 'remove_between_general' |
| 1135 |
macro in language definition text files. |
| 1136 |
|
| 1137 |
============================================================================ |
| 1138 |
Release Notes for cloc version 1.60 |
| 1139 |
http://cloc.sourceforge.net |
| 1140 |
August 16, 2013 |
| 1141 |
|
| 1142 |
New Languages: |
| 1143 |
o LESS |
| 1144 |
o Razor |
| 1145 |
o JavaServer Faces |
| 1146 |
o SASS |
| 1147 |
o Apex Trigger |
| 1148 |
o Visualforce Component |
| 1149 |
o Visualforce Page |
| 1150 |
o Verilog-SystemVerilog |
| 1151 |
o Pig Latin |
| 1152 |
|
| 1153 |
Updates: |
| 1154 |
o Improved handling of UTF-16 (both little and big endian). |
| 1155 |
o use Time::HiRes if available. |
| 1156 |
o Improved logic that distinguishes between Objective C, |
| 1157 |
MUMPS and MATLAB files. |
| 1158 |
o Added information about duplicate files to output created |
| 1159 |
by --ignored. |
| 1160 |
o Added support for .tar.xz compressed archives. |
| 1161 |
o CMake Added .cmake file extension. |
| 1162 |
o MXML Added support for Actionscript |
| 1163 |
o Groovy Added .gant file extension. |
| 1164 |
o Vala Recognize Vala header files. |
| 1165 |
|
| 1166 |
New options and features: |
| 1167 |
|
| 1168 |
--max-file-size=<MB> Skip files larger than <MB> megabytes when |
| 1169 |
traversing directories. By default, <MB>=100. |
| 1170 |
cloc's memory requirement is roughly twenty times |
| 1171 |
larger than the largest file so running with |
| 1172 |
files larger than 100 MB on a computer with less |
| 1173 |
than 2 GB of memory will cause problems. |
| 1174 |
Note: this check does not apply to files |
| 1175 |
explicitly passed as command line arguments. |
| 1176 |
|
| 1177 |
Bug Fixes: |
| 1178 |
|
| 1179 |
Suppress "Wrote <file>" messages when running with --quiet. |
| 1180 |
Fixed an error that caused cloc to fail with "Can't use an |
| 1181 |
undefined value as an ARRAY reference" when running with |
| 1182 |
Perl 5.16 or newer when it encounters certain file types. |
| 1183 |
|
| 1184 |
============================================================================ |
| 1185 |
Release Notes for cloc version 1.58 |
| 1186 |
http://cloc.sourceforge.net |
| 1187 |
March 3, 2013 |
| 1188 |
|
| 1189 |
Version 1.58 introduces a new version numbering scheme: odd numbers |
| 1190 |
represent development versions while even numbers represent stable, |
| 1191 |
released versions. There was no release 1.57 as it was the development |
| 1192 |
version leading to this release. |
| 1193 |
|
| 1194 |
New Languages: |
| 1195 |
o Ant |
| 1196 |
o Arduino Sketch |
| 1197 |
o InstallShield |
| 1198 |
o Maven |
| 1199 |
o PowerShell |
| 1200 |
o Rust |
| 1201 |
o Vala |
| 1202 |
|
| 1203 |
Updates: |
| 1204 |
o OCaml Added extensions .mli, .mly, .mll |
| 1205 |
o --read-lang-def See the section --read-lang-def v. |
| 1206 |
--force-lang-def below. |
| 1207 |
|
| 1208 |
New options and features: |
| 1209 |
|
| 1210 |
--diff-timeout N |
| 1211 |
o Running diff on large files with many repeated lines may |
| 1212 |
cause Algorithm::Diff::sdiff() to run for hours. This |
| 1213 |
option sets the upper time limit on the duration of this |
| 1214 |
operation for a single file pair. Default is 10 seconds. |
| 1215 |
|
| 1216 |
--force-lang-def FILE |
| 1217 |
o See the section --read-lang-def v. --force-lang-def below. |
| 1218 |
|
| 1219 |
--skip-archive REGEX |
| 1220 |
o Ignore files that end with the given Perl regular expression. |
| 1221 |
For example, if given --skip-archive='(zip|tar(.(gz|Z|bz2|xz|7z))?)' |
| 1222 |
the code will skip files that end with .zip, .tar, .tar.gz, |
| 1223 |
.tar.Z, .tar.bz2, .tar.xz, and .tar.7z (feature req. 32). |
| 1224 |
|
| 1225 |
Prevent "defined(@array) is deprecated" warnings with Perl 5.16.1. |
| 1226 |
|
| 1227 |
Show an example of alternation in the documentation for the --match-d |
| 1228 |
switch. |
| 1229 |
|
| 1230 |
|
| 1231 |
--read-lang-def v. --force-lang-def |
| 1232 |
|
| 1233 |
The --read-lang-def option allows one to replace cloc's language |
| 1234 |
processing filters with custom settings. The problem with this |
| 1235 |
option is that it overwrites internal logic that handles languages |
| 1236 |
which map to the same file extension. Currently these are |
| 1237 |
MATLAB/Objective C/MUMPS -> .m |
| 1238 |
Pascal/PHP -> .inc |
| 1239 |
Lisp/OpenCL -> .cl |
| 1240 |
The logic needed to handle these extension collisions is not |
| 1241 |
easily expressed in an input text file. In any event, in most |
| 1242 |
instances one merely wishes to augment cloc's language definitions |
| 1243 |
with entries for new languages rather than replace definitions |
| 1244 |
for known languages. |
| 1245 |
|
| 1246 |
For this reason, the behavior of --read-lang-def has been changed |
| 1247 |
to merge new language definitions found in the given file with |
| 1248 |
cloc's existing languages. Where there are conflicts, cloc's |
| 1249 |
built-in definitions take precedence. This new behavior allows |
| 1250 |
one to add new language definitions without sacrificing cloc's |
| 1251 |
ability to count files languages ending with .m, .inc, or .cl. |
| 1252 |
|
| 1253 |
The new option --force-lang-def behaves exactly like --read-lang-def |
| 1254 |
did in cloc versions 1.56 and earlier--it completely ignores |
| 1255 |
cloc's internal language definitions and replaces them with definitions |
| 1256 |
in the given file. However, one will no longer be able to count |
| 1257 |
files with the extensions .m, .inc, or .cl. |
| 1258 |
|
| 1259 |
Bug Fixes: |
| 1260 |
|
| 1261 |
Suppress "Wrote <file>" messages when running with --quiet. |
| 1262 |
|
| 1263 |
Create .file output when running with --sum-reports (id 3571353). |
| 1264 |
|
| 1265 |
Correct output for languages starting with a lower case letter when |
| 1266 |
running with --diff --sum-reports. |
| 1267 |
|
| 1268 |
Show correct count of files added/deleted with --diff (id 78). |
| 1269 |
|
| 1270 |
Handle special case of --diff between one file and a set of files (id 82). |
| 1271 |
|
| 1272 |
Prevent cloc from inadvertently counting lines from temporary |
| 1273 |
installations of Algorithm::Diff and/or Regexp::Common. This happens |
| 1274 |
on faulty Perl installations (eg. MinGW MSYS Perl) which cause |
| 1275 |
File::Temp::tempdir() to return the current working directory. |
| 1276 |
|
| 1277 |
============================================================================ |
| 1278 |
Release Notes for cloc version 1.56 |
| 1279 |
http://cloc.sourceforge.net |
| 1280 |
April 3, 2012 |
| 1281 |
|
| 1282 |
Version 1.56 introduces an additional documentation file, cloc.1.pod, which |
| 1283 |
can be used to produce cloc's documentation in the style of a Unix man page, |
| 1284 |
plain text, HTML, or LaTeX. |
| 1285 |
|
| 1286 |
New Languages: |
| 1287 |
o Clojure |
| 1288 |
o ClojureScript |
| 1289 |
o AutoHotkey |
| 1290 |
o QML |
| 1291 |
o CFScript |
| 1292 |
o OpenCL |
| 1293 |
|
| 1294 |
New options and features: |
| 1295 |
|
| 1296 |
--unix |
| 1297 |
o Override the operating system autodetection logic and run in |
| 1298 |
UNIX mode. |
| 1299 |
|
| 1300 |
--windows |
| 1301 |
o Override the operating system autodetection logic and run in |
| 1302 |
Microsoft Windows mode. |
| 1303 |
|
| 1304 |
--show-os |
| 1305 |
o Print the name of the of the operating system mode and exit. |
| 1306 |
|
| 1307 |
--csv-delimiter |
| 1308 |
o Use the provided delimiter instead of a comma when generating |
| 1309 |
csv output. |
| 1310 |
|
| 1311 |
--stdin-name |
| 1312 |
o On UNIX systems, enables cloc to count code piped in via STDIN. |
| 1313 |
This switch provides a filename for to use to infer the language. |
| 1314 |
|
| 1315 |
.git subdirectories are now ignored. |
| 1316 |
|
| 1317 |
Updated yacc counter to recognize C99 comments. |
| 1318 |
|
| 1319 |
Improved detection and reporting of ignored zero sized files. |
| 1320 |
|
| 1321 |
Removed spurious <languages> from YAML output. |
| 1322 |
|
| 1323 |
Fixed handling of multi-line Ruby comments surrounded by =begin/=end. |
| 1324 |
|
| 1325 |
Associated .ctl and .dsr extensions with Visual Basic |
| 1326 |
|
| 1327 |
Bug Fixes: |
| 1328 |
|
| 1329 |
Produce correct diff results when comparing empty files with populated |
| 1330 |
files. |
| 1331 |
|
| 1332 |
Remove temporary directory names from --by-file output when working |
| 1333 |
with archive files. |
| 1334 |
|
| 1335 |
Honor user's requested scratch directory if given --sdir. |
| 1336 |
|
| 1337 |
============================================================================ |
| 1338 |
Release Notes for cloc version 1.55 |
| 1339 |
http://cloc.sourceforge.net |
| 1340 |
October 14, 2011 |
| 1341 |
|
| 1342 |
Version 1.55 is a bugfix release to correct malformed XML output |
| 1343 |
that was introduced in the 1.54 release. Two minor enhancements |
| 1344 |
were added: |
| 1345 |
|
| 1346 |
New Languages: |
| 1347 |
o Dart |
| 1348 |
|
| 1349 |
New options and features: |
| 1350 |
|
| 1351 |
--sum-one |
| 1352 |
o Force printing of the SUM: line even if only one source |
| 1353 |
file is counted. |
| 1354 |
|
| 1355 |
============================================================================ |
| 1356 |
Release Notes for cloc version 1.54 |
| 1357 |
http://cloc.sourceforge.net |
| 1358 |
October 1, 2011 |
| 1359 |
|
| 1360 |
|
| 1361 |
New Languages: |
| 1362 |
o CMake |
| 1363 |
o Cython |
| 1364 |
o Objective C++ |
| 1365 |
o Ocaml |
| 1366 |
o Smarty |
| 1367 |
|
| 1368 |
New options and features: |
| 1369 |
|
| 1370 |
--autoconf |
| 1371 |
o Count files of recognized languages that end with ".in" |
| 1372 |
(for example, code.h.in, Makefile.in) as used by GNU |
| 1373 |
automake/autoconf. |
| 1374 |
|
| 1375 |
--match-d, --not-match-d |
| 1376 |
o Include, or skip over, directories whose names match |
| 1377 |
provided regular expressions. |
| 1378 |
|
| 1379 |
--follow-links |
| 1380 |
o Follow symbolic links (on Unix-like OS's). |
| 1381 |
|
| 1382 |
YAML and XML output: header lines now include the cloc URL, |
| 1383 |
version, # lines and files counted, etc. |
| 1384 |
|
| 1385 |
YAML and XML output: if writing to a file (rather than STDOUT), |
| 1386 |
save the file name as an element inside the file. |
| 1387 |
|
| 1388 |
Include support for languages with double extensions. First |
| 1389 |
implementation of these uses .spc.sql for SQL Stored Procedures |
| 1390 |
and .data.sql as SQL Data as distinct from just SQL. |
| 1391 |
|
| 1392 |
Handle archive files (tar files, zip files, etc) with spaces |
| 1393 |
in their names. |
| 1394 |
|
| 1395 |
Bug Fixes: |
| 1396 |
|
| 1397 |
Lisp: Include .lisp as a valid file extension. |
| 1398 |
|
| 1399 |
Correctly identify operating system as Windows if MKS Toolkit is |
| 1400 |
installed. |
| 1401 |
|
| 1402 |
Fix incorrectly handled .inc files (could be PHP or Pascal). |
| 1403 |
|
| 1404 |
--counted |
| 1405 |
o Correct output to show only files which were actually |
| 1406 |
used to produce the code count. Also show the output |
| 1407 |
by language rather than by filename. |
| 1408 |
|
| 1409 |
--diff |
| 1410 |
o Fixed null output when one input has a single file while |
| 1411 |
the comparison input has multiple files. |
| 1412 |
o Fixed null output when no lines of code are modified in |
| 1413 |
common files (only entire files were added or removed). |
| 1414 |
o Handle cases where one of the two inputs is an empty |
| 1415 |
file or directory. |
| 1416 |
|
| 1417 |
--diff + --exclude-file-list |
| 1418 |
o --diff now skips files defined by --exclude-file-list |
| 1419 |
|
| 1420 |
--diff + --exclude-lang |
| 1421 |
o --diff now skips languages defined by --exclude-lang |
| 1422 |
|
| 1423 |
--diff + --xml |
| 1424 |
o Include user-provided xsl file name in XML --diff output. |
| 1425 |
o XML output for --by-file and --by-file-by-lang. |
| 1426 |
|
| 1427 |
--diff + --csv |
| 1428 |
o Added comma separated value output for --diff. |
| 1429 |
|
| 1430 |
--diff + --sum-reports |
| 1431 |
o Can now use the --sum-reports option with --diff. |
| 1432 |
|
| 1433 |
--exclude-dir |
| 1434 |
o Quote metacharacters when comparing directory names against |
| 1435 |
--exclude-dir value. |
| 1436 |
|
| 1437 |
--strip-comments |
| 1438 |
o Do not remove blank lines if they follow lines with |
| 1439 |
(language-dependent) continuation markers. |
| 1440 |
|
| 1441 |
--sum-reports + --list-file |
| 1442 |
o Allow the --sum-reports option to take its inputs from |
| 1443 |
files defined by --list-file |
| 1444 |
|
| 1445 |
Outstanding issues: |
| 1446 |
--sql output formats remain unimplemented for --diff. |
| 1447 |
|
| 1448 |
============================================================================ |
| 1449 |
Release Notes for cloc version 1.53 |
| 1450 |
http://cloc.sourceforge.net |
| 1451 |
|
| 1452 |
New Languages: |
| 1453 |
o Go |
| 1454 |
o MXML |
| 1455 |
|
| 1456 |
New options: |
| 1457 |
|
| 1458 |
--lang-no-ext |
| 1459 |
o Alternate method to count files without file |
| 1460 |
extension. |
| 1461 |
--ignore-case |
| 1462 |
o Works with --diff; treat uppercase and lowercase text |
| 1463 |
as equivalent. |
| 1464 |
|
| 1465 |
Bug Fixes: |
| 1466 |
|
| 1467 |
Pascal: Add // as a comment marker. |
| 1468 |
IDL: Include .pro as a recognized file extension. |
| 1469 |
|
| 1470 |
--3: |
| 1471 |
o Correct XSLT style when running with --3. |
| 1472 |
|
| 1473 |
--diff: |
| 1474 |
o Implemented YAML output option. |
| 1475 |
o Implemented XML output option. Includes an optional |
| 1476 |
default XSLT style file. |
| 1477 |
o Include code/comment/blank counts of added files to |
| 1478 |
total added material and include code/comment/blank |
| 1479 |
counts of removed files to total removed material. |
| 1480 |
o Ignore unrecognized languages. |
| 1481 |
|
| 1482 |
--exclude-ext |
| 1483 |
o Was inadvertently disabled in v1.52; works now. |
| 1484 |
|
| 1485 |
Outstanding issues: |
| 1486 |
--csv, --sql output formats remain unimplemented for --diff. |
| 1487 |
|
| 1488 |
============================================================================ |
| 1489 |
Release Notes for cloc version 1.52 |
| 1490 |
http://cloc.sourceforge.net |
| 1491 |
|
| 1492 |
New Languages: |
| 1493 |
o Groovy |
| 1494 |
o Scala |
| 1495 |
o XAML |
| 1496 |
|
| 1497 |
New options: |
| 1498 |
|
| 1499 |
--exclude-ext |
| 1500 |
o Ignore files with the given file extension. |
| 1501 |
|
| 1502 |
--ignore-whitespace |
| 1503 |
o Works with --diff; ignore whitespace in code and comments |
| 1504 |
when computing differences. |
| 1505 |
|
| 1506 |
Bug Fixes: |
| 1507 |
|
| 1508 |
Fortran: Treat line starting with an exclamation mark as a comment. |
| 1509 |
Cobol: Treat page eject directive and any line with characters |
| 1510 |
in columns 1-6 as a blank line. |
| 1511 |
|
| 1512 |
--diff: |
| 1513 |
o Fix negative value of removed blank lines. |
| 1514 |
o Better output column alignment when running with --by-file. |
| 1515 |
o Bug fixes when dealing with fully qualified Windows paths. |
| 1516 |
|
| 1517 |
--exclude-list-file |
| 1518 |
o Can now also include directories to ignore in the supplied |
| 1519 |
input file. |
| 1520 |
|
| 1521 |
Other Improvements: |
| 1522 |
o Better logic to select the file whose name identifies it as |
| 1523 |
containing source code when the file is one of several having |
| 1524 |
identical contents (for example, if main.c and main.c.bak have |
| 1525 |
identical contents, choose main.c for counting instead of |
| 1526 |
main.c.bak, which would be rejected because the filename |
| 1527 |
does not match any recognized language). |
| 1528 |
o Contents of .hg/ (Mercurial) directories are ignored. |
| 1529 |
o On Windows: Ignore case in file name extensions. |