libs/newlib-cygwin
libs
/
newlib-cygwin
mirror of git://sourceware.org/git/newlib-cygwin.git
4
0
Fork 0
Code Issues Projects Releases Wiki Activity

* faq-using.xml (faq.using.converting-paths): Remove reference to 

cygwin.bat.
	(faq.using.emacs): Drop "CYGWIN=tty" setting.
	* pathnames.sgml (pathnames-posixdevices): Align list of device names
	with changes in 1.7.10.
	* setup2.sgml (setup-env-ov): Drop text which assumes that Cygwin
	processes are started in console window.  Align wording to lessened
	relevance of $CYGWIN.  Don't use dropped CYGWIN setting in example.
	(setup-locale-how): Put using console and Cygwin.bat file into
	perspective.
	(setup-locale-problems): Ditto.
This commit is contained in:
Corinna Vinschen 2011-11-18 11:39:31 +00:00
parent 4cc465db9a
commit 6a8a9ad8d8
4 changed files with 59 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
winsup/doc/ChangeLog
View File

@ -1,3 +1,17 @@
2011-11-17 Corinna Vinschen <corinna@vinschen.de>
* faq-using.xml (faq.using.converting-paths): Remove reference to
cygwin.bat.
(faq.using.emacs): Drop "CYGWIN=tty" setting.
* pathnames.sgml (pathnames-posixdevices): Align list of device names
with changes in 1.7.10.
* setup2.sgml (setup-env-ov): Drop text which assumes that Cygwin
processes are started in console window. Align wording to lessened
relevance of $CYGWIN. Don't use dropped CYGWIN setting in example.
(setup-locale-how): Put using console and Cygwin.bat file into
perspective.
(setup-locale-problems): Ditto.
2011-11-08 Corinna Vinschen <corinna@vinschen.de> 2011-11-08 Corinna Vinschen <corinna@vinschen.de>
* new-features.sgml (ov-new1.7.10): Document ptsname_r. * new-features.sgml (ov-new1.7.10): Document ptsname_r.

12
winsup/doc/faq-using.xml
View File

