This is the mail archive of the
cygwin-apps
mailing list for the Cygwin project.
Re: HELP with Cygwin docs needed
- From: Corinna Vinschen <corinna-cygwin at cygwin dot com>
- To: cygwin-apps at cygwin dot com
- Date: Wed, 24 Apr 2013 20:52:10 +0200
- Subject: Re: HELP with Cygwin docs needed
- 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>
- Reply-to: cygwin-apps at cygwin dot com
On Apr 24 12:31, Warren Young wrote:
> On 4/24/2013 11:20, Corinna Vinschen wrote:
> >
> >- What is the advantage of changing the format?
> [...]
> And as I now see, it looks like most of this work has been done
> already. It looks like the main things remaining would be to rename
> *.sgml to *.xml and *.dsl to *.xsl to reflect their actual current
> contents, wrap the "SGML" fragment documents in proper XML
> containers, and then probably switch from the nonstandard doctool to
> XIncludes.
>
> I suspect that if I did that, you won't immediately see a
> difference, except that all .sgml became .xml.
>
> >- Will it work equally well to build the docs on Cygwin and on Fedora?
> > Are the tools part of a default distro in both environments?
>
> The GNOME docs are split between DocBook XML and SGML[1]. So, yes,
> you can generally count on having the DocBook XML tools installed on
> Red Hattish Linuxes. And if not, say because you've got a
> minimalist install, the tools are in the stock repos.
>
> As for Cygwin, I've built my two DBX manuals under Cygwin before,
> just to prove it can be done. I tend to build on Linux and OS X for
> normal development, however, so it's been a while since I've tried
> this.
Ok, that sounds pretty good. It's just important that *before* the
transition, we have to make sure that all tools are in the Cygwin
distro as well. I'm building my stuff on Fedora so I'm off the hook,
but the basic idea is that everbody using the Cygwin tools should be
able to build the Cygwin package, including the docs.
So, if XInclude is not in the distro (I didn't check, actually), we need
a volunteer to provide it before changing the Cygwin docs. I think I
know just the right guy ;)
Corinna
--
Corinna Vinschen Please, send mails regarding Cygwin to
Cygwin Maintainer cygwin AT cygwin DOT com
Red Hat