cygwin: doc: cleanup cygutils info
Especially don't keep on about d2u and u2d. Dos2unix exists. Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
This commit is contained in:
parent
67e628fa33
commit
3476c8c868
|
@ -96,40 +96,16 @@ programs in your environment.
|
||||||
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="using-cygutils"><title>The cygutils package</title>
|
<sect2 id="using-shortcuts"><title>Creating shortcuts</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The optional <systemitem>cygutils</systemitem> package contains
|
By default, Cygwin does not create symlinks as .lnk files, but there's an
|
||||||
miscellaneous tools that are small enough to not require their own package.
|
option to do that, see <xref linkend="using-cygwinenv"></xref>.
|
||||||
It is not included in a default Cygwin install; select it from the Utils
|
|
||||||
category in <command>setup.exe</command>. Several of the
|
|
||||||
<systemitem>cygutils</systemitem> tools are useful for interacting with
|
|
||||||
Windows.</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
One of the hassles of Unix-Windows interoperability is the different line
|
|
||||||
endings on text files. As mentioned in <xref linkend="using-textbinary"></xref>,
|
|
||||||
Unix tools such as <command>tr</command> can convert between CRLF and LF
|
|
||||||
endings, but <systemitem>cygutils</systemitem> provides several dedicated programs:
|
|
||||||
<command>conv</command>, <command>d2u</command>, <command>dos2unix</command>,
|
|
||||||
<command>u2d</command>, and <command>unix2dos</command>. Use the
|
|
||||||
<literal>--help</literal> switch for usage information.
|
|
||||||
</para>
|
|
||||||
</sect2>
|
|
||||||
|
|
||||||
<sect2 id="using-shortcuts"><title>Creating shortcuts with cygutils</title>
|
|
||||||
<para>
|
|
||||||
Another problem area is between Unix-style links, which link one file
|
|
||||||
to another, and Microsoft .lnk files, which provide a shortcut to a
|
|
||||||
file. They seem similar at first glance but, in reality, are fairly
|
|
||||||
different. By default, Cygwin does not create symlinks as .lnk files,
|
|
||||||
but there's an option to do that, see <xref linkend="using-cygwinenv"></xref>.
|
|
||||||
These symlink .lnk files are compatible with Windows-created .lnk files,
|
These symlink .lnk files are compatible with Windows-created .lnk files,
|
||||||
but they are still different. They do not include much of the information
|
but they are still different. They do not include much of the information
|
||||||
that is available in a standard Microsoft shortcut, such as the working
|
that is available in a standard Microsoft shortcut, such as the working
|
||||||
directory, an icon, etc. The <systemitem>cygutils</systemitem>
|
directory, an icon, etc. The <systemitem>cygutils</systemitem>
|
||||||
package includes a <command>mkshortcut</command> utility for creating
|
package includes a <command>mkshortcut</command> utility for creating
|
||||||
standard native Microsoft .lnk files.
|
standard native Microsoft .lnk files from the command line.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
|
@ -144,11 +120,12 @@ Windows shortcuts.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="using-printing"><title>Printing with cygutils</title>
|
<sect2 id="using-printing"><title>Printing</title>
|
||||||
<para>
|
<para>
|
||||||
There are several options for printing from Cygwin, including the
|
There are several options for printing from Cygwin, including the
|
||||||
<command>lpr</command> found in <systemitem>cygutils</systemitem> (not to be confused with the
|
<command>lpr</command> found in <systemitem>cygutils-extra</systemitem>
|
||||||
native Windows <command>lpr.exe</command>). The easiest way to use <systemitem>cygutils</systemitem>'
|
(not to be confused with the native Windows <command>lpr.exe</command>).
|
||||||
|
The easiest way to use <systemitem>cygutils-extra</systemitem>'s
|
||||||
<command>lpr</command> is to specify a default device name in the
|
<command>lpr</command> is to specify a default device name in the
|
||||||
<envar>PRINTER</envar> environment variable. You may also specify a device
|
<envar>PRINTER</envar> environment variable. You may also specify a device
|
||||||
on the command line with the <literal>-d</literal> or <literal>-P</literal>
|
on the command line with the <literal>-d</literal> or <literal>-P</literal>
|
||||||
|
|
|
@ -75,8 +75,8 @@ since it only slows down reading and writing files. Additionally many
|
||||||
Windows applications can deal with POSIX \n line endings just fine
|
Windows applications can deal with POSIX \n line endings just fine
|
||||||
(unfortunate exception: Notepad). So we suggest to use binary mode
|
(unfortunate exception: Notepad). So we suggest to use binary mode
|
||||||
as much as possible and only convert files from or to DOS text mode
|
as much as possible and only convert files from or to DOS text mode
|
||||||
using tools specifically created to do that job, for instance, d2u and
|
using tools specifically created to do that job, for instance, dos2unix and
|
||||||
u2d from the cygutils package.
|
unix2dos from the dos2unix package.
|
||||||
</para>
|
</para>
|
||||||
<para>It is rather easy for the porter of a Unix package to fix the source
|
<para>It is rather easy for the porter of a Unix package to fix the source
|
||||||
code by supplying the appropriate file processing mode switches to the
|
code by supplying the appropriate file processing mode switches to the
|
||||||
|
|
|
@ -71,10 +71,9 @@
|
||||||
<para>
|
<para>
|
||||||
<ulink url="http://cygwin.com/cygwin-ug-net/using-utils.html"/>
|
<ulink url="http://cygwin.com/cygwin-ug-net/using-utils.html"/>
|
||||||
</para>
|
</para>
|
||||||
<para>The optional <package>cygutils</package> package also contains
|
<para>The optional <package>cygutils</package> and
|
||||||
utilities that help with common problems, such as
|
<package>cygutils-extra</package> packages also contain utilities that
|
||||||
<command>dos2unix</command> and <command>unix2dos</command> for the
|
help with common problems.</para>
|
||||||
CRLF issue.</para>
|
|
||||||
</refsect1>
|
</refsect1>
|
||||||
<refsect1>
|
<refsect1>
|
||||||
<title>DOCUMENTATION</title>
|
<title>DOCUMENTATION</title>
|
||||||
|
|
|
@ -98,8 +98,8 @@ handle binmode files just fine. A notable exception is the mini-editor
|
||||||
and only produces output files with DOS CRLF lineendings.</para>
|
and only produces output files with DOS CRLF lineendings.</para>
|
||||||
|
|
||||||
<para>You can convert files between CRLF and LF lineendings by using
|
<para>You can convert files between CRLF and LF lineendings by using
|
||||||
certain tools in the Cygwin distribution like <command>d2u</command> and
|
certain tools in the Cygwin distribution like <command>dos2unix</command> and
|
||||||
<command>u2d</command> from the cygutils package. You can also specify
|
<command>unix2dos</command> from the dos2unix package. You can also specify
|
||||||
a directory in the mount table to be mounted in textmode so you can use
|
a directory in the mount table to be mounted in textmode so you can use
|
||||||
that directory for exchange purposes.</para>
|
that directory for exchange purposes.</para>
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue