[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/beardbolt 47e9fa1f59 112/323: Update README
From: |
ELPA Syncer |
Subject: |
[elpa] externals/beardbolt 47e9fa1f59 112/323: Update README |
Date: |
Thu, 9 Mar 2023 10:58:22 -0500 (EST) |
branch: externals/beardbolt
commit 47e9fa1f5945d0f10e7dacbd929936a444bf3459
Author: Jay Kamat <jaygkamat@gmail.com>
Commit: Jay Kamat <jaygkamat@gmail.com>
Update README
---
README.org | 28 ++++++++++++++++++----------
rmsbolt.el | 4 ++--
starters/rmsbolt.pony | 2 +-
3 files changed, 21 insertions(+), 13 deletions(-)
diff --git a/README.org b/README.org
index b834d2c1b6..ead60725ce 100644
--- a/README.org
+++ b/README.org
@@ -12,7 +12,7 @@ versa. It supports more types of languages than any previous
tool of it's kind.
- Much more flexible and powerful
- Supports dissasembling to bytecode as well as assembly
- Supports many languages that godbolt does not support, such as python,
- common lisp, ocaml, and java.
+ common lisp, ocaml, java, and pony.
- No more sending your code to any server
- Much faster turnaround time from writing code to seeing and interacting with
disassembly
- 100% usable without the mouse.
@@ -54,10 +54,12 @@ though.
#+END_SRC
* Running
- Once installed, use the ~rmsbolt-starter~ command 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. After the first run, the buffer should
- automatically update.
+Once installed, use the ~rmsbolt-starter~ command 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. After the first run, the buffer should
+automatically update.
+
+Language-specific quirks are listed in the demos section currently.
* Demos
** C/C++
@@ -97,15 +99,21 @@ moment.
[[https://i.imgur.com/KkWEMMj.gif][https://i.imgur.com/KkWEMMj.gif]]
-** Common Lisp
+** Pony
-No support for source->asm matching or filtering.
+Filtering on pony is not as effective as pony asm includes references to
+machine-generated functions. This means the output will be slower to generate,
+similar to disassembly in other languages. The pony file being viewed will be
+copied into it's own directory, making it much harder to view non-toy examples.
-[[https://i.imgur.com/36aNVvf.gif][https://i.imgur.com/36aNVvf.gif]]
+[[https://i.imgur.com/8kd6kkJ.gif][https://i.imgur.com/8kd6kkJ.gif]]
-** Pony
+** Common Lisp
-Parses the output of ~ponyc -r=asm~ without good source->asm matching or
filtering.
+No support for source->asm matching or filtering. Only ~sbcl~ and ~clisp~
+supported at the moment, with ~sbcl~ giving much better results.
+
+[[https://i.imgur.com/36aNVvf.gif][https://i.imgur.com/36aNVvf.gif]]
* Adding a Language
diff --git a/rmsbolt.el b/rmsbolt.el
index eab2e3bd13..4908b9306c 100644
--- a/rmsbolt.el
+++ b/rmsbolt.el
@@ -25,8 +25,8 @@
;; RMSBolt is a package to provide assembly or bytecode output for a source
;; code input file.
;;
-;; It currently supports: C/C++, OCaml, Haskell, Python, Java, and (limited)
-;; Common Lisp and Pony.
+;; It currently supports: C/C++, OCaml, Haskell, Python, Java, Pony, and
+;; (limited) Common Lisp.
;;
;; Adding support for more languages, if they have an easy manual compilation
;; path from source->assembly/bytecode with debug information, should be much
diff --git a/starters/rmsbolt.pony b/starters/rmsbolt.pony
index 088921f9cb..2ce9207a3d 100644
--- a/starters/rmsbolt.pony
+++ b/starters/rmsbolt.pony
@@ -1,6 +1,6 @@
// pony rmsbolt starter file
-// Passing '--debug' is reccomended to pony because without it LOC hints are
optimized out
+// Passing '--debug' is recommended to pony because without it LOC hints are
optimized out
// Local Variables:
// rmsbolt-command: "ponyc --debug"
- [elpa] externals/beardbolt 9967391c74 105/323: Clean up pony support, (continued)
- [elpa] externals/beardbolt 9967391c74 105/323: Clean up pony support, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 910509ce5d 104/323: Document buffer-local tweakables in readme, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 5cecc2fb67 096/323: Fix typo in README, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 7e25ed58f2 099/323: Merge branch 'patch-1' into 'master', ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 439c7cb213 082/323: Satisfy checkdoc, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 04dd896bd5 114/323: Update README, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 6c53494f52 089/323: Add note for contributors, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 171a23628c 090/323: Reorder and clarify readme usage, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 26fc524912 083/323: Fix usage of if-let*, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 060f170a61 085/323: Clear overlays upon exiting rmsbolt mode, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 47e9fa1f59 112/323: Update README,
ELPA Syncer <=
- [elpa] externals/beardbolt c6831044c6 092/323: Update README, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 5c5e0e35db 115/323: Add prototype support for emacs lisp bytecode, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 032b3d8eef 107/323: Add melpa badge, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt d1b0f7c2ba 118/323: Fix compilation warnings, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 0ed6a01cd1 119/323: Fix initial run of emacs-lisp disassembler, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 77842a5f78 126/323: Add elisp support to docs, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt c00d09a850 122/323: Use hashtables instead of lists as sets for labels used, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt c009c2df44 130/323: Trim left side of strings to activate 'starting with period' opt, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 9e38f2238b 135/323: Add support for functions as arguments to :compile-cmd, ELPA Syncer, 2023/03/09
- [elpa] externals/beardbolt 1cc069a121 132/323: Quote filenames before passing them as shell arguments, ELPA Syncer, 2023/03/09