evil-qemacs/qe-doc.html

1928 lines
87 KiB
HTML
Raw Normal View History

2013-11-22 20:05:42 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by texi2html 5.0
2013-11-22 20:05:42 +00:00
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>QEmacs Documentation</title>
<meta name="description" content="QEmacs Documentation">
<meta name="keywords" content="QEmacs Documentation">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
2013-11-22 20:05:42 +00:00
<meta name="Generator" content="texi2html 5.0">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
2013-11-22 20:05:42 +00:00
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
2013-11-22 20:05:42 +00:00
span.nocodebreak {white-space:pre}
span.nolinebreak {white-space:pre}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
2013-11-22 20:05:42 +00:00
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<h1 class="titlefont">QEmacs Documentation</h1>
<br>
<br>
<br>
<hr>
<a name="Introduction"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[ &lt;&lt; ]</td>
<td valign="middle" align="left">[ &lt; ]</td>
<td valign="middle" align="left">[ Up ]</td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Invocation" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Invocation" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">1 Introduction</h1>
<p>QEmacs (for Quick Emacs) is a very small but powerful
2004-05-29 10:17:37 +00:00
UNIX editor. It has features that even big editors lack :
2013-11-22 20:05:42 +00:00
</p><ul>
<li> Full screen editor with an Emacs look and feel with all Emacs common
features: multi-buffer, multi-window, command mode, numeric
2004-05-29 10:17:37 +00:00
argument, keyboard macros, config file with C like syntax, minibuffer
with completion and history.
</li><li> Can edit files of hundreds of Megabytes without being slow by using
2004-05-29 10:17:37 +00:00
a highly optimized internal representation and by mmaping the file.
</li><li> Full <em>Unicode</em> support, including multi charset handling
2004-05-29 10:17:37 +00:00
(8859-x, UTF8, SJIS, EUC-JP, ...) and bidirectional editing respecting
the Unicode bidi algorithm. Arabic and Indic scripts handling (in
progress).
</li><li> WYSIWYG <em>HTML/XML/CSS2</em> mode graphical editing. Also supports lynx like
2004-05-29 10:17:37 +00:00
rendering on VT100 terminals.
</li><li> WYSIWYG <em>DocBook</em> mode based on XML/CSS2 renderer.
2004-05-29 10:17:37 +00:00
</li><li> C mode: coloring with immediate update. Emacs like auto-indent.
2004-05-29 10:17:37 +00:00
</li><li> Shell mode: colorized VT100 emulation so that your shell work
exactly as you expect. Compile mode with next/prev error.
2004-05-29 10:17:37 +00:00
</li><li> Input methods for most languages, including Chinese (input methods
come from the Yudit editor).
2004-05-29 10:17:37 +00:00
</li><li> <em>Hexadecimal editing</em> mode with insertion and block commands. Unicode
2004-05-29 10:17:37 +00:00
hexa editing is also supported.
</li><li> Works on any VT100 terminals without termcap. UTF8 VT100 support
2004-05-29 10:17:37 +00:00
included with double width glyphs.
</li><li> X11 support. Support multiple proportional fonts at the same time
2004-05-29 10:17:37 +00:00
(as XEmacs). X Input methods supported. Xft extension supported for
anti aliased font display.
</li><li>
2004-05-29 10:17:37 +00:00
Small! Full version (including HTML/XML/CSS2/DocBook rendering and all
charsets): 270KB big. Basic version (without bidir/unicode
scripts/input/X11/C/Shell/HTML/dired): 88KB.
</li></ul>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Invocation"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Introduction" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Introduction" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">2 Invocation</h1>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">usage: qe [-h] [-nw] [-display display] [-geometry WxH]
2004-05-29 10:17:37 +00:00
[-fs ptsize] [filename...]
2013-11-22 20:05:42 +00:00
</pre></div>
<dl compact="compact">
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-h</samp>&rsquo;</dt>
<dd><p>show help
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-nw</samp>&rsquo;</dt>
<dd><p>force tty terminal usage
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-display display</samp>&rsquo;</dt>
<dd><p>set X11 display to &rsquo;display&rsquo;
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-geometry WxH</samp>&rsquo;</dt>
<dd><p>set X11 display size
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-fs ptsize</samp>&rsquo;</dt>
<dd><p>set default font size
</p>
</dd>
</dl>
<p>When invoked as
2013-11-22 20:05:42 +00:00
</p><div class="example">
<pre class="example">usage: ffplay
</pre></div>
<p>QEmacs goes to <code>dired</code> mode automatically so that you can browse your
files easily (same as <kbd>C-x C-d</kbd> key).
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Common-editing-commands"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Invocation" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Invocation" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#Concepts" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">3 Common editing commands</h1>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Concepts"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Help-1" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.1 Concepts</h2>
<p>QEmacs store file content in <em>buffers</em>. Buffers can be seen as big
2004-05-29 10:17:37 +00:00
arrays of bytes.
</p>
<p>An <em>editing mode</em> tells how to display the content of a buffer and
2004-05-29 10:17:37 +00:00
how to interact with the user to modify its content.
</p>
<p>Multiple <em>Windows</em> can be shown on the screen at the same time. Each
2004-05-29 10:17:37 +00:00
windows show the content of a buffer with an editing mode. It means that
you can open several windows which show the same buffer in different
modes (for example, both text and hexadecimal).
</p>
<p>Each key binding activates a <em>command</em>. You can directly execute a
command by typing <kbd>M-x command RET</kbd>.
</p>
<p>Commands can take arguments. The key binding <kbd>C-u N</kbd> where N is an
2004-05-29 10:17:37 +00:00
optional number is used to give a numeric argument to the commands which
can handle them. If the command cannot handle a numerical argument, it
is simply repeated <code>N</code> times.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Help-1"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Concepts" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Simple-commands" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.2 Help</h2>
<p>You can press <kbd>C-h b</kbd> to have the list of all the currently active
2004-05-29 10:17:37 +00:00
bindings, including the ones of the current editing mode.
</p>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-h C-h, F1 : help-for-help
2004-05-29 10:17:37 +00:00
C-h b : describe-bindings
C-h c : describe-key-briefly
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Simple-commands"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Help-1" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Region-handling_002c-kill-commands" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.3 Simple commands</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">default : self-insert-command
2007-12-21 10:28:14 +00:00
M-# : insert-char
2004-05-29 10:17:37 +00:00
C-p, up : previous-line
C-n, down : next-line
C-b, left : backward-char
C-f, right : forward-char
M-b, C-left : backward-word
M-f, C-right : forward-word
M-v, prior : scroll-down
C-v, next : scroll-up
2007-12-21 10:28:14 +00:00
M-z : scroll-down-one
C-z : scroll-up-one
2004-05-29 10:17:37 +00:00
home, C-a : beginning-of-line
end, C-e : end-of-line
insert : overwrite-mode
C-d, delete : delete-char
backspace : backward-delete-char
M-&lt;, C-home : beginning-of-buffer
M-&gt;, C-end : end-of-buffer
2004-05-29 10:17:37 +00:00
C-i : tabulate
C-q : quoted-insert
RET : newline
2007-12-21 10:28:14 +00:00
C-o : open-line
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Region-handling_002c-kill-commands"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Simple-commands" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Buffer-and-file-handling" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.4 Region handling, kill commands</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-space : set-mark-command
2007-12-21 10:28:14 +00:00
C-x C-x : exchange-point-and-mark
C-x h : mark-whole-buffer
M-C-w : append-next-kill
C-k : kill-line
2004-05-29 10:17:37 +00:00
C-w : kill-region
M-w : copy-region
C-y : yank
M-y : yank-pop
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Buffer-and-file-handling"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Region-handling_002c-kill-commands" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Search-and-replace" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.5 Buffer and file handling</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-x C-f : find-file
2004-05-29 10:17:37 +00:00
C-x C-v : find-alternate-file
2007-12-21 10:28:14 +00:00
C-x i : insert-file
C-x C-s : save-buffer
C-x C-w : write-file
C-x w : write-region
2004-05-29 10:17:37 +00:00
C-x b : switch-to-buffer
C-x k : kill-buffer
C-x C-b : list-buffers
2007-12-21 10:28:14 +00:00
C-x C-q : toggle-read-only
M-~ : not-modified
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Search-and-replace"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Buffer-and-file-handling" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Paragraph-_002f-case-handling" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.6 Search and replace</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-s : isearch-backward
2004-05-29 10:17:37 +00:00
C-r : isearch-forward
M-% : query-replace
2007-12-21 10:28:14 +00:00
M-r : replace-string
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Paragraph-_002f-case-handling"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Search-and-replace" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Command-handling" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.7 Paragraph / case handling</h2>
2007-12-21 10:28:14 +00:00
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">M-{ : backward-paragraph
2007-12-21 10:28:14 +00:00
M-} : forward-paragraph
M-q : fill-paragraph
M-l : downcase-word
M-u : upcase-word
C-x C-l : downcase-region
C-x C-u : upcase-region
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Command-handling"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Paragraph-_002f-case-handling" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Window-handling" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
2007-12-21 10:28:14 +00:00
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
2007-12-21 10:28:14 +00:00
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.8 Command handling</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">M-x : execute-command
C-u : numeric-argument
2004-05-29 10:17:37 +00:00
C-g : abort
C-x u, C-_ : undo
C-x ( : start-kbd-macro
C-x ) : end-kbd-macro
2007-12-21 10:28:14 +00:00
C-x e, C-\ : call-last-kbd-macro
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Window-handling"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Command-handling" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Help" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.9 Window handling</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-x o : other-window
2007-12-21 10:28:14 +00:00
C-x n : next-window
C-x p : previous-window
2004-05-29 10:17:37 +00:00
C-x 0 : delete-window
C-x 1 : delete-other-windows
C-x 2 : split-window-vertically
C-x 3 : split-window-horizontally
C-x f : toggle-full-screen
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Help"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Window-handling" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#International" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.10 Help</h2>
2007-12-21 10:28:14 +00:00
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-h C-h, f1 : help-for-help
2007-12-21 10:28:14 +00:00
C-h b : describe-bindings
C-h c, C-h k : describe-key-briefly
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="International"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Help" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Process-control" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
2007-12-21 10:28:14 +00:00
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
2007-12-21 10:28:14 +00:00
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.11 International</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-x RET f : set-buffer-file-coding-system
2004-05-29 10:17:37 +00:00
C-x RET b : toggle-bidir
C-x RET C-\ : set-input-method
2007-12-21 10:28:14 +00:00
C-x C-\ : switch-input-method
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Process-control"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#International" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Miscellaneous" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.12 Process control</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-x RET RET : shell
2004-05-29 10:17:37 +00:00
C-x C-e : compile
C-x C-p : previous-error
C-x C-n : next-error
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Miscellaneous"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Process-control" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> &gt;&gt; </a>]</td>
2007-12-21 10:28:14 +00:00
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
2007-12-21 10:28:14 +00:00
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">3.13 Miscellaneous</h2>
2007-12-21 10:28:14 +00:00
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">C-x C-c : exit-qemacs
2007-12-21 10:28:14 +00:00
C-l : refresh
M-g : goto-line
C-x g : goto-char
C-x l : count-lines
C-x = : what-cursor-position
C-x RET l : toggle-line-numbers
C-x RET t : toggle-truncate-lines
C-x RET w : word-wrap
2004-05-29 10:17:37 +00:00
C-x C-d : dired
2013-11-22 20:05:42 +00:00
</pre></div>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Configuration-file-and-resources"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Common-editing-commands" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Miscellaneous" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#Resource-path" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">4 Configuration file and resources</h1>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Resource-path"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">4.1 Resource path</h2>
<p>All resources and configuration files are looked in the following paths:
&lsquo;<tt>/usr/share/qe:/usr/local/share/qe:/usr/lib/qe:/usr/local/lib/qe:~/.qe</tt>&rsquo;
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Configuration-file"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Resource-path" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Plugins" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">4.2 Configuration file</h2>
<p>QEmacs tries to load a configuration file in &lsquo;<tt>~/.qe/config</tt>&rsquo;. Each
2004-05-29 10:17:37 +00:00
line of the configuration file is a QEmacs command with a C like syntax
2013-11-22 20:05:42 +00:00
(&rsquo;-&rsquo; in command name can be replaced by &rsquo;_&rsquo;).
</p>
<p>Read the example file &lsquo;<tt>config.eg</tt>&rsquo; to have some examples.
</p>
<p>The following commands are useful:
</p>
<dl compact="compact">
2013-11-22 20:05:42 +00:00
<dt><code>global_set_key(key, command)</code></dt>
<dd><p>Set a global key binding to a command.
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt><code>set_display_size(width, height)</code></dt>
<dd><p>(X11) Set the window size, in character cells.
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt><code>set_system_font(family, system_fonts)</code></dt>
<dd>
<p>(X11) Maps a system font to a QEmacs font family. Multiple fonts can be
2013-11-22 20:05:42 +00:00
given as fallback (See section <a href="#fonts">Fonts</a>).
</p>
</dd>
2013-11-22 20:05:42 +00:00
<dt><code>set_style(stylename, css_property, css_value)</code></dt>
<dd><p>Set a colorization style (see &lsquo;<tt>qestyle.h</tt>&rsquo; and &lsquo;<tt>config.eg</tt>&rsquo; for
2004-05-29 10:17:37 +00:00
common style names)
</p>
</dd>
</dl>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Plugins"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">4.3 Plugins</h2>
<p>Any &lsquo;<tt>.so</tt>&rsquo; file found in the qemacs resource paths is considered as
a <em>plugin</em>. It is a piece of code containing new features for
qemacs.
</p>
<p>Currently, no plugins are compiled in, but you can look at the
2008-06-05 07:14:12 +00:00
&lsquo;<tt>plugins/</tt>&rsquo; directory to learn how to make one.
</p>
<p>Most QEmacs object files can in fact be compiled either as a plugin or
2004-05-29 10:17:37 +00:00
be statically linked in qemacs. The plugin system is strongly inspirated
from the Linux Kernel 2.4 module system.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Internationalization"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Plugins" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#Charsets" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">5 Internationalization</h1>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Charsets"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Internationalization" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Input-methods" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">5.1 Charsets</h2>
<p>QEmacs supports many common charsets including UTF8, shift JIS and EUC-JP. A
charset can be selected for each buffer with <kbd>C-x RET f</kbd>
(<code>set-buffer-file-coding-system</code>).
</p>
<p>Currently, QEmacs automatically detects the UTF8 encoding.
</p>
<p>Note that unlike in other editors, changing the charset of a buffer
2004-05-29 10:17:37 +00:00
does not modify its content: buffers always contain bytes, and the charset
is only used when the buffer content may be converted to characters, for
example to display it on screen.
</p>
<p>You can use the UniHex editing mode (<kbd>M-x unihex-mode</kbd>) to see the
2004-05-29 10:17:37 +00:00
Unicode values of each character in your file with the associated byte
offset.
</p>
<p>The command <code>convert-buffer-file-coding-system</code> can be used to
convert the buffer <em>content</em> to another charset.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Input-methods"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Internationalization" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Charsets" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Bidirectional-editing" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">5.2 Input methods</h2>
<p>The current input method can be changed with <kbd>C-x RET \</kbd>
(<code>set-input-method</code>). You can switch between this input method and
2013-11-22 20:05:42 +00:00
the default one with &rsquo;C-\&rsquo;.
</p>
<p>The input methods are currently stored in the resource file &lsquo;<tt>kmaps</tt>&rsquo;.
They are extracted from the <em>Yudit</em> editor keyboard maps.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Bidirectional-editing"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Internationalization" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Input-methods" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Unicode-scripts" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">5.3 Bidirectional editing</h2>
<p>QEmacs fully supports the Unicode bidi algorithm.
</p>
<p>By default, in text editing mode, qemacs is not in bidirectional mode (it
2013-11-22 20:05:42 +00:00
may change soon). You can use &rsquo;C-x RET b&rsquo; to toogle between bidi and normal
2004-05-29 10:17:37 +00:00
editing modes.
</p>
<p>In HTML editing mode, bidi is always activated and all the CSS2 bidi
2004-05-29 10:17:37 +00:00
properties are supported.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Unicode-scripts"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Internationalization" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Bidirectional-editing" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internationalization" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">5.4 Unicode scripts</h2>
<p>Currently, QEmacs fully supports Arabic shapping. Devanagari shaping is on
the way.
</p>
<p>The resource file &lsquo;<tt>ligatures</tt>&rsquo; contains all the standard Unicode rules
2004-05-29 10:17:37 +00:00
to handle character modifiers such as accents. It means that even if your
font does not support the Unicode character modifiers, QEmacs will do its
best to handle them.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Editing-Modes"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Internationalization" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Unicode-scripts" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#C-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">6 Editing Modes</h1>
2013-11-22 20:05:42 +00:00
<hr>
<a name="C-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Hexadecimal_002c-ascii-and-unihex-modes" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.1 C mode</h2>
<p>This mode is currently activated by &lsquo;<samp>M-x c-mode</samp>&rsquo;. It is
2004-05-29 10:17:37 +00:00
activated automatically when a C file is loaded.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Hexadecimal_002c-ascii-and-unihex-modes"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#C-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#shell-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.2 Hexadecimal, ascii and unihex modes</h2>
<p>Unlike other editors, QEmacs has powerful hexadecimal editing modes: all
common commands are working these modes, including the block commands.
</p>
<p>The hexadecimal mode (<kbd>M-x hex-mode</kbd>) shows both the hexa decimal
2004-05-29 10:17:37 +00:00
and ascii (bytes) values. You can toggle between the hexa and ascii columns
2013-11-22 20:05:42 +00:00
with &rsquo;TAB&rsquo;.
</p>
<p>The ascii mode (<kbd>M-x ascii-mode</kbd>) only shows the ascii column.
</p>
<p>The unihex mode (<kbd>M-x unihex-mode</kbd>) shows both the unicode and
glyph associated to each <em>character</em> of the buffer by using the current
2004-05-29 10:17:37 +00:00
buffer charset.
</p>
2013-11-22 20:05:42 +00:00
<p>You can change the line width in these modes with &rsquo;C-left&rsquo; and &rsquo;C-right&rsquo;.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="shell-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Hexadecimal_002c-ascii-and-unihex-modes" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Dired-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.3 shell mode</h2>
<p>You can activate it with <kbd>M-x shell</kbd>. Unlike other editors, a very
2004-05-29 10:17:37 +00:00
complete colorized VT100 emulation is done [it means you can launch
qemacs in the qemacs shell :-)].
</p>
<p>By default, <em>interactive mode</em> is selected. It means that most keys
2004-05-29 10:17:37 +00:00
you type are transmitted to the shell. This way, you can use the shell
completion and editing functions. By pressing <kbd>C-o</kbd>, you toggle
2004-05-29 10:17:37 +00:00
between interactive and editing mode. In editing mode, you can editing
the shell buffer as any other buffer.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Dired-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#shell-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Bufed-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.4 Dired mode</h2>
<p>You can activate it with <kbd>C-x C-d</kbd>. You can open the selected
directory with <kbd>RET</kbd> or <kbd>right</kbd>. <kbd>left</kbd> is used to go to the
2004-05-29 10:17:37 +00:00
parent directory. The current selected is opened in the right window.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Bufed-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Dired-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#XML-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.5 Bufed mode</h2>
<p>You can activate it with <kbd>C-x C-b</kbd>. You can select with <kbd>RET</kbd> or
<kbd>right</kbd> the current buffer.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="XML-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Bufed-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.6 XML mode</h2>
<p>This mode is currently activated by <kbd>M-x xml-mode</kbd>. It is activated
2004-05-29 10:17:37 +00:00
automatically when an XML file is loaded.
</p>
<p>Currently, only specific XML colorization is done in this
2004-05-29 10:17:37 +00:00
mode. Javascript (in SCRIPT tags) is colored as in C mode. CSS Style
sheets (in STYLE tags) are colorized with a specific color.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Graphical-HTML2_002fCSS-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#XML-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Usage" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.7 Graphical HTML2/CSS mode</h2>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Usage"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Features" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h3 class="subsection">6.7.1 Usage</h3>
<p>This mode is currently activated by <kbd>M-x html-mode</kbd>. It is
2004-05-29 10:17:37 +00:00
activated automatically when an HTML file is loaded.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Features"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Usage" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Known-limitations" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h3 class="subsection">6.7.2 Features</h3>
<p>The XML/HTML/CSS2 renderer has the following features:
2013-11-22 20:05:42 +00:00
</p><ul>
<li> The parse errors are written in buffer &rsquo;*xml-error*&rsquo;.
</li><li> Strict XML parser or relaxed mode for HTML pages.
</li><li> Letter case can be ignored or strictly respected.
</li><li> Integrated HTML to CSS2 converter so that the renderer do not
2004-05-29 10:17:37 +00:00
depend on HTML quirks.
</li><li> Quite complete CSS2 support (including generated content and
2004-05-29 10:17:37 +00:00
counters).
</li><li> Full Bidirectional Unicode support.
2013-11-22 20:05:42 +00:00
</li><li> Table support with both &rsquo;fixed&rsquo; and &rsquo;auto&rsquo; layout algorithms.
</li><li> &rsquo;tty&rsquo; and &rsquo;screen&rsquo; CSS2 medias are supported.
</li></ul>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Known-limitations"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Features" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#CSS-property-support" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h3 class="subsection">6.7.3 Known limitations</h3>
2013-11-22 20:05:42 +00:00
<ul>
<li> Cannot load external resources (e.g. style sheets) from other files.
2013-11-22 20:05:42 +00:00
</li><li> No image handling (only a rectangle with &rsquo;ALT&rsquo; name is drawn).
</li><li> No javascript.
</li><li> No frames.
</li></ul>
2013-11-22 20:05:42 +00:00
<hr>
<a name="CSS-property-support"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Known-limitations" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-DocBook-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h3 class="subsection">6.7.4 CSS property support</h3>
<p>The following properties are partially (see comments) or totally supported:
</p>
2013-11-22 20:05:42 +00:00
<ul>
<li> display: The value &rsquo;inline-block&rsquo; is a QEmacs extension.
</li><li> color
</li><li> background-color
2013-11-22 20:05:42 +00:00
</li><li> white-space: The value &rsquo;prewrap&rsquo; is a QEmacs extension.
</li><li> direction
</li><li> float
</li><li> font-family
</li><li> font-style
</li><li> font-weight
</li><li> font-size
</li><li> text-decoration
</li><li> text-align
</li><li> width
</li><li> height
</li><li> unicode-bidi
</li><li> border-width
</li><li> border-left-width
</li><li> border-top-width
</li><li> border-right-width
</li><li> border-bottom-width
</li><li> border-color
2004-05-29 10:17:37 +00:00
</li><li> border-left-color
2004-05-29 10:17:37 +00:00
</li><li> border-top-color
2004-05-29 10:17:37 +00:00
</li><li> border-right-color
2004-05-29 10:17:37 +00:00
</li><li> border-bottom-color
2004-05-29 10:17:37 +00:00
</li><li> border-style
2004-05-29 10:17:37 +00:00
</li><li> border-left-style
2004-05-29 10:17:37 +00:00
</li><li> border-top-style
2004-05-29 10:17:37 +00:00
</li><li> border-right-style
2004-05-29 10:17:37 +00:00
</li><li> border-bottom-style
2004-05-29 10:17:37 +00:00
</li><li> border
2004-05-29 10:17:37 +00:00
</li><li> border-left
2004-05-29 10:17:37 +00:00
</li><li> border-top
2004-05-29 10:17:37 +00:00
</li><li> border-right
2004-05-29 10:17:37 +00:00
</li><li> border-bottom
2004-05-29 10:17:37 +00:00
</li><li> padding
2004-05-29 10:17:37 +00:00
</li><li> padding-left
2004-05-29 10:17:37 +00:00
</li><li> padding-top
2004-05-29 10:17:37 +00:00
</li><li> padding-right
2004-05-29 10:17:37 +00:00
</li><li> padding-bottom
2004-05-29 10:17:37 +00:00
</li><li> margin
2004-05-29 10:17:37 +00:00
</li><li> margin-left
2004-05-29 10:17:37 +00:00
</li><li> margin-top
2004-05-29 10:17:37 +00:00
</li><li> margin-right
2004-05-29 10:17:37 +00:00
</li><li> margin-bottom
2004-05-29 10:17:37 +00:00
</li><li> clear
2004-05-29 10:17:37 +00:00
</li><li> overflow
2004-05-29 10:17:37 +00:00
</li><li> visibility
2004-05-29 10:17:37 +00:00
</li><li> table-layout
2004-05-29 10:17:37 +00:00
</li><li> vertical-align
2004-05-29 10:17:37 +00:00
</li><li> border-collapse
2004-05-29 10:17:37 +00:00
</li><li> border-spacing
2004-05-29 10:17:37 +00:00
</li><li> border-spacing-horizontal
2004-05-29 10:17:37 +00:00
</li><li> border-spacing-vertical
2004-05-29 10:17:37 +00:00
</li><li> line-height
2004-05-29 10:17:37 +00:00
</li><li> content
2004-05-29 10:17:37 +00:00
</li><li> caption-side
2004-05-29 10:17:37 +00:00
</li><li> marker-offset
2004-05-29 10:17:37 +00:00
</li><li> list-style-type
2004-05-29 10:17:37 +00:00
</li><li> column-span: QEmacs extension
</li><li> row-span: QEmacs extension
2013-11-22 20:05:42 +00:00
</li><li> content-alt: QEmacs extension. Same behavior as property &rsquo;content&rsquo; but used for images
2004-05-29 10:17:37 +00:00
</li><li> list-style-position
2004-05-29 10:17:37 +00:00
</li><li> counter-reset
2004-05-29 10:17:37 +00:00
</li><li> counter-increment
2004-05-29 10:17:37 +00:00
</li><li> bidi-mode: QEmacs extension: use lower/upper case to test bidi algorithm
2013-11-22 20:05:42 +00:00
</li><li> position: &lsquo;<samp>fixed</samp>&rsquo; is not supported. Only &rsquo;block&rsquo; boxes are positionned
</li><li> top
2004-05-29 10:17:37 +00:00
</li><li> bottom
2004-05-29 10:17:37 +00:00
</li><li> left
2004-05-29 10:17:37 +00:00
</li><li> right
2004-05-29 10:17:37 +00:00
</li></ul>
2004-05-29 10:17:37 +00:00
<p>The following properties are completely unsupported:
</p>
2013-11-22 20:05:42 +00:00
<ul>
<li> background
2004-05-29 10:17:37 +00:00
</li><li> background-attachment
2004-05-29 10:17:37 +00:00
</li><li> background-image
2004-05-29 10:17:37 +00:00
</li><li> background-position
2004-05-29 10:17:37 +00:00
</li><li> background-repeat
2004-05-29 10:17:37 +00:00
</li><li> clip
2004-05-29 10:17:37 +00:00
</li><li> cursor
2004-05-29 10:17:37 +00:00
</li><li> empty-cells
2004-05-29 10:17:37 +00:00
</li><li> font
2004-05-29 10:17:37 +00:00
</li><li> font-size-adjust
2004-05-29 10:17:37 +00:00
</li><li> font-stretch
2004-05-29 10:17:37 +00:00
</li><li> font-variant
2004-05-29 10:17:37 +00:00
</li><li> letter-spacing
2004-05-29 10:17:37 +00:00
</li><li> list-style
2004-05-29 10:17:37 +00:00
</li><li> list-style-image
2004-05-29 10:17:37 +00:00
</li><li> max-height
2004-05-29 10:17:37 +00:00
</li><li> max-width
2004-05-29 10:17:37 +00:00
</li><li> min-height
2004-05-29 10:17:37 +00:00
</li><li> min-width
2004-05-29 10:17:37 +00:00
</li><li> outline
2004-05-29 10:17:37 +00:00
</li><li> outline-color
2004-05-29 10:17:37 +00:00
</li><li> outline-style
2004-05-29 10:17:37 +00:00
</li><li> outline-width
2004-05-29 10:17:37 +00:00
</li><li> quotes
2004-05-29 10:17:37 +00:00
</li><li> text-indent
2004-05-29 10:17:37 +00:00
</li><li> text-shadow
2004-05-29 10:17:37 +00:00
</li><li> text-transform
2004-05-29 10:17:37 +00:00
</li><li> word-spacing
2004-05-29 10:17:37 +00:00
</li><li> z-index
2004-05-29 10:17:37 +00:00
</li><li> marks
2004-05-29 10:17:37 +00:00
</li><li> page
2004-05-29 10:17:37 +00:00
</li><li> page-break-after
</li><li> page-break-before
</li><li> page-break-inside
</li><li> size
</li><li> orphans
</li><li> widows
</li><li> azimuth
</li><li> cue
</li><li> cue-after
</li><li> cue-before
</li><li> elevation
</li><li> pause
</li><li> pause-after
</li><li> pause-before
</li><li> pitch
</li><li> pitch-range
</li><li> pitch-during
</li><li> richness
</li><li> speak
</li><li> speak-header
</li><li> speak-punctuation
</li><li> speak-rate
</li><li> stress
</li><li> voice-family
</li><li> volume
</li></ul>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Graphical-DocBook-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#CSS-property-support" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Image-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.8 Graphical DocBook mode</h2>
<p>This mode simply uses a different default style sheet from the HTML/CSS2
mode. It is activated by &lsquo;<samp>M-x docbook-mode</samp>&rsquo;.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Image-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Graphical-DocBook-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Audio_002fVideo-mode" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.9 Image mode</h2>
<p>When compiling qemacs with FFmpeg support (<a href="http://ffmpeg.org">http://ffmpeg.org</a>),
2004-05-29 10:17:37 +00:00
images can be viewed. The current implementation handles PNM, PAM, PNG,
JPEG and GIF images (animated GIF images are handled as video
data). <kbd>C-x C-d</kbd> can be used to have an interactive file viewer.
</p>
<p>Available commands:
</p>
<dl compact="compact">
2013-11-22 20:05:42 +00:00
<dt><kbd>t</kbd></dt>
<dd><p>(&lsquo;<samp>M-x image-rotate</samp>&rsquo;) Rotate right image by 90 degrees.
</p></dd>
2013-11-22 20:05:42 +00:00
<dt><kbd>f</kbd></dt>
<dd><p>(&lsquo;<samp>M-x toggle-full-screen</samp>&rsquo;) Toggle full screen mode
</p></dd>
2013-11-22 20:05:42 +00:00
<dt><kbd>c</kbd></dt>
<dd><p>(&lsquo;<samp>M-x image-convert</samp>&rsquo;) Change the pixel format of the image (press tab
2004-05-29 10:17:37 +00:00
to have a complete list). The data loss implied by the pixel format
change is displayed.
</p></dd>
2013-11-22 20:05:42 +00:00
<dt><kbd>b</kbd></dt>
<dd><p>(&lsquo;<samp>M-x image-set-background-color</samp>&rsquo;) Set the image background
2004-05-29 10:17:37 +00:00
color. The background is only visible if the image contains transparent
pixels. The &lsquo;<samp>transparent</samp>&rsquo; color displayed a &lsquo;<samp>gimp</samp>&rsquo; like grid.
</p></dd>
</dl>
2004-05-29 10:17:37 +00:00
<p>Status information:
</p>
2013-11-22 20:05:42 +00:00
<ul>
<li> The image resolution is displayed as &lsquo;<samp>NxM</samp>&rsquo;.
2004-05-29 10:17:37 +00:00
</li><li> The FFmpeg pixel format is displayed.
2004-05-29 10:17:37 +00:00
</li><li> &lsquo;<samp>I</samp>&rsquo; is displayed is the image is interleaved.
2004-05-29 10:17:37 +00:00
</li><li> &lsquo;<samp>T</samp>&rsquo; is displayed if the image contains transparent
pixels. &lsquo;<samp>A</samp>&rsquo; is displayed if the image contains semi-transparent
2004-05-29 10:17:37 +00:00
pixels.
</li></ul>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Audio_002fVideo-mode"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Image-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">6.10 Audio/Video mode</h2>
<p>When compiling qemacs with FFmpeg support (<a href="http://ffmpeg.org">http://ffmpeg.org</a>),
2004-05-29 10:17:37 +00:00
video and audio files can be viewed. The X11 Xvideo extension is used
if available for faster YUV rendering. <kbd>C-x C-d</kbd> can be used to
2004-05-29 10:17:37 +00:00
have an interactive file viewer.
</p>
<p>Audio only files are also rendered. The waveform is displayed at the
2004-05-29 10:17:37 +00:00
same time.
</p>
<p>No editing commands will be supported in that mode. Saving is
2004-05-29 10:17:37 +00:00
currently not possible.
</p>
<p>Available commands:
</p>
<dl compact="compact">
2013-11-22 20:05:42 +00:00
<dt><kbd>SPC</kbd></dt>
<dt><kbd>p</kbd></dt>
<dd><p>Pause/Resume
</p></dd>
2013-11-22 20:05:42 +00:00
<dt><kbd>f</kbd></dt>
<dd><p>(&lsquo;<samp>M-x toggle-full-screen</samp>&rsquo;) Toggle full screen mode
</p></dd>
2013-11-22 20:05:42 +00:00
<dt><kbd>v</kbd></dt>
<dd><p>(&lsquo;<samp>M-x av-cycle-video</samp>&rsquo;) Cycle through available video channels.
</p></dd>
2013-11-22 20:05:42 +00:00
<dt><kbd>a</kbd></dt>
<dd><p>(&lsquo;<samp>M-x av-cycle-audio</samp>&rsquo;) Cycle through available audio channels.
</p></dd>
</dl>
2013-11-22 20:05:42 +00:00
<hr>
<a name="fonts"></a>
2013-11-22 20:05:42 +00:00
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Editing-Modes" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Audio_002fVideo-mode" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#VT100-display" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<a name="Fonts"></a>
<h1 class="chapter">7 Fonts</h1>
2013-11-22 20:05:42 +00:00
<hr>
<a name="VT100-display"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#fonts" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#X11-display" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">7.1 VT100 display</h2>
<p>In order to display Unicode characters, you must have a recent xterm
2004-05-29 10:17:37 +00:00
from XFree version greater than 4.0.1.
</p>
<p>As a short test, you can launch xterm with the following options to
2004-05-29 10:17:37 +00:00
select UTF8 charset and a unicode fixed X11 font:
2013-11-22 20:05:42 +00:00
</p><div class="example">
<pre class="example">xterm -u8 -fn -misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1
</pre></div>
<p>Then look at the qemacs TestPage in VT100 mode:
2013-11-22 20:05:42 +00:00
</p><div class="example">
<pre class="example">qe -nw tests/TestPage.txt
</pre></div>
<p>If you are using latin scripts, you can use any fixed font in any
2004-05-29 10:17:37 +00:00
terminal. Otherwise, if you use ideograms or other non latin scripts,
you must configure your terminal emulator (usually xterm) to accept
2013-11-22 20:05:42 +00:00
&rsquo;double width&rsquo; fonts. It means that some characters, such as ideograms,
2004-05-29 10:17:37 +00:00
are meant to occupy two char cells instead of one. QEmacs knows that and
does the text alyout accordingly.
</p>
<p>The font <em>Unifont</em> is currently the best font for xterm. It is
2004-05-29 10:17:37 +00:00
usually included in the linux distributions. You can find it at
<a href="http://czyborra.com/unifont/">http://czyborra.com/unifont/</a>.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="X11-display"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#fonts" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#VT100-display" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Internal-QEmacs-fonts" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">7.2 X11 display</h2>
<p>QEmacs knows three basic font families:
</p>
2013-11-22 20:05:42 +00:00
<ul>
<li> &lsquo;<samp>sans</samp>&rsquo; for sans serif fonts.
</li><li> &lsquo;<samp>serif</samp>&rsquo; for serif fonts.
</li><li> &lsquo;<samp>fixed</samp>&rsquo; for fixed or monospace fonts.
</li></ul>
<p>QEmacs maps these three families to system fonts. The default mapping
is: &lsquo;<samp>helvetica</samp>&rsquo; for sans, &lsquo;<samp>Times</samp>&rsquo; for serif and &lsquo;<samp>fixed</samp>&rsquo;
2004-05-29 10:17:37 +00:00
for fixed.
</p>
<p>For each family, you can specify any number of <em>fallback fonts</em> that
2004-05-29 10:17:37 +00:00
QEmacs can use if the requested glyph is not found in the current
font. Currently, the font &lsquo;<samp>unifont</samp>&rsquo; is used as fallback in all
2004-05-29 10:17:37 +00:00
cases.
</p>
<p>You can use the command <code>set-system-font(family, fonts)</code> to change
the default qemacs mapping. <code>family</code> is <code>sans</code>, <code>serif</code>
or <code>fixed</code>, and <code>fonts</code> is a comma separated list of system
2004-05-29 10:17:37 +00:00
fonts which are used as principal font and fallback fonts.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Internal-QEmacs-fonts"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#fonts" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#X11-display" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#fonts" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">7.3 Internal QEmacs fonts</h2>
<p>In the tool &lsquo;<samp>html2png</samp>&rsquo;, QEmacs uses internal fonts which are the
&lsquo;<samp>Times</samp>&rsquo;, &lsquo;<samp>Helvetica</samp>&rsquo; and &lsquo;<samp>Unifont</samp>&rsquo; supplied in X11. They
are highly compressed in the <em>FBF</em> font format.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Html2png-Tool"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#fonts" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Internal-QEmacs-fonts" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#Introduction-1" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">8 Html2png Tool</h1>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Introduction-1"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Html2png-Tool" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Invocation-1" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">8.1 Introduction</h2>
<p>Html2png is a standalone HTML/XML/CSS2 renderer based on the QEmacs
2004-05-29 10:17:37 +00:00
internal renderer. It takes an HTML or XHTML file as input and produce a
PNG image file containing the graphical rendering of the page. It is
meant to be a test tool for the renderer. It can also be used as a
XML/HTML validator since all parse errors are logged on the standard
output.
</p>
<p>Unlike other HTML renderers, HTML2PNG do not have any dependency on the
2004-05-29 10:17:37 +00:00
operating system or the graphical interface. It uses its own fonts
(which are embedded in the executable), its own widgets and its own
charset tables.
</p>
<p>By using the highly compressed FBF font format, the Times, Helvetica and
2004-05-29 10:17:37 +00:00
Unifont fonts are embedded in the executable. It means that HTML2PNG can
view documents in any languages, including Arabic, Hebrew, Japanese and
Hangul.
</p>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Invocation-1"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Html2png-Tool" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Introduction-1" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">8.2 Invocation</h2>
2013-11-22 20:05:42 +00:00
<div class="example">
<pre class="example">usage: html2png [-h] [-x] [-w width] [-o outfile] [-f charset] infile
</pre></div>
<dl compact="compact">
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-h</samp>&rsquo;</dt>
<dd><p>display the help
</p></dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-x</samp>&rsquo;</dt>
<dd><p>use strict XML parser (xhtml type parsing)
</p></dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-w width</samp>&rsquo;</dt>
<dd><p>set the image width (default=640)
</p></dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-f charset</samp>&rsquo;</dt>
<dd><p>set the default charset (default=&rsquo;8859-1&rsquo;). Use -f ? to list supported charsets.
</p></dd>
2013-11-22 20:05:42 +00:00
<dt>&lsquo;<samp>-o outfile</samp>&rsquo;</dt>
<dd><p>set the output filename (default=&rsquo;a.png&rsquo;)
</p></dd>
</dl>
2013-11-22 20:05:42 +00:00
<hr>
<a name="Developper_0027s-Guide"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Html2png-Tool" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Invocation-1" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[ Up ]</td>
<td valign="middle" align="left">[<a href="#Plugins-1" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left">[ &gt;&gt; ]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h1 class="chapter">9 Developper&rsquo;s Guide</h1>
<hr>
<a name="Plugins-1"></a>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[ &gt; ]</td>
<td valign="middle" align="left">[ &gt;&gt; ]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
2013-11-22 20:05:42 +00:00
<td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
2013-11-22 20:05:42 +00:00
<h2 class="section">9.1 Plugins</h2>
2008-06-05 07:14:12 +00:00
<p>You can use the example in &lsquo;<tt>plugins/</tt>&rsquo; to develop dynamically
linked qemacs plugins (aka modules).
</p>
<p>Plugins can add any dynamic resource qemacs supports (modes, key
2004-05-29 10:17:37 +00:00
bindings, ...). A plugin can be either statically linked or
dynamically linked. Most of qemacs features are in fact statically
linked plugins.
</p>
<hr size="6">
<a name="SEC_About"></a>
2013-11-22 20:05:42 +00:00
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Introduction" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[Contents]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<h1>About This Document</h1>
2013-11-22 20:05:42 +00:00
<p>
</p>
<p>
The buttons in the navigation panels have the following meaning:
</p>
<table border="1">
<tr>
<th> Button </th>
<th> Name </th>
<th> Go to </th>
<th> From 1.2.3 go to</th>
</tr>
<tr>
<td align="center"> [ &lt;&lt; ] </td>
<td align="center">FastBack</td>
<td>Beginning of this chapter or previous chapter</td>
<td>1</td>
</tr>
2013-11-22 20:05:42 +00:00
<tr>
<td align="center"> [ &lt; ] </td>
<td align="center">Back</td>
<td>Previous section in reading order</td>
<td>1.2.2</td>
</tr>
<tr>
<td align="center"> [ Up ] </td>
<td align="center">Up</td>
<td>Up section</td>
<td>1.2</td>
</tr>
2013-11-22 20:05:42 +00:00
<tr>
<td align="center"> [ &gt; ] </td>
<td align="center">Forward</td>
<td>Next section in reading order</td>
<td>1.2.4</td>
</tr>
<tr>
<td align="center"> [ &gt;&gt; ] </td>
<td align="center">FastForward</td>
<td>Next chapter</td>
<td>2</td>
</tr>
<tr>
<td align="center"> [Top] </td>
<td align="center">Top</td>
<td>Cover (top) of document</td>
<td> &nbsp; </td>
</tr>
<tr>
<td align="center"> [Contents] </td>
<td align="center">Contents</td>
<td>Table of contents</td>
<td> &nbsp; </td>
</tr>
<tr>
<td align="center"> [Index] </td>
<td align="center">Index</td>
<td>Index</td>
<td> &nbsp; </td>
</tr>
<tr>
<td align="center"> [ ? ] </td>
<td align="center">About</td>
<td>About (help)</td>
<td> &nbsp; </td>
</tr>
</table>
<p>
where the <strong> Example </strong> assumes that the current position is at <strong> Subsubsection One-Two-Three </strong> of a document of the following structure:
</p>
<ul>
<li> 1. Section One
<ul>
<li>1.1 Subsection One-One
<ul>
<li>...</li>
</ul>
</li>
<li>1.2 Subsection One-Two
<ul>
<li>1.2.1 Subsubsection One-Two-One</li>
<li>1.2.2 Subsubsection One-Two-Two</li>
<li>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp;
<strong>&lt;== Current Position </strong></li>
<li>1.2.4 Subsubsection One-Two-Four</li>
</ul>
</li>
<li>1.3 Subsection One-Three
<ul>
<li>...</li>
</ul>
</li>
<li>1.4 Subsection One-Four</li>
</ul>
</li>
</ul>
2013-11-22 20:05:42 +00:00
<hr>
<p>
<font size="-1">
</font>
<br>
</p>
</body>
</html>