@ -113,10 +113,10 @@ information. For example (on my installation):
<screen> <screen>
bash$ cygpath --windows ~/.bashrc bash$ cygpath --windows ~/.bashrc
D:\starksb\.bashrc D:\starksb\.bashrc
bash$ cygpath --unix C:/cygwin/bin/cygwin.bat bash$ cygpath --unix C:/cygwin/bin/ls.exe
/usr/bin/cygwin.bat /usr/bin/ls.exe
bash$ cygpath --unix C:\\cygwin\\bin\\cygwin.bat bash$ cygpath --unix C:\\cygwin\\bin\\ls.exe
/usr/bin/cygwin.bat /usr/bin/ls.exe
</screen> </screen>
Note that bash interprets the backslash '\' as an escape character, so Note that bash interprets the backslash '\' as an escape character, so
you must type it twice in the bash shell if you want it to be recognized you must type it twice in the bash shell if you want it to be recognized
@ -785,9 +785,7 @@ need in order to run GNU emacs in a terminal window. If you also want
to be able to use the X11 to be able to use the X11
(<ulink url="http://cygwin.com/xfree/">http://cygwin.com/xfree/</ulink>) (<ulink url="http://cygwin.com/xfree/">http://cygwin.com/xfree/</ulink>)
GUI, install the emacs-X11 package. In either case, you run emacs by GUI, install the emacs-X11 package. In either case, you run emacs by
typing 'emacs' or '/usr/bin/emacs'. If you run emacs in the cygwin typing 'emacs' or '/usr/bin/emacs'.
console, be sure that your CYGWIN environment variable contains tty.
See /usr/share/doc/Cygwin/emacs.README for further information.
</para> </para>
</answer></qandaentry> </answer></qandaentry>

22
winsup/doc/pathnames.sgml
View File

@ -706,17 +706,23 @@ Cygwin supports the following character devices commonly found on POSIX systems:
/dev/zero /dev/zero
/dev/full /dev/full
/dev/console Pseudo device name for the standard console window created /dev/console Pseudo device name for the current console window of a session.
by Windows. Same as the one used for cmd.exe. Every one Up to Cygwin 1.7.9, this was the only name for a console.
of them has this name. It's not quite comparable with the Different consoles were indistinguishable.
console device on UNIX machines. Cygwin's /dev/console is not quite comparable with the console
device on UNIX machines.
/dev/cons0 Starting with Cygwin 1.7.10, Console sessions are numbered from
/dev/cons1 /dev/cons0 upwards. Console device names are pseudo device
... names, only accessible from processes within this very console
session. This is due to a restriction in Windows.
/dev/tty The current controlling tty of a session.
/dev/tty The current tty of a session running in a pseudo tty.
/dev/ptmx Pseudo tty master device. /dev/ptmx Pseudo tty master device.
/dev/ttym
/dev/tty0 Pseudo ttys are numbered from /dev/tty0 upwards as they are /dev/pty0 Pseudo ttys are numbered from /dev/pty0 upwards as they are
/dev/tty1 requested. /dev/pty1 requested.
... ...
/dev/ttyS0 Serial communication devices. ttyS0 == Win32 COM1, /dev/ttyS0 Serial communication devices. ttyS0 == Win32 COM1,

59
winsup/doc/setup2.sgml
View File

@ -3,31 +3,23 @@
<sect2 id="setup-env-ov"><title>Overview</title> <sect2 id="setup-env-ov"><title>Overview</title>
<para> <para>
You may wish to specify settings of several important environment All Windows environment variables are imported when Cygwin starts.
variables that affect Cygwin's operation. Some of these settings need Apart from that, you may wish to specify settings of several important
to be in effect prior to launching the initial Cygwin session (before environment variables that affect Cygwin's operation.</para>
starting your bash shell, for instance). They should therefore be set
in the Windows environment; all Windows environment variables are
imported when Cygwin starts. Such settings can be
placed in a .bat file. An initial file is named Cygwin.bat and is created
in the Cygwin root directory that you specified during setup. Note that
the "Cygwin" option of the Start Menu points to Cygwin.bat. Edit
Cygwin.bat to your liking or create your own .bat files to start
Cygwin processes.</para>
<para> <para>
The <envar>CYGWIN</envar> variable is used to configure many global The <envar>CYGWIN</envar> variable is used to configure a few global
settings for the Cygwin runtime system. Initially you can leave settings for the Cygwin runtime system. Typically you can leave
<envar>CYGWIN</envar> unset or set it to a value indicating several <envar>CYGWIN</envar> unset, but if you want to set one ore more
global Cygwin settings, using a syntax like this in the DOS shell, options, you can set it using a syntax like this, depending on the shell
before launching bash:</para> in which you're setting it. Here is an example in CMD syntax:</para>
<screen> <screen>
<prompt>C:\&gt;</prompt> <userinput>set CYGWIN=notitle glob</userinput> <prompt>C:\&gt;</prompt> <userinput>set CYGWIN=error_start:C:\cygwin\bin\gdb.exe glob</userinput>
</screen> </screen>
<para> <para>
This is, of course, just an example. For all possible settings of the This is, of course, just an example. For the recognized settings of the
<envar>CYGWIN</envar> environment variable, see <envar>CYGWIN</envar> environment variable, see
<xref linkend="using-cygwinenv"></xref>. <xref linkend="using-cygwinenv"></xref>.
</para> </para>
@ -395,9 +387,10 @@ You don't want to use the default character set? In that case you have to
specify the charset explicitly. For instance, assume you're from Japan and specify the charset explicitly. For instance, assume you're from Japan and
don't want to use the japanese default charset EUC-JP, but the Windows don't want to use the japanese default charset EUC-JP, but the Windows
default charset SJIS. What you can do, for instance, is to set the default charset SJIS. What you can do, for instance, is to set the
<envar>LANG</envar> variable in the <filename>C:\cygwin\Cygwin.bat</filename> <envar>LANG</envar> variable in the <command>mintty</command> Cygwin Terminal
file which is the batch file to start a Cygwin session from the "Cygwin" in the "Text" section of its "Options" dialog. If you're starting your
desktop shortcut.</para> Cygwin session via a batch file or a shortcut to a batch file, you can also
just set LANG there:</para>
<screen> <screen>
@echo off @echo off
@ -443,19 +436,19 @@ every Unicode character.</emphasis></para>
<sect2 id="setup-locale-console"><title>The Windows Console character set</title> <sect2 id="setup-locale-console"><title>The Windows Console character set</title>
<para>Most of the time the Windows console is used to run Cygwin applications. <para>Sometimes the Windows console is used to run Cygwin applications.
While terminal emulations like <command>xterm</command> or While terminal emulations like the Cygwin Terminal <command>mintty</command>
<command>mintty</command> have a distinct way to set the character set or <command>xterm</command> have a distinct way to set the character set
used for in- and output, the Windows console hasn't such a way, since it's used for in- and output, the Windows console hasn't such a way, since it's
not an application in its own right.</para> not an application in its own right.</para>
<para>This problem is solved in Cygwin as follows. When a Cygwin <para>This problem is solved in Cygwin as follows. When a Cygwin
process is started in a Windows console (either explicitly from cmd.exe, process is started in a Windows console (either explicitly from cmd.exe,
or implicitly by, for instance, clicking on the Cygwin desktop icon, or or implicitly by, for instance, running the
running the Cygwin.bat file), the Console character set is determined by the <filename>C:\cygwin\Cygwin.bat</filename> batch file), the Console character
setting of the aforementioned internationalization environment variables, set is determined by the setting of the aforementioned
the same way as described in <xref linkend="setup-locale-how"></xref>. internationalization environment variables, the same way as described in
</para> <xref linkend="setup-locale-how"></xref>. </para>
<para>What is that good for? Why not switch the console character set with <para>What is that good for? Why not switch the console character set with
the applications requirements? After all, the application knows if it uses the applications requirements? After all, the application knows if it uses
@ -473,10 +466,10 @@ problem.</para>
<sect2 id="setup-locale-problems"><title>Potential Problems when using Locales</title> <sect2 id="setup-locale-problems"><title>Potential Problems when using Locales</title>
<para> <para>
You can set the above internationalization variables not only in You can set the above internationalization variables not only when
<filename>Cygwin.bat</filename> or in the Windows environment, but also starting the first Cygwin process, but also in your Cygwin shell on the
in your Cygwin shell on the fly, even switch to yet another character fly, even switch to yet another character set, and yet another. In bash
set, and yet another. In bash for instance:</para> for instance:</para>
<screen> <screen>
<prompt>bash$</prompt> export LC_CTYPE="nl_BE.UTF-8" <prompt>bash$</prompt> export LC_CTYPE="nl_BE.UTF-8"