PageRenderTime 305ms CodeModel.GetById 289ms app.highlight 10ms RepoModel.GetById 0ms app.codeStats 1ms

/jEdit/tags/jedit-4-2-pre4/doc/users-guide/files.xml

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