[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/flx c41f9f5087 065/182: reorder README sections
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/flx c41f9f5087 065/182: reorder README sections |
Date: |
Tue, 13 Dec 2022 03:59:29 -0500 (EST) |
branch: elpa/flx
commit c41f9f50870b19505c2bf74a82f0ecf1546db921
Author: Le Wang <le.wang@agworld.com.au>
Commit: Le Wang <le.wang@agworld.com.au>
reorder README sections
---
README.md | 118 +++++++++++++++++++++++++++++++-------------------------------
1 file changed, 59 insertions(+), 59 deletions(-)
diff --git a/README.md b/README.md
index a67330673f..95bce2f951 100644
--- a/README.md
+++ b/README.md
@@ -9,65 +9,6 @@ expect to encounter bugs.
[Screencast showing rationale and ido workflow][]
-## Memory Usage
-
-The `flx` algorithm willingly sacrifices memory usage for speed.
-
-For 10k file names, about 10 MB of memory will be used to speed up future
-matching. This memory is never released to keep the match speed fast.
-
-So far with modern computers, this feels like a reasonable design decision.
-
-It may change in future.
-
-## GC Optimization
-
-Emacs's garbage collector is fairly primitive stop the world type. GC time can
-contribute significantly to the run-time of computation that allocates and
-frees a lot of memory.
-
-Consider the following example:
-
-```lisp
-(defun uuid ()
- (format "%08x-%08x-%08x-%08x"
- (random (expt 16 4))
- (random (expt 16 4))
- (random (expt 16 4))
- (random (expt 16 4))))
-
-(benchmark-run 1
- (let ((cache (flx-make-filename-cache)))
- (dolist (i (number-sequence 0 10000))
- (flx-process-cache (uuid) cache))))
- ;;; ⇒ (0.899678 9 0.33650300000000044)
-```
-
-This means that roughly 30% of time is spent just doing garbage-collection.
-
-`flx` can benefit significantly from garbage collection tuning.
-
-By default Emacs will initiate GC every 0.76 MB allocated (`gc-cons-threshold`
-== 800000). If we increase this to 20 MB (`gc-cons-threshold` == 20000000)
-we get:
-
-````lisp
-(benchmark-run 1
- (setq gc-cons-threshold 20000000)
- (let ((cache (flx-make-filename-cache)))
- (dolist (i (number-sequence 0 10000))
- (flx-process-cache (uuid) cache))))
- ;;; ⇒ (0.62035 1 0.05461100000000041)
-```
-
-So if you have a modern machine, I encourage you to add the following:
-
-```lisp
-(setq gc-cons-threshold 20000000)
-```
-
-to your init file.
-
## Installation
### Manual
@@ -134,6 +75,65 @@ still working through how to integrate it into helm.
The Helm demo shows the score of the top 20 matches.
+## Memory Usage
+
+The `flx` algorithm willingly sacrifices memory usage for speed.
+
+For 10k file names, about 10 MB of memory will be used to speed up future
+matching. This memory is never released to keep the match speed fast.
+
+So far with modern computers, this feels like a reasonable design decision.
+
+It may change in future.
+
+## GC Optimization
+
+Emacs's garbage collector is fairly primitive stop the world type. GC time can
+contribute significantly to the run-time of computation that allocates and
+frees a lot of memory.
+
+Consider the following example:
+
+```lisp
+(defun uuid ()
+ (format "%08x-%08x-%08x-%08x"
+ (random (expt 16 4))
+ (random (expt 16 4))
+ (random (expt 16 4))
+ (random (expt 16 4))))
+
+(benchmark-run 1
+ (let ((cache (flx-make-filename-cache)))
+ (dolist (i (number-sequence 0 10000))
+ (flx-process-cache (uuid) cache))))
+ ;;; ⇒ (0.899678 9 0.33650300000000044)
+```
+
+This means that roughly 30% of time is spent just doing garbage-collection.
+
+`flx` can benefit significantly from garbage collection tuning.
+
+By default Emacs will initiate GC every 0.76 MB allocated (`gc-cons-threshold`
+== 800000). If we increase this to 20 MB (`gc-cons-threshold` == 20000000)
+we get:
+
+````lisp
+(benchmark-run 1
+ (setq gc-cons-threshold 20000000)
+ (let ((cache (flx-make-filename-cache)))
+ (dolist (i (number-sequence 0 10000))
+ (flx-process-cache (uuid) cache))))
+ ;;; ⇒ (0.62035 1 0.05461100000000041)
+```
+
+So if you have a modern machine, I encourage you to add the following:
+
+```lisp
+(setq gc-cons-threshold 20000000)
+```
+
+to your init file.
+
[Screencast showing rationale and ido workflow]:
http://www.youtube.com/watch?v=_swuJ1RuMgk
[Helm]: https://github.com/emacs-helm/helm
- [nongnu] elpa/flx 222f60d28e 055/182: Merge pull request #18 from jschaf/master, (continued)
- [nongnu] elpa/flx 222f60d28e 055/182: Merge pull request #18 from jschaf/master, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 1d86d3bc09 052/182: cache clearing advice should be "before", ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx a0de931381 048/182: bump version, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 3b650d13f7 057/182: Merge pull request #23 from bbatsov/doc-improvements, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx f3ccfc9168 049/182: make warning less dramatic, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx acf230e2c9 102/182: Lower default flx-ido-threshold -> 500., ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx a1ac8f97ec 034/182: fix `ido-merge-work-directories`, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx f068b2bc1f 056/182: Improve the formatting of the README and extend it a bit, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 1df93b286a 060/182: comment clarification, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx a15638e403 064/182: Merge pull request #26 from bbatsov/master, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx c41f9f5087 065/182: reorder README sections,
ELPA Syncer <=
- [nongnu] elpa/flx d77b703c37 069/182: Merge pull request #28 from bbatsov/marmalade, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 0c41fc616d 072/182: update package install instrucations, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx ce2d375f82 073/182: Makefile: introduce all, clean targets, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx e24352a502 074/182: add usage information, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 6800cc34a9 076/182: flx-ido: fix comment in advice for ido-set-matches-1, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 4cd6d9c9e4 078/182: flx: require cl-lib; avoid ugly eval-when-compile, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 569beec178 080/182: Merge pull request #39 from artagnon/minor-cleanups, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 2903e5d2a7 084/182: Merge pull request #42 from bbatsov/byte-compile-warning, ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx 9440288782 086/182: Refactor to make prefix match clear., ELPA Syncer, 2022/12/13
- [nongnu] elpa/flx a1fef07104 087/182: Fix C-k to kill buffer at head., ELPA Syncer, 2022/12/13