Sync to GQview 1.5.9 release.
[geeqie.git] / doc / 4_2_rename.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3 <HEAD>
4         <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
5         <TITLE>Rename - GQview User Manual</TITLE>
6         <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.0  (Linux)">
7         <META NAME="CREATED" CONTENT="20040805;23590500">
8         <META NAME="CHANGED" CONTENT="20041005;1064200">
9 </HEAD>
10 <BODY LANG="en-US" DIR="LTR">
11 <CENTER>
12         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
13                 <COL WIDTH=85*>
14                 <COL WIDTH=85*>
15                 <COL WIDTH=85*>
16                 <THEAD>
17                         <TR VALIGN=TOP>
18                                 <TD WIDTH=33%>
19                                         <P><A HREF="4_1_copy_move.html">Previous</A></P>
20                                 </TD>
21                                 <TD WIDTH=33%>
22                                         <P ALIGN=CENTER>Rename - Image Management</P>
23                                 </TD>
24                                 <TD WIDTH=33%>
25                                         <P ALIGN=RIGHT><A HREF="4_3_delete.html">Next</A></P>
26                                 </TD>
27                         </TR>
28                 </THEAD>
29         </TABLE>
30 </CENTER>
31 <HR>
32 <H1>4.2 Rename</H1>
33 <P>To rename a file in GQview press Control + R, or select Rename
34 from the File menu. Rename is also available in the context menu of
35 all images and files.</P>
36 <P>When renaming a file, a dialog will display allowing entry of the
37 new name for the file. The dialog will be different depending on the
38 number of files selected to be renamed. A simple dialog will appear
39 when renaming a single file, however when renaming multiple files the
40 dialog will include a list of the file to be renamed and additional
41 options.</P>
42 <P><BR><BR>
43 </P>
44 <P><U>Rename single file dialog</U></P>
45 <P STYLE="margin-left: 0.79in">The dialog that appears when renaming
46 a single file includes an image of the file, an entry to type the new
47 name of the file, a Rename button, and a Cancel button. Type the new
48 name into the text entry and press Enter or activate the Rename
49 button to rename the file. Press Escape or activate the Cancel button
50 to close the dialog and abort renaming the file.</P>
51 <P STYLE="margin-left: 0.79in">When renaming a file and the new name
52 already exists on the file system a dialog will appear showing the
53 renamed and existing files. To overwrite the existing file press
54 enter or activate the Overwrite button. Press Escape or activate the
55 Cancel button to close the dialog abort renaming the file.</P>
56 <P STYLE="margin-left: 0.79in"><BR><BR>
57 </P>
58 <P><U>Rename multiple files dialog</U></P>
59 <P STYLE="margin-left: 0.79in">The dialog that appears when renaming
60 multiple files includes the list of files to be renamed, a preview
61 image of the active file, an entry to enter the new file name, an
62 auto rename check box, a Rename button, and a Cancel button.</P>
63 <P STYLE="margin-left: 0.79in"><B>Manually enter new file names:</B>
64 To manually enter the new name of each file, the active file will be
65 displayed in the image preview and it's original name will be
66 displayed above the text entry. To rename the file type the new name
67 and press Enter or activate the Rename button. When a file is
68 successfully renamed it will be removed from the list and the next
69 one will become the active file. After all files have been renamed,
70 the dialog will close.</P>
71 <P STYLE="margin-left: 0.79in">Files do not have to be renamed in the
72 order that they appear in the list, highlighting a name in the list
73 will make it become the active file.</P>
74 <P STYLE="margin-left: 0.79in">When renaming a file and the new name
75 already exists on the file system a dialog will appear showing the
76 renamed and existing files. To overwrite the existing file press
77 enter or activate the Overwrite button. Press Escape or activate the
78 Cancel button to return to the original rename dialog, the file that
79 prompted the overwrite dialog will remain active.</P>
80 <P STYLE="margin-left: 0.79in"><B>Automatic renaming of multiple
81 files:</B> To automatically rename the files in the list, enable the
82 Auto rename check box. The dialog will change to batch mode for
83 numerical naming of files.</P>
84 <P STYLE="margin-left: 0.79in">The file name list will change to
85 include a preview column that will show the resulting name of each
86 file. The text entry will change to three entries; the first
87 represents the text that appears in the new names before the number,
88 the second will be the start number to use when incrementing the file
89 number, and the third represents the text to append to the name after
90 the number. The end text should include the file name extension,
91 therefore batch renaming multiple types of files (those with
92 different extensions) all at once is not recommended.</P>
93 <P STYLE="margin-left: 0.79in">The padding number can be used to
94 change the minimum length of characters to use for the number portion
95 of the new name. When the file number results in fewer characters
96 than the padding size, the result will be padded with leading zeros
97 to fill the remaining space. For example if padding size is 3, a file
98 with the number 24 will appear in the file name as &ldquo;024&rdquo;.</P>
99 <P STYLE="margin-left: 0.79in">The order of the file list can be
100 changed by dragging a name to the desired location within the list.
101 The preview column will update to reflect the new order.</P>
102 <P STYLE="margin-left: 0.79in">When the preview of new names is
103 satisfactory, press Enter or activate the Rename button to rename the
104 files to match the name in the preview column. Press Escape or
105 activate the Cancel button to close the dialog and abort the rename
106 operation.</P>
107 <P STYLE="margin-left: 0.79in">If the resulting new names match any
108 existing files, a warning dialog will notify you. The rename dialog
109 will remain so that you can select a different set of names.</P>
110 <P><BR><BR>
111 </P>
112 <P><BR><BR>
113 </P>
114 <HR>
115 <CENTER>
116         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
117                 <COL WIDTH=85*>
118                 <COL WIDTH=85*>
119                 <COL WIDTH=85*>
120                 <THEAD>
121                         <TR VALIGN=TOP>
122                                 <TD WIDTH=33%>
123                                         <P><A HREF="4_1_copy_move.html">Previous</A></P>
124                                 </TD>
125                                 <TD WIDTH=33%>
126                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
127                                 </TD>
128                                 <TD WIDTH=33%>
129                                         <P ALIGN=RIGHT><A HREF="4_3_delete.html">Next</A></P>
130                                 </TD>
131                         </TR>
132                 </THEAD>
133                 <TBODY>
134                         <TR VALIGN=TOP>
135                                 <TD WIDTH=33%>
136                                         <P><BR>
137                                         </P>
138                                 </TD>
139                                 <TD WIDTH=33%>
140                                         <P ALIGN=CENTER><BR>
141                                         </P>
142                                 </TD>
143                                 <TD WIDTH=33%>
144                                         <P ALIGN=RIGHT>GQview User Manual</P>
145                                 </TD>
146                         </TR>
147                 </TBODY>
148         </TABLE>
149 </CENTER>
150 <P STYLE="margin-bottom: 0in"><BR>
151 </P>
152 </BODY>
153 </HTML>