From 13d5c72108de88e974d071ad717f4cfad4323c1d Mon Sep 17 00:00:00 2001 From: "Enrico Weigelt, metux IT service" Date: Sat, 10 Jan 2009 16:04:58 +0100 Subject: [PATCH] 2009-01-10 Enrico Weigelt, metux ITS * doc/*: moved manpages to doc/man/ * NEWS INSTALL README: moved to doc and left a symlink in . * FAQ HACKING INSTALL.FAST MAINTAINERS README.QNX TODO: moved to doc --- INSTALL | 370 +------------ configure.ac | 20 +- FAQ => doc/FAQ | 0 HACKING => doc/HACKING | 0 doc/INSTALL | 377 +++++++++++++ INSTALL.FAST => doc/INSTALL.FAST | 0 MAINTAINERS => doc/MAINTAINERS | 0 doc/Makefile.am | 12 +- doc/NEWS | 877 +++++++++++++++++++++++++++++++ doc/README | 176 +++++++ README.QNX => doc/README.QNX | 0 TODO => doc/TODO | 0 doc/es/Makefile.am | 10 +- doc/hu/Makefile.am | 10 +- doc/it/Makefile.am | 10 +- doc/man/Makefile.am | 8 + doc/man/es/Makefile.am | 7 + doc/{ => man}/es/mc.1.in | 0 doc/man/hu/Makefile.am | 7 + doc/{ => man}/hu/mc.1.in | 0 doc/man/it/Makefile.am | 7 + doc/{ => man}/it/mc.1.in | 0 doc/{ => man}/mc.1.in | 0 doc/{ => man}/mcedit.1.in | 0 doc/{ => man}/mcserv.8.in | 0 doc/{ => man}/mcview.1.in | 0 doc/man/pl/Makefile.am | 7 + doc/{ => man}/pl/mc.1.in | 0 doc/man/ru/Makefile.am | 7 + doc/{ => man}/ru/mc.1.in | 0 doc/man/sr/Makefile.am | 7 + doc/{ => man}/sr/mc.1.in | 0 doc/{ => man}/sr/mcserv.8.in | 0 doc/pl/Makefile.am | 10 +- doc/ru/Makefile.am | 10 +- doc/sr/Makefile.am | 14 +- 36 files changed, 1521 insertions(+), 425 deletions(-) mode change 100644 => 120000 INSTALL rename FAQ => doc/FAQ (100%) rename HACKING => doc/HACKING (100%) create mode 100644 doc/INSTALL rename INSTALL.FAST => doc/INSTALL.FAST (100%) rename MAINTAINERS => doc/MAINTAINERS (100%) create mode 100644 doc/NEWS create mode 100644 doc/README rename README.QNX => doc/README.QNX (100%) rename TODO => doc/TODO (100%) create mode 100644 doc/man/Makefile.am create mode 100644 doc/man/es/Makefile.am rename doc/{ => man}/es/mc.1.in (100%) create mode 100644 doc/man/hu/Makefile.am rename doc/{ => man}/hu/mc.1.in (100%) create mode 100644 doc/man/it/Makefile.am rename doc/{ => man}/it/mc.1.in (100%) rename doc/{ => man}/mc.1.in (100%) rename doc/{ => man}/mcedit.1.in (100%) rename doc/{ => man}/mcserv.8.in (100%) rename doc/{ => man}/mcview.1.in (100%) create mode 100644 doc/man/pl/Makefile.am rename doc/{ => man}/pl/mc.1.in (100%) create mode 100644 doc/man/ru/Makefile.am rename doc/{ => man}/ru/mc.1.in (100%) create mode 100644 doc/man/sr/Makefile.am rename doc/{ => man}/sr/mc.1.in (100%) rename doc/{ => man}/sr/mcserv.8.in (100%) diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 1ff7f5054..000000000 --- a/INSTALL +++ /dev/null @@ -1,369 +0,0 @@ -This file contains: - -- Installation instructions for GNU Midnight Commander -- Where to get more information on GNU Midnight Commander -- Notes about GNU Midnight Commander installation -- Obtaining related software - - -Installation instructions for GNU Midnight Commander ----------------------------------------------------- - -The `configure' shell script attempts to guess correct values for -various system-dependent variables used during compilation, and creates -the makefiles. It also creates a file `config.status' that you can run -in the future to recreate the current configuration. - -To compile this package: - -1. Configure the package for your system. - -Normally, you just `cd' to the directory containing the package's source -code and type `./configure'. If you're using `csh' on an old version of -SystemV, you might need to type `sh configure' instead to prevent `csh' -from trying to execute `configure' itself. Under AIX, you may need to -use ksh instead of sh. - -Running `configure' takes a while. While it is running, it prints some -messages that tell what it is doing. If you don't want to see any -messages, run `configure' with the `--quiet' option. - -To compile the package in a different directory than the one containing -the source code, you must use a version of `make' supporting the `VPATH' -variable, such as GNU `make'. Change to the directory where you want -the object files and executables to go and run the `configure' script -with the full path. If for some reason `configure' cannot find the -source code directory, run `configure' with the option `--srcdir=DIR', -where DIR is the directory that contains the source code. - -By default, `make install' will install the package's files in -`/usr/local/bin', `/usr/local/man', etc. You can specify an -installation prefix other than `/usr/local' by giving `configure' the -option `--prefix=PATH'. - -You can specify separate installation prefixes for architecture specific -files and architecture-independent files. If you give `configure' the -option `--exec-prefix=PATH', the package will use PATH as the prefix for -installing binary programs and libraries. Data files and documentation -will still use the regular prefix. Normally, all files are installed -using the same prefix. - -If compiled on GNU/Linux, Midnight Commander detects if you have the gpm -library installed. If you installed the gpm mouse library in a -non-standard place, you will need to use the --with-gpm-mouse flag with -the directory base where you installed the gpm package. - -`configure' recognizes the following options (the list may be -incomplete, use `configure --help' to get the full list): - -`--help' - Print a summary of the options to `configure' and exit. - -`--quiet' -`--silent' - Do not print messages saying which checks are being made. - -`--verbose' - Print the results of the checks. - -`--version' - Print the version of Autoconf used to generate the `configure' - script, and exit. - -`--without-edit' - Configure GNU Midnight Commander to be compiled without the - built-in file editor. The built-in editor is compiled in by - default. - -`--with-ext2undel' - On systems that use the ext2 or ext3 file system and have the - libext2fs library available, this option adds support for - recovering deleted files (the undel virtual file system). - -`--without-gpm-mouse' - Use this flag to disable gpm mouse support (e.g. if you want to - use mouse only on X terminals). - -`--with-glib12' - Force using glib 1.2.x even if glib 2.0.x is present. Use this - flag for testing or if you want to use the binary on systems that - don't have glib 2.0.x installed. - -`--with-glib-static' - Force linking against glib statically. This option is intended for - building binaries for distribution purposes and may not work on - some operating systems. - -`--with-mmap', `--without-mmap' - Force using or not using the mmap function. It is currently used - in the internal viewer. `--with-mmap' may be useful on some - versions of AIX where the `configure' script decides that mmap is - broken, but it's actually suitable for the internal viewer. - -`--with-subshell[=optional]', `--without-subshell' - The subshell support is by default turned on, you can disable - this by using the --without-subshell option. If you pass the - =optional parameter, then the subshell support is turned off by - default. To turn it on, specify the `-U' option to the program. - -`--without-x' - By default, the Midnight Commander tries to connect to the X Window - System events to query the status of the keyboard modifiers, such - as Control, Shift and Alt, when invoked in a terminal emulator - under X11. This is necessary (but not always sufficient) to - recognize some optional but handy key combinations like Ctrl-Home - and Shift-Cursor keys. Use `--without-x' if the dependency on - X11 libraries is not desired. - -`--without-vfs' - This option disables the Virtual File System switch code in the - Midnight Commander and uses the standard file system calls for - file access. If you specify this option, you won't get the - transparent access to archives and remote directories. - -`--with-mcfs' - This option enables mcfs - a non-standard remote filesystem - designed specifically for the Midnight Commander. It also enables - a server for that filesystem, mcserv. Please note that the - implementation of mcfs is not optimized for speed. There may be - security issues with mcserv - don't run it if you don't need it. - -`--with-samba' - This option enables remote VFS over the SMB protocol. A stripped - down version of samba distributed with the sources is compiled and - linked with the mc executable. It is recommended that you install - Samba client, since mc uses some files from Samba under certain - conditions. Please visit http://www.samba.org/ to learn more. - -`--disable-largefile' - This option disables support for large files (2 gigabytes and more) - on the systems where file operations use 32-bit offsets by default, - but support for 64-bit offsets is available. May be useful for - slow processors and embedded systems. - -`--enable-charset' - This option adds support for selecting character set of the text in - the internal viewer and editor and converting it on the fly. The - implementation of this option is currently incomplete. - -`--disable-background' - This option disables support for background operations. Background - operations allow to perform some tasks such as copying files in a - separate background process. Any messages from the background - process are forwarded to the foreground process. More advanced - dialogs cannot be forwarded yet, so the background process uses the - default. Background code is known to be less stable than the rest - of the code, so you may want to disable it at the compile time. - -`--disable-netcode' - This option disables support for networked virtual filesystems. - It's primarily used by developers to make sure that the code would - compile and run on operating systems that lack POSIX compatible - network support. But you can use it is you know that you won't be - accessing remote filesystems from GNU Midnight Commander. - -You may also tell configure which screen library you want to use with -the Midnight Commander. The configure script will use S-Lang as -default, and prefers an already installed S-Lang library over the -included one, but you can override this by using the following flag -(please note that since S-Lang is default, it is tested better than -ncurses): - -`--with-screen={slang|ncurses}' - Choose the library used to manage interaction with the terminal. - `slang' means S-Lang library already installed on the system, - `ncurses' means ncurses library already installed on the system. - The installed S-Lang library is used by default if found. - -On systems that require unusual options for compilation or linking that -the package's `configure' script does not know about, you can give -`configure' initial values for variables by placing them in the command -line: - -./configure CC='gcc -traditional' LIBS=-lposix - -Here are the variables that you might want to override when running -`configure'. - - - Variable: CC - C compiler program. The default is `gcc' if found, otherwise `cc'. - - - Variable: CFLAGS - The default flags used to build the program. - - - Variable: INSTALL - Program to use to install files. The default is `install' if you - have it, `cp' otherwise. - -For these variables, any value given in the command line is added to the -value that `configure' decides to use: - - - Variable: LIBS - Libraries to link with, in the form `-lfoo -lbar...'. - - - Variable: LDFLAGS - Linker flags, e.g. -L if you have libraries in a - nonstandard directory - - - Variable: CPPFLAGS - C/C++ preprocessor flags, e.g. -I if you have - headers in a nonstandard directory - -If you need to do unusual things to compile the package, we encourage -you to figure out how `configure' could check whether to do them, and -mail diffs or instructions to the address given in the README so we can -include them in the next release. - -2. Type `make' to compile the package. - -3. Type `make install' to install programs, data files, and the -documentation. On GNU/Linux the console screen saver is installed as -well. - -4. You can remove the program binaries and object files from the source -directory by typing `make clean'. If you want to clean the source tree -completely, so that it contains only those files that should be packaged -in the archive, issue `make distclean'. If you've run configure in a -different directory than the source tree, distclean won't remove your -*.o and linked programs in that directory. - -5. GNU Midnight Commander allows you to stay in the last current -directory after exiting MC. This is done with a shell function, the man -page has more information about this. - -The file `configure.in' is used to create `configure' by a program -called `autoconf'. You only need it if you want to regenerate -`configure' using a newer version of `autoconf'. - - -Where to get more information on GNU Midnight Commander -------------------------------------------------------- - -There are two mailing lists for the program: - -mc@gnome.org: Discussion on GNU Midnight Commander file manager. -mc-devel@gnome.org: Discussion between the developers of the program. - -To subscribe to the mailing lists, visit their respective pages: - -http://mail.gnome.org/mailman/listinfo/mc/ -http://mail.gnome.org/mailman/listinfo/mc-devel/ - - -Notes about GNU Midnight Commander installation ------------------------------------------------ - -GNU Midnight Commander has been run in the following configurations: - -i386-*-linux -sparc-*-linux -alpha-*-linux -powerpc-*-linux -mips-dec-ultrix4.3 -mips-dec-{open,net}bsd1.0 -mips-sgi-irix5.2 -mips-sgi-irix5.3 -rs6000-ibm-aix3.2.5 -sparc-sun-sunos4.1 -sparc-sun-netbsd1.0 -sparc-sun-solaris2.3 -hppa-hp-hpux9 -hppa-hp-hpux7 -m68k-apple-aux -mc88110-aviion-dgux5.4 -i386-*-bsdi2 -i386-*-freebsd4.3 -i386-*-openbsd2.9 - -Midnight Commander is written in a portable manner and uses GNU Autoconf -for configuration, so it is expected to compile without changes on many -other operating systems. - -You will need an ANSI C Compiler (such as GCC) and glib library to -compile the source. GNU Midnight Commander now comes with the S-Lang -screen manager, a fast screen manager, but you may want to use the -already installed S-Lang or ncurses library. - -If you insist on using ncurses, it's recommended to use ncurses 4.1 and -above, since the older versions don't support resizing in the xterm -window. - -GNU Midnight Commander comes with the mouse support on xterms and in the -Linux console. In order to take advantage of the mouse support on the -Linux console you will need the gpm mouse server (see the section -"Obtaining related software" in this file). - -Once you get gpm, compile it and install it, then you will have to -specify the `--with-gpm-mouse' flag to the configure program if you -installed it in a non-standard directory. If you installed the gpm -package under /usr or /usr/local, you don't need to specify this flag; -configure will find gpm for you. The support for mice on xterms is -always compiled in. - -We are working on further enhancements to the program, but we're not -sure which ones must go first. If you would like to point us in the -Right Direction we will be glad to hear from you (you could check the -file TODO included with this distribution for the current projects). - -If you happen to find a feature that doesn't do what you expect, please -write to mc@gnome.org telling as much as you can about the problem -you're experiencing. Please don't send personal messages to the -maintainers. - - -Obtaining related software --------------------------- - -glib ----- - -The only "hard" dependency of GNU Midnight Commander is glib. You can -get glib from - -ftp://ftp.gtk.org/pub/gtk/ - -Note that only versions 1.2.x and 2.0.x are supported. Newer versions -may work, but haven't been tested. - -Terminal database ------------------ - -There are many incomplete terminal databases out there, however, a -complete terminfo is bundled with ncurses. (It is simple to generate -the termcap database using the infocmp utility in ncurses). - -Some terminfo data are included with the mc distribution (lib/*.ti). -Particularly linux, xterm and vt100. Use e.g. ''tic linux.ti'' to use -them. - -If you want to run mc on xterm/color_xterm/ansi_xterm (not rxvt), then -you might read lib/README.xterm for further information. - -Screen libraries ----------------- - -GNU Midnight Commander can use the included version of S-Lang, but you -can get the latest version here: - -http://www.s-lang.org/ - -Alternatively, you can use ncurses: - -http://www.gnu.org/software/ncurses/ncurses.html - -Mouse support -------------- - -The general purpose mouse (gpm) daemon is available from - -ftp://arcana.linux.it/pub/gpm/ - -Compiler --------- - -If your C compiler is not powerful enough to compile GNU Midnight -Commander, you should report is as a bug to the GNU Midnight Commander -team. Sometimes there is no solution than upgrading to a modern and -free compiler - GCC (Compiler Collection): - -http://gcc.gnu.org/ diff --git a/INSTALL b/INSTALL new file mode 120000 index 000000000..5bb6e7b7e --- /dev/null +++ b/INSTALL @@ -0,0 +1 @@ +/usr/share/automake-1.10/INSTALL \ No newline at end of file diff --git a/configure.ac b/configure.ac index 29197950d..ade3c76ac 100644 --- a/configure.ac +++ b/configure.ac @@ -591,13 +591,19 @@ vfs/extfs/urar vfs/extfs/uzip vfs/extfs/uzoo -doc/mc.1 doc/mcedit.1 doc/mcview.1 doc/mcserv.8 -doc/es/mc.1 doc/es/Makefile -doc/hu/mc.1 doc/hu/Makefile -doc/it/mc.1 doc/it/Makefile -doc/pl/mc.1 doc/pl/Makefile -doc/ru/mc.1 doc/ru/Makefile -doc/sr/mc.1 doc/sr/mcserv.8 doc/sr/Makefile +doc/man/mc.1 doc/man/mcedit.1 doc/man/mcview.1 doc/man/mcserv.8 doc/man/Makefile +doc/man/es/mc.1 doc/man/es/Makefile +doc/man/hu/mc.1 doc/man/hu/Makefile +doc/man/it/mc.1 doc/man/it/Makefile +doc/man/pl/mc.1 doc/man/pl/Makefile +doc/man/ru/mc.1 doc/man/ru/Makefile +doc/man/sr/mc.1 doc/man/sr/mcserv.8 doc/man/sr/Makefile +doc/es/Makefile +doc/hu/Makefile +doc/it/Makefile +doc/pl/Makefile +doc/ru/Makefile +doc/sr/Makefile intl/Makefile po/Makefile.in diff --git a/FAQ b/doc/FAQ similarity index 100% rename from FAQ rename to doc/FAQ diff --git a/HACKING b/doc/HACKING similarity index 100% rename from HACKING rename to doc/HACKING diff --git a/doc/INSTALL b/doc/INSTALL new file mode 100644 index 000000000..7081b987f --- /dev/null +++ b/doc/INSTALL @@ -0,0 +1,377 @@ +This file contains: + +- Installation instructions for GNU Midnight Commander +- Where to get more information on GNU Midnight Commander +- Notes about GNU Midnight Commander installation +- Obtaining related software + + +Installation instructions for GNU Midnight Commander +---------------------------------------------------- + +The `configure' shell script attempts to guess correct values for +various system-dependent variables used during compilation, and creates +the makefiles. It also creates a file `config.status' that you can run +in the future to recreate the current configuration. + +To compile this package: + +1. Configure the package for your system. + +Normally, you just `cd' to the directory containing the package's source +code and type `./configure'. If you're using `csh' on an old version of +SystemV, you might need to type `sh configure' instead to prevent `csh' +from trying to execute `configure' itself. Under AIX, you may need to +use ksh instead of sh. + +Running `configure' takes a while. While it is running, it prints some +messages that tell what it is doing. If you don't want to see any +messages, run `configure' with the `--quiet' option. + +To compile the package in a different directory than the one containing +the source code, you must use a version of `make' supporting the `VPATH' +variable, such as GNU `make'. Change to the directory where you want +the object files and executables to go and run the `configure' script +with the full path. If for some reason `configure' cannot find the +source code directory, run `configure' with the option `--srcdir=DIR', +where DIR is the directory that contains the source code. + +By default, `make install' will install the package's files in +`/usr/local/bin', `/usr/local/man', etc. You can specify an +installation prefix other than `/usr/local' by giving `configure' the +option `--prefix=PATH'. + +You can specify separate installation prefixes for architecture specific +files and architecture-independent files. If you give `configure' the +option `--exec-prefix=PATH', the package will use PATH as the prefix for +installing binary programs and libraries. Data files and documentation +will still use the regular prefix. Normally, all files are installed +using the same prefix. + +If compiled on GNU/Linux, Midnight Commander detects if you have the gpm +library installed. If you installed the gpm mouse library in a +non-standard place, you will need to use the --with-gpm-mouse flag with +the directory base where you installed the gpm package. + +`configure' recognizes the following options (the list may be +incomplete, use `configure --help' to get the full list): + +`--help' + Print a summary of the options to `configure' and exit. + +`--quiet' +`--silent' + Do not print messages saying which checks are being made. + +`--verbose' + Print the results of the checks. + +`--version' + Print the version of Autoconf used to generate the `configure' + script, and exit. + +`--without-edit' + Configure GNU Midnight Commander to be compiled without the + built-in file editor. The built-in editor is compiled in by + default. + +`--with-ext2undel' + On systems that use the ext2 or ext3 file system and have the + libext2fs library available, this option adds support for + recovering deleted files (the undel virtual file system). + +`--without-gpm-mouse' + Use this flag to disable gpm mouse support (e.g. if you want to + use mouse only on X terminals). + +`--with-glib12' + Force using glib 1.2.x even if glib 2.0.x is present. Use this + flag for testing or if you want to use the binary on systems that + don't have glib 2.0.x installed. + +`--with-glib-static' + Force linking against glib statically. This option is intended for + building binaries for distribution purposes and may not work on + some operating systems. + +`--with-mmap', `--without-mmap' + Force using or not using the mmap function. It is currently used + in the internal viewer. `--with-mmap' may be useful on some + versions of AIX where the `configure' script decides that mmap is + broken, but it's actually suitable for the internal viewer. + +`--with-subshell[=optional]', `--without-subshell' + The subshell support is by default turned on, you can disable + this by using the --without-subshell option. If you pass the + =optional parameter, then the subshell support is turned off by + default. To turn it on, specify the `-U' option to the program. + +`--without-x' + By default, the Midnight Commander tries to connect to the X Window + System events to query the status of the keyboard modifiers, such + as Control, Shift and Alt, when invoked in a terminal emulator + under X11. This is necessary (but not always sufficient) to + recognize some optional but handy key combinations like Ctrl-Home + and Shift-Cursor keys. Use `--without-x' if the dependency on + X11 libraries is not desired. + +`--without-vfs' + This option disables the Virtual File System switch code in the + Midnight Commander and uses the standard file system calls for + file access. If you specify this option, you won't get the + transparent access to archives and remote directories. + +`--with-mcfs' + This option enables mcfs - a non-standard remote filesystem + designed specifically for the Midnight Commander. It also enables + a server for that filesystem, mcserv. Please note that the + implementation of mcfs is not optimized for speed. There may be + security issues with mcserv - don't run it if you don't need it. + +`--with-samba' + This option enables remote VFS over the SMB protocol. A stripped + down version of samba distributed with the sources is compiled and + linked with the mc executable. It is recommended that you install + Samba client, since mc uses some files from Samba under certain + conditions. Please visit http://www.samba.org/ to learn more. + +`--disable-largefile' + This option disables support for large files (2 gigabytes and more) + on the systems where file operations use 32-bit offsets by default, + but support for 64-bit offsets is available. May be useful for + slow processors and embedded systems. + +`--enable-charset' + This option adds support for selecting character set of the text in + the internal viewer and editor and converting it on the fly. The + implementation of this option is currently incomplete. + +`--disable-background' + This option disables support for background operations. Background + operations allow to perform some tasks such as copying files in a + separate background process. Any messages from the background + process are forwarded to the foreground process. More advanced + dialogs cannot be forwarded yet, so the background process uses the + default. Background code is known to be less stable than the rest + of the code, so you may want to disable it at the compile time. + +`--disable-netcode' + This option disables support for networked virtual filesystems. + It's primarily used by developers to make sure that the code would + compile and run on operating systems that lack POSIX compatible + network support. But you can use it is you know that you won't be + accessing remote filesystems from GNU Midnight Commander. + +You may also tell configure which screen library you want to use with +the Midnight Commander. The configure script will use S-Lang as +default, and prefers an already installed S-Lang library over the +included one, but you can override this by using the following flag +(please note that since S-Lang is default, it is tested better than +ncurses): + +`--with-screen={slang|mcslang|ncurses}' + Choose the library used to manage interaction with the terminal. + `slang' means S-Lang library already installed on the system, + `mcslang' means S-Lang library included with the sources of + GNU Midnight Commander, `ncurses' means ncurses library already + installed on the system. The installed S-Lang library is used + by default if found, otherwise the included S-Lang library is + used. + +`--with-termcap' + If the included S-Lang library is used, this option forces it to + use the termcap database, as opposed to the default terminfo + database. + +On systems that require unusual options for compilation or linking that +the package's `configure' script does not know about, you can give +`configure' initial values for variables by placing them in the command +line: + +./configure CC='gcc -traditional' LIBS=-lposix + +Here are the variables that you might want to override when running +`configure'. + + - Variable: CC + C compiler program. The default is `gcc' if found, otherwise `cc'. + + - Variable: CFLAGS + The default flags used to build the program. + + - Variable: INSTALL + Program to use to install files. The default is `install' if you + have it, `cp' otherwise. + +For these variables, any value given in the command line is added to the +value that `configure' decides to use: + + - Variable: LIBS + Libraries to link with, in the form `-lfoo -lbar...'. + + - Variable: LDFLAGS + Linker flags, e.g. -L if you have libraries in a + nonstandard directory + + - Variable: CPPFLAGS + C/C++ preprocessor flags, e.g. -I if you have + headers in a nonstandard directory + +If you need to do unusual things to compile the package, we encourage +you to figure out how `configure' could check whether to do them, and +mail diffs or instructions to the address given in the README so we can +include them in the next release. + +2. Type `make' to compile the package. + +3. Type `make install' to install programs, data files, and the +documentation. On GNU/Linux the console screen saver is installed as +well. + +4. You can remove the program binaries and object files from the source +directory by typing `make clean'. If you want to clean the source tree +completely, so that it contains only those files that should be packaged +in the archive, issue `make distclean'. If you've run configure in a +different directory than the source tree, distclean won't remove your +*.o and linked programs in that directory. + +5. GNU Midnight Commander allows you to stay in the last current +directory after exiting MC. This is done with a shell function, the man +page has more information about this. + +The file `configure.in' is used to create `configure' by a program +called `autoconf'. You only need it if you want to regenerate +`configure' using a newer version of `autoconf'. + + +Where to get more information on GNU Midnight Commander +------------------------------------------------------- + +There are two mailing lists for the program: + +mc@gnome.org: Discussion on GNU Midnight Commander file manager. +mc-devel@gnome.org: Discussion between the developers of the program. + +To subscribe to the mailing lists, visit their respective pages: + +http://mail.gnome.org/mailman/listinfo/mc/ +http://mail.gnome.org/mailman/listinfo/mc-devel/ + + +Notes about GNU Midnight Commander installation +----------------------------------------------- + +GNU Midnight Commander has been run in the following configurations: + +i386-*-linux +sparc-*-linux +alpha-*-linux +powerpc-*-linux +mips-dec-ultrix4.3 +mips-dec-{open,net}bsd1.0 +mips-sgi-irix5.2 +mips-sgi-irix5.3 +rs6000-ibm-aix3.2.5 +sparc-sun-sunos4.1 +sparc-sun-netbsd1.0 +sparc-sun-solaris2.3 +hppa-hp-hpux9 +hppa-hp-hpux7 +m68k-apple-aux +mc88110-aviion-dgux5.4 +i386-*-bsdi2 +i386-*-freebsd4.3 +i386-*-openbsd2.9 + +Midnight Commander is written in a portable manner and uses GNU Autoconf +for configuration, so it is expected to compile without changes on many +other operating systems. + +You will need an ANSI C Compiler (such as GCC) and glib library to +compile the source. GNU Midnight Commander now comes with the S-Lang +screen manager, a fast screen manager, but you may want to use the +already installed S-Lang or ncurses library. + +If you insist on using ncurses, it's recommended to use ncurses 4.1 and +above, since the older versions don't support resizing in the xterm +window. + +GNU Midnight Commander comes with the mouse support on xterms and in the +Linux console. In order to take advantage of the mouse support on the +Linux console you will need the gpm mouse server (see the section +"Obtaining related software" in this file). + +Once you get gpm, compile it and install it, then you will have to +specify the `--with-gpm-mouse' flag to the configure program if you +installed it in a non-standard directory. If you installed the gpm +package under /usr or /usr/local, you don't need to specify this flag; +configure will find gpm for you. The support for mice on xterms is +always compiled in. + +We are working on further enhancements to the program, but we're not +sure which ones must go first. If you would like to point us in the +Right Direction we will be glad to hear from you (you could check the +file TODO included with this distribution for the current projects). + +If you happen to find a feature that doesn't do what you expect, please +write to mc@gnome.org telling as much as you can about the problem +you're experiencing. Please don't send personal messages to the +maintainers. + + +Obtaining related software +-------------------------- + +glib +---- + +The only "hard" dependency of GNU Midnight Commander is glib. You can +get glib from + +ftp://ftp.gtk.org/pub/gtk/ + +Note that only versions 1.2.x and 2.0.x are supported. Newer versions +may work, but haven't been tested. + +Terminal database +----------------- + +There are many incomplete terminal databases out there, however, a +complete terminfo is bundled with ncurses. (It is simple to generate +the termcap database using the infocmp utility in ncurses). + +Some terminfo data are included with the mc distribution (lib/*.ti). +Particularly linux, xterm and vt100. Use e.g. ''tic linux.ti'' to use +them. + +If you want to run mc on xterm/color_xterm/ansi_xterm (not rxvt), then +you might read lib/README.xterm for further information. + +Screen libraries +---------------- + +GNU Midnight Commander can use the included version of S-Lang, but you +can get the latest version here: + +http://www.s-lang.org/ + +Alternatively, you can use ncurses: + +http://www.gnu.org/software/ncurses/ncurses.html + +Mouse support +------------- + +The general purpose mouse (gpm) daemon is available from + +ftp://arcana.linux.it/pub/gpm/ + +Compiler +-------- + +If your C compiler is not powerful enough to compile GNU Midnight +Commander, you should report is as a bug to the GNU Midnight Commander +team. Sometimes there is no solution than upgrading to a modern and +free compiler - GCC (Compiler Collection): + +http://gcc.gnu.org/ diff --git a/INSTALL.FAST b/doc/INSTALL.FAST similarity index 100% rename from INSTALL.FAST rename to doc/INSTALL.FAST diff --git a/MAINTAINERS b/doc/MAINTAINERS similarity index 100% rename from MAINTAINERS rename to doc/MAINTAINERS diff --git a/doc/Makefile.am b/doc/Makefile.am index 3aa746b72..545f3f907 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,11 +1,5 @@ -DIST_SUBDIRS = es hu it pl ru sr -SUBDIRS = $(DOC_LINGUAS) - -if USE_MCFS -man_MANS = mc.1 mcedit.1 mcview.1 mcserv.8 -else -man_MANS = mc.1 mcedit.1 mcview.1 -endif +DIST_SUBDIRS = man es hu it pl ru sr +SUBDIRS = man $(DOC_LINGUAS) pkgdata_DATA = mc.hlp @@ -13,6 +7,6 @@ EXTRA_DIST = xnc.hlp $(DX_CONFIG) doc/devel doxygen-include.am CLEANFILES = $(pkgdata_DATA) mc.hlp: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp + - $(top_builddir)/src/man2hlp man/mc.1 $(srcdir)/xnc.hlp mc.hlp include doxygen-include.am diff --git a/doc/NEWS b/doc/NEWS new file mode 100644 index 000000000..7668b24f7 --- /dev/null +++ b/doc/NEWS @@ -0,0 +1,877 @@ +Version 4.6.2-pre1. + +- Editor. + - Prompt the user whether to detach a hardlinked file + in "Quick save" mode. + - Fix a bug which prevented the editor from creating a + lock file in certain scenarios (bug #13673). + - New shortcut - Ctrl+S. Allows the user to toggle + syntax highlighting. + - Allow the user to override the automatic syntax + highlighting. + - Duplicate hotkey fixes. + +- VFS. + - extfs: Do not hang waiting for user input on password + protected .rar archives. + - extfs: Do not leave stale temporary files. + - extfs: Add support for ALZip archives. + - extfs: Properly retrieve the filesize of very large + files stored inside a .zip archive. + - extfs: Various quoting fixes. + - extfs: Various improvements in deb, iso9660, mailfs, rpm, trpm. + + - fish: Fix uploading of files with backtick characters in + their names. + - fish: Improve upload speed. + - fish: Allow for retrieving files larger than 2 GB. + - fish: Enable reget functionality. + - fish: Use numerical uid/gid when retrieving the directory + listing. + + - ftpfs: Allow for entering non-readable directories. + - ftpfs: Allow the user to interrupt the connection establishment. + - ftpfs: Enable reget functionality. + - ftpfs: `first_cd_then_ls' is the default mode for retrieving + directory contents now. + + - tarfs: Add support for long filenames as stored in + ustar format archives. + - tarfs: Allow for working with archives conforming to + POSIX.1-2001 standard + + +Version 4.6.1. + +- Core functionality. + - Bash < 2.05b no longer supported. For usage with bash < 2.05b fix + subshell_name_quote() to use 3-digit octals. + +Version 4.6.1. + +- Core functionality. + - Device numbers are displayed correctly. + - Improved message formatting for i18n. + - Recursive option added for internal grep. + +- Viewer. + - Almost completely rewritten internal viewer. + - mmap(2) support removed from internal viewer. + +- VFS. + - Fixed device number handling. + - zipfs can handle zip files that contain pathnames starting + with "./". + - Passive FTP over proxies is possible. + +- Miscellaneous. + - Code cleanup in various places + + +Version 4.6.1-pre5. + +- Core functionality. + - Fix double free in mc_maybe_editor_or_viewer(). + - Do not blindly cleanup in exit_subshell(). + - Fix blocking of panel cd-ing with white space command. + - Fix mini status after first Ctrl-O. + - Fix dynamic loading of Photon library for shift keys. + +- Security. + - See also VFS. + +- Portability. + - Added configuration files for Sun Solaris pkgmk(1). + +- Editor. + - Fix position save bug. + - Improve c.syntax. + - Improve makefile.syntax. + - Improve python.syntax. + - Improve eiffel.syntax. + - Improve syntax.syntax. + +- Viewer. + - Add .7z archives extensions to mc.ext.in. + - Add OpenOffice.org 2 extensions to mc.ext.in. + - Recognize both .udeb and .deb as Debian packages. + +- Screen libraries. + - Backport S-Lang fixes from HEAD. + +- VFS. + - Extensive samba cleanup. + - Fix possible crash on broken cpio archives. + - Quote fixes in urar.in. + +- Translations. + - Updated translations: German. + - Updated translations: Italian. + + +Version 4.6.1-pre4. + +- Core functionality. + - Fix X11 connection handling. + +- Editor. + - Add syntax file for the x86 assembler. + - Add syntax file for the Vision(tm) Ray Tracer. + - Add syntax file for the CORBA IDL. + - Add syntax file for the LUA programming language. + + +Version 4.6.1-pre3. + +- Core functionality. + - Improve support for tcsh. + +- Translations. + - Updated translations: Spain. + + +Version 4.6.1-pre2. + +Release candidate for 4.6.1. + +- Security. + - Fixed CAN-2004-0226 (buffer overflows). + - Fixed CAN-2004-0231 (unsafe temporary file and directory creation). + - Fixed CAN-2004-0232 (format string vulnerablities). + - cons.saver does not need to be setuid-root on Linux. + - Hiding of FTP passwords. + +- Portability. + - PC port has been removed. + - Support for SCO UNIX has been removed. + - Improve support for QNX Neutrino. + +- Core functionality. + - Use 8bit input as default. + - Better support for '@' in FTP usernames. + - Better large file support (int -> off_t) + - Add gnome, rxvt and xterm-new terminals (keyword copy for mc.lib). + - Make the find dialog more responsive while scanning through large files. + - Add implementation to cons.handler for FreeBSD 4.x and 5.x. + - Screen saving is now supported on FreeBSD console. + - Hide temporary commands from history. + - Add --with-glib12 option to configure to force using glib 1.2.x. + - Add --disable-background option to disable background support. + - Background support now uses pipes instead of UNIX sockets. + - libX11 is loaded dynamically using gmodule if possible. + - User is warned if one mc is run from another. + +- Screen libraries. + - Add many boundary check into internal slang library. + - Internal slang upgrade to 1.4.9. + - Increased maximum screen size to 512 x 512. + - Add support for qansi-m terminals. + +- Editor. + - Fix bugs for mcedit compiled with ncurses. + - New status string format in mcedit. + - Support for large syntax files. + - Temporarily disable safe save and backups on remote VFS + because it doesn't work. + - Enable user menu in mcedit. + - Add syntax file for the ASP.NET technology. + - Add syntax file for the Eiffel programming language. + - Add syntax file for the Ruby programming language. + - Add syntax file for the C# programming language. + - Upgrade php.syntax file. + - Improve sql.syntax file. + - Improve perl.syntax. + - Improve diff.syntax. + - Improve makefile.syntax. + - Add "define" keyword for syntax files. + +- VFS. + - Full audit of quoting of parameters in vfs scripts (CAN-2004-0494). + - Fixed CAN-2003-1023 (stack overflow in vfs_s_resolve_symlink). + - Various fixes in tar.c. + - VFS supports iso9660 images. + +- Translations. + - New translations: Mongolian, Serbian and Lithuanian. + - Updated translations: Ukrainian, Italian, Hungarian. + + +Version 4.6.0. + +- Core functionality. + - Fixed infinite loop under xterm if xterm is forcedly closed. + +- Portability. + - ncurses can be found even if it's renamed to curses (OpenBSD). + - Warning fixes for 64-bit systems. + + +Version 4.6.0-pre3. + +Another release candidate for 4.6.0. + +- Core functionality. + - ".." is no longer shown in the root directory. + - Fixed segmentation fault when processing truncated + section header in the corrupted initialization file. + +- Screen libraries. + - Fixed incorrect processing of AltGr on Linux console + introduced in -pre2. + +- Documentation. + - Fixed a bug in man2hlp that could randomly prevent correct + generation of the help files. + - Added manual page for mcview. + + +Version 4.6.0-pre2. + +Release candidate for 4.6.0. + +- Security. + - mc now creates its own temporary directory /tmp/mc-$USER. + If it fails or permissions are wrong, the user is warned. + +- Portability. + - mc now complies with the Filesystem Hierarchy Standard and + uses @prefix@/share/mc for the data files. + - Support for glib 2.0.x has been added. + - glib 1.2 is now properly detected on FreeBSD. + +- Core functionality. + - Fixed segmentation fault when displaying messages from + background operations. + - When using support for setting the last working directory of + mc in the parent shell, "mc" is now an alias in all shells, + not a function. The "-P" option needs an argument now. + - Alt-O sets the same directory on the other panel. + - Current directory is shown in the xterm window title. + +- Screen libraries. + - Screen library is now selected by the option --with-screen. + - X11 support is enabled by default, use --without-x to disable. + - The keycode now contains information about all screen + modifiers. This allows to implement more shortcuts, but this + work has just begun. + - Included S-Lang library has been updated to version 1.4.5. + - Mouse wheel is supported in the internal editor and viewer in + xterm compatible terminals that implement wheel events. + +- Editor. + - Internal editor now saves the cursor position in the file. + - New syntax rules - RPM specfile, m4. + - Editor shows control characters in the caret notation. + +- VFS. + - Most extfs scripts have been reviewed and improved. + - Fixed viewing and editing files on mcfs. + - Support for termnet and HSC firewall has been removed. + +- Documentation. + - Polish manual has been added. + +Version 4.6.0-pre1. + +- Security release. Massive code cleanup. Most improvements didn't + need any significant amount of the new code. + +- Security. + - Fixes for remotely exploitable buffer overflows in VFS. + +- Ports and editions. + - GNOME edition has been removed. + - OS/2 port has been removed. + - MAD (Memory Allocation Debugger) has been removed. + +- Core functionality. + - Large file support enabled by default. + - Shift-F5 and Shift-F6 copy and rename like F5 and F6, but + suggest the selected filename as the destination. + - File search with contents doesn't use external egrep. + - Directories with many files are now reloaded much faster. + - Subshell works under Cygwin. + +- Screen libraries. + - Improved support for ncurses. + - Dropped support for the old Curses library. + - Colors are enabled on all capable terminals when using S-Lang. + - Syntax highlighting now works with ncurses. + +- Editor. + - Editor files are now stored in ~/.mc/cedit instead of ~/.cedit + to avoid collision with Cooledit. + - New syntax rules - PHP, Tcl, SQL, DOS batch file. + - Editor supports word completion. + +- VFS. + - Local temporary file is used for uploading via ftpfs/fish only + if file is uploaded to the same ftp/fish server. + - mcfs support is disabled by default. + - Samba configuration and codepage files locations can be + configured. + - .netrc support in ftpfs is enabled by default. + - Viewing zip files could corrupt them. + +- Documentation. + - Added manuals in Spanish, Italian and Russian. + - Help files are not distributed, but generated during the + build from the manual pages. + +- Translations. + - Belarussian translation has been added. + + +Version 4.5.55 + +- Mostly bugfixes and portability fixes. Making things work as they + were meant to work. + +- Text edition improvements. + - Ctrl-O supported in the viewer and editor. + - Better terminal support. Should not need "Learn Keys" on rxvt + and xterm in most cases. + +- GNOME edition improvements. + - Find dialog rewritten. + - Editor and viewer ask whether to save modified file when + closed from window manager. + +- Editor. + - New syntax rules - S-Lang, PO files, Octave. + - Alt-B goes to matching bracket. + +- Portability improvements. + - Should compile out-of-box on Cygwin and QNX Neutrino. + - Can be compiled by BSD make. + - Subshell and VFS code are safer and more portable. + +- Experimental features (disabled by default). + - Charset conversion support. + - Large (64-bit) file support on 32-bit systems. + + +Version 4.5 + +- Too many new features to list. + +- This is the last version to be actively maintained. The GNOME + edition is in stabilization and maintenance phase only. A new file + manager is being written for the GNOME project. + + +Version 3.5 + +- New hotlist code. + - The bookmark code has been completely revamped and now it supports + folders. New format for the hot list file. + - It is possible to copy a selected path name into the input line + (C-Enter). + +- Tk enhancements. + - New built in GUI designer to help developers modify the look + of the program at run time (no penalty for users). + - Many dialog boxes now work. + - Right button now pops up a context sensitive action menu. + - Added many visual enhancements. + - The Tk edition is not yet finished though. + +- File management. + - Now we do background copy and move operations. + (you can ftp your files in the background now, for example). + +- Built in text editor + - This is an easy to use text editor with pull-down menus. + The features it presently supports are: Block copy, move, + delete, cut, paste; key for key undo; file insertion; macro + definition; regular expression search and replace (and our + own scanf-printf search and replace); shift-arrow MSW-MAC + text highlighting (for the Linux console only); + insert-overwrite toggle; and an option to pipe text blocks + through shell commands like indent. + + Comes with Emacs keybindings as well. + + mcedit is a link to mc which bring it up in editor mode. + +- FTP File system + - Many fixes and enhancements, better support for proxy + machines. + - Now we support both active and passive opens. + - Estimated time of arrival for ftp transfers. + - stalled detection. + - Much better support for proxies. + - ftp URLs now allow a password to be provided. + +- ext2fs Undelete File system + - Minor enhancements. + +- TAR File system + - Now we flush the tarfs if the tar file has been modified + +- External File systems: + - Speeded up RPM file system. + - New LHA file system. + - New ARC file system. + - New DEB file system (for those users of Debian). + - New RAR file system. + - Fixed problems with different zipfs. + +- MC file system: + - We get can use a mc file system by using either mc: or mc:// prefixes. + +- Viewer changes: + - Now we include a program that preprocesses mail if you view it + so, you get colored mails in the viewer. + - A simple ruler has been implemented (press Alt-r to enable it). + +- New hex editor + - Now you can do hex editions in your files with a single keystroke. + (invoke it by using the hex-viewer and then clicking on edit). + +- Find file command: + - Now we can search inside files using a piped grep (particularly + interesting to search inside virtual file system: tar files, + tar files on remote ftp sites, or searching information on an + ftp site) + +- Widgets: + - Input lines now support control-left, control-right movement on the + Linux console. + +- Extension file: + - We now support extra entries in a given rule with the Include= + tag. + +- Ports: + - Windows NT, Windows 95 by Juan Grigera + - OS/2 by Alexander Dong. + + +- Many many many bug fixes and memory leaks have been fixed. + + +Version 3.2 + +- External File system: + - Mtools file system works. + - New Cpio file system. + - New RPM file system. + +- FTP file system: + - support for HSC firewall + +- Lots of subshell fixes + +- Regexp-extension: + - Editing of non-local files works now. + +- Bunch of bug fixes. + +- Panelize now works properly. + +- Can work on Nextstep now. + +- Windows NT port by Juan Grigera. + +- Midnight Commander file system server: + - Fixed errno handling in the server. + - Fixed time handling in the server. + - Better caching. + - Works with PAM if supported on the system. + +Version 3.1 + +This has been finished: + +- Enhanced ftpfs: + - Displays progress bars. + - Supports Netware and Windows NT servers + - Better support for symlinked files. + - Handles those warez sites file names. + - Increase the directory cache timeout. + - Cache flushing (C-r) + - If you append a /~ to the directory, you will log into your home + directory (this is done by default if you use the menus to connect). + - More robust. +- Subshell fixes (it should not hang any longer). + - Fixes prompt handling for zsh and tcsh users. + - Fixes variable expansion for tcsh (now you may edit files). + - Rewrote the sync code between the parent and child, should not hang + any longer. +- Better command completion. +- Keypad handling enhanced: + - Special key treatment for +, -, \ and now may be configure to + only take place if you do not have a command typed in. + - Now the + and \ bindings when ran on the Linux console work + may use the keypad and M-+ and M-\ and leave the + and \ keys + free. +- Better handling of the line drawing chars on OSF/1 and AIX. +- Enhanced tar/compressed tar file systems. +- Global kill ring. +- Added undelete feature for Linux systems: now you may recover deleted files + on ext2 file systems with the Undelete file system. +- Symlink commands (for symlink lovers). + see the docs on C-x C-r, C-x C-l, C-x C-s keystrokes. +- New macros: + %b and %B return the basename of the selected filename + %var{ENV-VAR} expands to the contents of ENV-VAR variable. +- MC may be invoked as a viewer (mc -f flag). +- Added Unicode support on the Linux console (run with mc -N) +- Tons of bug fixes, the code is cleaner and hopefully +- Allow a vfs pathname to be passed as a startup directory. + +This is a list of people that put their effort into making the 3.1 +release: + +Adam Tla/lka, Antonio Palama, Carl Thompson, Ching Hui, Dugan Porter, Gerd +Knorr, Ilya Rybkin, Jakub Jelinek, Janne Kukonlehto, Juan Grigera, Juan Jose +Ciarlante, John Davis, Marcelo Fabian Roccasalva, Perry Francis Nguyen, +Sergey Ya Korshunoff Steven Hirsch, Thanh Ma and Torben Fjerdingstad. + +Version 3.0 + +This has been finished: + +- Virtual File System: You now can browse tar, compressed tar and + file systems over the network as if they were local subdirectories; +- Slang support, you don't need ncurses anymore (but you can still compile + with ncurses, if you want). +- New mc.ext format, for details see the sample mc.ext file provided. +- Append option if you try to copy/move a file onto already existing one. +- Internal cd command uses CDPATH variable if set (like in BASH). +- Find file command is much faster. +- External panelize command - finding files using unlimited number of + criteria - actually spawns an external command and it can be find, awk, + grep -l or anything else. +- Learn keys makes setting up of mc on terminals with broken + terminfo/termcap databases easier. It just asks you to press keys which + are not working. +- Advanced chown command. +- C-PgUp and C-PgDn takes you to the previous and currently selected + directory respectively on the Linux console. +- You can choose between 7 data bits, iso-latin-1 (0-127+160-255) or + other (0-255). +- Confirmation for overwriting, deleting and exiting added. +- Viewer has growing buffers. +- Filename, username, hostname and variable completion (M-Tab) on all + input lines plus command completion on appropriate places of command + line. +- Following of symlinks at changing directory. +- Viewer now supports bold faces and underlines, and it fits the + information on the screen better. Now you can also specify the starting + mode for the viewer depending on the contents of the viewed file. +- Mask rename and copy. +- Colors now let you specify the intensity of the colors you want. + +This is being worked on: +- Virtual File System: FTP file system. +- Tcl/Tk and XView versions of the program (preliminary versions are + up and running). + + +Version 2.0 + +Now users are able to define their own display + +- User defined display formats. + + Now you can configure the file display to suit your needs. + For example, you can say which information you want to see displayed + instead of our defaults. + +- User definable program layout. + + Panels could be shown vertically or horizontally; + panels could be different sizes, you can hide or show most + program windows (command line, keybar or menubar). + +- Output window. + + Now, it's possible to see part of the last program output on the Linux + console without having to switch screens via an option in the layout + menu. + +- New View modes: + + Quick view: as you browse your files, each one is displayed on + the other panel on the idle time. + + Tree view: let's you browse your directories by traveling a tree. + We have two traveling modes available. And the tree does + not take your precious time: it's build on the fly, as you + browse your disk (you can always loose your time if you + want to :-). + + Info view: Gives you information on the currently select file and + the current file system as you move. + + User view: Let's you define a directory listing and the format you + want to use. + +- New subshell support (concurrent shell execution) + + The Midnight Commander will now spawn one copy of the shell, so you + get better performance and you can use shell functions, define variables + and execute complete shell commands. Supported shells: bash, zsh and + tcsh. If your shell is not supported, then the old mode is still + available. + +- Dialog box manager + + Almost all the new configuration options are configured with this + new dialog manager, easy to use if you are familiar with dialog boxes + in DOS and Windows. + + Available widgets: check buttons, buttons, radio buttons, + input lines and list boxes (So you can take our code and use it on + your applications). + +- New option configuration. + + Now the program options are configured with a dialog box. + +- Chmod and Chown commands: + + For changing permissions as well as ownership of files and + directories, uses our new dialog manager. + +- Color customization support + + Now you can change the default color of the program with any of + these: + environment variable, Colors section in the init file (colors per + terminal type) and command line. + +- User menu and extension enhancements: + + Execution understand the %t macro (tagged files). + + User menu also has a new macro to let the user specify options. + + You can hide and show entries in the user menus by using conditions. + + Auto detect best match depending on a regexp. + +- Viewer: + Goto line command, + horizontal scrolling, + on the fly decompression (and we don't eat unneeded cycles of CPU), + allow non gunzip operation. + +- Internal move command: + + Now, we don't rely anymore on system commands in /bin, so the + program is more robust and is much faster. Bunches of code come + from the GNU fileutils. + +- The Tree view and normal views allows wrapped incremental searches of + file names. + +- Mask rename: + + Now it's possible to do things like rename *.pas in *.bak + +- Compare directories command + +- Allow panels to be in Long mode without forcing the user to a single panel. + + (You can even have two long panels). + +- F10, C-g cancels as well as ESC ESC. + +- Improved help system. + + We updated and spelled the help system and added a lots of links. + The Web page is constructed with the same tools. + +- Allows tagging of directories: + + Now you can copy, rename, move and delete complete directories. You + are not limited anymore to files. + +- View output (screen save/restore) on Linux console. + + On old Linux systems, only b&w is supported, on newer Linux systems + (1.1.67 and newer), we also support color screen save/restore and + cursor positions. + +- 8 bit clean support. + +- Visual feedback while i-searching files. + +- Much more intuitive, you have to use it. + +- It's better than aspirin. + +- New memory allocation debugger. + + During testing time, we used a powerful memory allocation debugger, + so the program will not eat all your memory, and will make a good use of + your memory. + +- Now it also runs on hppa-hp-hpux9, hppa-hp-hpux7, m68k-apple-aux and + sparc-sun-netbsd1.0. The best platform to run it is Linux, of course, + since that's where most of us develop it. + +- Inode sort option. + +- Nice progress status indicator. + + We have two of them: a moving dash indicator and a progress bar + indicator for file operations. + +Version 0.15 + +- Uses GNU autoconf. + Currently, it has been ported to this configurations: + i386-*-linux1.0 + i386-*-linux1.1 + mips-sgi-irix5.2 + mips-dec-ultrix4.3 + rs6000-ibm-aix3.2.5 + sparc-sun-sunos4.1 + sparc-sun-solaris2.3 + +- Improvements to the internal file viewer: + Wrap/Unwrap mode. + Hex mode. + Hex searches. + Now you can view compressed files (gzip, compress, zip, pack and lzh). + Performance enhancements, now it's much faster. + Works on systems without mmap. + +- Mouse Support now also works on xterms. + If you run in the Linux console, you will still need the gpm mouse server + to use the mouse support, but if you use xterms, then you're lucky + and can use the mouse support when using xterms. + +- Help system and man page. + Both were updated and has many more hypertext links inside, the + help system can also be used with a mouse. + +- If running on xterms, now you can see the output of the last program + you ran by using the C-o key combination. + +- Switch panels command (C-u) +- With filter command per panel. +- With auto mounting/umounting on chdir feature. +- cd now expands tildes (~, ~user). +- Much more portable. +- Many bugs were fixed. + +Version 0.14 + +- Now can handle directories with an unlimited number of files. +- New link and symlink commands (C-x l, C-x s). +- New insert tagged files or selection command (C-x t). + +Version 0.13 + +- Behave more like the Norton Commander. +- Added menu file edit. +- If there is no permission to load a directory, now it loads a dummy + directory. +- When a panel is re-sorted, keep the selected file selected. +- forward_word and backward_word command on the input line now skip + over letters and numbers. +- Fixed backward scrolling in the internal viewer. +- The internal viewer now computes the percentage in a more natural + way. +- Added handling of the Home and End keys to the internal viewer +- Bug fixes. + +Version 0.12 + +- Preliminary support for System V compilation. +- Bug fix: didn't call closedir in all cases. +- bug fixes. + +Version 0.11 + +- Support cd -. +- Corrected Makefile. + +Version 0.10 + +- Added new Alt-G, Alt-H, Alt-J to select the top file, middle file + and bottom file in the current panel. +- Now it's allowed to select option in query boxes by the first initial +- Fixed mouse repeat rate. +- Fixed a bug that prevent copying individual files to another file. +- Some minor bug fixes. + +Version 0.9 + +- Mouse Support. +- Internal Copy command (it no longer uses cp). +- Verbose Copying of files. +- Confirmation on Overwrite and on Delete. +- Support reverse sorting. +- Many visual enhancements. +- Per panel options are saved and restored. +- New truncation of names in the panels. +- History in Input Lines (M-p and M-n). +- Input line enhancements. +- Dialog boxes are nicer than before. +- Cache in gid and uid translators. +- More keybindings for the Input lines. +- Better kill management in Input Lines. +- Bug fixes. + +Version 0.8 + +- The online help now comes with the complete man page. +- Input lines now support M-b and M-f for movement by word. +- Unlimited input lines (command line). +- Filename searches now must be started with C-s or M-s. +- Many bug fixes. + +Version 0.7 + +- The stat() reloading optimization is now a configuration option. +- Many bug fixes went to the find file command. +- New history in the hypertext viewer. +- ESC-Tab will copy the name of the other-panel selected file to the + input line. +- Now it's possible to display files and directories mixed together or + separated (like the Norton Commander). +- Many bug fixes, see the ChangeLog for details. + +Version 0.6 + +- Extension dependent execution implemented (now you can execute + things like tar tzvf over compressed tar files, just a tap in the + Enter key). +- Added simple expansion of useful variables in the user menu. +- Avoid unnecessary reloading of subdirectories using stat (suggested + by Torben Fjerdingstad ). +- Added options to disable colors and display version number. +- Allow start up directory specification (ex: mc /usr/local/bin /tmp). +- Fixed bug that operated on the selection instead of the tagged file +(when only one file was tagged). +- Some cosmetic changes. +- Bug fixes. + +Version 0.5 + +- Fixed bug in the help browser that crashed the program. +- New internal viewer. +- New long directory listing format. +- some bug fixes. + +Version 0.4 + +- User Menus (F2 key). +- Quick search of files in a panel (Alt-filename takes you to that file). +- Char quoting (C-q). +- exec() enhancements. +- now you can suspend the program (C-z). +- The find file command now seems to be very stable. +- misc bug fixes. + +Version 0.3 + +- Setup loading/saving. +- Support for any size screen. +- Many, many bug fixes. diff --git a/doc/README b/doc/README new file mode 100644 index 000000000..ed21be659 --- /dev/null +++ b/doc/README @@ -0,0 +1,176 @@ +Contents +-------- + +Introduction +Dependencies +Features +Mini-documentation +Where to get more information +Reporting problems + + +Introduction +------------ + +GNU Midnight Commander (also referred to as MC) is a user shell with +text-mode full-screen interface. It can be run on the OS console, +in xterm and other terminal emulators. + +GNU Midnight Commander allows you to manage files while making most of +you screen and giving you a clear representation of the filesystem, yet +it's simple enough to be run over a telnet or ssh session. + +GNU Midnight Commander is released under the GNU General Public +License version 2.0 or any later version. A copy of the file is +included with this distribution package. + + +Dependencies +------------ + +To compile the GNU Midnight Commander you need to have a copy of the +glib library version 1.2.x or 2.0.x, available at +ftp://ftp.gtk.org/pub/gtk/ + + +Features +-------- + +GNU Midnight Commander was conceived as a free clone of John Socha's +Norton Commander (TM). It also takes the best from more recent software +with similar interfaces. GNU Midnight Commander comes with mouse support +on xterm and optionally on the Linux console. + +Some features are specific to the POSIX environment MC runs on, some are +familiar to the users of similar software for other operating systems. +The features include: + + * Built in Virtual File System: manipulate remote file systems + through the FTP and SMB protocols or over secure shell, browse + contents of tar, ar, rpm, zip, cpio, lha and rar archives just + like local files. + + * Almost all operations work with the virtual file system, + enabling you to do complex tasks, like viewing files in + archives on an FTP server. + + * Mouse support on most terminal emulators for X Window System + as well as on the Linux console. + + * Learn Keys: GNU Midnight Commander may be configured at run + time to support any kind of input keys for a given terminal, + making its operation possible even on most weird terminals. + + * Text and hex editors are available for you to use (hex editor + is a part of the viewer). + + * Hotlist allows you to keep a list of common visited locations, + including remote sites and directories inside archives. + + * Command completion: By pressing Alt-Tab in any place where a + filename or an executable are expected, GNU Midnight Commander + will complete the name for you. If you press Alt-Tab for the + second time, you get a list box with all possible completions. + + * Subshell support: Run your commands by a real shell + interpreter. GNU Midnight Commander interacts with bash, + tcsh and zsh to provide you with all of the facilities + available in your preferred shell. + + * Find file command can search for the file contents. + + * Background operations allow you to copy or move files from + any virtual file system while you do other tasks (i.e., you + can do background FTP copies). + + * FTP proxy is supported. + + * Linux file recovery: If you are using Linux, you can recover + deleted files from an ext2 or ext3 partition with the undelete + file system. This is a low level file recovery function that + can recover files deleted by any program on Linux. + + * External panelization: You can run any arbitrary external + command and GNU Midnight Commander will display the output + generated as a file listing that can be manipulated as a + regular directory. + + * Emacs-like key bindings are used in all widgets. + + * Context dependent actions (open, view, edit) are available. + + * The built-in file viewer, together with the context dependent + actions is used to format man pages on the fly, coloring mail + messages and more. + + * The built-in editor supports syntax highlighting and external + actions, such as spell checking and formatting. + + +Mini-documentation +------------------ + +These are hints for the text mode edition: + +* Use the F-Keys for invoking the commands in the function key bar. + If your terminal doesn't support F-keys, you can use the + sequence to invoke the corresponding F-digit key. + +* Tab changes the current panel. + +* All input lines have emacs-like key-bindings (command history is + accessed through the M-p and M-n keys). + +* The panels accept C-n, C-p for browsing the panel (like in Emacs). + +* M-Enter copies the currently selected file name to the input line. + +* M-Tab completes the current word (or tries to). + +* The Virtual File System is a cute addition to the project, you may + browse in tar and compressed tar files as well as browsing remote + machines with the mcfs file system. + +* Please read the manual page. + +* Read the file TODO for the current projects. + +You can access the whole documentation online with the F1 key, +although it's not as nice as the groff printed manual page :-) + + +Where to get more information +----------------------------- + +There is a webpage for GNU Midnight Commander at + +http://www.gnu.org/software/mc/ + +This page also has current information about mailing lists and some +useful advices how to report bugs. + +You can download the latest version of GNU Midnight Commander from + +ftp://ftp.gnu.org/gnu/mc/ + + +Reporting problems +------------------ + +There are two mailing lists, mc@gnome.org and mc-devel@gnome.org. Use +mc-devel@gnome.org if you are prepared for a more technical discussion +with the developers of the package, otherwise use mc@gnome.org. + +Please don't sent HTML e-mail to either of those mailing lists. + +Include the output of "mc --version", the operating system and the +distribution (if applicable) you are using, the compiler and the +configure flags used to compile the program (if you know them). + +If the program crashed and produced a core dump, please provide a +stack trace of the program. + +You can do this by running gdb like this: + +gdb mc core +(gdb) where diff --git a/README.QNX b/doc/README.QNX similarity index 100% rename from README.QNX rename to doc/README.QNX diff --git a/TODO b/doc/TODO similarity index 100% rename from TODO rename to doc/TODO diff --git a/doc/es/Makefile.am b/doc/es/Makefile.am index fcdce4c13..7690db10a 100644 --- a/doc/es/Makefile.am +++ b/doc/es/Makefile.am @@ -1,10 +1,8 @@ -mandir = @mandir@/es -man_MANS = mc.1 - -pkgdata_DATA = mc.hlp.es +LANG=es +pkgdata_DATA = mc.hlp.$(LANG) EXTRA_DIST = xnc.hlp CLEANFILES = $(pkgdata_DATA) -mc.hlp.es: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.es +mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp + - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG) diff --git a/doc/hu/Makefile.am b/doc/hu/Makefile.am index b839865a4..d302e33e8 100644 --- a/doc/hu/Makefile.am +++ b/doc/hu/Makefile.am @@ -1,10 +1,8 @@ -mandir = @mandir@/hu -man_MANS = mc.1 - -pkgdata_DATA = mc.hlp.hu +LANG=hu +pkgdata_DATA = mc.hlp.$(LANG) EXTRA_DIST = xnc.hlp CLEANFILES = $(pkgdata_DATA) -mc.hlp.hu: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.hu +mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp + - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG) diff --git a/doc/it/Makefile.am b/doc/it/Makefile.am index 139a203fa..8c1da5de8 100644 --- a/doc/it/Makefile.am +++ b/doc/it/Makefile.am @@ -1,10 +1,8 @@ -mandir = @mandir@/it -man_MANS = mc.1 - -pkgdata_DATA = mc.hlp.it +LANG=it +pkgdata_DATA = mc.hlp.$(LANG) EXTRA_DIST = xnc.hlp CLEANFILES = $(pkgdata_DATA) -mc.hlp.it: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.it +mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp + - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG) diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am new file mode 100644 index 000000000..5d40b3c57 --- /dev/null +++ b/doc/man/Makefile.am @@ -0,0 +1,8 @@ +DIST_SUBDIRS = es hu it pl ru sr +SUBDIRS = $(DOC_LINGUAS) + +if USE_MCFS +man_MANS = mc.1 mcedit.1 mcview.1 mcserv.8 +else +man_MANS = mc.1 mcedit.1 mcview.1 +endif diff --git a/doc/man/es/Makefile.am b/doc/man/es/Makefile.am new file mode 100644 index 000000000..4d457b648 --- /dev/null +++ b/doc/man/es/Makefile.am @@ -0,0 +1,7 @@ +LANG=es +mandir = @mandir@/$(LANG) +if USE_MCFS +man_MANS = mc.1 +else +man_MANS = mc.1 +endif diff --git a/doc/es/mc.1.in b/doc/man/es/mc.1.in similarity index 100% rename from doc/es/mc.1.in rename to doc/man/es/mc.1.in diff --git a/doc/man/hu/Makefile.am b/doc/man/hu/Makefile.am new file mode 100644 index 000000000..960dd950f --- /dev/null +++ b/doc/man/hu/Makefile.am @@ -0,0 +1,7 @@ +LANG=hu +mandir = @mandir@/$(LANG) +if USE_MCFS +man_MANS = mc.1 +else +man_MANS = mc.1 +endif diff --git a/doc/hu/mc.1.in b/doc/man/hu/mc.1.in similarity index 100% rename from doc/hu/mc.1.in rename to doc/man/hu/mc.1.in diff --git a/doc/man/it/Makefile.am b/doc/man/it/Makefile.am new file mode 100644 index 000000000..99a44c812 --- /dev/null +++ b/doc/man/it/Makefile.am @@ -0,0 +1,7 @@ +LANG=it +mandir = @mandir@/$(LANG) +if USE_MCFS +man_MANS = mc.1 +else +man_MANS = mc.1 +endif diff --git a/doc/it/mc.1.in b/doc/man/it/mc.1.in similarity index 100% rename from doc/it/mc.1.in rename to doc/man/it/mc.1.in diff --git a/doc/mc.1.in b/doc/man/mc.1.in similarity index 100% rename from doc/mc.1.in rename to doc/man/mc.1.in diff --git a/doc/mcedit.1.in b/doc/man/mcedit.1.in similarity index 100% rename from doc/mcedit.1.in rename to doc/man/mcedit.1.in diff --git a/doc/mcserv.8.in b/doc/man/mcserv.8.in similarity index 100% rename from doc/mcserv.8.in rename to doc/man/mcserv.8.in diff --git a/doc/mcview.1.in b/doc/man/mcview.1.in similarity index 100% rename from doc/mcview.1.in rename to doc/man/mcview.1.in diff --git a/doc/man/pl/Makefile.am b/doc/man/pl/Makefile.am new file mode 100644 index 000000000..82f79bb92 --- /dev/null +++ b/doc/man/pl/Makefile.am @@ -0,0 +1,7 @@ +LANG=pl +mandir = @mandir@/$(LANG) +if USE_MCFS +man_MANS = mc.1 +else +man_MANS = mc.1 +endif diff --git a/doc/pl/mc.1.in b/doc/man/pl/mc.1.in similarity index 100% rename from doc/pl/mc.1.in rename to doc/man/pl/mc.1.in diff --git a/doc/man/ru/Makefile.am b/doc/man/ru/Makefile.am new file mode 100644 index 000000000..c2a11ff2e --- /dev/null +++ b/doc/man/ru/Makefile.am @@ -0,0 +1,7 @@ +LANG=ru +mandir = @mandir@/$(LANG) +if USE_MCFS +man_MANS = mc.1 +else +man_MANS = mc.1 +endif diff --git a/doc/ru/mc.1.in b/doc/man/ru/mc.1.in similarity index 100% rename from doc/ru/mc.1.in rename to doc/man/ru/mc.1.in diff --git a/doc/man/sr/Makefile.am b/doc/man/sr/Makefile.am new file mode 100644 index 000000000..3d9268fbe --- /dev/null +++ b/doc/man/sr/Makefile.am @@ -0,0 +1,7 @@ +LANG=sr +mandir = @mandir@/$(LANG) +if USE_MCFS +man_MANS = mc.1 mcserv.8 +else +man_MANS = mc.1 +endif diff --git a/doc/sr/mc.1.in b/doc/man/sr/mc.1.in similarity index 100% rename from doc/sr/mc.1.in rename to doc/man/sr/mc.1.in diff --git a/doc/sr/mcserv.8.in b/doc/man/sr/mcserv.8.in similarity index 100% rename from doc/sr/mcserv.8.in rename to doc/man/sr/mcserv.8.in diff --git a/doc/pl/Makefile.am b/doc/pl/Makefile.am index 8195e326b..83f0a67ed 100644 --- a/doc/pl/Makefile.am +++ b/doc/pl/Makefile.am @@ -1,10 +1,8 @@ -mandir = @mandir@/pl -man_MANS = mc.1 - -pkgdata_DATA = mc.hlp.pl +LANG=pl +pkgdata_DATA = mc.hlp.$(LANG) EXTRA_DIST = xnc.hlp CLEANFILES = $(pkgdata_DATA) -mc.hlp.pl: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.pl +mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp + - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG) diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am index 3ccafeafc..16cb33b49 100644 --- a/doc/ru/Makefile.am +++ b/doc/ru/Makefile.am @@ -1,10 +1,8 @@ -mandir = @mandir@/ru -man_MANS = mc.1 - -pkgdata_DATA = mc.hlp.ru +LANG=ru +pkgdata_DATA = mc.hlp.$(LANG) EXTRA_DIST = xnc.hlp CLEANFILES = $(pkgdata_DATA) -mc.hlp.ru: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.ru +mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp + - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG) diff --git a/doc/sr/Makefile.am b/doc/sr/Makefile.am index f956fb21b..da353e095 100644 --- a/doc/sr/Makefile.am +++ b/doc/sr/Makefile.am @@ -1,14 +1,8 @@ -mandir = @mandir@/sr -if USE_MCFS -man_MANS = mc.1 mcserv.8 -else -man_MANS = mc.1 -endif - -pkgdata_DATA = mc.hlp.sr +LANG=sr +pkgdata_DATA = mc.hlp.$(LANG) EXTRA_DIST = xnc.hlp CLEANFILES = $(pkgdata_DATA) -mc.hlp.sr: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp - - $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.sr +mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp + - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)