XML and Docbook aren't the problem. The problem is that Docbook should be
parsed according to stylesheets to take care of spacing to be converted to
.txt, xml and other relevant outputs. XML serves a purpose, and the current
tools for editing documentation are avoiding what XML was set to do,
On Fri, Jul 06, 2018 at 10:06:39PM +0200, Sid wrote:
> Whenever an improvement is suggested for documentation at FreeBSD's
> bugzilla, it sits there for months or even over a year.
Unfortunately this is not limited to doc PRs. We do a little bit
better at ports due to the "maintainer" concept.
On Sat, Jul 07, 2018 at 09:16:37PM +0200, Sid wrote:
> I think simplifying the process so that only Docbook needs to be
> learned well for edit proposals will make it easier for those
> submitting bug reports, and especially for committers.
While I agree with this, I'd rather let people know that
Thank you for your response. The tools I'm referring to are igor and xmllint.
Mention of igor is here,
https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview.html .
(the other link had the mistake of including the sentence punctuation)
Mention of xmllint is in chapter 7.2.
Other
On Fri, 6 Jul 2018 at 17:41, Sid wrote:
>
> I'm aware of FreeBSD's XSLT and DSSSL stylesheets, mentioned at
> https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/stylesheets.html,
> but they should be used exclusively for its Docbook XML.
>
> XSLT's stylesheet needs to be a part of
I'm aware of FreeBSD's XSLT and DSSSL stylesheets, mentioned at
https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/stylesheets.html,
but they should be used exclusively for its Docbook XML.
XSLT's stylesheet needs to be a part of automating of tabbing and stripping of
spacing outside