* Re: Updating the tour for Xft
2009-07-30 17:50 ` Stefan Monnier
2009-07-31 17:54 ` Gilaras Drakeson
@ 2009-08-25 6:32 ` Phil Sung
2009-08-25 7:19 ` Glenn Morris
1 sibling, 1 reply; 7+ messages in thread
From: Phil Sung @ 2009-08-25 6:32 UTC (permalink / raw)
To: Stefan Monnier; +Cc: Emacs Devel
[-- Attachment #1: Type: text/plain, Size: 736 bytes --]
On Thu, Jul 30, 2009 at 10:50, Stefan Monnier<monnier@iro.umontreal.ca> wrote:
>> Now we have nice anti-aliased fonts with 23.1, can we update the tour
>> (http://www.gnu.org/software/emacs/tour/) so that it shows off this
>> nice new visual feature?
>
> I agree that the tour should be updated to reflect what the user would
> see in Emacs-23.
I've regenerated the tour screenshots with Emacs 23. I also updated
the text to reflect some of the Emacs 23 features and defaults (e.g.
with respect to transient mark and emacsclient).
Can someone please
(1) apply the attached patch (for tour/index.html) to the web site and
(2) replace the images in tour/images with those in
<http://web.psung.name/public/images.tar.gz> ?
Thanks,
Phil
[-- Attachment #2: tour.diff --]
[-- Type: text/x-patch, Size: 7310 bytes --]
--- tour/index.html 11 Jun 2008 21:33:00 -0000 1.14
+++ tour/index.html 25 Aug 2009 06:04:38 -0000
@@ -24,22 +24,29 @@
a sampling of the things you can do with Emacs:</p>
<p>Beyond just being able to edit plain text files, Emacs includes special
- features to help you write in many different programming and markup
- languages:</p>
+ features to help you write in many different human languages and
+ programming/markup languages:</p>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td align="center">
<table border="0" cellpadding="2" cellspacing="0">
<tr>
+ <td><a href="images/hello.png">
+ <img src="images/hello-small.png"
+ alt="'Hello' in various languages" /></a></td>
+ </tr>
+ <tr>
<td><a href="images/latex.png">
<img src="images/latex-small.png"
alt="Syntax highlighting in Latex mode" /></a></td>
+ </tr>
+ <tr>
<td><a href="images/code.png">
<img src="images/code-small.png"
alt="Syntax highlighting in C mode" /></a></td>
</tr>
<tr>
- <td align="center" colspan="2">
+ <td align="center">
<small>(Click on any of these pictures for a larger view.)</small></td></tr>
</table>
</td></tr>
@@ -128,7 +135,7 @@
<p>To run the tutorial, start Emacs and type <tt>C-h t</tt>, that
is, <tt>Ctrl-h</tt> followed by <tt>t</tt>.</p>
-<p>All the features described in this tour work in GNU Emacs 22. Some features
+<p>All the features described in this tour work in GNU Emacs 23. Some features
described weren't included in previous versions of Emacs but can be installed
separately.</p>
@@ -363,16 +370,6 @@
<tt>C-y</tt> (yank), inserting a file, and inserting a buffer all set the
region to surround the inserted text.</p>
-<p>Usually, the region is invisible. Emacs does not highlight it by default:
- this would be annoying when you merely wanted to move point without caring
- about the region. <tt>M-x transient-mark-mode</tt> makes Emacs highlight the
- region, but only when you appear to be actively using it. <tt>C-SPC</tt> and
- commands which set the region are said to <em>activate the mark</em> (that
- is, they activate highlighting of the region), but modifying the buffer in
- any way deactivates the mark. For more information
- see <a href="http://www.gnu.org/software/emacs/manual/html_node/emacs/Transient-Mark.html">
- <tt>(info "(emacs)Transient Mark")</tt></a>.</p>
-
<p><em>Narrowing</em> restricts the view (and editing) of a buffer to a certain
region. This is handy when you're only working with a small part of a buffer
(e.g. a chapter in a book). Then commands like incremental search,
@@ -479,13 +476,6 @@
cursor (so as to break any existing sequence of undos), and
press <tt>C-/</tt> until you find what you want.</p>
-<p>You can also restrict undo to the current region to avoid affecting
- subsequent actions elsewhere:</p>
-
-<table class="commandlist">
- <tr><td><tt>C-u C-/</tt></td><td>Undo within region</td></tr>
-</table>
-
<p>To learn more about undo,
see <a href="http://www.gnu.org/software/emacs/manual/html_node/emacs/Undo.html">
<tt>(info "(emacs)Undo")</tt></a>.</p>
@@ -791,18 +781,18 @@
<h3>Version control</h3>
<p>Emacs helps you manipulate and edit files stored in version control. Emacs
- supports CVS, Arch, RCS, Subversion and more, but it offers a uniform
- interface, called VC, regardless of the version control system you are
- using.</p>
+ supports CVS, Subversion, bzr, git, hg, and other systems, but it offers a
+ uniform interface, called VC, regardless of the version control system you
+ are using.</p>
<p>Emacs automatically detects when a file you're editing is under version
control, and displays something like this in the mode line: <tt>CVS-1.14</tt>
to indicate the version control system in use, and the current version.</p>
<p><tt>M-x vc-next-action</tt> or <tt>C-x v v</tt> commits the current file
- (prompting you for a log message) if you've modified it, or locks the file
- for you if you haven't acquired a lock. (The locking step is not necessary
- under CVS and some other version control systems.)</p>
+ (prompting you for a log message) if you've modified it. (Under version
+ control systems that require locking, this command also acquires a lock for
+ you.)</p>
<p>VC provides other commands for version control-related tasks:</p>
@@ -855,10 +845,10 @@
<h3>Emacs server</h3>
-<p>Some people like to keep only single instance of Emacs open and edit all
- their files in there. Doing so has its advantages:</p>
+<p>Some people like to keep only a single instance of Emacs open and edit all
+ their files in there. Doing this has a few advantages:</p>
<ul>
- <li>You can kill/yank text between buffers, but only in the same instance of
+ <li>You can kill/yank text between buffers in the same instance of
Emacs.</li>
<li>Emacs remembers argument histories (what commands you've used, what files
you've opened, terms you've searched for, etc.), but only within each
@@ -866,21 +856,22 @@
<li>If you have many customizations, starting new instances of Emacs is
slow.</li>
</ul>
-<p>Alas, when you type <tt>$ emacs</tt> in a shell to edit a file (or
+<p>Alas, when you type <tt>emacs</tt> in a shell to edit a file (or
when <tt>$EDITOR</tt> is invoked by an external program), a new instance of
Emacs is started. You can avoid this by using <tt>emacsclient</tt>, which
- connects to an existing instance of Emacs and tells it instead to open the
- file for you:</p>
+ instead opens a new frame connected to an existing instance of Emacs:</p>
<ol>
<li>In your existing instance of Emacs, type <tt>M-x server-start</tt>. Or
add <tt>(server-start)</tt> to your <tt>.emacs</tt> file to make it do that
automatically at startup.</li>
- <li>To edit a file, type <tt>$ emacsclient FILENAME</tt> at a prompt. The
- file appears in one of your existing Emacs frames. You can also
- change <tt>$EDITOR</tt> to <tt>emacsclient</tt> if you're using programs
- that invoke <tt>$EDITOR</tt> to get input from you.</li>
- <li>When you're done editing, type <tt>C-x #</tt>. Emacs will close the
- buffer and you can return to whatever you were doing in the shell.</li>
+ <li>To edit a file, type <tt>emacsclient -t FILENAME</tt> at a
+ prompt. You can also change your <tt>$EDITOR</tt>
+ to <tt>emacsclient -t</tt> if you're using programs that automatically
+ invoke <tt>$EDITOR</tt>. (<tt>emacsclient -t</tt> opens a new frame on
+ the terminal; alternatively, <tt>emacsclient -c</tt> opens a new X
+ frame.)</li>
+ <li>When you're done editing, type <tt>C-x C-c</tt>, which closes the
+ frame.</li>
</ol>
<p>For more information,
@@ -911,8 +902,6 @@
<p>We've also seen a prefix argument used to modify the following command (the
numeric argument, if provided, is ignored):</p>
<table class="commandlist">
- <tr><td><tt>C-/</tt></td><td>Undo</td></tr>
- <tr><td><tt>C-u C-/</tt></td><td>Undo within current region</td></tr>
<tr><td><tt>M-x shell</tt></td><td>Create or switch to shell buffer
named <tt>*shell*</tt></td></tr>
<tr><td><tt>C-u M-x shell</tt></td><td>Create or switch to shell buffer with
^ permalink raw reply [flat|nested] 7+ messages in thread