home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / ntcode / gr564s / src / ms / readme < prev    next >
Encoding:
Text File  |  1995-05-19  |  6.6 KB  |  176 lines
  1. MS RCS configuration
  2.  
  3.     $Id$
  4.  
  5.     Copyright 1991, 1992, 1993 by Paul Eggert
  6.     Distributed under license by the Free Software Foundation, Inc.
  7.  
  8.     This file is part of RCS.
  9.  
  10.     RCS is free software; you can redistribute it and/or modify it
  11.     under the terms of the GNU General Public License as published
  12.     by the Free Software Foundation; either version 2, or (at your
  13.     option) any later version.
  14.  
  15.     RCS is distributed in the hope that it will be useful, but
  16.     WITHOUT ANY WARRANTY; without even the implied warranty of
  17.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18.     GNU General Public License for more details.
  19.  
  20.     You should have received a copy of the GNU General Public
  21.     License along with RCS; see the file COPYING.  If not, write to
  22.     the Free Software Foundation, 675 Mass Ave, Cambridge, MA
  23.     02139, USA.
  24.  
  25.     Report problems and direct all questions to:
  26.  
  27.         rcs-bugs@cs.purdue.edu
  28.  
  29. This is $Revision$ of the MS RCS support directory.
  30. It contains extra files useful for getting RCS 5.6.4 (and later versions)
  31. to run under the MS-DOS, OS/2 and Windows/NT operating systems.
  32. This version has not been fully tested and it probably has problems.
  33. If you get it to work, please send your fixes to rcs-bugs@cs.purdue.edu.
  34.  
  35. The diff subdirectory contains a version of GNU diff 2.2 modified for
  36. use under MS-DOS, OS/2 and Windows/NT.  Install GNU diff before tackling RCS.
  37.  
  38. Put this directory into the src\ms subdirectory of the RCS source tree,
  39. so that this file becomes src\ms\README.
  40.  
  41. On a Posix or Unix host, run the following commands.
  42. This has already been done in the distribution copy,
  43. but you may need to repeat it if you change the source files.
  44.  
  45.     make -fmakefile.mk clean
  46.     make -fmakefile.mk
  47.  
  48. On an MS-DOS, OS/2 or Windows/NT host, run the following commands:
  49.  
  50.     make -fms\bor.mk -DBCC=0    # Turbo C 2.01
  51.     make -fms\bor.mk -DBCC=2    # Borland C++ 2.0
  52.     make -fms\bor.mk -DBCC=3    # Borland C++ 3.x
  53.     nmake -f ms\nmake.mk OS=dos    # Microsoft C on DOS
  54.     nmake -f ms\nmake.mk OS=os2    # Microsoft C on OS/2
  55.     nmake -f ms\nmake.mk OS=nt    # Microsoft C on Windows/NT
  56.  
  57. To test RCS after you've installed it, make `installtest';
  58. if this fails, make `installdebug' for detailed info.
  59.  
  60. See also ..\README, particularly the note about text_work_stdio.
  61.  
  62. Some systems become painfully confused if the TZ environment variable 
  63. is not set.  We normally force the user to have a TZ environment 
  64. variable.  This can be controlled by the `TZ_must_be_set' flag found 
  65. in src\ms\conf.h.  The format of the TZ environment variable:
  66.  
  67.            TZ=zzz[+/-]d[d][lll]
  68.  
  69. zzz        A three-character string representing the name of the current 
  70.            time zone (PST, MST, EST, etc.).  All three characters are 
  71.            required.
  72.  
  73. [+/-]d[]d  A required field containing an optionally signed number of 
  74.            one or more digits.  This number is the local time zone's 
  75.            difference from GMT in hours.  Positive numbers adjust 
  76.            westward from GMT, negative numbers adjust eastward.  For 
  77.            example, 5=EST, +8=PST, and -1=continental Europe.
  78.  
  79. lll        An optional three-character field representing the local 
  80.            time zone daylight saving time.  "PDT" represents Pacific 
  81.            daylight saving time.
  82.  
  83. Remember, this software is distributed under the GNU General Public License,
  84. which means that normally you must distribute sources whenever you distribute
  85. executables; see COPYING.
  86.  
  87.  
  88. Credits:
  89.   Frank Whaley of Autodesk ported RCS to MS-DOS, OS/2 and Windows/NT.
  90.   Rich Braun of Kronos contributed Novell support.
  91.   Kai Uwe Rommel of the Technical University of Munich contributed many fixes.
  92.   Paul Eggert of Twin Sun integrated.
  93.  
  94.  
  95.   KNOWN PROBLEMS
  96.  
  97. If you specify a filename longer than the DOS limits, RCS uses the
  98. long filename, but DOS silently truncates it.  This can lead to
  99. spurious differences e.g. in the filenames in Id strings, because
  100. the filename you tell `rcsdiff' may differ from the name you told `co'.
  101.  
  102. By default, pathnames in $Header and $Source keyword expansions use /
  103. to separate pathname components, because \ prevents these expansions
  104. from being usefully placed into C strings.  If you prefer \ anyway,
  105. change the definition of SLASH in conf.h to '\\'.
  106.  
  107. Borland C++ 3.0 sometimes objects to tabs in preprocessor directives.
  108. Expand them to spaces to work around the problem.
  109.  
  110. When a network drive is used for RCS and a file is checked in using ci
  111. a sharing violation is reported by AT&T StarGroup because the work file
  112. is still open when diff (which also opens the work file) is run, and
  113. the AT&T StarGroup is indeed so brain damaged that it considers it a
  114. sharing violations for two processes to read the same file unless it is
  115. read only.  amiga!cbmvax!feith1!john (John L. Wehle) reports the
  116. following patch seems to work around the problem, but this fix is so
  117. entirely silly that we can't bring ourselves to fold it into the
  118. main source code.
  119.  
  120. *** src/ci.c.orig    Mon Feb 17 17:02:06 1992
  121. --- src/ci.c    Tue Mar 10 18:06:20 1992
  122. ***************
  123. *** 619,624 ****
  124. --- 619,625 ----
  125.               newdelnum.string, targetdelta->num
  126.               );
  127.               newdelta.log = getlogmsg();
  128. + Izclose(&workptr);
  129.               switch (run((char*)0, diffilename,
  130.               DIFF DIFF_FLAGS,
  131.               newhead ? workdiffname : expfilename,
  132. ***************
  133. *** 628,633 ****
  134. --- 629,638 ----
  135.               case DIFF_FAILURE: case DIFF_SUCCESS: break;
  136.               default: faterror("diff failed");
  137.               }
  138. + if (!(workptr = Iopen(workfilename, FOPEN_R_WORK, &workstat))) {
  139. +     eerror(workfilename);
  140. +     continue;
  141. + }
  142.               if (newhead) {
  143.               Irewind(workptr);
  144.               putdftext(newdelnum.string,newdelta.log,workptr,frewrite,false);
  145.  
  146.  
  147. John Steele <jsteele@netcom.com> reports:
  148.  
  149.     I have a problem with the makefile (nmake.mk) when it tries to create
  150.     ci.exe:
  151.  
  152.     nmake -f ms\nmake.mk OS=dos
  153.  
  154.         link /nologo /ST:16384 logindos.obj spawnvpq.obj c:\c6\lib\setargv.obj @
  155.     ms\ci.rsp,ci,nul,nul
  156.     Object Modules [.OBJ]: /nologo /ST:16384 logindos.obj spawnvpq.obj c:\c6\lib\set
  157.     argv.obj ci rcslex rcssyn rcsgen rcsedit rcskeys rcsmap rcsrev rcsutil rcsfnms p
  158.     artime maketime rcskeep rcsfcmp
  159.     Definitions File [NUL.DEF]:
  160.                    ^^^^ it stops here, and I press enter...
  161.     LINK : fatal error L1102: unexpected end-of-file
  162.     NMAKE : fatal error U1077: 'link' : return code '2'
  163.     Stop.
  164.  
  165.     Doesn't look like a valid link line to me (this does work under the 1.2 beta).
  166.     According to make, you can't mix response files with the rest...
  167.  
  168.     Microsoft (R) Segmented-Executable Linker  Version 5.10
  169.     Copyright (C) Microsoft Corp 1984-1990.  All rights reserved.
  170.  
  171.     Usage:
  172.  
  173.     LINK
  174.     LINK @<response file>
  175.     LINK <objs>,<exefile>,<mapfile>,<libs>,<deffile>
  176.