Date: Wed, 30 Jan 2013 22:45:23 +0100 From: Gabor Kovesdan <gabor@FreeBSD.org> To: Hiroki Sato <hrs@FreeBSD.org> Cc: doc@FreeBSD.org Subject: Re: RFC: Dealing with version-specific docs Message-ID: <51099473.60802@FreeBSD.org> In-Reply-To: <20130131.051215.1551317688782223614.hrs@allbsd.org> References: <51065CFC.5090803@FreeBSD.org> <20130131.051215.1551317688782223614.hrs@allbsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Em 30-01-2013 21:12, Hiroki Sato escreveu: > I have no objection to use @os (or some other attrs) for conditional > text, but it may need an attention that profiling feature of DocBook > XSLT is exclusive, IIRC. What I mean by "exclusive" is that it works > for elements for each version like this: > > <para os="freebsd8" >8.X specific</para> > <para os="freebsd9" >9.X specific</para> > <para os="freebsd10">10.X specific</para> > > but we cannot write the common part like this: > > <para os="freebsd8 freebsd9">8.X and 9.X specific</para> > <para os="freebsd10">10.X specific</para> It is true, that's why I proposed the semantics to be "up to X until the version, which has a new marked section". DocBook profiling is indeed exclusive but online the printed edition would be profiled and it would exclusively contain FreeBSD 9.X related information, while the online edition would not be profiled so would contain everything. > > In a past, I created and used a patch (for another project) to > support multiple keywords and negation (condition="!print" for > ignoring it only in printable formats) in an attr for profiling > because some more flexibility was needed. However, in this case > there is another drawback that validation is not possible and a typo > in the profiling attr, "freedsb8" for example, is silently ignored. I had Schematron validation in mind but since I'm still polishing the toolchain part I didn't mention it, just wanted to give the editors a starting point to avoid blocking the content reorganization because of the technical issues. Gabor
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?51099473.60802>