aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorPaul Eggert2015-03-18 11:45:36 -0700
committerPaul Eggert2015-03-18 11:45:36 -0700
commit81deba3d7a2b187d58fe26bd8b4eafb5687095e1 (patch)
tree82feff9e8228de216840a6c96ba7c006ce337e24 /doc/misc
parent8dfff871bdf0e420c6f5570e72afc80471d40d51 (diff)
parent1a941d6c9eab9a35682408d6b85a1a98cfb6b01d (diff)
downloademacs-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/ChangeLog10
-rw-r--r--doc/misc/efaq-w32.texi425
-rw-r--r--doc/misc/efaq.texi12
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 @@
12015-03-18 Eli Zaretskii <eliz@gnu.org>
2
3 * efaq-w32.texi: Remove outdated information and update.
4
52015-03-18 Martin Rudalics <rudalics@gmx.at>
6
7 * efaq.texi (Fullscreen mode on MS-Windows): Fix description (Bug#20110).
8
12015-03-04 Michael Albinus <michael.albinus@gmx.de> 92015-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
172015-03-02 Daniel Colascione <dancol@dancol.org> 252015-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
130Emacs @value{EMACSVER} is known to run on all versions of Windows from 130Emacs @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? 131Windows 98 and Windows NT 4.0 through to Windows 8.1. The Windows
132Windows 98 and Windows NT 4.0 through to Windows 7. The Windows port is 132port is built using the Win32 API and supports most features of the X
133built using the Win32 API and supports most features of the X version, 133version, including variable width fonts, images and tooltips.
134including variable width fonts, images and tooltips. 134
135Emacs on Windows can be compiled as either a 32-bit or a 64-bit
136executable, 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
164Pre-compiled versions are distributed from 166Pre-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}.
166Emacs binaries are distributed as zip files, digitally 168Emacs binaries are distributed as zip files, digitally signed by the
167signed by the developer who built them. Generally most users will 169developer who built them. Generally most users will want the file
168want the file @file{emacs-@value{EMACSVER}-bin-i386.zip}, which 170@file{emacs-@value{EMACSVER}-bin-i686-pc-mingw.zip} for the 32-bit
169contains everything you need to get started. 171build, and @file{emacs-@value{EMACSVER}-bin-x86_64-w64-mingw32.zip}
172for the 64-bit build. The zip archive contains everything you need to
173get 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
190To compile Emacs on Windows, you will need the MingW or Cygwin port of 194To compile Emacs on Windows, you will need the MinGW port of GCC and
191GCC with MingW make, or a Microsoft C compiler with nmake and the 195Binutils, the MinGW runtime and development environment, and the MSYS
192single threaded C runtime library. Recent versions of Microsoft 196suite of tools. For the details, see the file @file{nt/INSTALL} in
193Visual Studio no longer come with the single threaded C runtime 197the Emacs source distribution.
194library, which is required for certain POSIX compatibility, so MingW 198
195is usually the best choice. Image support requires external 199Support for displaying images, as well as XML/HTML rendering and TLS
196libraries, the headers and import libraries for which will need to be 200networking requires external libraries, the headers and import
197installed where your compiler can find them. You will also need ports 201libraries for which will need to be installed where your compiler can
198of GNU @command{rm} and @command{cp}, as the Windows native 202find them. Again, the details, including URLs of sites where you can
199equivalents are not consistent between versions. GNU texinfo will be 203download these libraries are in @file{nt/INSTALL}. @xref{Other useful
200required to build the manuals. @xref{Other useful ports}. 204ports}, for auxiliary tools you may wish to install and use in
205conjunction with Emacs.
201 206
202After unpacking the source, or checking out of the repository, be sure 207After unpacking the source, or checking out of the repository, be sure
203to read the instructions in @file{nt/README} and @file{nt/INSTALL}. 208to 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}.
211By default, Emacs is compiled with debugging on, and optimizations enabled. 216By default, Emacs is compiled with debugging on, and optimizations enabled.
212The optimizations may interfere with some types of debugging; the debugger 217The optimizations may interfere with some types of debugging; the debugger
213may not show clearly where it is, or may not be able to inspect certain 218may not show clearly where it is, or may not be able to inspect certain
214variables. If this is the case, reconfigure with @option{--no-opt}. 219variables. If this is the case, reconfigure with @kbd{CFLAGS='-O0 -g3'}
215 220
216The file @file{etc/DEBUG} contains general debugging hints, as well as 221The file @file{etc/DEBUG} contains general debugging hints, as well as
217specific notes about debugging Emacs with both gdb and Microsoft debuggers. 222specific 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
229GDB is the GNU debugger, which can be used to debug Emacs when it has 225GDB is the GNU debugger, which can be used to debug Emacs when it has
230been compiled with GCC. The best results will be obtained if you 226been compiled with MinGW GCC. The best results will be obtained if
231start gdb from the @file{src} directory as @samp{gdb oo/i386/emacs.exe}. 227you start gdb from the @file{src} directory as @kbd{gdb ./emacs.exe}.
232This will load the init file @file{.gdbinit} in that directory, to 228This will load the init file @file{.gdbinit}@footnote{
233define some extra commands for working with lisp while debugging, and 229Latest versions of GDB might refuse to load the init file for security
234set up breakpoints to catch abnormal aborts. 230reasons, 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 233lisp while debugging, and set up breakpoints to catch abnormal
238@cindex MSVC++, debugging Emacs with 234aborts.
239@cindex DevStudio, debugging Emacs with 235
240@cindex debugging Emacs with MS DevStudio 236A Windows port of GDB can be found on MinGW download sites and on some
241 237others.
242MS DevStudio can be used to debug Emacs when it has been compiled with
243a Microsoft compiler. To view lisp variables, you can call the
244function @code{debug_print} from the Quickwatch window. Some
245@uref{http://www.gnu.org/software/emacs/windows/ntemacs/discuss/debug.txt,
246old 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.
279The binary distributions are distributed as zip files, which are handled 270The binary distributions are distributed as zip files, which are handled
280natively by Windows XP and later. For earlier versions, there are many 271natively by Windows XP and later. For earlier versions, there are many
281tools that can handle the zip format, from InfoZip's command line unzip 272tools that can handle the zip format, from InfoZip's command line unzip
282tool, to 7zip's multi-format graphical archive explorer. Although 273tool, to 7zip's multi-format graphical archive explorer. (Although
283popular, WinZip has caused problems with line-ends in the past, and is not 274popular, WinZip has caused problems with line-ends in the past, and is not
284Free software, so we do not recommend it. 275Free software, so we do not recommend it.)
285 276
286Source distributions are distributed as gzipped tar files. 7zip and 277Source distributions are distributed as @file{.tar.gz} or
287similar multi-format graphical tools can handle these, or you can get 278@file{.tar.xz} files. 7zip and similar multi-format graphical tools
288Windows ports of the command line gzip and tar tools from multiple sources. 279can handle these, or you can get Windows ports of the command line
280gzip and tar tools from multiple sources, or use @command{bsdtar}.
289@xref{Other useful ports}. 281@xref{Other useful ports}.
290 282
291The command to unpack a source distribution from the command line is: 283The command to unpack a source distribution from the command line is:
284
292@example 285@example
293tar xzf emacs-@value{EMACSVER}.tar.gz 286tar xzf emacs-@value{EMACSVER}.tar.gz
294@end example 287@end example
295 288
296If this does not work with the versions of tar and gzip that you have, 289If this does not work with the versions of tar and gzip that you have,
297you may need to try a two step process: 290you may need to try a two step process:
291
298@example 292@example
299gzip -dc emacs-@value{EMACSVER}.tar.gz | tar xvf - 293gzip -dc emacs-@value{EMACSVER}.tar.gz | tar xf -
300@end example 294@end example
301 295
302You may see many messages from tar complaining about being unable to change 296You 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
304broken pipe. These messages are usually harmless, caused by incomplete ports 298broken pipe. These messages are usually harmless, caused by incomplete ports
305that are not fully aware of the limitations of Windows. 299that are not fully aware of the limitations of Windows.
306 300
307@node Installing 301And 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
305bsdtar -xf emacs-@value{EMACSVER}.tar.xz
306@end example
307
308Expect @command{bsdtar} to unpack the whole distribution without any
309complaints.
310
311Once you unpack the source distribution, look in @file{nt/INSTALL}
312file 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.
313You can run Emacs without any extra steps, but if you want icons in your 320You can run Emacs without any extra steps, but if you want icons in your
314Start Menu, or for Emacs to detect the image libraries that are already 321Start Menu, or for Emacs to detect the image libraries that are already
315installed on your system as part of GTK, then you should run the program 322installed 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}
324directory 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
331Emacs has built in support for XBM and PBM/PGM/PPM images. This is 340Emacs has built in support for XBM and PBM/PGM/PPM images. This is
332sufficient to see the monochrome splash screen and tool-bar icons. 341sufficient to see the monochrome splash screen and tool-bar icons.
333Since 22.2, the official precompiled binaries for Windows have bundled 342Since v22.2, the official precompiled binaries for Windows have bundled
334libXpm, which is required to display the color versions of those images. 343libXpm, which is required to display the color versions of those images.
335 344
336Emacs is compiled to recognize JPEG, PNG, GIF and TIFF images also, 345Emacs is compiled to recognize JPEG, PNG, GIF, TIFF, and RSVG images
337but displaying these image types require external DLLs which are not 346also, but displaying these image types require external DLLs which are
338bundled with Emacs. @xref{Other useful ports}. 347not 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
345When Emacs starts up, it attempts to load and execute the contents of 354When Emacs starts up, it attempts to load and execute the contents of
346a file commonly called @file{.emacs} (though it may have other names, 355a 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
348customizations you have made. You can manually add lisp code to your 357contains any customizations you have made. You can manually add lisp
349.emacs, or you can use the Customization interface accessible from the 358code to your .emacs, or you can use the Customization interface
350@emph{Options} menu. If the file does not exist, Emacs will start 359accessible from the @emph{Options} menu. If the file does not exist,
351with the default settings. 360Emacs 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
361On Windows, the .emacs file may be called _emacs for backward 370On Windows, the @file{.emacs} file may be called @file{_emacs} for
362compatibility with DOS and FAT filesystems where filenames could not 371backward compatibility with DOS and FAT filesystems where filenames
363start with a dot. Some users prefer to continue using such a name, 372could not start with a dot. Some users prefer to continue using such
364because Explorer cannot create a file with a name starting with a dot, 373a name due to historical problems various Windows tools had in the
365even though the filesystem and most other programs can handle it. 374past with file names that begin with a dot. In Emacs 22 and later,
366In Emacs 22 and later, the init file may also be called 375the 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 376other files that are created by lisp packages are now stored in the
368by 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
369so this keeps all your Emacs related files in one place. 378files in one place.
370 379
371All the files mentioned above should go in your @env{HOME} directory. 380All the files mentioned above should go in your @env{HOME} directory.
372The @env{HOME} directory is determined by following the steps below: 381The @env{HOME} directory is determined by following the steps below:
@@ -387,14 +396,14 @@ backward compatibility, as previous versions defaulted to @file{C:/}
387if @env{HOME} was not set. 396if @env{HOME} was not set.
388@item 397@item
389Use the user's AppData directory, usually a directory called 398Use 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
391of which varies according to Windows version and whether the computer is 400of which varies according to Windows version and whether the computer is
392part of a domain. 401part of a domain.
393@end enumerate 402@end enumerate
394 403
395Within Emacs, @key{~} at the beginning of a file name is expanded to your 404Within 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}. 406by 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
415Look carefully at what is printed and make sure the value is 424Look carefully at what is printed in the echo area, and make sure the
416valid. For example, if the value has trailing whitespace, Emacs won't 425value is valid. For example, if the value has trailing whitespace,
417be able to find the directory. Also, be sure that the value isn't a 426Emacs won't be able to find the directory. Also, be sure that the
418relative drive letter (e.g., @file{d:} without a backslash); if it is, 427value isn't a relative drive letter (e.g., @file{d:} without a
419then @env{HOME} is going to be whatever the current directory on that 428backslash or a forward slash after the colon); if it is, then
420drive is, which is likely not what you want to happen. 429@env{HOME} is going to be whatever the current directory on that drive
430is, 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
489The location of the Desktop varies between different versions of 499The location of the Desktop varies between different versions of
490Windows, and in a corporate environment can be moved around by the 500Windows, and in a corporate environment can be moved around by the
491network administrator. On NT derivatives, you can use the value of 501network administrator. On latest Windows versions, you can use the
492the @env{USERPROFILE} environment variable to find where the desktop 502value of the @env{USERPROFILE} environment variable to find where the
493might be: 503desktop 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
524software available to change that though). The latter can be used to 534software available to change that though). The latter can be used to
525make Emacs use a focus-follow-mouse policy within its own frames. 535make Emacs use a focus-follow-mouse policy within its own frames.
526 536
537You can also change the Windows click-to-focus policy by changing
538settings in the Registry. The details vary according to your Windows
539version; look on the Internet for instructions to enable ``active
540window 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
576Message-ID: <fawg21mm4hm.fsf@@mordor.rsn.hp.com> 591Message-ID: <fawg21mm4hm.fsf@@mordor.rsn.hp.com>
577Subject: Re: Re[2]: problem with caps/ctrl swap on NT 4.0 592Subject: Re: Re[2]: problem with caps/ctrl swap on NT 4.0
578@end ignore 593@end ignore
579@example 594@smallexample
580It's a binary value that lets you map keystrokes in the low-level keyboard 595It's a binary value that lets you map keystrokes in the low-level keyboard
581drivers in NT. As a result you don't have to worry about applications 596drivers in NT. As a result you don't have to worry about applications
582bypassing mappings that you've done at a higher level (i.e. it just works). 597bypassing 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
601This registry value is system wide, and can't be made user-specific. It 616This registry value is system wide, and can't be made user-specific. It
602also only takes affect on reboot. 617also only takes affect on reboot.
603@end example 618@end smallexample
604@item 619@item
605Ulfar Erlingsson has provided a registry file that sets the CapsLock key 620Ulfar Erlingsson has provided a registry file that sets the CapsLock key
606to be a Control key and the Windows key to be an Alt key: 621to 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
663to be reactivated to operate on it, unless @code{mark-even-if-inactive} 678to be reactivated to operate on it, unless @code{mark-even-if-inactive}
664is set. Secondly, @code{transient-mark-mode} also highlights the 679is set. Secondly, @code{transient-mark-mode} also highlights the
665region when it is active, providing the same visual clue that you get 680region when it is active, providing the same visual clue that you get
666in other programs. 681in other programs. This mode is turned on by default in latest
682versions of Emacs.
667 683
668In addition to seeing the highlighting, new Emacs users often expect 684In addition to seeing the highlighting, new Emacs users often expect
669editing commands to replace the region when it is active. This behavior 685editing 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
719Emacs does not come with an uninstall program. No files are installed 735Emacs does not come with an uninstall program. No files are installed
720outside of the Emacs base directory, so deleting that directory is 736outside of the directories you find in the binary zip archive, so
721sufficient to clean away the files. If you ran @command{addpm}, 737deleting those directories is sufficient to clean away the files. If
722you'll need to delete the Start Menu group too. The registry entries 738you ran @command{addpm}, you'll need to delete the Start Menu group
723inserted by @command{addpm} will not cause any problems if you leave 739too. The registry entries inserted by @command{addpm} will not cause
724them there, but for the sake of completeness, you can use @command{regedit} 740any problems if you leave them there, but for the sake of
725to remove the keys under @code{HKEY_LOCAL_MACHINE} orx 741completeness, 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
745Paths\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
751corrupted while unpacking and Emacs will not start. 769corrupted while unpacking and Emacs will not start.
752@end enumerate 770@end enumerate
753 771
754If it is still not working, send mail to the list, describing what 772If it is still not working, send mail to the
755you'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
756the more likely it is that you'll receive a helpful response.. 774done, and what you are seeing. (The more information you send the more
775likely 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)
910based when fonts are listed, which may let you differentiate between two 928based when fonts are listed, which may let you differentiate between two
911fonts with the same name and different technologies. 929fonts with the same name and different technologies.
912 930
913From Emacs 23, the preferred font name format will be moving to the simpler 931Starting with Emacs 23, the preferred font name format will be moving
914and more flexible fontconfig format. XLFD names will continue to be 932to the simpler and more flexible fontconfig format. XLFD names will
915supported for backward compatibility. 933continue to be supported for backward compatibility.
916 934
917@example 935@example
918XLFD: -*-Courier New-normal-r-*-*-13-*-*-*-c-*-iso8859-1 936XLFD: -*-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
980The @code{w32-enable-synthesized-fonts} variable is obsolete starting
981from 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
986For many languages, native truetype fonts are sufficient, and in Emacs 1007For many languages, native truetype fonts are sufficient, and in Emacs
98723 the need for BDF fonts will disappear for almost all languages. At 100823 the need for BDF fonts will disappear for almost all languages. At
988the time of writing, some Arabic characters in the HELLO file still do 1009the time of writing, all supported characters are able to be displayed
989not display with native fonts, because they are pre-composed characters 1010with appropriate truetype or opentype fonts.
990from MULE character sets rather than standard Unicode Arabic, but all
991other characters are able to be displayed with appropriate truetype or
992opentype 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
1046Alternatively, you can augment the default fontset with information of
1047which fonts to use for certain ranges of characters or for specific
1048scripts/character sets. @xref{Modifying Fontsets,, Modifying
1049Fontsets, emacs, The GNU Emacs Manual}, for details and some useful
1050examples.
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
1037In addition to the wide range of fonts that come with the language 1061In addition to the wide range of fonts that come with the language
1038support packages of various components of Windows itself, GNU/Linux 1062support packages of various components of Windows itself, GNU/Linux
1039distributions these days come with a number of Free truetype fonts 1063distributions these days come with a number of Free truetype fonts
1040that cover a wide range of languages. The GNU intlfonts source 1064that cover a wide range of languages. The GNU Unifont project
1041distribution contains BDF fonts covering all of the languages that can 1065contains glyphs for most of the Unicode codespace, and can be
1042be displayed by Emacs 22, and can be downloaded from 1066downloaded from @uref{http://ftpmirror.gnu.org/unifont, ftp.gnu.org
1043@uref{http://ftpmirror.gnu.org/intlfonts, ftp.gnu.org mirrors}. 1067mirrors}.
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
1058and using a different font behind the scenes). 1082and using a different font behind the scenes).
1059@xref{Non-latin display}. 1083@xref{Non-latin display}.
1060 1084
1061In addition to defining a fontset with the expected font, you may also need
1062to 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
1073based on your locale, which will let Emacs use font names in your local 1091based on your locale, which will let Emacs use font names in your local
1074language successfully. 1092language 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
1087To use bdf fonts with Emacs, you need to tell Emacs where the fonts
1088are located, create fontsets for them, and then use them. We'll use
1089the 16 dot international fonts from @uref{http://ftpmirror.gnu.org/intlfonts,
1090ftp.gnu.org/gnu/intlfonts} as an
1091example put together by Jason Rumney.
1092
1093Download @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
1095fonts returned by using @code{w32-find-bdf-fonts} to enumerate all of
1096the 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
1098to 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
1110Then create fontsets for the BDF fonts:
1111
1112@example
1113(create-fontset-from-fontset-spec
1114 "-*-fixed-medium-r-normal-*-16-*-*-*-c-*-fontset-bdf,
1115japanese-jisx0208:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0208.1983-*,
1116katakana-jisx0201:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0201*-*,
1117latin-jisx0201:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0201*-*,
1118japanese-jisx0208-1978:-*-*-medium-r-normal-*-16-*-*-*-c-*-jisx0208.1978-*,
1119thai-tis620:-misc-fixed-medium-r-normal--16-160-72-72-m-80-tis620.2529-1,
1120lao:-misc-fixed-medium-r-normal--16-160-72-72-m-80-MuleLao-1,
1121tibetan-1-column:-TibMdXA-fixed-medium-r-normal--16-160-72-72-m-80-MuleTibetan-1,
1122ethiopic:-Admas-Ethiomx16f-Medium-R-Normal--16-150-100-100-M-160-Ethiopic-Unicode,
1123tibetan:-TibMdXA-fixed-medium-r-normal--16-160-72-72-m-160-MuleTibetan-0")
1124@end example
1125
1126Many of the international bdf fonts from gnu.org are type 0, and therefore
1127need 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
1144You can now use the Emacs font menu (@pxref{Fonts and text
1145translation,,How can I have Emacs use a font menu like on X?}) to
1146select the @emph{bdf: 16-dot medium} fontset, or you can select it by
1147setting the default font:
1148
1149@example
1150 (set-frame-font "fontset-bdf")
1151@end example
1152
1153Try loading the file @file{etc/HELLO}, and you should be able to see the
1154various international fonts displayed (except for Hindi, which is not
1155included 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}.
1220It does this to be safe, as no data loss will occur if the file is really 1161It does this to be safe, as no data loss will occur if the file is really
1221binary and the Ctrl-M characters are significant. 1162binary 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
1229The variable @code{file-name-buffer-file-type-alist} holds a list of
1230filename patterns and their associated type; binary or text. Files marked
1231as binary will not have line-end detection performed on them, and instead
1232will always be displayed as is. With auto-detection in recent versions of
1233Emacs, this is seldom useful for existing files, but can still be used
1234to 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
1260changes in printing technology from text and postscript based printers 1188changes in printing technology from text and postscript based printers
1261connected via ports that can be accessed directly, to graphical 1189connected via ports that can be accessed directly, to graphical
1262printers that are only accessible via USB. For details, see 1190printers 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
1264Wiki}. 1192Wiki}, @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}.
1293The quoting rules for native Windows shells and Cygwin shells have 1222The quoting rules for native Windows shells and Cygwin shells have
1294some subtle differences. When Emacs spawns subprocesses, it tries to 1223some subtle differences. When Emacs spawns subprocesses, it tries to
1295determine whether the process is a Cygwin program and changes its 1224determine whether the process is a Cygwin program and changes its
1296quoting mechanism appropriately. See this 1225quoting mechanism appropriately.
1297@uref{http://www.gnu.org/software/emacs/windows/ntemacs/discuss/shell-quoting,
1298previous 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
1357the buffering semantics. 1284the buffering semantics.
1358 1285
1359Some programs handle this by having an explicit flag to control their 1286Some programs handle this by having an explicit flag to control their
1360buffering behavior, typically @option{-i} for interactive. Other 1287buffering behavior, typically @option{-i} for interactive, or by a
1361programs manage to detect that they are running under Emacs, by 1288special environment variable. Other programs manage to detect that
1362using @samp{getenv("emacs")} internally. 1289they are running under Emacs, by using @samp{getenv("emacs")}
1290internally. Look in the program's documentation for the way around
1291this 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
1430You can start an interactive shell in Emacs by typing @kbd{M-x shell}. 1359You can start an interactive shell in Emacs by typing @kbd{M-x shell}.
1360By default, this will start the standard Windows shell @file{cmd.exe}.
1431Emacs uses the @env{SHELL} environment variable to determine which 1361Emacs uses the @env{SHELL} environment variable to determine which
1432program to use as the shell. To instruct Emacs to use a non-default 1362program to use as the shell. To instruct Emacs to use a non-default
1433shell, you can either set this environment variable, or customize 1363shell, 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
1470If you find that you are having trouble with Emacs tracking drive
1471changes with bash, see Mike Fabian's
1472@uref{http://www.gnu.org/software/emacs/windows/ntemacs/discuss/drive-tracking,
1473note}.
1474
1475WARNING: Some versions of bash set and use the environment variable 1400WARNING: Some versions of bash set and use the environment variable
1476PID. For some as yet unknown reason, if @env{PID} is set and Emacs 1401PID. For some as yet unknown reason, if @env{PID} is set and Emacs
1477passes it on to bash subshells, bash dies (Emacs can inherit the 1402passes 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
1491The package 1416The package
1492@uref{http://www.emacswiki.org/cgi-bin/wiki/cygwin-mount.el, 1417@uref{http://www.emacswiki.org/emacs/cygwin-mount.el,
1493cygwin-mount.el} teaches Emacs about Cygwin mount points. 1418cygwin-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.
1850GNU Aspell is a popular choice these days, Windows installers are 1775GNU Aspell is a popular choice these days, Windows installers are
1851available from the @uref{http://aspell.net/win32/, official site}. 1776available from the @uref{http://aspell.net/win32/, official site}.
1777Another possibility is Hunspell, which is available from
1778@uref{https://sourceforge.net/projects/ezwinports/files/?source=navbar,
1779the ezwinports site}.
1852 1780
1853Once installed, you will need to configure @code{ispell-program-name} 1781Once installed, you will need to configure @code{ispell-program-name}
1854to tell ispell and flyspell to use @command{aspell} as a replacement for 1782to tell ispell and flyspell to use @command{aspell} or
1855ispell. You can include the full path to the @file{aspell} binary, which 1783@command{hunspell} as a replacement for ispell. You can include the
1856means you do not need to add its installation directory to the @env{PATH}. 1784full path to the @file{aspell}/@file{hunspell} binary, which means you
1785do 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
1874We recommend using the GNU Compiler Collection for developing C/C++
1875code from Emacs. The MinGW development toolchain provides Windows
1876ports of GCC and other compilers.
1877
1878The rest of this chapter describes other alternatives which you may
1879need 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
1972Christopher Payne wrote a Visual Studio add-in that makes Emacs the 1908Christopher Payne wrote a Visual Studio add-in that makes Emacs the
1973default text editor, this has now been taken over by Jeff Paquette. 1909default text editor, this has now been taken over by Jeff Paquette.
1974See the following two URLS for details: 1910See 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
2230runs. This is intended to complement the MinGW tools to make it easier 2167runs. This is intended to complement the MinGW tools to make it easier
2231to port software to Windows. 2168to port software to Windows.
2232 2169
2170@node EZWinPorts
2171@section EZWinPorts
2172@cindex ezwinports
2173
2174The @uref{https://sourceforge.net/projects/ezwinports/, EZWinPorts
2175project} provides many useful ports of recent versions of GNU and Unix
2176software. 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,
2179Hunspell, 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
2253GnuWin32 provides precompiled native Windows ports of a wide selection 2201GnuWin32 provides precompiled native Windows ports of a wide selection
2254of Free software and libraries. Tools available here that are useful 2202of Free software and libraries. Unfortunately, the ports are
2255for Emacs include: 2203outdated. 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
2302read using Emacs' built-in manual reader @code{woman}. This 2250read using Emacs' built-in manual reader @code{woman}. This
2303requires no external programs, but if you do have a port of 2251requires 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
2305which may be slightly faster. 2253which may be slightly faster. A Windows version of @command{man} is
2254available 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
2677Use the function @code{w32-send-sys-command}. For example, you can 2677Beginning with Emacs 24.4 either run Emacs with the @samp{--maximized}
2678put the following in your @file{.emacs} file: 2678command-line option or put the following form in your @file{.emacs}
2679file:
2680
2681@lisp
2682(add-hook 'emacs-startup-hook 'toggle-frame-maximized)
2683@end lisp
2684
2685With older versions use the function @code{w32-send-sys-command}. For
2686example, 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