Em Fri, 28 Oct 2016 11:07:15 +0200 Markus Heiser <markus.heiser@xxxxxxxxxxx> escreveu: > Am 28.10.2016 um 08:54 schrieb Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>: > > That sounds like a good plan to me, and patches to fix up typos to keep > > things being able to be parsed properly should be fine. > > I followed this discussion and now I wan't to come back to the "Was" of > the subject [1] where the sphinx kernel-cmd directive was introduced ;-) > > My conclusion of this and other discussions on the linux-doc ML is; we > have the situation, where *old hats* want to stay with perl, since they > are productive with, while sphinx is in the python domain. And there > is a need (to answer [2]). Can't speak for others, but for me, perl is great for writing parsing scripts. I can produce reliable scripts in perl on almost no time, like the one I wrote today to parse the ABI file. > IMO, the sphinx kernel-cmd directive [1] is the gate in between sphinx's > python and the perl domains. I agree. > I know that Jani [2] and Jon [3] have reasonable doubt about such a > directive. So I want to ask, if we all can life with this compromise: > > * rebase [1] on top of Jon's docs-next > * apply patch [4] to fix a tab issue > * fix kernel-cmd to start only *.pl scripts from Documentation/sphinx [5] > * add documentation [2] > > Should we take this away? .. if so, I can send patch series, but I want > to ask this first, before I implement a "parse-headers" replacement > a third time. ;-) It is up to Jon to decide that. Maybe he wants to get some feedback about that on KS next week. - On a separate matter: any news with regards to the man pages Sphinx extension? > > --Markus-- > > [1] https://www.mail-archive.com/linux-doc@xxxxxxxxxxxxxxx/msg06657.html > [2] https://www.mail-archive.com/linux-doc@xxxxxxxxxxxxxxx/msg07075.html > [3] https://www.mail-archive.com/linux-doc@xxxxxxxxxxxxxxx/msg07080.html > [4] https://www.mail-archive.com/linux-doc@xxxxxxxxxxxxxxx/msg06941.html > [5] https://www.mail-archive.com/linux-doc@xxxxxxxxxxxxxxx/msg07082.html > Thanks, Mauro -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
