Small fix in manual translation.
[midnight-commander.git] / README.PC
blobb7ddbdca3c2f97a60cb96110a1598a2ec83ed7c4
1 ------------------------------------------------------------------------
2 Support for Windows is broken since GNU Midnight Commander started using
3 glib.  If you want to revive the project, it may be your last chance. 
4 If nobody volunteers, all the code for the native Windows port will be
5 removed from the project.
6 ------------------------------------------------------------------------
10 GNU Midnight Commander for Win32
11 --------------------------------
13 0. Introduction
14 1. Compiling
15 2. Changes made
16 3. Authors and maintainers
19 0. Introduction
20 ---------------
21 Yes, Midnight Commander can be compiled for Win32 (all versions of
22 Microsoft Windows starting with Windows 95 for all platforms, except
23 Windows CE).  It may be tricky to compile, it may be buggy, but it should
24 be usable.  Maybe you can help as a beta tester or as a programmer.
25 In either case you would like subscribe to the mc-devel list (see README
26 and FAQ) and contact us.
28 Please note that Midnight Commander remains primarily a file manager for
29 UNIX-like systems.  You should not expect that it will work on your
30 system better than a file manager written specifically for your OS.
33 1. Compiling
34 ------------
37 1.1. Compiler
38 -------------
39 If you really want to enjoy free software under your non-free OS,
40 you should try free compilers.  Two of them are supported: RSXNT and
41 MinGW.  Please visit their respective sites for more information.
43 RSXNT:  http://www.mathematik.uni-bielefeld.de/~rainer/
44 MinGW:  http://www.mingw.org/
46 MinGW is also included with Cygwin (http://www.cygwin.com/).
48 Cygwin environment is so close to UNIX, that it's possible to compile
49 GNU Midnight Commander in the same way as it's done in UNIX (see file
50 INSTALL for details).  However, you should realize that you would get a
51 UNIX program that has no idea about drives, Windows-style permissions
52 and some other Windows-specific features.  This is not the Win32 port
53 discussed in this document.
55 Speaking of non-free compilers, Microsoft Visual C++ (4.0 and above) and
56 Borland C++ are supported.  "Supported" means merely that there are
57 specific makefiles for those compilers, but it does not even assume that
58 they will compile GNU Midnight Commander out-of-box.
61 1.2. General issues
62 -------------------
63 See pc/README, pc/BUGS, pc/TODO for the information concerning current
64 state of the port.  You will need to hack the code a lot just to
65 compile it.
68 1.3 Windowing Library
69 ---------------------
70 Currently only support for the S-Lang windowing library is provided.
71 There are curses clones ported to Win32, but I believe that since we
72 are not using autoconf for the Win32 port, we should avoid unnecessary
73 difficulties.
75 Currently the Win32 port only can use S-Lang included in this
76 distribution (see slang/ subdirectory).  This is a subset of S-Lang
77 distribution with some bugfixes and MC-specific code changes.
80 1.4 Features and Limitations
81 ----------------------------
82 Internal editor is supported (including syntax highlighting).
83 Internal viewer is supported (including hex editor).
84 VFS (virtual file system) is not supported.
85 Concurrent subshell is not supported.
88 2. Changes made
89 ---------------
92 2.1. Changes to main code
93 -------------------------
94 Changes in the main code are enclosed in #ifdef NATIVE_WIN32 blocks.
96 In some cases we suppressed code. This is temporal (so that mc can compile).
97 In the future we will provide fake or true interfaces for these features.
98    - Links: creation and information on links are not supported.  We
99             should provide a fake interface for the local filesystem and
100             a true one for networked.
101    - GID/UID queries (get_user, owner, preserve UID/GID on copy, ...).
102    - Terminals: all the code directly done with terminals must be suppressed.
103    - Signals: deleted.  Should support the native ones.
104    - pipes: had some trouble in ext.c and with error_pipes but soon will be
105             fixed.
106    - Chown command: Not supported yet.
109 2.2. Files rewritten
110 --------------------
111 There are several files with so many changes that they have been moved
112 to pc/ subdirectory.  Our intention should be, however, to make most code
113 system-independent.  This would increase code reuse and maintainability.
114 See pc/ subdirectory for further details.
117 3. Authors and maintainers
118 --------------------------
119 The code is not actively maintained, but the patches are applied.
120 Please send your changes to the mc-devel list.