This is the mail archive of the
mailing list for the Cygwin project.
[RFC] 1.7 Packaging: Documentation
- From: "Yaakov (Cygwin Ports)" <yselkowitz at users dot sourceforge dot net>
- To: cygwin-apps at cygwin dot com
- Date: Fri, 15 Aug 2008 02:43:43 -0500
- Subject: [RFC] 1.7 Packaging: Documentation
-----BEGIN PGP SIGNED MESSAGE-----
A few ideas about package documentation for 1.7:
1) Info pages
Per a recent discussion on the main list, GNU info 'dir' will be managed
solely by _update-info-dir. Packagers should no longer use postinstall
scripts for this purpose; the next version of cygport will have the
2) which docs to package
There has been an unofficial list of "standard" docs which are installed
into the docdir. I think that among these, ABOUT-NLS and INSTALL should
be removed from the default list, as they generally serve no purpose for
a binary package.
As for license files, do we really need to install hundreds of copies of
the same license? IANAL, so does a symlink to the copy in base-files
suffice, or is the mere presence of the latter enough?
3) where to install docs
Could we remove the versioning from the docdir and Cygwin README, IOW:
Since only one version of foo can be installed at a time, this shouldn't
cause any difficulties, and would in fact alleviate several:
a) This is generally the default, and changing this for
non-autotool-based packages often requires a patch or an extra step in
b) This means that the docdir isn't moving with every version bump,
which currently makes it a chore when e.g. bookmarking HTML docs for
viewing in your favorite browser (either Win32 or Cygwin).
c) Several programs, e.g. IDEs, include documentation browsers, but they
need to be told where to find the docs; hence a version bump currently
requires changing the settings of that program.
d) In at least one case (KDevelop), these external docdirs are
*hard-coded* into the program with a configure switch!
cgf confirmed recently that ldesc: is still unused. Do we seriously
intend to ever use it, or should we forget it?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
-----END PGP SIGNATURE-----