From ef31e58d2625dc4a39addffadaba01d2f0a11071 Mon Sep 17 00:00:00 2001
From: Davis Goglin <davis.goglin@oregonicecream.com>
Date: Tue, 15 Mar 2016 12:00:56 -0700
Subject: [PATCH] Add base config documentation

---
 doc/user/usage.rst | 57 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/doc/user/usage.rst b/doc/user/usage.rst
index 074e8a0..26fdd68 100644
--- a/doc/user/usage.rst
+++ b/doc/user/usage.rst
@@ -120,6 +120,63 @@ on USB interface
     # Cut paper
     Epson.cut()
 
+Configuration File
+------------------
+
+You can create a configuration file for python-escpos. This will
+allow you to use the CLI, and skip some setup when using the library
+programically.
+
+The default configuration file is named ``config.ini``. For windows it is
+probably at::
+
+    %appdata%/python-escpos/config.ini
+
+And for linux::
+
+        $HOME/.config/python-escpos/config.ini
+
+If you aren't sure, run::
+
+        from escpos import config
+        c = config.Config()
+        c.load()
+
+If it can't find the configuration file in the default location, it will tell
+you where it's looking. You can always pass a path or a list of paths to
+search to the ``load()`` method.
+
+
+To load the configured pritner, run::
+
+        from escpos import config
+        c = config.Config()
+        printer = c.printer()
+
+
+The printer section
+^^^^^^^^^^^^^^^^^^^
+
+The ``[printer]`` configuration section defines a default printer to create.
+
+The only required paramter is ``type``. The value of this should be one of the
+printers defined in :doc:`/user/printers`.
+
+The rest of the parameters are whatever you want to pass to the printer.
+
+An example file printer::
+
+        [printer]
+        type=File
+        devfile=/dev/someprinter
+
+And for a network printer::
+
+        [printer]
+        type=network
+        host=127.0.0.1
+        port=9000
+
 How to update your code for USB printers
 ----------------------------------------