<commit_before>Documentation should use [Journo](https://github.com/jashkenas/journo) formats and standards.

### Array concatenation via `_.cat`

Signature: `_.cat(... arrays:Array ...)`

The `_.cat` function provides a way to concatenate zero or more heterogeneous arrays into one.

```javascript
_.cat();                    // 0-args
//=> []

_.cat([]);                  // 1-arg, empty array
//=> []

_.cat([1,2,3]);             // 1-arg
//=> []

_.cat([1,2,3],[4,5,6]);     // 2-args
//=> [1,2,3,4,5,6]

_.cat([1,2,3],[4,5,6],[7]); // 3+ args
//=> [1,2,3,4,5,6,7]
```

Not every argument to `_.cat` needs to be an array; other types are accepted:

```javascript
_.cat(1,[2],3,4);           // mixed args
//=> [1,2,3,4]
```

The `_.cat` function will also work with the `arguments` object as if it were an array.

## Array construction via `_.cons`

Signature: `_.cons(head:Any, tail:Array)`

The `_.cons` function provides a way to "construct" a new array by taking some element and putting it at the front of another array.

```javascript
_.cons(0, []);
//=> [0]

_.cons(1, [2]);
//=> [1,2]

_.cons([0], [1,2,3]);
//=> [0,1,2,3]
```

The `_.cons` function also can be used to create pairs if the second argument is not an array.

Signature: `_.cons(head:Any, tail:Any)`

```javascript
_.cons(1, 2);
//=> [1,2]

_.cons([1], 2);
//=> [[1],2]
```

## Array partitioning via `_.partition` and `_.partitionAll`

    partition: function(array, n, pad) {
	partitionAll: function(array, n, step) {
	
## Array flattening via `_.mapcat`
	
    mapcat: function(array, fun) {
	
## Inserting elements into an array via `_.interpose`
	
    interpose: function(array, inter) {
	
## Weaving arrays together via `_.weave` and `_.interleave`
	
    weave: function(/* args */) {
    interleave: _.weave,
	
## Building arrays from repeated value with `_.repeat` and `_.cycle`
	
    repeat: function(t, elem) {<commit_msg>Added _.cons arguments examples<commit_after>Documentation should use [Journo](https://github.com/jashkenas/journo) formats and standards.

### Array concatenation via `_.cat`

Signature: `_.cat(... arrays:Array ...)`

The `_.cat` function provides a way to concatenate zero or more heterogeneous arrays into one.

```javascript
_.cat();                    // 0-args
//=> []

_.cat([]);                  // 1-arg, empty array
//=> []

_.cat([1,2,3]);             // 1-arg
//=> []

_.cat([1,2,3],[4,5,6]);     // 2-args
//=> [1,2,3,4,5,6]

_.cat([1,2,3],[4,5,6],[7]); // 3+ args
//=> [1,2,3,4,5,6,7]
```

Not every argument to `_.cat` needs to be an array; other types are accepted:

```javascript
_.cat(1,[2],3,4);           // mixed args
//=> [1,2,3,4]
```

The `_.cat` function will also work with the `arguments` object as if it were an array.

## Array construction via `_.cons`

Signature: `_.cons(head:Any, tail:Array)`

The `_.cons` function provides a way to "construct" a new array by taking some element and putting it at the front of another array.

```javascript
_.cons(0, []);
//=> [0]

_.cons(1, [2]);
//=> [1,2]

_.cons([0], [1,2,3]);
//=> [0,1,2,3]
```

The `_.cons` function also can be used to create pairs if the second argument is not an array.

Signature: `_.cons(head:Any, tail:Any)`

```javascript
_.cons(1, 2);
//=> [1,2]

_.cons([1], 2);
//=> [[1],2]
```

Finally, `_.cons` will operate with the `arguments` object.

Signature: `_.cons(head:Any, tail:Arguments)`

```javascript
function f() { return _.cons(0, arguments) }

f(1,2,3);
//=> [0,1,2,3]
```

## Array partitioning via `_.partition` and `_.partitionAll`

    partition: function(array, n, pad) {
	partitionAll: function(array, n, step) {
	
## Array flattening via `_.mapcat`
	
    mapcat: function(array, fun) {
	
## Inserting elements into an array via `_.interpose`
	
    interpose: function(array, inter) {
	
## Weaving arrays together via `_.weave` and `_.interleave`
	
    weave: function(/* args */) {
    interleave: _.weave,
	
## Building arrays from repeated value with `_.repeat` and `_.cycle`
	
    repeat: function(t, elem) {
{'fraction_non_alphanumeric': 0.1977667493796526, 'fraction_numerical': 0.0337468982630273, 'mean_word_length': 3.2610993657505287, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 26, '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': '1670582', 'n_tokens_mistral': 1490, 'n_tokens_neox': 1406, 'n_words': 428}