home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / TOOLS / MC3543B / install < prev    next >
Text File  |  1997-05-07  |  21KB  |  534 lines
  1. -*-text-*-
  2.  
  3. This file contains:
  4.  
  5. - Installation instructions and notes for the Midnight Commander
  6. - Where to get more information on the Midnight Commander
  7. - Common problems
  8. - Information on porting the program
  9. - Obtaining the missing pieces of the Midnight Commander
  10.  
  11.  
  12. Installation instructions for the Midnight Commander
  13. ----------------------------------------------------
  14.  
  15.    The `configure' shell script attempts to guess correct values for
  16. various system-dependent variables used during compilation, and creates
  17. the Makefile.  It also creates a file `config.status' that you can run
  18. in the future to recreate the current configuration.
  19.  
  20. (Nextstep users, make sure you read the "Compiling under Nextstep"
  21. section)
  22.  
  23. To compile this package:
  24.  
  25. 1.  Configure the package for your system.
  26.  
  27.    Normally, you just `cd' to the directory containing the package's
  28. source code and type `./configure'.  If you're using `csh' on an old
  29. version of System V, you might need to type `sh configure' instead to
  30. prevent `csh' from trying to execute `configure' itself (under AIX,
  31. you may need to use ksh instead of sh).
  32.  
  33.    Running `configure' takes a while.  While it is running, it
  34. prints some messages that tell what it is doing.  If you don't want to
  35. see any messages, run `configure' with its standard output redirected
  36. to `/dev/null'; for example, `./configure >/dev/null'.
  37.  
  38.    To compile the package in a different directory from the one
  39. containing the source code, you must use a version of `make' that
  40. supports the `VPATH' variable, such as GNU `make'.  `cd' to the
  41. directory where you want the object files and executables to go and run
  42. the `configure' script.  `configure' automatically checks for the
  43. source code in the directory that `configure' is in and in `..'.  If
  44. for some reason `configure' is not in the source code directory that
  45. you are configuring, then it will report that it can't find the source
  46. code.  In that case, run `configure' with the option `--srcdir=DIR',
  47. where DIR is the directory that contains the source code.
  48.  
  49.    By default, `make install' will install the package's files in
  50. `/usr/local/bin', `/usr/local/man', etc.  You can specify an
  51. installation prefix other than `/usr/local' by giving `configure' the
  52. option `--prefix=PATH'.  Alternately, you can do so by consistently
  53. giving a value for the `prefix' variable when you run `make', e.g.,
  54.      make prefix=/usr/gnu
  55.      make prefix=/usr/gnu install
  56.  
  57.    You can specify separate installation prefixes for
  58. architecture-specific files and architecture-independent files.  If
  59. you give `configure' the option `--exec-prefix=PATH' or set the `make'
  60. variable `exec_prefix' to PATH, the package will use PATH as the
  61. prefix for installing programs and libraries.  Data files and
  62. documentation will still use the regular prefix.  Normally, all files
  63. are installed using the same prefix.
  64.  
  65.     The program detects if you have the gpm library installed.  If you
  66. installed the gpm mouse library in a non-standard place, you will need
  67. to use the --with-gpm-mouse flag with the directory base where you
  68. installed the gpm package.
  69.  
  70.    `configure' also recognizes the following options:
  71.  
  72. `--help'
  73.      Print a summary of the options to `configure', and exit.
  74.  
  75. `--quiet'
  76. `--silent'
  77.      Do not print messages saying which checks are being made.
  78.  
  79. `--verbose'
  80.      Print the results of the checks.
  81.  
  82. `--version'
  83.      Print the version of Autoconf used to generate the `configure'
  84.      script, and exit.
  85.  
  86. `--with-debug'
  87.      Enables the built-in memory allocation debugger and forces
  88.      compilation with -Wall.  This is an option intended to be used by
  89.      the program developers.
  90.  
  91. `--without-edit'
  92.      Configures the program to be compiled without the built-in file
  93.      editor.   The built-in editor is compiled in by default.
  94.  
  95. `--with-ext2undel=PATH'
  96.      On systems that use the Extended 2 file system and have the
  97.      libext2fs.a library available, this compiles into the Midnight
  98.      Commander the support code for recovering deleted files (the
  99.      undel virtual file system). 
  100.  
  101. `--with-gpm-mouse=PATH'
  102.      Use this flag if your GPM mouse package is not installed in
  103.      a standard place.  The configure will append `lib' and
  104.      `include' to find the libgpm.a and gpm.h files respectively.
  105.  
  106. `--with-hsc'
  107.      Compiles support into the ftp virtual file system to support the
  108.      HSC firewall.
  109.  
  110. `--with-mmap'
  111.      Needed when compiling under AIX if you want the fast viewer.
  112.  
  113. `--with-sco'
  114.      This option is used to compile on SCO: it disables the terminal
  115.      resizing mechanism and uses the BSD-like pseudoterminal handling.
  116.  
  117. `--with-subshell[=optional]', `--without-subshell' 
  118.      The subshell support is by default turned on, you can disable
  119.      this by using the --without-subshell option.  If you pass the
  120.      =optional parameter, then the subshell support is turned off by
  121.      default, to turn it on, you have to specify the `-U' flag when
  122.      running the program.
  123.  
  124. `--with-termnet'
  125.      Enables the network support with the Term package.
  126.  
  127. `--with-tk'                    [WARNING: X code is not released]
  128.      This option enables including the Tcl/Tk version.
  129.  
  130. `--with-tk-includes=DIR'       [WARNING: X code is not released]
  131.      Lets you specify the place where you have your Tcl/Tk headers installed.
  132.      It should be a directory containing tcl.h and tk.h.
  133.  
  134. `--with-tk-libraries=DIR'      [WARNING: X code is not released]
  135.      Lets you specify the place where you have your Tcl/Tk libraries - 
  136.      libtcl and libtk.
  137.  
  138. `--with-xview'                 [WARNING: X code is not released]
  139.      This option enables including the XView version.
  140.  
  141. `--with-xview-includes=DIR'    [WARNING: X code is not released]
  142.      Lets you specify the place where you have your xview headers installed.
  143.      It should be the directory, which has subdirectories xview and
  144.      hopefuly xview_private.
  145.  
  146. `--with-xview-libraries=DIR'   [WARNING: X code is not released]
  147.      Lets you specify the place where you have your xview libraries - 
  148.      libolgx and libxview.
  149.  
  150. `--with-xv-bindir=DIR'         [WARNING: X code is not released]
  151.      Lets you specify the place where program mxc will be installed.
  152.      Default is somewhere in your XView binaries directory,
  153.      $OPENWINHOME/bin.
  154.  
  155. `--without-dusum'
  156.      This option disables a feature of the Midnight Commander, which is
  157.      forking the du command with the -s option when you want to calculate
  158.      directory sizes.
  159.  
  160. `--without-vfs'
  161.      This option disables the Virtual File System switch code in the
  162.      Midnight Commander and uses the standard file system calls for
  163.      file access.  If you specify this option you will not get the
  164.      transparent tar File system manipulation as well nor the
  165.      networked Midnight Commander file system.
  166.  
  167. You may also tell configure which display manager you want to use with
  168. the Midnight Commander.  The configure script will use SLang as default,
  169. but you can override this by using any of the following flags (please 
  170. note that slang is included as part of the distribution),
  171.  
  172. `--with-slang' (default)
  173.      This is used to configure the program to use the SLang screen
  174.      manager.  This is included as part of the Midnight Commander,
  175.      you don't need it installed on your system.
  176.      Slang is the only library that will let you resize the Midnight
  177.      Commander window on an xterm.
  178.  
  179.      This option will usually try to use the terminfo database if it
  180.      is available, otherwise it will use the termcap database.  At
  181.      compile time, you may force the use the terminal database with
  182.      the `--with-termcap' and `--with-terminfo' options.
  183.  
  184. `--with-ncurses[=directory]'
  185.      Use this flag (either with or without the =directory part), if
  186.      you want to compile with ncurses instead of the default SLang.
  187.  
  188.      Use the =directory part if your ncurses is not installed in any of the
  189.      places configure will check (/usr/include, /usr/include/ncurses,
  190.      /usr/local/include and /usr/local/include/ncurses).
  191.      The argument to this flag is the base directory where the ncurses
  192.      files are located.  The configure will append lib and include to
  193.      find the libncurses.a and ncurses.h file respectively.  For
  194.      example, if you have installed ncurses under /gnu/lib and
  195.      /gnu/include, you specify: --with-ncurses=/gnu
  196.  
  197.      You will need the ncurses package only if your system does not
  198.      provide a compatible curses.  If after compiling, the program
  199.      says that it can't resolve the has_colors function, then you need
  200.      the ncurses package or you may always go back to the included SLang
  201.      screen manager.
  202.  
  203. `--with-vcurses[=directory]'
  204.      Use this flag to force the Midnight Commander to use a SystemV
  205.      type ncurses, the optional directory specifies where should
  206.      the C compiler find the include files.
  207.  
  208. `--with-sunos-curses'
  209.      You use this flag on SunOS machines if you want to use SunOS 4.x
  210.      curses instead of ncurses.  You don't need this flag if you don't
  211.      have ncurses installed: it's only needed to force the usage of
  212.      SunOS curses over ncurses.
  213.  
  214.    `configure' also accepts and ignores some other options.
  215.  
  216.    On systems that require unusual options for compilation or linking
  217. that the package's `configure' script does not know about, you can give
  218. `configure' initial values for variables by setting them in the
  219. environment.  In Bourne-compatible shells, you can do that on the
  220. command line like this:
  221.  
  222.      CC='gcc -traditional' LIBS=-lposix ./configure
  223.  
  224. On systems that have the `env' program, you can do it like this:
  225.  
  226.      env CC='gcc -traditional' LIBS=-lposix ./configure
  227.  
  228.    Here are the `make' variables that you might want to override with
  229. environment variables when running `configure'.
  230.  
  231.    For these variables, any value given in the environment overrides the
  232. value that `configure' would choose:
  233.  
  234.  - Variable: CC
  235.      C compiler program.  The default is `cc'.
  236.  
  237.  - Variable: CFLAGS
  238.      The default flags used to build the program.
  239.  
  240.  - Variable: INSTALL
  241.      Program to use to install files.  The default is `install' if you
  242.      have it, `cp' otherwise.
  243.  
  244.    For these variables, any value given in the environment is added to
  245. the value that `configure' chooses:
  246.  
  247.  - Variable: LIBS
  248.      Libraries to link with, in the form `-lfoo -lbar...'.
  249.  
  250.    If you need to do unusual things to compile the package, we encourage
  251. you to figure out how `configure' could check whether to do them, and
  252. mail diffs or instructions to the address given in the README so we
  253. can include them in the next release.
  254.  
  255. 2.  Type `make' to compile the package.
  256.  
  257. 3.  If the package comes with self-tests and you want to run them,
  258. type `make check'.  If you're not sure whether there are any, try it;
  259. if `make' responds with something like
  260.     make: *** No way to make target `check'.  Stop.
  261. then the package does not come with self-tests.
  262.  
  263. 4.  Type `make install' to install programs, data files, and
  264. documentation.
  265. If your system is Linux, then install installs the Linux console screen
  266. saver as well.
  267.  
  268. 5.  You can remove the program binaries and object files from the
  269. source directory by typing `make clean'.  To also remove the
  270. Makefile(s), the header file containing system-dependent definitions
  271. (if the package uses one), and `config.status' (all the files that
  272. `configure' created), type `make realclean'. If you want to clean the source
  273. tree completely, so that it contains only those files that should be
  274. packaged in the archive, issue `make distclean'. If you've run configure in
  275. a different directory than the source tree, distclean won't remove your *.o
  276. and linked programs in that directory.
  277.  
  278. 6.  The Midnight Commander allows you to be kept on the directory you
  279. were when you quit the program, this is done with a shell function,
  280. the man page has more information about this.  If you want to let the
  281. install program make the change to your /etc/profile or your
  282. ~/.profile or ~/.bashrc, then type: `make mcfninstall'.
  283.  
  284.    The file `configure.in' is used to create `configure' by a program
  285. called `autoconf'.  You only need it if you want to regenerate
  286. `configure' using a newer version of `autoconf'.
  287.  
  288. Compiling under NeXTStep 
  289. ------------------------
  290.  
  291. These instructions were provided by Gregor Hoffleit
  292. <flight@mathi.uni-heidelberg.DE>, he recommends configuring the
  293. program like this:
  294.  
  295.  
  296. export CC="cc -posix"
  297. configure --without-subshell --with-termcap
  298. Edie config.h and make sure you have #undef HAVE_GETWD
  299. make
  300.  
  301.  
  302.  
  303. - Where to get more information on the Midnight Commander
  304. ---------------------------------------------------------
  305.  
  306. Janne Kukonlehto set up a WWW page, here is the URL:
  307. http://mc.blackdown.org/mc/
  308.  
  309. We also a set of mailing lists for the program:
  310.  
  311. mc-announce: Announcements of new version of the Midnight Commander.
  312. mc-digest:   Digest version of the mc list.
  313. mc-patches:  Patches by mail (also on the ftp site).
  314. mc:          Discussion on the Midnight Commander file manager.
  315. mc-devel:    For discussion between the developers of the program.
  316.  
  317. to subscribe to the mailing lists, send a message to:
  318.  
  319. majordomo@roxanne.nuclecu.unam.mx
  320.  
  321. with the following text in the body of the message:
  322.  
  323. subscribe <list-name> [address]
  324.  
  325. The address is optional and list-name is one of the above list names
  326. (mc, mc-announce, mc-patches or mc-digest).
  327.  
  328.  
  329. Notes about the Midnight Commander installation
  330. ------------------------------------------------
  331.  
  332. The Midnight Commander has been run in the following configurations:
  333.  
  334. i386-*-linux
  335. sparc-*-linux
  336. alpha-*-linux
  337. mips-dec-ultrix4.3
  338. mips-dec-{open,net}bsd1.0
  339. mips-sgi-irix5.2
  340. mips-sgi-irix5.3
  341. rs6000-ibm-aix3.2.5
  342. sparc-sun-sunos4.1
  343. sparc-sun-netbsd1.0
  344. sparc-sun-solaris2.3
  345. hppa-hp-hpux9
  346. hppa-hp-hpux7
  347. m68k-apple-aux
  348. mc88110-aviion-dgux5.4
  349. i386-*-{bsdi2,freebsd}
  350.  
  351. Since the Midnight Commander is configured via the GNU autoconf
  352. program, it's not difficult to run it in other operating systems.
  353.  
  354. If you're using AIX, with the cc6000 compiler, you have to specify the
  355. `--with-mmap' command line option. 
  356.  
  357. You will need GNU C (or an ANSI C Compiler) and optionally a color
  358. curses library (ncurses is a good choice).  The Midnight Commander now
  359. comes with the Slang screen manager, a fast screen manager, so ncurses
  360. is not required anymore unless you want to use it.  
  361.  
  362. Many Linux systems ship with ncurses version 1.8.0 or 1.8.1; the
  363. Midnight Commander may run with it, but some bugs in this version of
  364. NCurses sometimes make the display look strange (which is not the
  365. intention).  
  366.  
  367. VERY IMPORTANT NCURSES NOTE: On some architectures, the default
  368. compilation mode for ncurses it to include the buggy OPT_MVCUR in the
  369. Makefile.  If that is the case, please remove it before compiling.
  370.  
  371. Since version 0.9 the Midnight Commander comes with mouse support on
  372. xterms and in the Linux console. In order to take advantage of the
  373. mouse support on the Linux console you will need the gpm mouse server
  374. (see the section "Obtaining the Missing Pieces" in this file).
  375.  
  376. Once you get the Mouse Server, compile it and install it, then you
  377. will have to specify the `--with-gpm-mouse' flag to the configure
  378. program if you installed it in a non-standard directory.  If you
  379. installed the gpm package under /usr or /usr/local, you don't need to
  380. specify this flag; configure will find gpm for you.  The support for
  381. mice on xterms is always compiled in.
  382.  
  383. We are working on further enhancements to the program, but we're not
  384. sure which ones must go first.  If you would like to point us in the
  385. Right Direction we will be glad to hear from you (you could check the
  386. file TODO included with this distribution for the current projects).
  387.  
  388. If you happen to find an undocumented feature that doesn't do what you
  389. expected, please drop us a note telling us as much as you can about
  390. the problem you're experiencing (to miguel@roxanne.nuclecu.unam.mx).
  391.  
  392.  
  393. Porting the program
  394. -------------------
  395.  
  396. Random notes on porting to other architectures.  
  397.  
  398. The Midnight Commander uses now by default the Slang library for
  399. handling the display.  If you can't port Slang (which should be a
  400. pretty trivial job), you may want to attempt using ncurses (the
  401. Midnight Commander can use ncurses as well as the display engine). 
  402.  
  403. If you don't want to install ncurses and your OS is a SystemV Release
  404. 4 variant, maybe the curses supplied with your system will do the
  405. work.  If you experience display problems, then it means that we are
  406. dealing with a buggy implementation of curses.  You have two options:
  407. one, download ncurses and recompile with ncurses or recompile all your
  408. source code with the symbol BUGGY_CURSES defined.  But you can always
  409. switch to the default SLang screen manager.
  410.  
  411. The fast way to do this is to:
  412.  
  413. make clean; make XINC=-DBUGGY_CURSES
  414.  
  415. The correct thing is to add a detection case to the file ncurses.h
  416. (provided with this program) and again, run: make clean; make;
  417.  
  418. If you add the detection case, please, send me a patch, so that I
  419. could include it in future versions of the program.
  420.  
  421.  
  422. Obtaining the missing pieces of the Midnight Commander
  423. ------------------------------------------------------
  424.  
  425. The Midnight Commander will build without requiring you to get any
  426. other software packages, however, you may be interested in enhancing
  427. the Midnight Commander environment with some of these:
  428.  
  429. o Terminal database
  430.  
  431.   There are many incomplete terminal databases out there, you can get
  432.   the official termcap and terminfo database from the following URL:
  433.  
  434.   http://www.ccil.org/~esr/ncurses.html
  435.  
  436.   Some terminfo data are included with the mc distribution (lib/*.ti).
  437.   Particularly linux, xterm and vt100. Use e.g. ''tic linux.ti'' to
  438.   use them.
  439.  
  440.   If you want to run mc on xterm/color_xterm/ansi_xterm (not rxvt), then
  441.   you might read lib/README.xterm for further information.
  442.  
  443. o In the past the Midnight Commander required the NCurses library to
  444.   build, now it's optional and it's not the recommended way of using
  445.   it, but in case you feel nostalgic, you can get the NCurses library 
  446.   from:
  447.  
  448.   ftp.nuclecu.unam.mx:/Midnight
  449.   ftp.netcom.com:/pub/zm/zmbenhal
  450.  
  451.   When compiling ncurses, please check that you don't define
  452.   OPT_MVCUR since it's buggy.
  453.  
  454. o The GPM Mouse Server is available at:
  455.  
  456.   iride.unipv.it:/pub/gpm
  457.  
  458. o The X Windows System libraries are only used if you are going to
  459.   build the X11 versions of the program.  Please note that this code
  460.   is not finished, so it's only useful if you want to look at what we
  461.   are doing or want to help in one of the two X11 versions.
  462.   
  463. o The XView library can be obtained from (currently the newest is
  464.   XView3.2p1-X11R6.tar.gz):
  465.  
  466.   ftp.nuclecu.unam.mx:/Midnight/devel/XView.libs
  467.   ftp.x.org:/contrib/libraries
  468.   ftp.cvut.cz:/pub/x11/contrib/libraries
  469.  
  470.   - Linux/ELF shared binaries:
  471.  
  472.       sunsite.unc.edu:/pub/Linux/libs/X/xview
  473.       ftp.cvut.cz:/pub/linux/sunsite/libs/X/xview
  474.  
  475. o The Tcl/Tk libraries can be obtained from:
  476.  
  477.   ftp.smli.com:/pub/tcl
  478.   ftp.aud.alcatel.com:/tcl/ftp.smli.com
  479.   ftp.cvut.cz:/pub/tcl/ftp.smli.com
  480.  
  481.   - Linux/ELF shared binaries:
  482.  
  483.       ftp.ods.com:/pub/linux
  484.       ftp.cvut.cz:/pub/linux/ods
  485.  
  486. o The Xpm library (used by the XView version) can be obtained from
  487.   (currently xpm-3.4f.tar.gz):
  488.  
  489.   koala.inria.fr:/pub/xpm
  490.   ftp.x.org:/contrib/libraries
  491.   ftp.cvut.cz:/pub/x11/contrib/libraries
  492.  
  493.   - Linux/ELF shared binaries:
  494.  
  495.       ftp.ctd.comsat.com:/pub/linux/ELF
  496.       ftp.cvut.cz:/pub/linux/comsat
  497.  
  498. To get the mouse support working on the Linux console:
  499.  
  500. If you're using Linux version >= 1.1.34, then you will have to choose yes
  501. to selection when you compile your kernel. If your Linux version is
  502. older than this one, you may try to apply one of the patches included in
  503. the gpm package.
  504.  
  505. And the GNU C Compiler may be obtained from the following sites:
  506.  
  507.         ASIA: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:/ftpsync/prep,
  508.               cair.kaist.ac.kr:/pub/gnu
  509.         AUSTRALIA: archie.au:/gnu (archie.oz or archie.oz.au for ACSnet)
  510.         AFRICA: ftp.sun.ac.za:/pub/gnu
  511.         MIDDLE-EAST: ftp.technion.ac.il:/pub/unsupported/gnu
  512.         EUROPE: ftp.cvut.cz:/pub/gnu, irisa.irisa.fr:/pub/gnu, 
  513.               ftp.univ-lyon1.fr:pub/gnu, ftp.mcc.ac.uk, 
  514.               unix.hensa.ac.uk:/pub/uunet/systems/gnu,
  515.               src.doc.ic.ac.uk:/gnu, ftp.win.tue.nl, ugle.unit.no, 
  516.               ftp.denet.dk, ftp.informatik.rwth-aachen.de:/pub/gnu, 
  517.               ftp.informatik.tu-muenchen.de, ftp.eunet.ch, 
  518.               nic.switch.ch:/mirror/gnu, nic.funet.fi:/pub/gnu, isy.liu.se, 
  519.               ftp.stacken.kth.se, ftp.luth.se:/pub/unix/gnu, archive.eu.net
  520.         CANADA: ftp.cs.ubc.ca:/mirror2/gnu
  521.         USA: wuarchive.wustl.edu:/mirrors/gnu, labrea.stanford.edu,
  522.              ftp.kpc.com:/pub/mirror/gnu, ftp.cs.widener.edu, uxc.cso.uiuc.edu,
  523.              col.hp.com:/mirrors/gnu, ftp.cs.columbia.edu:/archives/gnu/prep,
  524.              gatekeeper.dec.com:/pub/GNU, ftp.uu.net:/systems/gnu
  525.  
  526.  
  527. Unsupported options to configure:
  528. ---------------------------------
  529. `--with-bsd-curses'
  530.      If you don't want to use ncurses and are using an Ultrix box, you
  531.      can use this switch.  Be aware that ncurses is a better option
  532.      than the curses included in Ultrix.
  533.  
  534.