diff options
| author | Paul Eggert | 2015-03-18 11:45:36 -0700 |
|---|---|---|
| committer | Paul Eggert | 2015-03-18 11:45:36 -0700 |
| commit | 81deba3d7a2b187d58fe26bd8b4eafb5687095e1 (patch) | |
| tree | 82feff9e8228de216840a6c96ba7c006ce337e24 /doc/misc | |
| parent | 8dfff871bdf0e420c6f5570e72afc80471d40d51 (diff) | |
| parent | 1a941d6c9eab9a35682408d6b85a1a98cfb6b01d (diff) | |
| download | emacs-81deba3d7a2b187d58fe26bd8b4eafb5687095e1.tar.gz emacs-81deba3d7a2b187d58fe26bd8b4eafb5687095e1.zip | |
Merge from origin/emacs-24
1a941d6 Fix incorrect usage of @key in the User Manual (Bug#20135)
14c47d3 doc/misc/efaq-w32.texi: Spell-check.
ac85901 doc/misc/efaq-w32.texi: Remove outdated information and update.
c43762d Fix description of fullscreen mode on MS-Windows (Bug#20110).
ea8cab3 doc/lispref/minibuf.texi (Basic Completion): Fix a typo. (Bug#20108)
2fdec80 Improve indexing in Emacs manual (Bug#20105)
cc11321 Fix --no-bitmap-icon
Conflicts:
doc/emacs/ChangeLog
doc/lispref/ChangeLog
doc/misc/ChangeLog
src/ChangeLog
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/ChangeLog | 10 | ||||
| -rw-r--r-- | doc/misc/efaq-w32.texi | 425 | ||||
| -rw-r--r-- | doc/misc/efaq.texi | 12 |
3 files changed, 206 insertions, 241 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index fc85bd97f73..62f565191dc 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,11 @@ | |||
| 1 | 2015-03-18 Eli Zaretskii <eliz@gnu.org> | ||
| 2 | |||
| 3 | * efaq-w32.texi: Remove outdated information and update. | ||
| 4 | |||
| 5 | 2015-03-18 Martin Rudalics <rudalics@gmx.at> | ||
| 6 | |||
| 7 | * efaq.texi (Fullscreen mode on MS-Windows): Fix description (Bug#20110). | ||
| 8 | |||
| 1 | 2015-03-04 Michael Albinus <michael.albinus@gmx.de> | 9 | 2015-03-04 Michael Albinus <michael.albinus@gmx.de> |
| 2 | 10 | ||
| 3 | * tramp.texi (External methods) <adb>: Explain, when Tramp | 11 | * tramp.texi (External methods) <adb>: Explain, when Tramp |
| @@ -12,7 +20,7 @@ | |||
| 12 | 20 | ||
| 13 | * erc.texi (Advanced Usage, Options): Add descriptions and examples | 21 | * erc.texi (Advanced Usage, Options): Add descriptions and examples |
| 14 | for erc-format-nick-function and erc-rename-buffers options. | 22 | for erc-format-nick-function and erc-rename-buffers options. |
| 15 | (Connecting): fix typo | 23 | (Connecting): Fix typo |
| 16 | 24 | ||
| 17 | 2015-03-02 Daniel Colascione <dancol@dancol.org> | 25 | 2015-03-02 Daniel Colascione <dancol@dancol.org> |
| 18 | 26 | ||
diff --git a/doc/misc/efaq-w32.texi b/doc/misc/efaq-w32.texi index 9691a731123..d95fa7e4790 100644 --- a/doc/misc/efaq-w32.texi +++ b/doc/misc/efaq-w32.texi | |||
| @@ -128,10 +128,12 @@ systems. | |||
| 128 | @cindex supported versions of Windows | 128 | @cindex supported versions of Windows |
| 129 | 129 | ||
| 130 | Emacs @value{EMACSVER} is known to run on all versions of Windows from | 130 | Emacs @value{EMACSVER} is known to run on all versions of Windows from |
| 131 | @c FIXME does it really still support Windows 98? Does it matter? | 131 | Windows 98 and Windows NT 4.0 through to Windows 8.1. The Windows |
| 132 | Windows 98 and Windows NT 4.0 through to Windows 7. The Windows port is | 132 | port is built using the Win32 API and supports most features of the X |
| 133 | built using the Win32 API and supports most features of the X version, | 133 | version, including variable width fonts, images and tooltips. |
| 134 | including variable width fonts, images and tooltips. | 134 | |
| 135 | Emacs on Windows can be compiled as either a 32-bit or a 64-bit | ||
| 136 | executable, using the MinGW GCC compiler and development tools. | ||
| 135 | 137 | ||
| 136 | @node Other versions of Emacs | 138 | @node Other versions of Emacs |
| 137 | @section What other versions of Emacs run on Windows? | 139 | @section What other versions of Emacs run on Windows? |
| @@ -163,10 +165,12 @@ instructions (requires DJGPP). | |||
| 163 | @cindex where to get Emacs binaries | 165 | @cindex where to get Emacs binaries |
| 164 | Pre-compiled versions are distributed from | 166 | Pre-compiled versions are distributed from |
| 165 | @uref{http://ftpmirror.gnu.org/emacs/windows/, ftp.gnu.org mirrors}. | 167 | @uref{http://ftpmirror.gnu.org/emacs/windows/, ftp.gnu.org mirrors}. |
| 166 | Emacs binaries are distributed as zip files, digitally | 168 | Emacs binaries are distributed as zip files, digitally signed by the |
| 167 | signed by the developer who built them. Generally most users will | 169 | developer who built them. Generally most users will want the file |
| 168 | want the file @file{emacs-@value{EMACSVER}-bin-i386.zip}, which | 170 | @file{emacs-@value{EMACSVER}-bin-i686-pc-mingw.zip} for the 32-bit |
| 169 | contains everything you need to get started. | 171 | build, and @file{emacs-@value{EMACSVER}-bin-x86_64-w64-mingw32.zip} |
| 172 | for the 64-bit build. The zip archive contains everything you need to | ||
| 173 | get started. | ||
| 170 | 174 | ||
| 171 | @cindex where to get sources | 175 | @cindex where to get sources |
| 172 | @cindex Emacs source code | 176 | @cindex Emacs source code |
| @@ -187,17 +191,18 @@ development site. | |||
| 187 | @section How can I compile Emacs myself? | 191 | @section How can I compile Emacs myself? |
| 188 | @cindex compiling Emacs | 192 | @cindex compiling Emacs |
| 189 | 193 | ||
| 190 | To compile Emacs on Windows, you will need the MingW or Cygwin port of | 194 | To compile Emacs on Windows, you will need the MinGW port of GCC and |
| 191 | GCC with MingW make, or a Microsoft C compiler with nmake and the | 195 | Binutils, the MinGW runtime and development environment, and the MSYS |
| 192 | single threaded C runtime library. Recent versions of Microsoft | 196 | suite of tools. For the details, see the file @file{nt/INSTALL} in |
| 193 | Visual Studio no longer come with the single threaded C runtime | 197 | the Emacs source distribution. |
| 194 | library, which is required for certain POSIX compatibility, so MingW | 198 | |
| 195 | is usually the best choice. Image support requires external | 199 | Support for displaying images, as well as XML/HTML rendering and TLS |
| 196 | libraries, the headers and import libraries for which will need to be | 200 | networking requires external libraries, the headers and import |
| 197 | installed where your compiler can find them. You will also need ports | 201 | libraries for which will need to be installed where your compiler can |
| 198 | of GNU @command{rm} and @command{cp}, as the Windows native | 202 | find them. Again, the details, including URLs of sites where you can |
| 199 | equivalents are not consistent between versions. GNU texinfo will be | 203 | download these libraries are in @file{nt/INSTALL}. @xref{Other useful |
| 200 | required to build the manuals. @xref{Other useful ports}. | 204 | ports}, for auxiliary tools you may wish to install and use in |
| 205 | conjunction with Emacs. | ||
| 201 | 206 | ||
| 202 | After unpacking the source, or checking out of the repository, be sure | 207 | After unpacking the source, or checking out of the repository, be sure |
| 203 | to read the instructions in @file{nt/README} and @file{nt/INSTALL}. | 208 | to read the instructions in @file{nt/README} and @file{nt/INSTALL}. |
| @@ -211,39 +216,25 @@ to read the instructions in @file{nt/README} and @file{nt/INSTALL}. | |||
| 211 | By default, Emacs is compiled with debugging on, and optimizations enabled. | 216 | By default, Emacs is compiled with debugging on, and optimizations enabled. |
| 212 | The optimizations may interfere with some types of debugging; the debugger | 217 | The optimizations may interfere with some types of debugging; the debugger |
| 213 | may not show clearly where it is, or may not be able to inspect certain | 218 | may not show clearly where it is, or may not be able to inspect certain |
| 214 | variables. If this is the case, reconfigure with @option{--no-opt}. | 219 | variables. If this is the case, reconfigure with @kbd{CFLAGS='-O0 -g3'} |
| 215 | 220 | ||
| 216 | The file @file{etc/DEBUG} contains general debugging hints, as well as | 221 | The file @file{etc/DEBUG} contains general debugging hints, as well as |
| 217 | specific notes about debugging Emacs with both gdb and Microsoft debuggers. | 222 | specific notes about debugging Emacs. |
| 218 | |||
| 219 | @menu | ||
| 220 | * GDB:: | ||
| 221 | * Microsoft Developer Studio:: | ||
| 222 | @end menu | ||
| 223 | 223 | ||
| 224 | @node GDB | ||
| 225 | @subsection GDB | ||
| 226 | @cindex GDB, debugging Emacs with | ||
| 227 | @cindex debugging Emacs with GDB | 224 | @cindex debugging Emacs with GDB |
| 228 | |||
| 229 | GDB is the GNU debugger, which can be used to debug Emacs when it has | 225 | GDB is the GNU debugger, which can be used to debug Emacs when it has |
| 230 | been compiled with GCC. The best results will be obtained if you | 226 | been compiled with MinGW GCC. The best results will be obtained if |
| 231 | start gdb from the @file{src} directory as @samp{gdb oo/i386/emacs.exe}. | 227 | you start gdb from the @file{src} directory as @kbd{gdb ./emacs.exe}. |
| 232 | This will load the init file @file{.gdbinit} in that directory, to | 228 | This will load the init file @file{.gdbinit}@footnote{ |
| 233 | define some extra commands for working with lisp while debugging, and | 229 | Latest versions of GDB might refuse to load the init file for security |
| 234 | set up breakpoints to catch abnormal aborts. | 230 | reasons, unless you customize GDB; alternatively, use an explicit |
| 235 | 231 | @kbd{source ./gdbinit} command after entering GDB. | |
| 236 | @node Microsoft Developer Studio | 232 | } in that directory, to define some extra commands for working with |
| 237 | @subsection Microsoft Developer Studio | 233 | lisp while debugging, and set up breakpoints to catch abnormal |
| 238 | @cindex MSVC++, debugging Emacs with | 234 | aborts. |
| 239 | @cindex DevStudio, debugging Emacs with | 235 | |
| 240 | @cindex debugging Emacs with MS DevStudio | 236 | A Windows port of GDB can be found on MinGW download sites and on some |
| 241 | 237 | others. | |
| 242 | MS DevStudio can be used to debug Emacs when it has been compiled with | ||
| 243 | a Microsoft compiler. To view lisp variables, you can call the | ||
| 244 | function @code{debug_print} from the Quickwatch window. Some | ||
| 245 | @uref{http://www.gnu.org/software/emacs/windows/ntemacs/discuss/debug.txt, | ||
| 246 | old tips} are probably still valid. | ||
| 247 | 238 | ||
| 248 | @c ------------------------------------------------------------ | 239 | @c ------------------------------------------------------------ |
| 249 | @node Installing Emacs | 240 | @node Installing Emacs |
| @@ -251,7 +242,7 @@ old tips} are probably still valid. | |||
| 251 | 242 | ||
| 252 | @menu | 243 | @menu |
| 253 | * Unpacking:: | 244 | * Unpacking:: |
| 254 | * Installing:: | 245 | * Installing binaries:: |
| 255 | * Image support:: | 246 | * Image support:: |
| 256 | * Init file:: | 247 | * Init file:: |
| 257 | * Location of init file:: | 248 | * Location of init file:: |
| @@ -279,24 +270,27 @@ old tips} are probably still valid. | |||
| 279 | The binary distributions are distributed as zip files, which are handled | 270 | The binary distributions are distributed as zip files, which are handled |
| 280 | natively by Windows XP and later. For earlier versions, there are many | 271 | natively by Windows XP and later. For earlier versions, there are many |
| 281 | tools that can handle the zip format, from InfoZip's command line unzip | 272 | tools that can handle the zip format, from InfoZip's command line unzip |
| 282 | tool, to 7zip's multi-format graphical archive explorer. Although | 273 | tool, to 7zip's multi-format graphical archive explorer. (Although |
| 283 | popular, WinZip has caused problems with line-ends in the past, and is not | 274 | popular, WinZip has caused problems with line-ends in the past, and is not |
| 284 | Free software, so we do not recommend it. | 275 | Free software, so we do not recommend it.) |
| 285 | 276 | ||
| 286 | Source distributions are distributed as gzipped tar files. 7zip and | 277 | Source distributions are distributed as @file{.tar.gz} or |
| 287 | similar multi-format graphical tools can handle these, or you can get | 278 | @file{.tar.xz} files. 7zip and similar multi-format graphical tools |
| 288 | Windows ports of the command line gzip and tar tools from multiple sources. | 279 | can handle these, or you can get Windows ports of the command line |
| 280 | gzip and tar tools from multiple sources, or use @command{bsdtar}. | ||
| 289 | @xref{Other useful ports}. | 281 | @xref{Other useful ports}. |
| 290 | 282 | ||
| 291 | The command to unpack a source distribution from the command line is: | 283 | The command to unpack a source distribution from the command line is: |
| 284 | |||
| 292 | @example | 285 | @example |
| 293 | tar xzf emacs-@value{EMACSVER}.tar.gz | 286 | tar xzf emacs-@value{EMACSVER}.tar.gz |
| 294 | @end example | 287 | @end example |
| 295 | 288 | ||
| 296 | If this does not work with the versions of tar and gzip that you have, | 289 | If this does not work with the versions of tar and gzip that you have, |
| 297 | you may need to try a two step process: | 290 | you may need to try a two step process: |
| 291 | |||
| 298 | @example | 292 | @example |
| 299 | gzip -dc emacs-@value{EMACSVER}.tar.gz | tar xvf - | 293 | gzip -dc emacs-@value{EMACSVER}.tar.gz | tar xf - |
| 300 | @end example | 294 | @end example |
| 301 | 295 | ||
| 302 | You may see many messages from tar complaining about being unable to change | 296 | You may see many messages from tar complaining about being unable to change |
| @@ -304,8 +298,21 @@ the modification time on directories, and from gzip complaining about a | |||
| 304 | broken pipe. These messages are usually harmless, caused by incomplete ports | 298 | broken pipe. These messages are usually harmless, caused by incomplete ports |
| 305 | that are not fully aware of the limitations of Windows. | 299 | that are not fully aware of the limitations of Windows. |
| 306 | 300 | ||
| 307 | @node Installing | 301 | And here's an example of using @command{bsdtar} (from the |
| 308 | @section How do I install Emacs after unpacking? | 302 | @samp{libarchive} package) to unpack a @file{.tar.xz} archive: |
| 303 | |||
| 304 | @example | ||
| 305 | bsdtar -xf emacs-@value{EMACSVER}.tar.xz | ||
| 306 | @end example | ||
| 307 | |||
| 308 | Expect @command{bsdtar} to unpack the whole distribution without any | ||
| 309 | complaints. | ||
| 310 | |||
| 311 | Once you unpack the source distribution, look in @file{nt/INSTALL} | ||
| 312 | file for build instructions. | ||
| 313 | |||
| 314 | @node Installing binaries | ||
| 315 | @section How do I install Emacs after unpacking the binary zip? | ||
| 309 | @cindex installing Emacs | 316 | @cindex installing Emacs |
| 310 | @pindex addpm | 317 | @pindex addpm |
| 311 | @cindex Start Menu, creating icons for Emacs | 318 | @cindex Start Menu, creating icons for Emacs |
| @@ -313,7 +320,8 @@ that are not fully aware of the limitations of Windows. | |||
| 313 | You can run Emacs without any extra steps, but if you want icons in your | 320 | You can run Emacs without any extra steps, but if you want icons in your |
| 314 | Start Menu, or for Emacs to detect the image libraries that are already | 321 | Start Menu, or for Emacs to detect the image libraries that are already |
| 315 | installed on your system as part of GTK, then you should run the program | 322 | installed on your system as part of GTK, then you should run the program |
| 316 | @file{emacs-@value{EMACSVER}\bin\addpm.exe}. | 323 | @file{addpm.exe}, which is usually installed into the same @file{bin} |
| 324 | directory with @file{emacs.exe}. | ||
| 317 | 325 | ||
| 318 | @node Image support | 326 | @node Image support |
| 319 | @section How do I get image support? | 327 | @section How do I get image support? |
| @@ -323,6 +331,7 @@ installed on your system as part of GTK, then you should run the program | |||
| 323 | @cindex gif, installing image support in Emacs | 331 | @cindex gif, installing image support in Emacs |
| 324 | @cindex tiff, installing image support in Emacs | 332 | @cindex tiff, installing image support in Emacs |
| 325 | @cindex xpm, installing image support in Emacs | 333 | @cindex xpm, installing image support in Emacs |
| 334 | @cindex rsvg, installing image support in Emacs | ||
| 326 | @cindex toolbar, installing color icons in | 335 | @cindex toolbar, installing color icons in |
| 327 | @cindex color images, installing support for images in Emacs | 336 | @cindex color images, installing support for images in Emacs |
| 328 | @cindex monochrome images, getting color images in Emacs | 337 | @cindex monochrome images, getting color images in Emacs |
| @@ -330,12 +339,12 @@ installed on your system as part of GTK, then you should run the program | |||
| 330 | 339 | ||
| 331 | Emacs has built in support for XBM and PBM/PGM/PPM images. This is | 340 | Emacs has built in support for XBM and PBM/PGM/PPM images. This is |
| 332 | sufficient to see the monochrome splash screen and tool-bar icons. | 341 | sufficient to see the monochrome splash screen and tool-bar icons. |
| 333 | Since 22.2, the official precompiled binaries for Windows have bundled | 342 | Since v22.2, the official precompiled binaries for Windows have bundled |
| 334 | libXpm, which is required to display the color versions of those images. | 343 | libXpm, which is required to display the color versions of those images. |
| 335 | 344 | ||
| 336 | Emacs is compiled to recognize JPEG, PNG, GIF and TIFF images also, | 345 | Emacs is compiled to recognize JPEG, PNG, GIF, TIFF, and RSVG images |
| 337 | but displaying these image types require external DLLs which are not | 346 | also, but displaying these image types require external DLLs which are |
| 338 | bundled with Emacs. @xref{Other useful ports}. | 347 | not bundled with Emacs. @xref{Other useful ports}. |
| 339 | 348 | ||
| 340 | @node Init file | 349 | @node Init file |
| 341 | @section What is my init file? | 350 | @section What is my init file? |
| @@ -344,11 +353,11 @@ bundled with Emacs. @xref{Other useful ports}. | |||
| 344 | 353 | ||
| 345 | When Emacs starts up, it attempts to load and execute the contents of | 354 | When Emacs starts up, it attempts to load and execute the contents of |
| 346 | a file commonly called @file{.emacs} (though it may have other names, | 355 | a file commonly called @file{.emacs} (though it may have other names, |
| 347 | @pxref{Installing Emacs,,Where do I put my init file?}) which contains any | 356 | @pxref{Location of init file,,Where do I put my init file?}) which |
| 348 | customizations you have made. You can manually add lisp code to your | 357 | contains any customizations you have made. You can manually add lisp |
| 349 | .emacs, or you can use the Customization interface accessible from the | 358 | code to your .emacs, or you can use the Customization interface |
| 350 | @emph{Options} menu. If the file does not exist, Emacs will start | 359 | accessible from the @emph{Options} menu. If the file does not exist, |
| 351 | with the default settings. | 360 | Emacs will start with the default settings. |
| 352 | 361 | ||
| 353 | @node Location of init file | 362 | @node Location of init file |
| 354 | @section Where do I put my init file? | 363 | @section Where do I put my init file? |
| @@ -358,15 +367,15 @@ with the default settings. | |||
| 358 | @cindex init.el | 367 | @cindex init.el |
| 359 | @cindex registry, setting the HOME directory in | 368 | @cindex registry, setting the HOME directory in |
| 360 | 369 | ||
| 361 | On Windows, the .emacs file may be called _emacs for backward | 370 | On Windows, the @file{.emacs} file may be called @file{_emacs} for |
| 362 | compatibility with DOS and FAT filesystems where filenames could not | 371 | backward compatibility with DOS and FAT filesystems where filenames |
| 363 | start with a dot. Some users prefer to continue using such a name, | 372 | could not start with a dot. Some users prefer to continue using such |
| 364 | because Explorer cannot create a file with a name starting with a dot, | 373 | a name due to historical problems various Windows tools had in the |
| 365 | even though the filesystem and most other programs can handle it. | 374 | past with file names that begin with a dot. In Emacs 22 and later, |
| 366 | In Emacs 22 and later, the init file may also be called | 375 | the init file may also be called @file{.emacs.d/init.el}. Many of the |
| 367 | @file{.emacs.d/init.el}. Many of the other files that are created | 376 | other files that are created by lisp packages are now stored in the |
| 368 | by lisp packages are now stored in the @file{.emacs.d} directory too, | 377 | @file{.emacs.d} directory too, so this keeps all your Emacs related |
| 369 | so this keeps all your Emacs related files in one place. | 378 | files in one place. |
| 370 | 379 | ||
| 371 | All the files mentioned above should go in your @env{HOME} directory. | 380 | All the files mentioned above should go in your @env{HOME} directory. |
| 372 | The @env{HOME} directory is determined by following the steps below: | 381 | The @env{HOME} directory is determined by following the steps below: |
| @@ -387,14 +396,14 @@ backward compatibility, as previous versions defaulted to @file{C:/} | |||
| 387 | if @env{HOME} was not set. | 396 | if @env{HOME} was not set. |
| 388 | @item | 397 | @item |
| 389 | Use the user's AppData directory, usually a directory called | 398 | Use the user's AppData directory, usually a directory called |
| 390 | @file{Application Data} under the user's profile directory, the location | 399 | @file{AppData} under the user's profile directory, the location |
| 391 | of which varies according to Windows version and whether the computer is | 400 | of which varies according to Windows version and whether the computer is |
| 392 | part of a domain. | 401 | part of a domain. |
| 393 | @end enumerate | 402 | @end enumerate |
| 394 | 403 | ||
| 395 | Within Emacs, @key{~} at the beginning of a file name is expanded to your | 404 | Within Emacs, @key{~} at the beginning of a file name is expanded to your |
| 396 | @env{HOME} directory, so you can always find your .emacs file with | 405 | @env{HOME} directory, so you can always find your @file{.emacs} file |
| 397 | @kbd{C-x C-f ~/.emacs}. | 406 | by typing the command @kbd{C-x C-f ~/.emacs}. |
| 398 | 407 | ||
| 399 | @node Troubleshooting init file | 408 | @node Troubleshooting init file |
| 400 | @section Troubleshooting init file problems | 409 | @section Troubleshooting init file problems |
| @@ -409,15 +418,16 @@ to. You can do this by evaluating the following expression in the | |||
| 409 | @file{*scratch*} buffer using @kbd{C-x C-e}: | 418 | @file{*scratch*} buffer using @kbd{C-x C-e}: |
| 410 | 419 | ||
| 411 | @example | 420 | @example |
| 412 | (insert (getenv "HOME")) | 421 | (getenv "HOME") |
| 413 | @end example | 422 | @end example |
| 414 | 423 | ||
| 415 | Look carefully at what is printed and make sure the value is | 424 | Look carefully at what is printed in the echo area, and make sure the |
| 416 | valid. For example, if the value has trailing whitespace, Emacs won't | 425 | value is valid. For example, if the value has trailing whitespace, |
| 417 | be able to find the directory. Also, be sure that the value isn't a | 426 | Emacs won't be able to find the directory. Also, be sure that the |
| 418 | relative drive letter (e.g., @file{d:} without a backslash); if it is, | 427 | value isn't a relative drive letter (e.g., @file{d:} without a |
| 419 | then @env{HOME} is going to be whatever the current directory on that | 428 | backslash or a forward slash after the colon); if it is, then |
| 420 | drive is, which is likely not what you want to happen. | 429 | @env{HOME} is going to be whatever the current directory on that drive |
| 430 | is, which is likely not what you want to happen. | ||
| 421 | 431 | ||
| 422 | @node Associate files with Emacs | 432 | @node Associate files with Emacs |
| 423 | @section How do I associate files with Emacs? | 433 | @section How do I associate files with Emacs? |
| @@ -488,9 +498,9 @@ Thanks to Jason Rumney and Sigbjorn Finne for these tips. | |||
| 488 | 498 | ||
| 489 | The location of the Desktop varies between different versions of | 499 | The location of the Desktop varies between different versions of |
| 490 | Windows, and in a corporate environment can be moved around by the | 500 | Windows, and in a corporate environment can be moved around by the |
| 491 | network administrator. On NT derivatives, you can use the value of | 501 | network administrator. On latest Windows versions, you can use the |
| 492 | the @env{USERPROFILE} environment variable to find where the desktop | 502 | value of the @env{USERPROFILE} environment variable to find where the |
| 493 | might be: | 503 | desktop might be: |
| 494 | 504 | ||
| 495 | @example | 505 | @example |
| 496 | @kbd{C-x C-f $USERPROFILE/Desktop} | 506 | @kbd{C-x C-f $USERPROFILE/Desktop} |
| @@ -512,7 +522,7 @@ menu by default). Once you have a file from the Desktop inside Emacs, | |||
| 512 | @end menu | 522 | @end menu |
| 513 | 523 | ||
| 514 | @node Focus follows mouse | 524 | @node Focus follows mouse |
| 515 | @subsection How do it make the active window follow the mouse? | 525 | @subsection How do I make the active window follow the mouse? |
| 516 | @vindex focus-follows-mouse | 526 | @vindex focus-follows-mouse |
| 517 | @cindex point to focus | 527 | @cindex point to focus |
| 518 | @cindex mouse over to focus | 528 | @cindex mouse over to focus |
| @@ -524,6 +534,11 @@ even though Windows has a click to focus policy by default (there is | |||
| 524 | software available to change that though). The latter can be used to | 534 | software available to change that though). The latter can be used to |
| 525 | make Emacs use a focus-follow-mouse policy within its own frames. | 535 | make Emacs use a focus-follow-mouse policy within its own frames. |
| 526 | 536 | ||
| 537 | You can also change the Windows click-to-focus policy by changing | ||
| 538 | settings in the Registry. The details vary according to your Windows | ||
| 539 | version; look on the Internet for instructions to enable ``active | ||
| 540 | window tracking'' for your version of Windows. | ||
| 541 | |||
| 527 | @node Swap CapsLock and Control | 542 | @node Swap CapsLock and Control |
| 528 | @subsection How do I swap CapsLock and Control? | 543 | @subsection How do I swap CapsLock and Control? |
| 529 | @cindex scan codes, modifying | 544 | @cindex scan codes, modifying |
| @@ -576,7 +591,7 @@ Date: 04 Dec 1996 14:36:21 -0600 | |||
| 576 | Message-ID: <fawg21mm4hm.fsf@@mordor.rsn.hp.com> | 591 | Message-ID: <fawg21mm4hm.fsf@@mordor.rsn.hp.com> |
| 577 | Subject: Re: Re[2]: problem with caps/ctrl swap on NT 4.0 | 592 | Subject: Re: Re[2]: problem with caps/ctrl swap on NT 4.0 |
| 578 | @end ignore | 593 | @end ignore |
| 579 | @example | 594 | @smallexample |
| 580 | It's a binary value that lets you map keystrokes in the low-level keyboard | 595 | It's a binary value that lets you map keystrokes in the low-level keyboard |
| 581 | drivers in NT. As a result you don't have to worry about applications | 596 | drivers in NT. As a result you don't have to worry about applications |
| 582 | bypassing mappings that you've done at a higher level (i.e. it just works). | 597 | bypassing mappings that you've done at a higher level (i.e. it just works). |
| @@ -600,7 +615,7 @@ lock key will behave as caps-lock. To swap, you also need to map 0x3a to | |||
| 600 | 615 | ||
| 601 | This registry value is system wide, and can't be made user-specific. It | 616 | This registry value is system wide, and can't be made user-specific. It |
| 602 | also only takes affect on reboot. | 617 | also only takes affect on reboot. |
| 603 | @end example | 618 | @end smallexample |
| 604 | @item | 619 | @item |
| 605 | Ulfar Erlingsson has provided a registry file that sets the CapsLock key | 620 | Ulfar Erlingsson has provided a registry file that sets the CapsLock key |
| 606 | to be a Control key and the Windows key to be an Alt key: | 621 | to be a Control key and the Windows key to be an Alt key: |
| @@ -663,7 +678,8 @@ buffers etc. will instead act on the region. An inactive mark needs | |||
| 663 | to be reactivated to operate on it, unless @code{mark-even-if-inactive} | 678 | to be reactivated to operate on it, unless @code{mark-even-if-inactive} |
| 664 | is set. Secondly, @code{transient-mark-mode} also highlights the | 679 | is set. Secondly, @code{transient-mark-mode} also highlights the |
| 665 | region when it is active, providing the same visual clue that you get | 680 | region when it is active, providing the same visual clue that you get |
| 666 | in other programs. | 681 | in other programs. This mode is turned on by default in latest |
| 682 | versions of Emacs. | ||
| 667 | 683 | ||
| 668 | In addition to seeing the highlighting, new Emacs users often expect | 684 | In addition to seeing the highlighting, new Emacs users often expect |
| 669 | editing commands to replace the region when it is active. This behavior | 685 | editing commands to replace the region when it is active. This behavior |
| @@ -717,14 +733,16 @@ message as documented in Microsoft's API documentation. | |||
| 717 | @cindex delete Emacs directory | 733 | @cindex delete Emacs directory |
| 718 | 734 | ||
| 719 | Emacs does not come with an uninstall program. No files are installed | 735 | Emacs does not come with an uninstall program. No files are installed |
| 720 | outside of the Emacs base directory, so deleting that directory is | 736 | outside of the directories you find in the binary zip archive, so |
| 721 | sufficient to clean away the files. If you ran @command{addpm}, | 737 | deleting those directories is sufficient to clean away the files. If |
| 722 | you'll need to delete the Start Menu group too. The registry entries | 738 | you ran @command{addpm}, you'll need to delete the Start Menu group |
| 723 | inserted by @command{addpm} will not cause any problems if you leave | 739 | too. The registry entries inserted by @command{addpm} will not cause |
| 724 | them there, but for the sake of completeness, you can use @command{regedit} | 740 | any problems if you leave them there, but for the sake of |
| 725 | to remove the keys under @code{HKEY_LOCAL_MACHINE} orx | 741 | completeness, you can use @command{regedit} to remove the keys under |
| 726 | @code{HKEY_CURRENT_USER}: @code{SOFTWARE\GNU\Emacs}, and the key | 742 | @code{HKEY_LOCAL_MACHINE} or @code{HKEY_CURRENT_USER}: |
| 727 | @code{HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\emacs.exe} if it exists. | 743 | @code{SOFTWARE\GNU\Emacs}, and the key |
| 744 | @code{HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App | ||
| 745 | Paths\emacs.exe} if it exists. | ||
| 728 | 746 | ||
| 729 | @node Does not run | 747 | @node Does not run |
| 730 | @section When I run Emacs nothing happens | 748 | @section When I run Emacs nothing happens |
| @@ -751,9 +769,10 @@ been truncated to CONTRIBU or CONTRI~1, your distribution has been | |||
| 751 | corrupted while unpacking and Emacs will not start. | 769 | corrupted while unpacking and Emacs will not start. |
| 752 | @end enumerate | 770 | @end enumerate |
| 753 | 771 | ||
| 754 | If it is still not working, send mail to the list, describing what | 772 | If it is still not working, send mail to the |
| 755 | you've done, and what you are seeing. (The more information you send | 773 | @email{help-gnu-emacs@@gnu.org} mailing list, describing what you've |
| 756 | the more likely it is that you'll receive a helpful response.. | 774 | done, and what you are seeing. (The more information you send the more |
| 775 | likely it is that you'll receive a helpful response.) | ||
| 757 | 776 | ||
| 758 | @node Virus | 777 | @node Virus |
| 759 | @section Does Emacs contain a virus? | 778 | @section Does Emacs contain a virus? |
| @@ -880,7 +899,6 @@ The doc string contains a list of the system sounds you can use. | |||
| 880 | * Font names:: | 899 | * Font names:: |
| 881 | * Bold and italic:: | 900 | * Bold and italic:: |
| 882 | * Multilingual fonts:: | 901 | * Multilingual fonts:: |
| 883 | * BDF fonts:: | ||
| 884 | * Font menu:: | 902 | * Font menu:: |
| 885 | * Line ends:: | 903 | * Line ends:: |
| 886 | @end menu | 904 | @end menu |
| @@ -910,9 +928,9 @@ an indication of whether the font is outline (.TTF, .ATM) or raster (.FON) | |||
| 910 | based when fonts are listed, which may let you differentiate between two | 928 | based when fonts are listed, which may let you differentiate between two |
| 911 | fonts with the same name and different technologies. | 929 | fonts with the same name and different technologies. |
| 912 | 930 | ||
| 913 | From Emacs 23, the preferred font name format will be moving to the simpler | 931 | Starting with Emacs 23, the preferred font name format will be moving |
| 914 | and more flexible fontconfig format. XLFD names will continue to be | 932 | to the simpler and more flexible fontconfig format. XLFD names will |
| 915 | supported for backward compatibility. | 933 | continue to be supported for backward compatibility. |
| 916 | 934 | ||
| 917 | @example | 935 | @example |
| 918 | XLFD: -*-Courier New-normal-r-*-*-13-*-*-*-c-*-iso8859-1 | 936 | XLFD: -*-Courier New-normal-r-*-*-13-*-*-*-c-*-iso8859-1 |
| @@ -959,6 +977,9 @@ and manually set the font for italic, bold and bold-italic as follows: | |||
| 959 | (set-face-font 'bold-italic "-*-Courier New-bold-i-*-*-11-*-*-*-c-*-iso8859-1") | 977 | (set-face-font 'bold-italic "-*-Courier New-bold-i-*-*-11-*-*-*-c-*-iso8859-1") |
| 960 | @end example | 978 | @end example |
| 961 | 979 | ||
| 980 | The @code{w32-enable-synthesized-fonts} variable is obsolete starting | ||
| 981 | from Emacs 24.4, as Emacs no longer has this limitation. | ||
| 982 | |||
| 962 | @node Multilingual fonts | 983 | @node Multilingual fonts |
| 963 | @section Multilingual font support | 984 | @section Multilingual font support |
| 964 | @cindex multilingual display, fonts | 985 | @cindex multilingual display, fonts |
| @@ -985,11 +1006,8 @@ require the BDF fonts from the GNU intlfonts package. | |||
| 985 | 1006 | ||
| 986 | For many languages, native truetype fonts are sufficient, and in Emacs | 1007 | For many languages, native truetype fonts are sufficient, and in Emacs |
| 987 | 23 the need for BDF fonts will disappear for almost all languages. At | 1008 | 23 the need for BDF fonts will disappear for almost all languages. At |
| 988 | the time of writing, some Arabic characters in the HELLO file still do | 1009 | the time of writing, all supported characters are able to be displayed |
| 989 | not display with native fonts, because they are pre-composed characters | 1010 | with appropriate truetype or opentype fonts. |
| 990 | from MULE character sets rather than standard Unicode Arabic, but all | ||
| 991 | other characters are able to be displayed with appropriate truetype or | ||
| 992 | opentype fonts. | ||
| 993 | 1011 | ||
| 994 | @node Non-latin display | 1012 | @node Non-latin display |
| 995 | @subsection How do I get Emacs to display non-latin characters? | 1013 | @subsection How do I get Emacs to display non-latin characters? |
| @@ -1025,6 +1043,12 @@ new fontset with @code{create-fontset-from-ascii-font} or | |||
| 1025 | chinese-big5-2:-*-MingLiU-normal-r-*-*-12-*-*-*-c-*-big5-*" t) | 1043 | chinese-big5-2:-*-MingLiU-normal-r-*-*-12-*-*-*-c-*-big5-*" t) |
| 1026 | @end example | 1044 | @end example |
| 1027 | 1045 | ||
| 1046 | Alternatively, you can augment the default fontset with information of | ||
| 1047 | which fonts to use for certain ranges of characters or for specific | ||
| 1048 | scripts/character sets. @xref{Modifying Fontsets,, Modifying | ||
| 1049 | Fontsets, emacs, The GNU Emacs Manual}, for details and some useful | ||
| 1050 | examples. | ||
| 1051 | |||
| 1028 | @node International fonts | 1052 | @node International fonts |
| 1029 | @subsection Where can I find fonts for other languages? | 1053 | @subsection Where can I find fonts for other languages? |
| 1030 | @cindex language support, finding fonts | 1054 | @cindex language support, finding fonts |
| @@ -1037,10 +1061,10 @@ new fontset with @code{create-fontset-from-ascii-font} or | |||
| 1037 | In addition to the wide range of fonts that come with the language | 1061 | In addition to the wide range of fonts that come with the language |
| 1038 | support packages of various components of Windows itself, GNU/Linux | 1062 | support packages of various components of Windows itself, GNU/Linux |
| 1039 | distributions these days come with a number of Free truetype fonts | 1063 | distributions these days come with a number of Free truetype fonts |
| 1040 | that cover a wide range of languages. The GNU intlfonts source | 1064 | that cover a wide range of languages. The GNU Unifont project |
| 1041 | distribution contains BDF fonts covering all of the languages that can | 1065 | contains glyphs for most of the Unicode codespace, and can be |
| 1042 | be displayed by Emacs 22, and can be downloaded from | 1066 | downloaded from @uref{http://ftpmirror.gnu.org/unifont, ftp.gnu.org |
| 1043 | @uref{http://ftpmirror.gnu.org/intlfonts, ftp.gnu.org mirrors}. | 1067 | mirrors}. |
| 1044 | 1068 | ||
| 1045 | @node Third-party multibyte | 1069 | @node Third-party multibyte |
| 1046 | @subsection How do I use third party programs to display multibyte characters? | 1070 | @subsection How do I use third party programs to display multibyte characters? |
| @@ -1058,12 +1082,6 @@ for that language, but the third party software is intercepting it | |||
| 1058 | and using a different font behind the scenes). | 1082 | and using a different font behind the scenes). |
| 1059 | @xref{Non-latin display}. | 1083 | @xref{Non-latin display}. |
| 1060 | 1084 | ||
| 1061 | In addition to defining a fontset with the expected font, you may also need | ||
| 1062 | to disable unicode output with: | ||
| 1063 | @example | ||
| 1064 | (setq w32-enable-unicode-output nil) | ||
| 1065 | @end example | ||
| 1066 | |||
| 1067 | @node Localized fonts | 1085 | @node Localized fonts |
| 1068 | @subsection Can I use a font with a name in my language? | 1086 | @subsection Can I use a font with a name in my language? |
| 1069 | @cindex fonts, localized font names | 1087 | @cindex fonts, localized font names |
| @@ -1073,87 +1091,9 @@ Normally Emacs should initialize @code{locale-coding-system} appropriately | |||
| 1073 | based on your locale, which will let Emacs use font names in your local | 1091 | based on your locale, which will let Emacs use font names in your local |
| 1074 | language successfully. | 1092 | language successfully. |
| 1075 | 1093 | ||
| 1076 | @node BDF fonts | 1094 | @c This feature disappeared in Emacs 23, but I'm keeping its |
| 1077 | @section How do I use bdf fonts with Emacs? | 1095 | @c description here, since I think it was a mistake to remove it, and |
| 1078 | @cindex BDF fonts, using | 1096 | @c resurrecting it doesn't sound too problematic. |
| 1079 | @cindex GNU intlfonts, using | ||
| 1080 | @cindex intlfonts, using | ||
| 1081 | @vindex w32-bdf-filename-alist | ||
| 1082 | @vindex bdf-directory-alist | ||
| 1083 | @vindex font-encoding-alist | ||
| 1084 | @findex w32-find-bdf-fonts | ||
| 1085 | @findex set-frame-font | ||
| 1086 | |||
| 1087 | To use bdf fonts with Emacs, you need to tell Emacs where the fonts | ||
| 1088 | are located, create fontsets for them, and then use them. We'll use | ||
| 1089 | the 16 dot international fonts from @uref{http://ftpmirror.gnu.org/intlfonts, | ||
| 1090 | ftp.gnu.org/gnu/intlfonts} as an | ||
| 1091 | example put together by Jason Rumney. | ||
| 1092 | |||
| 1093 | Download @file{16dots.tar.gz} and unpack it; I'll assume that they are in | ||
| 1094 | @file{c:\intlfonts}. Then set @code{w32-bdf-filename-alist} to the list of | ||
| 1095 | fonts returned by using @code{w32-find-bdf-fonts} to enumerate all of | ||
| 1096 | the font files. It is a good idea to set the variable | ||
| 1097 | @code{bdf-directory-list} at the same time so @code{ps-print} knows where | ||
| 1098 | to find the fonts: | ||
| 1099 | @example | ||
| 1100 | (setq bdf-directory-list | ||
| 1101 | '("c:/intlfonts/Asian" "c:/intlfonts/Chinese" | ||
| 1102 | "c:/intlfonts/Chinese-X" "c:/intlfonts/Ethiopic" | ||
| 1103 | "c:/intlfonts/European" "c:/intlfonts/Japanese" | ||
| 1104 | "c:/intlfonts/Japanese-X" "c:/intlfonts/Korean-X" | ||
| 1105 | "c:/intlfonts/Misc/")) | ||
| 1106 | |||
| 1107 | (setq w32-bdf-filename-alist (w32-find-bdf-fonts bdf-directory-list)) | ||
| 1108 | @end example | ||
| 1109 | |||
| 1110 | Then create fontsets for the BDF fonts: | ||
| 1111 | |||
| 1112 | @example | ||
| 1113 | (create-fontset-from-fontset-spec | ||
| 1114 | "-*-fixed-medium-r-normal-*-16-*-*-*-c-*-fontset-bdf, | ||
| 1115 | japanese-jisx0208:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0208.1983-*, | ||
| 1116 | katakana-jisx0201:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0201*-*, | ||
| 1117 | latin-jisx0201:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0201*-*, | ||
| 1118 | japanese-jisx0208-1978:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0208.1978-*, | ||
| 1119 | thai-tis620:-misc-fixed-medium-r-normal--16-160-72-72-m-80-tis620.2529-1, | ||
| 1120 | lao:-misc-fixed-medium-r-normal--16-160-72-72-m-80-MuleLao-1, | ||
| 1121 | tibetan-1-column:-TibMdXA-fixed-medium-r-normal--16-160-72-72-m-80-MuleTibetan-1, | ||
| 1122 | ethiopic:-Admas-Ethiomx16f-Medium-R-Normal--16-150-100-100-M-160-Ethiopic-Unicode, | ||
| 1123 | tibetan:-TibMdXA-fixed-medium-r-normal--16-160-72-72-m-160-MuleTibetan-0") | ||
| 1124 | @end example | ||
| 1125 | |||
| 1126 | Many of the international bdf fonts from gnu.org are type 0, and therefore | ||
| 1127 | need to be added to font-encoding-alist: | ||
| 1128 | |||
| 1129 | @example | ||
| 1130 | ;; Need to add some fonts to font-encoding-alist since the bdf fonts | ||
| 1131 | ;; are type 0 not the default type 1. | ||
| 1132 | (setq font-encoding-alist | ||
| 1133 | (append '(("MuleTibetan-0" (tibetan . 0)) | ||
| 1134 | ("GB2312" (chinese-gb2312 . 0)) | ||
| 1135 | ("JISX0208" (japanese-jisx0208 . 0)) | ||
| 1136 | ("JISX0212" (japanese-jisx0212 . 0)) | ||
| 1137 | ("VISCII" (vietnamese-viscii-lower . 0)) | ||
| 1138 | ("KSC5601" (korean-ksc5601 . 0)) | ||
| 1139 | ("MuleArabic-0" (arabic-digit . 0)) | ||
| 1140 | ("MuleArabic-1" (arabic-1-column . 0)) | ||
| 1141 | ("MuleArabic-2" (arabic-2-column . 0))) font-encoding-alist)) | ||
| 1142 | @end example | ||
| 1143 | |||
| 1144 | You can now use the Emacs font menu (@pxref{Fonts and text | ||
| 1145 | translation,,How can I have Emacs use a font menu like on X?}) to | ||
| 1146 | select the @emph{bdf: 16-dot medium} fontset, or you can select it by | ||
| 1147 | setting the default font: | ||
| 1148 | |||
| 1149 | @example | ||
| 1150 | (set-frame-font "fontset-bdf") | ||
| 1151 | @end example | ||
| 1152 | |||
| 1153 | Try loading the file @file{etc/HELLO}, and you should be able to see the | ||
| 1154 | various international fonts displayed (except for Hindi, which is not | ||
| 1155 | included in the 16-dot font distribution). | ||
| 1156 | |||
| 1157 | @node Font menu | 1097 | @node Font menu |
| 1158 | @section How can I have Emacs use a font menu like on X? | 1098 | @section How can I have Emacs use a font menu like on X? |
| 1159 | @cindex fonts, displaying a menu | 1099 | @cindex fonts, displaying a menu |
| @@ -1171,6 +1111,8 @@ Place the following in your init file: | |||
| 1171 | * Add fonts to menu:: | 1111 | * Add fonts to menu:: |
| 1172 | @end menu | 1112 | @end menu |
| 1173 | 1113 | ||
| 1114 | @c This variable still exists, but will have no effect until | ||
| 1115 | @c w32-use-w32-font-dialog support is resurrected, see above. | ||
| 1174 | @node Add fonts to menu | 1116 | @node Add fonts to menu |
| 1175 | @subsection How can I add my font to the font menu? | 1117 | @subsection How can I add my font to the font menu? |
| 1176 | @cindex font menu, adding fonts | 1118 | @cindex font menu, adding fonts |
| @@ -1204,7 +1146,6 @@ this collection of email messages} on the topic. | |||
| 1204 | 1146 | ||
| 1205 | @menu | 1147 | @menu |
| 1206 | * Automatic line ends:: | 1148 | * Automatic line ends:: |
| 1207 | * Line ends by filename:: | ||
| 1208 | * Line ends by file system:: | 1149 | * Line ends by file system:: |
| 1209 | @end menu | 1150 | @end menu |
| 1210 | 1151 | ||
| @@ -1220,19 +1161,6 @@ file in Unix (LF) mode with the Ctrl-M characters displayed as @samp{^M}. | |||
| 1220 | It does this to be safe, as no data loss will occur if the file is really | 1161 | It does this to be safe, as no data loss will occur if the file is really |
| 1221 | binary and the Ctrl-M characters are significant. | 1162 | binary and the Ctrl-M characters are significant. |
| 1222 | 1163 | ||
| 1223 | @node Line ends by filename | ||
| 1224 | @subsection CR/LF translation by file extension | ||
| 1225 | @cindex line ends, determining by filename | ||
| 1226 | @cindex binary files, determining by file name | ||
| 1227 | @vindex file-name-buffer-file-type-alist | ||
| 1228 | |||
| 1229 | The variable @code{file-name-buffer-file-type-alist} holds a list of | ||
| 1230 | filename patterns and their associated type; binary or text. Files marked | ||
| 1231 | as binary will not have line-end detection performed on them, and instead | ||
| 1232 | will always be displayed as is. With auto-detection in recent versions of | ||
| 1233 | Emacs, this is seldom useful for existing files, but can still be used | ||
| 1234 | to influence the choice of line ends for newly created files. | ||
| 1235 | |||
| 1236 | @node Line ends by file system | 1164 | @node Line ends by file system |
| 1237 | @subsection CR/LF translation by file system | 1165 | @subsection CR/LF translation by file system |
| 1238 | @cindex line ends, determining by filesystem | 1166 | @cindex line ends, determining by filesystem |
| @@ -1260,8 +1188,9 @@ MS Windows, but this has still been insufficient to keep up with | |||
| 1260 | changes in printing technology from text and postscript based printers | 1188 | changes in printing technology from text and postscript based printers |
| 1261 | connected via ports that can be accessed directly, to graphical | 1189 | connected via ports that can be accessed directly, to graphical |
| 1262 | printers that are only accessible via USB. For details, see | 1190 | printers that are only accessible via USB. For details, see |
| 1263 | @uref{http://www.emacswiki.org/cgi-bin/wiki/PrintingFromEmacs, Emacs | 1191 | @uref{http://www.emacswiki.org/emacs/PrintingFromEmacs, Emacs |
| 1264 | Wiki}. | 1192 | Wiki}, @uref{http://www.emacswiki.org/emacs/PrintWithWebBrowser}, and |
| 1193 | @uref{http://www.emacswiki.org/emacs/PrintFromWindowsExplorer}. | ||
| 1265 | 1194 | ||
| 1266 | @c ------------------------------------------------------------ | 1195 | @c ------------------------------------------------------------ |
| 1267 | @node Sub-processes | 1196 | @node Sub-processes |
| @@ -1293,9 +1222,7 @@ Wiki}. | |||
| 1293 | The quoting rules for native Windows shells and Cygwin shells have | 1222 | The quoting rules for native Windows shells and Cygwin shells have |
| 1294 | some subtle differences. When Emacs spawns subprocesses, it tries to | 1223 | some subtle differences. When Emacs spawns subprocesses, it tries to |
| 1295 | determine whether the process is a Cygwin program and changes its | 1224 | determine whether the process is a Cygwin program and changes its |
| 1296 | quoting mechanism appropriately. See this | 1225 | quoting mechanism appropriately. |
| 1297 | @uref{http://www.gnu.org/software/emacs/windows/ntemacs/discuss/shell-quoting, | ||
| 1298 | previous discussion} for details. | ||
| 1299 | 1226 | ||
| 1300 | @node Subprocess hang | 1227 | @node Subprocess hang |
| 1301 | @section Programs reading input hang | 1228 | @section Programs reading input hang |
| @@ -1357,9 +1284,11 @@ you can use @code{setbuf} and @code{setvbuf} to manipulate | |||
| 1357 | the buffering semantics. | 1284 | the buffering semantics. |
| 1358 | 1285 | ||
| 1359 | Some programs handle this by having an explicit flag to control their | 1286 | Some programs handle this by having an explicit flag to control their |
| 1360 | buffering behavior, typically @option{-i} for interactive. Other | 1287 | buffering behavior, typically @option{-i} for interactive, or by a |
| 1361 | programs manage to detect that they are running under Emacs, by | 1288 | special environment variable. Other programs manage to detect that |
| 1362 | using @samp{getenv("emacs")} internally. | 1289 | they are running under Emacs, by using @samp{getenv("emacs")} |
| 1290 | internally. Look in the program's documentation for the way around | ||
| 1291 | this issue. | ||
| 1363 | 1292 | ||
| 1364 | @menu | 1293 | @menu |
| 1365 | * Perl script buffering:: | 1294 | * Perl script buffering:: |
| @@ -1428,6 +1357,7 @@ this discussion} for more details. | |||
| 1428 | @vindex explicit-shell-file-name | 1357 | @vindex explicit-shell-file-name |
| 1429 | 1358 | ||
| 1430 | You can start an interactive shell in Emacs by typing @kbd{M-x shell}. | 1359 | You can start an interactive shell in Emacs by typing @kbd{M-x shell}. |
| 1360 | By default, this will start the standard Windows shell @file{cmd.exe}. | ||
| 1431 | Emacs uses the @env{SHELL} environment variable to determine which | 1361 | Emacs uses the @env{SHELL} environment variable to determine which |
| 1432 | program to use as the shell. To instruct Emacs to use a non-default | 1362 | program to use as the shell. To instruct Emacs to use a non-default |
| 1433 | shell, you can either set this environment variable, or customize | 1363 | shell, you can either set this environment variable, or customize |
| @@ -1467,11 +1397,6 @@ default shell in Emacs, you can place the following in your init file: | |||
| 1467 | (add-hook 'shell-mode-hook 'my-shell-setup) | 1397 | (add-hook 'shell-mode-hook 'my-shell-setup) |
| 1468 | @end example | 1398 | @end example |
| 1469 | 1399 | ||
| 1470 | If you find that you are having trouble with Emacs tracking drive | ||
| 1471 | changes with bash, see Mike Fabian's | ||
| 1472 | @uref{http://www.gnu.org/software/emacs/windows/ntemacs/discuss/drive-tracking, | ||
| 1473 | note}. | ||
| 1474 | |||
| 1475 | WARNING: Some versions of bash set and use the environment variable | 1400 | WARNING: Some versions of bash set and use the environment variable |
| 1476 | PID. For some as yet unknown reason, if @env{PID} is set and Emacs | 1401 | PID. For some as yet unknown reason, if @env{PID} is set and Emacs |
| 1477 | passes it on to bash subshells, bash dies (Emacs can inherit the | 1402 | passes it on to bash subshells, bash dies (Emacs can inherit the |
| @@ -1489,7 +1414,7 @@ continue to use bash as your subshell: | |||
| 1489 | @cindex cygwin mount points, using within Emacs | 1414 | @cindex cygwin mount points, using within Emacs |
| 1490 | 1415 | ||
| 1491 | The package | 1416 | The package |
| 1492 | @uref{http://www.emacswiki.org/cgi-bin/wiki/cygwin-mount.el, | 1417 | @uref{http://www.emacswiki.org/emacs/cygwin-mount.el, |
| 1493 | cygwin-mount.el} teaches Emacs about Cygwin mount points. | 1418 | cygwin-mount.el} teaches Emacs about Cygwin mount points. |
| 1494 | 1419 | ||
| 1495 | @node Dired ls | 1420 | @node Dired ls |
| @@ -1849,11 +1774,15 @@ your type (@code{flyspell}). Both packages depend on a copy of | |||
| 1849 | @command{ispell} 3.2 or a compatible spell-checking program. | 1774 | @command{ispell} 3.2 or a compatible spell-checking program. |
| 1850 | GNU Aspell is a popular choice these days, Windows installers are | 1775 | GNU Aspell is a popular choice these days, Windows installers are |
| 1851 | available from the @uref{http://aspell.net/win32/, official site}. | 1776 | available from the @uref{http://aspell.net/win32/, official site}. |
| 1777 | Another possibility is Hunspell, which is available from | ||
| 1778 | @uref{https://sourceforge.net/projects/ezwinports/files/?source=navbar, | ||
| 1779 | the ezwinports site}. | ||
| 1852 | 1780 | ||
| 1853 | Once installed, you will need to configure @code{ispell-program-name} | 1781 | Once installed, you will need to configure @code{ispell-program-name} |
| 1854 | to tell ispell and flyspell to use @command{aspell} as a replacement for | 1782 | to tell ispell and flyspell to use @command{aspell} or |
| 1855 | ispell. You can include the full path to the @file{aspell} binary, which | 1783 | @command{hunspell} as a replacement for ispell. You can include the |
| 1856 | means you do not need to add its installation directory to the @env{PATH}. | 1784 | full path to the @file{aspell}/@file{hunspell} binary, which means you |
| 1785 | do not need to add its installation directory to the @env{PATH}. | ||
| 1857 | 1786 | ||
| 1858 | @node Encryption | 1787 | @node Encryption |
| 1859 | @section Emacs and encryption | 1788 | @section Emacs and encryption |
| @@ -1942,6 +1871,13 @@ of grep is to use @samp{findstr /n /r}. | |||
| 1942 | @node Developing with Emacs | 1871 | @node Developing with Emacs |
| 1943 | @chapter Developing with Emacs | 1872 | @chapter Developing with Emacs |
| 1944 | 1873 | ||
| 1874 | We recommend using the GNU Compiler Collection for developing C/C++ | ||
| 1875 | code from Emacs. The MinGW development toolchain provides Windows | ||
| 1876 | ports of GCC and other compilers. | ||
| 1877 | |||
| 1878 | The rest of this chapter describes other alternatives which you may | ||
| 1879 | need to use. | ||
| 1880 | |||
| 1945 | @menu | 1881 | @menu |
| 1946 | * MSVC:: | 1882 | * MSVC:: |
| 1947 | * Borland C++ Builder:: | 1883 | * Borland C++ Builder:: |
| @@ -1971,7 +1907,7 @@ tools to build your project. | |||
| 1971 | 1907 | ||
| 1972 | Christopher Payne wrote a Visual Studio add-in that makes Emacs the | 1908 | Christopher Payne wrote a Visual Studio add-in that makes Emacs the |
| 1973 | default text editor, this has now been taken over by Jeff Paquette. | 1909 | default text editor, this has now been taken over by Jeff Paquette. |
| 1974 | See the following two URLS for details: | 1910 | See the following two URLs for details: |
| 1975 | @itemize | 1911 | @itemize |
| 1976 | @item @uref{http://sourceforge.net/projects/visemacs/} for the latest version. | 1912 | @item @uref{http://sourceforge.net/projects/visemacs/} for the latest version. |
| 1977 | @item @uref{http://www.smathers.net/VisEmacs.htm} for notes on usage. | 1913 | @item @uref{http://www.smathers.net/VisEmacs.htm} for notes on usage. |
| @@ -2178,6 +2114,7 @@ suggestions} for improving the interaction of perldb and Emacs. | |||
| 2178 | @menu | 2114 | @menu |
| 2179 | * Cygwin:: | 2115 | * Cygwin:: |
| 2180 | * MinGW:: | 2116 | * MinGW:: |
| 2117 | * EZWinPorts:: | ||
| 2181 | * UWIN:: | 2118 | * UWIN:: |
| 2182 | * GnuWin32:: | 2119 | * GnuWin32:: |
| 2183 | * GTK:: | 2120 | * GTK:: |
| @@ -2230,6 +2167,17 @@ filesystem mapping to appear more POSIX like to the scripts that it | |||
| 2230 | runs. This is intended to complement the MinGW tools to make it easier | 2167 | runs. This is intended to complement the MinGW tools to make it easier |
| 2231 | to port software to Windows. | 2168 | to port software to Windows. |
| 2232 | 2169 | ||
| 2170 | @node EZWinPorts | ||
| 2171 | @section EZWinPorts | ||
| 2172 | @cindex ezwinports | ||
| 2173 | |||
| 2174 | The @uref{https://sourceforge.net/projects/ezwinports/, EZWinPorts | ||
| 2175 | project} provides many useful ports of recent versions of GNU and Unix | ||
| 2176 | software. This includes all the optional libraries used by Emacs | ||
| 2177 | (image libraries, libxml2, GnuTLS), RCS, Texinfo, a clone of | ||
| 2178 | @command{man} command, Grep, xz, bzip2, bsdtar, ID Utils, Findutils, | ||
| 2179 | Hunspell, Gawk, GNU Make, Groff, GDB. | ||
| 2180 | |||
| 2233 | @node UWIN | 2181 | @node UWIN |
| 2234 | @section UWIN | 2182 | @section UWIN |
| 2235 | @cindex uwin environment | 2183 | @cindex uwin environment |
| @@ -2251,8 +2199,8 @@ is @command{ksh}, the Korn shell. | |||
| 2251 | @uref{http://gnuwin32.sourceforge.net/} | 2199 | @uref{http://gnuwin32.sourceforge.net/} |
| 2252 | 2200 | ||
| 2253 | GnuWin32 provides precompiled native Windows ports of a wide selection | 2201 | GnuWin32 provides precompiled native Windows ports of a wide selection |
| 2254 | of Free software and libraries. Tools available here that are useful | 2202 | of Free software and libraries. Unfortunately, the ports are |
| 2255 | for Emacs include: | 2203 | outdated. Tools available here that are useful for Emacs include: |
| 2256 | 2204 | ||
| 2257 | @itemize | 2205 | @itemize |
| 2258 | @item Arc - used by @code{archive-mode} to edit .arc files. | 2206 | @item Arc - used by @code{archive-mode} to edit .arc files. |
| @@ -2302,7 +2250,8 @@ Man pages for Emacs and other ported programs that you have can be | |||
| 2302 | read using Emacs' built-in manual reader @code{woman}. This | 2250 | read using Emacs' built-in manual reader @code{woman}. This |
| 2303 | requires no external programs, but if you do have a port of | 2251 | requires no external programs, but if you do have a port of |
| 2304 | @command{man}, there is also an Emacs wrapper @code{man} that | 2252 | @command{man}, there is also an Emacs wrapper @code{man} that |
| 2305 | which may be slightly faster. | 2253 | which may be slightly faster. A Windows version of @command{man} is |
| 2254 | available from the EZWinPorts site (@pxref{EZWinPorts}). | ||
| 2306 | 2255 | ||
| 2307 | @c ------------------------------------------------------------ | 2256 | @c ------------------------------------------------------------ |
| 2308 | @node Further information | 2257 | @node Further information |
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index 84178277aab..cdf944041b6 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi | |||
| @@ -2674,8 +2674,16 @@ variable in the environment. | |||
| 2674 | @cindex Maximize frame | 2674 | @cindex Maximize frame |
| 2675 | @cindex Fullscreen mode | 2675 | @cindex Fullscreen mode |
| 2676 | 2676 | ||
| 2677 | Use the function @code{w32-send-sys-command}. For example, you can | 2677 | Beginning with Emacs 24.4 either run Emacs with the @samp{--maximized} |
| 2678 | put the following in your @file{.emacs} file: | 2678 | command-line option or put the following form in your @file{.emacs} |
| 2679 | file: | ||
| 2680 | |||
| 2681 | @lisp | ||
| 2682 | (add-hook 'emacs-startup-hook 'toggle-frame-maximized) | ||
| 2683 | @end lisp | ||
| 2684 | |||
| 2685 | With older versions use the function @code{w32-send-sys-command}. For | ||
| 2686 | example, you can put the following in your @file{.emacs} file: | ||
| 2679 | 2687 | ||
| 2680 | @lisp | 2688 | @lisp |
| 2681 | (add-hook 'emacs-startup-hook | 2689 | (add-hook 'emacs-startup-hook |