X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=1.1 required=5.0	tests=AWL,BAYES_00,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: RE: Cygwin Users Guide (cygwin-ug-net.html) not installed with doc
Date: Sat, 15 Jan 2011 07:42:26 -0800
Message-ID: <053401cbb4ca$d065d840$1d05a8c0@olabinc.com>
MIME-Version: 1.0
Content-Type: text/plain;	charset="us-ascii"
Content-Transfer-Encoding: 7bit
In-Reply-To: <20110115064609.GA19088@ednor.casa.cgf.cx>
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
List-Id: <cygwin.cygwin.com>
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT 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

> From: Christopher Faylor > Sent: Friday, January 14, 2011 10:46 PM
> > Otto wrote:
> >I'm not sure which you are calling a bug:
> >1) no html docs
> >2) failing info cmd on cygwin-ug-net
> >
> >I'm thinking your are refering to (2).
>
> Yes.  I am referring to 2, i.e., the actual thing I
> mentioned.  It can't
> be a "bug" if it was never intended to have html docs in the package.

So can we also add a "feature" request, to generate the html docs also?

From a broad, "how can we make something more user friendly for the broadest
set of users", generating the html doc is the appropriate thing to do.

X/Cygwin generates 5 different formats (pdf, ps, rtf, txt) and info is NOT
one of them.

If one asks:

* what is best for the community
* what provides the most accessibility to the most people
* does it make sense to have Cygwin and Cygwin/X look
  like they are all part of the same family

then generating the additional formats, in addition to the info format is
the appropriate thing to do. And I mean to package and distribute via
setup.exe in the cygwin-doc package. And not just using the generated html
for the cygwin website.

...digging deeper... I'm a bit surprised...

So I'm not a cygwin src or bin guru, but looking at the src for the doc,
http://cygwin.com/cgi-bin/cvsweb.cgi/src/winsup/doc/Makefile.in?rev=1.1&cont
ent-type=text/x-cvsweb-markup&cvsroot=src
html files have been generated since Makefile rev 1.1. (Appears as if you
were the original check-in person).

You state:
> It can't be a "bug" if it was never
> intended to have html docs in the package.

I fail to understand your comment and why this is not a bug as even the
latest 1.27 Makefile shows the following lines:

tarball : cygwin-docs.tar.bz2
cygwin-docs.tar.bz2 : $(TBFILES) $(TBDEPS)
        find $(TBFILES) $(TBDIRS) \! -type d | sort | tar -T - -cf -  |
bzip2 > cygwin-docs.tar.bz2

Why is the html not included?
Is there some other wrapper generating the bin-distribution for setup?
Why does it not include the html?
Maybe I'm being daftly ignorant and/or missing something...
Am I looking at the wrong sources?

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