resend update to sgml documentation

Dustin Navea speeddymon at yahoo.com
Sun Nov 10 23:24:24 CST 2002


--- Vincent Béron <vberon at mecano.gme.usherb.ca> wrote:
> Le dim 10/11/2002 à 19:49, Tony Lambregts a écrit :
[-snip-]
> > 
> > 
> > >
> > >I must say that the actual target name (for multiple builds) are not
> > >very good. Somebody has some ideas?
> > >
> > What would be wrong with the following targets
> > 
> > everything    All the guides in all the formats + wine-doc.html and the 
> > man page
> Why only wine-doc.html? Why not wine-doc.pdf and wine-doc.ps?
> 
> > allguides     All the guides in all formats + wine-doc.html
> Again, why only wine-doc.html?
> 
> > allhtml       All the guides in html + wine-doc.html
> > allpdf        All the guides in pdf
> > allps         All the guides in ps
> I ask the question again, why not wine-doc.pdf and wine-doc.ps? I don't
> see a reason for not building those, but I may have missed something.
> 
> Seems good to me (with the inclusion of wine-doc.pdf and .ps), with the
> exception that I'd keep the "separate" targets, so that you can build
> either the 4 separate guides (in whatever format you prefer), or the
> whole thing in one document. Else, with everything or allguides, you get
> twice each information, once in wine-doc and the other in the specific
> guide. It's valid for winehq.org, but not for packaging.
> 
> I'll rename the "separate" targets: wine-user, wine-devel, winelib-user,
> wine-pkg. Each will build the 3 formats of the specified guide.
> 
> Recap of make targets:
> 
> doc: wine-doc.{html,pdf,ps}
> guides: 4 guides in HTML, PDF, PS
> (I keep those three because they're more important than the other
> individual targets)
> html: wine-doc.html
> pdf: wine-doc.pdf
> ps: wine-dos.ps
> 
> wine-user: wine-user.{html,pdf,ps}
> wine-devel: wine-devel.{html,pdf,ps}
> winelib-user: wine-devel.{html,pdf,ps}
> wine-pkg: wine-pkg.{html,pdf,ps}
> allhtml: 4 guides in HTML + wine-doc.html
> allpdf: 4 guides in PDF + wine-doc.pdf
> allps: 4 guides in PS + wine-doc.ps
> alldoc: allhtml + allpdf + allps
> everything: alldoc + man
> 
> How's that?
> There's a lot of targets, I know. Too much, or is it still bearable?
> 
[-snip-]

It's missing one thing, the ability to make the 4 guides in 1 format (i.e.
"make guides.html" to make ONLY html format of the guides w/out the
wine-doc.html).  Should be 3 additional targets, 1 for each of html, ps, and
pdf, tacked onto the end of guides target.

-Dustin

__________________________________________________
Do you Yahoo!?
U2 on LAUNCH - Exclusive greatest hits videos
http://launch.yahoo.com/u2



More information about the wine-devel mailing list