home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / mc454src.zip / mc-4.5.4.src / mc-4.5.4 / README.QNX < prev    next >
Text File  |  1999-01-04  |  10KB  |  323 lines
  1. Midnight Commander for QNX
  2. --------------------------
  3.  
  4. 1. Compiling
  5. 2. Running 'mc' under QNX
  6. 3. List of modifications on mc-4.1.33
  7. 4. TODO
  8. 5. Contact information
  9.  
  10. 1. Compiling
  11. ------------
  12.  
  13. 1.1 Make utility
  14. ----------------
  15.  
  16. Use 'gmake'. (This is the default 'make' under QNX 4.23+). [The old 'qmake'
  17. can not handle the makefiles in the mc-source.]
  18.  
  19. 1.2 Configuring
  20. ---------------
  21.  
  22. If you don't have an installed TCP/IP development kit, you have to 'hide'
  23. the library file 'socket3r.lib' (can be installed by e.g. Watcom C 10.6)
  24. in /usr/lib or /usr/watcom/10.6/usr/lib, because the existence of this file
  25. will confuse 'configure': it will erranously assume you have the complete
  26. TCP/IP development kit (with headers) and will enable compiling of the
  27. network-related VFS code (not only tarfs).
  28. [A patch would be required in the configure-script to check the existence
  29. of the TCP/IP-related headers also...]
  30.  
  31. Use '--disable-nls' option, if you don't have the binary utilities of
  32. GNU 'gettext' package (e.g. 'msgfmt'). ['--with-included-gettext' doesn't
  33. really work in 4.1.33, there are configuration/compiling problems...]
  34.  
  35. 1.3 Compiler
  36. ------------
  37.  
  38. It is adviced to use Watcom C 10.6+ to compile the source, because older
  39. compilers (e.g. 9.52) do not support some convenient/required features.
  40. [e.g. 'ar'-compatible 'wlib',...]
  41.  
  42. 1.4 "No prototype found for '<function>'" warnings
  43. --------------------------------------------------
  44.  
  45. It is adviced to use high warning level (e.g. 'CFLAGS="-w4" ./configure'),
  46. when compiling the source, because Watcom C uses a special parameter passing
  47. convention for functions with fixed number of arguments only. So if the
  48. compiler doesn't see the correct prototype of a function with variable
  49. number of arguments (like printf()), it will produce a warning about the
  50. missing prototype, but generates function call code according to the special
  51. parameter passing convention, not the required CDECL convention (it is used
  52. by default for functions with variable number of arguments). So the calling
  53. convention of the function call code and the function code itself will not
  54. match! So you MUST provide the correct prototype for function with variable
  55. number of arguments! (Or you can force using the stack-based calling
  56. convention as a default, if you have the stack-call-conv version of all of the
  57. required libraries ('<name>3s.lib')...[Watcom C 10.6 required!])
  58.  
  59. [The latest release version (4.1.33/qnx) is checked against these types of
  60. missing prototypes...]
  61.  
  62. 1.5 Tested configuration
  63. ------------------------
  64.  
  65. QNX 4.24
  66. Watcom C 10.6 (release version, no newer beta patches)
  67. Photon 1.12
  68. no TCP/IP development kit (-> VFS: tarfs only!)
  69. mc-4.1.33, mc-4.1.34
  70.  
  71. 2. Running 'mc' under QNX
  72. -------------------------
  73.  
  74. Using 'qnx*' terminals:
  75.  
  76.   You can not use your keyboard correctly, if you disable the "Full 8 bits
  77.   input" feature in the 'Options|Display bits...' dialog.
  78.  
  79.   On 'qnx*' terminals 'mc' will run in black and white mode by default,
  80.   because these types of terminals use non-ANSI-compatible color sequences.
  81.  
  82. Accessing remote nodes via the native QNX-network:
  83.  
  84.   [The problem exists under the older versions of 'mc' only...]
  85.   If directory panels can not handle '//<node-id>' prefix in directory names,
  86.   use directory links in order to access remote nodes on the native QNX
  87.   network:
  88.  
  89.         mkdir /net
  90.         ln -sf //1/ /net/1
  91.         ...
  92.  
  93. Extension and menu files:
  94.  
  95.   Default 'tar' uses 'stderr' (and not 'stdout' as its 'normal' output with
  96.   '-t' option.
  97.   
  98.   Default 'tar' is not a GNU 'tar', so does not understand '-z' option.
  99.  
  100. Special key-mappings:
  101.  
  102.   Restrictions of the META-? as Alt-? functionality:
  103.   [META-? as ESC-? will always work!!!]
  104.  
  105.     Alt-TAB   -> Ctrl-TAB    (Alt-TAB reserved in Photon [1.12+])
  106.     Alt-ENTER -> Ctrl-ENTER  ('qnx*' terminals only)
  107.   
  108.     Alt-<uppercase letter>: doesn't work
  109.  
  110. 'qansi*' terminals:
  111.  
  112.   Problem [QNX 4.23+ only]: screen corruption (strange line-drawing character
  113.   set handling) on 'qansi*' terminals, if linked with mc/Slang/terminfo
  114.   terminal management. (Older versions of QNX and Slang/termcap not affected.)
  115.  
  116.   This problem is solved, see the comments in slang/sldisply.c about
  117.   SLTT_TRANSP_ACS_PATCH and QNX_QANSI_SLANG_COMPAT_ACS!
  118.  
  119. other terminals:
  120.  
  121.   I have tested 'mc' under QNX on 'qnx*' and 'qansi*' terminals only. 
  122.   
  123. toggle panels on/off (CTRL-o):
  124.  
  125.   Currently not supported, but could be implemented later...
  126.  
  127. 3. List of modifications on mc-4.1.33/mc-4.1.34
  128. -----------------------------------------------
  129.  
  130. edit/
  131.  
  132.  syntax.c: (4.1.33 only, fixed in 4.1.34)
  133.  
  134.    line 100,191: WCC 10.6 doesn't like "<label>: }" contruct ("no statement
  135.    after the label"), modified to "<label>: /*nop*/; }".
  136.  
  137. lib/
  138.  
  139.   mc.menu:
  140.  
  141.     'Z' on 'tar.Z' and 'tar.z' files: '%f' -> '$1'.
  142.  
  143.   mc.ext.in.qnx.diff:
  144.   mc.menu.qnx.diff:
  145.  
  146.     QNX: modified 'mc.ext.in'. [tar -t: output to stderr,...]
  147.     QNX: modified 'mc.menu'. [tar is not GNU tar: doesn't know '-z',...]
  148.  
  149.     Support for '*.tar.F': 'freeze'-compressed tar files...
  150.     
  151.     (No automatic install implemented: patches must be applied before
  152.     running 'configure' [->mc.ext.in.qnx.diff!]; this patch can be not
  153.     only QNX-specific...) 
  154.  
  155.   Makefile.in:
  156.  
  157.     'mc.ext.in.qnx.diff' and 'mc.menu.qnx.diff' added to DISTLIB.
  158.  
  159. slang/
  160.  
  161.   sldisply.c:
  162.  
  163.     SLTT_TRANSP_ACS_PATCH dependant code:
  164.  
  165.     The problem: some terminals (e.g. QNX/qansi*) map the whole upper half of
  166.     the ASCII table to the lower half, when alt-char-set is activated with
  167.     the smacs/as string-sequence. This means, that if 0 <= ch < 128 written
  168.     to the terminal, it will be translated to (ch+128) automatically by the
  169.     terminal: so not only the line-drawing characters can be written, when
  170.     the alt-char-set is activated. It implicitly means, that space, NL, CR,
  171.     etc. characters (exactly: anything besides the "standard" line drawing
  172.     characters) can not be written directly to the terminal, when the
  173.     alt-char-set is activated, because writing these characters doesn't cause
  174.     an implicit/temporary switching-back to the standard char-set!
  175.    
  176.     The original code in SLang assumes that space, NL, CR, etc. can be
  177.     printed when alt-char-set is activated. If SLTT_TRANSP_ACS_PATCH is
  178.     defined, the modified code will not use this assumption.
  179.     [Remark: the patch-code is not the most exact solution, but works...]
  180.  
  181.     QNX_QANSI_SLANG_COMPAT_ACS_PATCH dependant code:
  182.  
  183.     A more OS/terminal-specific solution for the problem mentioned above
  184.     (->SLTT_TRANSP_ACS_PATCH).
  185.   
  186.     If QNX_QANSI_SLANG_COMPAT_ACS is defined, the default smacs/sa, rmacs/ae,
  187.     acsc/ac [and sgr/sa, if it would be used!] command sequences will be
  188.     replaced internally with the "old style" (pre-QNX 4.23) sequences in case
  189.     of QNX/qansi terminals. Using these optional command sequences the terminal
  190.     remains compatible with the original SLang code (without using the
  191.     workaround-code enabled by defining SLTT_TRANSP_ACS_PATCH).
  192.    
  193.     Remark:
  194.  
  195.     Currently SLTT_TRANSP_ACS_PATCH is not auto-configured by 'configure'.
  196.     (Must be manually defined...)
  197.  
  198.     There is some (QNX-specific) auto-configuration hand-coded in the source:
  199.  
  200.         #ifdef SLTT_TRANSP_ACS_PATCH
  201.         # if defined(__QNX__) && defined(QNX_QANSI_SLANG_COMPAT_ACS)
  202.         #  undef SLTT_TRANSP_ACS_PATCH
  203.         # endif
  204.         #else
  205.         # if defined(__QNX__) && !defined(QNX_QANSI_SLANG_COMPAT_ACS)
  206.         #  define QNX_QANSI_SLANG_COMPAT_ACS 1
  207.         # endif
  208.         #endif
  209.  
  210.   slutty.c:
  211.  
  212.     "newtty.c_iflag &= ~(ECHO | INLCR | ICRNL);"
  213.  
  214.     ECHO(0x08) is a c_lflag bit, it means PARMRK(0x08) in c_iflag. (!?!)
  215.  
  216. src/
  217.  
  218.   file.c:
  219.  
  220.     'do_reget' can be extern if (USE_VFS && USE_NETCODE), not if (USE_VFS).
  221.  
  222.   find.c:
  223.  
  224.     search_content():
  225.     
  226.     variable 'i' "must be" 'int', not 'char'. ["i == -1": (buggy?) WCC 10.6
  227.     doesn't convert automatically (int)(-1) to (char)(-1) (GCC does), so
  228.     "comparison result always 0" warning produced. It is cleaner to define
  229.     'i' as 'int', than cast '-1' to 'char', because 'read()' returns 'int'.]
  230.     
  231.   key.c:
  232.  
  233.     init_key():
  234.  
  235.     Call load_xtra_key_defines() and clear 'use_8th_bit_as_meta' by default
  236.     under QNX, if a 'qnx*' terminal detected. (A saved config file (mc.ini)
  237.     can override it later...)
  238.  
  239.   key.h:
  240.  
  241.     Declare load_xtra_key_defines().
  242.  
  243.   keyxdef.c:
  244.  
  245.     Provides a method to define some platform-specific additional key
  246.     mappings. (e.g. QNX terminals can handle most of META-? combinations as
  247.     ALT-?...)
  248.     
  249.     (Currently not listed in doc/FILES...)
  250.  
  251.   layout.c:
  252.  
  253.     TIOCGWINSZ must be available (<sys/ioctl.h> included), because window-
  254.     resizing code doesn't work, if not defined.
  255.  
  256.   main.c:
  257.  
  258.     print_usage(): reserved name in the QNX run-time library!
  259.     print_usage() -> print_mc_usage()
  260.  
  261.   mouse.c:
  262.  
  263.     QNX: ncurses 1.9.8a ported to QNX doesn't provide the 'SP' pointer as a
  264.     global symbol in the library, so the keyok() emulation currently can not
  265.     be used under QNX (4.24 & Watcom C 10.6 release version).
  266.  
  267.   slint.c:
  268.  
  269.     QNX: 'qansi*' terminals added to the color_terminals[] list.
  270.     
  271.   subshell.c:
  272.   utilunix.c:
  273.  
  274.     QNX: include <unix.h> to get prototype for exec*()!!!
  275.     [See README.QNX/Section 1.4!]
  276.     
  277.   Makefile.in:
  278.  
  279.     'keyxdef' module added to SRCS and OBJS.
  280.  
  281. vfs/
  282.  
  283.   Makefile.in:
  284.  
  285.     'install' target: 'mcserv' not installed, if net-code not enabled
  286.     by 'configure'.
  287.  
  288. <mc-src-root>/
  289.  
  290.   README.QNX:
  291.  
  292.     QNX-specific notes...
  293.   
  294.   configure (line 3369):
  295.   configure.in (line 88):
  296.  
  297.     (mc-4.1.34 only)
  298.     'test x$CCOPTS = x;' => 'test "x$CCOPTS" = x;'
  299.  
  300.   Makefile.in:
  301.  
  302.     README.QNX added to DISTMAIN.
  303.     
  304. 4. TODO
  305. -------
  306.  
  307. Because of limited time and resources now I can define a 'wish list' only:
  308. (maybe somebody in the QNX community can help...)
  309.  
  310. subshell support with panel switch on/off ?
  311. mouse under Photon (with qnxm, qansi-m terminals) ?
  312. ...
  313.  
  314. 5. Contact information
  315. ----------------------
  316.  
  317. Please report QNX-specific bugs and comments via e-mail to: gt_cosy@usa.net
  318.  
  319.  
  320. -------------
  321. Tamasi Gyorgy
  322. -------------
  323.