Date: Fri, 14 Jan 2011 17:39:56 -0500
From: Christopher Faylor <cgf-use-the-mailinglist-please AT cygwin DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: Cygwin Users Guide (cygwin-ug-net.html) not installed with doc
Message-ID: <20110114223956.GA16751@ednor.casa.cgf.cx>
Reply-To: cygwin AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
References: <04ec01cbb413$8ffb71f0$1d05a8c0 AT olabinc DOT com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <04ec01cbb413$8ffb71f0$1d05a8c0@olabinc.com>
User-Agent: Mutt/1.5.20 (2009-06-14)
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com

On Fri, Jan 14, 2011 at 09:50:40AM -0800, Otto Hirr wrote:
>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?

So to paraphrase:

"I've tried to type "info cygwin-ug-net" and it failed saying "No menu item
'cygwin-ug-net'".  I believe this is a bug."

Yes.  It's a bug.

It will be fixed.

cgf

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