summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorLev Lamberov <dogsleg@debian.org>2016-09-23 09:49:35 +0500
committerLev Lamberov <dogsleg@debian.org>2016-09-23 09:49:35 +0500
commitf858a9011b9e1ae0155e29118fb1a697909f3a0e (patch)
tree18f970f3cb04253c96123cf28563bccc24edaca3 /README.org
New upstream version 0.1.1
Diffstat (limited to 'README.org')
-rw-r--r--README.org63
1 files changed, 63 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..437db91
--- /dev/null
+++ b/README.org
@@ -0,0 +1,63 @@
+* Restart Emacs
+
+ [[http://melpa.org/#/restart-emacs][file:http://melpa.org/packages/restart-emacs-badge.svg]] [[http://stable.melpa.org/#/restart-emacs][file:http://stable.melpa.org/packages/restart-emacs-badge.svg]] [[https://travis-ci.org/iqbalansari/restart-emacs][https://travis-ci.org/iqbalansari/restart-emacs.svg?branch=master]]
+
+
+** Table of contents :TOC_3_gh:
+ - [[#restart-emacs][Restart Emacs]]
+ - [[#what-is-this][What is this?]]
+ - [[#installation][Installation]]
+ - [[#elpa][ELPA]]
+ - [[#el-get][El-get]]
+ - [[#usage][Usage]]
+ - [[#compatibility][Compatibility]]
+ - [[#restarting-gui-emacs][Restarting GUI Emacs]]
+ - [[#restarting-emacs-running-in-a-terminal][Restarting Emacs running in a terminal]]
+
+** What is this?
+ This is a simple package to restart Emacs for within Emacs. Inspired by [[http://emacs.stackexchange.com/questions/5428/restart-emacs-from-within-emacs][this]]
+ stackoverflow question.
+
+** Installation
+*** ELPA
+ ~restart-emacs~ is available on [[http://melpa.org/#/restart-emacs][MELPA]] and [[http://stable.melpa.org/#/restart-emacs][MELPA Stable]]. Please follow the instructions on
+ MELPA [[http://melpa.org/#/getting-started][website]] to enable it, if you haven't already.
+
+ You can then install ~restart-emacs~ from the [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Package-Menu.html][package menu]]. Alternatively install it by doing the following
+
+ Refresh the package index
+ #+BEGIN_QUOTE
+ M-x package-refresh-contents RET
+ #+END_QUOTE
+
+ And then install it by doing
+ #+BEGIN_QUOTE
+ M-x package-install RET restart-emacs
+ #+END_QUOTE
+
+*** El-get
+ ~restart-emacs~ can also be installed using ~el-get~. Assuming you have latest version of el-get installing it by doing something similar to
+ #+BEGIN_QUOTE
+ M-x el-get-install RET restart-emacs
+ #+END_QUOTE
+
+** Usage
+ It offers only one command ~restart-emacs~ which kills current Emacs session
+ and starts a new session.
+
+ Additional arguments to be passed to the new instance can be specified using
+ prefix arguments
+
+ - with a single ~universal-argument~ (=C-u=) Emacs is restarted with ~--debug-init~ flag
+ - with two ~universal-argument~ (=C-u= =C-u=) Emacs is restarted with ~-Q~ flag
+ - with three ~universal-argument~ (=C-u= =C-u= =C-u=) the user is prompted for the arguments
+
+** Compatibility
+*** Restarting GUI Emacs
+ Restarting graphical Emacs should work on any UNIXy system with ~sh~ and on
+ Windows.
+
+*** Restarting Emacs running in a terminal
+ This requires that the shell from which Emacs was launched supports job
+ control. This has been tested to work on ~sh~, ~bash~, ~zsh~, ~fish~, ~csh~
+ and ~tcsh~, however this does not work on Windows.