Re: [sphinx-users] Sphinx-3.0.0b1 released.

2020-03-24 Thread Luc Saffre
I ran it on all my doctrees (more than 20), and the only "problems" were
duplicate glossary entries or object definitions, IOW the new version
works perfect for me, and better than 2.4-

Thanks for your work!

Luc

On 22.03.20 17:26, Komiya Takeshi wrote:
> Hi all,
>
> We just released Sphinx-3.0.0b1.
> It has many changes including incompatible ones.
> Please confirm it working fine on your documents.
>
> In detail, please see CHANGES:
> https://github.com/sphinx-doc/sphinx/blob/3.0.x/CHANGES
>
> You can use it with: pip install --pre Sphinx
>
> Since this is a beta release, we expect that you may encounter bugs.
> If you find a bug, please file an issue on Github issues:
> https://github.com/sphinx-doc/sphinx/issues
>
> Thanks,
> Takeshi KOMIYA
>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/b41aa0cf-f9b2-5bc7-40c0-75908d055df6%40gmail.com.


[sphinx-users] Re: How to fix wrong parameter order introduced in 2.4.0

2020-03-24 Thread Pavel Dvořák
I've inspected the issue in a different way. It really does 
@deprecated_args decorator, which adds parameters to the wrong place. Now I 
just have to come up with a way to insert those params into the correct 
place in __signature__.parameters

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/21e56e86-b0cc-4af1-aff8-11ddc1c71b81%40googlegroups.com.


Re: [sphinx-users] How to fix wrong parameter order introduced in 2.4.0

2020-03-24 Thread Jörg Faschingbauer

On 3/24/20 11:40, Pavel Dvořák wrote:

Since 2.4.0 we got warnings like these:
```
08:53:25 WARNING: error while formatting arguments for 
pywikibot.Claim.__init__: wrong parameter order: 
<_ParameterKind.VAR_KEYWORD: 4> before 
<_ParameterKind.POSITIONAL_OR_KEYWORD: 1>

```
But there seems to be nothing wrong with:
```
         @deprecated_args(isReference='is_reference', 
isQualifier='is_qualifier')
         def __init__(self, site, pid, snak=None, hash=None, 
is_reference=False,

      is_qualifier=False, rank='normal', **kwargs):
         """
         Initializer.

         Defined by the "snak" value, supplemented by site + pid

         @param site: repository the claim is on
         @type site: pywikibot.site.DataSite
         @param pid: property id, with "P" prefix
         @param snak: snak identifier for claim
         @param hash: hash identifier for references
         @param is_reference: whether specified claim is a reference
         @param is_qualifier: whether specified claim is a qualifier
         @param rank: rank for claim
         """
```
How to fix these?


I use the Python logger to filter a warning. Example code here, look out 
for the 'setup' function, down at the bottom of the file.


https://github.com/jfasch/jfasch-home/blob/master/conf.py

It might not be a silver bullet, maybe there's a better way for your 
case. I'd have had to patch the Sphinx html builder; so I filter the log 
as a last resort.


Jörg
--
DI Jörg Faschingbauer   
Linux und Open Source - Programmierung, Beratung und Schulung   
https://www.faschingbauer.me
http://www.faschingbauer.co.at  
j...@faschingbauer.co.at
Bergwirtstrasse 10  
A-8075 Hart bei Graz
Tel. +43-664-5783814
UID: ATU64329756

--
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/0c27fb97-9ea6-b18b-f3f0-16c491f17242%40faschingbauer.co.at.


[sphinx-users] Re: How to fix wrong parameter order introduced in 2.4.0

2020-03-24 Thread mohamed Alisaleh
بتاريخ الثلاثاء، 24 مارس، 2020 1:40:11 م UTC+3، كتب Pavel Dvořák:
> Since 2.4.0 we got warnings like these:
> ```
> 
> 08:53:25 WARNING: error while formatting arguments for 
> pywikibot.Claim.__init__: wrong parameter order: <_ParameterKind.VAR_KEYWORD: 
> 4> before <_ParameterKind.POSITIONAL_OR_KEYWORD: 1>
> ```
> But there seems to be nothing wrong with:
> ```
>         @deprecated_args(isReference='is_reference', 
> isQualifier='is_qualifier')
>         def __init__(self, site, pid, snak=None, hash=None, 
> is_reference=False,
>      is_qualifier=False, rank='normal', **kwargs):
>         """
>         Initializer.
>     
>         Defined by the "snak" value, supplemented by site + pid
>     
>         @param site: repository the claim is on
>         @type site: pywikibot.site.DataSite
>         @param pid: property id, with "P" prefix
>         @param snak: snak identifier for claim
>         @param hash: hash identifier for references
>         @param is_reference: whether specified claim is a reference
>         @param is_qualifier: whether specified claim is a qualifier
>         @param rank: rank for claim
>         """
> 
> ```
> How to fix these?

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/bd4d1972-23a5-436e-a69a-9065258eb7f7%40googlegroups.com.


[sphinx-users] Re: How to fix wrong parameter order introduced in 2.4.0

2020-03-24 Thread Pavel Dvořák
Also: Is there a way to print Python variables values during sphinx-build? 
(either into docs or into console) This would help me find out, if there is 
an issue with @deprecated_args decorator

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/009e22eb-238f-417a-b45f-f8c0a75ab3c1%40googlegroups.com.


[sphinx-users] How to fix wrong parameter order introduced in 2.4.0

2020-03-24 Thread Pavel Dvořák
Since 2.4.0 we got warnings like these:
```
08:53:25 WARNING: error while formatting arguments for 
pywikibot.Claim.__init__: wrong parameter order: 
<_ParameterKind.VAR_KEYWORD: 4> before 
<_ParameterKind.POSITIONAL_OR_KEYWORD: 1>
```
But there seems to be nothing wrong with:
```
@deprecated_args(isReference='is_reference', 
isQualifier='is_qualifier')
def __init__(self, site, pid, snak=None, hash=None, 
is_reference=False,
 is_qualifier=False, rank='normal', **kwargs):
"""
Initializer.

Defined by the "snak" value, supplemented by site + pid

@param site: repository the claim is on
@type site: pywikibot.site.DataSite
@param pid: property id, with "P" prefix
@param snak: snak identifier for claim
@param hash: hash identifier for references
@param is_reference: whether specified claim is a reference
@param is_qualifier: whether specified claim is a qualifier
@param rank: rank for claim
"""
```
How to fix these?

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/402a20ba-eb40-4929-aa47-421d151f1727%40googlegroups.com.