This is the mail archive of the
cygwin
mailing list for the Cygwin project.
RE: Cygwin Users Guide (cygwin-ug-net.html) not installed with doc
- From: "Otto Hirr" <otto dot hirr at olabinc dot com>
- To: <cygwin at cygwin dot com>
- Date: Sat, 15 Jan 2011 07:42:26 -0800
- Subject: RE: Cygwin Users Guide (cygwin-ug-net.html) not installed with doc
- Reply-to: <otto dot hirr at olabinc 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