From: <ea...@us...> - 2002-05-05 15:07:32
|
Update of /cvsroot/mingw/msys/dvlpr/doc/msys In directory usw-pr-cvs1:/tmp/cvs-serv20837/doc/msys Modified Files: MSYS-1.0.7-changes.rtf README.rtf Log Message: * script/msys.iss.in ([Run]): Debug it. Add an execution of the README.rtf. * pi/pi.bat: New file. * doc/msys/MSYS-1.0.7-changes.rtf: Update with msys.bat changes and postinstall information. * doc/msys/README.rtf: Correct the Win32 switch data, format for rtf, and move the change history section to the end. Add sections "Working with MinGW", "Working with other products" and "Disclaimer". Rename "Using different binaries" to "Using binaries with different runtimes". * var/pi.dat: Add pi.bat. Index: MSYS-1.0.7-changes.rtf =================================================================== RCS file: /cvsroot/mingw/msys/dvlpr/doc/msys/MSYS-1.0.7-changes.rtf,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 Binary files /tmp/cvsojB1DC and /tmp/cvssHSs34 differ Index: README.rtf =================================================================== RCS file: /cvsroot/mingw/msys/dvlpr/doc/msys/README.rtf,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** README.rtf 18 Apr 2002 12:17:07 -0000 1.1 --- README.rtf 5 May 2002 15:07:29 -0000 1.2 *************** *** 1,15 **** ! {\rtf1\ansi\ansicpg1252\deff0\deftab720{\fonttbl{\f0\fswiss MS Sans Serif;}{\f1\froman\fcharset2 Symbol;}{\f2\fmodern Courier New;}{\f3\froman Times New Roman;}} ! {\colortbl\red0\green0\blue0;} ! \deflang1033\horzdoc{\*\fchars }{\*\lchars }\pard\tx2610\plain\f2\fs20\b\i File:\plain\f2\fs20\i \tab \plain\f2\fs20 README ! \par \plain\f2\fs20\b\i Copyright (C):\plain\f2\fs20 \tab 2001, 2002 Earnie Boyd <ea...@us...> ! \par \plain\f2\fs20\b\i Distribution:\plain\f2\fs20 \tab See MSYS_LICENSE ! \par \plain\f2\fs20\b\i MSYS Revision:\plain\f2\fs20 \tab 1.0.6 ! \par \plain\f2\fs20\b\i MSYS Revision date:\plain\f2\fs20\i \tab \plain\f2\fs20 March 17th, 2002 ! \par \pard\plain\f2\fs20 ! \par \plain\f2\fs20\b\i Preface:\plain\f2\fs20 ! \par Ok, you have installed msys and now you're reading this to understand how to get started. However, I must first explain some important facts about Msys. Msys file system maps (mounts) are automatic and happens as described in table 1. These automatic file system maps are not changable by the user. User defined file system maps can be created by specifying them in the /etc/fstab directory as explained in table 2. \par ! \par \plain\f2\fs20\b\i TABLE 1 - Automatic file system maps:\plain\f2\fs20 ! \par + ---------------------------------------------------------------------------- + \par | The automatic mounts are relative to where the msys-1.0.dll (DLL) is located | \par | such that the following is true: | --- 1,28 ---- ! {\rtf1\ansi\ansicpg1252\uc1 \deff0\deflang1033\deflangfe1033{\fonttbl{\f0\froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman;}{\f2\fmodern\fcharset0\fprq1{\*\panose 02070309020205020404}Courier New;} ! {\f16\fmodern\fcharset0\fprq1{\*\panose 020b0609040504020204}Lucida Console;}{\f17\froman\fcharset238\fprq2 Times New Roman CE;}{\f18\froman\fcharset204\fprq2 Times New Roman Cyr;}{\f20\froman\fcharset161\fprq2 Times New Roman Greek;} ! {\f21\froman\fcharset162\fprq2 Times New Roman Tur;}{\f22\froman\fcharset186\fprq2 Times New Roman Baltic;}{\f29\fmodern\fcharset238\fprq1 Courier New CE;}{\f30\fmodern\fcharset204\fprq1 Courier New Cyr;}{\f32\fmodern\fcharset161\fprq1 Courier New Greek;} ! {\f33\fmodern\fcharset162\fprq1 Courier New Tur;}{\f34\fmodern\fcharset186\fprq1 Courier New Baltic;}{\f113\fmodern\fcharset238\fprq1 Lucida Console CE;}{\f114\fmodern\fcharset204\fprq1 Lucida Console Cyr;} ! {\f116\fmodern\fcharset161\fprq1 Lucida Console Greek;}{\f117\fmodern\fcharset162\fprq1 Lucida Console Tur;}}{\colortbl;\red0\green0\blue0;\red0\green0\blue255;\red0\green255\blue255;\red0\green255\blue0;\red255\green0\blue255;\red255\green0\blue0; ! \red255\green255\blue0;\red255\green255\blue255;\red0\green0\blue128;\red0\green128\blue128;\red0\green128\blue0;\red128\green0\blue128;\red128\green0\blue0;\red128\green128\blue0;\red128\green128\blue128;\red192\green192\blue192;}{\stylesheet{ ! \widctlpar\adjustright \fs20\cgrid \snext0 Normal;}{\*\cs10 \additive Default Paragraph Font;}{\s15\widctlpar\tqc\tx4320\tqr\tx8640\adjustright \fs20\cgrid \sbasedon0 \snext15 header;}{\s16\widctlpar\tqc\tx4320\tqr\tx8640\adjustright \fs20\cgrid ! \sbasedon0 \snext16 footer;}}{\info{\author OMNIBOOK 500}{\operator OMNIBOOK 500}{\creatim\yr2002\mo5\dy5\hr8\min53}{\revtim\yr2002\mo5\dy5\hr10\min44}{\version4}{\edmins65}{\nofpages3}{\nofwords1165}{\nofchars6643}{\*\company Qwest Communications Corp.} ! {\nofcharsws8158}{\vern113}}\widowctrl\ftnbj\aenddoc\hyphcaps0\viewkind1\viewscale100 \fet0\sectd \linex0\sectdefaultcl {\header \pard\plain \nowidctlpar\tx2610\adjustright \fs20\cgrid {\b\i\f2\cgrid0 File:}{\i\f2\cgrid0 \tab }{\f2\cgrid0 README ! \par }{\b\i\f2\cgrid0 Copyright (C):}{\f2\cgrid0 \tab 2001, 2002 Earnie Boyd <ea...@us...> ! \par }{\b\i\f2\cgrid0 Distribution:}{\f2\cgrid0 \tab See MSYS_LICENSE ! \par }{\b\i\f2\cgrid0 MSYS Revision:}{\f2\cgrid0 \tab 1.0.7 ! \par }{\b\i\f2\cgrid0 MSYS Revision date:}{\i\f2\cgrid0 \tab }{\f2\cgrid0 May 5th, 2002 \par ! \par }\pard \qc\nowidctlpar\tx2610\adjustright {\i\f2\cgrid0 Page }{\field{\*\fldinst {\i\f2\cgrid0 PAGE }}{\fldrslt {\i\f2\lang1024\cgrid0 2}}}{\i\f2\cgrid0 of }{\field{\*\fldinst {\i\f2\cgrid0 NUMPAGES }}{\fldrslt {\i\f2\lang1024\cgrid0 1}}}{\i\f2\cgrid0 ! ! \par }\pard\plain \s15\widctlpar\tqc\tx4320\tqr\tx8640\adjustright \fs20\cgrid { ! \par }}{\footer \pard\plain \s16\widctlpar\tqc\tx4320\tqr\tx8640\adjustright \fs20\cgrid { ! \par }}{\*\pnseclvl1\pnucrm\pnstart1\pnindent720\pnhang{\pntxta .}}{\*\pnseclvl2\pnucltr\pnstart1\pnindent720\pnhang{\pntxta .}}{\*\pnseclvl3\pndec\pnstart1\pnindent720\pnhang{\pntxta .}}{\*\pnseclvl4\pnlcltr\pnstart1\pnindent720\pnhang{\pntxta )}} ! {\*\pnseclvl5\pndec\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl6\pnlcltr\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl7\pnlcrm\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl8 ! \pnlcltr\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl9\pnlcrm\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}\pard\plain \nowidctlpar\adjustright \fs20\cgrid {\b\i\f2\cgrid0 Preface:}{\f2\cgrid0 ! \par Ok, you have installed msys and now you're reading this to understand how to get started. However, I must first explain some important facts about Msys. Msys file system bindings (mounts) are automatic and happens as described in table 1. These ! automatic file system bindings are not changable by the user. User defined file system bindings can be created by specifying them in the /etc/fstab directory as explained in table 2. ! \par ! \par }{\b\i\f2\cgrid0 TABLE 1 - Automatic file system maps:}{\f2\cgrid0 ! \par }{\f16\fs16\cgrid0 + ---------------------------------------------------------------------------- + \par | The automatic mounts are relative to where the msys-1.0.dll (DLL) is located | \par | such that the following is true: | *************** *** 26,32 **** \par | | \par + ---------------------------------------------------------------------------- + ! \par ! \par \plain\f2\fs20\b\i TABLE 2 - /etc/fstab layout:\plain\f2\fs20 ! \par + ---------------------------------------------------------------------------- + \par | The record format for the /etc/fstab is current a simple one. I need to | \par | work on the syntax parsing more so that things like embedded spaces work. | --- 39,45 ---- \par | | \par + ---------------------------------------------------------------------------- + ! \par }{\f2\cgrid0 ! \par }{\b\i\f2\cgrid0 TABLE 2 - /etc/fstab layout:}{\f2\cgrid0 ! \par }{\f16\fs16\cgrid0 + ---------------------------------------------------------------------------- + \par | The record format for the /etc/fstab is current a simple one. I need to | \par | work on the syntax parsing more so that things like embedded spaces work. | *************** *** 38,43 **** \par | As you can see this is simply the Win32 path mapped to a mount point. It is | \par | unix practice to have the /bar created as an empty directory before it can | ! \par | mount the mount point. Msys doesn't force this and may or may not be to | ! \par | your advantage. | \par | | \par | If you create a /etc/fstab record that maps to an automatic mount point Msys | --- 51,57 ---- \par | As you can see this is simply the Win32 path mapped to a mount point. It is | \par | unix practice to have the /bar created as an empty directory before it can | ! \par | mount the mount point. Msys doesn't force this but it will be to advantage | ! \par | if you do. Some programs, e.g. find, and some operations, e.g. tab | ! \par | operate better if the physical directory is present for those mount points. | \par | | \par | If you create a /etc/fstab record that maps to an automatic mount point Msys | *************** *** 47,106 **** \par | | \par + ---------------------------------------------------------------------------- + \par ! \par Msys will convert POSIX paths that are used as arguments to Win32 paths. This ! \par is done for any executable not in /bin and /usr/bin. If the executable is ! \par dependant on the msys-1.0.dll then it must be located in the /bin or /usr/bin ! \par directory. This means that you now have a POSIX environment that will ! \par automagically do the right thing wrt changing the paths passed as arguments. ! \par Arguments beginning with a / and have a length of two will be passed to the ! \par program unchanged to allow for the command.com/cmd.exe (Win32) style switch. ! \par This means that if you want to pass a drive as an argument you must use a ! \par notation similar to /c/ or c:/ (one may work better than the other in some ! \par cases). An example of a Win32 style switch is `write /p /mydocs/msys-rocks.' ! \par In this example write (a.k.a. WordPad) exists in the c:\\winnt\\system32 ! \par path on my system. The /p tells write to print the document. And ! \par /mydocs/msys-rocks converts to c:\\msys\\1.0\\mydocs\\msys-rocks so that write can ! \par find it. ! \par ! \par Version 1.0.3 added checks for paths following an `=' and `-X' where X ! \par is a program switch. \par ! \par Version 1.0.4 added symlink resolution, removed the dependancy that the path ! \par must begin with a / and removed bash.exe since sh.exe is bash.exe anyway. Also ! \par added diff, diff3 and head to the distribution. An MSYS icon exists in the ! \par rxvt binary. \par ! \par Version 1.0.5 is a bug fix release that filters out the conversion of quoted ! \par relative paths. So that -DSOME_CONSTANT=\\"1.0.5\\" can be properly input into ! \par gcc. Also fixed the problem with sh.exe reading /etc/profile with \\r\\n line ! \par endings. Added the binaries true.exe, false.exe, tail.exe and fold.exe. ! \par Updated the gmake binary to the Cygwin version including the --win32 switch. I ! \par am suggesting to use this version of make and have copied /bin/gmake.exe to ! \par /bin/make (yes without the .exe). If you wish to go back to the "native" ! \par version of make typing make.exe will get you there. \par ! \par Version 1.0.6 is a bug fix release plus some additional binaries. See the MSYS-1.0.6-changes.rtf document for specifics. \par ! \par Version 1.0.7 added path list conversion and returns the Win32 path with pwd. There are a number of other fixes which you can find in the MSYS-1.0.7-changes.rtf document. \par ! \par \plain\f2\fs20\b\i STARTING Msys: ! \par \plain\f2\fs20 Starting Msys should now just be a matter of clicking on the MSYS icon on your desktop or Start menu. If you have the File Manager window open, you may now click on it and have it start also. Doing these presents you with a console window within which you may enter commands. \par ! \par \plain\f2\fs20\b\i Other documentation:\plain\f2\fs20 ! \par Be sure to read the MSYS_ series. I have tried to document how I'm changing ! \par the cygwin code to allow us to use it with MSYS. These can be found in the ! \par /doc/msys directory, or you can find them in the /usr/doc/msys directory. \par ! \par \plain\f2\fs20\b\i Using different binaries:\plain\f2\fs20 ! \par You can't use Cygwin binaries at all. You can use Win32 native binaries but you ! \par should put them into the /mingw/bin directory tree. If you wish to replace an ! \par MSYS binary with a native win32 version then delete the /bin version. \par ! \par \plain\f2\fs20\b\i Bug Reports:\plain\f2\fs20 ! \par Send your bug reports to Min...@li.... \par ! \par \plain\f2\fs20\b\i User Posts:\plain\f2\fs20 ! \par Min...@li... \par ! \par } ! |