[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/vlf b8cc344 091/310: Add more detailed usage details.
From: |
Stefan Monnier |
Subject: |
[elpa] externals/vlf b8cc344 091/310: Add more detailed usage details. |
Date: |
Sat, 28 Nov 2020 00:32:53 -0500 (EST) |
branch: externals/vlf
commit b8cc34422eb9922da0e98e5fda116c42abb3c16a
Author: Andrey Kotlarski <m00naticus@gmail.com>
Commit: Andrey Kotlarski <m00naticus@gmail.com>
Add more detailed usage details.
---
README.org | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 65 insertions(+), 1 deletion(-)
diff --git a/README.org b/README.org
index 03b57a5..2905b55 100644
--- a/README.org
+++ b/README.org
@@ -18,4 +18,68 @@ following improvements:
- newly added content is acknowledged if file has changed size
meanwhile
- automatic scrolling of batches
-- vlfi is added as an option when opening large files
+- VLFI is added as an option when opening large files and given dired
+ key-binding
+
+GNU Emacs 23 and 24 are supported.
+
+* Overview and tips
+
+M-x vlfi PATH-TO-FILE
+
+Emacs' Unicode support is leveraged so you'll not see bare bytes but
+characters decoded as if the file is normally opened. Same holds for
+editing, search and indexing.
+
+Regular Emacs integers are used, so if you have really huge file and
+Emacs doesn't have bignum support, VLFI will choke.
+
+*vlfi-batch-size* bounds the memory used for all operations.
+
+VLFI is derived from special mode and keeps all its properties. For
+example you can directly press digits to enter prefix arguments.
+
+* Detail usage
+
+** Controlling batch size
+
+*+* and *-* control current batch size by factors of 2.
+
+You can also set by hand local variable *vlfi-batch-size* and then
+refresh with *g*.
+
+** Moving around
+
+*M-PgUp* and *M-PgDn* move chunk by chunk. With positive prefix
+argument they move prefix number of batches. With negative - append
+prefix number of batches.
+
+*[* and *]* take you to the beginning and end of file respectively.
+
+*j* jumps to given chunk (to see where you are in file and how many chunks
+there are using the current batch size, look at the bracketed part of
+the buffer name, batch size is also there - at the end).
+
+** Searching whole file
+
+*s* and *r* search forward and backward respectively over the whole
+file. This is done by chunk by chunk so if you have really huge
+file - you'd better set somewhat bigger batch size beforehand.
+
+*l* jumps to given line in file. This is done by searching from the
+beginning, so again the bigger current batch size, the quicker.
+
+** Editting
+
+*e* enters VLFI in editing mode. If editing doesn't change size of
+the chunk, only this chunk is saved. Otherwise the remaining part of
+the file is adjusted chunk by chunk, so again you'd better have bigger
+current batch size. If chunk has been expanded the memory used is
+(batch size + difference to the original chunk size) x 2.
+
+** Occur over whole file
+
+*o* builds index for given regular expression just like occur-mode.
+It does this chunk by chunk over the whole file. Note that if even if
+you prematurely stop it with *C-g*, it will still show index of what's
+found so far.
- [elpa] externals/vlf facdb9f 249/310: Fix binary tune base case and add approximation after access to, (continued)
- [elpa] externals/vlf facdb9f 249/310: Fix binary tune base case and add approximation after access to, Stefan Monnier, 2020/11/28
- [elpa] externals/vlf d67825c 244/310: Move back to using average speed when measuring and tuning. Be more, Stefan Monnier, 2020/11/28
- [elpa] externals/vlf e3be8d5 079/310: Don't adjust chunk with more that 3 bytes and inhibit spurious update, Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 1589cf9 081/310: Make custom revert function local only for vlfi buffers., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf b34bd2e 082/310: Don't use temporary buffer when adjusting expanded file content., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 681d3d9 084/310: Add vlfi-occur-mode., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 641ff4b 085/310: First feature complete version of vlfi-occur., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 1dcd122 086/310: Use overlays for number indicators., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf f14ef6c 087/310: Usability improvements to vlfi-occur., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 54927af 088/310: Update README and bump version., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf b8cc344 091/310: Add more detailed usage details.,
Stefan Monnier <=
- [elpa] externals/vlf eaf85e5 093/310: Add key-binding to vlfi-mode-map in vlfi-edit-mode-map., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf e4d886a 092/310: Add check if VLFI buffer has been modified before occur jumping to new, Stefan Monnier, 2020/11/28
- [elpa] externals/vlf a63ea7a 095/310: Grammar fixes., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 57eb4c2 099/310: Initial attempt at optimizing chunk access., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf d2bd47c 100/310: More attempts to optimize decoding., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 7bfe665 102/310: More secure chunk decode adjustment and minor fixes., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf bbda9ab 105/310: Merge branch 'master' into chunk-opt2, Stefan Monnier, 2020/11/28
- [elpa] externals/vlf 1ac1eec 106/310: Turn vlfi-get-file-size to function., Stefan Monnier, 2020/11/28
- [elpa] externals/vlf de1948e 108/310: Merge branch 'master' into chunk-opt2, Stefan Monnier, 2020/11/28
- [elpa] externals/vlf c827c3e 110/310: Prevent standard save procedure invocation in case user postpones, Stefan Monnier, 2020/11/28