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