summaryrefslogtreecommitdiff
path: root/doc/misc/eshell.texi
Commit message (Collapse)AuthorAgeFilesLines
...
* Improve wording of Eshell variable interpolation code/documentationJim Porter2022-03-081-12/+31
| | | | | | | | | | | | | | | | * lisp/eshell/esh-arg.el (eshell-unescape-inner-double-quote): Rename from 'eshell-parse-inner-double-quote'. * lisp/eshell/esh-cmd.el (eshell-with-temp-command): Improve docstring. * lisp/eshell/esh-var.el (eshell-parse-variable-ref): Use 'eshell-unescape-inner-double-quote' and improve robustness of quoted variable name matching. (eshell-parse-indices): Use 'eshell-unescape-inner-double-quote'. * doc/misc/eshell.texi (Dollars Expansion): Improve wording of subscript notation.
* Allow splitting strings in Eshell expansions with "plain" stringsJim Porter2022-03-031-3/+3
| | | | | | | | | | | | | | Since '$var[hello 0]' doesn't make sense when 'var' is a string, the previous restriction was unnecessary. * lisp/eshell/esh-var.el (Commentary): Update documentation. (eshell-apply-indices): Allow "plain" strings to split strings. * test/lisp/eshell/esh-var-test.el (esh-var-test/interp-var-string-split-indices) (esh-var-test/quoted-interp-var-string-split-indices): Update tests. * doc/misc/eshell.texi (Dollars expansion): Update documentation.
* Fix parsing of indices in Eshell expansionsJim Porter2022-03-031-33/+29
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Previously, more-complex index expansions, like '$var[":" 0]' or '$var[$(expr) 0]' failed to parse correctly. * lisp/eshell/esh-var.el (Commentary): Clarify indexing and length expansions. (eshell-parse-indices): Expand docstring and support parsing inside double-quotes. (eshell-eval-indices): New function. (eshell-parse-variable): Use it. * test/lisp/eshell/esh-var-tests.el (eshell-test-value): New defvar. (esh-var-test/interp-var-indices, (esh-var-test/interp-var-split-indices) (esh-var-test/interp-var-string-split-indices) (esh-var-test/interp-var-regexp-split-indices) (esh-var-test/interp-var-assoc, esh-var-test/interp-var-length-list) (esh-var-test/interp-var-length-string) (esh-var-test/interp-var-length-alist) (esh-var-test/quoted-interp-var-indices) (esh-var-test/quoted-interp-var-split-indices) (esh-var-test/quoted-interp-var-string-split-indices) (esh-var-test/quoted-interp-var-regexp-split-indices) (esh-var-test/quoted-interp-var-assoc) (esh-var-test/quoted-interp-var-length-list) (esh-var-test/quoted-interp-var-length-string) (esh-var-test/quoted-interp-var-length-alist): New tests. * doc/misc/eshell.texi (Dollars Expansion): Expand and reword documentation for indexing and length expansions.
* Merge from origin/emacs-28Stefan Kangas2022-03-021-21/+33
|\ | | | | | | | | | | 9dadcbe429 ; * doc/misc/eshell.texi (Dollars Expansion): Fix markup. 2c3d1b6bf4 Improve/correct documentation about Eshell variable expansion 9e257aecc9 Partially revert b03f74e0f2a578b1580e8b1c368665850ee7f808
| * ; * doc/misc/eshell.texi (Dollars Expansion): Fix markup.Eli Zaretskii2022-03-011-28/+29
| |
| * Improve/correct documentation about Eshell variable expansionJim Porter2022-03-011-0/+11
| | | | | | | | | | | | | | | | * lisp/eshell/esh-var.el: Correct documentation comment. (eshell-parse-variable-ref): Correct docstring. * doc/misc/eshell.texi (Dollars Expansion): Add documentation for $"var"/$'var' and $<command> syntaxes.
* | Add Eshell syntax to more easily bypass Eshell's own pipeliningSean Whitton2022-01-241-0/+42
| | | | | | | | | | | | | | | | * etc/NEWS: * doc/misc/eshell.texi (Input/Output): Document the new syntax. * lisp/eshell/em-extpipe.el: New module (Bug#46351). * test/lisp/eshell/em-extpipe-tests.el: New tests. * lisp/eshell/esh-module.el (eshell-modules-list): Add `eshell-extpipe'.
* | In Eshell, allow "-n" to suppress the trailing newline for "plain" echoJim Porter2022-01-201-3/+10
| | | | | | | | | | | | | | | | | | | | | | * doc/misc/eshell.texi (Built-in commands): Expand on the documentation of echo (bug#27361). * lisp/eshell/em-basic.el (eshell-echo): Respect OUTPUT-NEWLINE even when 'eshell-plain-echo-behavior' is non-nil. (eshell/echo): Add "-N" option and recommend its use over "-n" in Lisp-friendly echo. (eshell/printnl): Simplify; 'eshell-stringify' is equivalent to calling 'eshell-echo' here.
* | Follow POSIX/GNU argument conventions for 'eshell-eval-using-options'Jim Porter2022-01-121-0/+120
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/eshell/esh-opt.el (eshell--split-switch): New function. (eshell-set-option): Allow setting a supplied value instead of always consuming from 'eshell--args'. (eshell--process-option): Support consuming option values specified as a single token. (eshell--process-args): For short options, pass full switch token to 'eshell--process-option'. * test/lisp/eshell/esh-opt-tests.el (esh-opt-process-args-test): Fix test. (test-eshell-eval-using-options): Add tests for various types of options. * doc/misc/eshell.texi (Defining new built-in commands): New subsection, describe how to use 'eshell-eval-using-options'. * etc/NEWS: Announce the change.
* | Merge from origin/emacs-28Eli Zaretskii2022-01-011-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 836be7a112 ; * etc/refcards/ru-refcard.tex: Update Copyright year. 86cbc6ee4a * lisp/net/tramp-sh.el: Adapt copyright year ebe8772f65 ; Minor fixes related to copyright years 23c1ee6989 ; * test/manual/etags/ETAGS.good_N: Adjust to copyright ye... 8d3fc7ec89 * src/xfaces.c (face_for_font): Make 'hash' be uintptr_t. 19dcb237b5 ; Add 2022 to copyright years. # Conflicts: # etc/NEWS # etc/refcards/ru-refcard.tex # lib/cdefs.h # lisp/erc/erc-dcc.el # lisp/erc/erc-imenu.el # lisp/erc/erc-replace.el # lisp/image-dired.el # lisp/progmodes/xref.el # m4/alloca.m4 # m4/byteswap.m4 # m4/errno_h.m4 # m4/getopt.m4 # m4/gnulib-common.m4 # m4/inttypes.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/sys_socket_h.m4
| * ; Add 2022 to copyright years.Eli Zaretskii2022-01-011-1/+1
| |
* | * doc/misc/eshell.texi (Built-ins): Fix xref.Glenn Morris2021-12-071-1/+1
| |
* | ; * doc/misc/eshell.texi (Built-ins): Improve markup, fix typos.Eli Zaretskii2021-12-051-22/+39
| |
* | Update the Info documentation of Eshell's built-in commandsEarl Hyatt2021-12-051-25/+314
|/ | | | | | | * doc/misc/eshell.texi (Built-in commands): Add the remaining built-in Eshell commands to the list of built-ins. Expand some of the descriptions and mention user options affecting command behavior. Sort these commands in alphabetical order (bug#52289).
* Be explicit about missing sections in eshell manualStefan Kangas2021-09-191-0/+12
| | | | | | | * doc/misc/eshell.texi (Writing a module, Module testing) (Directory handling, Key rebinding, Smart scrolling) (Terminal emulation): Explicitly say that these sections remain to be written. (Bug#49306)
* Merge from origin/emacs-27Glenn Morris2021-04-161-2/+2
|\ | | | | | | | | eedad01b4b (origin/emacs-27) Fix typos in manuals 24d214652e Fix description of momentary message display
| * Fix typos in manualsEli Zaretskii2021-04-131-2/+2
| | | | | | | | | | * doc/misc/eshell.texi (Completion): * doc/lispref/objects.texi (Mutability): Fix typos. (Bug#47738)
| * Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* | Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright".
* | Merge from origin/emacs-27Glenn Morris2020-11-231-1/+1
|\| | | | | | | e66502fec1 ; * doc/misc/eshell.texi (Input/Output): Fix typo.
| * ; * doc/misc/eshell.texi (Input/Output): Fix typo.Michael Albinus2020-11-161-1/+1
| |
* | Add a note to eshell.texi that I, too, was a contributorJohn Wiegley2020-05-161-0/+3
|/
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Remove obsolete XEmacs references from manualsStefan Kangas2019-10-171-13/+0
| | | | | | | | | * doc/misc/erc.texi: * doc/misc/eshell.texi: * doc/misc/htmlfontify.texi: * doc/misc/remember.texi: * doc/misc/sieve.texi: * doc/misc/viper.texi: Remove obsolete XEmacs references.
* Say how to enable event designators in the eshell manualNoam Postavsky2019-08-081-4/+8
| | | | | | * doc/misc/eshell.texi (History): Mention that event designators need to be enabled. * etc/NEWS: Mark corresponding entry as documented in manual.
* * lisp/eshell/em-cmpl.el: Use completion-at-point i.s.o pcompleteStefan Monnier2019-03-191-9/+8
| | | | | | | | | | | | (eshell-cmpl-initialize): Refrain from binding to the `tab` key, which prevents the tab -> TAB remapping. Use completion-at-point and completion-help-at-point. (eshell-complete-commands-list): Use `fboundp` test instead of ugly gymnastics to try and hide the function call from the compiler. (eshell-pcomplete): Make it an alias of completion-at-point. * doc/misc/eshell.texi (Completion): Change wording to reflect different default behavior.
* Merge from origin/emacs-26Glenn Morris2019-02-201-6/+6
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ff9c962 ; * lisp/ldefs-boot.el: Update. b4a251c * ; ChangeLog.3 update d3104e3 * etc/AUTHORS: Update. a19bfb7 Remove .art from the default list of ImageMagick extensions 6985caa Fix input after setting x-wait-for-event-timeout nil 715388a Fix two warnings in eshell.texi d49cdd9 * lisp/minibuffer.el (completion-table-dynamic): Improve docs... 5dc4e51 * lisp/emacs-lisp/debug.el (debug-on-variable-change): Doc fi... 76ef805 Fix a typo in ELisp manual b5e66f4 Update citations of Internet RFCs 57ece2a Fix handling of manpage references divided by hyphenation 7ad0cd6 * doc/misc/eshell.texi: Fix some @ref's. 12b7940 Fix a typo in lispref/syntax.texi # Conflicts: # lisp/gnus/nnrss.el # lisp/mail/ietf-drums.el
| * Fix two warnings in eshell.texiMartin Rudalics2019-02-191-2/+2
| | | | | | | | | | * doc/misc/eshell.texi (Built-ins, Globbing): Fix `.' or `,' must follow @xref, not `f' warnings.
| * * doc/misc/eshell.texi: Fix some @ref's.Gregor Zattler2019-02-161-6/+6
| | | | | | | | Copyright-paperwork-exempt: yes
| * * doc/misc/eshell.texi (Built-ins): Fix alias descriptionGregor Zattler2019-02-151-2/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Dear eamcs developers, eshells current documentation first states that alias definitions are not saved to an alias file, later that they are saved to an alias file. I tested it and the latter is correct. Please find attached a patch which fixes this. Thanks for working on emacs which is really great, Gregor >From 1fe51cc769ab7a30d0896fb3d6105c0561243fa7 Mon Sep 17 00:00:00 2001 From: Gregor Zattler <telegraph@gmx.net> Date: Wed, 13 Feb 2019 20:19:38 +0100 Subject: * doc/misc/eshell.texi (Built-ins): Fix alias description. Bring description of built-in 'alias' in line with (info "(eshell) Aliases"), which describes the actual behaviur. (cherry picked from commit a48099ce7ff63cda416a870766fe61f5b8ac7c2c)
* | * doc/misc/eshell.texi (Built-ins): Fix alias descriptionGregor Zattler2019-02-131-2/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Dear eamcs developers, eshells current documentation first states that alias definitions are not saved to an alias file, later that they are saved to an alias file. I tested it and the latter is correct. Please find attached a patch which fixes this. Thanks for working on emacs which is really great, Gregor >From 1fe51cc769ab7a30d0896fb3d6105c0561243fa7 Mon Sep 17 00:00:00 2001 From: Gregor Zattler <telegraph@gmx.net> Date: Wed, 13 Feb 2019 20:19:38 +0100 Subject: * doc/misc/eshell.texi (Built-ins): Fix alias description. Bring description of built-in 'alias' in line with (info "(eshell) Aliases"), which describes the actual behaviur.
* | Merge from origin/emacs-26Paul Eggert2018-12-311-1/+1
|\| | | | | | | | | | | 2fcf2df Fix copyright years by hand 26bed8b Update copyright year to 2019 2814292 Fix value of default frame height. (Bug#33921)
| * Fix copyright years by handPaul Eggert2019-01-011-1/+1
| | | | | | | | | | These are dates that admin/update-copyright did not update, or updated incorrectly.
* | Merge from origin/emacs-26Glenn Morris2018-09-281-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | 1908173 (origin/emacs-26) Fix Bug#32828 7f5086d * lisp/net/shr.el (shr-copy-url): Fix docstring. d309994 Fix typos in documentation 25cdd65 ; Spellcheck two more documentation strings c8bda05 ; * lisp/simple.el (save-interprogram-paste-before-kill): Fix... dc7fdee * doc/emacs/kmacro.texi (Basic Keyboard Macro): Mention old b... 17766a1 Improve docs of functions/variables related to 'display-buffer' a363931 * lisp/mouse.el (tear-off-window): Fix non-mouse use (bug#32799) 8b8a4c0 Improve documentation of directory-local variables c9c9756 Don't use obsolete variable 'save-place' in documentation ca208e8 Use save-place-mode instead of save-place
| * Fix typos in documentationEli Zaretskii2018-09-271-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/misc/vhdl-mode.texi (Custom Indentation Functions): * doc/misc/url.texi (Customization): * doc/misc/tramp.texi (Overview): * doc/misc/srecode.texi (Developing Template Functions): * doc/misc/sieve.texi (Sieve Mode): * doc/misc/reftex.texi (Options - Creating Citations): * doc/misc/org.texi (Cooperation, Conflicts): * doc/misc/gnus.texi (Misc Group Stuff): * doc/misc/eshell.texi (Bugs and ideas): * doc/misc/calc.texi (Summary): * doc/man/emacsclient.1: * doc/lispref/os.texi (Security Considerations): * doc/lispref/control.texi (pcase Macro): * CONTRIBUTE: Fix typos. Reported by Mak Kolybabi <mak@kolybabi.com> (Bug#32853)
* | Merge from origin/emacs-26Glenn Morris2018-09-201-2/+3
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | d28d54c (origin/emacs-26) More accurate docs for 'text-char-description' b3baf99 Document synchronous behavior of eshell/make (Bug#32513) 98544ea Fix bs-show with wide characters (Bug#17822) 85af51b Improve Custom menu labels for 2 options 72a2a36 Improve wording of last change in dired-x.texi d4fa83b Fix GnuTLS test suite with GnuTLS versions 3.4.x b5bee6b Fix build with gnutls versions 3.0 to 3.2 (Bug#32446) 67eb80e ; * etc/enriched.txt (hanging-indents): Remove extra indent. c71cfb7 Fix the Bubbles game on TTY frames 3bbf21b Add choice to reshow certificate information (Bug#31877) 6f2c471 * src/alloc.c (Fbool_vector, Flist, Fvector): Doc tweak. 39eecb3 * src/alloc.c (vector): Fix grammatical error in doc string: ...
| * Document synchronous behavior of eshell/make (Bug#32513)Noam Postavsky2018-09-191-2/+3
| | | | | | | | | | | | * doc/misc/eshell.texi (Built-ins): * lisp/eshell/em-unix.el (eshell/make): Mention that it falls back to the external 'make' command when called synchronously.
* | Merge from origin/emacs-26Glenn Morris2018-04-201-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5de608f (origin/emacs-26) Update the documentation of 'perform-replace' 06245b6 * etc/NEWS: Another fix for the last change (noted by Juri Li... 8f6293c Fix use of @key in Texinfo manuals f4c9894 Improve documentation of actual arglist ce0e253 ; * etc/NEWS: Improve last change as proposed by Phil Sainty b89ff0e Don't assume term-current-row cache is valid (Bug#31193) 326a296 ; * etc/NEWS: Mention 'display-buffer-in-major-side-window' c... 3bdc9a1 Fix flyspell-auto-correct-previous-word broken by recent change a539eb5 * test/src/lread-tests.el (lread-test-bug-31186): New test. 3fa472b Fix undefined behaviour while looking for lexical-binding fil... 4341aac Minor wording improvement in "Bookmarks" Conflicts: test/src/lread-tests.el
| * Fix use of @key in Texinfo manualsEli Zaretskii2018-04-191-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/misc/efaq-w32.texi (Location of init file): * doc/misc/org.texi (Editing source code, Export settings) (Closing items, Drawers, Structure editing): * doc/misc/gnus.texi (Spam and Ham Processors, Terminology): * doc/misc/calc.texi (Keypad Functions Menu, Keypad Binary Menu) (Keypad Vectors Menu, Keypad Main Menu, Basic Arithmetic) (Symbolic Mode): * doc/misc/sc.texi (Electric References): * doc/misc/info.texi (Help-^L): * doc/misc/reftex.texi (Reference Styles): * doc/misc/idlwave.texi (Troubleshooting, Examining Variables) (Lesson III---User Catalog, Using the Shell): * doc/misc/eshell.texi (Bugs and ideas): * doc/misc/ada-mode.texi (Automatic Casing): * doc/misc/ediff.texi (Selective Browsing): * doc/misc/vip.texi (Customizing Constants): * doc/misc/pcl-cvs.texi (Selected files): * doc/misc/efaq.texi (Replying to the sender of a message) (Basic keys, No Meta key, Matching parentheses) (Origin of the term Emacs, Installing Texinfo documentation) (Learning how to do something, Emacs manual, Extended commands): * doc/misc/viper.texi (Rudimentary Changes): * doc/misc/tramp.texi (Frequently Asked Questions): * doc/emacs/kmacro.texi (Basic Keyboard Macro): * doc/emacs/frames.texi (Frame Commands): * doc/emacs/msdos.texi (Windows Keyboard): * doc/emacs/search.texi (Query Replace): * doc/lispintro/emacs-lisp-intro.texi (Keybindings) (Note for Novices): * doc/lispref/tips.texi (Key Binding Conventions): Fix use of @key. For the details, see http://lists.gnu.org/archive/html/emacs-devel/2018-04/msg00390.html.
* | Make eshell/kill handle -<signal> and -<SIGNALNAME> (Bug#29156)Eric Skoglund2018-03-251-1/+1
|/ | | | | | | | | * lisp/eshell/esh-proc.el (eshell/kill): Handle the argument parsing and numeric conversion in function in order to parse -signal and -SIGNALNAME correctly. * doc/misc/eshell.texi (kill): Update docs to reflect new function behaviour. * etc/NEWS: Mention new eshell/kill behaviour.
* Mark keys consistently in manualsMichael Albinus2018-02-261-9/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/killing.texi: * doc/lispintro/emacs-lisp-intro.texi: * doc/misc/calc.texi: * doc/misc/cc-mode.texi: * doc/misc/dired-x.texi: * doc/misc/ede.texi: * doc/misc/edt.texi: * doc/misc/efaq.texi: * doc/misc/erc.texi: * doc/misc/eshell.texi: * doc/misc/gnus-faq.texi: * doc/misc/gnus-news.texi: * doc/misc/idlwave.texi: * doc/misc/ido.texi: * doc/misc/mairix-el.texi: * doc/misc/message.texi: * doc/misc/mh-e.texi: * doc/misc/newsticker.texi: * doc/misc/org.texi: * doc/misc/pcl-cvs.texi: * doc/misc/ses.texi: * doc/misc/sieve.texi: * doc/misc/smtpmail.texi: * doc/misc/speedbar.texi: * doc/misc/srecode.texi: * doc/misc/vhdl-mode.texi: * doc/misc/vip.texi: * doc/misc/viper.texi: Mark keys consistently.
* ; Fix doc typos related to indefinite articlesGlenn Morris2018-02-161-1/+1
|
* Fix copyright years by handPaul Eggert2018-01-011-1/+1
| | | | | These are dates that admin/update-copyright did not update, or updated incorrectly.
* eshell.texi improvementsMichael Albinus2017-10-011-2/+6
| | | | | | * doc/misc/eshell.texi (Built-ins): eshell/sudo is a compiled Lisp function in `em-tramp.el'. Mention also $*, $1, $2, ... (Aliases): Add $*, $1, $2, ... to the variable index.
* Revert "Don't lose arguments to eshell aliases (Bug#27954)"Noam Postavsky2017-09-301-1/+8
| | | | | | | | | It broke the established argument handling methods provided by eshell aliases (Bug#28568). * doc/misc/eshell.texi (Aliases): Fix example, call out use of arguments in aliases. * lisp/eshell/em-alias.el (eshell-maybe-replace-by-alias): Ignore ARGS.
* Remove an opinionated section on "What Eshell is not"John Wiegley2017-09-051-18/+0
| | | | | | I don't find this information to accurately reflect possible use cases for Eshell; plus, it doesn't offer much in the way of information, just opinion.
* Fix a typo in Eshell manualEli Zaretskii2017-01-271-1/+1
| | | | | * doc/misc/eshell.texi (History): Fix a typo. Reported by Mak Kolybabi <mak@kolybabi.com>.
* Fix copyright years by handPaul Eggert2017-01-011-1/+1
| | | | | These are dates that admin/update-copyright did not update, or updated incorrectly.
* Fix Bug#23032Michael Albinus2016-03-191-1/+3
| | | | | * doc/misc/eshell.texi (Arguments): Mention the pipe symbol in remote file names. (Bug#23032)
* Document new features if EshellEli Zaretskii2016-01-101-0/+15
| | | | | | | | * doc/misc/eshell.texi (Input/Output): Document the new '#<bufname>' syntax. (Input/Output): Document 'eshell-destroy-buffer-when-process-dies'. Disable "Key Index" generation, as there are no @kindex entries in this manual.
generated by cgit v1.2.3 (git 2.39.1) at 2025-04-09 07:35:15 +0000