This is the mail archive of the
cygwin-patches
mailing list for the Cygwin project.
Re: [PATCH] DocBook XML toolchain modernization
- From: Warren Young <warren at etr-usa dot com>
- To: cygwin-patches at cygwin dot com
- Date: Tue, 30 Apr 2013 14:09:52 -0600
- Subject: Re: [PATCH] DocBook XML toolchain modernization
- References: <20130423152014 dot GG26397 at calimero dot vinschen dot de> <5178049C dot 7000108 at etr-usa dot com> <20130424172039 dot GA27256 at calimero dot vinschen dot de> <51782505 dot 5020502 at etr-usa dot com> <20130424185210 dot GE26397 at calimero dot vinschen dot de> <51783EBC dot 30409 at etr-usa dot com> <20130425084305 dot GA29270 at calimero dot vinschen dot de> <517F15AF dot 5080307 at etr-usa dot com> <20130430184703 dot GB6865 at ednor dot casa dot cgf dot cx> <51801469 dot 9070606 at etr-usa dot com> <20130430190706 dot GC6865 at ednor dot casa dot cgf dot cx>
On 4/30/2013 13:07, Christopher Faylor wrote:
On Tue, Apr 30, 2013 at 12:58:49PM -0600, Warren Young wrote:
Do you mean for me to check these changes in when I get my sourceware
account?
Yes, with the implied assumption that you won't be breaking anything.
Of course.
Some questions from the original post:
- When a change is checked in to the docs, does it immediately propagate
to the public web site, or is there a manual publication process? I
mean, if the build is technically broken for a few seconds while I check
in a batch of changes, does it immediately break cygwin.com? If so,
that would require that I check in only self-contained change sets even
if it means long CVS log messages.
- Am I right that we no longer need the second FAQ output format?
- http://cygwin.com/faq.html appears to be assembled from a site-wide
style/navigation file and winsup/doc/faq/faq.html. Is that right, and
if so, do you mind if I add a target to the Makefile that gets you a
secondary variant of faq.html containing just the <body> tag's contents?
Embedding <html> within <html> is eeevil.
- Do you want me to do the proposed doctool to Doxygen conversion, so we
can get rid of doctool?
- If I get rid of doctool, do you agree that we no longer need Autoconf
for the docs?
- Is someone using the @srcdir@ feature of the current doc build system
to build outside the source tree? (e.g. mkdir foo ; cd foo ;
../configure && make) If so, is my "SRCDIR=.. ; make -f ../Makefile"
alternative acceptable?
(If no one is using the @srcdir@ feature, then we *definitely* don't
need Autoconf any more after doctool goes away.)
- Any comments about the other items in my FUTURE WORK section?
Unconditional green light, or do you want to approve them one by one?