This is the mail archive of the
cygwin-patches
mailing list for the Cygwin project.
May I remove setup.xml and cygwin-ug.xml?
- From: Warren Young <warren at etr-usa dot com>
- To: Cygwin Patches <cygwin-patches at cygwin dot com>
- Date: Fri, 10 May 2013 12:19:49 -0600
- Subject: May I remove setup.xml and cygwin-ug.xml?
These files in winsup/doc appear to have been replaced by setup-net.xml
and cygwin-ug-net.xml. The Makefile doesn't use either of these as
input to any of its outputs, and they're not referenced by any of the
other input files.
Further, if you try to build a document from either of these, you get
errors due to missing XML chunks. (e.g. setup-reg.xml, referenced by
setup.xml, doesn't exist.)
When I first discovered this, I thought for sure it meant I'd somehow
screwed up the SGML to DocBook XML conversion, but ruled that out thus:
$ grep -Rsl setup-reg winsup
If you do that to both the current tree and to a tree rolled back to
before I got my commit bit, you find that only setup.{xml,sgml} contains
that string. It means the pre-Warren tree couldn't build documents from
this file, either.
I'm not in any particular hurry to get rid of these files. They only
trouble they're causing is the same any clutter causes. I want to make
sure no one knows a reason either has to remain in existence before I
nuke them.