To answer a previous question you posed, It worked fairly well, with one minor 
problem that dtinfogen keeps throwing a very nondescript error of "dtinfogen: 
sgmls not found
make[4]: *** [usersGuide/TOC.sgm] Error 255"


Thank you for your time,
-Chase

‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
On July 31, 2018 3:06 PM, Jon Trulson <j...@radscan.com> wrote:

> I guess we should at some point discuss the whole SGML infrastructure in
> CDE.
>
> http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/sgml.html
>
> This link provides a decent 'demystification' of docbook and where it is
> going.
>
> http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/
>
> XML is the current markup format, and explains why the openjade (onsgmls
> et. al.) tools haven't been updated since 2005. We are essentially
> replacing one ancient tool, with a slightly less ancient tool.
>
> From the page:
>
> http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/sgml.html
>
> =-=
> "13.3. Why SGML DocBook is dead
>
> The DSSSL toolchain is, as far as new development goes, effectively
> dead. The XSLT toolchain has reached production status in mid-2002; a
> working version shipped in Red Hat 7.3. It's where DocBook developers
> are putting almost all of their effort.
>
> The reason for the change to XML was threefold. First, SGML turned out
> to be too complicated to use; then, DSSSL turned out to be too
> complicated to live with; then, significant parts of the DSSSL toolchain
> turned out to be weak and irredeemably messy.
>
> Relative to SGML, XML has a reduced feature set that is sufficient for
> almost all purposes but much easier to understand and build parsers for.
> SGML-processing tools (such as validating parsers) have to carry around
> support for a lot of features that DocBook and other text markup systems
> never actually used. Removing these features made XML simpler and
> XML-processing tools faster.
>
> The language used to describe SGML DTDs is sufficiently spiky and
> forbidding that composing SGML DTDs was something of a black art. XML
> DTDs, on the other hand, can be described in a dialect of XML itself;
> there does not need to be a separate DTD language. An XML description of
> an XML DTD is called a schema; the term DTD itself will probably pass
> out of use as the standards for schemas firm up.
>
> But mostly the DSSSL toolchain is dead because DSSSL itself, the SGML
> stylesheet description language in that toolchain, proved just too
> arcane for most human beings, and made stylesheets too difficult to
> write and modify. (It was a dialect of Scheme. Your humble editor, a
> LISP-head from way back, shakes his head in sad bemusement that this
> should drive people away.)
>
> XML fans like to sum up all these changes with "XML: tastes great, less
> filling."
> =-=
>
> :)
>
> So - is anyone on this list familiar with docbook XML want to take up
> the task of upgrading our documentation format and generation to
> something from this decade?
>
> Short term, using a new onsgmls is probably the way to go, but long
> term, it seems clear we need to update to a proper, modern docbook XML.
>
> -jon
>
> On 07/31/2018 12:53 PM, Jon Trulson wrote:
>
> > On 07/30/2018 10:29 PM, Matthew R. Trower wrote:
> >
> > > Chase via cdesktopenv-devel cdesktopenv-devel@lists.sourceforge.net
> > > writes:
> > >
> > > > The reason I chose opensp instead of sp is simply because when I tried
> > > > installing sp on Lubuntu, it gave me an error saying "Package sp has
> > > > no installation candidate", although it is in the debian repos, so I
> > > > don't know whats happening with that. I also picked it due to looking
> > > > at the *bsd and solaris repos, and most seem to have opensp, but not
> > > > sp itself.
> > >
> > > > On July 30, 2018 5:53 PM, Jon Trulson j...@radscan.com wrote:
> > > >
> > > > > Well, I'd like to hear from Chase as to whether that is actually the
> > > > > case on Debian.
> > > > > As I mentioned before, nsgmls exists on Ubuntu 16.04 after installing
> > > > > the "sp" package.
> > >
> > > At least on illumos/OpenSolaris, opensp contains onsgmls and nsgmls.
> > > The latter is a link to the former.  I don't think the opensp package
> > > itself contains these links; I think it is a distribution "extra".
> > > Debian 9 contains opensp, but not sp.  There is no symlink from onsgmls
> > > to nsgmls.  I can't comment on BSD at this time.
> >
> > I checked on ubuntu 16.04, it has both "sp" and "opensp".   Installing
> > "opensp" does provide the onsgmls program.  nsgmls comes from the "sp"
> > package, and is not a symlink to onsgmls.
> > I have confirmed that FreeBSD also has opensp in its ports collection --
> > I'm not sure about OpenBSD.  So it does seem like opensp is the way to go.
> >
> > > I'm not really familiar with these programs, but it seems to me that
> > > OpenSP is the continuation of SP (any expert is welcome to correct me).
> > > As such, I'd say we should default to using that (and onsgmls), rather
> > > than old SP.  If people want/need to use old SP, they can always
> > > override it in host.def.
> >
> > That's the impression I got too, however if you go to the opensp
> > (OpenJade) SF page, it isn't updated very often, and there seems to be
> > no interaction with the developers.
> > https://sourceforge.net/projects/openjade/
> > There are 71 open tickets reports with no responses by any of the
> > developers that I could see in my skimming around.  It does not seem
> > very actively developed, but there does not seem to be any alternative.
> >
> > > And of course, if we know about types of systems where that's necessary,
> > > it could go into their system cf files.
> > > Some links about SP and OpenSP
> > >    SP:     http://www.jclark.com/sp/howtoget.htm
> > >    OpenSP: http://openjade.sourceforge.net/doc/index.htm
> > > Version histories, which seem indicative of a transition.
> > >    SP:     http://openjade.sourceforge.net/doc/new.htm
> > >    OpenSP: http://openjade.sourceforge.net/doc/NEWS
> > > OpenJade in general
> > >    http://openjade.sourceforge.net/
> >
> > I guess we should stick to onsgmls for now.
> > Chase: Did it actually work well?  The help system, man pages, and
> > dtinfo stuff worked/looked ok?
>
> --
>
> Jon Trulson
>
> "Fire all weapons and open a hailing frequency for my victory yodle."
>
> - Zapp Brannigan
>
> -----------------------------------------------------------------------------------------------------
>
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>
> cdesktopenv-devel mailing list
> cdesktopenv-devel@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/cdesktopenv-devel



------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
cdesktopenv-devel mailing list
cdesktopenv-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/cdesktopenv-devel

Reply via email to