2009-01-10 Enrico Weigelt, metux ITS <weigelt@metux.de>

* 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
This commit is contained in:
Enrico Weigelt, metux IT service 2009-01-10 16:04:58 +01:00 committed by Slava Zanko
parent 8f7d6de326
commit 13d5c72108
36 changed files with 1521 additions and 425 deletions

369
INSTALL
View File

@ -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<lib dir> if you have libraries in a
nonstandard directory <lib dir>
- Variable: CPPFLAGS
C/C++ preprocessor flags, e.g. -I<include dir> if you have
headers in a nonstandard directory <include dir>
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/

1
INSTALL Symbolic link
View File

@ -0,0 +1 @@
/usr/share/automake-1.10/INSTALL

View File

@ -591,13 +591,19 @@ vfs/extfs/urar
vfs/extfs/uzip vfs/extfs/uzip
vfs/extfs/uzoo vfs/extfs/uzoo
doc/mc.1 doc/mcedit.1 doc/mcview.1 doc/mcserv.8 doc/man/mc.1 doc/man/mcedit.1 doc/man/mcview.1 doc/man/mcserv.8 doc/man/Makefile
doc/es/mc.1 doc/es/Makefile doc/man/es/mc.1 doc/man/es/Makefile
doc/hu/mc.1 doc/hu/Makefile doc/man/hu/mc.1 doc/man/hu/Makefile
doc/it/mc.1 doc/it/Makefile doc/man/it/mc.1 doc/man/it/Makefile
doc/pl/mc.1 doc/pl/Makefile doc/man/pl/mc.1 doc/man/pl/Makefile
doc/ru/mc.1 doc/ru/Makefile doc/man/ru/mc.1 doc/man/ru/Makefile
doc/sr/mc.1 doc/sr/mcserv.8 doc/sr/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 intl/Makefile
po/Makefile.in po/Makefile.in

View File

377
doc/INSTALL Normal file
View File

@ -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<lib dir> if you have libraries in a
nonstandard directory <lib dir>
- Variable: CPPFLAGS
C/C++ preprocessor flags, e.g. -I<include dir> if you have
headers in a nonstandard directory <include dir>
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/

View File

@ -1,11 +1,5 @@
DIST_SUBDIRS = es hu it pl ru sr DIST_SUBDIRS = man es hu it pl ru sr
SUBDIRS = $(DOC_LINGUAS) SUBDIRS = man $(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
pkgdata_DATA = mc.hlp pkgdata_DATA = mc.hlp
@ -13,6 +7,6 @@ EXTRA_DIST = xnc.hlp $(DX_CONFIG) doc/devel doxygen-include.am
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp 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 include doxygen-include.am

877
doc/NEWS Normal file
View File

@ -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 <tfj@olivia.ping.dk>).
- 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.

176
doc/README Normal file
View File

@ -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 <ESC digit>
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

View File

View File

@ -1,10 +1,8 @@
mandir = @mandir@/es LANG=es
man_MANS = mc.1 pkgdata_DATA = mc.hlp.$(LANG)
pkgdata_DATA = mc.hlp.es
EXTRA_DIST = xnc.hlp EXTRA_DIST = xnc.hlp
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp.es: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp
- $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.es - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)

View File

@ -1,10 +1,8 @@
mandir = @mandir@/hu LANG=hu
man_MANS = mc.1 pkgdata_DATA = mc.hlp.$(LANG)
pkgdata_DATA = mc.hlp.hu
EXTRA_DIST = xnc.hlp EXTRA_DIST = xnc.hlp
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp.hu: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp
- $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.hu - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)

View File

@ -1,10 +1,8 @@
mandir = @mandir@/it LANG=it
man_MANS = mc.1 pkgdata_DATA = mc.hlp.$(LANG)
pkgdata_DATA = mc.hlp.it
EXTRA_DIST = xnc.hlp EXTRA_DIST = xnc.hlp
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp.it: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp
- $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.it - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)

8
doc/man/Makefile.am Normal file
View File

@ -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

7
doc/man/es/Makefile.am Normal file
View File

@ -0,0 +1,7 @@
LANG=es
mandir = @mandir@/$(LANG)
if USE_MCFS
man_MANS = mc.1
else
man_MANS = mc.1
endif

7
doc/man/hu/Makefile.am Normal file
View File

@ -0,0 +1,7 @@
LANG=hu
mandir = @mandir@/$(LANG)
if USE_MCFS
man_MANS = mc.1
else
man_MANS = mc.1
endif

7
doc/man/it/Makefile.am Normal file
View File

@ -0,0 +1,7 @@
LANG=it
mandir = @mandir@/$(LANG)
if USE_MCFS
man_MANS = mc.1
else
man_MANS = mc.1
endif

7
doc/man/pl/Makefile.am Normal file
View File

@ -0,0 +1,7 @@
LANG=pl
mandir = @mandir@/$(LANG)
if USE_MCFS
man_MANS = mc.1
else
man_MANS = mc.1
endif

7
doc/man/ru/Makefile.am Normal file
View File

@ -0,0 +1,7 @@
LANG=ru
mandir = @mandir@/$(LANG)
if USE_MCFS
man_MANS = mc.1
else
man_MANS = mc.1
endif

7
doc/man/sr/Makefile.am Normal file
View File

@ -0,0 +1,7 @@
LANG=sr
mandir = @mandir@/$(LANG)
if USE_MCFS
man_MANS = mc.1 mcserv.8
else
man_MANS = mc.1
endif

View File

@ -1,10 +1,8 @@
mandir = @mandir@/pl LANG=pl
man_MANS = mc.1 pkgdata_DATA = mc.hlp.$(LANG)
pkgdata_DATA = mc.hlp.pl
EXTRA_DIST = xnc.hlp EXTRA_DIST = xnc.hlp
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp.pl: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp
- $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.pl - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)

View File

@ -1,10 +1,8 @@
mandir = @mandir@/ru LANG=ru
man_MANS = mc.1 pkgdata_DATA = mc.hlp.$(LANG)
pkgdata_DATA = mc.hlp.ru
EXTRA_DIST = xnc.hlp EXTRA_DIST = xnc.hlp
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp.ru: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp
- $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.ru - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)

View File

@ -1,14 +1,8 @@
mandir = @mandir@/sr LANG=sr
if USE_MCFS pkgdata_DATA = mc.hlp.$(LANG)
man_MANS = mc.1 mcserv.8
else
man_MANS = mc.1
endif
pkgdata_DATA = mc.hlp.sr
EXTRA_DIST = xnc.hlp EXTRA_DIST = xnc.hlp
CLEANFILES = $(pkgdata_DATA) CLEANFILES = $(pkgdata_DATA)
mc.hlp.sr: mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp mc.hlp.$(LANG): ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp $(top_builddir)/src/man2hlp
- $(top_builddir)/src/man2hlp mc.1 $(srcdir)/xnc.hlp mc.hlp.sr - $(top_builddir)/src/man2hlp ../man/$(LANG)/mc.1 $(srcdir)/xnc.hlp mc.hlp.$(LANG)