[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34992&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34992
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 08/Jan/17 18:29
Start Date: 08/Jan/17 18:29
Worklog Time Spent: 10m
Work Description: Github user jbfavre commented on the issue:
https://github.com/apache/trafficserver/pull/1303
AFAIK, there're no case yet where an issue exists only on Github.
But, this has been "announced" by Bryan Call on trafficserver-dev:
https://mail-archives.apache.org/mod_mbox/trafficserver-dev/201612.mbox/%3ce5d8e071-8de0-4930-bc2d-15cae1d57...@apache.org%3e
so I asume this will come to reality one day.
Like I said, I won't go against the Autolink feature :)
Issue Time Tracking
---
Worklog Id: (was: 34992)
Time Spent: 2h 50m (was: 2h 40m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 2h 50m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34989&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34989
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 08/Jan/17 16:33
Start Date: 08/Jan/17 16:33
Worklog Time Spent: 10m
Work Description: Github user jablko commented on the issue:
https://github.com/apache/trafficserver/pull/1303
> The ``inliner`` parameter takes an instance of `states.Inliner` or a
subclass.
> It handles inline markup recognition. A common extension is the addition
of
> further implicit hyperlinks, like "RFC 2822". This can be done by
subclassing
> `states.Inliner`, adding a new method for the implicit markup, and adding
a
> ``(pattern, method)`` pair to the "implicit_dispatch" attribute of the
> subclass. See `states.Inliner.implicit_inline()` for details.
https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/docutils/parsers/rst/__init__.py#l59
This is exactly what we're doing. I think it's okay that Docutils added the
init_customizations() method between versions -- it sounds like it was their
only option.
I don't have a strong sense yet how we want to reference GitHub issues (are
there any cases yet?) so it's hard to judge whether consistency between Jira
and GitHub is desirable. One thing I personally like about TS-1234 (for Jira)
is that we use the same in commit messages, source code comments, etc. so it's
consistent in that sense.
Issue Time Tracking
---
Worklog Id: (was: 34989)
Time Spent: 2h 40m (was: 2.5h)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 2h 40m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34988&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34988
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 08/Jan/17 15:35
Start Date: 08/Jan/17 15:35
Worklog Time Spent: 10m
Work Description: Github user jbfavre commented on the issue:
https://github.com/apache/trafficserver/pull/1303
Well, at least I won't go against it :)
When fixing it in first place, docutils devs feedback was that we wrongly
used Inliner, in the sense it's supposed to be internal.
What if another docutils internal change breaks it again ? Don't think it
won't happen because the discussion I had showed that not every docutils dev is
happy with last change. So, chances are that there'll be another refacto, maybe
for 0.15 or 0.16.
Better solution, in both docutils devs & myself, should be to make Sphinx
allow customization.
Second concern is that, IMHO, we shouldn't allow 2 different syntax to
reference trafficserver issues in documentation.
This usually leads to confusion (why should I use one more than another ?)
Finally, the fix I made has another positive effect: we now have a
consistent way of referencing issues, for both Jira & Github. For now, I don't
see any way to differentiate Jira & github ones with the Autolink feature.
My 2 cents,
Issue Time Tracking
---
Worklog Id: (was: 34988)
Time Spent: 2.5h (was: 2h 20m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 2.5h
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34987&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34987
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 08/Jan/17 15:26
Start Date: 08/Jan/17 15:26
Worklog Time Spent: 10m
Work Description: Github user jablko commented on the issue:
https://github.com/apache/trafficserver/pull/1303
@zwoop Yes, I'd like to backport this to 7.1.x if @SolidWallOfCode, @jsime,
and @jbfavre approve it. #1296 is in 7.1.x already.
Issue Time Tracking
---
Worklog Id: (was: 34987)
Time Spent: 2h 20m (was: 2h 10m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 2h 20m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34961&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34961
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 08/Jan/17 02:52
Start Date: 08/Jan/17 02:52
Worklog Time Spent: 10m
Work Description: Github user zwoop commented on the issue:
https://github.com/apache/trafficserver/pull/1303
We need into 7.1.x as well, right?
Issue Time Tracking
---
Worklog Id: (was: 34961)
Time Spent: 2h 10m (was: 2h)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 2h 10m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34931&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34931
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 06/Jan/17 21:19
Start Date: 06/Jan/17 21:19
Worklog Time Spent: 10m
Work Description: Github user atsci commented on the issue:
https://github.com/apache/trafficserver/pull/1303
Linux build *successful*! See
https://ci.trafficserver.apache.org/job/Github-Linux/1203/ for details.
Issue Time Tracking
---
Worklog Id: (was: 34931)
Time Spent: 2h (was: 1h 50m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 2h
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34930&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34930
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 06/Jan/17 21:15
Start Date: 06/Jan/17 21:15
Worklog Time Spent: 10m
Work Description: Github user atsci commented on the issue:
https://github.com/apache/trafficserver/pull/1303
FreeBSD build *successful*! See
https://ci.trafficserver.apache.org/job/Github-FreeBSD/1309/ for details.
Issue Time Tracking
---
Worklog Id: (was: 34930)
Time Spent: 1h 50m (was: 1h 40m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 1h 50m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34929&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34929
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 06/Jan/17 21:02
Start Date: 06/Jan/17 21:02
Worklog Time Spent: 10m
Work Description: GitHub user jablko opened a pull request:
https://github.com/apache/trafficserver/pull/1303
TS-5107: Changes to autolinking in Docutils 1.3
Restore the autolinking code and update it for Docutils 1.3, which added
the init_customizations() method. It works with Docutils 1.2 and 1.3 now.
@jbfavre already fixed this in #1296, thanks! I realize it would've been
much better if I'd had this ready at the beginning of the week ...
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/jablko/trafficserver docutils
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/trafficserver/pull/1303.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #1303
commit 8ee31f9bdfa8969c685b0ca11fb6306ba5068811
Author: Jack Bates
Date: 2017-01-06T19:49:30Z
Revert "Fix nested role (not supported)"
This reverts commit 9e374946a6700bf9766d011dadbc05891d92f058.
commit d3c244f43f68c02d2b652f91b418d3dccaa3a511
Author: Jack Bates
Date: 2017-01-06T19:49:42Z
Revert "Fix documentation build for docutils 0.13.1 (2/2)"
This reverts commit f3e37f8e104a74700b35816e50f32f95ee436741.
commit 6f1b0cbc235dd8d7e92d1e0d868ed55a76237a27
Author: Jack Bates
Date: 2017-01-06T19:49:46Z
Revert "Fix documentation build for docutils 0.13.1 (1/2)"
This reverts commit ac0db847e841d50fd38920234166a45762b00398.
commit 8a6fa8392d42caf5588df523f370debffcd7537b
Author: Jack Bates
Date: 2017-01-06T19:55:44Z
TS-5107: Changes to autolinking in Docutils 1.3
init_customizations() was added in Docutils 1.3.
Issue Time Tracking
---
Worklog Id: (was: 34929)
Time Spent: 1h 40m (was: 1.5h)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
>Assignee: Jean Baptiste Favre
> Fix For: 7.0.1
>
> Time Spent: 1h 40m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34694&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34694
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 04/Jan/17 17:32
Start Date: 04/Jan/17 17:32
Worklog Time Spent: 10m
Work Description: Github user jsime closed the pull request at:
https://github.com/apache/trafficserver/pull/1296
Issue Time Tracking
---
Worklog Id: (was: 34694)
Time Spent: 1.5h (was: 1h 20m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 1.5h
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34642&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34642
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 04/Jan/17 12:44
Start Date: 04/Jan/17 12:44
Worklog Time Spent: 10m
Work Description: Github user suenway commented on the issue:
https://github.com/apache/trafficserver/pull/1296
This is an automatically generated message.
sun...@yahoo-inc.com is no longer with Yahoo! Inc.
Your message will not be forwarded.
If you have a sales inquiry, please email yahoosa...@yahoo-inc.com and
someone will follow up with you shortly.
If you require assistance with a legal matter, please send a message to
legal-noti...@yahoo-inc.com
Thank you!
Issue Time Tracking
---
Worklog Id: (was: 34642)
Time Spent: 1h 20m (was: 1h 10m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 1h 20m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34641&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34641
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 04/Jan/17 12:43
Start Date: 04/Jan/17 12:43
Worklog Time Spent: 10m
Work Description: Github user jbfavre commented on the issue:
https://github.com/apache/trafficserver/pull/1296
I've updated the pull request.
Now supports `:ts:jira:` as well as `:ts:github:` syntax.
I've updated the current documentation to fix issues which used the old
syntax.
Still have to update the whole documentation, but my concern here is to get
the PR merged so that I can backport it to Debian package and avoid its removal
(because build fails because of docutils 0.13.1 being in Debian)
Issue Time Tracking
---
Worklog Id: (was: 34641)
Time Spent: 1h 10m (was: 1h)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 1h 10m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34531&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34531
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 03/Jan/17 17:51
Start Date: 03/Jan/17 17:51
Worklog Time Spent: 10m
Work Description: Github user jbfavre commented on the issue:
https://github.com/apache/trafficserver/pull/1296
All right, I'll implement both, shouldn't be too difficult :)
But I first have to figure out how to build a link with a XRefRole
subclass. Doesn't work for now :-/
Issue Time Tracking
---
Worklog Id: (was: 34531)
Time Spent: 1h (was: 50m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 1h
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34526&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34526
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 03/Jan/17 16:42
Start Date: 03/Jan/17 16:42
Worklog Time Spent: 10m
Work Description: Github user jsime commented on the issue:
https://github.com/apache/trafficserver/pull/1296
I was thinking mostly in terms of the historical references, since the old
& closed Jira issues aren't being migrated. Only the new work (and existing,
but codeless, Jira tickets) are GitHub-bound as I understand it, and the two
systems have independent sequences for the issue numbers.
Grep shows a dozen-ish Jira issue mentions on head (most with no markup, so
this PR will be a great improvement). Marking them up with a `:ts:jira:` would
leave their links intact and valid for all posterity while we add a separate
`:ts:issue:` for referencing all future tickets to GitHub.
Issue Time Tracking
---
Worklog Id: (was: 34526)
Time Spent: 50m (was: 40m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 50m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34525&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34525
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 03/Jan/17 16:20
Start Date: 03/Jan/17 16:20
Worklog Time Spent: 10m
Work Description: Github user jbfavre commented on the issue:
https://github.com/apache/trafficserver/pull/1296
@jsime I just wonder wether keeping the difference between Jira and Github
is still relevant, after the Jira to Github move annouced by Brian ?
Issue Time Tracking
---
Worklog Id: (was: 34525)
Time Spent: 40m (was: 0.5h)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 40m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34524&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34524
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 03/Jan/17 16:07
Start Date: 03/Jan/17 16:07
Worklog Time Spent: 10m
Work Description: Github user jsime commented on the issue:
https://github.com/apache/trafficserver/pull/1296
Seconding @SolidWallOfCode's suggestion on a rename. My preference would be
for this to be renamed `:ts:jira:` for two reasons: following the existing
convention used by `:ts:cv:` and friends as well as distinguishing between Jira
issues and GitHub issues.
Other than the name, this looks good.
Issue Time Tracking
---
Worklog Id: (was: 34524)
Time Spent: 0.5h (was: 20m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 0.5h
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34515&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34515
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 03/Jan/17 14:17
Start Date: 03/Jan/17 14:17
Worklog Time Spent: 10m
Work Description: Github user SolidWallOfCode commented on the issue:
https://github.com/apache/trafficserver/pull/1296
I would prefer to put the role in the 'ts' domain, e.g. `:ts:issue:` or
`ts:jira`. This would be more consistent with existing practice. E.g.
```
:ts:cv:`proxy.config.net.sock_packet_tos_in` and :ts:jira:`1090`
```
instead of
```
:ts:cv:`proxy.config.net.sock_packet_tos_in` and :tsissue:`1090`
```
Issue Time Tracking
---
Worklog Id: (was: 34515)
Time Spent: 20m (was: 10m)
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 20m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
[jira] [Work logged] (TS-5107) ATS 7.0.0 doesn't build against python docutils 0.13.1
[
https://issues.apache.org/jira/browse/TS-5107?focusedWorklogId=34509&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-34509
]
ASF GitHub Bot logged work on TS-5107:
--
Author: ASF GitHub Bot
Created on: 03/Jan/17 13:42
Start Date: 03/Jan/17 13:42
Worklog Time Spent: 10m
Work Description: GitHub user jbfavre opened a pull request:
https://github.com/apache/trafficserver/pull/1296
TS-5107: Fix documentation for docutils >= 0.13
Change introduced in docutils 0.13.0 breaks current documentation build.
Current doc build uses docutils Inliner monkey patching which is likely to
break with each docutils internal changes.
Therefore, I removed the Inliner monkey patching, introduced classic
docutils roles
definition using traffic_server extension.
I also updated the documentation using the new rst syntax introduced by the
role.
To declare an issue in the documentation one must now use folowing syntax:
`:tsissue:\`\`` where is the Jira's issue number.
Jira's base url is defined in `doc/conf.py` in variable
`trafficserver_issue_url`.
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/jbfavre/trafficserver
fix_doc_for_docutils_0.13.1
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/trafficserver/pull/1296.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #1296
commit df24cdb43f9cfb69bc8208f1ba80d01c27bc0b9f
Author: Jean Baptiste Favre
Date: 2017-01-03T13:32:09Z
TS-5107: Fix documentation for docutils >= 0.13
Change introduced in docutils 0.13.0 breaks current documentation build.
Current doc build uses docutils Inliner monkey patching which is likely to
break with each docutils internal changes.
Therefore, I removed the Inliner monkey patching, introduced classic
docutils roles
definition using traffic_server extension.
I also updated the documentation using the new rst syntax introduced by the
role.
To declare an issue in the documentation one must now use folowing syntax:
`:tsissue:\`\`` where is the Jira's issue number.
Jira's base url is defined in `doc/conf.py` in variable
`trafficserver_issue_url`.
Issue Time Tracking
---
Worklog Id: (was: 34509)
Time Spent: 10m
Remaining Estimate: 0h
> ATS 7.0.0 doesn't build against python docutils 0.13.1
> --
>
> Key: TS-5107
> URL: https://issues.apache.org/jira/browse/TS-5107
> Project: Traffic Server
> Issue Type: Bug
> Components: Documentation
>Reporter: Jean Baptiste Favre
> Time Spent: 10m
> Remaining Estimate: 0h
>
> Trying to build ATS 7.0.0 with python docutils 0.13.1 on Debian fails
> with following error:
> {code}Making all in doc
> make[2]: Entering directory '/home/debocker/source/build/doc'
> PAPEROPT_a4="-D latex_paper_size=a4" PAPEROPT_letter="-D
> latex_paper_size=letter" PAPER="letter" ./sbuild sphinx-build -c . -d
> docbuild/doctrees -b man . docbuild/man
> Running Sphinx v1.4.9
> making output directory...
> WARNING: sphinx.ext.pngmath has been deprecated. Please use
> sphinx.ext.imgmath instead.
> loading pickled environment... not yet created
> building [mo]: targets for 0 po files that are out of date
> building [man]: all manpages
> updating environment: 456 added, 0 changed, 0 removed
> reading sources... [ 0%] admin-guide/configuration/cache-basics.en
> Exception occurred:
> File "conf.py", line 185, in __init__
> start_string_prefix=self.start_string_prefix,
> AttributeError: Inliner instance has no attribute 'start_string_prefix'
> The full traceback has been saved in /tmp/sphinx-err-5iq_t9.log, if you
> want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> A bug report can be filed in the tracker at
> . Thanks!
> Makefile:998: recipe for target 'man' failed
> make[2]: Leaving directory '/home/debocker/source/build/doc'
> make[2]: *** [man] Error 1
> make[1]: *** [all-recursive] Error 1{code}
> I tracked it down to
> [docutils/parsers/rst/states.py|https://fossies.org/diffs/docutils/0.12_vs_0.13.1/docutils/parsers/rst/states.py-diff.html]
> which changed
> between 0.12 & 0.13.1
> {{start_string_prefix}} is not defined anymore at {{Inliner}} init. We have to
> call {{init_cutomizations}} method, but I can't figure out the {{settings}}
> structure.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
