PageRenderTime 269ms CodeModel.GetById 258ms app.highlight 8ms RepoModel.GetById 1ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/users-guide/word-wrap.html

#
HTML | 44 lines | 44 code | 0 blank | 0 comment | 0 complexity | cb51a8eb659be20f55d04fe1400f1b8c MD5 | raw file
 1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Wrapping Long Lines</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="jEdit 4.3 User's Guide"><link rel="up" href="editing.html" title="Chapter 5. Editing Text"><link rel="prev" href="paragraphs.html" title="Working With Paragraphs"><link rel="next" href="scrolling.html" title="Scrolling"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Wrapping Long Lines</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="paragraphs.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Editing Text</th><td width="20%" align="right"> <a accesskey="n" href="scrolling.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="word-wrap"></a>Wrapping Long Lines</h2></div></div></div><p>The <em class="firstterm">word wrap</em> feature splits lines at word
 2        boundaries in order to fit text within a specified wrap margin. A word
 3        boundary, for the purposes of word wrap, means whitespace. Long lines
 4        without whitespace are currently not wrapped by jEdit. The wrap margin
 5        position is indicated in the text are as a faint blue vertical line.
 6        There are two &#8220;<span class="quote">wrap modes</span>&#8221;, &#8220;<span class="quote">soft</span>&#8221; and
 7        &#8220;<span class="quote">hard</span>&#8221;; they are described below. The current wrap mode is
 8        shown in the status bar; see <a class="xref" href="status-bar.html" title="The Status Bar">the section called &#8220;The Status Bar&#8221;</a>. The wrap
 9        mode can be changed in one of the following ways:</p><div class="itemizedlist"><ul type="disc"><li><p>On a global or mode-specific basis in the
10                <span class="guibutton"><strong>Editing</strong></span> pane of the
11                <span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Global
12                Options</strong></span> dialog box. See <a class="xref" href="global-opts.html#editing-pane" title="The Editing Pane">the section called &#8220;The Editing Pane&#8221;</a>.</p></li><li><p>In the current buffer for the duration of the editing
13                session,</p><div class="itemizedlist"><ul type="circle"><li><p>By clicking the status bar indicator.</p></li><li><p>In the
14                        <span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Buffer
15                        Options</strong></span> dialog box. See <a class="xref" href="buffer-opts.html" title="The Buffer Options Dialog Box">the section called &#8220;The Buffer Options Dialog Box&#8221;</a>.</p></li><li><p>From the keyboard, if a keyboard shortcut has been
16                        assigned to the <span class="guimenuitem"><strong>Toggle Word
17                        Wrap</strong></span> command in the
18                        <span class="guibutton"><strong>Shortcuts</strong></span> pane of the
19                        <span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Global
20                        Options</strong></span> dialog box. By default, this
21                        command does not have a keyboard shortcut.</p></li></ul></div></li><li><p>In the current buffer for future editing sessions by
22                placing the following in one of the first or last 10 lines of
23                the buffer, where <em class="replaceable"><code>mode</code></em> is either
24                &#8220;<span class="quote">none</span>&#8221;, &#8220;<span class="quote">soft</span>&#8221; or &#8220;<span class="quote">hard</span>&#8221;,
25                and <em class="replaceable"><code>column</code></em> is the desired wrap
26                margin:</p><pre class="screen">:wrap=<em class="replaceable"><code>mode</code></em>:maxLineLen=<em class="replaceable"><code>column</code></em>:</pre></li></ul></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556732"></a>Soft Wrap</h3></div></div></div><p>In soft wrap mode, lines are automatically wrapped when
27            displayed on screen. Newlines are not inserted at the wrap
28            positions, and the wrapping is automatically updated when text is
29            inserted or removed.</p><p>If the margin is set to 0, then the width of the text area
30            window is used to determine where to wrap lines.</p><p>If end of line markers are enabled in the <span class="guibutton"><strong>Text
31            Area</strong></span> pane of the
32            <span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Global
33            Options</strong></span> dialog box, a colon (&#8220;<span class="quote">:</span>&#8221;) is
34            painted at the end of wrapped lines. See <a class="xref" href="global-opts.html#text-area-pane" title="The Text Area Pane">the section called &#8220;The Text Area Pane&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556779"></a>Hard Wrap</h3></div></div></div><p>In hard wrap mode, inserting text at the end of a line will
35            automatically break the line if it extends beyond the wrap margin.
36            Inserting or removing text in the middle of a line has no effect,
37            however text can be re-wrapped using the
38            <span class="guimenu"><strong>Edit</strong></span>&gt;<span class="guisubmenu"><strong>Text</strong></span>&gt;<span class="guimenuitem"><strong>Format
39            Paragraph</strong></span> command. See <a class="xref" href="paragraphs.html" title="Working With Paragraphs">the section called &#8220;Working With Paragraphs&#8221;</a>.</p><p>Hard wrap is implemented using character offsets, not screen
40            positions, so it might not behave like you expect if a
41            proportional-width font is being used. The text area font can be
42            changed in the <span class="guibutton"><strong>Text Area</strong></span> pane of the
43            <span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Global
44            Options</strong></span> dialog box.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="paragraphs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="editing.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="scrolling.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Working With Paragraphs </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Scrolling</td></tr></table></div></body></html>