PageRenderTime 116ms CodeModel.GetById 85ms app.highlight 15ms RepoModel.GetById 1ms app.codeStats 0ms

/jEdit/tags/jedit-4-1-pre5/doc/users-guide/files.xml

#
XML | 564 lines | 561 code | 1 blank | 2 comment | 0 complexity | 235aff6b823d5ff9b00fc119e2da411e MD5 | raw file
  1<!-- jEdit buffer-local properties: -->
  2<!-- :tabSize=1:indentSize=1:noTabs=true: -->
  3
  4<chapter id="files"><title>Working With Files</title>
  5 <sect1 id="creating"><title>Creating New Files</title>
  6  <para>
  7   <guimenu>File</guimenu>&gt;<guimenuitem>New</guimenuitem> (shortcut:
  8   <keycombo><keycap>Control</keycap><keycap>N</keycap></keycombo>) opens a new
  9   untitled buffer. When it is saved, a file will be created on disk.
 10   Another way to create a new file is to specify a non-existent file
 11   name when starting jEdit from your operating system's command line.
 12  </para>
 13 </sect1>
 14 <sect1 id="opening"><title>Opening Files</title>
 15  <para>
 16   <guimenu>File</guimenu>&gt;<guimenuitem>Open</guimenuitem> (shortcut:
 17   <keycombo><keycap>Control</keycap><keycap>O</keycap></keycombo>) displays
 18   a file selector dialog box and loads the specified file into a new
 19   buffer. Multiple files can be opened at once by holding down
 20   <keycap>Control</keycap> while clicking on them in the file system browser.
 21   The file selector dialog box also supports auto-completion; when you begin
 22   typing a the name of an existing file in the file name field, jEdit will
 23   attempt to complete it; if the suggested completion is wrong, either select
 24   an alternative with the arrow keys or keep typing.
 25  </para>
 26  <para>
 27   Files that you do not have write access to are opened in read-only
 28   mode, and editing will not be permitted.
 29  </para>
 30  <para>
 31   <guimenu>File</guimenu>&gt;<guimenuitem>Insert</guimenuitem> displays
 32   a file selector dialog box and inserts the specified file into the current
 33   buffer.
 34  </para>
 35  <para>
 36   The <guimenu>File</guimenu>&gt;<guimenuitem>Recent Files</guimenuitem> menu
 37   lists recent files. When a recent file is opened, the caret
 38   is automatically moved to its previous location in that file.
 39   The number of recent files to remember can be changed and caret
 40   position saving can be disabled in the <guibutton>General</guibutton> pane of
 41   the <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
 42   dialog box; see <xref linkend="global-opts" />.
 43  </para>
 44  <para>
 45   The <guimenu>Utilities</guimenu>&gt;<guimenuitem>Current Directory</guimenuitem>
 46   menu lists all files and directories in the current buffer's directory.
 47   Selecting a file opens it in a buffer for editing; selecting a directory
 48   opens it in the file system browser (see <xref linkend="vfs-browser" />).
 49  </para>
 50  <tip>
 51   <para>
 52    jEdit supports transparent editing of GZipped files; if a file begins with
 53    the GZip <quote>magic number</quote>, it is automatically decompressed
 54    before loading and compressed when saving. To compress an existing file,
 55    you need to change a setting in the
 56    <guimenu>Utilities</guimenu>&gt;<guimenuitem>Buffer Options</guimenuitem>
 57    dialog box; see <xref linkend="buffer-opts"/> for details.
 58   </para>
 59  </tip>
 60 </sect1>
 61 <sect1 id="saving"><title>Saving Files</title>
 62  <para>
 63   Changed made to a buffer do not affect the file on disk until the
 64   buffer is <firstterm>saved</firstterm>.
 65  </para>
 66  <para>
 67   <guimenu>File</guimenu>&gt;<guimenuitem>Save</guimenuitem> (shortcut:
 68   <keycombo><keycap>Control</keycap><keycap>S</keycap></keycombo>)
 69   saves the current buffer to disk.
 70  </para>
 71  <para>
 72   <guimenu>File</guimenu>&gt;<guimenuitem>Save All</guimenuitem>
 73   (shortcut: <keycombo><keycap>Control</keycap><keycap>E</keycap></keycombo>
 74   <keycombo><keycap>Control</keycap><keycap>S</keycap></keycombo>) saves all
 75   open buffers to disk, asking for confirmation first.
 76  </para>
 77  <para>
 78   <guimenu>File</guimenu>&gt;<guimenuitem>Save As</guimenuitem> saves the
 79   buffer to a different specified file on disk. The buffer is then
 80   renamed, and subsequent saves also save to the specified file. Note that
 81   using this command to save over an already open buffer will close that
 82   buffer, to avoid having two buffers open with the same path name.
 83  </para>
 84  <para>
 85   <guimenu>File</guimenu>&gt;<guimenuitem>Save a Copy As</guimenuitem> saves
 86   the buffer to a different specified file on disk, but doesn't rename the
 87   buffer, and doesn't clear the <quote>modified</quote> flag. Note that using
 88   this command to save over an already open buffer will automatically reload
 89   that buffer.
 90  </para>
 91  <sidebar><title>How files are saved</title>
 92   <para>
 93    To prevent data loss in the unlikely case that jEdit should crash in the
 94    middle of saving a file, files are first saved to
 95    <filename>#<replaceable>filename</replaceable>#save#</filename>. If this
 96    operation is successful, the original file is replaced with the temporary
 97    file.
 98   </para>
 99   <para>
