Update the docs, remove the shallow clone proscription.

This commit is contained in:
Steven Black
2017-08-20 12:18:57 -04:00
parent db70e34166
commit 1ee48fb718
16 changed files with 128 additions and 288 deletions
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, gambling, porn, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -93,6 +75,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, gambling, porn extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -92,6 +74,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, gambling, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -91,6 +73,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, gambling extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -90,6 +72,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, porn, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -92,6 +74,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, porn extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -91,6 +73,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -90,6 +72,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with fakenews extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -89,6 +71,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with gambling, porn, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -92,6 +74,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with gambling, porn extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -91,6 +73,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with gambling, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -90,6 +72,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with gambling extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -89,6 +71,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with porn, social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -91,6 +73,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with porn extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -90,6 +72,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with social extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -89,6 +71,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated
+8 -18
View File
@@ -1,23 +1,5 @@
[![Build Status](https://travis-ci.org/StevenBlack/hosts.svg?branch=master)](https://travis-ci.org/StevenBlack/hosts)
### Cloning? Use a shallow clone and avoid 400 Mb of history
A **shallow clone** is a good idea because you probably don't need many years of history.
Like this:
git clone --depth 5 https://github.com/StevenBlack/hosts.git
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
Afterwards, you can follow the instructions above.
# Unified hosts file with base extensions
This repository consolidates several reputable `hosts` files, and merges them
@@ -88,6 +70,14 @@ folders.
## Generate your own unified hosts file
To run unit tests, in the top level directory, just run:
python testUpdateHostsFile.py
**Note** if you are using Python 2, you must first install the `mock` library:
pip install mock
The `updateHostsFile.py` script, which is python 2.7 and Python 3-compatible,
will generate a unified hosts file based on the sources in the local `data/`
subfolder. The script will prompt you Whether it should fetch updated