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

- Raw text -