100    However, in some situations, this behavior is undesirable. For example,
101    on Unix saving files this way will result in the owner and group of the
102    file being reset. If this bothers you, you can disable this so-called
103    <quote>two-stage save</quote> in the <guibutton>Loading and Saving</guibutton>
104    pane of the
105    <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
106    dialog box.
107   </para>
108  </sidebar>
109  <sect2><title>Autosave and Crash Recovery</title>
110   <para>
111    The autosave feature protects your work from computer crashes and
112    such. Every 30 seconds, all buffers with unsaved changes are
113    written out to their respective file names, enclosed in hash
114    (<quote>#</quote>) characters. For example, <filename>program.c</filename>
115    will be autosaved to <filename>#program.c#</filename>.
116   </para>
117   <para>
118    Saving a buffer using
119    one of the commands in the previous section automatically deletes the
120    autosave file, so they will only ever be visible in the unlikely
121    event of a jEdit (or operating system) crash.
122   </para>
123   <para>
124    If an autosave file is
125    found while a buffer is being loaded, jEdit will offer to recover the
126    autosaved data.
127   </para>
128   <para>
129    The autosave feature can be configured
130    in the <guibutton>Loading and Saving</guibutton> pane of the
131    <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
132    dialog box; see <xref linkend="global-opts" />.
133   </para>
134  </sect2>
135  <sect2><title>Backups</title>
136   <para>
137    The backup feature can be used to roll back to the previous version
138    of a file after changes were made. When a buffer is saved
139    for the first time after being opened, its original contents are
140    <quote>backed up</quote> under a different file name.
141   </para>
142   <para>
143    The default behavior is to back up the original contents
144    to the buffer's file name suffixed with a tilde (<quote>~</quote>).
145    For example, <filename>paper.tex</filename> will be backed up to
146    <filename>paper.tex~</filename>.
147   </para>
148   <para>
149    The backup feature can also be configured in
150    the <guibutton>Loading and Saving</guibutton> pane of the
151    <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
152    dialog box. It can be customized to do any of the following:
153   </para>
154   <itemizedlist>
155    <listitem><para>
156     Save numbered backups, named
157     <filename><replaceable>filename</replaceable>~<replaceable>number</replaceable>~</filename>
158    </para></listitem>
159    <listitem><para>
160     Add a prefix to the backed-up file name
161    </para></listitem>
162    <listitem><para>
163     Adds a suffix to the backed-up file name (the default is <quote>~</quote>)
164    </para></listitem>
165    <listitem><para>
166     Backups can optionally be saved in a specified backup directory, instead of
167     the directory of the original file. This can reduce clutter
168    </para></listitem>
169    <listitem><para>
170     Backups can also optionally be created every time a buffer is saved;
171     as mentioned above, the default is to only create a backup the first
172     time a buffer is saved after being opened.
173    </para></listitem>
174   </itemizedlist>
175  </sect2>
176 </sect1>
177 <sect1 id="line-separators"><title>Line Separators</title>
178  <para>
179   The three major operating systems use different conventions to mark
180   line endings in text files.
181   The MacOS uses Carriage-Return characters (<literal>\r</literal> in
182   Java-speak) for that purpose. Unix
183   uses Newline characters (<literal>\n</literal>). Windows uses both
184   (<literal>\r\n</literal>). jEdit can read and write files in all three formats.
185  </para>
186  <para>
187   When loading a file, the line separator used within is automatically
188   detected, and will be used when saving a file back to disk. The line
189   separator used when saving the current buffer can be changed in the
190   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Buffer
191   Options</guimenuitem> dialog box; see <xref linkend="buffer-opts" />.
192  </para>
193  <para>
194   By default, new files are saved with your operating system's native line
195   separator. This can be changed in the
196   <guibutton>Loading and Saving</guibutton> pane of the
197   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
198   dialog box; see <xref linkend="global-opts" />. Note that changing this
199   setting has no effect on existing files.
200  </para>
201 </sect1>
202 <sect1 id="encodings"><title>Character Encodings</title>
203  <para>
204   If you edit files in different human languages, you will most likely be
205   familiar with the concept of a <quote>character encoding</quote>. The gist
206   of the idea is that there are several ways to store a particular character
207   on disk. The current buffer's encoding is shown in the status
208   bar.
209  </para>
210  <para>
211   jEdit can use any
212   encoding supported by the Java platform.
213   The default encoding, used to load and save files for which no
214   other encoding is specified, can be set in the <guibutton>Loading and
215   Saving</guibutton> pane of the
216   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
217   dialog box; see <xref linkend="global-opts" />. The setting is presented as
218   an editable combo box; the combo box
219   contains a few of the more frequently used encodings, but the Java platform
220   defines practically hundreds more you can use.
221  </para>
222  <para>
223   Unfortunately, there
224   is no way to obtain a list of all supported encodings in Java, and the
225   set is constantly changing with each Java version. So to play it safe, jEdit
226   has a few pre-defined defaults, but allows you to use any other supported
227   encoding, assuming you know its name.
228  </para>
229  <para>
230   Unless you change the default encoding, jEdit will use your operating
231   system's native default; <literal>MacRoman</literal> on the MacOS,
232   <literal>Cp1252</literal> on Windows, and <literal>8859_1</literal> on
233   Unix.
234  </para>
235  <para>
236   To open a file stored in an encoding other than the default, select the
237   encoding from the
238   <guimenu>Commands</guimenu>&gt;<guisubmenu>Encoding</guisubmenu> menu of
239   the open file dialog box or file system browser window, then open the file.
240  </para>
241  <para>
242   The encoding to use when saving an open file
243   can be set in the <guimenu>Utilities</guimenu>&gt;<guimenuitem>Buffer
244   Options</guimenuitem> dialog box.
245  </para>
246  <para>
247   If a file is opened
248   without an explicit encoding specified and it appears in the recent file list,
249   jEdit will use the encoding last used
250   when working with that file; otherwise the default encoding will be used.
251  </para>
252  <sect2><title>Commonly Used Encodings</title>
253   <para>
254    The most frequently-used character encoding is ASCII, or <quote>American 
255    Standard Code for Information Interchange</quote>. ASCII encodes Latin
256    letters used in English, in addition to numbers and a range of punctuation
257    characters.
258    The ASCII character set consists of 127 characters, and it is unsuitable
259    for anything but English text (and other file types which only use English
260    characters, like most program source). jEdit will load and save files as
261    ASCII if the <literal>ASCII</literal> encoding is used.
262   </para>
263   <para>
264    Because ASCII is unsuitable for international use, most operating
265    systems use an 8-bit extension of ASCII, with the first 127 characters
266    remaining the same, and the rest used to encode accents, umlauts, and
267    various less frequently used typographical marks. Unfortunately, the three
268    major
269    operating systems all extend ASCII in a different way. Files written by
270    Macintosh programs can be read using the <literal>MacRoman</literal>
271    encoding; Windows text files are usually stored as
272    <literal>Cp1252</literal>. In the Unix world, the <literal>8859_1</literal>
273    (otherwise known as <literal>Latin1</literal>) character encoding has found
274    widespread usage.
275   </para>
276   <para>
277    Windows users are accustomed to dealing with files in a wide range of
278    character sets, known as <firstterm>code pages</firstterm>. Java supports a
279    large number of code pages; the encoding name consists of the text
280    <quote>Cp</quote>, followed by a number.
281   </para>
282   <para>
283    Raw Unicode files are quite rare, but can be read and written with the
284    <literal>Unicode</literal> encoding.
285    One reason raw Unicode has not found widespread usage for storing files on
286    disk is that each character takes up 16 bits. Most other character sets
287    devote 8 bits per character, which saves space. The <literal>UTF8</literal>
288    encoding encodes frequently-used Unicode characters as 8 bits, with
289    less-frequent ones stretching up to 24 bits. This saves space but allows the
290    full range of Unicode characters to be represented.
291   </para>
292   <para>
293    Many common cross-platform international character sets are supported;
294    <literal>KOI8_R</literal> for Russian text, <literal>Big5</literal> and
295    <literal>GBK</literal> for Chinese, and <literal>SJIS</literal> for
296    Japanese.
297   </para>
298  </sect2>
299 </sect1>
300 <sect1 id="vfs-browser"><title>The File System Browser</title>
301  <para>
302   <guimenu>Utilities</guimenu>&gt;<guimenuitem>File System
303   Browser</guimenuitem> displays a file system browser.
304   By default, the file system browser is shown in a floating window;
305   it can be set to dock into the view in the <guibutton>Docking</guibutton>
306   pane of the <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global
307   Options</guimenuitem> dialog box; see <xref linkend="docking" />.
308  </para>
309  <para>
310   The file system browser can be customized in the
311   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
312   dialog box.
313  </para>
314  <sect2><title>Navigating the File System</title>
315   <para>
316    The directory to browse is specified in the <guibutton>Path</guibutton> text
317    field. Clicking the mouse in the text field automatically selects its
318    contents allowing a new path to be quickly typed in. If a relative path is
319    entered, it will be resolved relative to the current path. This text field
320    remembers previously entered strings; see <xref linkend="history" />.
321    Previously browsed directories are also listed in the
322    <guimenu>Utilities</guimenu>&gt;<guisubmenu>Recent Directories</guisubmenu>
323    menu; selecting one opens it in the file system browser.
324   </para>
325   <para>
326    To browse higher up in the directory hierarchy, click one of the parent
327    directories in the parent directory list.
328   </para>
329   <para>
330    Files and directories in the file list are shown in different colors
331    depending on what glob patterns their names match. The patterns and colors
332    can be customized in the
333    <guibutton>File System Browser</guibutton>&gt;<guibutton>Colors</guibutton>
334    pane of the
335    <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
336    dialog box.
337   </para>
338   <para>
339    To browse a listed directory, double-click it (or if you have a three-button
340    mouse, you can click the middle mouse button as well). Alternatively, click
341    the disclosure
342    widget next to a directory to list its contents in place.
343   </para>
344   <para>
345    Open files in the file list are shown with their file names underlined.
346    Single-clicking an open file will select the appropriate buffer in the current
347    view. Unopened files can be opened for editing by double-clicking (or by
348    clicking the middle mouse button). If you hold down <keycap>Shift</keycap>
349    while double-clicking (or middle-clicking), the file will be opened in a new
350    view.
351   </para>
352   <para>
353    Clicking a file or directory with the right mouse button displays a popup
354    menu containing file manipulation commands. Note that attempting to delete
355    a directory containing files will give an error;
356    only empty directories can be deleted.
357   </para>
358   <para>
359    If you only want to see a specific set of files (for example,
360    those whose names end with <filename>.java</filename>), enter a glob pattern
361    in the <guibutton>Filter</guibutton> text field.
362    See <xref linkend="globs" /> for information about glob patterns.
363    This text fields remembers previously entered strings;
364    see <xref linkend="history" />.
365   </para>
366   <tip>
367    <para>
368     The file list sorting algorithm used in jEdit handles numbers in file names
369     in an intelligent manner. For example, a file named
370     <filename>section10.xml</filename> will be placed after a file named
371     <filename>section5.xml</filename>. A conventional letter-by-letter
372     sort would have placed these two files in the wrong order.
373    </para>
374   </tip>
375  </sect2>
376  <sect2><title>The Tool Bar</title>
377   <para>
378    The file system browser has a tool bar containing a number of icons.
379    These buttons correspond to the items in the <guibutton>Commands</guibutton>
380    menu described below; the only menu item that does not have a corresponding
381    tool bar button is <guimenuitem>Show Hidden Files</guimenuitem>.
382   </para>
383  </sect2>
384  <sect2><title>The Commands Menu</title>
385   <para>
386    Clicking the <guibutton>Commands</guibutton> button displays a menu
387    containing the following items:
388   </para>
389   <itemizedlist>
390    <listitem><para><guimenuitem>Parent Directory</guimenuitem> - moves up in
391    the directory hierarchy.</para></listitem>
392    <listitem><para><guimenuitem>Reload Directory</guimenuitem> - reloads the
393    file list from disk.</para></listitem>
394    <listitem><para><guimenuitem>Local Drives</guimenuitem> - displays all
395    local drives. On Windows, this will be a list of
396    drive letters; on Unix, the list will only contain one entry, the
397    root directory.</para></listitem>
398    <listitem><para><guimenuitem>Home Directory</guimenuitem> - displays your
399    home directory.</para></listitem>
400    <listitem><para><guimenuitem>Directory of Current Buffer - displays the
401    directory containing the currently active buffer.</guimenuitem></para></listitem>
402    <listitem><para><guimenuitem>New File</guimenuitem> - opens an
403    <filename>Untitled</filename> file in the current directory. The file will
404    not actually be created on disk until it is saved.</para></listitem>
405    <listitem><para><guimenuitem>New Directory</guimenuitem> - creates a new
406    directory after prompting for the desired name.</para></listitem>
407    <listitem><para><guimenuitem>Search in Directory</guimenuitem> -
408    displays the
409    search and
410    replace dialog box for searching in all files in the current directory. If a
411    file is selected, its extension becomes the file name filter for the search;
412    otherwise, the file name filter entered in the browser is used.
413    See <xref linkend="search-replace" /> for details.</para></listitem>
414    <listitem><para><guimenuitem>Show Hidden Files</guimenuitem> - toggles if
415    hidden files are to be shown in the file list.</para></listitem>
416   </itemizedlist>
417  </sect2>
418  <sect2><title>The Plugins Menu</title>
419   <para>
420    Clicking the <guibutton>Plugins</guibutton> button displays a menu
421    containing commands for browsing plugin file systems. For information
422    about plugins, see <xref linkend="using-plugins" />.
423   </para>
424  </sect2>
425  <sect2><title>The Favorites Menu</title>
426   <para>
427    Clicking the <guibutton>Favorites</guibutton> button displays a menu
428    showing all directories in the favorites list, along with an
429    <guimenuitem>Add to Favorites</guimenuitem> command that adds the current
430    directory to the favorites, and an <guimenuitem>Edit Favorites</guimenuitem>
431    command that shows the favorites list in the file system view, allowing items
432    to be removed by right-clicking on them and selecting
433    <guimenuitem>Delete</guimenuitem> from the resulting popup menu.
434   </para>
435  </sect2>
436  <sect2><title>Keyboard Shortcuts</title>
437   <para>
438    The file system browser can be navigated from the keyboard:
439   </para>
440   <itemizedlist>
441    <listitem><para><keycap>Enter</keycap> - opens the currently selected file or
442    directory.</para></listitem>
443    <listitem><para><keycap>Left</keycap> - goes to the current directory's parent.
444    </para></listitem>
445    <listitem><para><keycap>Up</keycap> - selects previous file in list.
446    </para></listitem>
447    <listitem><para><keycap>Down</keycap> - selects next file in list.
448    </para></listitem>
449    <listitem><para><keycap>/</keycap> - displays all
450    local drives.</para></listitem>
451    <listitem><para><keycap>~</keycap> - displays your home directory.
452    </para></listitem>
453    <listitem><para><keycap>-</keycap> - displays the directory containing
454    the current buffer.</para></listitem>
455    <listitem><para>Typing the first few characters of
456    a file's name will select that file.
457    </para></listitem>
458   </itemizedlist>
459   <para>
460    The file system view, and not the <guibutton>Path</guibutton> or
461    <guibutton>Filter</guibutton> text fields must have keyboard focus for these
462    shortcuts to work.
463   </para>
464  </sect2>
465 </sect1>
466 <sect1 id="reloading"><title>Reloading Files</title>
467  <para>
468   If an open buffer is modified on disk by another application, a warning
469   dialog box is displayed, offering to either continue editing
470   (and lose changes made by the other application)
471   or reload the buffer from disk (and lose any unsaved changes in jEdit). This
472   feature can be disabled in the <guibutton>General</guibutton> pane of the
473   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
474   dialog box; see <xref linkend="global-opts" />.
475  </para>
476  <para>
477   <guimenu>File</guimenu>&gt;<guimenuitem>Reload</guimenuitem> can be used to
478   reload the current buffer from disk at any other
479   time; a confirmation dialog box will be displayed first if the buffer
480   has unsaved changes.
481  </para>
482  <para>
483   <guimenu>File</guimenu>&gt;<guimenuitem>Reload All</guimenuitem>
484   discards unsaved changes in all open buffers and reload them from disk,
485   asking for confirmation first.
486  </para>
487 </sect1>
488 <sect1 id="threaded-io"><title>Multi-Threaded I/O</title>
489  <para>
490   To improve responsiveness and perceived performance,
491   jEdit executes all input/output operations asynchronously.
492   While I/O is in progress, the status bar displays the number of
493   remaining I/O operations.
494   The <guimenu>Utilities</guimenu>&gt;<guisubmenu>Troubleshooting</guisubmenu>&gt;<guimenuitem>I/O
495   Progress
496   Monitor</guimenuitem> command displays a window with more detailed status
497   information and progress meters. This window is floating by default, but
498   it can be set to dock into the view in the
499   <guibutton>Docking</guibutton> pane of the
500   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
501   dialog box; see <xref linkend="docking" />. I/O requests can also be aborted in
502   this window, however note that aborting a buffer save can result in data loss.
503  </para>
504  <para>
505   By default, four I/O threads are created, which means that up
506   to four buffers can be loaded or saved simultaneously. The number of
507   threads can be changed in the
508   <guibutton>Loading and Saving</guibutton> pane of the
509   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global Options</guimenuitem>
510   dialog box; see <xref linkend="global-opts" />. Setting the number to zero
511   disables multi-threaded I/O completely; doing this is not recommended.
512  </para>
513 </sect1>
514 <sect1 id="printing"><title>Printing Files</title>
515  <para>
516   <guimenu>File</guimenu>&gt;<guimenuitem>Print</guimenuitem>
517   (shortcut: <keycombo><keycap>Control</keycap><keycap>P</keycap></keycombo>)
518   will print the current buffer. By default, the printed output will have
519   syntax highlighting, and each page will have a header with the file name,
520   and a footer with the current date/time and page number. The appearance of
521   printed output
522   can be customized in the <guibutton>Printing</guibutton> pane of the
523   <guimenu>Utilities</guimenu>&gt;<guimenuitem>Global
524   Options</guimenuitem> dialog box. The following settings can be changed:
525  </para>
526  <itemizedlist>
527   <listitem><para>The font to use when printing</para></listitem>
528   <listitem><para>If a header with the file name should be printed on each
529   page.</para></listitem>
530   <listitem><para>If a footer with the page number and current date should be
531   printed on each page.</para></listitem>
532   <listitem><para>If line numbers should be printed.</para></listitem>
533   <listitem><para>If the output should be colored according to the current
534   mode's syntax highlighting rules (might look bad on gray-scale
535   printers); otherwise, only syntax styles will be applied.</para></listitem>
536   <listitem><para>The tab size to use when printing - this will usually be
537   less than the text area tab size, to conserve space in the printed output.
538   </para></listitem>
539  </itemizedlist>
540 </sect1>
541 <sect1 id="closing-exiting"><title>Closing Files and Exiting jEdit</title>
542  <para>
543   <guimenu>File</guimenu>&gt;<guimenuitem>Close</guimenuitem>
544   (shortcut: <keycombo><keycap>Control</keycap><keycap>W</keycap></keycombo>)
545   closes the current buffer. If it has unsaved changes, jEdit
546   will ask if they should be saved first.
547  </para>
548  <para>
549   <guimenu>File</guimenu>&gt;<guimenuitem>Close All</guimenuitem>
550   (shortcut: <keycombo><keycap>Control</keycap><keycap>E</keycap></keycombo>
551   <keycombo><keycap>Control</keycap><keycap>W</keycap></keycombo>)
552   closes all buffers. If any buffers have unsaved
553   changes, they will be listed in a dialog box where they can be saved
554   or discarded. In the dialog box, multiple buffers to operate on at
555   once can be selected by clicking on them in the list while holding
556   down <keycap>Control</keycap>.
557  </para>
558  <para>
559   <guimenu>File</guimenu>&gt;<guimenuitem>Exit</guimenuitem>
560   (shortcut: <keycombo><keycap>Control</keycap><keycap>Q</keycap></keycombo>)
561   will completely exit jEdit.
562  </para>
563 </sect1>
564</chapter>