--- wininstall.texi.orig 2005-05-02 23:34:02.000000000 +0200 +++ wininstall.texi 2005-05-15 14:04:20.000000000 +0200 @@ -3,8 +3,8 @@ @end ifset Installation of @AUCTeX{} under Windows is a bit more complicated, but -we are working to resolve the issues involved. Please report -success/failure to us at @email{auctex-devel@@gnu.org}. Here are the +we are working to resolve the issues involved. Please report +success/failure to us at @email{auctex-devel@@gnu.org}. Here are the steps to perform: @enumerate @@ -12,30 +12,32 @@ If you unpacked the distribution using Winzip or similar, you better restart using infozip on the @samp{.zip} file, or standard Unix tools (see the next point) on the @samp{.tar.gz} file: tools that make the -mistake of turning Unix line endings into MSDOS line endings will cause -trouble later in installation and operation. +mistake of turning Unix line endings into MSDOS line endings will +cause trouble later in installation and operation. @item The installation of @AUCTeX{} will require the MSYS tool set from address@hidden://www.mingw.org}. If you have the Cygwin tool set from address@hidden://cygwin.com} installed, that should do just fine as well, -but it is quite larger and slower. address@hidden://www.mingw.org} or the Cygwin tool set from address@hidden://cygwin.com}. The latter is larger (the download size of +the base system is about 15 MB) but comes with a package manager that +allows for updating the tool set and installing additional packages +like, for example, the spell checker @w{aspell}. If you are installing @AUCTeX{} with one of those sets for an Emacs -compiled in a different one, you should try to avoid tool-specific path -names like @file{/cygwin/c}. Instead, use the @file{c:} syntax. It -might also help to use forward slashes instead of the backward slashes -more typical for @w{MS Windows}: while backward slashes are supposed to -work if properly escaped in the shell, this is one area easily -overlooked by the developers. The same holds for file or directory -names with spaces in them. Another noteworthy problem is that you -should be consistent with regard to using upper and lower case -characters for directory names: while Windows ignores any differences in -that area, the configuration scripts don't. +compiled in a different one, you should try to avoid tool-specific +path names like @file{/cygdrive/c}. Instead, use the @file{c:} +syntax. It might also help to use forward slashes instead of the +backward slashes more typical for @w{MS Windows}: while backward +slashes are supposed to work if properly escaped in the shell, this is +one area easily overlooked by the developers. The same holds for file +or directory names with spaces in them. Another noteworthy problem is +that you should be consistent with regard to using upper and lower +case characters for directory names: while Windows ignores any +differences in that area, the configuration scripts don't. It is appreciated if you report any problems you experienced when -installing @AUCTeX{}, as we are trying our best to make it work -even for platforms that we don't use ourselves. +installing @AUCTeX{}, as we are trying our best to make it work even +for platforms that we don't use ourselves. Compiling Emacs is outside of the scope of this manual. @AUCTeX{} itself does not require a @w{C compiler} for installation. @@ -45,38 +47,39 @@ @uref{http://www.xemacs.org} or try getting and compiling an @acronym{CVS} version of @w{GNU Emacs} from @uref{http://savannah.gnu.org/cvs/?group=emacs,Savannah}. Precompiled -versions happen to be available at @uref{http://www.crasseux.com/emacs/} -and @uref{http://nqmacs.sf.net/}. +versions happen to be available at address@hidden://www.crasseux.com/emacs/} and address@hidden://nqmacs.sf.net/}. If you disable the installation of @previewlatex{}, you might also use an @w{Emacs 21} binary from from @uref{http://ftp.gnu.org/pub/gnu/windows/emacs/}. @item -You need a working @TeX{} installation. One popular installation under -Windows is @uref{http://www.miktex.org,address@hidden Another much more -extensive system is @uref{http://www.tug.org/texlive,@address@hidden live}} -which is rather close to its Unix cousins. +You need a working @TeX{} installation. One popular installation +under Windows is @uref{http://www.miktex.org,address@hidden Another much +more extensive system is @uref{http://www.tug.org/texlive,@address@hidden +live}} which is rather close to its Unix cousins. @item @uref{http://www.perl.org,Perl} is needed for rebuilding the -documentation if you are working with a copy from @acronym{CVS} or have -touched documentation source files. This is needed for @previewlatex{} -documentation, strictly speaking. - address@hidden -Now the fun stuff starts. Unpack the @AUCTeX{} distribution into some -installation directory. @strong{Do not} unpack it right into your Emacs' -own directories: the installation will copy the material that needs to -be placed there. Keep the installation directory separate: you can -remove its contents after installation completes. Since you are reading -this, you probably have already unpacked @AUCTeX{}, but it should still -be easy to move it elsewhere now. - address@hidden -Ready for takeoff. Start some shell (typically @command{bash}) capable of -running @command{configure}, change into the installation directory and -call @command{./configure} with appropriate options. +documentation if you are working with a copy from @acronym{CVS} or +have touched documentation source files. This is needed for address@hidden documentation, strictly speaking. + address@hidden +Now the fun stuff starts. Unpack the @AUCTeX{} distribution into some +installation directory. @strong{Do not} unpack it right into your +Emacs' own directories: the installation will copy the material that +needs to be placed there. Keep the installation directory separate: +you can remove its contents after installation completes. Since you +are reading this, you probably have already unpacked @AUCTeX{}, but it +should still be easy to move it elsewhere now. + address@hidden +Ready for takeoff. Start some shell (typically @command{bash}) +capable of running @command{configure}, change into the installation +directory and call @command{./configure} with appropriate options. Typical options you'll want to specify will be @table @code @@ -84,36 +87,37 @@ which makes sure that (1) the AUCTeX manual will be installed in the @file{info/} directory of your Emacs installation and (2) the automatically generated global style hooks will be installed in the address@hidden/} directory of your Emacs installation. If you are collecting -stuff like that in a central directory hierarchy (not untypical with -Cygwin), you might want to specify that here instead. You stand a good -chance that this will be the only option you need to supply, as long as -your @TeX{}-related executables are in your system path, which they -better be for @AUCTeX{}'s operation, anyway. address@hidden/} directory of your Emacs installation. If you are +collecting stuff like that in a central directory hierarchy (not +untypical with Cygwin), you might want to specify that here instead. +You stand a good chance that this will be the only option you need to +supply, as long as your @TeX{}-related executables are in your system +path, which they better be for @AUCTeX{}'s operation, anyway. @item --with-emacs if you are installing for a version of Emacs. You can use @address@hidden/path/to/emacs}} to specify the name of the installed Emacs executable, complete with its path if necessary (if -Emacs is not within a directory specified in your @var{PATH} environment -setting). +Emacs is not within a directory specified in your @var{PATH} +environment setting). @item --with-xemacs if you are installing for a version of XEmacs. Again, you can use @address@hidden/path/to/xemacs}} to specify the name of the -installed XEmacs executable complete with its path if necessary. It may -also be necessary to specify this option if a copy of Emacs is found in -your @var{PATH} environment setting, but you still would like to install -a copy of @AUCTeX{} for XEmacs. +installed XEmacs executable complete with its path if necessary. It +may also be necessary to specify this option if a copy of Emacs is +found in your @var{PATH} environment setting, but you still would like +to install a copy of @AUCTeX{} for XEmacs. @item address@hidden/dir} This may be needed for GNU Emacs installation, but hopefully address@hidden should figure this out by itself. Don't use this for -XEmacs, rather use address@hidden should figure this out by itself. Don't use this +for XEmacs, rather use @item address@hidden/dir} -which gives the location of the package directory for XEmacs where stuff -should be installed. Again, hopefully this is not necessary to specify. +which gives the location of the package directory for XEmacs where +stuff should be installed. Again, hopefully this is not necessary to +specify. @item address@hidden/dir} Directory containing automatically generated information. You should @@ -131,7 +135,7 @@ @item Run @command{make} in the installation directory. - + @item Run @code{make install} in the installation directory. @@ -144,20 +148,20 @@ @end example The configuration for Windows systems is probably not quite fitting. -Instead of loading @file{tex-site.el} in that manner, you might want to -load @file{tex-mik.el} (for address@hidden) or @file{tex-fptex} (for address@hidden) instead. Those will lead to somewhat more appropriate values -for your system. You can always use +Instead of loading @file{tex-site.el} in that manner, you might want +to load @file{tex-mik.el} (for address@hidden) or @file{tex-fptex} (for address@hidden) instead. Those will lead to somewhat more appropriate +values for your system. You can always use @example - @kbd{M-x customize-group @key{RET} AUCTeX @key{RET}} address@hidden customize-group @key{RET} AUCTeX @key{RET}} @end example in order to customize more stuff, or use the @samp{Customize} menu. @item Load a @file{.tex} file Emacs or XEmacs and see if you get the address@hidden menu. Try using that to @LaTeX{} the file. address@hidden menu. Try using that to @LaTeX{} the file. @end enumerate Well, that about is all. Have fun!