<commit_before>This is a C extension for [hotdoc](https://github.com/hotdoc/hotdoc)

This extension uses clang to generate symbols for C source code,
and implements its own comment scanner, to speed things up in
situations where the relevant comments are explicitly named, and
the user doesn't need to document static functions.

### Install instructions:

This extension uses the bindings of clang. It has been tested
with clang-3.5, but it *might* work with other clang versions.

To figure out the clang bindings that need to be installed,
hotdoc also needs the "llvm-config" program to be in the PATH.

This extension also uses flex for the comment scanner.

On Fedora 22 the dependencies can be installed with:

```
dnf install clang-devel llvm-devel flex python-devel
```

On a recent enough Debian / Ubuntu:

```
apt-get install libclang-3.5-dev llvm-3.5-dev flex python-dev
```

Otherwise you may still try to install an earlier version of clang with

```
apt-get install libclang-dev llvm-dev flex python-dev
```

If you use this extension in another environment, please let me know
how you installed these requirements :)

You can then install this extension either through pip:

```
pip install hotdoc_c_extension
```<commit_msg>And update doc again<commit_after>This is a C extension for [hotdoc](https://github.com/hotdoc/hotdoc)

This extension uses clang to generate symbols for C source code,
and implements its own comment scanner, to speed things up in
situations where the relevant comments are explicitly named, and
the user doesn't need to document static functions.

### Install instructions:

This extension uses the bindings of clang. It has been tested
with clang-3.5 and clang 3.6.2, but it *might* work with other clang versions.

To figure out the clang bindings that need to be installed,
hotdoc also needs the "llvm-config" program to be in the PATH.

This extension also uses flex for the comment scanner.

On Fedora 22 the dependencies can be installed with:

```
dnf install clang-devel llvm-devel flex python-devel
```

On a recent enough Debian / Ubuntu:

```
apt-get install libclang-dev llvm-dev flex python-dev
```

Otherwise you may still try to install an earlier version of clang with

```
apt-get install libclang-dev llvm-dev flex python-dev
```

If you use this extension in another environment, please let me know
how you installed these requirements :)

You can then install this extension either through pip:

```
pip install hotdoc_c_extension
```
{'fraction_non_alphanumeric': 0.06412825651302605, 'fraction_numerical': 0.006012024048096192, 'mean_word_length': 4.414316702819956, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7498693', 'n_tokens_mistral': 713, 'n_tokens_neox': 663, 'n_words': 356}