* bug#1349: Calc interactive tutorial typo & suggestion
@ 2008-11-15 6:26 Ben Wong
2008-11-15 16:18 ` Jay Belanger
0 siblings, 1 reply; 2+ messages in thread
From: Ben Wong @ 2008-11-15 6:26 UTC (permalink / raw
To: bug-gnu-emacs
I have two tiny bugs for you, both having to do with returning to
Calc's interactive tutorial when switching buffers.
The interactive tutorial for calc says to use `C-x * i' to switch back
to the tutorial from the calculator. However, that key sequence
brings up the main calc info page, which would leave most people lost
and frustrated. I believe the correct sequence is `C-x * o'.
Specifically, the info file "calc-1", around line 1024, states:
"The easiest way to read this tutorial on-line is to have two windows
on your Emacs screen, one with Calc and one with the Info system. (If
you have a printed copy of the manual you can use that instead.) Press
`C-x * c' to turn Calc on or to switch into the Calc window, and press
`C-x * i' to start the Info system or to switch into its window. Or,
you may prefer to use the tutorial in printed form."
I believe that paragraph should read:
"The easiest way to read this tutorial on-line is to have two windows
on your Emacs screen, one with Calc and one with the Info system. (If
you have a printed copy of the manual you can use that instead.) Press
`C-x * i' to start the Info system. Press `C-x * c' to turn Calc on or
to switch into the Calc window, and press `C-x * o' to switch back to the
Info window. Or, you may prefer to use the tutorial in printed form."
I also have a second small suggestion for the tutorial. There should be
a message at the end of the answer to the first exercise, at least,
stating:
"If you are using the Emacs Info system, you may press 'l' to
return to the last page you were viewing."
Currently, the tutorial mentions the 'l' key only in the question
section, which goes away when looking at the answer in Info.
In GNU Emacs 22.1.1 (mipsel--netbsd)
of 2008-05-25 on lily.ziaspace.com
configured using `configure '--localstatedir=/var' '--without-gif'
'--without-jpeg' '--without-png' '--without-tiff' '--without-x'
'--without-xpm' '--prefix=/usr/pkg' '--host=mipsel--netbsd'
'--infodir=/usr/pkg/info' '--mandir=/usr/pkg/man'
'host_alias=mipsel--netbsd' 'CC=cc' 'CFLAGS=-O2 -I/usr/include'
'LDFLAGS=-L/usr/lib -Wl,-R/usr/lib -Wl,-R/usr/pkg/lib' 'LIBS='
'CPPFLAGS=-I/usr/include''
Important settings:
value of $LC_ALL: nil
value of $LC_COLLATE: nil
value of $LC_CTYPE: nil
value of $LC_MESSAGES: nil
value of $LC_MONETARY: nil
value of $LC_NUMERIC: nil
value of $LC_TIME: nil
value of $LANG: nil
locale-coding-system: nil
default-enable-multibyte-characters: t
Major mode: Info
Minor modes in effect:
menu-bar-mode: t
file-name-shadow-mode: t
global-font-lock-mode: t
font-lock-mode: t
unify-8859-on-encoding-mode: t
utf-translate-cjk-mode: t
auto-compression-mode: t
line-number-mode: t
Recent input:
h t SPC SPC SPC 1 SPC C-x * c C-x * i C-z SPC SPC TAB
TAB l SPC C-x * x ESC x r e p o r t - e m a c s - b
u g RET
Recent messages:
Loading easymenu...done
Loading info...done
Welcome to the GNU Emacs Calculator! Press `?' or `h' for help, `q' to quit
Welcome to the Calc Tutorial!
C-x * (Type ? for a list of Calc options)
Welcome to the GNU Emacs Calculator! Press `?' or `h' for help, `q' to quit
C-x * (Type ? for a list of Calc options) [2 times]
Loading emacsbug...
Loading regexp-opt...done
Loading emacsbug...done
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#1349: Calc interactive tutorial typo & suggestion
2008-11-15 6:26 bug#1349: Calc interactive tutorial typo & suggestion Ben Wong
@ 2008-11-15 16:18 ` Jay Belanger
0 siblings, 0 replies; 2+ messages in thread
From: Jay Belanger @ 2008-11-15 16:18 UTC (permalink / raw
To: Ben Wong; +Cc: 1349
"Ben Wong" <ben@wongs.net> writes:
> The interactive tutorial for calc says to use `C-x * i' to switch back
> to the tutorial from the calculator. However, that key sequence
> brings up the main calc info page, which would leave most people lost
> and frustrated. I believe the correct sequence is `C-x * o'.
I see. Both `C-x * c, C-x * i' and `C-x * i, C-x * c, C-x * o'
seem to leave Emacs in the same state, neither of which is looking at
the tutorial. The paragraph you mentioned talks about reading the
tutorial online, so it should probably be changed to `C-x * t', which
will set up the desired Emacs setup by itself, and a discussion of how
to switch between the info and Calc buffers. In the future, perhaps
Calc commands that will manipulate the info buffer from within the Calc
buffer might be useful (for example, `i SPC' in the Calc buffer will
scroll the info buffer).
> I also have a second small suggestion for the tutorial. There should be
> a message at the end of the answer to the first exercise, at least,
> stating:
>
> "If you are using the Emacs Info system, you may press 'l' to
> return to the last page you were viewing."
That's a good idea; I'll add a line like that to the info output.
Jay
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2008-11-15 16:18 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-11-15 6:26 bug#1349: Calc interactive tutorial typo & suggestion Ben Wong
2008-11-15 16:18 ` Jay Belanger
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.