diff mac/INSTALL @ 32752:923b8d6d8277

Initial check-in: changes for building Emacs under Mac OS. 2000-10-23 Andrew Choi <[e-mail]> * dispextern.h [macintosh]: Include macgui.h instead of macterm.h. * dispnew.c [macintosh]: Include macterm.h. (init_display) [macintosh]: initialization for window system. * emacs.c (main) [macintosh]: Call syms_of_textprop, syms_of_macfns, syms_of_ccl, syms_of_fontset, syms_of_xterm, syms_of_search, x_term_init, and init_keyboard before calling init_window_once. Also, call syms_of_xmenu. * fontset.c (syms_of_fontset) [macintosh]: Set ASCII font of default fontset to Monaco. * frame.c [macintosh]: Include macterm.h. Remove declarations of NewMacWindow and DisposeMacWindow. (make_terminal_frame) [macintosh]: Call make_mac_terminal_frame instead of calling NewMacWindow and setting fields of f->output_data.mac directly. Call init_frame_faces. (Fdelete_frame) [macintosh]: Remove unused code. (Fmodify_frame_parameters) [macintosh]: Call x_set_frame_parameters instead of mac_set_frame_parameters. * frame.h [macintosh]: Define menu_bar_lines field in struct frame. Define FRAME_EXTERNAL_MENU_BAR macro. * keyboard.c [macintosh]: Include macterm.h. (kbd_buffer_get_event) [macintosh]: Generate delete_window_event and menu_bar_activate_event type events as for X and NT. (make_lispy_event) [macintosh]: Construct lisp events of type MENU_BAR_EVENT as for X and NT. * sysdep.c [macintosh]: Remove declaration for sys_signal. Include stdlib.h. Remove definition of Vx_bitmap_file_path. (sys_subshell) [macintosh]: Remove definition entirely. (init_sys_modes) [macintosh]: Do not initialize Vwindow_system and Vwindow_system_version here. Remove initialization of Vx_bitmap_file_path. (read_input_waiting): Correct the number of parameters passed to read_socket_hook. Move all Macintosh functions to mac/mac.c. * term.c [macintosh]: Include macterm.h. * window.c [macintosh]: Include macterm.h. * xdisp.c [macintosh]: Include macterm.h. Declare set_frame_menubar and pending_menu_activation. (echo_area_display) [macintosh]: Do not return if terminal frame is the selected frame. (update_menu_bar) [macintosh]: Check FRAME_EXTERNAL_MENU_BAR (f). Allow only the selected frame to set menu bar. (redisplay_window) [macintosh]: Obtain menu bar to redisplay by calling FRAME_EXTERNAL_MENU_BAR (f). (display_menu_bar) [macintosh]: Check FRAME_MAC_P (f). * xfaces.c [macintosh]: Include macterm.h. Define x_display_info and check_x. Declare XCreateGC. Define x_create_gc and x_free_gc. Initialize font_sort_order. (x_face_list_fonts) [macintosh]: Use the same code as WINDOWSNT, but call x_list_fonts instead of w32_list_fonts. (Finternal_face_x_get_resource) [macintosh]: Do not call display_x_get_resource. (prepare_face_for_display) [macintosh]: Set xgcv.font. (realize_x_face) [macintosh]: Load the font if it is specified in ATTRS. (syms_of_xfaces) [macintosh]: Initialize Vscalable_fonts_allowed to Qt. * cus-edit.el (custom-button-face): Use 3D look for mac. (custom-button-pressed-face): Likewise. * faces.el (set-face-attributes-from-resources): Handle mac frames in the same way as x and w32 frames. (face-valid-attribute-values): Likewise. (read-face-attribute): Likewise. (defined-colors): Likewise. (color-defined-p): Likewise. (color-values): Likewise. (display-grayscale-p): Likewise. (face-set-after-frame-default): Likewise. (mode-line): Same default face as for x and w32. (tool-bar): Likewise. * frame.el: Remove call to frame-notice-user-settings at end of the file. * info.el (Info-fontify-node): make underlines invisible for mac as for x, pc, and w32 frame types. * term/mac-win.el: New file.

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mac/INSTALL	Sun Oct 22 16:50:16 2000 +0000
@@ -0,0 +1,105 @@
+* BUILDING EMACS ON THE MAC OS     -*- outline -*-
+
+You can use either Metrowerks CodeWarrior Pro 5 or 6 or MPW-GM
+(Aug. 2000) to build Emacs.  MPW-GM can be downloaded free of charge
+from Apple at
+
+  http://developer.apple.com/tools/mpw-tools/
+
+You will need MPW-GM to build the make-docfile utility and to generate
+the doc string file DOC.
+
+To decompress files, you can use MacGzip from
+
+  http://persephone.cps.unizar.es/~spd/gzip
+
+and to untar them, you can use tar 4.0 from
+
+  http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/cmp/tar-40b.hqx
+
+(Optional) If you wish to fetch files from the Emacs CVS repository
+directly to your Mac, you can use the CVS client MacCVS, which can be
+downloaded from
+
+  http://www.wincvs.org/
+
+(Optional) A subset of the fonts from the GNU intlfonts-1.2
+distribution converted to NFNT format can be obtained from
+
+  ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin
+
+* BUILDING EMACS
+
+To build Emacs in the MPW Shell, simply set the directory to
+...:emacs:mac: and build the target Emacs of the make file
+makefile.mpw.  I.e., execute the commands
+
+  make Emacs -f makefile.MPW > Emacs.MakeScript
+  Emacs.MakeScript
+
+To build Emacs using CodeWarrior, start up the CodeWarrior IDE, choose
+File->Import Project...  and select the file emacs-cw5.mcp.xml or
+emacs-cw6.mcp.xml, depending on which verison of CodeWarrior used.
+When prompted to save the project, navigate to same directory as the
+file emacs-cw[56].mcp.xml, name it emacs-cw5.mcp or emacs-cw6.mcp, and
+save it there.  Then choose Project->Make.  Note that this does not
+build the DOC file.  To do so, use MPW and build the target "Doc" in
+makefile.MPW.
+
+Once built, the Emacs application (Emacs CW or Emacs MPW) can be
+launched where it is created.
+
+To build an optimized version of Emacs in CodeWarrior, change the
+value in the Emacs Settings->Code Generation->Global Optimization
+dialog.  To build a version for profiling, check the Profiler
+Information box in the Emacs Settings->Code Generation->PPC Processor
+dialog and include the Profiler PPC.Lib library.
+
+To build optimized or debugging version of Emacs in MPW, follow the
+comment in makefile.MPW to enable the -opt speed or -sym on option
+(see note below).
+
+The Mac version requires compiled Lisp files to be present in the lisp
+directory to run properly.  It is cumbersome to bootstrap from only
+the Lisp source files.  One way of getting the compiled Lisp files is
+to build Emacs once on, say, a Unix system and transfer that directory
+to the Mac.  Note that linefeed conversion must be disabled when
+transferring compiled Lisp files.
+
+An alternative is to unzip and untar the archive lisp-elc.tgz.  An
+older version of frame.elc in the archive may cause a problem when the
+Mac version starts up.  If this is the case, simply remove or rename
+that file.  Then once Emacs runs, you can invoke
+byte-recompile-directory on the lisp directory to byte-compile all
+out-of-date Lisp files.
+
+You may also need to run update-autoloads-from-directories on the lisp
+directory to bring loaddefs.el up-to-date.
+
+* NOTES
+
+Emacs should build and run on a PowerMac running Mac OS 8.1 - 9.0.
+
+You will need around 100 MB of disk space for the source files and
+intermediate files.
+
+It will not run on machines with more than 256 MB of physical or
+virtual memory.
+
+Currently there is no support for building the LEIM directory on the
+Mac.  However, it can be built on another platform and transferred to
+the Mac.
+
+When Emacs is built with "-opt speed" enabled in makefile.MPW,
+optimization causes the functions reset_buffer_local_variables in
+buffer.c and syms_of_lread in lread.c to crash.  Avoid this by
+enclosing them in the following pragmas.
+
+  #pragma options opt off
+
+  <function definition...>
+
+  #pragma options opt reset
+
+To use the same icon as when Emacs is built on Windows NT, define
+GNU_ICON in mac/src/Emacs.r.