*************************************************************************** Meadow Installation Manual *************************************************************************** 1. Caution o You CANNOT share elc files (byte-compiled lisp files) with Meadow-3.XX and Meadow-1.XX. 2. Preparation Meadow requires the following software. 2.1 ImageMagick ImageMagick is a collection of tools and libraries to read, write, and manipulate an image in many image formats. Currently Meadow supports only ImageMagick-6.2.0, so you should install this without fail. You can get these packages in the following URLs. o ImageMagick http://www.meadowy.org/meadow/dists/snapshot/ http://www.imagemagick.org/www/download.html 3. Installation You can select installation methods, 3.1 or 3.2 subsection. 3.1 Installation of binary archive. Please extract the archive of Meadow There are following binary archives. Meadow-${VERSION}-i386.tar.gz Intel x86 Binary For example, a name of Meadow version 3.00 is "Meadow-3.00-i386.tar.gz". !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! You can extract the arvhie with tar.exe and gzip.exe. ! ! If you want to use the other archiver, ! ! disable the feature of conversion LF into CR+LF. ! ! (Winzip enables this feature in the case of default.) ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! DON'T install Meadow to the directory whose name contains non-ascii ! ! characters ! ! and a white space. Maybe, you can install Meadow to such directories, ! ! but I don't verify its case. Similarly, you should not specify your ! ! home directory named with non-ascii characters. ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! If you want to install the archive to "c:/win32app/Meadow", please extract this at c:/win32app. For example, ----------------- c: [RETURN] cd \win32app [RETURN] tar zxvf Meadow--.tar.gz [RETURN] ----------------- You can get the following tree. c:/win32app/Meadow/ +---- bin/ Main programs +---- bitmap/ splash bitmapfile +---- etc/ Other data +---- info/ info directory +---- leim/ leim directory +---- lisp/ Emacs Lisp library +---- site-lisp/ site-lisp Emacs Lisp library +---- README.Meadow.ja +---- INSTALL.Meadow.ja +---- dot.emacs.ja sample of .emacs +---- install.exe Please execute "install.exe". In the "Meadow" directory, you will find "install.exe". It is an installtion program, please execute it. (by an explorer, a command prompt, and so on.) The installation program asks you where your HOME DIRECTORY is. Please input your HOME DIRECTORY. ;; FYI. ;; Your home directory is used for your personal space. ;; And you can put ".emacs" file here, then Meadow will read it. That's all. The installation program will install Meadow correctly. You can invoke Meadow from the "Start" menu. Its menu is stored in "Start -> Program -> Meadow -> Meadow". 3.2 Using Netinstaller Currently, No netinstaller for Meadow 2.20 is available. 4. Installation of source archive. Your compilation environment (Microsoft Visual C++ or Cygwin) make the following procedures different. 4.1 With Microsoft Visual C++ Please extract the archive of Meadow The source archive is named "Meadow--src.tar.gz" ;; is the version name of Meadow. ;; Please replace it to the version name. For example, if you want to put sources to c:/source ----------------- c: [RETURN] cd \source [RETURN] tar zxvf Meadow--src.tar.gz ----------------- Then you can get the follwing source tree. c:/source/Meadow-/-------src/ (Main source) +--lib-src/ (library and tools source) +--nt/ (configuration files for Meadow) +--info/ (info files) +--lisp/ (Emacs Lisp files) +--etc/ (Other data) +-- .... And so on Your compilation environment(Microsoft Visual C++ or Cygwin) make the following procedures different. ----------------- cd Meadow-\nt [RETURN] configure.meadow --with-msvc --prefix [RETURN] nmake bootstrap [RETURN] nmake all [RETURN] ----------------- You would be able to compile with Microsoft Visual C++ 6.x and 7.x. I presume that you can do it with other version of Visual C++. But I'm not sure. If you meet any problem, you must resolve by YOURSELF!!! :-) ----------------- nmake install [RETURN] ----------------- 4.2 With Cygwin Please extract the archive of Meadow in the same way as 4.1 STEP1. On a Cygwin shell(sh, bash and so forth), you should type the following command. ----------------- cd Meadow-/nt [RETURN] ./configure.meadow.bat --with-gcc --no-cygwin --no-debug --prefix [RETURN] make bootstrap [RETURN] make all [RETURN] ----------------- You would be able to compile with cmd.exe (or command.com). If you meet any problem, you must resolve by YOURSELF!!! :-) ----------------- make install [RETURN] ----------------- 5. Auxiliary programs 5.1 fakecygpty Meadow 3.XX can run cygwin commands needs pseudo terminal more naturally using fakecygpty as a wrapper program. This can be compiled only with cygwin gcc. You can compile it just as follows, and put the binary yielded into /bin directory. ----------------- cd nt gcc -o fakecygpty.exe fakecygpty.c cp fakecygpty.exe /bin/ ----------------- You can see how to use this program in the help of the variable mw32-process-wrapper-alist. Typical setting of the variable is following. You can put it into your .emacs file. ----------------- (setq mw32-process-wrapper-alist '(("/\\(bash\\|tcsh\\|svn\\|ssh\\|gpg[esvk]?\\)\\.exe" . (nil . "fakecygpty.exe")))) ----------------- That's all.