On Wed, 2006-11-22 at 16:56, Paul Traina wrote: > Mike Noyes wrote: > > On Wed, 2006-11-22 at 14:50, Paul Traina wrote: > >> Mike Noyes wrote: > >>> I believe, an even better solution is using DocBook XInclude from LEAF > >>> to the Shorewall site. This is only possible if you're using DocBook XML > >>> <reference> to generate man pages, and the docbook xml source is > >>> available via uri. > >> The only problem with that idea that I can think of, is that it > >> vulnerable to Tom changing URLs or updating the documentation for > >> Shorewall while we have not updated or changed ours. > > > > Paul, > > A broken XInclude would fail validation. It shouldn't go longer than a > > day without notice. Also, our doc-build.sh script is robust enough to > > bail on error, and leave the current documentation alone. > > > > > > http://leaf.cvs.sourceforge.net/leaf/sourceforge/admin/doc-build.sh?revision=1.13&view=markup > > > > Again, this is provided you have the docbook reference source available > > via uri. DocBook XInclude won't work otherwise. > > > > Note: this solution will provide LEAF a local current xslt->html > > version of the Shorewall docbook reference (man page). > > > >> Up to you. > > > > Are you using DocBook v5, or 4.4? I haven't had time to learn the new v5 > > tool chain. The move to schema (RELAX NG) and XSLT 2 are both going to > > require considerable time/effort to learn properly. > > > > I don't do docbook at all. When I edited chapters, I just used an XML > style editor and made good guesses as to what you guys needed. In the > end, I think KP cleaned up a few tags. > > What troubles me more is that Tom updates the documentation on his site > to represent the state of the art in shorewall v5, and the currently > shipping versions of LEAF or BU are using shorewall v3, our > documentation will not match the code we're shipping. <snip>
Paul, This is another reason for keeping the man pages in our repository. We are sure to have the correct version used in leaf branches that way. Right now we are setup this way. Any change will require some type of effort. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: leaf, phpwebsite, phpwebsite-comm, sitedocs ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys - and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ leaf-devel mailing list leaf-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/leaf-devel
