* Re: Low-stress useful project
@ 2006-08-12 7:28 Mikiya Matsuzaka
2006-08-12 22:01 ` T. V. Raman
0 siblings, 1 reply; 7+ messages in thread
From: Mikiya Matsuzaka @ 2006-08-12 7:28 UTC (permalink / raw)
Eshell.info has 'Function and Variable Index' section, but
almost empty. This means we must read the source code to
customize Eshell.
I invoked grep command to list all interactive commands of
eshell, and edited its output. The list follows. I hope
somebody does the list of variables.
------------------------------------------------------------------------
(defun eshell (&optional arg)
"Create an interactive Eshell buffer.
The buffer used for Eshell sessions is determined by the value of
`eshell-buffer-name'. If there is already an Eshell session active in
that buffer, Emacs will simply switch to it. Otherwise, a new session
will begin. A numeric prefix arg (as in `C-u 42 M-x eshell RET')
switches to the session with that number, creating it if necessary. A
nonnumeric prefix arg means to create a new session. Returns the
buffer selected (or created)."
(interactive "P")
(defun eshell-command (&optional command arg)
"Execute the Eshell command string COMMAND.
With prefix ARG, insert output into the current buffer at point."
(interactive)
(defun eshell-report-bug (topic)
"Report a bug in Eshell.
Prompts for the TOPIC. Leaves you in a mail buffer.
Please include any configuration details that might be involved."
(interactive "sBug Subject: ")
(defun eshell-insert-envvar (envvar-name)
"Insert ENVVAR-NAME into the current buffer at point."
(interactive
(list (read-envvar-name "Name of environment variable: " t)))
(defun eshell-test-goto-func ()
"Jump to the function that defines a particular test."
(interactive)
(defun eshell-run-one-test (&optional arg)
"Jump to the function that defines a particular test."
(interactive "P")
(defun eshell-test (&optional arg)
"Test Eshell to verify that it works as expected."
(interactive "P")
(defun eshell-insert-process (process)
"Insert the name of PROCESS into the current buffer at point."
(interactive
(list (get-process
(eshell-read-process-name "Name of process: "))))
(defun eshell-interrupt-process ()
"Interrupt a process."
(interactive)
(defun eshell-kill-process ()
"Kill a process."
(interactive)
(defun eshell-quit-process ()
"Send quit signal to process."
(interactive)
(defun eshell-send-eof-to-process ()
"Send EOF to process."
(interactive)
(defun eshell-toggle-direct-send ()
(interactive)
(defun eshell-self-insert-command (N)
(interactive "i")
(defun eshell-find-tag (&optional tagname next-p regexp-p)
"A special version of `find-tag' that ignores read-onlyness."
(interactive)
(defun eshell-forward-argument (&optional arg)
"Move forward ARG arguments."
(interactive "p")
(eshell-move-argument (point-max) 'forward-char 'arg-end arg))
(defun eshell-backward-argument (&optional arg)
"Move backward ARG arguments."
(interactive "p")
(defun eshell-repeat-argument (&optional arg)
(interactive "p")
(defun eshell-bol ()
"Goes to the beginning of line, then skips past the prompt, if any."
(interactive)
(defun eshell-queue-input (&optional use-region)
"Queue the current input text for execution by Eshell.
Particularly, don't send the text to the current process, even if it's
waiting for input."
(interactive "P")
(defun eshell-send-input (&optional use-region queue-p no-newline)
"Send the input received to Eshell for parsing and processing.
After `eshell-last-output-end', sends all text from that marker to
point as input. Before that marker, calls `eshell-get-old-input' to
retrieve old input, copies it to the end of the buffer, and sends it.
If USE-REGION is non-nil, the current region (between point and mark)
will be used as input.
If QUEUE-P is non-nil, input will be queued until the next prompt,
rather than sent to the currently active process. If no process, the
input is processed immediately.
If NO-NEWLINE is non-nil, the input is sent without an implied final
newline."
(interactive "P")
(defun eshell-kill-output ()
"Kill all output from interpreter since last input.
Does not delete the prompt."
(interactive)
(defun eshell-show-output (&optional arg)
"Display start of this batch of interpreter output at top of window.
Sets mark to the value of point when this command is run.
With a prefix argument, narrows region to last command output."
(interactive "P")
(defun eshell-mark-output (&optional arg)
"Display start of this batch of interpreter output at top of window.
Sets mark to the value of point when this command is run.
With a prefix argument, narrows region to last command output."
(interactive "P")
(defun eshell-kill-input ()
"Kill all text from last stuff output by interpreter to point."
(interactive)
(defun eshell-show-maximum-output (&optional interactive)
"Put the end of the buffer at the bottom of the window.
When run interactively, widen the buffer first."
(interactive "p")
(defun eshell-copy-old-input ()
"Insert after prompt old input at point as new input to be edited."
(interactive)
(defun eshell-life-is-too-much ()
"Kill the current buffer (or bury it). Good-bye Eshell."
(interactive)
(defun eshell-truncate-buffer ()
"Truncate the buffer to `eshell-buffer-maximum-lines'.
This function could be on `eshell-output-filter-functions' or bound to
a key."
(interactive)
(defun eshell-send-invisible (str)
"Read a string without echoing.
Then send it to the process running in the current buffer."
(interactive "P") ; Defeat snooping via C-x ESC ESC
(defun eshell-insert-buffer-name (buffer-name)
"Insert BUFFER-NAME into the current buffer at point."
(interactive "BName of buffer: ")
(defun eshell-occur-mode-goto-occurrence ()
"Go to the occurrence the current line describes."
(interactive)
(defun eshell-occur-mode-mouse-goto (event)
"In Occur mode, go to the occurrence whose line you click on."
(interactive "e")
(defun eshell-diff-quit ()
"Restore the window configuration previous to diff'ing."
(interactive)
(defun eshell-smart-goto-end ()
"Like `end-of-buffer', but do not push a mark."
(interactive)
(defun eshell-source-file (file &optional args subcommand-p)
"Execute a series of Eshell commands in FILE, passing ARGS.
Comments begin with '#'."
(interactive "f")
(defun eshell-lock-local-map (&optional arg)
"Lock or unlock the current local keymap.
Within a prefix arg, set the local keymap to its normal value, and
lock it at that."
(interactive "P")
(defun eshell-delete-backward-char (n &optional killflag)
"Delete the last character, unless it's part of the output."
(interactive "P")
(defun eshell-delchar-or-maybe-eof (arg)
"Delete ARG characters forward or send an EOF to subprocess.
Sends an EOF only if point is at the end of the buffer and there is no
input."
(interactive "p")
(defun eshell-backward-matching-input (regexp arg)
"Search backward through buffer for match for REGEXP.
Matches are searched for on lines that match `eshell-prompt-regexp'.
With prefix argument N, search for Nth previous match.
If N is negative, find the next or Nth next match."
(interactive (eshell-regexp-arg "Backward input matching (regexp): "))
(defun eshell-forward-matching-input (regexp arg)
"Search forward through buffer for match for REGEXP.
Matches are searched for on lines that match `eshell-prompt-regexp'.
With prefix argument N, search for Nth following match.
If N is negative, find the previous or Nth previous match."
(interactive (eshell-regexp-arg "Forward input matching (regexp): "))
(defun eshell-next-prompt (n)
"Move to end of Nth next prompt in the buffer.
See `eshell-prompt-regexp'."
(interactive "p")
(defun eshell-previous-prompt (n)
"Move to end of Nth previous prompt in the buffer.
See `eshell-prompt-regexp'."
(interactive "p")
(defun eshell-display-predicate-help ()
(interactive)
(defun eshell-display-modifier-help ()
(interactive)
(defun eshell-list-history ()
"List in help buffer the buffer's input history."
(interactive)
(defun eshell-get-next-from-history ()
"After fetching a line from input history, this fetches the next.
In other words, this recalls the input line after the line you
recalled last. You can use this to repeat a sequence of input lines."
(interactive)
(defun eshell-previous-input (arg)
"Cycle backwards through input history."
(interactive "*p")
(defun eshell-next-input (arg)
"Cycle forwards through input history."
(interactive "*p")
(defun eshell-previous-matching-input (regexp arg)
"Search backwards through input history for match for REGEXP.
\(Previous history elements are earlier commands.)
With prefix argument N, search for Nth previous match.
If N is negative, find the next or Nth next match."
(interactive (eshell-regexp-arg "Previous input matching (regexp): "))
(defun eshell-next-matching-input (regexp arg)
"Search forwards through input history for match for REGEXP.
\(Later history elements are more recent commands.)
With prefix argument N, search for Nth following match.
If N is negative, find the previous or Nth previous match."
(interactive (eshell-regexp-arg "Next input matching (regexp): "))
(defun eshell-previous-matching-input-from-input (arg)
"Search backwards through input history for match for current input.
\(Previous history elements are earlier commands.)
With prefix argument N, search for Nth previous match.
If N is negative, search forwards for the -Nth following match."
(interactive "p")
(defun eshell-next-matching-input-from-input (arg)
"Search forwards through input history for match for current input.
\(Following history elements are more recent commands.)
With prefix argument N, search for Nth following match.
If N is negative, search backwards for the -Nth previous match."
(interactive "p")
(defun eshell-isearch-backward (&optional invert)
"Do incremental regexp search backward through past commands."
(interactive)
(defun eshell-isearch-repeat-backward (&optional invert)
"Do incremental regexp search backward through past commands."
(interactive)
(defun eshell-isearch-forward ()
"Do incremental regexp search backward through past commands."
(interactive)
(defun eshell-isearch-repeat-forward ()
"Do incremental regexp search backward through past commands."
(interactive)
(defun eshell-isearch-cancel ()
(interactive)
(defun eshell-isearch-abort ()
(interactive)
(defun eshell-isearch-delete-char ()
(interactive)
(defun eshell-isearch-return ()
(interactive)
(defun eshell-completion-help ()
(interactive)
------------------------------------------------------------------------.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Low-stress useful project
2006-08-12 7:28 Low-stress useful project Mikiya Matsuzaka
@ 2006-08-12 22:01 ` T. V. Raman
0 siblings, 0 replies; 7+ messages in thread
From: T. V. Raman @ 2006-08-12 22:01 UTC (permalink / raw)
Cc: emacs-devel
For the emacspeak project, I eventually ended up writing code
that extracts variable and function docs from the source
code. This is *not* a replacement for a hand-written manual, but
it is better than nothing.
If there is interest I can contribute this to the Emacs
distribution.
>>>>> "Mikiya" == Mikiya Matsuzaka <yoyu@tiara.ocn.ne.jp> writes:
Mikiya> Eshell.info has 'Function and Variable Index'
Mikiya> section, but almost empty. This means we must read
Mikiya> the source code to customize Eshell.
Mikiya>
Mikiya> I invoked grep command to list all interactive
Mikiya> commands of eshell, and edited its output. The list
Mikiya> follows. I hope somebody does the list of variables.
Mikiya>
Mikiya>
Mikiya> ------------------------------------------------------------------------
Mikiya>
Mikiya> (defun eshell (&optional arg) "Create an interactive
Mikiya> Eshell buffer. The buffer used for Eshell sessions
Mikiya> is determined by the value of `eshell-buffer-name'.
Mikiya> If there is already an Eshell session active in that
Mikiya> buffer, Emacs will simply switch to it. Otherwise, a
Mikiya> new session will begin. A numeric prefix arg (as in
Mikiya> `C-u 42 M-x eshell RET') switches to the session with
Mikiya> that number, creating it if necessary. A nonnumeric
Mikiya> prefix arg means to create a new session. Returns
Mikiya> the buffer selected (or created)." (interactive "P")
Mikiya>
Mikiya> (defun eshell-command (&optional command arg)
Mikiya> "Execute the Eshell command string COMMAND. With
Mikiya> prefix ARG, insert output into the current buffer at
Mikiya> point." (interactive)
Mikiya>
Mikiya> (defun eshell-report-bug (topic) "Report a bug in
Mikiya> Eshell. Prompts for the TOPIC. Leaves you in a mail
Mikiya> buffer. Please include any configuration details
Mikiya> that might be involved." (interactive "sBug Subject:
Mikiya> ")
Mikiya>
Mikiya> (defun eshell-insert-envvar (envvar-name) "Insert
Mikiya> ENVVAR-NAME into the current buffer at point."
Mikiya> (interactive (list (read-envvar-name "Name of
Mikiya> environment variable: " t)))
Mikiya>
Mikiya> (defun eshell-test-goto-func () "Jump to the function
Mikiya> that defines a particular test." (interactive)
Mikiya>
Mikiya> (defun eshell-run-one-test (&optional arg) "Jump to
Mikiya> the function that defines a particular test."
Mikiya> (interactive "P")
Mikiya>
Mikiya> (defun eshell-test (&optional arg) "Test Eshell to
Mikiya> verify that it works as expected." (interactive "P")
Mikiya>
Mikiya> (defun eshell-insert-process (process) "Insert the
Mikiya> name of PROCESS into the current buffer at point."
Mikiya> (interactive (list (get-process
Mikiya> (eshell-read-process-name "Name of process: "))))
Mikiya>
Mikiya> (defun eshell-interrupt-process () "Interrupt a
Mikiya> process." (interactive)
Mikiya>
Mikiya> (defun eshell-kill-process () "Kill a process."
Mikiya> (interactive)
Mikiya>
Mikiya> (defun eshell-quit-process () "Send quit signal to
Mikiya> process." (interactive)
Mikiya>
Mikiya> (defun eshell-send-eof-to-process () "Send EOF to
Mikiya> process." (interactive)
Mikiya>
Mikiya> (defun eshell-toggle-direct-send () (interactive)
Mikiya>
Mikiya> (defun eshell-self-insert-command (N) (interactive
Mikiya> "i")
Mikiya>
Mikiya> (defun eshell-find-tag (&optional tagname next-p
Mikiya> regexp-p) "A special version of `find-tag' that
Mikiya> ignores read-onlyness." (interactive)
Mikiya>
Mikiya> (defun eshell-forward-argument (&optional arg) "Move
Mikiya> forward ARG arguments." (interactive "p")
Mikiya> (eshell-move-argument (point-max) 'forward-char
Mikiya> 'arg-end arg))
Mikiya>
Mikiya> (defun eshell-backward-argument (&optional arg) "Move
Mikiya> backward ARG arguments." (interactive "p")
Mikiya>
Mikiya> (defun eshell-repeat-argument (&optional arg)
Mikiya> (interactive "p")
Mikiya>
Mikiya> (defun eshell-bol () "Goes to the beginning of line,
Mikiya> then skips past the prompt, if any." (interactive)
Mikiya>
Mikiya> (defun eshell-queue-input (&optional use-region)
Mikiya> "Queue the current input text for execution by
Mikiya> Eshell. Particularly, don't send the text to the
Mikiya> current process, even if it's waiting for input."
Mikiya> (interactive "P")
Mikiya>
Mikiya> (defun eshell-send-input (&optional use-region
Mikiya> queue-p no-newline) "Send the input received to
Mikiya> Eshell for parsing and processing. After
Mikiya> `eshell-last-output-end', sends all text from that
Mikiya> marker to point as input. Before that marker, calls
Mikiya> `eshell-get-old-input' to retrieve old input, copies
Mikiya> it to the end of the buffer, and sends it.
Mikiya>
Mikiya> If USE-REGION is non-nil, the current region (between
Mikiya> point and mark) will be used as input.
Mikiya>
Mikiya> If QUEUE-P is non-nil, input will be queued until the
Mikiya> next prompt, rather than sent to the currently active
Mikiya> process. If no process, the input is processed
Mikiya> immediately.
Mikiya>
Mikiya> If NO-NEWLINE is non-nil, the input is sent without
Mikiya> an implied final newline." (interactive "P")
Mikiya>
Mikiya> (defun eshell-kill-output () "Kill all output from
Mikiya> interpreter since last input. Does not delete the
Mikiya> prompt." (interactive)
Mikiya>
Mikiya> (defun eshell-show-output (&optional arg) "Display
Mikiya> start of this batch of interpreter output at top of
Mikiya> window. Sets mark to the value of point when this
Mikiya> command is run. With a prefix argument, narrows
Mikiya> region to last command output." (interactive "P")
Mikiya>
Mikiya> (defun eshell-mark-output (&optional arg) "Display
Mikiya> start of this batch of interpreter output at top of
Mikiya> window. Sets mark to the value of point when this
Mikiya> command is run. With a prefix argument, narrows
Mikiya> region to last command output." (interactive "P")
Mikiya>
Mikiya> (defun eshell-kill-input () "Kill all text from last
Mikiya> stuff output by interpreter to point." (interactive)
Mikiya>
Mikiya> (defun eshell-show-maximum-output (&optional
Mikiya> interactive) "Put the end of the buffer at the bottom
Mikiya> of the window. When run interactively, widen the
Mikiya> buffer first." (interactive "p")
Mikiya>
Mikiya> (defun eshell-copy-old-input () "Insert after prompt
Mikiya> old input at point as new input to be edited."
Mikiya> (interactive)
Mikiya>
Mikiya> (defun eshell-life-is-too-much () "Kill the current
Mikiya> buffer (or bury it). Good-bye Eshell."
Mikiya> (interactive)
Mikiya>
Mikiya> (defun eshell-truncate-buffer () "Truncate the buffer
Mikiya> to `eshell-buffer-maximum-lines'. This function
Mikiya> could be on `eshell-output-filter-functions' or bound
Mikiya> to a key." (interactive)
Mikiya>
Mikiya> (defun eshell-send-invisible (str) "Read a string
Mikiya> without echoing. Then send it to the process running
Mikiya> in the current buffer." (interactive "P") ; Defeat
Mikiya> snooping via C-x ESC ESC
Mikiya>
Mikiya> (defun eshell-insert-buffer-name (buffer-name)
Mikiya> "Insert BUFFER-NAME into the current buffer at
Mikiya> point." (interactive "BName of buffer: ")
Mikiya>
Mikiya> (defun eshell-occur-mode-goto-occurrence () "Go to
Mikiya> the occurrence the current line describes."
Mikiya> (interactive)
Mikiya>
Mikiya> (defun eshell-occur-mode-mouse-goto (event) "In Occur
Mikiya> mode, go to the occurrence whose line you click on."
Mikiya> (interactive "e")
Mikiya>
Mikiya> (defun eshell-diff-quit () "Restore the window
Mikiya> configuration previous to diff'ing." (interactive)
Mikiya>
Mikiya> (defun eshell-smart-goto-end () "Like
Mikiya> `end-of-buffer', but do not push a mark."
Mikiya> (interactive)
Mikiya>
Mikiya> (defun eshell-source-file (file &optional args
Mikiya> subcommand-p) "Execute a series of Eshell commands in
Mikiya> FILE, passing ARGS. Comments begin with '#'."
Mikiya> (interactive "f")
Mikiya>
Mikiya> (defun eshell-lock-local-map (&optional arg) "Lock or
Mikiya> unlock the current local keymap. Within a prefix
Mikiya> arg, set the local keymap to its normal value, and
Mikiya> lock it at that." (interactive "P")
Mikiya>
Mikiya> (defun eshell-delete-backward-char (n &optional
Mikiya> killflag) "Delete the last character, unless it's
Mikiya> part of the output." (interactive "P")
Mikiya>
Mikiya> (defun eshell-delchar-or-maybe-eof (arg) "Delete ARG
Mikiya> characters forward or send an EOF to subprocess.
Mikiya> Sends an EOF only if point is at the end of the
Mikiya> buffer and there is no input." (interactive "p")
Mikiya>
Mikiya> (defun eshell-backward-matching-input (regexp arg)
Mikiya> "Search backward through buffer for match for REGEXP.
Mikiya> Matches are searched for on lines that match
Mikiya> `eshell-prompt-regexp'. With prefix argument N,
Mikiya> search for Nth previous match. If N is negative,
Mikiya> find the next or Nth next match." (interactive
Mikiya> (eshell-regexp-arg "Backward input matching (regexp):
Mikiya> "))
Mikiya>
Mikiya> (defun eshell-forward-matching-input (regexp arg)
Mikiya> "Search forward through buffer for match for REGEXP.
Mikiya> Matches are searched for on lines that match
Mikiya> `eshell-prompt-regexp'. With prefix argument N,
Mikiya> search for Nth following match. If N is negative,
Mikiya> find the previous or Nth previous match."
Mikiya> (interactive (eshell-regexp-arg "Forward input
Mikiya> matching (regexp): "))
Mikiya>
Mikiya> (defun eshell-next-prompt (n) "Move to end of Nth
Mikiya> next prompt in the buffer. See
Mikiya> `eshell-prompt-regexp'." (interactive "p")
Mikiya>
Mikiya> (defun eshell-previous-prompt (n) "Move to end of Nth
Mikiya> previous prompt in the buffer. See
Mikiya> `eshell-prompt-regexp'." (interactive "p")
Mikiya>
Mikiya> (defun eshell-display-predicate-help () (interactive)
Mikiya>
Mikiya> (defun eshell-display-modifier-help () (interactive)
Mikiya>
Mikiya> (defun eshell-list-history () "List in help buffer
Mikiya> the buffer's input history." (interactive)
Mikiya>
Mikiya> (defun eshell-get-next-from-history () "After
Mikiya> fetching a line from input history, this fetches the
Mikiya> next. In other words, this recalls the input line
Mikiya> after the line you recalled last. You can use this
Mikiya> to repeat a sequence of input lines." (interactive)
Mikiya>
Mikiya> (defun eshell-previous-input (arg) "Cycle backwards
Mikiya> through input history." (interactive "*p")
Mikiya>
Mikiya> (defun eshell-next-input (arg) "Cycle forwards
Mikiya> through input history." (interactive "*p")
Mikiya>
Mikiya> (defun eshell-previous-matching-input (regexp arg)
Mikiya> "Search backwards through input history for match for
Mikiya> REGEXP. \(Previous history elements are earlier
Mikiya> commands.) With prefix argument N, search for Nth
Mikiya> previous match. If N is negative, find the next or
Mikiya> Nth next match." (interactive (eshell-regexp-arg
Mikiya> "Previous input matching (regexp): "))
Mikiya>
Mikiya> (defun eshell-next-matching-input (regexp arg)
Mikiya> "Search forwards through input history for match for
Mikiya> REGEXP. \(Later history elements are more recent
Mikiya> commands.) With prefix argument N, search for Nth
Mikiya> following match. If N is negative, find the previous
Mikiya> or Nth previous match." (interactive
Mikiya> (eshell-regexp-arg "Next input matching (regexp): "))
Mikiya>
Mikiya> (defun eshell-previous-matching-input-from-input
Mikiya> (arg) "Search backwards through input history for
Mikiya> match for current input. \(Previous history elements
Mikiya> are earlier commands.) With prefix argument N,
Mikiya> search for Nth previous match. If N is negative,
Mikiya> search forwards for the -Nth following match."
Mikiya> (interactive "p")
Mikiya>
Mikiya> (defun eshell-next-matching-input-from-input (arg)
Mikiya> "Search forwards through input history for match for
Mikiya> current input. \(Following history elements are more
Mikiya> recent commands.) With prefix argument N, search for
Mikiya> Nth following match. If N is negative, search
Mikiya> backwards for the -Nth previous match." (interactive
Mikiya> "p")
Mikiya>
Mikiya> (defun eshell-isearch-backward (&optional invert) "Do
Mikiya> incremental regexp search backward through past
Mikiya> commands." (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-repeat-backward (&optional
Mikiya> invert) "Do incremental regexp search backward
Mikiya> through past commands." (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-forward () "Do incremental
Mikiya> regexp search backward through past commands."
Mikiya> (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-repeat-forward () "Do
Mikiya> incremental regexp search backward through past
Mikiya> commands." (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-cancel () (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-abort () (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-delete-char () (interactive)
Mikiya>
Mikiya> (defun eshell-isearch-return () (interactive)
Mikiya>
Mikiya> (defun eshell-completion-help () (interactive)
Mikiya>
Mikiya> ------------------------------------------------------------------------.
Mikiya>
Mikiya>
Mikiya>
Mikiya> _______________________________________________
Mikiya> Emacs-devel mailing list Emacs-devel@gnu.org
Mikiya> http://lists.gnu.org/mailman/listinfo/emacs-devel
--
Best Regards,
--raman
Email: raman@users.sf.net
WWW: http://emacspeak.sf.net/raman/
AIM: emacspeak GTalk: tv.raman.tv@gmail.com
PGP: http://emacspeak.sf.net/raman/raman-almaden.asc
Google: tv+raman
IRC: irc://irc.freenode.net/#emacs
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Low-stress useful project
@ 2006-08-13 6:43 Mikiya Matsuzaka
0 siblings, 0 replies; 7+ messages in thread
From: Mikiya Matsuzaka @ 2006-08-13 6:43 UTC (permalink / raw)
Only if you missed it.
http://www.emacswiki.org/cgi-bin/wiki/EshellManual
^ permalink raw reply [flat|nested] 7+ messages in thread
* Low-stress useful project
@ 2006-08-10 20:18 Richard Stallman
2006-08-11 8:58 ` Alan Mackenzie
0 siblings, 1 reply; 7+ messages in thread
From: Richard Stallman @ 2006-08-10 20:18 UTC (permalink / raw)
The Eshell manual, eshell.texi, is less than half complete.
Would people who work on Eshell like to work on adding what
is missing? Maybe some parts can be copied from the Bash manual
and then adapted to fit Eshell.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Low-stress useful project
2006-08-10 20:18 Richard Stallman
@ 2006-08-11 8:58 ` Alan Mackenzie
2006-08-12 14:28 ` Richard Stallman
0 siblings, 1 reply; 7+ messages in thread
From: Alan Mackenzie @ 2006-08-11 8:58 UTC (permalink / raw)
Cc: emacs-devel
Hi, Richard!
On Thu, Aug 10, 2006 at 04:18:55PM -0400, Richard Stallman wrote:
> The Eshell manual, eshell.texi, is less than half complete. Would
> people who work on Eshell like to work on adding what is missing?
> Maybe some parts can be copied from the Bash manual and then adapted
> to fit Eshell.
With all due respect to everybody, and so on, but the Bash manual, the
last time I looked at it[*], didn't seem to be one of the better manuals
in the GNU system. It is short on examples, doesn't seem well
organized, and I found it maddeningly difficult to find out about basic
things (how do you write a `while' loop?) a few years back when I was
learning bash. The bash man page is much more coherent. I would
suggest NOT using the bash manual as a basis for eshell.texi.
[*] Version 2.5b, 15th July 2002
--
Alan Mackenzie (Munich, Germany)
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Low-stress useful project
2006-08-11 8:58 ` Alan Mackenzie
@ 2006-08-12 14:28 ` Richard Stallman
2006-08-12 17:23 ` Alan Mackenzie
0 siblings, 1 reply; 7+ messages in thread
From: Richard Stallman @ 2006-08-12 14:28 UTC (permalink / raw)
Cc: emacs-devel
With all due respect to everybody, and so on, but the Bash manual, the
last time I looked at it[*], didn't seem to be one of the better manuals
in the GNU system. It is short on examples, doesn't seem well
organized, and I found it maddeningly difficult to find out about basic
things (how do you write a `while' loop?) a few years back when I was
learning bash.
Would you like to work on improving it? It won't magically change by
itself.
The bash man page is much more coherent.
It is ok to copy the text from there, too; it will require rewriting into
Texinfo, though.
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: Low-stress useful project
2006-08-12 14:28 ` Richard Stallman
@ 2006-08-12 17:23 ` Alan Mackenzie
0 siblings, 0 replies; 7+ messages in thread
From: Alan Mackenzie @ 2006-08-12 17:23 UTC (permalink / raw)
Cc: emacs-devel
Hi, Richard!
On Sat, Aug 12, 2006 at 10:28:03AM -0400, Richard Stallman wrote:
> With all due respect to everybody, and so on, but the Bash manual,
> the last time I looked at it[*], didn't seem to be one of the
> better manuals in the GNU system. It is short on examples,
> doesn't seem well organized, and I found it maddeningly difficult
> to find out about basic things (how do you write a `while' loop?)
> a few years back when I was learning bash.
> Would you like to work on improving it? It won't magically change by
> itself.
A fair response (even if a little bit hackneyed). I'd like to work on
it, but that would mean doing less on other things (like Emacs and CC
Mode), so I'll just leave it.
I wasn't disparaging this manual out of personal frustration or hate or
anything like that - I merely wanted anybody contemplating the task (of
doing eshell.texi) not to take over the form of bashref.texi
uncritically.
> The bash man page is much more coherent.
> It is ok to copy the text from there, too; it will require rewriting
> into Texinfo, though.
--
Alan.
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2006-08-13 6:43 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-08-12 7:28 Low-stress useful project Mikiya Matsuzaka
2006-08-12 22:01 ` T. V. Raman
-- strict thread matches above, loose matches on Subject: below --
2006-08-13 6:43 Mikiya Matsuzaka
2006-08-10 20:18 Richard Stallman
2006-08-11 8:58 ` Alan Mackenzie
2006-08-12 14:28 ` Richard Stallman
2006-08-12 17:23 ` Alan Mackenzie
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.