[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 9136c93 06/11: Readme
From: |
Artur Malabarba |
Subject: |
[elpa] master 9136c93 06/11: Readme |
Date: |
Sat, 07 Mar 2015 20:43:03 +0000 |
branch: master
commit 9136c93cbe44ed15df4c51a1f9310ebea512dcfe
Author: Artur Malabarba <address@hidden>
Commit: Artur Malabarba <address@hidden>
Readme
---
README.org | 23 +++++++++++++++++++++++
spinner.el | 26 ++++++++++++++++++++++++--
2 files changed, 47 insertions(+), 2 deletions(-)
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..0c680c0
--- /dev/null
+++ b/README.org
@@ -0,0 +1,23 @@
+#+TITLE: spinner.el
+
+Add spinners and progress-bars to the mode-line for ongoing operations.
+
+* Usage
+
+1. Add ~(spinner "1.0")~ to your package’s dependencies.
+
+2. Call ~(spinner-start)~ and a spinner will be added to the mode-line.
+
+3. Call ~(spinner-stop)~ on the same buffer when you want to remove it.
+
+* Behavior
+
+The default spinner is a line drawing that rotates. You can pass an
+argument to ~spinner-start~ to specify which spinner you want. All
+possibilities are listed in the ~spinner-types~ variable, but here are
+a few examples for you to try:
+
+- ~(spinner-start 'vertical-breathing 10)~
+- ~(spinner-start 'minibox)~
+- ~(spinner-start 'moon)~
+- ~(spinner-start 'triangle)~
diff --git a/spinner.el b/spinner.el
index 4297b24..06b0d83 100644
--- a/spinner.el
+++ b/spinner.el
@@ -20,8 +20,30 @@
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
-
-;; Run `(spinner-start)' to see the effect.
+;; 1 Usage
+;; ═══════
+;;
+;; 1. Add `(spinner "1.0")' to your package’s dependencies.
+;;
+;; 2. Call `(spinner-start)' and a spinner will be added to the
+;; mode-line.
+;;
+;; 3. Call `(spinner-stop)' on the same buffer when you want to remove
+;; it.
+;;
+;;
+;; 2 Behavior
+;; ══════════
+;;
+;; The default spinner is a line drawing that rotates. You can pass an
+;; argument to `spinner-start' to specify which spinner you want. All
+;; possibilities are listed in the `spinner-types' variable, but here are
+;; a few examples for you to try:
+;;
+;; • `(spinner-start 'vertical-breathing 10)'
+;; • `(spinner-start 'minibox)'
+;; • `(spinner-start 'moon)'
+;; • `(spinner-start 'triangle)'
;;; Code:
- [elpa] master updated (5736e85 -> 690a61b), Artur Malabarba, 2015/03/07
- [elpa] master 72aa357 01/11: Initial commit, Artur Malabarba, 2015/03/07
- [elpa] master 2a7b2eb 03/11: Add spinners, Artur Malabarba, 2015/03/07
- [elpa] master 0e69061 05/11: Headline, Artur Malabarba, 2015/03/07
- [elpa] master 1ce3b52 02/11: Add file, Artur Malabarba, 2015/03/07
- [elpa] master 3f5871a 04/11: Customizable speed, Artur Malabarba, 2015/03/07
- [elpa] master 42c92ad 07/11: Whitespace, Artur Malabarba, 2015/03/07
- [elpa] master 88741b8 09/11: A couple more spinners, Artur Malabarba, 2015/03/07
- [elpa] master 9136c93 06/11: Readme,
Artur Malabarba <=
- [elpa] master 9477ee8 10/11: Add url, Artur Malabarba, 2015/03/07
- [elpa] master b0161b1 08/11: ADd gif, Artur Malabarba, 2015/03/07
- [elpa] master 690a61b 11/11: Add 'packages/spinner/' from commit '9477ee899d62259d4b946f243cdcdd9cdeb1e910', Artur Malabarba, 2015/03/07