* Added filtering post texi2html to remove date items. This makes the output file qe-doc.html time independent
1928 lines
87 KiB
HTML
1928 lines
87 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<!-- Created by texi2html 5.0
|
|
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">
|
|
<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}
|
|
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}
|
|
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">
|
|
|
|
<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">[ << ]</td>
|
|
<td valign="middle" align="left">[ < ]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#Invocation" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Invocation" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">1 Introduction</h1>
|
|
<p>QEmacs (for Quick Emacs) is a very small but powerful
|
|
UNIX editor. It has features that even big editors lack :
|
|
</p><ul>
|
|
<li> Full screen editor with an Emacs look and feel with all Emacs common
|
|
features: multi-buffer, multi-window, command mode, numeric
|
|
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
|
|
a highly optimized internal representation and by mmaping the file.
|
|
|
|
</li><li> Full <em>Unicode</em> support, including multi charset handling
|
|
(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
|
|
rendering on VT100 terminals.
|
|
|
|
</li><li> WYSIWYG <em>DocBook</em> mode based on XML/CSS2 renderer.
|
|
|
|
</li><li> C mode: coloring with immediate update. Emacs like auto-indent.
|
|
|
|
</li><li> Shell mode: colorized VT100 emulation so that your shell work
|
|
exactly as you expect. Compile mode with next/prev error.
|
|
|
|
</li><li> Input methods for most languages, including Chinese (input methods
|
|
come from the Yudit editor).
|
|
|
|
</li><li> <em>Hexadecimal editing</em> mode with insertion and block commands. Unicode
|
|
hexa editing is also supported.
|
|
|
|
</li><li> Works on any VT100 terminals without termcap. UTF8 VT100 support
|
|
included with double width glyphs.
|
|
|
|
</li><li> X11 support. Support multiple proportional fonts at the same time
|
|
(as XEmacs). X Input methods supported. Xft extension supported for
|
|
anti aliased font display.
|
|
|
|
</li><li>
|
|
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>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Introduction" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">2 Invocation</h1>
|
|
|
|
<div class="example">
|
|
<pre class="example">usage: qe [-h] [-nw] [-display display] [-geometry WxH]
|
|
[-fs ptsize] [filename...]
|
|
</pre></div>
|
|
|
|
<dl compact="compact">
|
|
<dt>‘<samp>-h</samp>’</dt>
|
|
<dd><p>show help
|
|
</p>
|
|
</dd>
|
|
<dt>‘<samp>-nw</samp>’</dt>
|
|
<dd><p>force tty terminal usage
|
|
</p>
|
|
</dd>
|
|
<dt>‘<samp>-display display</samp>’</dt>
|
|
<dd><p>set X11 display to ’display’
|
|
</p>
|
|
</dd>
|
|
<dt>‘<samp>-geometry WxH</samp>’</dt>
|
|
<dd><p>set X11 display size
|
|
</p>
|
|
</dd>
|
|
<dt>‘<samp>-fs ptsize</samp>’</dt>
|
|
<dd><p>set default font size
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<p>When invoked as
|
|
</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>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Invocation" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#Concepts" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">3 Common editing commands</h1>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Common-editing-commands" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.1 Concepts</h2>
|
|
|
|
<p>QEmacs store file content in <em>buffers</em>. Buffers can be seen as big
|
|
arrays of bytes.
|
|
</p>
|
|
<p>An <em>editing mode</em> tells how to display the content of a buffer and
|
|
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
|
|
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
|
|
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>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Concepts" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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
|
|
bindings, including the ones of the current editing mode.
|
|
</p>
|
|
<div class="example">
|
|
<pre class="example">C-h C-h, F1 : help-for-help
|
|
C-h b : describe-bindings
|
|
C-h c : describe-key-briefly
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Help-1" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.3 Simple commands</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">default : self-insert-command
|
|
M-# : insert-char
|
|
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
|
|
M-z : scroll-down-one
|
|
C-z : scroll-up-one
|
|
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-<, C-home : beginning-of-buffer
|
|
M->, C-end : end-of-buffer
|
|
C-i : tabulate
|
|
C-q : quoted-insert
|
|
RET : newline
|
|
C-o : open-line
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Simple-commands" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.4 Region handling, kill commands</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-space : set-mark-command
|
|
C-x C-x : exchange-point-and-mark
|
|
C-x h : mark-whole-buffer
|
|
M-C-w : append-next-kill
|
|
C-k : kill-line
|
|
C-w : kill-region
|
|
M-w : copy-region
|
|
C-y : yank
|
|
M-y : yank-pop
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Region-handling_002c-kill-commands" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.5 Buffer and file handling</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-x C-f : find-file
|
|
C-x C-v : find-alternate-file
|
|
C-x i : insert-file
|
|
C-x C-s : save-buffer
|
|
C-x C-w : write-file
|
|
C-x w : write-region
|
|
C-x b : switch-to-buffer
|
|
C-x k : kill-buffer
|
|
C-x C-b : list-buffers
|
|
C-x C-q : toggle-read-only
|
|
M-~ : not-modified
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Buffer-and-file-handling" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.6 Search and replace</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-s : isearch-backward
|
|
C-r : isearch-forward
|
|
M-% : query-replace
|
|
M-r : replace-string
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Search-and-replace" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.7 Paragraph / case handling</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">M-{ : backward-paragraph
|
|
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
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Paragraph-_002f-case-handling" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.8 Command handling</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">M-x : execute-command
|
|
C-u : numeric-argument
|
|
C-g : abort
|
|
C-x u, C-_ : undo
|
|
C-x ( : start-kbd-macro
|
|
C-x ) : end-kbd-macro
|
|
C-x e, C-\ : call-last-kbd-macro
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Command-handling" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.9 Window handling</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-x o : other-window
|
|
C-x n : next-window
|
|
C-x p : previous-window
|
|
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
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Window-handling" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.10 Help</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-h C-h, f1 : help-for-help
|
|
C-h b : describe-bindings
|
|
C-h c, C-h k : describe-key-briefly
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Help" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.11 International</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-x RET f : set-buffer-file-coding-system
|
|
C-x RET b : toggle-bidir
|
|
C-x RET C-\ : set-input-method
|
|
C-x C-\ : switch-input-method
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#International" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.12 Process control</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-x RET RET : shell
|
|
C-x C-e : compile
|
|
C-x C-p : previous-error
|
|
C-x C-n : next-error
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Process-control" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">3.13 Miscellaneous</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">C-x C-c : exit-qemacs
|
|
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
|
|
C-x C-d : dired
|
|
</pre></div>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Miscellaneous" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#Resource-path" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">4 Configuration file and resources</h1>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file-and-resources" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">4.1 Resource path</h2>
|
|
|
|
<p>All resources and configuration files are looked in the following paths:
|
|
‘<tt>/usr/share/qe:/usr/local/share/qe:/usr/lib/qe:/usr/local/lib/qe:~/.qe</tt>’
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Resource-path" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">4.2 Configuration file</h2>
|
|
|
|
<p>QEmacs tries to load a configuration file in ‘<tt>~/.qe/config</tt>’. Each
|
|
line of the configuration file is a QEmacs command with a C like syntax
|
|
(’-’ in command name can be replaced by ’_’).
|
|
</p>
|
|
<p>Read the example file ‘<tt>config.eg</tt>’ to have some examples.
|
|
</p>
|
|
<p>The following commands are useful:
|
|
</p>
|
|
<dl compact="compact">
|
|
<dt><code>global_set_key(key, command)</code></dt>
|
|
<dd><p>Set a global key binding to a command.
|
|
</p>
|
|
</dd>
|
|
<dt><code>set_display_size(width, height)</code></dt>
|
|
<dd><p>(X11) Set the window size, in character cells.
|
|
</p>
|
|
</dd>
|
|
<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
|
|
given as fallback (See section <a href="#fonts">Fonts</a>).
|
|
</p>
|
|
</dd>
|
|
<dt><code>set_style(stylename, css_property, css_value)</code></dt>
|
|
<dd><p>Set a colorization style (see ‘<tt>qestyle.h</tt>’ and ‘<tt>config.eg</tt>’ for
|
|
common style names)
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Configuration-file" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Internationalization" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">4.3 Plugins</h2>
|
|
|
|
<p>Any ‘<tt>.so</tt>’ 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
|
|
‘<tt>plugins/</tt>’ directory to learn how to make one.
|
|
</p>
|
|
<p>Most QEmacs object files can in fact be compiled either as a plugin or
|
|
be statically linked in qemacs. The plugin system is strongly inspirated
|
|
from the Linux Kernel 2.4 module system.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Plugins" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#Charsets" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">5 Internationalization</h1>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Internationalization" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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
|
|
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
|
|
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>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Charsets" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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
|
|
the default one with ’C-\’.
|
|
</p>
|
|
<p>The input methods are currently stored in the resource file ‘<tt>kmaps</tt>’.
|
|
They are extracted from the <em>Yudit</em> editor keyboard maps.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Input-methods" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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
|
|
may change soon). You can use ’C-x RET b’ to toogle between bidi and normal
|
|
editing modes.
|
|
</p>
|
|
<p>In HTML editing mode, bidi is always activated and all the CSS2 bidi
|
|
properties are supported.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Bidirectional-editing" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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 ‘<tt>ligatures</tt>’ contains all the standard Unicode rules
|
|
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>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Unicode-scripts" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#C-mode" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">6 Editing Modes</h1>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Editing-Modes" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">6.1 C mode</h2>
|
|
|
|
<p>This mode is currently activated by ‘<samp>M-x c-mode</samp>’. It is
|
|
activated automatically when a C file is loaded.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#C-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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
|
|
and ascii (bytes) values. You can toggle between the hexa and ascii columns
|
|
with ’TAB’.
|
|
</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
|
|
buffer charset.
|
|
</p>
|
|
<p>You can change the line width in these modes with ’C-left’ and ’C-right’.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Hexadecimal_002c-ascii-and-unihex-modes" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">6.3 shell mode</h2>
|
|
|
|
<p>You can activate it with <kbd>M-x shell</kbd>. Unlike other editors, a very
|
|
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
|
|
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
|
|
between interactive and editing mode. In editing mode, you can editing
|
|
the shell buffer as any other buffer.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#shell-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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
|
|
parent directory. The current selected is opened in the right window.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Dired-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Bufed-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">6.6 XML mode</h2>
|
|
|
|
<p>This mode is currently activated by <kbd>M-x xml-mode</kbd>. It is activated
|
|
automatically when an XML file is loaded.
|
|
</p>
|
|
<p>Currently, only specific XML colorization is done in this
|
|
mode. Javascript (in SCRIPT tags) is colored as in C mode. CSS Style
|
|
sheets (in STYLE tags) are colorized with a specific color.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#XML-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">6.7 Graphical HTML2/CSS mode</h2>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Graphical-HTML2_002fCSS-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h3 class="subsection">6.7.1 Usage</h3>
|
|
|
|
<p>This mode is currently activated by <kbd>M-x html-mode</kbd>. It is
|
|
activated automatically when an HTML file is loaded.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Usage" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h3 class="subsection">6.7.2 Features</h3>
|
|
|
|
<p>The XML/HTML/CSS2 renderer has the following features:
|
|
</p><ul>
|
|
<li> The parse errors are written in buffer ’*xml-error*’.
|
|
</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
|
|
depend on HTML quirks.
|
|
</li><li> Quite complete CSS2 support (including generated content and
|
|
counters).
|
|
</li><li> Full Bidirectional Unicode support.
|
|
</li><li> Table support with both ’fixed’ and ’auto’ layout algorithms.
|
|
</li><li> ’tty’ and ’screen’ CSS2 medias are supported.
|
|
</li></ul>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Features" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h3 class="subsection">6.7.3 Known limitations</h3>
|
|
|
|
<ul>
|
|
<li> Cannot load external resources (e.g. style sheets) from other files.
|
|
</li><li> No image handling (only a rectangle with ’ALT’ name is drawn).
|
|
</li><li> No javascript.
|
|
</li><li> No frames.
|
|
</li></ul>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Known-limitations" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h3 class="subsection">6.7.4 CSS property support</h3>
|
|
|
|
<p>The following properties are partially (see comments) or totally supported:
|
|
</p>
|
|
<ul>
|
|
<li> display: The value ’inline-block’ is a QEmacs extension.
|
|
</li><li> color
|
|
|
|
</li><li> background-color
|
|
|
|
</li><li> white-space: The value ’prewrap’ 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
|
|
|
|
</li><li> border-left-color
|
|
|
|
</li><li> border-top-color
|
|
|
|
</li><li> border-right-color
|
|
|
|
</li><li> border-bottom-color
|
|
|
|
</li><li> border-style
|
|
|
|
</li><li> border-left-style
|
|
|
|
</li><li> border-top-style
|
|
|
|
</li><li> border-right-style
|
|
|
|
</li><li> border-bottom-style
|
|
|
|
</li><li> border
|
|
|
|
</li><li> border-left
|
|
|
|
</li><li> border-top
|
|
|
|
</li><li> border-right
|
|
|
|
</li><li> border-bottom
|
|
|
|
</li><li> padding
|
|
|
|
</li><li> padding-left
|
|
|
|
</li><li> padding-top
|
|
|
|
</li><li> padding-right
|
|
|
|
</li><li> padding-bottom
|
|
|
|
</li><li> margin
|
|
|
|
</li><li> margin-left
|
|
|
|
</li><li> margin-top
|
|
|
|
</li><li> margin-right
|
|
|
|
</li><li> margin-bottom
|
|
|
|
</li><li> clear
|
|
|
|
</li><li> overflow
|
|
|
|
</li><li> visibility
|
|
|
|
</li><li> table-layout
|
|
|
|
</li><li> vertical-align
|
|
|
|
</li><li> border-collapse
|
|
|
|
</li><li> border-spacing
|
|
|
|
</li><li> border-spacing-horizontal
|
|
|
|
</li><li> border-spacing-vertical
|
|
|
|
</li><li> line-height
|
|
|
|
</li><li> content
|
|
|
|
</li><li> caption-side
|
|
|
|
</li><li> marker-offset
|
|
|
|
</li><li> list-style-type
|
|
|
|
</li><li> column-span: QEmacs extension
|
|
</li><li> row-span: QEmacs extension
|
|
</li><li> content-alt: QEmacs extension. Same behavior as property ’content’ but used for images
|
|
|
|
</li><li> list-style-position
|
|
|
|
</li><li> counter-reset
|
|
|
|
</li><li> counter-increment
|
|
|
|
</li><li> bidi-mode: QEmacs extension: use lower/upper case to test bidi algorithm
|
|
</li><li> position: ‘<samp>fixed</samp>’ is not supported. Only ’block’ boxes are positionned
|
|
</li><li> top
|
|
|
|
</li><li> bottom
|
|
|
|
</li><li> left
|
|
|
|
</li><li> right
|
|
|
|
</li></ul>
|
|
|
|
<p>The following properties are completely unsupported:
|
|
</p>
|
|
<ul>
|
|
<li> background
|
|
|
|
</li><li> background-attachment
|
|
|
|
</li><li> background-image
|
|
|
|
</li><li> background-position
|
|
|
|
</li><li> background-repeat
|
|
|
|
</li><li> clip
|
|
|
|
</li><li> cursor
|
|
|
|
</li><li> empty-cells
|
|
|
|
</li><li> font
|
|
|
|
</li><li> font-size-adjust
|
|
|
|
</li><li> font-stretch
|
|
|
|
</li><li> font-variant
|
|
|
|
</li><li> letter-spacing
|
|
|
|
</li><li> list-style
|
|
|
|
</li><li> list-style-image
|
|
|
|
</li><li> max-height
|
|
|
|
</li><li> max-width
|
|
|
|
</li><li> min-height
|
|
|
|
</li><li> min-width
|
|
|
|
</li><li> outline
|
|
|
|
</li><li> outline-color
|
|
|
|
</li><li> outline-style
|
|
|
|
</li><li> outline-width
|
|
|
|
</li><li> quotes
|
|
|
|
</li><li> text-indent
|
|
|
|
</li><li> text-shadow
|
|
|
|
</li><li> text-transform
|
|
|
|
</li><li> word-spacing
|
|
|
|
</li><li> z-index
|
|
|
|
</li><li> marks
|
|
|
|
</li><li> page
|
|
|
|
</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>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#CSS-property-support" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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 ‘<samp>M-x docbook-mode</samp>’.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Graphical-DocBook-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">6.9 Image mode</h2>
|
|
|
|
<p>When compiling qemacs with FFmpeg support (<a href="http://ffmpeg.org">http://ffmpeg.org</a>),
|
|
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">
|
|
<dt><kbd>t</kbd></dt>
|
|
<dd><p>(‘<samp>M-x image-rotate</samp>’) Rotate right image by 90 degrees.
|
|
</p></dd>
|
|
<dt><kbd>f</kbd></dt>
|
|
<dd><p>(‘<samp>M-x toggle-full-screen</samp>’) Toggle full screen mode
|
|
</p></dd>
|
|
<dt><kbd>c</kbd></dt>
|
|
<dd><p>(‘<samp>M-x image-convert</samp>’) Change the pixel format of the image (press tab
|
|
to have a complete list). The data loss implied by the pixel format
|
|
change is displayed.
|
|
</p></dd>
|
|
<dt><kbd>b</kbd></dt>
|
|
<dd><p>(‘<samp>M-x image-set-background-color</samp>’) Set the image background
|
|
color. The background is only visible if the image contains transparent
|
|
pixels. The ‘<samp>transparent</samp>’ color displayed a ‘<samp>gimp</samp>’ like grid.
|
|
</p></dd>
|
|
</dl>
|
|
|
|
<p>Status information:
|
|
</p>
|
|
<ul>
|
|
<li> The image resolution is displayed as ‘<samp>NxM</samp>’.
|
|
|
|
</li><li> The FFmpeg pixel format is displayed.
|
|
|
|
</li><li> ‘<samp>I</samp>’ is displayed is the image is interleaved.
|
|
|
|
</li><li> ‘<samp>T</samp>’ is displayed if the image contains transparent
|
|
pixels. ‘<samp>A</samp>’ is displayed if the image contains semi-transparent
|
|
pixels.
|
|
|
|
</li></ul>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Image-mode" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<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>),
|
|
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
|
|
have an interactive file viewer.
|
|
</p>
|
|
<p>Audio only files are also rendered. The waveform is displayed at the
|
|
same time.
|
|
</p>
|
|
<p>No editing commands will be supported in that mode. Saving is
|
|
currently not possible.
|
|
</p>
|
|
<p>Available commands:
|
|
</p>
|
|
<dl compact="compact">
|
|
<dt><kbd>SPC</kbd></dt>
|
|
<dt><kbd>p</kbd></dt>
|
|
<dd><p>Pause/Resume
|
|
</p></dd>
|
|
<dt><kbd>f</kbd></dt>
|
|
<dd><p>(‘<samp>M-x toggle-full-screen</samp>’) Toggle full screen mode
|
|
</p></dd>
|
|
<dt><kbd>v</kbd></dt>
|
|
<dd><p>(‘<samp>M-x av-cycle-video</samp>’) Cycle through available video channels.
|
|
</p></dd>
|
|
<dt><kbd>a</kbd></dt>
|
|
<dd><p>(‘<samp>M-x av-cycle-audio</samp>’) Cycle through available audio channels.
|
|
</p></dd>
|
|
</dl>
|
|
|
|
<hr>
|
|
<a name="fonts"></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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Audio_002fVideo-mode" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#VT100-display" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<a name="Fonts"></a>
|
|
<h1 class="chapter">7 Fonts</h1>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#fonts" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">7.1 VT100 display</h2>
|
|
|
|
<p>In order to display Unicode characters, you must have a recent xterm
|
|
from XFree version greater than 4.0.1.
|
|
</p>
|
|
<p>As a short test, you can launch xterm with the following options to
|
|
select UTF8 charset and a unicode fixed X11 font:
|
|
</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:
|
|
</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
|
|
terminal. Otherwise, if you use ideograms or other non latin scripts,
|
|
you must configure your terminal emulator (usually xterm) to accept
|
|
’double width’ fonts. It means that some characters, such as ideograms,
|
|
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
|
|
usually included in the linux distributions. You can find it at
|
|
<a href="http://czyborra.com/unifont/">http://czyborra.com/unifont/</a>.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#VT100-display" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">7.2 X11 display</h2>
|
|
|
|
<p>QEmacs knows three basic font families:
|
|
</p>
|
|
<ul>
|
|
<li> ‘<samp>sans</samp>’ for sans serif fonts.
|
|
</li><li> ‘<samp>serif</samp>’ for serif fonts.
|
|
</li><li> ‘<samp>fixed</samp>’ for fixed or monospace fonts.
|
|
</li></ul>
|
|
|
|
<p>QEmacs maps these three families to system fonts. The default mapping
|
|
is: ‘<samp>helvetica</samp>’ for sans, ‘<samp>Times</samp>’ for serif and ‘<samp>fixed</samp>’
|
|
for fixed.
|
|
</p>
|
|
<p>For each family, you can specify any number of <em>fallback fonts</em> that
|
|
QEmacs can use if the requested glyph is not found in the current
|
|
font. Currently, the font ‘<samp>unifont</samp>’ is used as fallback in all
|
|
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
|
|
fonts which are used as principal font and fallback fonts.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#X11-display" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">7.3 Internal QEmacs fonts</h2>
|
|
|
|
<p>In the tool ‘<samp>html2png</samp>’, QEmacs uses internal fonts which are the
|
|
‘<samp>Times</samp>’, ‘<samp>Helvetica</samp>’ and ‘<samp>Unifont</samp>’ supplied in X11. They
|
|
are highly compressed in the <em>FBF</em> font format.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Internal-QEmacs-fonts" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#Introduction-1" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">8 Html2png Tool</h1>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Html2png-Tool" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">8.1 Introduction</h2>
|
|
|
|
<p>Html2png is a standalone HTML/XML/CSS2 renderer based on the QEmacs
|
|
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
|
|
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
|
|
Unifont fonts are embedded in the executable. It means that HTML2PNG can
|
|
view documents in any languages, including Arabic, Hebrew, Japanese and
|
|
Hangul.
|
|
</p>
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Introduction-1" title="Previous section in reading order"> < </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"> > </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Next chapter"> >> </a>]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">8.2 Invocation</h2>
|
|
|
|
<div class="example">
|
|
<pre class="example">usage: html2png [-h] [-x] [-w width] [-o outfile] [-f charset] infile
|
|
</pre></div>
|
|
|
|
<dl compact="compact">
|
|
<dt>‘<samp>-h</samp>’</dt>
|
|
<dd><p>display the help
|
|
</p></dd>
|
|
<dt>‘<samp>-x</samp>’</dt>
|
|
<dd><p>use strict XML parser (xhtml type parsing)
|
|
</p></dd>
|
|
<dt>‘<samp>-w width</samp>’</dt>
|
|
<dd><p>set the image width (default=640)
|
|
</p></dd>
|
|
<dt>‘<samp>-f charset</samp>’</dt>
|
|
<dd><p>set the default charset (default=’8859-1’). Use -f ? to list supported charsets.
|
|
</p></dd>
|
|
<dt>‘<samp>-o outfile</samp>’</dt>
|
|
<dd><p>set the output filename (default=’a.png’)
|
|
</p></dd>
|
|
</dl>
|
|
|
|
<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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Invocation-1" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[ Up ]</td>
|
|
<td valign="middle" align="left">[<a href="#Plugins-1" title="Next section in reading order"> > </a>]</td>
|
|
<td valign="middle" align="left">[ >> ]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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 class="chapter">9 Developper’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"> << </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Previous section in reading order"> < </a>]</td>
|
|
<td valign="middle" align="left">[<a href="#Developper_0027s-Guide" title="Up section"> Up </a>]</td>
|
|
<td valign="middle" align="left">[ > ]</td>
|
|
<td valign="middle" align="left">[ >> ]</td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<td valign="middle" align="left"> </td>
|
|
<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>
|
|
<h2 class="section">9.1 Plugins</h2>
|
|
|
|
<p>You can use the example in ‘<tt>plugins/</tt>’ to develop dynamically
|
|
linked qemacs plugins (aka modules).
|
|
</p>
|
|
<p>Plugins can add any dynamic resource qemacs supports (modes, key
|
|
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>
|
|
<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>
|
|
|
|
<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"> [ << ] </td>
|
|
<td align="center">FastBack</td>
|
|
<td>Beginning of this chapter or previous chapter</td>
|
|
<td>1</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"> [ < ] </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>
|
|
<tr>
|
|
<td align="center"> [ > ] </td>
|
|
<td align="center">Forward</td>
|
|
<td>Next section in reading order</td>
|
|
<td>1.2.4</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"> [ >> ] </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> </td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"> [Contents] </td>
|
|
<td align="center">Contents</td>
|
|
<td>Table of contents</td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"> [Index] </td>
|
|
<td align="center">Index</td>
|
|
<td>Index</td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"> [ ? ] </td>
|
|
<td align="center">About</td>
|
|
<td>About (help)</td>
|
|
<td> </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
|
|
<strong><== 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>
|
|
|
|
<hr>
|
|
<p>
|
|
<font size="-1">
|
|
|
|
</font>
|
|
<br>
|
|
|
|
</p>
|
|
</body>
|
|
</html>
|