X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=4.8 required=5.0	tests=AWL,BAYES_50,T_RP_MATCHES_RCVD
X-Spam-Check-By: sourceware.org
Reply-To: <otto DOT hirr AT olabinc DOT com>
From: "Otto Hirr" <otto DOT hirr AT olabinc DOT com>
To: <cygwin AT cygwin DOT com>
Subject: Cygwin Users Guide (cygwin-ug-net.html) not installed with doc
Date: Fri, 14 Jan 2011 09:50:40 -0800
Message-ID: <04ec01cbb413$8ffb71f0$1d05a8c0@olabinc.com>
MIME-Version: 1.0
Content-Type: text/plain;	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com

Greetings,

Seems odd that the "Cygwin User's Guide" (html) is not installed with the
"cygwin-doc" package. The package descriptions claims to include the "User's
Guide".

The install file, cygwin-doc-1.7-1.tar.bz2, contains a cygwin-ug-net.info
file, installed in usr/share/info.

Attempts even to use 'info' have failed.
Attempting 'info cygwin-ug-net' yields
  No menu item `cygwin-ug-net' in node '(dir)Top'.
Editing 'dir' to include cygwin-ug-net (as follows (w/o indent)):
  * Cygwin Users Guide: (cygwin-ug-net). Cygwin Users Guide.
results in the following when menu selected:
  Cannot find node `Top'.

(Ok, so I've used 'info' in the past, even written some doc for it. But that
was long ago and I was not a guru then and certainly not now.)

This _should_not_ be this hard.

By default, cygwin-doc, should provide html files as does Cygwin/X Users
Guide, not info files.

(No this is not to start some discussion on the merits of info over
html/browser, the world wide web adoption has spoken.)

There is very useful information in the 'Cygwin Users Guide'. It should be
part of the basic "cygwin-doc" package, so that one does not have to go out
to the web to read it.

So is this an error, oversite, or have I missed installing some other
package that includes this?  Or have I missed something very obvious?

Regards,

..Otto



--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple