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:
Corinna Vinschen 2017-12-05 17:58:02 +01:00
parent 67e628fa33
commit 3476c8c868
4 changed files with 15 additions and 39 deletions

View File

@ -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>

View File

@ -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

View File

@ -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>

View File

@ -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>