/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
Possible License(s): BSD-3-Clause, AGPL-1.0, Apache-2.0, LGPL-2.0, LGPL-3.0, GPL-2.0, CC-BY-SA-3.0, LGPL-2.1, GPL-3.0, MPL-2.0-no-copyleft-exception, IPL-1.0
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 “<span class="quote">wrap modes</span>”, “<span class="quote">soft</span>” and
7 “<span class="quote">hard</span>”; 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 “The Status Bar”</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>><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 “The Editing Pane”</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>><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 “The Buffer Options Dialog Box”</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>><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 “<span class="quote">none</span>”, “<span class="quote">soft</span>” or “<span class="quote">hard</span>”,
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>><span class="guimenuitem"><strong>Global
33 Options</strong></span> dialog box, a colon (“<span class="quote">:</span>”) 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 “The Text Area Pane”</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>><span class="guisubmenu"><strong>Text</strong></span>><span class="guimenuitem"><strong>Format
39 Paragraph</strong></span> command. See <a class="xref" href="paragraphs.html" title="Working With Paragraphs">the section called “Working With Paragraphs”</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>><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>