Re: The downside of math::

2016-10-24 Thread Jani Nikula
On Mon, 24 Oct 2016, Johannes Berg wrote: > But yes, I also agree that we shouldn't add any dependencies where the > input isn't suitable as a fallback, since that also means that the > input is going to be difficult to read and write in the source, which > should remain a reasonable way to read t

Re: The downside of math::

2016-10-24 Thread Johannes Berg
> I'd like to refine: Do not add non-trivial hard dependencies. Do not > add dependencies the lack of which make large parts of generated > documentation useless. > > Graceful degradation on unmet dependencies is the key here. Agree. > Give a build > warn about missing dependencies. Try to do

Re: The downside of math::

2016-10-24 Thread Jani Nikula
On Mon, 24 Oct 2016, Johannes Berg wrote: > On Sun, 2016-10-23 at 12:58 +0200, Markus Heiser wrote: >> Further I think we should not generate more (and more) external >> requirements like e.g. plantuml, Java or reportlab discussed here: > > I still disagree, I think we should make it easy to "opt

Re: The downside of math::

2016-10-24 Thread Johannes Berg
On Sun, 2016-10-23 at 12:58 +0200, Markus Heiser wrote: > If you don't want to see a warning log, we have to consider  > a solution like Johannes Berg posted here: > >  https://www.mail-archive.com/linux-doc@vger.kernel.org/msg07071.html > > @johannes: since this thread and our "sequence diagram

Re: The downside of math::

2016-10-23 Thread Markus Heiser
Am 21.10.2016 um 23:38 schrieb Jonathan Corbet : > On Thu, 20 Oct 2016 17:55:21 +0300 > Jani Nikula wrote: > >> I wonder if we could cook up a nice way to make the math:: usage >> conditional on actually being able to render it. > > I think that's the ideal solution. > > I got the docs build

Re: The downside of math::

2016-10-21 Thread Jonathan Corbet
On Thu, 20 Oct 2016 17:55:21 +0300 Jani Nikula wrote: > I wonder if we could cook up a nice way to make the math:: usage > conditional on actually being able to render it. I think that's the ideal solution. I got the docs build working again on my Fedora machine, but it threw me back into this

Re: The downside of math::

2016-10-20 Thread Markus Heiser
Am 20.10.2016 um 16:55 schrieb Jani Nikula : >> So, I really prefer not removing math support. > > I wonder if we could cook up a nice way to make the math:: usage > conditional on actually being able to render it. > > I would rather have the math:: directive produce just the preformatted > inde

Re: The downside of math::

2016-10-20 Thread Jani Nikula
On Thu, 20 Oct 2016, Mauro Carvalho Chehab wrote: > Hi Jon, > > Em Wed, 19 Oct 2016 17:02:46 -0600 > Jonathan Corbet escreveu: > >> Hey, Mauro, >> >> So I was a little surprised to find that the htmldocs build now breaks on >> one of my machines due to a lack of LaTeX. A bit of digging turned u

Re: The downside of math::

2016-10-19 Thread Mauro Carvalho Chehab
Em Wed, 19 Oct 2016 22:26:18 -0200 Mauro Carvalho Chehab escreveu: > Hi Jon, > > Em Wed, 19 Oct 2016 17:02:46 -0600 > Jonathan Corbet escreveu: > > > Hey, Mauro, > > > > So I was a little surprised to find that the htmldocs build now breaks on > > one of my machines due to a lack of LaTeX. B

Re: The downside of math::

2016-10-19 Thread Mauro Carvalho Chehab
Hi Jon, Em Wed, 19 Oct 2016 17:02:46 -0600 Jonathan Corbet escreveu: > Hey, Mauro, > > So I was a little surprised to find that the htmldocs build now breaks on > one of my machines due to a lack of LaTeX. A bit of digging turned up > the culprit: commit b7ff94df5628 (pixfmt-007.rst: use Sphin

The downside of math::

2016-10-19 Thread Jonathan Corbet
Hey, Mauro, So I was a little surprised to find that the htmldocs build now breaks on one of my machines due to a lack of LaTeX. A bit of digging turned up the culprit: commit b7ff94df5628 (pixfmt-007.rst: use Sphinx math:: expressions). The math:: directive uses LaTeX to process the math markup