Updating the tour for Xft

Updating the tour for Xft

[David House]

Hi all,

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?

The tour is a great way of showing off Emacs' features and visual
features have a massive impact, so this seems like a logical thing to
do.

-- 
-David

Re: Updating the tour for Xft

[Phil Sung]

On Thu, Jul 30, 2009 at 04:13, David House<dmhouse@gmail.com> 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?
>
> The tour is a great way of showing off Emacs' features and visual
> features have a massive impact, so this seems like a logical thing to
> do.

That's a good idea. I'll take care of it (although it may be few days
before I can get around to it).

Phil

Re: Updating the tour for Xft

[Stefan Monnier]

> 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?

> The tour is a great way of showing off Emacs' features and visual
> features have a massive impact, so this seems like a logical thing
> to do.

I agree that the tour should be updated to reflect what the user would
see in Emacs-23.  Any volunteer?


        Stefan

Re: Updating the tour for Xft

[Gilaras Drakeson]

Hi,

>> 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?
>
>> The tour is a great way of showing off Emacs' features and visual
>> features have a massive impact, so this seems like a logical thing
>> to do.
>
> I agree that the tour should be updated to reflect what the user would
> see in Emacs-23.  Any volunteer?

Is there a [wrapper] function to "import" a rectangular region of the
current frame with the rectangle expressed in terms of (row,col)s, and
create an image out of it?

-- 
Gilaras

Re: Updating the tour for Xft

[Phil Sung]

[-- 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&nbsp;-t&nbsp;FILENAME</tt> at a
+    prompt. You can also change your <tt>$EDITOR</tt>
+    to <tt>emacsclient&nbsp;-t</tt> if you're using programs that automatically
+    invoke <tt>$EDITOR</tt>. (<tt>emacsclient&nbsp;-t</tt> opens a new frame on
+    the terminal; alternatively, <tt>emacsclient&nbsp;-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

Re: Updating the tour for Xft

[Phil Sung]

On Thu, Jul 30, 2009 at 17:52, Kenichi Handa<handa@m17n.org> wrote:
> In article <60c603510907301026i540ba1fbuf14416c17e7bb7cd@mail.gmail.com>, Phil Sung <psung@mit.edu> writes:
> Please consider adding the attached image (showing the HELLO
> file).

Thanks! I included a similar image.

Phil

Re: Updating the tour for Xft

[Glenn Morris]

applied.