diff options
| author | Karoly Lorentey | 2006-02-16 16:18:54 +0000 |
|---|---|---|
| committer | Karoly Lorentey | 2006-02-16 16:18:54 +0000 |
| commit | 322c30faa92c5ba2accc1027893a7cc24abbde72 (patch) | |
| tree | 235c1de5e7e7b71c470b326e9480e3476c483050 /man | |
| parent | 6213d5b33cfae99e350488ab96bfd9704e0ff834 (diff) | |
| parent | b51897597a6ab40a4772d70a23421e66b3eb5048 (diff) | |
| download | emacs-322c30faa92c5ba2accc1027893a7cc24abbde72.tar.gz emacs-322c30faa92c5ba2accc1027893a7cc24abbde72.zip | |
Merged from
Patches applied:
* emacs@sv.gnu.org/emacs--devo--0--patch-73
Merge from erc--emacs--0
* emacs@sv.gnu.org/emacs--devo--0--patch-74
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-75
Make ERC comply with the new copyright year guidelines.
* emacs@sv.gnu.org/emacs--devo--0--patch-76
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-77
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-78
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-79
(rcirc-format-response-string): Fix small bugs
* emacs@sv.gnu.org/emacs--devo--0--patch-80
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-81
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-82
Fix compiler error in erc-dcc.el.
* emacs@sv.gnu.org/emacs--devo--0--patch-83
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-84
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-85
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-86
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-87
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-88
Merge from erc--emacs--0
* emacs@sv.gnu.org/emacs--devo--0--patch-89
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-90
Update from CVS
git-archimport-id: lorentey@elte.hu--2004/emacs--multi-tty--0--patch-513
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 60 | ||||
| -rw-r--r-- | man/building.texi | 28 | ||||
| -rw-r--r-- | man/custom.texi | 92 | ||||
| -rw-r--r-- | man/dired.texi | 60 | ||||
| -rw-r--r-- | man/display.texi | 2 | ||||
| -rw-r--r-- | man/faq.texi | 4 | ||||
| -rw-r--r-- | man/files.texi | 2 | ||||
| -rw-r--r-- | man/frames.texi | 2 | ||||
| -rw-r--r-- | man/glossary.texi | 2 | ||||
| -rw-r--r-- | man/maintaining.texi | 14 | ||||
| -rw-r--r-- | man/programs.texi | 19 | ||||
| -rw-r--r-- | man/text.texi | 11 | ||||
| -rw-r--r-- | man/xresources.texi | 3 |
13 files changed, 199 insertions, 100 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index fa6e236959f..0d22e6d17bc 100644 --- a/man/ChangeLog +++ b/man/ChangeLog | |||
| @@ -1,3 +1,63 @@ | |||
| 1 | 2006-02-15 Francesco Potort,Al(B <pot@gnu.org> | ||
| 2 | |||
| 3 | * maintaining.texi (Create Tags Table): Explain why the | ||
| 4 | exception when etags writes to files under the /dev tree. | ||
| 5 | |||
| 6 | 2006-02-14 Richard M. Stallman <rms@gnu.org> | ||
| 7 | |||
| 8 | * custom.texi (Safe File Variables): Lots of clarification. | ||
| 9 | Renamed from Unsafe File Variables. | ||
| 10 | |||
| 11 | 2006-02-14 Chong Yidong <cyd@stupidchicken.com> | ||
| 12 | |||
| 13 | * custom.texi (Unsafe File Variables): File variable confirmation | ||
| 14 | assumed denied in batch mode. | ||
| 15 | |||
| 16 | 2006-02-14 Richard M. Stallman <rms@gnu.org> | ||
| 17 | |||
| 18 | * building.texi (GDB User Interface Layout): Don't say `inferior' | ||
| 19 | for program being debugged. | ||
| 20 | |||
| 21 | 2006-02-15 Nick Roberts <nickrob@snap.net.nz> | ||
| 22 | |||
| 23 | * building.texi (GDB Graphical Interface): Replace | ||
| 24 | gdb-use-inferior-io-buffer with gdb-use-separate-io-buffer. | ||
| 25 | |||
| 26 | 2006-02-13 Chong Yidong <cyd@stupidchicken.com> | ||
| 27 | |||
| 28 | * custom.texi (Specifying File Variables, Unsafe File Variables): | ||
| 29 | New nodes, split from File Variables. Document new file local | ||
| 30 | variable behavior. | ||
| 31 | |||
| 32 | 2006-02-13 YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp> | ||
| 33 | |||
| 34 | * display.texi (Standard Faces): | ||
| 35 | * faq.texi (Colors on a TTY): | ||
| 36 | * files.texi (Visiting): | ||
| 37 | * frames.texi (Clipboard): | ||
| 38 | * glossary.texi (Glossary) <Clipboard>: | ||
| 39 | * xresources.texi (X Resources): Mention Mac OS port. | ||
| 40 | |||
| 41 | 2006-02-12 Karl Berry <karl@gnu.org> | ||
| 42 | |||
| 43 | * faq.texi (Emacs for Atari ST): use Sch@"auble instead of the | ||
| 44 | 8-bit accented a. | ||
| 45 | |||
| 46 | 2006-02-12 Richard M. Stallman <rms@gnu.org> | ||
| 47 | |||
| 48 | * building.texi (Building): Clarify topic in intro. | ||
| 49 | |||
| 50 | * maintaining.texi (Maintaining): Change title; clarify topic. | ||
| 51 | Delete duplicate index entries. | ||
| 52 | |||
| 53 | * building.texi (Other GDB User Interface Buffers): Clarifications. | ||
| 54 | |||
| 55 | * text.texi (Cell Commands): Clarifications. | ||
| 56 | |||
| 57 | * programs.texi (Defuns): Delete duplicate explanation of | ||
| 58 | left-margin paren convention. | ||
| 59 | (Hungry Delete): Minor cleanup. | ||
| 60 | |||
| 1 | 2006-02-11 Mathias Dahl <mathias.dahl@gmail.com> | 61 | 2006-02-11 Mathias Dahl <mathias.dahl@gmail.com> |
| 2 | 62 | ||
| 3 | * dired.texi (Tumme): More tumme documentation. | 63 | * dired.texi (Tumme): More tumme documentation. |
diff --git a/man/building.texi b/man/building.texi index e3e3b5ac5a2..497c2777a5a 100644 --- a/man/building.texi +++ b/man/building.texi | |||
| @@ -10,7 +10,7 @@ | |||
| 10 | 10 | ||
| 11 | The previous chapter discusses the Emacs commands that are useful for | 11 | The previous chapter discusses the Emacs commands that are useful for |
| 12 | making changes in programs. This chapter deals with commands that assist | 12 | making changes in programs. This chapter deals with commands that assist |
| 13 | in the larger process of developing and maintaining programs. | 13 | in the larger process of compiling and testing programs. |
| 14 | 14 | ||
| 15 | @menu | 15 | @menu |
| 16 | * Compilation:: Compiling programs in languages other | 16 | * Compilation:: Compiling programs in languages other |
| @@ -828,20 +828,20 @@ displays the following frame layout: | |||
| 828 | @example | 828 | @example |
| 829 | +--------------------------------+--------------------------------+ | 829 | +--------------------------------+--------------------------------+ |
| 830 | | | | | 830 | | | | |
| 831 | | GUD buffer (I/O of GDB) | Locals buffer | | 831 | | GUD buffer (I/O of GDB) | Locals buffer | |
| 832 | | | | | 832 | | | | |
| 833 | |--------------------------------+--------------------------------+ | 833 | |--------------------------------+--------------------------------+ |
| 834 | | | | | 834 | | | | |
| 835 | | Source buffer | I/O buffer (of inferior) | | 835 | | Source buffer | I/O buffer for debugged pgm | |
| 836 | | | | | 836 | | | | |
| 837 | |--------------------------------+--------------------------------+ | 837 | |--------------------------------+--------------------------------+ |
| 838 | | | | | 838 | | | | |
| 839 | | Stack buffer | Breakpoints buffer | | 839 | | Stack buffer | Breakpoints buffer | |
| 840 | | | | | 840 | | | | |
| 841 | +--------------------------------+--------------------------------+ | 841 | +--------------------------------+--------------------------------+ |
| 842 | @end example | 842 | @end example |
| 843 | 843 | ||
| 844 | However, if @code{gdb-use-inferior-io-buffer} is @code{nil}, the I/O | 844 | However, if @code{gdb-use-separate-io-buffer} is @code{nil}, the I/O |
| 845 | buffer does not appear and the source buffer occupies the full width | 845 | buffer does not appear and the source buffer occupies the full width |
| 846 | of the frame. | 846 | of the frame. |
| 847 | 847 | ||
| @@ -972,15 +972,17 @@ for variables defined in compound statements, the default value is | |||
| 972 | 972 | ||
| 973 | @table @asis | 973 | @table @asis |
| 974 | @item Input/Output Buffer | 974 | @item Input/Output Buffer |
| 975 | @vindex gdb-use-inferior-io-buffer | 975 | @vindex gdb-use-separate-io-buffer |
| 976 | If the variable @code{gdb-use-inferior-io-buffer} is non-@code{nil}, | 976 | If the variable @code{gdb-use-separate-io-buffer} is non-@code{nil}, |
| 977 | the executable program that is being debugged takes its input and | 977 | the executable program that is being debugged takes its input and |
| 978 | displays its output here. Otherwise it uses the GUD buffer for that. | 978 | displays its output here. Otherwise it uses the GUD buffer for that. |
| 979 | To toggle the use of this buffer, do @kbd{M-x | 979 | To toggle whether GUD mode uses this buffer, do @kbd{M-x |
| 980 | gdb-use-inferior-io-buffer}. | 980 | gdb-use-separate-io-buffer}. That takes effect when you next |
| 981 | restart the program you are debugging. | ||
| 981 | 982 | ||
| 982 | Some of the commands from shell mode are available here. @xref{Shell | 983 | The history and replay commands from Shell mode are available here, |
| 983 | Mode}. | 984 | as are the commands to send signals to the program you are debugging. |
| 985 | @xref{Shell Mode}. | ||
| 984 | 986 | ||
| 985 | @item Locals Buffer | 987 | @item Locals Buffer |
| 986 | The locals buffer displays the values of local variables of the | 988 | The locals buffer displays the values of local variables of the |
| @@ -990,8 +992,8 @@ Information on a frame, gdb, The GNU debugger}). | |||
| 990 | Arrays and structures display their type only. With GDB 6.4 or later, | 992 | Arrays and structures display their type only. With GDB 6.4 or later, |
| 991 | move point to their name and press @key{RET}, or alternatively click | 993 | move point to their name and press @key{RET}, or alternatively click |
| 992 | @kbd{Mouse-2} there, to examine their values. With earlier versions | 994 | @kbd{Mouse-2} there, to examine their values. With earlier versions |
| 993 | of GDB, move point to their type description ([struct/union] or | 995 | of GDB, use @kbd{Mouse-2} or @key{RET} on the type description |
| 994 | [array]). @xref{Watch Expressions}. | 996 | (@samp{[struct/union]} or @samp{[array]}). @xref{Watch Expressions}. |
| 995 | 997 | ||
| 996 | @item Registers Buffer | 998 | @item Registers Buffer |
| 997 | @findex toggle-gdb-all-registers | 999 | @findex toggle-gdb-all-registers |
diff --git a/man/custom.texi b/man/custom.texi index 2efbdd81398..db88f64f839 100644 --- a/man/custom.texi +++ b/man/custom.texi | |||
| @@ -1043,7 +1043,15 @@ file with Emacs. Visiting the file checks for local variable | |||
| 1043 | specifications; it automatically makes these variables local to the | 1043 | specifications; it automatically makes these variables local to the |
| 1044 | buffer, and sets them to the values specified in the file. | 1044 | buffer, and sets them to the values specified in the file. |
| 1045 | 1045 | ||
| 1046 | There are two ways to specify local variable values: in the first | 1046 | @menu |
| 1047 | * Specifying File Variables:: Specifying file local variables. | ||
| 1048 | * Safe File Variables:: Making sure file local variables are safe. | ||
| 1049 | @end menu | ||
| 1050 | |||
| 1051 | @node Specifying File Variables | ||
| 1052 | @subsubsection Specifying File Variables | ||
| 1053 | |||
| 1054 | There are two ways to specify file local variable values: in the first | ||
| 1047 | line, or with a local variables list. Here's how to specify them in the | 1055 | line, or with a local variables list. Here's how to specify them in the |
| 1048 | first line: | 1056 | first line: |
| 1049 | 1057 | ||
| @@ -1089,7 +1097,7 @@ variables list and a @samp{-*-} line, Emacs processes @emph{everything} | |||
| 1089 | in the @samp{-*-} line first, and @emph{everything} in the local | 1097 | in the @samp{-*-} line first, and @emph{everything} in the local |
| 1090 | variables list afterward. | 1098 | variables list afterward. |
| 1091 | 1099 | ||
| 1092 | Here is an example of a local variables list: | 1100 | Here is an example of a local variables list: |
| 1093 | 1101 | ||
| 1094 | @example | 1102 | @example |
| 1095 | ;;; Local Variables: *** | 1103 | ;;; Local Variables: *** |
| @@ -1170,33 +1178,63 @@ list need not take the time to search the whole file. | |||
| 1170 | major mode of a buffer according to the file name and contents, | 1178 | major mode of a buffer according to the file name and contents, |
| 1171 | including the local variables list if any. @xref{Choosing Modes}. | 1179 | including the local variables list if any. @xref{Choosing Modes}. |
| 1172 | 1180 | ||
| 1173 | @findex enable-local-variables | 1181 | @node Safe File Variables |
| 1174 | The variable @code{enable-local-variables} controls whether to process | 1182 | @subsubsection Safety of File Variables |
| 1175 | local variables in files, and thus gives you a chance to override them. | 1183 | |
| 1176 | Its default value is @code{t}, which means do process local variables in | 1184 | File-local variables can be dangerous; when you visit someone else's |
| 1177 | files. If you set the value to @code{nil}, Emacs simply ignores local | 1185 | file, there's no telling what its local variables list could do to |
| 1178 | variables in files. Any other value says to query you about each file | 1186 | your Emacs. Improper values of the @code{eval} ``variable,'' and |
| 1179 | that has local variables, showing you the local variable specifications | 1187 | other variables such as @code{load-path}, could execute Lisp code you |
| 1180 | so you can judge. | 1188 | didn't intend to run. |
| 1181 | 1189 | ||
| 1182 | @findex enable-local-eval | 1190 | Therefore, whenever Emacs encounters file local variable values that |
| 1183 | The @code{eval} ``variable,'' and certain actual variables, create a | 1191 | are not known to be safe, it displays the file's entire local |
| 1184 | special risk; when you visit someone else's file, local variable | 1192 | variables list, and asks you for confirmation before setting them. |
| 1185 | specifications for these could affect your Emacs in arbitrary ways. | 1193 | You can type @kbd{y} or @key{SPC} to put the local variables list into |
| 1186 | Therefore, the variable @code{enable-local-eval} controls whether Emacs | 1194 | effect, or @kbd{n} to ignore it. When Emacs is run in batch mode |
| 1187 | processes @code{eval} variables, as well variables with names that end | 1195 | (@pxref{Initial Options}), it can't really ask you, so it assumes the |
| 1188 | in @samp{-hook}, @samp{-hooks}, @samp{-function} or @samp{-functions}, | 1196 | answer @samp{n}. |
| 1189 | and certain other variables. The three possibilities for the variable's | 1197 | |
| 1190 | value are @code{t}, @code{nil}, and anything else, just as for | 1198 | Emacs normally recognizes certain variables/value pairs as safe. |
| 1191 | @code{enable-local-variables}. The default is @code{maybe}, which is | 1199 | For instance, it is safe to give @code{comment-column} or |
| 1192 | neither @code{t} nor @code{nil}, so normally Emacs does ask for | 1200 | @code{fill-column} any integer value. If a file specifies only safe |
| 1193 | confirmation about file settings for these variables. | 1201 | variable/value pairs, Emacs does not ask for confirmation before |
| 1194 | 1202 | setting them. Otherwise, you can tell Emacs to record that all the | |
| 1195 | @findex safe-local-eval-forms | 1203 | variable/value pairs in the file are safe, by typing @kbd{!} at the |
| 1204 | confirmation prompt. When Emacs encounters these variable/value pairs | ||
| 1205 | subsequently, in the same file or others, it will assume they are | ||
| 1206 | safe. | ||
| 1207 | |||
| 1208 | @vindex safe-local-variable-values | ||
| 1209 | @cindex risky variable | ||
| 1210 | Some variables, such as @code{load-path}, are considered | ||
| 1211 | particularly @dfn{risky}: there is seldom any reason to specify them | ||
| 1212 | as local variables, and changing them can be dangerous. Even if you | ||
| 1213 | enter @kbd{!} at the confirmation prompt, Emacs will not record any | ||
| 1214 | values as safe for these variables. If you really want to record safe | ||
| 1215 | values for these variables, do it directly by customizing | ||
| 1216 | @samp{safe-local-variable-values} (@pxref{Easy Customization}). | ||
| 1217 | |||
| 1218 | @vindex enable-local-variables | ||
| 1219 | The variable @code{enable-local-variables} allows you to change the | ||
| 1220 | way Emacs processes local variables. Its default value is @code{t}, | ||
| 1221 | which specifies the behavior described above. If it is @code{nil}, | ||
| 1222 | Emacs simply ignores all file local variables. Any other value says | ||
| 1223 | to query you about each file that has local variables, without trying | ||
| 1224 | to determine whether the values are known to be safe. | ||
| 1225 | |||
| 1226 | @vindex enable-local-eval | ||
| 1227 | The variable @code{enable-local-eval} controls whether Emacs | ||
| 1228 | processes @code{eval} variables. The three possibilities for the | ||
| 1229 | variable's value are @code{t}, @code{nil}, and anything else, just as | ||
| 1230 | for @code{enable-local-variables}. The default is @code{maybe}, which | ||
| 1231 | is neither @code{t} nor @code{nil}, so normally Emacs does ask for | ||
| 1232 | confirmation about processes @code{eval} variables. | ||
| 1233 | |||
| 1234 | @vindex safe-local-eval-forms | ||
| 1196 | The @code{safe-local-eval-forms} is a customizable list of eval | 1235 | The @code{safe-local-eval-forms} is a customizable list of eval |
| 1197 | forms which are safe to eval, so Emacs should not ask for | 1236 | forms which are safe to eval, so Emacs should not ask for |
| 1198 | confirmation to evaluate these forms, even if | 1237 | confirmation to evaluate these forms. |
| 1199 | @code{enable-local-variables} says to ask for confirmation in general. | ||
| 1200 | 1238 | ||
| 1201 | @node Key Bindings | 1239 | @node Key Bindings |
| 1202 | @section Customizing Key Bindings | 1240 | @section Customizing Key Bindings |
diff --git a/man/dired.texi b/man/dired.texi index d391e4566f1..195a77e0fd3 100644 --- a/man/dired.texi +++ b/man/dired.texi | |||
| @@ -1146,6 +1146,7 @@ C-c}. | |||
| 1146 | @section Thumbnail and image file viewing and manipulation | 1146 | @section Thumbnail and image file viewing and manipulation |
| 1147 | 1147 | ||
| 1148 | @cindex tumme mode | 1148 | @cindex tumme mode |
| 1149 | |||
| 1149 | Tumme provides for simple viewing of thumbnails of image files. It | 1150 | Tumme provides for simple viewing of thumbnails of image files. It |
| 1150 | provides viewing of the original file, sized or in full size, inside | 1151 | provides viewing of the original file, sized or in full size, inside |
| 1151 | Emacs or in an external viewer. | 1152 | Emacs or in an external viewer. |
| @@ -1159,14 +1160,14 @@ files. All images in that directory will get thumbnail files created | |||
| 1159 | for them, and the thumbnails will be displayed in the ``thumbnail | 1160 | for them, and the thumbnails will be displayed in the ``thumbnail |
| 1160 | buffer''. | 1161 | buffer''. |
| 1161 | 1162 | ||
| 1162 | Because thumbnails are created on the fly and before they can be | 1163 | If the directory contains many image files and becayse thumbnails |
| 1163 | displayed, the above command might take a long time, especially the | 1164 | are created on the fly before they can be displayed, the above command |
| 1164 | first time, if the directory contains many image files. If the number | 1165 | might take a long time, especially the first time (consecutive |
| 1165 | of image files is higher than | 1166 | viewings will use the cached thumbnail files). Also, if the number of |
| 1166 | @code{tumme-show-all-from-dir-max-files}, the command will be aborted. | 1167 | image files is higher than @code{tumme-show-all-from-dir-max-files}, |
| 1167 | To work around this you can instead mark the files you want to look | 1168 | the command will be aborted. To work around this you can instead mark |
| 1168 | at, using @kbd{m} as usual in Dired, and then type @kbd{C-t d} | 1169 | the files you want to look at, using @kbd{m} as usual in Dired, and |
| 1169 | (@code{tumme-display-thumbs}). | 1170 | then type @kbd{C-t d} (@code{tumme-display-thumbs}). |
| 1170 | 1171 | ||
| 1171 | Regardless of which command you chose to display the thumbnails, a | 1172 | Regardless of which command you chose to display the thumbnails, a |
| 1172 | new buffer will open up, displaying thumbnail images of the files that | 1173 | new buffer will open up, displaying thumbnail images of the files that |
| @@ -1193,26 +1194,37 @@ for deletion in the dired buffer. If you just want visually to delete | |||
| 1193 | the thumbnail image from the thumbnail buffer, type @kbd{C-d} | 1194 | the thumbnail image from the thumbnail buffer, type @kbd{C-d} |
| 1194 | (@code{tumme-delete-char}). | 1195 | (@code{tumme-delete-char}). |
| 1195 | 1196 | ||
| 1196 | More advanced features include commands for using ``tags'' (another | 1197 | More advanced features include commands for using ``tags''. ``Tag'' |
| 1197 | name for ``keyword'' or ``label'') to tag image files and to search | 1198 | is just another word for ``keyword'', ``label'' or ``category''. In |
| 1198 | for image files with a certain tag. | 1199 | short, it is meta data used to categorize an image file. Commands |
| 1199 | 1200 | exist to add tags for one or many image files from dired, to mark | |
| 1200 | The tags put on image files are stored in a database file and can be | 1201 | files having a certain tag in Dired and to remove tags from files. |
| 1201 | used for marking image files. For example, you can let Tumme mark all | 1202 | The tags put on image files are stored in a database file (currently a |
| 1202 | files in the current directory tagged with the tag `flowers'. To tag | 1203 | plain text file). |
| 1203 | image files, mark them in the dired buffer and type @kbd{C-t t} | 1204 | |
| 1204 | (@code{tumme-tag-files}). To mark files having a certain tag, type | 1205 | To tag image files, mark them in the dired buffer and type @kbd{C-t |
| 1205 | @kbd{C-t f} (@code{tumme-mark-tagged-files}). | 1206 | t} (@code{tumme-tag-files}). You will be prompted for a tag. To mark |
| 1206 | 1207 | files having a certain tag, type @kbd{C-t f} | |
| 1207 | After marking image files with a certain tag, they can be viewed as | 1208 | (@code{tumme-mark-tagged-files}). After marking image files with a |
| 1208 | explained earlier, by typing @key{C-t d}. | 1209 | certain tag, they can be viewed as explained earlier, by typing |
| 1210 | @key{C-t d}. | ||
| 1211 | |||
| 1212 | You can also tag a file from the thumbnail buffer by typing @kbd{t | ||
| 1213 | t} and remove it by typing @kbd{t r}. There is also a special ``tag'' | ||
| 1214 | called ``comment'' for each file (it is not a tag in the exact same | ||
| 1215 | sense as the other tags, it is handled slightly different). That is | ||
| 1216 | used to enter a comment or description about the image. You comment a | ||
| 1217 | file from the thumbnail buffer by typing @kbd{c}. You will be | ||
| 1218 | prompted for a comment. Comments can also be added from Dired, and | ||
| 1219 | then also to multiple files at once, by typing @kbd{C-t c} | ||
| 1220 | (@code{tumme-dired-comment-files}). | ||
| 1209 | 1221 | ||
| 1210 | Tumme also provide simple image manipulation commands, like rotating | 1222 | Tumme also provide simple image manipulation commands, like rotating |
| 1211 | thumbnails and original image files. In the thumbnail buffer, type | 1223 | thumbnails and original image files. In the thumbnail buffer, type |
| 1212 | @kbd{L} to rotate the original image 90 degrees anti clockwise, and | 1224 | @kbd{L} to rotate the original image 90 degrees anti clockwise, and |
| 1213 | @kbd{R} to rotate it 90 degrees clockwise. | 1225 | @kbd{R} to rotate it 90 degrees clockwise. This rotation will be done |
| 1214 | 1226 | lossless (the image quality will not be reduced) and needs an external | |
| 1215 | 1227 | utility called JpegTRAN to work. | |
| 1216 | 1228 | ||
| 1217 | @node Misc Dired Features | 1229 | @node Misc Dired Features |
| 1218 | @section Other Dired Features | 1230 | @section Other Dired Features |
diff --git a/man/display.texi b/man/display.texi index 9c653e2ca56..83b5ae48554 100644 --- a/man/display.texi +++ b/man/display.texi | |||
| @@ -472,7 +472,7 @@ This face determines the colors and font of Emacs's menus. @xref{Menu | |||
| 472 | Bars}. Setting the font of LessTif/Motif menus is currently not | 472 | Bars}. Setting the font of LessTif/Motif menus is currently not |
| 473 | supported; attempts to set the font are ignored in this case. | 473 | supported; attempts to set the font are ignored in this case. |
| 474 | Likewise, attempts to customize this face in Emacs built with GTK and | 474 | Likewise, attempts to customize this face in Emacs built with GTK and |
| 475 | in the MS-Windows port are ignored by the respective GUI toolkits; | 475 | in the MS-Windows/Mac ports are ignored by the respective GUI toolkits; |
| 476 | you need to use system-wide styles and options to change the | 476 | you need to use system-wide styles and options to change the |
| 477 | appearance of the menus. | 477 | appearance of the menus. |
| 478 | @end table | 478 | @end table |
diff --git a/man/faq.texi b/man/faq.texi index 734212758d5..fd69ad663b5 100644 --- a/man/faq.texi +++ b/man/faq.texi | |||
| @@ -1272,7 +1272,7 @@ customize, with completion. | |||
| 1272 | 1272 | ||
| 1273 | In Emacs 21.1 and later, colors and faces are supported in non-windowed mode, | 1273 | In Emacs 21.1 and later, colors and faces are supported in non-windowed mode, |
| 1274 | i.e.@: on Unix and GNU/Linux text-only terminals and consoles, and when | 1274 | i.e.@: on Unix and GNU/Linux text-only terminals and consoles, and when |
| 1275 | invoked as @samp{emacs -nw} on X and MS-Windows. (Colors and faces were | 1275 | invoked as @samp{emacs -nw} on X, MS-Windows, and Mac. (Colors and faces were |
| 1276 | supported in the MS-DOS port since Emacs 19.29.) Emacs automatically | 1276 | supported in the MS-DOS port since Emacs 19.29.) Emacs automatically |
| 1277 | detects color support at startup and uses it if available. If you think | 1277 | detects color support at startup and uses it if available. If you think |
| 1278 | that your terminal supports colors, but Emacs won't use them, check the | 1278 | that your terminal supports colors, but Emacs won't use them, check the |
| @@ -3670,7 +3670,7 @@ for OS/2 users of Emacs can be found at | |||
| 3670 | @cindex Atari ST, Emacs for | 3670 | @cindex Atari ST, Emacs for |
| 3671 | @cindex TOS, Emacs for | 3671 | @cindex TOS, Emacs for |
| 3672 | 3672 | ||
| 3673 | Roland Schäuble reports that Emacs 18.58 running on plain TOS and MiNT | 3673 | Roland Sch@"auble reports that Emacs 18.58 running on plain TOS and MiNT |
| 3674 | is available at | 3674 | is available at |
| 3675 | @uref{ftp://atari.archive.umich.edu/Editors/Emacs-18-58/1858b-d3.zoo}. | 3675 | @uref{ftp://atari.archive.umich.edu/Editors/Emacs-18-58/1858b-d3.zoo}. |
| 3676 | 3676 | ||
diff --git a/man/files.texi b/man/files.texi index 4bafc9b736c..a0822054210 100644 --- a/man/files.texi +++ b/man/files.texi | |||
| @@ -239,7 +239,7 @@ toolkit, commands invoked with the mouse (by clicking on the menu bar | |||
| 239 | or tool bar) use the toolkit's standard File Selection dialog instead | 239 | or tool bar) use the toolkit's standard File Selection dialog instead |
| 240 | of prompting for the file name in the minibuffer. On Unix and | 240 | of prompting for the file name in the minibuffer. On Unix and |
| 241 | GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and | 241 | GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and |
| 242 | Motif toolkits; on MS-Windows, the GUI version does that by default. | 242 | Motif toolkits; on MS-Windows and Mac, the GUI version does that by default. |
| 243 | For information on how to customize this, see @ref{Dialog Boxes}. | 243 | For information on how to customize this, see @ref{Dialog Boxes}. |
| 244 | 244 | ||
| 245 | Secondly, Emacs supports ``drag and drop''; dropping a file into an | 245 | Secondly, Emacs supports ``drag and drop''; dropping a file into an |
diff --git a/man/frames.texi b/man/frames.texi index f25399e071b..b5ec21533b7 100644 --- a/man/frames.texi +++ b/man/frames.texi | |||
| @@ -293,7 +293,7 @@ names, all use the clipboard. | |||
| 293 | the Emacs yank functions consult the clipboard before the primary | 293 | the Emacs yank functions consult the clipboard before the primary |
| 294 | selection, and to make the kill functions to store in the clipboard as | 294 | selection, and to make the kill functions to store in the clipboard as |
| 295 | well as the primary selection. Otherwise they do not access the | 295 | well as the primary selection. Otherwise they do not access the |
| 296 | clipboard at all. Using the clipboard is the default on MS-Windows, | 296 | clipboard at all. Using the clipboard is the default on MS-Windows and Mac, |
| 297 | but not on other systems. | 297 | but not on other systems. |
| 298 | 298 | ||
| 299 | @node Mouse References | 299 | @node Mouse References |
diff --git a/man/glossary.texi b/man/glossary.texi index 9d86a8d12cc..e2d2ad56832 100644 --- a/man/glossary.texi +++ b/man/glossary.texi | |||
| @@ -175,7 +175,7 @@ mouse button and release it without moving the mouse. @xref{Mouse Buttons}. | |||
| 175 | @item Clipboard | 175 | @item Clipboard |
| 176 | A clipboard is a buffer provided by the window system for transferring | 176 | A clipboard is a buffer provided by the window system for transferring |
| 177 | text between applications. On the X Window system, the clipboard is | 177 | text between applications. On the X Window system, the clipboard is |
| 178 | provided in addition to the primary selection (q.v.@:); on MS-Windows, | 178 | provided in addition to the primary selection (q.v.@:); on MS-Windows and Mac, |
| 179 | the clipboard is used @emph{instead} of the primary selection. | 179 | the clipboard is used @emph{instead} of the primary selection. |
| 180 | @xref{Clipboard}. | 180 | @xref{Clipboard}. |
| 181 | 181 | ||
diff --git a/man/maintaining.texi b/man/maintaining.texi index 66a235ae119..9836aae4e83 100644 --- a/man/maintaining.texi +++ b/man/maintaining.texi | |||
| @@ -3,14 +3,11 @@ | |||
| 3 | @c 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc. | 3 | @c 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc. |
| 4 | @c See file emacs.texi for copying conditions. | 4 | @c See file emacs.texi for copying conditions. |
| 5 | @node Maintaining, Abbrevs, Building, Top | 5 | @node Maintaining, Abbrevs, Building, Top |
| 6 | @chapter Maintaining Programs | 6 | @chapter Maintaining Large Programs |
| 7 | @cindex Lisp editing | ||
| 8 | @cindex C editing | ||
| 9 | @cindex program editing | ||
| 10 | 7 | ||
| 11 | This chapter describes Emacs features for maintaining programs. The | 8 | This chapter describes Emacs features for maintaining large |
| 12 | version control features (@pxref{Version Control}) are also particularly | 9 | programs. The version control features (@pxref{Version Control}) are |
| 13 | useful for this purpose. | 10 | also particularly useful for this purpose. |
| 14 | 11 | ||
| 15 | @menu | 12 | @menu |
| 16 | * Change Log:: Maintaining a change history for your program. | 13 | * Change Log:: Maintaining a change history for your program. |
| @@ -407,7 +404,8 @@ directory where the tags file was initially written. This way, you can | |||
| 407 | move an entire directory tree containing both the tags file and the | 404 | move an entire directory tree containing both the tags file and the |
| 408 | source files, and the tags file will still refer correctly to the source | 405 | source files, and the tags file will still refer correctly to the source |
| 409 | files. If the tags file is in @file{/dev}, however, the file names are | 406 | files. If the tags file is in @file{/dev}, however, the file names are |
| 410 | made relative to the current working directory. | 407 | made relative to the current working directory. This is useful, for |
| 408 | example, when writing the tags to @file{/dev/stdout}. | ||
| 411 | 409 | ||
| 412 | If you specify absolute file names as arguments to @code{etags}, then | 410 | If you specify absolute file names as arguments to @code{etags}, then |
| 413 | the tags file will contain absolute file names. This way, the tags file | 411 | the tags file will contain absolute file names. This way, the tags file |
diff --git a/man/programs.texi b/man/programs.texi index 6404e3466bc..643e6445fb0 100644 --- a/man/programs.texi +++ b/man/programs.texi | |||
| @@ -132,19 +132,6 @@ place to set up customizations for that major mode. @xref{Hooks}. | |||
| 132 | something like a function, is called a @dfn{defun}. The name comes | 132 | something like a function, is called a @dfn{defun}. The name comes |
| 133 | from Lisp, but in Emacs we use it for all languages. | 133 | from Lisp, but in Emacs we use it for all languages. |
| 134 | 134 | ||
| 135 | In many programming language modes, Emacs assumes that a defun is | ||
| 136 | any pair of parentheses (or braces, if the language uses braces this | ||
| 137 | way) that starts at the left margin. For example, in C, the body of a | ||
| 138 | function definition is a defun, usually recognized as an open-brace | ||
| 139 | that begins at the left margin@footnote{Alternatively, you can set up | ||
| 140 | C Mode to recognize a defun at an opening brace at the outermost | ||
| 141 | level. @xref{Movement Commands,,, ccmode, the CC Mode Manual}.}. A | ||
| 142 | variable's initializer can also count as a defun, if the open-brace | ||
| 143 | that begins the initializer is at the left margin. | ||
| 144 | |||
| 145 | However, some language modes provide their own code for recognizing | ||
| 146 | defuns in a way that suits the language syntax and conventions better. | ||
| 147 | |||
| 148 | @menu | 135 | @menu |
| 149 | * Left Margin Paren:: An open-paren or similar opening delimiter | 136 | * Left Margin Paren:: An open-paren or similar opening delimiter |
| 150 | starts a defun if it is at the left margin. | 137 | starts a defun if it is at the left margin. |
| @@ -1573,9 +1560,9 @@ following point. | |||
| 1573 | 1560 | ||
| 1574 | As an alternative to the above commands, you can enable @dfn{hungry | 1561 | As an alternative to the above commands, you can enable @dfn{hungry |
| 1575 | delete mode}. When this feature is enabled (indicated by @samp{/h} in | 1562 | delete mode}. When this feature is enabled (indicated by @samp{/h} in |
| 1576 | the mode line after the mode name), a single @key{DEL} command deletes | 1563 | the mode line after the mode name), a single @key{DEL} deletes all |
| 1577 | all preceding whitespace, not just one space, and a single @kbd{C-c | 1564 | preceding whitespace, not just one space, and a single @kbd{C-c C-d} |
| 1578 | C-d} (but @emph{not} @key{DELETE}) deletes all following whitespace. | 1565 | (but @emph{not} plain @key{DELETE}) deletes all following whitespace. |
| 1579 | 1566 | ||
| 1580 | @table @kbd | 1567 | @table @kbd |
| 1581 | @item M-x c-toggle-hungry-state | 1568 | @item M-x c-toggle-hungry-state |
diff --git a/man/text.texi b/man/text.texi index 4fb5ee9cc1e..2b70c599b89 100644 --- a/man/text.texi +++ b/man/text.texi | |||
| @@ -2575,10 +2575,10 @@ Likewise @kbd{M-x table-backward-cell} from the first cell in a table | |||
| 2575 | moves to the last cell. | 2575 | moves to the last cell. |
| 2576 | 2576 | ||
| 2577 | @findex table-span-cell | 2577 | @findex table-span-cell |
| 2578 | The command @code{table-span-cell} spans the current cell into one | 2578 | The command @code{table-span-cell} merges the current cell with the |
| 2579 | of the four directions---right, left, above or below---and merges the | 2579 | adjacent cell in a specified direction---right, left, above or below. |
| 2580 | current cell with the adjacent cell. It does not allow directions to | 2580 | You specify the direction with the minibuffer. It does not allow |
| 2581 | which spanning does not produce a legitimate cell. | 2581 | merges which don't result in a legitimate cell layout. |
| 2582 | 2582 | ||
| 2583 | @findex table-split-cell | 2583 | @findex table-split-cell |
| 2584 | @cindex text-based tables, split a cell | 2584 | @cindex text-based tables, split a cell |
| @@ -2586,7 +2586,8 @@ which spanning does not produce a legitimate cell. | |||
| 2586 | The command @code{table-split-cell} splits the current cell | 2586 | The command @code{table-split-cell} splits the current cell |
| 2587 | vertically or horizontally. This command is a wrapper to the | 2587 | vertically or horizontally. This command is a wrapper to the |
| 2588 | direction specific commands @code{table-split-cell-vertically} and | 2588 | direction specific commands @code{table-split-cell-vertically} and |
| 2589 | @code{table-split-cell-horizontally}. | 2589 | @code{table-split-cell-horizontally}. You specify the direction with |
| 2590 | a minibuffer argument. | ||
| 2590 | 2591 | ||
| 2591 | @findex table-split-cell-vertically | 2592 | @findex table-split-cell-vertically |
| 2592 | The command @code{table-split-cell-vertically} splits the current | 2593 | The command @code{table-split-cell-vertically} splits the current |
diff --git a/man/xresources.texi b/man/xresources.texi index f7947edda17..87781da582c 100644 --- a/man/xresources.texi +++ b/man/xresources.texi | |||
| @@ -8,7 +8,8 @@ | |||
| 8 | You can customize some X-related aspects of Emacs behavior using X | 8 | You can customize some X-related aspects of Emacs behavior using X |
| 9 | resources, as is usual for programs that use X. On MS-Windows, you | 9 | resources, as is usual for programs that use X. On MS-Windows, you |
| 10 | can customize some of the same aspects using the system registry. | 10 | can customize some of the same aspects using the system registry. |
| 11 | @xref{MS-Windows Registry}. | 11 | @xref{MS-Windows Registry}. Likewise, the Mac Carbon port emulates X |
| 12 | resources using the Preferences system. @xref{Mac Environment Variables}. | ||
| 12 | 13 | ||
| 13 | When Emacs is built using an `X toolkit', such as Lucid or LessTif, | 14 | When Emacs is built using an `X toolkit', such as Lucid or LessTif, |
| 14 | you need to use X resources to customize the appearance of the | 15 | you need to use X resources to customize the appearance of the |