branch: externals/beardbolt
commit c442960f160f3fab565268950044435cd8fd26e8
Author: Jay Kamat <jaygka...@gmail.com>
Commit: Jay Kamat <jaygka...@gmail.com>
Add an easy way to turn off automatic recompilation
---
README.org | 8 ++++++--
rmsbolt.el | 14 +++++++++++---
2 files changed, 17 insertions(+), 5 deletions(-)
diff --git a/README.org b/README.org
index 154f72255c..23d07c70b9 100644
--- a/README.org
+++ b/README.org
@@ -17,6 +17,7 @@ versa.
- It's easy to add new languages (even those that use unique bytecode
formats)
without touching many files.
- Dosen't eat your ram on the 'server' or the 'client'
+ - No enforced limits on code size, compilation time, or processing time.
- Benefits from living in Emacs
- Full undo tree from Emacs on disassembly/source so you don't loose work.
- Vim bindings through evil/viper.
@@ -53,7 +54,8 @@ add it..
* Running
Once installed, use the ~rmsbolt-lang~ functions to generate starter files, or
enable ~rmsbolt-mode~ in a supported language. Then run ~rmsbolt-compile~ or
- use the default ~C-c C-c~ binding.
+ use the default ~C-c C-c~ binding. After the first run, the buffer should
+ automatically update.
* Demos
** C/C++
@@ -115,12 +117,14 @@ available in the compiled form if they exist.
settings into a valid command which will take in a filename and output
assembly or an executable. See ~rmsbolt--c-compile-cmd~ for an example.
- If the assembly is not in a standard format, you will need to define a
- ~process-asm-custom-fn~ as well.
+ ~process-asm-custom-fn~ as well (see python/java for examples).
2. [[file:rmsbolt.el::;;;;;%20Starter%20Definitions][Add a new entry into the
starter file]]
- For this, you will need to make a starter file. See
[[file:starters/][this folder]] for
existing examples.
You're done!
+
* Alternatives
- [[https://github.com/yawkat/javap][yawkat/javap]]
-
[[https://github.com/mattgodbolt/compiler-explorer][mattgodbolt/compiler-explorer]]
+- [[http://reliant.colab.duke.edu/c2mips/][c2mips]]
diff --git a/rmsbolt.el b/rmsbolt.el
index c9ab587eb0..0ef807fbfe 100644
--- a/rmsbolt.el
+++ b/rmsbolt.el
@@ -21,7 +21,9 @@
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
-;; TODO create commentary
+;; rmsbolt is a package to provide assembly or bytecode output for a source
code input file.
+;;
+;;
;;; Requires:
@@ -50,6 +52,10 @@
"Lighter displayed in mode line when `rmsbolt-mode' is active."
:type 'string
:group 'rmsbolt)
+(defcustom rmsbolt-automatic-recompile t
+ "Whether to automatically recompile on source buffer changes."
+ :type 'boolean
+ :group 'rmsbolt)
;;;;; Buffer Local Tweakables
(defcustom rmsbolt-disassemble nil
@@ -977,7 +983,7 @@ Outputs assembly file if ASM."
(rmsbolt-defstarter "python" 'python-mode)
(rmsbolt-defstarter "java" 'java-mode)
-;;;; Font lock matcher
+;;;; Overlay Commands
(defun rmsbolt--goto-line (line)
"Goto a certain LINE."
(when line
@@ -1069,6 +1075,7 @@ Outputs assembly file if ASM."
(defun rmsbolt-hot-recompile ()
"Recompile source buffer if we need to."
(when-let ((should-hot-compile rmsbolt-mode)
+ (should-hot-recompile rmsbolt-automatic-recompile)
(output-buffer (get-buffer rmsbolt-output-buffer))
(src-buffer (buffer-local-value 'rmsbolt-src-buffer
output-buffer))
(modified (buffer-modified-p src-buffer)))
@@ -1094,7 +1101,8 @@ This mode is enabled both in modes to be compiled and
output buffers."
(setq rmsbolt--idle-timer (run-with-idle-timer
rmsbolt-overlay-delay t
#'rmsbolt-move-overlays)))
- (unless rmsbolt--compile-idle-timer
+ (unless (or rmsbolt--compile-idle-timer
+ (not rmsbolt-automatic-recompile))
(setq rmsbolt--compile-idle-timer (run-with-idle-timer
rmsbolt-compile-delay t
#'rmsbolt-hot-recompile)))
