home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs57pc1.zip / README < prev    next >
Text File  |  1997-01-26  |  27KB  |  606 lines
  1. README for RCS 5.7 for PC's running under OS/2, DOS or Win95/NT
  2. ---------------------------------------------------------------
  3.  
  4. Release date: Jan 26th 1997
  5.  
  6. Changes: - fixed Win95/NT bug with export of const data items
  7.            from RSXNT-built DLL
  8.  
  9. Release date: Jan 12th 1997
  10.  
  11. Changes: - added binary mode support to cii/coo (from Hans-Otto Ultes)
  12.      - fixed bug causing "ci -f" to fail if no headers to expand
  13.      - fixed bug causing crash with pseudo symlinks
  14.      - fixed bug causing misleading error message due to nobody
  15.        being logged on to networking software recognized by RCS
  16.          - include GNU info, TeX DVI and OS/2 IPF formatted docs
  17.            (from K.H. Marbaise)
  18.          - make Win95/NT executables with RSXNT 1.3, 
  19.            a few source changes were required
  20.  
  21. Release date: May 20th 1996
  22.  
  23. Changes: - fixed serious bug with every other file argument 
  24.            often not working
  25.  
  26. Release date: May 14th 1996
  27.  
  28. Changes: - upgraded RCS to GNU RCS 5.7
  29.      - upgraded diff to GNU diff 2.7.2
  30.      - DOS 32-bit diff now only supplied in Watcom+PMODE/W version
  31.      - support for binary files working now, see below
  32.      - support for pseudo symbolic links
  33.      - support for Windows 95 and Windows NT
  34.  
  35. Release date: May 1st 1995
  36.  
  37. Changes: - the cii (rcsfront) indirect invocation method did not 
  38.            work for DOS, now just use the real executable
  39.          - cii itself did not work correctly on FAT file system
  40.          - integrated fix from Paul Eggert for "rcs -o"
  41.          - minor adjustments for emx 0.9a
  42.          - added a second 32-bit diff for DOS, created with
  43.            Watcom C 10.0 and the PMODE/W extender, for those
  44.            that have trouble with the emx generated one
  45.  
  46. Release date: December 16th 1994
  47.  
  48. Changes: - fixed another problem with 32-bit executables for OS/2,
  49.            they seem to work fine now
  50.          - updated emx and rsx DOS extender runtime modules
  51.  
  52. Release date: September 17th 1994 (never made public)
  53.  
  54. Changes: - fixed problem with checkout failures for 32-bit executables
  55.      - significant speedup for checkout of old revisions with
  56.            the 32-bit executables (side effect of above fix)
  57.  
  58. Release date: August 1st 1994
  59.  
  60. Changes: - added workaround for bug in MS-DOS SHARE.EXE
  61.      - new MS-DOS executables
  62.      - slightly corrected rcs/src/ms/Makefile and README files
  63.  
  64. Initial Release date: July 11th 1994
  65.  
  66.  
  67. 0. Archive Locations
  68. --------------------
  69.  
  70. This package is primarily distributed as
  71.  
  72.   ftp://ftp.leo.org/pub/comp/os/os2/gnu/devtools/rcs57pc1.zip
  73.   ftp://ftp.leo.org/pub/comp/os/os2/gnu/devtools/rcs57pc2.zip
  74.  
  75. and
  76.  
  77.   ftp://ftp.cs.purdue.edu/pub/RCS/rcs57pc1.zip
  78.   ftp://ftp.cs.purdue.edu/pub/RCS/rcs57pc2.zip
  79.  
  80. The first archive contains the more widely used DOS, Win95/NT and OS/2
  81. 32-bit executables as well as formatted documentation files. The
  82. second one contains the not so often needed OS/2 16-bit executables,
  83. source code and unformatted documentation files.
  84.  
  85. As long as the author of this revision maintains the PC versions of
  86. RCS and has access to this archive site, the latest version can be
  87. found there (with file names indicating higher revisions, perhaps).
  88.  
  89. Other sites will have copies of this archive too, such as
  90.  
  91.   ftp://ftp-os2.nmsu.edu/os2/unix
  92.   ftp://ftp-os2.cdrom.com/os2/unix
  93.  
  94. which are the best known OS/2 ftp archive sites on the Internet. In
  95. addition, one should be able to find it in the Simtel and Coast-to-Coast
  96. archives:
  97.  
  98.   ftp://ftp.simtel.net/pub/simtelnet/msdos/pgmutl
  99.   ftp://ftp.coast.net/simtel/msdos/pgmutil
  100.   ftp://ftp.coast.net/simtel/os2/pgmtools
  101.   ftp://ftp.coast.net/simtel/nt/pgmtools
  102.  
  103. Related packages that may be of interest for RCS users include (all
  104. path names relative to ftp://ftp.leo.org/pub/comp/os/os2/): 
  105.  
  106. - CVS 1.4 (gnu/devtools/cvs14p9b.zip and cvs14p9s.zip) or newer
  107.  
  108.   CVS is a more advanced revision control system for multi user access
  109.   to shared source code without locks and with conflict resolution.
  110.   It works on top of RCS.
  111.  
  112. - GNU make 3.74 or newer (gnu/devtools/gnumake.zip)
  113.  
  114.   This is a "make" program that knows how to access source files
  115.   maintained with RCS without need to specify special rules.
  116.  
  117. - GNU Emacs 19.30 or newer (gnu/emacs-19/*)
  118.  
  119.   The GNU Emacs editor is a very powerful programmer's editor that
  120.   provides easy access to files maintained with RCS via its included
  121.   "vc" package.
  122.  
  123. And, because they can be used to create executables of this RCS
  124. version: 
  125.  
  126. - the emx programming environment (gnu/emx+gcc/*)
  127.  
  128.   The emx environment (current version 0.9c) provides
  129.   tools to create and run 32-bit programs under OS/2 2.x and
  130.   MS-DOS. It uses many GNU programs, such as the gcc C/C++ compiler,
  131.   gas assembler, gdb debugger and libg++ class library.
  132.  
  133. - the RSX DOS extender and Win95/NT runtime environment for emx, 
  134.   currently v5.10 (gnu/emx+gcc/contrib/rsx510.zip and rsxnt13.zip)
  135.  
  136.   This is an alternative DOS extender for emx to let emx programs
  137.   run in a MS-DOS DPMI environment (such as Microsoft Windows 3.x)
  138.   as well as a kind of "emx runtime for Win32".
  139.  
  140.  
  141. 1. Overview
  142. -----------
  143.  
  144. RCS is a revision control system, usually used by software developers
  145. to maintain revisions of the source code for the software they write.
  146.  
  147. This package contains in subdirectories:
  148.  
  149. rcs         the source code for RCS 5.7
  150.  
  151. rcsfront    the source code for RCSFRONT, a small (and unsupported) 
  152.         front end tool for easier management of a collection
  153.         of files under RCS control
  154.  
  155. diff, diff16    the source code for the GNU diff program, an important
  156.         tool required for RCS (two versions, see below)
  157.  
  158. doc        preformatted documentation (plain text and 
  159.         PostScript format)
  160.  
  161. bin32        OS/2 2.x executable programs (32-bit)
  162. bin16        OS/2 1.x executable programs (16-bit)
  163. bindos        MS-DOS executable programs (16-bit, but see below)
  164. binnt        Windows 95 and NT executable programs (32-bit)
  165.  
  166. It is assumed that you are familiar with the concept and usage of
  167. RCS. If that is not the case, please read (or print and read) the
  168. original RCS documentation and manual pages available in the "doc"
  169. subdirectory. This file only documents platform and/or release
  170. specific information.
  171.  
  172.  
  173. 2. Installation
  174. ---------------
  175.  
  176. First, just pick the right set of executable programs and put them in
  177. a directory, which should be listed in the PATH environment
  178. variable. For the OS/2 32-bit executables, since they use a few DLL's
  179. (dynamic link libraries), this directory should also be listed in the
  180. LIBPATH statement in CONFIG.SYS.
  181.  
  182. Second, you need to set/check a few environment variables:
  183.  
  184. a) Either the USER or LOGNAME variable must contain the user's
  185.    (i.e. your) last name, unless you have network software installed
  186.    and want to use the name with which the user is logged on to the
  187.    network (see below). In this latter case, you need not set one of
  188.    these variables, if RCS is able to detect the logged on user name.
  189.  
  190. b) The TZ environment variable should contain your proper time zone
  191.    definition. If you use the OS/2 32-bit executables, you can also
  192.    use the EMXTZ variable if some other software on your machine
  193.    requires a more complicated value of this variable which programs
  194.    compiled with emx (see below) don't understand. 
  195.  
  196.    The TZ variable usually contains, the time zone name, the time zone
  197.    offset in hours to GMT and optionally the daylight savings time
  198.    zone name, examples are:
  199.  
  200.     SET TZ=PST8PDT        (pacific standard time)
  201.     SET TZ=CET-1        (central europe time)
  202.  
  203. c) The RCSINIT variable can contain options for RCS you want to use all
  204.    the time. The default value is suitable for work under DOS and on FAT
  205.    file systems under OS/2, i.e. all RCS files go into a subdirectory
  206.    RCS of the working directory and have no special suffix.
  207.  
  208.    If you work under OS/2 on a HPFS file system (or any other file
  209.    system that can handle long names), you may want to follow the Unix
  210.    convention of using RCS files in the working directory that may
  211.    also have a suffix of ",v". For this case, use "SET RCSINIT=-x,v/".
  212.  
  213.    Windows 95 and NT also support long file names and the ,v suffix,
  214.    but the ,v suffix not on FAT file systems, only on network drives
  215.    (that reside on OS/2 HPFS or NT NTFS servers or on Unix NFS
  216.    servers).
  217.  
  218.    See the RCS manual pages for details about all other available
  219.    options.
  220.  
  221. d) Make sure you have a properly set TMP (and possibly TEMP)
  222.    environment variable that points to a directory where
  223.    temporary files should be stored.
  224.  
  225. e) (this is optional, for OS/2 32-bit executables only)
  226.  
  227.    The RCSLOAD environment variable can be set to a decimal number
  228.    specifying the amount of minutes to keep the RCS (and diff)
  229.    executables preloaded in memory. This requires that you have the
  230.    emx runtime package installed (emxload.exe is required). This
  231.    method may speed up the use of RCS from within GNU Emacs or with
  232.    CVS if many files are checked in/out in a batch because that can
  233.    result in a large number of executed subprocesses with RCS
  234.    programs.
  235.  
  236. After these steps, you should be able to use the RCS commands.
  237.  
  238.  
  239. 3. RCS
  240. ------
  241.  
  242. RCS is a widely used revision control system available for most Unix
  243. systems and several other platforms (such as in this package, for OS/2
  244. and MS-DOS/Windows, Windows 95 and Windows NT). It allows shared use
  245. of RCS files in heterogenous networks, for example. A few notes on PC
  246. specific details, however:
  247.  
  248. * Note 1: Network Software
  249.  
  250. The RCS programs recognize certain PC networking software and query it
  251. for the name of the logged on user. The result can be overridden by
  252. the value of the USER or LOGNAME environment variables. The LOGNAME
  253. variable has precedence over the USER variable.
  254.  
  255. Under OS/2, the RCS programs recognize the following networking
  256. products:
  257.  
  258. - IBM LAN Server
  259. - IBM Peer (Warp Connect)
  260. - Microsoft LAN Manager
  261. - Novell NetWare
  262.  
  263. In addition, the installation of the IBM TCP/IP for OS/2 product
  264. usually sets the USER environment variable in CONFIG.SYS.
  265.  
  266. Under MS-DOS, the following networking products are recognized:
  267.  
  268. - IBM DOS LAN Requester or DOS LAN Services
  269. - IBM PC Network
  270. - Microsoft LAN Manager Client
  271. - Novell NetWare Client
  272.  
  273. Also the locally logged on user name is recognized if networking
  274. components are used in:
  275.  
  276. - Microsoft Windows for Workgroups
  277. - Microsoft Windows 95
  278. - Microsoft Windows NT
  279.  
  280. Any product compatible to those mentioned should work as well.
  281.  
  282. Note that network support in RCS means only that the RCS commands can
  283. retrieve the current user name from the networking software, nothing
  284. more. In particular, RCS relies on correct support for file locking
  285. and "strange" file modes (such as creating a read-only file and
  286. writing to it before closing it for the first time) on network drives.
  287. RCS only uses regular OS file system services on network drives.
  288.  
  289. * Note 2: binary files
  290.  
  291. This version of RCS for the PC does now support revision control of
  292. binary files. The main goal, however, is to allow control of source
  293. files in heterogenous environments. In such environments, the systems
  294. can have different conventions for line separation in source code
  295. files. To allow shared use of RCS files between systems with different
  296. line separators, a conversion must take place when checking in/out
  297. files. 
  298.  
  299. This, naturally, would break many binary files. Therefore a special
  300. option, -kb, must be used for binary files with this RCS version to
  301. mark them as binary files. Before you can check in a binary file you
  302. must initialize an empty RCS file with "rcs -i -kb <rcsfile>". Do not
  303. use -kb for plain text files because it makes those RCS files
  304. non-portable to other operating environments.
  305.  
  306. The way how RCS currently stores "differences" between the revisions
  307. of a binary file is quite inefficient (but more or less portable).
  308. Future version of RCS may support better methods.
  309.  
  310. * Note 3: RCS file path names
  311.  
  312. Whenever a path name passed to a RCS program has /RCS/ in it, it is
  313. treated as a RCS (rather than a working) file. However, that /RCS/
  314. component must be specified in upper case even on the PC operating
  315. systems where path names are normally not case sensitive.
  316.  
  317. So, d:/work/RCS/foo.c and e:/proj/RCS/subproj/bar.c are recognized as
  318. RCS files while e:/proj/free/rcs/src/ci.c is recognized as a working
  319. file.
  320.  
  321. In addition all PC operating systems treat / in path names exactly
  322. like \ as a path name separator even though \ is much more widely
  323. known and used as such. However, under Unix / is the only path name
  324. separator and thus RCS uses it in both the programs and the 
  325. documentation. Please don't be confused by this fact and keep in mind
  326. that it simply doesn't matter which one is used on the PC, at least
  327. as far as RCS is concerned.
  328.  
  329. * Note 4: pseudo symbolic links
  330.  
  331. RCS usually uses the ./RCS directory for separating the RCS files from
  332. the working files. There are tools like RCSFRONT (see below) and CVS
  333. to separate them further (allowing to put them in entirely different
  334. locations). For users of plain RCS, under Unix it is a widely used
  335. practice to make ./RCS a symbolic link to a different location in the
  336. directory tree in order to separate working and RCS files.
  337.  
  338. There is now a new feature in RCS for the PC that mimics Unix-style
  339. symbolic links for the PC operating systems because they don't support
  340. symbolic links natively in most cases (you can have symbolic links if
  341. you use TVFS under OS/2).
  342.  
  343. How does it work? When, instead of the ./RCS subdirectory, a regular
  344. file ./RCS exists, a single line of text is read from it and treated as
  345. the actual path name of the RCS directory. This can be either an
  346. absolute path name or a path name relative to the current directory. 
  347.  
  348. So if you are currently working in the directory E:\Work and have a
  349. file RCS there that contains the line N:\Project\Repository, then a
  350. command like "ci foobar.c" will check in foobar.c into the RCS file
  351. N:\Project\Repository\foobar.c,v as if ./RCS were a Unix-style
  352. symbolic link to that location. (Note: the ,v suffix is only available
  353. when long file names and the , character in file names are supported
  354. and also RCSINIT is set accordingly.)
  355.  
  356. However, you must either use the ,v suffix for the RCS file names
  357. (set RCSINIT accordingly) or specify a path name in the ./RCS file
  358. that contains a /RCS/ component (/RCS/ must be in upper case), 
  359. otherwise the RCS programs will abort because they can't determine 
  360. where to store the RCS file.
  361.  
  362. * Note 4: rcsfreeze
  363.  
  364. RCS contains one utility program (rcsfreeze) not written in the C
  365. language but as a bourne shell script. Even with a bourne shell for
  366. the PC it is not advisable to use it on the PC. Instead, I have
  367. rewritten the exact same semantics as a REXX procedure which can be
  368. used under OS/2 (1.x or 2.x).
  369.  
  370. This REXX procedure is, of course, useless on MS-DOS for two reasons.
  371. First, unless you have IBM PC-DOS 7 (or newer) or a free REXX
  372. interpreter for DOS, you cannot even get it to run. Second, it depends
  373. on long filenames. 
  374.  
  375. If you have a REXX interpreter for Windows 95 or Windows NT, you may get
  376. it to run with some changes, but that has not been attempted so far.
  377.  
  378. Rewriting the program in C would solve that problem but would also cause
  379. extra work ...
  380.  
  381.  
  382. 4. RCSFRONT
  383. -----------
  384.  
  385. The RCSFRONT program, written by Jason P. Winters and Craig J. Kim is
  386. distributed by the Free Software Foundation. It allows checking in/out
  387. whole collections of files or even whole directory trees with RCS. It
  388. was heavily modified to run on the PC. In addition, it does not seem
  389. to be maintained actively any longer.
  390.  
  391. Of course, RCSFRONT is no substitute for more sophisticated software
  392. that builds on RCS for similar goals, such as CVS. But it may be
  393. sufficient for use on standalone systems or single-programmer
  394. projects. See its manual page in the "doc" subdirectory for more
  395. details. It is a bit difficult to get it working if you are unfamiliar
  396. with it.
  397.  
  398. Note: only single line log messages are posssible with cii at the
  399. moment, due to limitations in RCS's ci and the PC command line
  400. interpreters.
  401.  
  402.  
  403. 5. GNU diff
  404. -----------
  405.  
  406. The RCS programs depend on the availability of the diff command under
  407. Unix, to compare two files (or two different revisions of a file in
  408. the context of RCS). Since that is not a standard command on PC
  409. operating systems, a version of it, the Free Software Foundation's GNU
  410. diff program, is included in this package. Please use only this diff
  411. program with RCS if possible.
  412.  
  413. Since the reliability of RCS depends on that of the diff program very
  414. heavily, a few more words on this topic:
  415.  
  416. This package supports PC's running OS/2 2.x (a 32-bit operating
  417. system), OS/2 1.x (a 16-bit operating system) and MS-DOS (a 16-bit
  418. operating system which, due to lack of any protection, allows
  419. implementing so-called DOS-extenders to run 32-bit programs on top of
  420. it). Windows 95 and NT are also supported.
  421.  
  422. The GNU diff program (current version is 2.7.1), which works very well
  423. with RCS, is inherently a 32-bit program (it uses rather large data
  424. structures, for example). It can be compiled for OS/2 2.x and Windows
  425. 95/NT without much effort. However, that is not the case for the
  426. 16-bit target systems. Because of this fact, long time ago I put a LOT
  427. of effort into porting the then current version (1.15) to let it run
  428. under OS/2 1.x and under MS-DOS, and testing it thoroughly. As you can
  429. see from the version numbers, it has undergone quite some development
  430. since then and porting the current version again to OS/2 1.x and
  431. MS-DOS would be a lot of work.
  432.  
  433. Because the functionality of diff that is used by RCS has not changed
  434. since 1.15 and since it does not make sense to spend a lot of time for
  435. the 16-bit target operating systems any longer, I decided to include
  436. *two* versions of GNU diff in this package. The old version, 1.15, is
  437. included for use under OS/2 1.x and MS-DOS in the "diff16" subdirectory
  438. and the current version, 2.7.1, is included for use under OS/2 2.x and
  439. Windows 95/NT (and MS-DOS on 386 or better CPU's, see below) in the
  440. "diff" subdirectory.
  441.  
  442. Since MS-DOS can be used to also run 32-bit programs with some kind of
  443. DOS extender, this current version of GNU diff can also be used under
  444. MS-DOS, if a 386 or higher CPU is available. This is very important
  445. because MS-DOS limits normal DOS programs to use only up to 640k of
  446. memory less the amount used for MS-DOS itself. And since some RCS
  447. programs call diff as a subprogram, even less memory is available for
  448. diff. So, naturally, the diff program when running under DOS can fail
  449. with "out of memory"-type errors if you try to use RCS commands on
  450. larger files. If that occurs, you should switch to the 32-bit version
  451. of diff, diff-32.exe in the "bindos" subdirectory and rename that to
  452. diff.exe.
  453.  
  454. The RCS commands merge and rcsmerge depend on the availability of
  455. another related command, the diff3 program. This program is a
  456. three-way file comparison/merge program that in turn uses the diff
  457. program as a subprogram. A version of it is included with the GNU diff
  458. program in the same package. 
  459.  
  460. The user interface of the diff3 program was changed noticable between
  461. versions 1.15 and 2.1 and the RCS programs merge and rcsmerge require
  462. at least the diff3 program included with GNU diff 2.1. For this reason
  463. and since it is a much smaller program than diff itself, the GNU diff
  464. 2.6's diff3 program has been "ported back" to GNU diff 1.15 and is
  465. also used in the 16-bit target environments.
  466.  
  467. To make a long story short, while the executables for the RCS programs
  468. and RCSFRONT for all target environments are made from the same source
  469. code, two different versions of GNU diff (1.15 and 2.7.1) are used to
  470. create the diff program's executables for the target platforms, 1.15 for
  471. 16-bit OS/2 1.x and MS-DOS and 2.7.1 for 32-bit OS/2 2.x, Windows 95/NT
  472. and MS-DOS on 386 and up PC's.
  473.  
  474.  
  475. 6. The emx toolkit and the emx and rsx DOS extenders
  476. ----------------------------------------------------
  477.  
  478. The emx 0.9c kit with patch 2 applied was used to create the 32-bit OS/2
  479. 2.x executables. This toolkit uses the GNU gcc compiler and is freely
  480. available to everyone. At least the 0.9b version is absolutely required
  481. or you can experience loss of data with the generated programs, if you
  482. want to recompile yourself.
  483.  
  484. The emx kit also includes a DOS extender (emx.exe) that allows to run
  485. 32-bit emx-compiled programs under plain DOS and in VCPI environment
  486. (certain DOS "memory managers" provide this environment). To run them in
  487. a DPMI environment (such as in DOS windows under Microsoft Windows 3.x,
  488. OS/2 2.x, Windows 95 or NT), a different DOS extender is available,
  489. called rsx (rsx.exe). The emx-compiled 32-bit DOS programs automatically
  490. select the right extender to run on at runtime. 
  491.  
  492. So should you want to use 32-bit DOS emx-compiled RCS executables, you
  493. should make yourself familiar with those two extenders. The 32-bit DOS
  494. executables are not included in this package since the 16-bit ones
  495. should fit well in almost all DOS situations. If you want the 32-bit
  496. ones, you will have to recompile yourself. When using emx to compile RCS
  497. for DOS, no network support is available for technical reasons, however.
  498. But then, you don't gain much from them, since the RCS programs (as
  499. opposed to GNU diff) do not reach the MS-DOS 640k limit.
  500.  
  501. You should be able to find the full packages of emx and rsx at the same
  502. places where you got this RCS package. Note that you may already have
  503. either emx.exe or rsx.exe or even both on your MS-DOS system because
  504. they are popular and you may be using some other software that depends
  505. on them. In such a case make sure you have only one copy (the newest
  506. one) on your system available via the PATH environment variable.
  507.  
  508. I mentioned that the emx toolkit was used to create the OS/2 2.x
  509. 32-bit executables. To save disk space, the RCS (and RCSFRONT and GNU
  510. diff/diff3) programs are linked with the shared runtime library of
  511. emx, so you have only copy of it on disk and not one in each separate
  512. executable. This emx runtime consists of emx.dll and emxlibcs.dll. If
  513. you followed the installation instructions above, you should not
  514. notice any difference to "normal" statically linked programs. Since
  515. many free programs for OS/2 2.x are compiled with this
  516. compiler/toolkit, chances are big that you already have a copy of
  517. these DLL's on your system. Make sure you keep only one of them (the
  518. newest one) in a directory listed in the LIBPATH statement in your
  519. CONFIG.SYS.
  520.  
  521. In addition, because the RCS programs use a common set of utility
  522. functions, these have been put into another shared library,
  523. rcslib.dll. This further reduces disk space requirements
  524. considerably. Also, the GNU regular expression library used by GNU
  525. diff is also linked in a separate DLL, gnuregex.dll, since it is quite
  526. large and many of the FSF's programs use it which are available for
  527. OS/2. You need only one copy of it on your system too.
  528.  
  529.  
  530. 7. Other compilers
  531. ------------------
  532.  
  533. The 16-bit DOS and OS/2 executables are compiled with Microsoft C 6.00A,
  534. an environment that is no longer maintained by Microsoft but works well
  535. enough to keep it. Newer Microsoft compilers may work for DOS but are
  536. untested. The Visual C++ 4.0 (Microsoft C/C++ 10.0) can be used for
  537. Win32 executables, it supports even the shared rcslib.dll method like
  538. emx does for OS/2 and RSX/Win32.
  539.  
  540. The Watcom C/C++ 10.6 compiler can be used for all target environments.
  541. However, the code it generates is less compact than that created by the
  542. other compilers so no included executable sets were generated with it,
  543. with one exception. The diff-32.exe in tbe bindos subdirectory was
  544. created with the 32-bit DOS (DOS4G/W) target of the Watcom compiler, but
  545. a different (free) DOS extender was used instead of the huge DOS4GW.EXE
  546. extender that Watcom includes with their compiler. Instead of that,
  547. PMODE/W 1.23 has been used. 
  548.  
  549.  
  550. 8. Documentation
  551. ----------------
  552.  
  553. The manual pages for RCS and RCSFRONT programs and additional documents
  554. are available in the "doc" subdirectory in two formats: as plain ASCII
  555. files for reading with any file browser or editor and in PostScript (TM)
  556. format for printing on a PostScript printer or viewing/printing with
  557. GhostScript or GSView. They were all created with the OS/2 version of
  558. the GNU groff text formatter from the "source" documents also included
  559. in this package (in the "rcs\man" and "rcsfront" subdirectories).
  560.  
  561. The documentation for GNU diff and diff3, version 2.7.1, is available
  562. as a TeXinfo source file in the "diff" subdirectory. A preformatted
  563. version in GNU Info format is in the "doc" subdirectory for reading
  564. with either the GNU Emacs editor or the standalone GNU info browser,
  565. but it can also be viewed with any normal file browser. A PostScript
  566. version of it, made with emTeX and dvips, is also in the "doc"
  567. subdirectory.
  568.  
  569. If you are not yet familiar with RCS and/or GNU diff, please read this
  570. documentation files very carefully. I repeat, read them and read them
  571. entirely and carefully before starting to use these tools. OK?
  572.  
  573.  
  574. 9. Problems
  575. -----------
  576.  
  577. Please read this file carefully. If you have problems using RCS, please
  578. first check it again to see if you forgot something and also check the
  579. RCS documentation in the "doc" subdirectory.
  580.  
  581. If that doesn't help, send a short and descriptive e-mail
  582. message. Don't laugh, you don't know how often I get e-mail with
  583. contents like "the foobar program you ported to OS/2 does not work,
  584. what should I do?" without any more details. Remember that I can't
  585. read your mind, especially not over such distances. :-)
  586.  
  587.  
  588. 10. Author / Address
  589. --------------------
  590.  
  591. Walter F. Tichy wrote the original version of RCS.
  592. Paul Eggert wrote the changes for RCS version 5.x, and maintains it.
  593.  
  594. This port of RCS 5.7 to MS-DOS and OS/2 is based on an earlier
  595. release (RCS 5.6.3) made by Paul Eggert, Frank Whaley and Kai Uwe
  596. Rommel.
  597.  
  598. The DOS and OS/2 related changes for 5.7, for the DOS, Windows 95/NT
  599. and OS/2 32-bit targets, the networking support and the ports of 
  600. RCSFRONT, GNU diff 1.15 and 2.7.1 were made by Kai Uwe Rommel.
  601.  
  602.  
  603. /* Kai Uwe Rommel      ARS Computer & Consulting GmbH, Muenchen, Germany *
  604.  * rommel@ars.de             CompuServe 100265,2651, Fax +49 89 324 4524 *
  605.  * rommel@leo.org (ftp.leo.org:/pub/comp/os/os2 maintenance)             */
  606.