/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 “<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>