§
    _÷#dæ·  ã                   ó8  — d Z ddlZddlZddlmZ ddlmZmZmZmZm	Z	m
Z
mZmZmZmZmZmZ ddlmZ ddlmZmZmZ ddlmZmZ ddlmZ dd	lmZ dd
lmZm Z  ddl!m"Z" ddl#m$Z$m%Z% ddl&m'Z'm(Z( ddl)m*Z*m+Z+ ddl,m-Z-m.Z.m/Z/ ddl0m1Z1 ddl2m3Z3m4Z4m5Z5 ddl6m7Z7m8Z8 erddl9m:Z: ddl;m<Z< ddl=m>Z>  e.j?        e@¦  «        ZAejB        dd…         dk    rddlmCZC neZC ejD        d¦  «        ZE ejD        dejF        ¦  «        ZG e*¦   «         ZH G d„ de"eI         ¦  «        ZJ G d„ deJ¦  «        ZK G d„ d e+¦  «        ZL G d!„ d"e1¦  «        ZM G d#„ d$e"eI         ¦  «        ZN G d%„ d&e1¦  «        ZO G d'„ d(e+¦  «        ZPd)eId*eeeI                  fd+„ZQd,d-d.e	e         d/eId0eId1eRd2eId3ejS        d*ejT        fd4„ZU G d5„ d6e1¦  «        ZVdGd8eId9eId*ee         fd:„ZW G d;„ d<e1¦  «        ZX G d=„ d>e+¦  «        ZY G d?„ d@e$¦  «        ZZdAdBdCe$dDe d*ee[         fdE„Z\dAdBd*eeIef         fdF„Z]dS )HzThe standard domain.é    N)Úcopy)ÚTYPE_CHECKINGÚAnyÚCallableÚDictÚIterableÚIteratorÚListÚOptionalÚTupleÚTypeÚUnionÚcast)Únodes)ÚElementÚNodeÚsystem_message)Ú	DirectiveÚ
directives)Ú
StringList)Úaddnodes)Údesc_signatureÚpending_xref)ÚObjectDescription)ÚDomainÚObjType)Ú_Ú__)ÚEmphasizedLiteralÚXRefRole)Údocname_joinÚloggingÚws_re)ÚSphinxDirective)Úclean_astextÚmake_idÚmake_refnode)Ú
OptionSpecÚRoleFunction)ÚSphinx)ÚBuilder)ÚBuildEnvironmenté   )é   é   )ÚFinalz ((?:/|--|-|\+)?[^\s=]+)(=?\s*.*)z`((~?\w*:)?\w+)`c                   ó‚   — e Zd ZU dZdZeed<   dZedee	gef         ed<   dede	d	efd
„Z
dedede	d	dfd„Zded	efd„ZdS )ÚGenericObjectzM
    A generic x-ref directive registered with Sphinx.add_object_type().
    Ú ÚindextemplateNr,   Ú
parse_nodeÚsigÚsignodeÚreturnc                 óÐ   — | j         r|                       | j        ||¦  «        }nA|                     ¦   «          |t          j        ||¦  «        z  }t          j        d|¦  «        }|S )Nú )r5   ÚenvÚclearr   Ú	desc_namer#   Úsub)Úselfr6   r7   Únames       ú4/usr/lib/python3/dist-packages/sphinx/domains/std.pyÚhandle_signaturezGenericObject.handle_signature4   s_   € ØŒ?ð 	'Ø—?’? 4¤8¨S°'Ñ:Ô:ˆDˆDà�MŠM‰OŒOˆOØ•xÔ)¨#¨sÑ3Ô3Ñ3ˆGå”9˜S #Ñ&Ô&ˆDØˆó    r@   c                 ó¢  — t          | j        | j        j        | j        |¦  «        }|d                              |¦  «         | j        j                             |¦  «         | j        rœ| j                             d¦  «        }|dk    rJ| j        d |…          	                    ¦   «         }| j        |dz   d …          	                    ¦   «         |fz  }nd}| j        |fz  }| j
        d                              |||dd f¦  «         t          t          | j                             d¦  «        ¦  «        }|                     | j        |||¬	¦  «         d S )
NÚidsú:éÿÿÿÿé   ÚsingleÚentriesr3   Ústd©Úlocation)r&   r;   ÚstateÚdocumentÚobjtypeÚappendÚnote_explicit_targetr4   ÚfindÚstripÚ	indexnoder   ÚStandardDomainÚ
get_domainÚnote_object)	r?   r@   r6   r7   Únode_idÚcolonÚ	indextypeÚ
indexentryrK   s	            rA   Úadd_target_and_indexz"GenericObject.add_target_and_index>   s=  € Ý˜$œ( D¤JÔ$7¸¼ÀtÑLÔLˆØ�Œ×Ò˜gÑ&Ô&Ð&ØŒ
Ô×0Ò0°Ñ9Ô9Ð9àÔð 	YØÔ&×+Ò+¨CÑ0Ô0ˆEØ˜Š{ˆ{Ø Ô.¨v°¨vÔ6×<Ò<Ñ>Ô>�	Ø!Ô/°¸±	°
°
Ô;×AÒAÑCÔCÀtÀgÑM�
�
à$�	Ø!Ô/°4°'Ñ9�
ØŒN˜9Ô%×,Ò,¨i¸ÀWÈbÐRVÐ-WÑXÔXÐXå•> 4¤8×#6Ò#6°uÑ#=Ô#=Ñ>Ô>ˆØ�Š˜œ d¨G¸gˆÑFÔFÐFÐFÐFrC   c                 ó   — | j         dz   |z   S )z°Generate old styled node_id for generic objects.

        .. note:: Old Styled node_id was used until Sphinx-3.0.
                  This will be removed in Sphinx-5.0.
        ú-)rP   ©r?   r@   s     rA   Úmake_old_idzGenericObject.make_old_idP   s   € ð Œ|˜cÑ! DÑ(Ð(rC   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r4   ÚstrÚ__annotations__r5   r   r   rB   r]   ra   © rC   rA   r2   r2   -   sØ   € € € € € € ðð ð €M�3ÐÐÑØKO€J�Ð,¨c°>ÐBÀCÐGÔHÐOÐOÑOð Cð °.ð ÀSð ð ð ð ðG¨ð G°3ð GÀð GÐTXð Gð Gð Gð Gð$) ð )¨ð )ð )ð )ð )ð )ð )rC   r2   c                   ó$   — e Zd Z ed¦  «        ZdS )ÚEnvVarúenvironment variable; %sN)rb   rc   rd   r   r4   rh   rC   rA   rj   rj   Y   s   € € € € € Ø�AÐ0Ñ1Ô1€M€M€MrC   rj   c                   ó`   — e Zd ZdZdej        dddededee	e
         e	e         f         f
d„Zd	S )
ÚEnvVarXRefRolezQ
    Cross-referencing role for environment variables (adds an index entry).
    rO   r;   r,   ÚnodeÚis_refr8   c                 ó   — |s|gg fS |d         }d|                      d¦  «        z  }t          j        ¦   «         }d||dd fdt          d¦  «        |z  |dd fg|d<   t	          j        dd|g¬¦  «        }|                     |¦  «         |||gg fS )	NÚ	reftargetzindex-%sÚindexrI   r3   rk   rJ   ©rE   )Únew_serialnor   rr   r   r   ÚtargetrR   )	r?   rO   r;   rn   ro   ÚvarnameÚtgtidrU   Ú
targetnodes	            rA   Úresult_nodeszEnvVarXRefRole.result_nodesb   s»   € àð 	Ø�6˜2�:ÐØ�{Ô#ˆØ˜S×-Ò-¨gÑ6Ô6Ñ6ˆÝ”NÑ$Ô$ˆ	à�w  r¨4Ð0Ø•qÐ3Ñ4Ô4°wÑ>ÀÀrÈ4ÐPð 
ˆ	�)Ñõ ”\ " b¨u¨gÐ6Ñ6Ô6ˆ
Ø×%Ò% jÑ1Ô1Ð1Ø˜: tÐ,¨bÐ0Ð0rC   N)rb   rc   rd   re   r   rO   r   Úboolr   r
   r   r   ry   rh   rC   rA   rm   rm   ]   sn   € € € € € ðð ð1 U¤^ð 1Ð:Lð 1ÐT[ð 1Ø!ð1Ø&+¨D°¬J¸¸^Ô8LÐ,LÔ&Mð1ð 1ð 1ð 1ð 1ð 1rC   rm   c                   ó^   — e Zd ZU dZdZdZdZdZdZi Z	e
ed<   dee         fd	„Zd
edefd„ZdS )ÚTargetz@
    Generic target for user-defined cross-reference types.
    r3   FrH   r   TÚoption_specr8   c                 ór  — t          j        d| j        d                              ¦   «         ¦  «        }t	          | j        | j        j        | j        |¦  «        }t          j
        dd|g¬¦  «        }|                      |¦  «         | j        j                             |¦  «         |g}| j        r”| j        |fz  }d}|                     d¦  «        }|dk    r;|d |…                              ¦   «         }||dz   d …                              ¦   «         }t          j        |||dd fg¬	¦  «        }|                     d|¦  «         | j        }	d| j        v r| j                             dd¦  «        \  }
}	t'          t(          | j                             d
¦  «        ¦  «        }|                     |	|||¬¦  «         |S )Nr:   r   r3   rs   rI   rF   rG   rH   )rJ   rK   rL   )r#   r>   Ú	argumentsrT   r&   r;   rN   rO   r@   r   ru   Úset_source_inforR   r4   rS   r   rr   ÚinsertÚsplitr   rV   rW   rX   )r?   ÚfullnamerY   rn   Úretr\   r[   rZ   Úinoder@   r   rK   s               rA   Úrunz
Target.run~   sŸ  € å”9˜S $¤.°Ô"3×"9Ò"9Ñ";Ô";Ñ<Ô<ˆÝ˜$œ( D¤JÔ$7¸¼ÀHÑMÔMˆÝŒ|˜B ¨¨	Ð2Ñ2Ô2ˆØ×Ò˜TÑ"Ô"Ð"ØŒ
Ô×0Ò0°Ñ6Ô6Ð6Ø˜&ˆØÔð 	!ØÔ+¨x¨kÑ9ˆJØ ˆIØ—O’O CÑ(Ô(ˆEØ˜Š{ˆ{Ø& v¨ vÔ.×4Ò4Ñ6Ô6�	Ø'¨°©	¨
¨
Ô3×9Ò9Ñ;Ô;�
Ý”N¨Y¸
ÀGÈRÐQUÐ,VÐ+WÐXÑXÔXˆEØ�JŠJ�q˜%Ñ Ô Ð ØŒyˆØ�$”)ÐÐØ”i—o’o c¨1Ñ-Ô-‰GˆAˆtå•> 4¤8×#6Ò#6°uÑ#=Ô#=Ñ>Ô>ˆØ�Š˜˜h¨¸$ˆÑ?Ô?Ð?àˆ
rC   r@   c                 ó   — | j         dz   |z   S )z¨Generate old styled node_id for targets.

        .. note:: Old Styled node_id was used until Sphinx-3.0.
                  This will be removed in Sphinx-5.0.
        r_   )r@   r`   s     rA   ra   zTarget.make_old_id˜   s   € ð Œy˜3‰ Ñ%Ð%rC   N)rb   rc   rd   re   r4   Úhas_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespacer}   r(   rg   r
   r   r†   rf   ra   rh   rC   rA   r|   r|   r   s�   € € € € € € ðð ð €Mà€KØÐØÐØ $ÐØ €K�Ð Ð Ñ ð�T˜$”Zð ð ð ð ð4& ð &¨ð &ð &ð &ð &ð &ð &rC   r|   c                   óR   — e Zd ZdZdededefd„Zdedededdfd„Zd	ed
edefd„ZdS )Ú	Cmdoptionz;
    Description of a command-line option (.. option).
    r6   r7   r8   c                 ód  — d}d}|                      d¦  «        D �]‹}|                     ¦   «         }t                               |¦  «        }|s+t                               t          d¦  «        ||¬¦  «         Œ^|                     ¦   «         \  }}|d         dk    r|d         dk    r|d	d…         }d|z   }|rX| j        j	        j
        r/|t          j        d
d
¦  «        z  }|t          j        ¦   «         z  }n|t          j        dd¦  «        z  }|t          j        ||¦  «        z  }| j        j	        j
        �r(d}	|�r|d         dk    r1|d         dk    r%d}	|t          j        dd¦  «        z  }|dd…         }ne|d         dk    r+|t          j        ¦   «         z  }|                     ¦   «         }n.|d         dk    r"|t          j        dd¦  «        z  }|dd	…         }t                                |¦  «        D ]K}
t%          |
t&          j        ¦  «        r*|t'          j        |
                     ¦   «         ¦  «        z  }ŒF||
z  }ŒL|	r|t          j        dd¦  «        z  }n|t          j        ||¦  «        z  }|s	|}|g|d<   n|d                              |¦  «         |dz  }�Œ�|st.          ‚|S )z/Transform an option description into RST nodes.r   r3   z, znMalformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"rL   rG   ú[ú]Nú,FTrH   r:   ú=Úallnames)r‚   rT   Úoption_desc_reÚmatchÚloggerÚwarningr   Úgroupsr;   ÚconfigÚoption_emphasise_placeholdersr   Údesc_sig_punctuationÚdesc_sig_spaceÚdesc_addnamer=   Ú	samp_roleÚparseÚ
isinstancer   ÚTextÚastextrQ   Ú
ValueError)r?   r6   r7   ÚcountÚ	firstnameÚpotential_optionÚmÚoptnameÚargsÚadd_end_bracketÚparts              rA   rB   zCmdoption.handle_signature¦   sæ  € àˆØˆ	Ø #§	¢	¨$¡¤ð 1	ñ 1	ÐØ/×5Ò5Ñ7Ô7ÐÝ×$Ò$Ð%5Ñ6Ô6ˆAØð Ý—’�rð #?ñ  @ô  @àAQØ(/ð ñ 1ô 1ð 1ð ØŸHšH™JœJ‰MˆG�TØ�rŒ{˜cÒ!Ð! d¨2¤h°#¢o oà! # 2 #œ,�Ø˜T‘z�àð AØ”8”?Ô@ð AØ�xÔ<¸SÀ#ÑFÔFÑF�GØ�xÔ6Ñ8Ô8Ñ8�G�Gà�xÔ4°T¸4Ñ@Ô@Ñ@�GØ•xÔ)¨'°7Ñ;Ô;Ñ;ˆGØŒxŒÔ<ñ =Ø"'�Øñ ,Ø˜A”w #’~�~¨$¨r¬(°cª/¨/Ø*.˜Ø¥8Ô#@ÀÀcÑ#JÔ#JÑJ˜Ø# A b Dœz˜˜Ø˜aœ Cš˜Ø¥8Ô#:Ñ#<Ô#<Ñ<˜Ø#Ÿzšz™|œ|˜˜Ø˜aœ Cš˜Ø¥8Ô#@ÀÀcÑ#JÔ#JÑJ˜Ø# A B Bœx˜Ý )§¢°Ñ 5Ô 5ð ,ð ,˜Ý% d­E¬JÑ7Ô7ð ,Ø#¥u¤z°$·+²+±-´-Ñ'@Ô'@Ñ@˜G˜Gà# t™O˜G˜GØ"ð GØ�xÔ<¸SÀ#ÑFÔFÑF�Gøà�8Ô0°°tÑ<Ô<Ñ<�Øð 4Ø#�	Ø'. i�˜
Ñ#Ð#à˜
Ô#×*Ò*¨7Ñ3Ô3Ð3Ø�Q‰JˆE‰EØð 	ÝÐØÐrC   r¥   Nc                 ól  — | j         j                             d¦  «        }|                     dg ¦  «        D ]å}dg}|r|                     |¦  «         |                     d¦  «        s|                     d¦  «         d                     |¦  «        }t          | j         | j        j        ||¦  «        }|d                              |¦  «         |  	                    ||¦  «        }	|	| j        j        j
        vr%|	|d         vr|d                              |	¦  «         Œæ| j        j                             |¦  «         t          t          | j                              d¦  «        ¦  «        }
|                     dg ¦  «        D ]0}|
                     ||| j         j        |d         d	         ¦  «         Œ1|rt#          d
¦  «        |z  }nt#          d¦  «        }|                     dg ¦  «        D ]J}d                     ||g¦  «        }| j        d                              d||d         d	         dd f¦  «         ŒKd S )Nústd:programr“   Ú	cmdoption)r_   ú/Úargr_   rE   rK   r   z%s command line optionzcommand line optionz; rJ   Úpairr3   )r;   Úref_contextÚgetrQ   Ú
startswithÚjoinr&   rN   rO   ra   rE   rR   r   rV   rW   Úadd_program_optionÚdocnamer   rU   )r?   r¥   r6   r7   Úcurrprogramr¨   ÚprefixesÚprefixrY   Úold_node_idÚdomainÚdescrÚoptionÚentrys                 rA   r]   zCmdoption.add_target_and_indexà   sC  € Ø”hÔ*×.Ò.¨}Ñ=Ô=ˆØ—{’{ :¨rÑ2Ô2ð 	3ð 	3ˆGØ#�}ˆHØð -Ø—’ Ñ,Ô,Ð,Ø×%Ò% jÑ1Ô1ð 'Ø—’ Ñ&Ô&Ð&Ø—X’X˜hÑ'Ô'ˆFÝ˜dœh¨¬
Ô(;¸VÀWÑMÔMˆGØ�EŒN×!Ò! 'Ñ*Ô*Ð*à×*Ò*¨6°7Ñ;Ô;ˆKØ $¤*Ô"5Ô"9Ð9Ð9Ø '¨%¤.Ð0Ð0Ø˜”×%Ò% kÑ2Ô2Ð2øàŒ
Ô×0Ò0°Ñ9Ô9Ð9å•n d¤h×&9Ò&9¸%Ñ&@Ô&@ÑAÔAˆØ—{’{ :¨rÑ2Ô2ð 	Kð 	KˆGØ×%Ò% k°7Ø&*¤hÔ&6¸À¼ÀqÔ8IñKô Kð Kð Kð ð 	-ÝÐ.Ñ/Ô/°+Ñ=ˆEˆEåÐ+Ñ,Ô,ˆEØ—k’k *¨bÑ1Ô1ð 	[ð 	[ˆFØ—I’I˜u f˜oÑ.Ô.ˆEØŒN˜9Ô%×,Ò,¨f°e¸WÀU¼^ÈAÔ=NÐPRÐTXÐ-YÑZÔZÐZÐZð	[ð 	[rC   rº   r¨   c                 ó6   — t          j        |dz   |z   ¦  «        S )zªGenerate old styled node_id for cmdoption.

        .. note:: Old Styled node_id was used until Sphinx-3.0.
                  This will be removed in Sphinx-5.0.
        r_   ©r   r&   )r?   rº   r¨   s      rA   ra   zCmdoption.make_old_id  s   € õ Œ}˜V c™\¨GÑ3Ñ4Ô4Ð4rC   )	rb   rc   rd   re   rf   r   rB   r]   ra   rh   rC   rA   r�   r�   ¡   s«   € € € € € ðð ð8 Cð 8°.ð 8ÀSð 8ð 8ð 8ð 8ðt[¨cð [¸ð [Ànð [ÐY]ð [ð [ð [ð [ðB5 #ð 5°ð 5¸ð 5ð 5ð 5ð 5ð 5ð 5rC   r�   c                   óJ   — e Zd ZU dZdZdZdZdZi Ze	e
d<   dee         fd„Zd	S )
ÚProgramzI
    Directive to name the program for which options are documented.
    FrH   r   Tr}   r8   c                 óÖ   — t          j        d| j        d                              ¦   «         ¦  «        }|dk    r!| j        j                             dd ¦  «         n|| j        j        d<   g S )Nr_   r   ÚNoner­   )r#   r>   r   rT   r;   r²   Úpop)r?   Úprograms     rA   r†   zProgram.run  sc   € Ý”)˜C ¤°Ô!2×!8Ò!8Ñ!:Ô!:Ñ;Ô;ˆØ�fÒÐØŒHÔ ×$Ò$ ]°DÑ9Ô9Ð9Ð9à29ˆDŒHÔ  Ñ/Øˆ	rC   N)rb   rc   rd   re   rˆ   r‰   rŠ   r‹   r}   r(   rg   r
   r   r†   rh   rC   rA   rÃ   rÃ   
  sh   € € € € € € ðð ð €KØÐØÐØ $ÐØ €K�Ð Ð Ñ ð�T˜$”Zð ð ð ð ð ð rC   rÃ   c                   ó>   — e Zd Zdddededededeeef         fd„Zd	S )
ÚOptionXRefRoler;   r,   ÚrefnodeÚhas_explicit_titleÚtitleru   r8   c                 óD   — |j                              d¦  «        |d<   ||fS )Nr­   )r²   r³   )r?   r;   rÊ   rË   rÌ   ru   s         rA   Úprocess_linkzOptionXRefRole.process_link  s&   € à!$¤×!4Ò!4°]Ñ!CÔ!Cˆ�ÑØ�fˆ}ÐrC   N©rb   rc   rd   r   rz   rf   r   rÎ   rh   rC   rA   rÉ   rÉ     s_   € € € € € ðÐ 2ð ¸Wð ÐZ^ð ØðØ),ðØ16°s¸C°x´ðð ð ð ð ð rC   rÉ   Úliner8   c                 ó8   — t          j        d| ¦  «        d gz   }|S )Nz +: +)Úrer‚   )rÐ   Úpartss     rA   Úsplit_term_classifiersrÔ   %  s   € å!#¤¨'°4Ñ!8Ô!8¸D¸6Ñ!A€EØ€LrC   r;   r,   Ú	textnodesÚ	index_keyÚsourceÚlinenorY   rO   c                 óH  — t          j        ddg|¢R Ž }||_        ||_        |                     ¦   «         }|r|d                              |¦  «         nBt          | |d|¦  «        }|d                              |¦  «         |                     |¦  «         t          t          |  
                    d¦  «        ¦  «        }	|	                     |||¬¦  «         t          j        ¦   «         }
d||d|fg|
d<   |j        |j        c|
_        |
_        |                     |
¦  «         |S )	Nr3   rE   ÚtermrK   rL   rI   ÚmainrJ   )r   rÚ   r×   rÐ   r¢   rQ   r&   rR   r   rV   rW   Ú
_note_termr   rr   )r;   rÕ   rÖ   r×   rØ   rY   rO   rÚ   ÚtermtextrK   rU   s              rA   Úmake_glossary_termrÞ   +  s   € õ
 Œ:�b˜"Ð)˜yÐ)Ð)Ð)€DØ€D„KØ€D„IØ�{Š{‰}Œ}€Hàð ,àˆUŒ×Ò˜7Ñ#Ô#Ð#Ð#å˜#˜x¨°Ñ:Ô:ˆØˆUŒ×Ò˜7Ñ#Ô#Ð#Ø×%Ò% dÑ+Ô+Ð+å
�~˜sŸ~š~¨eÑ4Ô4Ñ
5Ô
5€CØ‡N‚N�8˜W¨t€NÑ4Ô4Ð4õ ”Ñ Ô €IØ% x°¸&À)ÐLÐM€IˆiÑØ'+¤{°D´IÐ$€IÔ�i”nØ‡K‚K�	ÑÔÐà€KrC   c                   óX   — e Zd ZU dZdZdZdZdZdej	        iZ
eed<   dee         fd„Zd	S )
ÚGlossaryz[
    Directive to create a glossary with cross-reference targets for :term:
    roles.
    Tr   FÚsortedr}   r8   c                 ó  — t          j        ¦   «         }| j        j        |_        d| j        v |d<   g }d}d}d}g }t          | j        | j        j        ¦  «        D �]6\  }\  }}	|s*|r%|r#|d         d                              d||	¦  «         d}Œ5|�rT|d          	                    ¦   «         �s9| 
                    d¦  «        rd}Œkd}|ro|sB|                     | j        j                             t          d	¦  «        ||	¬
¦  «        ¦  «         |                     |||	fgt          ¦   «         f¦  «         d}�nV|rB|                     | j        j                             t          d¦  «        ||	¬
¦  «        ¦  «         |r%|d         d                              |||	f¦  «         në|                     | j        j                             t          d¦  «        ||	¬
¦  «        ¦  «         n¨|rn¥|s3d}t          |¦  «        t          |                     ¦   «         ¦  «        z
  }
|r,|d         d                              ||
d …         ||	¦  «         nB|                     | j        j                             t          d¦  «        ||	¬
¦  «        ¦  «         d}�Œ8g }|D �]3\  }}g }g }|D ]•\  }}}	t#          |¦  «        }| j                             |d         |	¦  «        \  }}t'          | j        ||d         ||	d | j        j        ¬¦  «        }||_        |                     |¦  «         |                     |¦  «         Œ–|                     |¦  «         t/          j        ¦   «         }|r-| j                             ||j        d         d         |¦  «         |                     |¦  «         |                     t/          j        dg|¢R Ž ¦  «         �Œ5t/          j        dg|¢R Ž }|d                              d¦  «         ||z  }||gz   S )Nrá   TFrG   rH   r3   r   z.. z,glossary term must be preceded by empty line)r×   rÐ   z3glossary terms must not be separated by empty linesz4glossary seems to be misformatted, check indentation)rY   rO   ÚclassesÚglossary)r   rä   rN   rO   ÚoptionsÚzipÚcontentÚitemsrQ   Úisspacer´   Úreporterr—   r   r   ÚlenÚlstriprÔ   Úinline_textrÞ   r;   Ú	rawsourceÚextendr   Ú
definitionÚnested_parseÚdefinition_list_itemÚdefinition_list)r?   rn   rJ   Úin_definitionÚ
in_commentÚ	was_emptyÚmessagesrÐ   r×   rØ   Ú
indent_lenrè   Útermsrð   Ú	termnodesÚsystem_messagesrÓ   rÕ   ÚsysmsgrÚ   ÚdefnodeÚdlists                         rA   r†   zGlossary.runW  s¤  € ÝÔ Ñ"Ô"ˆØœ
Ô+ˆŒØ" d¤lÐ2ˆˆX‰ð HJˆØˆØˆ
Øˆ	Ø!ˆÝ&)¨$¬,¸¼Ô8JÑ&KÔ&Kð 1	ñ 1	Ñ"ˆDÑ"�6˜6àð Ø ð > Wð >Ø˜B”K ”N×)Ò)¨"¨f°fÑ=Ô=Ð=Ø �	Øàñ (5˜D œGŸOšOÑ-Ô-ñ (5à—?’? 5Ñ)Ô)ð 'Ø!%�JØà!&�Jð !ð 9Ø$ð 9Ø Ÿš¨¬
Ô(;×(CÒ(CÝÐLÑMÔMØ#)°ð )Dñ )8ô )8ñ 9ô 9ð 9ð —N’N d¨F°FÐ%;Ð$<½j¹l¼lÐ#KÑLÔLÐLØ$)�M‘Mð !ð 9Ø Ÿš¨¬
Ô(;×(CÒ(CÝÐSÑTÔTØ#)°ð )Dñ )8ô )8ñ 9ô 9ð 9ð ð 9Ø œ Aœ×-Ò-¨t°V¸VÐ.DÑEÔEÐEÐEà Ÿš¨¬
Ô(;×(CÒ(CÝÐTÑUÔUØ#)°ð )Dñ )8ô )8ñ 9ô 9ð 9ð 9ð ð 5Øà$ð @à$(�MÝ!$ T¡¤­S°·²±´Ñ-?Ô-?Ñ!?�JØð 5Ø˜B”K ”N×)Ò)¨$¨z¨{¨{Ô*;¸VÀVÑLÔLÐLÐLà—O’O D¤JÔ$7×$?Ò$?ÝÐPÑQÔQØ%¨Fð %@ñ %4ô %4ñ 5ô 5ð 5ð ˆI‰Ið 35ˆØ!(ð 	Eñ 	EÑˆE�:Ø$&ˆIØ*,ˆOØ(-ð 'ð 'Ñ$��f˜fÝ.¨tÑ4Ô4�ð %)¤J×$:Ò$:¸5À¼8ÀVÑ$LÔ$LÑ!�	˜6õ *¨$¬(°I¸uÀQ¼xÈÐQWØ26ÀÄÔATðVñ Vô V�à!%�”Ø×&Ò& vÑ.Ô.Ð.Ø× Ò  Ñ&Ô&Ð&Ð&à×Ò˜_Ñ-Ô-Ð-åÔ&Ñ(Ô(ˆGØð 1Ø”
×'Ò'¨
°JÔ4DÀQÔ4GÈÔ4JØ(/ñ1ô 1ð 1à×Ò˜WÑ%Ô%Ð%Ø�LŠL�Ô3°BÐC¸ÐCÐCÐCÑDÔDÐDÑDåÔ% bÐ1¨5Ð1Ð1Ð1ˆØˆiÔ×Ò 
Ñ+Ô+Ð+Ø�‰ˆØ˜4˜&Ñ Ð rC   N)rb   rc   rd   re   rˆ   r‰   rŠ   r‹   r   Úflagr}   r(   rg   r
   r   r†   rh   rC   rA   rà   rà   I  s~   € € € € € € ðð ð
 €KØÐØÐØ %Ðà�*”/ð€K�ð ð ñ ða!�T˜$”Zð a!ð a!ð a!ð a!ð a!ð a!rC   rà   r3   ÚtextÚproductionGroupc                 ó>  — t          |¦  «        dk    r|dz  }g }d}t                               | ¦  «        D �]"}|                     ¦   «         |k    rC| ||                     ¦   «         …         }|                     t          j        |¦  «        ¦  «         |                     d¦  «        }d|v rM|d         dk    r#|                     d¦  «        \  }}|dd …         }	n%|d         dk    r|dd …         }|}	n|}|}	n|}||z   }	t          |dd|	¬¦  «        }
|
t          j
        ||dg¬	¦  «        z  }
|                     |
¦  «         |                     ¦   «         }�Œ$|t          | ¦  «        k     r/|                     t          j        | |d …         ¦  «        ¦  «         |S )
Nr   rF   rH   ú~ÚtokenrK   )ÚreftypeÚ	refdomainrq   Úxref©rã   )rë   Útoken_reÚfinditerÚstartrQ   r   r¡   Úgroupr‚   r   ÚliteralÚend)r   r  ÚretnodesÚposr§   Útxtr  r   rÌ   ru   rÊ   s              rA   Útoken_xrefsr  »  sŸ  € Ý
ˆ?ÑÔ˜qÒ Ð Ø˜3ÑˆØ€HØ
€CÝ×Ò˜tÑ$Ô$ð ñ ˆØ�7Š7‰9Œ9�sŠ?ˆ?Ø�s˜1Ÿ7š7™9œ9�}Ô%ˆCØ�OŠO�EœJ s™OœOÑ,Ô,Ð,Ø—’˜‘
”
ˆØ�%ˆ<ˆ<Ø�QŒx˜3ŠˆØ Ÿ;š; sÑ+Ô+‘��5Ø˜q˜r˜rœ��Ø�q”˜S’�Ø˜a˜b˜bœ	�Ø��à�Ø��àˆEØ$ uÑ,ˆFÝ˜u¨gÀØ)/ð1ñ 1ô 1ˆà•5”= ¨¸°xÐ@Ñ@Ô@Ñ@ˆØ�Š˜Ñ Ô Ð Ø�eŠe‰gŒgˆ‰Ø
�S�‰YŒY‚€Ø�Š�œ
 4¨¨¨¤:Ñ.Ô.Ñ/Ô/Ð/Ø€OrC   c                   óZ   — e Zd ZU dZdZdZdZdZi Ze	e
d<   dee         fd„Zd	edefd
„ZdS )ÚProductionListz0
    Directive to list grammar productions.
    FrH   r   Tr}   r8   c                 óô  — t          t          | j                             d¦  «        ¦  «        }t	          j        ¦   «         }|                      |¦  «         t          j        d¦  «        }| 	                    d| j
        d         ¦  «                             d¦  «        }d}d}|D �]Q}|sd|vr|                     ¦   «         }Œd}	 |                     dd	¦  «        \  }}	n# t          $ r Y  �n
w xY wt	          j        |¦  «        }
|                     ¦   «         }||
d
<   |
d
         r—d|z  }t          | j        | j        j        ||¦  «        }|
d                              |¦  «         | j        j                             |
|
¦  «         t)          |¦  «        dk    r|›d|›�}n|}|                     d|||¬¦  «         |
                     t/          |	|¦  «        ¦  «         |                     |
¦  «         �ŒS|gS )NrK   z\\\nr3   r   ú
FrF   TrH   Ú	tokennamezgrammar-token-%srE   r  rL   )r   rV   r;   rW   r   Úproductionlistr€   rÒ   Úcompiler>   r   r‚   rT   r£   Ú
productionr&   rN   rO   rQ   Únote_implicit_targetrë   rX   rï   r  )r?   r¼   rn   Únl_escape_reÚlinesr  Úfirst_rule_seenÚruler@   ÚtokensÚsubnoderº   rY   ÚobjNames                 rA   r†   zProductionList.runç  s  € Ý•n d¤h×&9Ò&9¸%Ñ&@Ô&@ÑAÔAˆÝ Ô/Ñ1Ô1ˆØ×Ò˜TÑ"Ô"Ð"å”z 'Ñ*Ô*ˆØ× Ò   T¤^°AÔ%6Ñ7Ô7×=Ò=¸dÑCÔCˆàˆØˆØð 	!ñ 	!ˆDØ"ð  s°$  Ø"&§*¢*¡,¤,�ØØ"ˆOðØ#Ÿzšz¨#¨qÑ1Ô1‘��f�føÝð ð ð Ø�‘ðøøøåÔ)¨$Ñ/Ô/ˆGØ—:’:‘<”<ˆDØ#'ˆG�KÑ Ø�{Ô#ð 
MØ+¨oÑ=�Ý! $¤(¨D¬JÔ,?ÀÈÑNÔN�Ø˜”×%Ò% gÑ.Ô.Ð.Ø”
Ô#×8Ò8¸À'ÑJÔJÐJå�Ñ'Ô'¨1Ò,Ð,Ø)8¨¨¸$¸$Ð?�G�Gà"�GØ×"Ò" 7¨G°WÀtÐ"ÑLÔLÐLØ�NŠN�; v¨Ñ?Ô?Ñ@Ô@Ð@Ø�KŠK˜Ñ Ô Ð Ñ Øˆvˆs   ÃCÃ
C.Ã-C.r  c                 ó0   — t          j        d|z   ¦  «        S )z§Generate old styled node_id for tokens.

        .. note:: Old Styled node_id was used until Sphinx-3.0.
                  This will be removed in Sphinx-5.0.
        zgrammar-token-rÁ   )r?   r  s     rA   ra   zProductionList.make_old_id  s   € õ Œ}Ð-°Ñ5Ñ6Ô6Ð6rC   N)rb   rc   rd   re   rˆ   r‰   rŠ   r‹   r}   r(   rg   r
   r   r†   rf   ra   rh   rC   rA   r  r  Ü  s‹   € € € € € € ðð ð €KØÐØÐØ $ÐØ €K�Ð Ð Ñ ð#�T˜$”Zð #ð #ð #ð #ðJ7 ð 7¨ð 7ð 7ð 7ð 7ð 7ð 7rC   r  c                   ó>   — e Zd Zdddededededeeef         fd„Zd	S )
ÚTokenXRefRoler;   r,   rÊ   rË   rÌ   ru   r8   c                 ó¨   — |                      d¦  «        }| j        s3|d         dk    r'd|v r|                     d¦  «        \  }}n
|dd …         }||fS )Nr  r   rF   rH   )rì   rË   r‚   )r?   r;   rÊ   rË   rÌ   ru   r   s          rA   rÎ   zTokenXRefRole.process_link  sa   € à—’˜sÑ#Ô#ˆØÔ&ð 	"¨5°¬8°sª?¨?Ø�eˆ|ˆ|Ø Ÿ;š; sÑ+Ô+‘��5�5à˜a˜b˜bœ	�Ø�fˆ}ÐrC   NrÏ   rh   rC   rA   r%  r%    s_   € € € € € ðÐ 2ð ¸Wð ÐZ^ð ØðØ),ðØ16°s¸C°x´ðð ð ð ð ð rC   r%  c                   ób  ‡ — e Zd ZU dZdZdZ e ed¦  «        dd¬¦  «         e ed¦  «        d	d¬¦  «         e ed
¦  «        ddd¬¦  «         e ed¦  «        d¦  «         e ed¦  «        d¦  «         e ed¦  «        dd¬¦  «        dœZe	e
ef         ed<   eeeeeedœZe	e
ee         f         ed<    ed¬¦  «         e¦   «          e¦   «          eej        d¬¦  «         edej        d¬¦  «         edd¬¦  «         ed¬¦  «         edej        ¬¦  «        dœZe	e
eeef         f         ed<   i i dd  ed!¦  «        fd"d  ed#¦  «        fd$d  ed%¦  «        fd&œd'd(d)d&œd*œZeed+<   d,d-d.d/d0d1œZej         d2ej!        d3ej"        d4iZ#e	ee$         e%e
e&e'         f         f         ed5<   drˆ fd:„Z(	 dsd;e
d<e
d=e
d>e
d8d9f
d?„Z)e*d8e	e%e
e
f         e%e
e
f         f         fd@„¦   «         Z+dtdAe
d;e
dBe
dCe,d8d9f
dD„Z-e*d8e	e
e%e
e
f         f         fdE„¦   «         Z.dtde
dBe
dCe,d8d9fdF„Z/e*d8e	e%e
e
f         e%e
e
f         f         fdG„¦   «         Z0e*d8e	e
e%e
e
e
f         f         fdH„¦   «         Z1e*d8e	e
e%e
e
f         f         fdI„¦   «         Z2d<e
d8d9fdJ„Z3dKe4e
         dLe	d8d9fdM„Z5d6d7d<e
dej6        d8d9fdN„Z7dOe
d;e
d<e
dBe
d8d9f
dP„Z8dQe
dRdSd<e
dBe
dTe
dUe
dVe,d8e9fdW„Z:d6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fd\„Z<d6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fd]„Z=d6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fd^„Z>d6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fd_„Z?d6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fd`„Z@d6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fda„ZAd6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e9fdb„ZBd6d7dQe
dRdSdXe
dYe
dZe;d[e9d8e&e9         fdc„ZCd6d7dQe
dRdSdYe
dZe;d[e9d8e4e%e
e9f                  fdd„ZDd8eEe%e
e
e
e
e
eFf                  fde„ZGdudgedheHd8e
fdi„ZIdZe$d8eHfdj„ZJdZe$d8e&e
         fdk„ZKdZe$d8e&e
         fdl„ZLd6d7dRdSdme
d<e
dne9d8e%eFdof         fdp„ZMdZe9d8e&e
         fdq„ZNˆ xZOS )vrV   zs
    Domain for all objects that don't fit into another domain or are added
    via the application interface.
    rK   ÚDefaultzglossary termrÚ   rG   )Ú
searchpriozgrammar tokenr  zreference labelÚrefÚkeywordzenvironment variableÚenvvarzprogram optionr¾   rO   Údoc)rÚ   r  Úlabelr,  r®   r-  Úobject_types)rÇ   r®   r¾   r,  rä   r  r   T)Úwarn_dangling)Úinnernodeclassr0  )Ú	lowercaser1  r0  )r2  r0  )r0  r1  )r¾   r,  r  rÚ   r*  Únumrefr+  r-  ÚrolesÚgenindexr3   ÚIndexúpy-modindexzModule IndexÚsearchzSearch Page)r5  Úmodindexr8  )r5  r3   )r7  r3   )r8  r3   )ÚprogoptionsÚobjectsÚlabelsÚ
anonlabelsÚinitial_dataz term not in glossary: %(target)rzundefined label: %(target)rzunknown keyword: %(target)rzunknown document: %(target)rzunknown option: %(target)r)rÚ   r3  r+  r-  r¾   )ÚfigureN)ÚtableN)ú
code-blockNÚenumerable_nodesr;   r,   r8   Nc                 óâ   •— t          ¦   «                              |¦  «         t          | j        ¦  «        | _        |j        j        j                             ¦   «         D ]\  }}|| j        |<   Œd S ©N)ÚsuperÚ__init__r   rB  ÚappÚregistryrè   )r?   r;   rn   ÚsettingsÚ	__class__s       €rA   rF  zStandardDomain.__init__n  sq   ø€ Ý‰Œ×Ò˜ÑÔÐõ !% TÔ%:Ñ ;Ô ;ˆÔØ!œgÔ.Ô?×EÒEÑGÔGð 	3ð 	3‰NˆD�(Ø*2ˆDÔ! $Ñ'Ð'ð	3ð 	3rC   r@   r·   rY   rÌ   c                 ó  — || j         v re| j         |         ||fk    rRt                               t          d¦  «        || j                             | j         |         d         ¦  «        ¦  «         ||f| j         |<   |r|||f| j        |<   dS dS )aU  Add a hyperlink target for cross reference.

        .. warning::

           This is only for internal use.  Please don't use this from your extension.
           ``document.note_explicit_target()`` or ``note_implicit_target()`` are recommended to
           add a hyperlink target to the document.

           This only adds a hyperlink target to the StandardDomain.  And this does not add a
           node_id to node.  Therefore, it is very fragile to calling this without
           understanding hyperlink target framework in both docutils and Sphinx.

        .. versionadded:: 3.0
        ú(duplicate label %s, other instance in %sr   N)r=  r–   r—   r   r;   Údoc2pathr<  )r?   r@   r·   rY   rÌ   s        rA   Únote_hyperlink_targetz$StandardDomain.note_hyperlink_targetv  sª   € ð  �4”?Ð"Ð" t¤°tÔ'<ÀÈ'Ð@RÒ'RÐ'RÝ�NŠN�2ÐHÑIÔIØ ¤×!2Ò!2°4´?À4Ô3HÈÔ3KÑ!LÔ!LñNô Nð Nð ")¨'Ð 2ˆŒ˜ÑØð 	:Ø!(¨'°5Ð 9ˆDŒK˜ÑÐÐð	:ð 	:rC   c                 ó8   — | j                              di ¦  «        S )Nr;  ©ÚdataÚ
setdefault©r?   s    rA   r;  zStandardDomain.objectsŽ  s   € àŒy×#Ò# I¨rÑ2Ô2Ð2rC   rP   ÚlabelidrM   c                 óÎ   — ||f| j         v rA| j         ||f         d         }t                               t          d¦  «        ||||¬¦  «         | j        j        |f| j         ||f<   dS )zRNote a generic object for cross reference.

        .. versionadded:: 3.0
        r   z4duplicate %s description of %s, other instance in %srL   N)r;  r–   r—   r   r;   r·   )r?   rP   r@   rT  rM   r·   s         rA   rX   zStandardDomain.note_object’  s|   € ð �Tˆ?˜dœlÐ*Ð*Ø”l 7¨D =Ô1°!Ô4ˆGÝ�NŠN�2ÐTÑUÔUØ" D¨'¸Hð ñ Fô Fð Fà'+¤xÔ'7¸Ð&AˆŒ�W˜d�]Ñ#Ð#Ð#rC   c                 ó8   — | j                              di ¦  «        S )z2.. note:: Will be removed soon. internal use only.rù   rP  rS  s    rA   Ú_termszStandardDomain._termsž  s   € ð Œy×#Ò# G¨RÑ0Ô0Ð0rC   c                 ó†   — |                       d|||¦  «         | j        j        |f| j        |                     ¦   «         <   dS )zeNote a term for cross reference.

        .. note:: Will be removed soon. internal use only.
        rÚ   N)rX   r;   r·   rW  Úlower)r?   rÚ   rT  rM   s       rA   rÜ   zStandardDomain._note_term£  sB   € ð
 	×Ò˜  w°Ñ9Ô9Ð9à%)¤XÔ%5°wÐ$?ˆŒ�D—J’J‘L”LÑ!Ð!Ð!rC   c                 ó8   — | j                              di ¦  «        S )Nr:  rP  rS  s    rA   r:  zStandardDomain.progoptions¬  s   € àŒy×#Ò# M°2Ñ6Ô6Ð6rC   c                 ó8   — | j                              di ¦  «        S )Nr<  rP  rS  s    rA   r<  zStandardDomain.labels°  s   € àŒy×#Ò# H¨bÑ1Ô1Ð1rC   c                 ó8   — | j                              di ¦  «        S )Nr=  rP  rS  s    rA   r=  zStandardDomain.anonlabels´  s   € àŒy×#Ò# L°"Ñ5Ô5Ð5rC   c                 ón  — d }t          | j                             ¦   «         ¦  «        D ]\  }\  }}||k    r| j        |= Œt          | j                             ¦   «         ¦  «        D ]\  }\  }}||k    r| j        |= Œt          | j                             ¦   «         ¦  «        D ]\  }\  }}||k    r| j        |= Œt          | j                             ¦   «         ¦  «        D ]\  }\  }}}||k    r| j        |= Œt          | j                             ¦   «         ¦  «        D ]\  }\  }}||k    r| j        |= Œd S rD  )Úlistr:  rè   r;  rW  r<  r=  )r?   r·   ÚkeyÚfnÚ_ls        rA   Ú	clear_doczStandardDomain.clear_doc¸  s[  € ØˆÝ! $Ô"2×"8Ò"8Ñ":Ô":Ñ;Ô;ð 	*ð 	*‰MˆC‘�"�bØ�WŠ}ˆ}ØÔ$ SÐ)øÝ! $¤,×"4Ò"4Ñ"6Ô"6Ñ7Ô7ð 	&ð 	&‰MˆC‘�"�bØ�WŠ}ˆ}Ø”L Ð%øÝ! $¤+×"3Ò"3Ñ"5Ô"5Ñ6Ô6ð 	%ð 	%‰MˆC‘�"�bØ�WŠ}ˆ}Ø”K Ð$øÝ!% d¤k×&7Ò&7Ñ&9Ô&9Ñ!:Ô!:ð 	%ð 	%ÑˆC‘�"�b˜"Ø�WŠ}ˆ}Ø”K Ð$øÝ! $¤/×"7Ò"7Ñ"9Ô"9Ñ:Ô:ð 	)ð 	)‰MˆC‘�"�bØ�WŠ}ˆ}Ø”O CÐ(øð	)ð 	)rC   ÚdocnamesÚ	otherdatac                 ó  — |d                               ¦   «         D ]\  }}|d         |v r
|| j        |<   Œ|d                               ¦   «         D ]\  }}|d         |v r
|| j        |<   Œ|d                               ¦   «         D ]\  }}|d         |v r
|| j        |<   Œ|d                               ¦   «         D ]\  }}|d         |v r
|| j        |<   Œ|d                               ¦   «         D ]\  }}|d         |v r
|| j        |<   Œd S )Nr:  r   r;  rù   r<  r=  )rè   r:  r;  rW  r<  r=  )r?   rc  rd  r_  rQ  s        rA   Úmerge_domaindatazStandardDomain.merge_domaindataÊ  sM  € à" =Ô1×7Ò7Ñ9Ô9ð 	-ð 	-‰IˆC�Ø�AŒw˜(Ð"Ð"Ø(,�Ô  Ñ%øØ" 9Ô-×3Ò3Ñ5Ô5ð 	)ð 	)‰IˆC�Ø�AŒw˜(Ð"Ð"Ø$(�”˜SÑ!øØ" 7Ô+×1Ò1Ñ3Ô3ð 	(ð 	(‰IˆC�Ø�AŒw˜(Ð"Ð"Ø#'�”˜CÑ øØ" 8Ô,×2Ò2Ñ4Ô4ð 	(ð 	(‰IˆC�Ø�AŒw˜(Ð"Ð"Ø#'�”˜CÑ øØ" <Ô0×6Ò6Ñ8Ô8ð 	,ð 	,‰IˆC�Ø�AŒw˜(Ð"Ð"Ø'+�” Ñ$øð	,ð 	,rC   c           	      óÄ  — |j                              ¦   «         D �]Ä\  }}|sŒ	|j        |         }|€Œ|j        |         }t	          |t
          j        ¦  «        r2d|v r.|j                             |d         ¦  «        }|d         d         }|j        dk    sd|v s|j         	                    d¦  «        rŒœ|| j
        v rOt                               t          d¦  «        ||                     | j
        |         d         ¦  «        |¬¦  «         ||f| j        |<   |j        d	k    r1t!          t
          j        |d         ¦  «        }t%          |¦  «        }	�n{|j        d
k    rt%          |¦  «        }	�n_|                      |¦  «        r|                      |¦  «        }	|	s�Œ†�n/t	          |t
          j        t
          j        f¦  «        r,|j        r%t!          t
          j        |j        d         ¦  «        }t	          |t
          j        t
          j        f¦  «        r%t!          t
          j        |j        d         ¦  «        }t	          |t
          j        t
          j        f¦  «        rt%          |¦  «        }	n\t;          |                     t>          j         ¦  «        d ¦  «        }
|
r+|
                     d¦  «        r|
                     d¦  «        }	n�Œ·|||	f| j
        |<   �ŒÆd S )NÚrefidÚnamesr   ÚfootnoteÚrefuriÚdesc_rL  rL   ÚsectionÚrubricÚcaption)!Ú	nametypesrè   ÚnameidsrE   r    r   ru   r³   Útagnamer´   r<  r–   r—   r   rM  r=  r   rÌ   r%   Úis_enumerable_nodeÚget_numfig_titleró   Ú
field_listÚchildrenr   Úfieldrò   rÚ   Ú
field_nameÚnextÚfindallr   Útoctree)r?   r;   r·   rO   r@   ÚexplicitrT  rn   rÌ   Úsectnamer{  s              rA   Úprocess_doczStandardDomain.process_docÜ  sÒ  € Ø&Ô0×6Ò6Ñ8Ô8ð /	;ñ /	;‰NˆD�(Øð ØØÔ& tÔ,ˆGØˆØØ”< Ô(ˆDÝ˜$¥¤Ñ-Ô-ð +°'¸T°/°/à”|×'Ò'¨¨W¬Ñ6Ô6�Ø˜wœ-¨Ô*�Ø” 
Ò*Ð*Ø Ð$Ð$Ø”L×+Ò+¨GÑ4Ô4ð %ð Ø�t”{Ð"Ð"Ý—’�rÐ"LÑMÔMØ# S§\¢\°$´+¸dÔ2CÀAÔ2FÑ%GÔ%GØ(,ð ñ .ô .ð .ð %,¨WÐ$4ˆDŒO˜DÑ!ØŒ|˜yÒ(Ð(Ý�Uœ[¨$¨q¬'Ñ2Ô2�Ý'¨Ñ.Ô.�‘Ø” Ò)Ð)Ý'¨Ñ-Ô-�‘Ø×(Ò(¨Ñ.Ô.ð !Ø×0Ò0°Ñ6Ô6�Øð Ùñõ ˜t¥eÔ&;Ý&+Ô&6ð&8ñ 9ô 9ð AàœðAõ  ¥¤¨t¬}¸QÔ/?Ñ@Ô@�DÝ˜d¥U¤[µ%Ô2LÐ$MÑNÔNð AÝ¥¤¨t¬}¸QÔ/?Ñ@Ô@�DÝ˜d¥U¤ZµÔ1AÐ$BÑCÔCð !Ý+¨DÑ1Ô1�H�Hå" 4§<¢<µÔ0@Ñ#AÔ#AÀ4ÑHÔH�GØð ! 7§;¢;¨yÑ#9Ô#9ð !Ø#*§;¢;¨yÑ#9Ô#9˜˜ñ !Ø '¨°(Ð :ˆDŒK˜ÑÑð_/	;ð /	;rC   rÇ   c                 ó<   — ||f| j         vr||f| j         ||f<   d S d S rD  )r:  )r?   rÇ   r@   r·   rT  s        rA   r¶   z!StandardDomain.add_program_option  s8   € à�Tˆ? $Ô"2Ð2Ð2Ø/6¸Ð.@ˆDÔ˜W d˜]Ñ+Ð+Ð+ð 3Ð2rC   ÚfromdocnameÚbuilderr+   r}  Úrolenamerå   c                 óð  — |                      dt          j        ¦  «        } |dddi|¤Ž}	t          j        ||¦  «        }
|
                     d¦  «        �9|
d                              d¦  «         |
d                              d|z   ¦  «         ||k    r||	d<   nGt          d¦  «        }||d	<   ||d
<   |                     ||¦  «        |	d<   |r|	dxx         d|z   z  cc<   |	                     |
¦  «         |	S )NÚ	nodeclassr3   ÚinternalTrã   rK   zstd-rh  Ú
refdocnameÚrefsectnamerk  ú#©r3   r3   )rÆ   r   Ú	referenceÚinliner³   rQ   r   Úget_relative_uri)r?   r€  r�  r·   rT  r}  r‚  rå   r„  ÚnewnodeÚ	innernodeÚcontnodes               rA   Úbuild_reference_nodez#StandardDomain.build_reference_node  s&  € ð —K’K ­U¬_Ñ=Ô=ˆ	Ø�)Ð=Ð=¨TÐ=°WÐ=Ð=ˆÝ”L ¨8Ñ4Ô4ˆ	Ø�=Š=˜Ñ#Ô#Ð/Ø�iÔ ×'Ò'¨Ñ.Ô.Ð.Ø�iÔ ×'Ò'¨°Ñ(9Ñ:Ô:Ð:Ø�kÒ!Ð!Ø&ˆG�GÑÐõ
 $ BÑ'Ô'ˆHØ%,ˆH�\Ñ"Ø&.ˆH�]Ñ#Ø '× 8Ò 8Ø˜Wñ!&ô !&ˆG�HÑàð 3Ø˜Ð!Ð!Ô! S¨7¡]Ñ2Ð!Ð!Ñ!Ø�Š�yÑ!Ô!Ð!ØˆrC   Útypru   rn   r�  c           	      óÚ   — |dk    r| j         }nM|dk    r| j        }n?|dk    r| j        }n1|dk    r| j        }n#|dk    r| j        }n|dk    r| j        }n| j        } ||||||||¦  «        S )Nr*  r3  r+  r-  r¾   rÚ   )Ú_resolve_ref_xrefÚ_resolve_numref_xrefÚ_resolve_keyword_xrefÚ_resolve_doc_xrefÚ_resolve_option_xrefÚ_resolve_term_xrefÚ_resolve_obj_xref)	r?   r;   r€  r�  r‘  ru   rn   r�  Úresolvers	            rA   Úresolve_xrefzStandardDomain.resolve_xref,  sœ   € ð �%Š<ˆ<ØÔ-ˆHˆHØ�HŠ_ˆ_ØÔ0ˆHˆHØ�IÒÐØÔ1ˆHˆHØ�EŠ\ˆ\ØÔ-ˆHˆHØ�HŠ_ˆ_ØÔ0ˆHˆHØ�FŠ]ˆ]ØÔ.ˆHˆHàÔ-ˆHàˆx˜˜[¨'°3¸ÀÀhÑOÔOÐOrC   c                 óò   — |d         r3| j                              |d¦  «        \  }}	|                     ¦   «         }
n| j                             |d¦  «        \  }}	}
|sd S |                      ||||	|
d¦  «        S )NÚrefexplicitr‰  ©r3   r3   r3   r*  )r=  r³   r¢   r<  r�  )r?   r;   r€  r�  r‘  ru   rn   r�  r·   rT  r}  s              rA   r“  z StandardDomain._resolve_ref_xref@  s’   € ð �Ôð 	Oð  $œ×2Ò2°6¸8ÑDÔDÑˆG�WØ—{’{‘}”}ˆHˆHð *.¬¯ª¸ÀÑ)NÔ)NÑ&ˆG�W˜hØð 	Ø�4à×(Ò(¨°gØ)0°'¸8ÀUñLô Lð 	LrC   c           
      óN  — || j         v r | j                              |d¦  «        \  }}	}
n | j                             |d¦  «        \  }}	d }
|sd S |                     |¦  «        j                             |	¦  «        }|                      |¦  «        }|€d S |dk    r9|j        j        du r+t           	                    t          d¦  «        |¬¦  «         |S 	 |                      |||||¦  «        }|€|S n<# t          $ r/ t           	                    t          d¦  «        |	|¬¦  «         |cY S w xY w	 |d         r|                     ¦   «         }n |j        j                             |d	¦  «        }|
€0d
|v r,t           	                    t          d¦  «        ||¬¦  «         |S d                     t!          t"          |¦  «        ¦  «        }d
|v sd|v r1|
r|                     |
|¬¦  «        }n|                     |¬¦  «        }n||z  }n{# t&          $ r7}t           	                    t          d¦  «        |||¬¦  «         |cY d }~S d }~wt(          $ r/ t           	                    t          d¦  «        ||¬¦  «         |cY S w xY w|                      ||||	|dt,          j        |¬¦  «        S )Nrž  r‰  rm  Fz(numfig is disabled. :numref: is ignored.rL   zBFailed to create a cross reference. Any number is not assigned: %sr�  r3   z{name}zthe link has no caption: %sú.Únumber)r@   r¡  )r¡  zinvalid numfig_format: %s (%r)zinvalid numfig_format: %sr3  )r„  rÌ   )r<  r³   r=  Úget_doctreerE   Úget_enumerable_node_typer™   Únumfigr–   r—   r   Úget_fignumberr£   r¢   Únumfig_formatrµ   Úmaprf   ÚformatÚKeyErrorÚ	TypeErrorr�  r   Únumber_reference)r?   r;   r€  r�  r‘  ru   rn   r�  r·   rT  ÚfignameÚtarget_nodeÚfigtypeÚ	fignumberrÌ   ÚfignumÚnewtitleÚexcs                     rA   r”  z#StandardDomain._resolve_numref_xrefR  s	  € ð �T”[Ð Ð Ø(,¬¯ª¸ÀÑ(MÔ(MÑ%ˆG�W˜g˜gà#œ×2Ò2°6¸8ÑDÔDÑˆG�WØˆGàð 	Ø�4à—o’o gÑ.Ô.Ô2×6Ò6°wÑ?Ô?ˆØ×/Ò/°Ñ<Ô<ˆØˆ?Ø�4à�iÒÐ C¤JÔ$5¸Ð$>Ð$>Ý�NŠN�2ÐHÑIÔIÐTXˆNÑYÔYÐYØˆOð	Ø×*Ò*¨3°¸À'È;ÑWÔWˆIØÐ Ø�ð !øåð 	ð 	ð 	Ý�NŠN�2ð -ñ .ô .à"¨Tð ñ 3ô 3ð 3ð ˆOˆOˆOð		øøøð	Ø�MÔ"ð BØ ŸšÑ)Ô)��àœ
Ô0×4Ò4°W¸bÑAÔA�àˆ 8¨uÐ#4Ð#4Ý—’�rÐ"?Ñ@Ô@À%ÐRV�ÑWÔWÐWØ�àŸš¥#¥c¨9Ñ"5Ô"5Ñ6Ô6�Ø˜uÐ$Ð$¨°EÐ(9Ð(9àð ?Ø#(§<¢<°WÀV <Ñ#LÔ#L˜˜à#(§<¢<°v <Ñ#>Ô#>˜˜ð  % v™~�HøøÝð 	ð 	ð 	Ý�NŠN�2Ð>Ñ?Ô?ÀÈÐVZˆNÑ[Ô[Ð[ØˆOˆOˆOˆOˆOˆOøøøøÝð 	ð 	ð 	Ý�NŠN�2Ð9Ñ:Ô:¸EÈDˆNÑQÔQÐQØˆOˆOˆOð	øøøð ×(Ò(¨°gØ)0°'¸8ÀXÝ3;Ô3LØ/4ð )ñ 6ô 6ð 	6s>   ÃC2 Ã26D+Ä*D+Ä/A.H ÆA&H È
I=È,IÈ;I=É9I=É<I=c                 ón   — | j                              |d¦  «        \  }}	}
|sd S t          ||||	|¦  «        S )Nrž  )r<  r³   r'   )r?   r;   r€  r�  r‘  ru   rn   r�  r·   rT  r   s              rA   r•  z$StandardDomain._resolve_keyword_xref‘  sJ   € ð #œkŸošo¨f°lÑCÔCÑˆ�˜!Øð 	Ø�4Ý˜G [°'Ø# Xñ/ô /ð 	/rC   c                 ó4  — |                      d|¦  «        }t          ||d         ¦  «        }	|	|j        vrd S |d         r|                     ¦   «         }
nt	          |j        |	         ¦  «        }
t          j        |
|
dg¬¦  «        }t          |||	d |¦  «        S )NÚrefdocrq   r�  r-  r  )	r³   r!   Úall_docsr¢   r%   Útitlesr   r‹  r'   )r?   r;   r€  r�  r‘  ru   rn   r�  rµ  r·   ro  rŽ  s               rA   r–  z StandardDomain._resolve_doc_xref›  s›   € ð —’˜( KÑ0Ô0ˆÝ˜v t¨KÔ'8Ñ9Ô9ˆØ˜#œ,Ð&Ð&Ø�4à�MÔ"ð <àŸ+š+™-œ-��å& s¤z°'Ô':Ñ;Ô;�Ýœ W¨gÀ¸wÐGÑGÔGˆIÝ ¨°g¸tÀYÑOÔOÐOrC   c                 óp  — |                      d¦  «        }|                     ¦   «         }| j                              ||fd¦  «        \  }	}
|	sFdD ]C}||v r=|                     |¦  «        \  }}}| j                              ||fd¦  «        \  }	}
|	r nŒD|	s‘g }t	          j        |¦  «        ryt	          j        |d¦  «        \  }}|                     |¦  «         d                     |¦  «        }| j                              ||fd¦  «        \  }	}
|	rnt	          j        |¦  «        °yd S t          |||	|
|¦  «        S )Nr­   r‰  >   ú[=r:   r’   rH   r_   )
r³   rT   r:  Ú	partitionr#   r8  r‚   rQ   rµ   r'   )r?   r;   r€  r�  r‘  ru   rn   r�  Úprognamer·   rT  ÚneedleÚstemr   ÚcommandsÚ
subcommands                   rA   r—  z#StandardDomain._resolve_option_xref¬  sn  € ð —8’8˜MÑ*Ô*ˆØ—’‘”ˆØÔ+×/Ò/°¸6Ð0BÀHÑMÔMÑˆ�Øð 
	ð
 +ð ð �Ø˜VÐ#Ð#Ø!'×!1Ò!1°&Ñ!9Ô!9‘J�D˜!˜QØ'+Ô'7×';Ò';¸XÀtÐ<LÈhÑ'WÔ'WÑ$�G˜WØð Ø˜øØð 	ØˆHÝ”,˜vÑ&Ô&ð 	Ý%*¤[°¸Ñ%;Ô%;Ñ"�
˜FØ—’ 
Ñ+Ô+Ð+ØŸ8š8 HÑ-Ô-�à#'Ô#3×#7Ò#7¸À6Ð8JÈHÑ#UÔ#UÑ �˜Øð Øõ ”,˜vÑ&Ô&ð 	ð �tå˜G [°'Ø# Xñ/ô /ð 	/rC   c           	      óä   — |                       |||||||¦  «        }|r|S |                     ¦   «         | j        v r5| j        |                     ¦   «                  \  }	}
t          |||	|
|¦  «        S d S rD  )r™  rY  rW  r'   )r?   r;   r€  r�  r‘  ru   rn   r�  Úresultr·   rT  s              rA   r˜  z!StandardDomain._resolve_term_xrefÍ  s‚   € ð ×'Ò'¨¨[¸'À3Ø(.°°hñ@ô @ˆàð 	ØˆMð �|Š|‰~Œ~ ¤Ð,Ð,Ø#'¤;¨v¯|ª|©~¬~Ô#>Ñ �˜Ý# G¨[¸'À7ÈHÑUÔUÐUà�trC   c                 ó°   — |                       |¦  «        pg }|D ]!}	|	|f| j        v r| j        |	|f         \  }
} nŒ"d\  }
}|
sd S t          |||
||¦  «        S )Nr‰  )Úobjtypes_for_roler;  r'   )r?   r;   r€  r�  r‘  ru   rn   r�  ÚobjtypesrP   r·   rT  s               rA   r™  z StandardDomain._resolve_obj_xrefÜ  s’   € ð ×)Ò)¨#Ñ.Ô.Ð4°"ˆØð 	&ð 	&ˆGØ˜Ð  D¤LÐ0Ð0Ø#'¤<°¸°Ô#@Ñ �˜Ø�ð 1ð  &ÑˆG�WØð 	Ø�4Ý˜G [°'Ø# Xñ/ô /ð 	/rC   c                 ó˜  — g }|                      ¦   «         }dD ]A}	|                      ||||	|	dk    r|n|||¦  «        }
|
r|                     d|	z   |
f¦  «         ŒB| j        D ]g}||f}|dk    r||f}|| j        v rN| j        |         \  }}|                     d|                      |¦  «        z   t          |||||¦  «        f¦  «         Œh|S )N)r*  r¾   r*  zstd:rÚ   )rY  r›  rQ   r/  r;  Úrole_for_objtyper'   )r?   r;   r€  r�  ru   rn   r�  ÚresultsÚltargetÚroleÚresrP   r_  r·   rT  s                  rA   Úresolve_any_xrefzStandardDomain.resolve_any_xrefë  s#  € ð .0ˆØ—,’,‘.”.ˆØ%ð 	5ð 	5ˆDØ×#Ò# C¨°g¸tØ/3°uª}¨} G GÀ&Ø$(¨(ñ4ô 4ˆCð ð 5Ø—’ ¨¡¨sÐ3Ñ4Ô4Ð4øàÔ(ð 	Bð 	BˆGØ˜FÐ#ˆCØ˜&Ò Ð Ø Ð(�Ø�d”lÐ"Ð"Ø#'¤<°Ô#4Ñ �˜Ø—’ ¨×)>Ò)>¸wÑ)GÔ)GÑ GÝ ,¨W°kÀ7Ø-4°hñ!@ô !@ð Añ Bô Bð Bøð ˆrC   c              #   óÄ  K  — | j         j        D ])}|t          | j         j        |         ¦  «        d|ddfV — Œ*| j                             ¦   «         D ]N\  \  }}}|r.d                     ||g¦  «        }||d|d         |d         dfV — Œ8||d|d         |d         dfV — ŒO| j                             ¦   «         D ]4\  \  }}}||||d         |d         | j        |         j	        d         fV — Œ5| j
                             ¦   «         D ]\  }\  }}	}
||
d	||	dfV — Œt          | j
        ¦  «        }| j                             ¦   «         D ]\  }\  }}	||vr
||d	||	dfV — Œd S )
Nr-  r3   rG   r   r®   r   rH   r)  r.  )r;   r¶  r%   r·  r:  rè   rµ   r;  r/  Úattrsr<  Úsetr=  )r?   r-  Úprogr¾   Úinforƒ   Útyper@   r·   rT  ÚsectionnameÚnon_anon_labelss               rA   Úget_objectszStandardDomain.get_objects  sô  è è € à”8Ô$ð 	Pð 	PˆCØ� T¤X¤_°SÔ%9Ñ:Ô:¸EÀ3ÈÈBÐOÐOÐOÐOÐOØ$(Ô$4×$:Ò$:Ñ$<Ô$<ð 	Ið 	IÑ ‰NˆT�6˜DØð IØŸ8š8 T¨6 NÑ3Ô3�Ø ¨;¸¸Q¼ÀÀaÄÈ!ÐLÐLÐLÐLÐLà˜v {°D¸´G¸TÀ!¼WÀaÐHÐHÐHÐHÐHØ"&¤,×"4Ò"4Ñ"6Ô"6ð 	@ð 	@Ñ‰LˆT�4˜$Ø˜˜t T¨!¤W¨d°1¬gØÔ$ TÔ*Ô0°Ô>ð@ð @ð @ð @ð @à59´[×5FÒ5FÑ5HÔ5Hð 	Eð 	EÑ1ˆDÑ1�7˜G [Ø˜ g¨w¸ÀÐDÐDÐDÐDÐDå˜dœkÑ*Ô*ˆØ(,¬×(=Ò(=Ñ(?Ô(?ð 	Bð 	BÑ$ˆDÑ$�7˜GØ˜?Ð*Ð*Ø˜T 7¨G°W¸bÐAÐAÐAÐAøð	Bð 	BrC   FrÑ  Úprimaryc                 ó   — |j         S rD  )Úlname)r?   rÑ  rÕ  s      rA   Úget_type_namezStandardDomain.get_type_name  s
   € àŒzÐrC   c                 ó   — |j         | j        v S rD  )rJ  rB  )r?   rn   s     rA   rs  z!StandardDomain.is_enumerable_node  s   € ØŒ~ Ô!6Ð6Ð6rC   c                 ó2  — |                       |¦  «        r�t          t          |¦  «        }| j                             |j        d¦  «        \  }}|r ||¦  «        S |D ]9}t          |t          j        t          j	        f¦  «        rt          |¦  «        c S Œ:dS )z?Get the title of enumerable nodes to refer them using its title©NNN)rs  r   r   rB  r³   rJ  r    r   ro  rÌ   r%   )r?   rn   Úelemr   Útitle_getterr!  s         rA   rt  zStandardDomain.get_numfig_title  s§   € à×"Ò" 4Ñ(Ô(ð 	5Ý� Ñ&Ô&ˆDØ"Ô3×7Ò7¸¼ÈÑUÔU‰OˆAˆ|Øð 5Ø#�| DÑ)Ô)Ð)à#ð 5ð 5�GÝ! '­E¬M½5¼;Ð+GÑHÔHð 5Ý+¨GÑ4Ô4Ð4Ð4Ð4ð5ð ˆtrC   c                 ó"  — dt           dt          dt          fd„}t          |t          j        ¦  «        rdS t          |t          j        ¦  «        rd|v r ||t          j        ¦  «        rdS | j         	                    |j
        d¦  «        \  }}|S )	zGet type of enumerable nodes.rn   Úclsr8   c                 ó:   ‡— t          ˆfd„| D ¦   «         ¦  «        S )Nc              3   ó8   •K  — | ]}t          |‰¦  «        V — Œd S rD  )r    )Ú.0Úchildrß  s     €rA   ú	<genexpr>zMStandardDomain.get_enumerable_node_type.<locals>.has_child.<locals>.<genexpr>/  s-   øè è € Ð@Ð@°%•z %¨Ñ-Ô-Ð@Ð@Ð@Ð@Ð@Ð@rC   )Úany)rn   rß  s    `rA   Ú	has_childz:StandardDomain.get_enumerable_node_type.<locals>.has_child.  s&   ø€ ÝÐ@Ð@Ð@Ð@¸4Ð@Ñ@Ô@Ñ@Ô@Ð@rC   rm  Úliteral_blockrA  rÛ  )r   r   rz   r    r   rm  Ú	containerrç  rB  r³   rJ  )r?   rn   ræ  r®  r   s        rA   r£  z'StandardDomain.get_enumerable_node_type,  s­   € ð	A�Gð 	A­$ð 	Aµ4ð 	Að 	Að 	Að 	Aõ �d�EœMÑ*Ô*ð 		Ø�9Ý˜�uœÑ/Ô/ð 	Ø Ð%Ð%Øˆi˜�eÔ1Ñ2Ô2ð &ð  �<àÔ.×2Ò2°4´>À<ÑPÔP‰JˆG�QØˆNrC   r®  r­  .c                 óš  — |dk    r}|j         dk    rdS ||j        vrt          ‚d|d         d         z   }||j        |         vr |j        |                              d¦  «        S |j        |                              |¦  «        S 	 |d         d         }|j        |         |         |         S # t
          t          f$ r}t          |‚d }~ww xY w)Nrm  Úlatexrh   rˆ  rE   r   r3   )r@   Útoc_secnumbersr£   r³   Útoc_fignumbersr©  Ú
IndexError)	r?   r;   r�  r®  r·   r­  Ú
anchornameÚ	figure_idr²  s	            rA   r¥  zStandardDomain.get_fignumber<  sì   € à�iÒÐØŒ|˜wÒ&Ð&Ø�rØ Ô 2Ð2Ð2Ý Ð à  ;¨uÔ#5°aÔ#8Ñ8�
Ø SÔ%7¸Ô%@Ð@Ð@àÔ-¨gÔ6×:Ò:¸2Ñ>Ô>Ð>àÔ-¨gÔ6×:Ò:¸:ÑFÔFÐFð*Ø'¨Ô.¨qÔ1�	ØÔ)¨'Ô2°7Ô;¸IÔFÐFøÝ�jÐ)ð *ð *ð *õ ! cÐ)øøøøð*øøøs   Â&B, Â,C
Â=CÃC
c                 ód  — |                      d¦  «        dk    r–|                      d¦  «        }t          j        |                      d¦  «        ¦  «        }|r|                     d|¦  «         |                     ¦   «         }|r*d                     d                     |¦  «        |g¦  «        S d S d S )Nr  r¾   r­   rq   r   r   r_   )r³   r#   r‚   r�   rÆ   rµ   )r?   rn   r»  Úcommandr¾   s        rA   Úget_full_qualified_namez&StandardDomain.get_full_qualified_nameS  s£   € Ø�8Š8�IÑÔ (Ò*Ð*Ø—x’x Ñ.Ô.ˆHÝ”k $§(¢(¨;Ñ"7Ô"7Ñ8Ô8ˆGØð ,Ø—’˜q (Ñ+Ô+Ð+Ø—[’[‘]”]ˆFØð Ø—x’x §¢¨'Ñ!2Ô!2°FÐ ;Ñ<Ô<Ð<à�tà�4rC   )r;   r,   r8   N©r3   rD  )F)Prb   rc   rd   re   r@   r.  r   r   r/  r   rf   rg   rÃ   r�   rj   rà   r  r   r   r   rÉ   rm   r%  r    r   r‹  r4  r   r)   r>  r0   Údangling_warningsr?  r@  rè  rB  r   r   r   r   rF  rN  Úpropertyr;  r   rX   rW  rÜ   r:  r<  r=  rb  r
   rf  rO   r~  r¶   r   r�  r   r›  r“  r”  r•  r–  r—  r˜  r™  rË  r	   ÚintrÔ  rz   rØ  rs  rt  r£  r¥  rò  Ú__classcell__)rJ  s   @rA   rV   rV   !  sÁ
  ø€ € € € € € ðð ð
 €DØ€Eð �˜˜˜/Ñ*Ô*¨F¸rÐBÑBÔBØ�˜˜˜?Ñ+Ô+¨WÀÐDÑDÔDØ�˜˜Ð,Ñ-Ô-¨u°iØ$&ð(ñ (ô (à�'˜!˜!Ð2Ñ3Ô3°XÑ>Ô>Ø�W˜Q˜QÐ/Ñ0Ô0°(Ñ;Ô;Øˆw�q�q˜‘}”} e¸Ð;Ñ;Ô;ð(ð (€L�$�s˜G�|Ô$ð ð ñ ð ØØØØØ(ð.ð .€J��S˜$˜yœ/Ð)Ô*ð ð ñ ð "�>°Ð5Ñ5Ô5Ø!�>Ñ#Ô#à �=‘?”?à�8¨5¬<Ø*.ð0ñ 0ô 0ð �8 d¸5¼<Ø*.ð0ñ 0ô 0ð �8 dØ*.ð0ñ 0ô 0ð �8¨$Ð/Ñ/Ô/à�8¨$¸u¼|ÐLÑLÔLð#7ð 7€Eˆ4��U˜<¨Ð1Ô2Ð2Ô3ð ð ñ ð* Øà# R¨¨¨7©¬Ð4Ø&¨¨A¨A¨nÑ,=Ô,=Ð>Ø! 2 q q¨Ñ'7Ô'7Ð8ð
ð 
ð )Ø+Ø&ð
ð 
ðð €L�%ð ð ñ ð  3Ø0Ø0Ø-Ø.ðð Ðð 	ŒÐ&ØŒ�_ØŒÐ-ðJÐ�d˜4 œ: u¨S°(¸8Ô2DÐ-DÔ'EÐEÔFð ð ñ ð3ð 3ð 3ð 3ð 3ð 3ð ,.ð:ð :¨#ð :¸ð :Àcð :Ø%(ð:Ø26ð:ð :ð :ð :ð0 ð3˜˜e C¨ Hœo¨u°S¸#°X¬Ð>Ô?ð 3ð 3ð 3ñ „Xð3ð
Bð 
B 3ð 
B¨cð 
B¸Cð 
BÈ3ð 
BØð
Bð 
Bð 
Bð 
Bð ð1˜˜S %¨¨S¨¤/Ð1Ô2ð 1ð 1ð 1ñ „Xð1ð@ð @˜sð @¨Sð @¸Cð @È4ð @ð @ð @ð @ð ð7˜T %¨¨S¨¤/°5¸¸c¸´?Ð"BÔCð 7ð 7ð 7ñ „Xð7ð ð2˜˜S %¨¨S°#¨Ô"6Ð6Ô7ð 2ð 2ð 2ñ „Xð2ð ð6˜D  e¨C°¨H¤oÐ!5Ô6ð 6ð 6ð 6ñ „Xð6ð) ð )¨ð )ð )ð )ð )ð$,¨¨c¬ð ,¸tð ,Èð ,ð ,ð ,ð ,ð$0;Ð1ð 0;¸Cð 0;È5Ì>ð 0;Ð^bð 0;ð 0;ð 0;ð 0;ðdA¨#ð A°Sð AÀ3ð AÐQTð AÐY]ð Að Að Að Að
°ð ¸ið ÐRUð Ø&)ðØ58ðØDGðØTWðà")ðð ð ð ð2PÐ 2ð PÀð PÈyð PØðPØ'*ðPØ2>ðPØJQðPà" 7Ô+ðPð Pð Pð Pð(LÐ%7ð LÀcð LØ#,ðLØ36ðLØ@CðLØKWðLà$+ðLà08¸Ô0AðLð Lð Lð Lð$=6Ð(:ð =6Èð =6Ø&/ð=6Ø69ð=6ØCFð=6à#/ð=6à;Bð=6àGOÐPWÔGXð=6ð =6ð =6ð =6ð~/Ð);ð /È#ð /Ø'0ð/Ø7:ð/ØDGð/à$0ð/à<Cð/àHPÐQXÔHYð/ð /ð /ð /ðPÐ%7ð PÀcð PØ#,ðPØ36ðPØ@CðPà ,ðPà8?ðPàDLÈWÔDUðPð Pð Pð Pð"/Ð(:ð /Èð /Ø&/ð/Ø69ð/ØCFð/à#/ð/à;Bð/àGOÐPWÔGXð/ð /ð /ð /ðBÐ&8ð Àsð Ø$-ðØ47ðØADðà!-ðà9@ðàELðð ð ð ð/Ð%7ð /Àcð /Ø#,ð/Ø36ð/Ø@Cð/à ,ð/à8?ð/àDLÈWÔDUð/ð /ð /ð /ðÐ$6ð ÀSð Ø"+ðØ58ðØ@Lðà#*ðà/3°E¸#¸w¸,Ô4GÔ/Hðð ð ð ð.B˜X e¨C°°c¸3ÀÀSÐ,HÔ&IÔJð Bð Bð Bð Bð*ð  'ð °Dð ÀSð ð ð ð ð7 tð 7°ð 7ð 7ð 7ð 7ð Tð ¨h°s¬mð ð ð ð ð¨Tð °h¸s´mð ð ð ð ð *Ð!3ð *¸ið *Ø"ð*Ø-0ð*Ø?Fð*ØKPÐQTÐVYÐQYÌ?ð*ð *ð *ð *ð.¨Gð ¸À¼ð ð ð ð ð ð ð ð rC   rV   rG  r*   r¼   rn   c                 óê   — |r|j         dk    s|d         dk    rd S |d         }||j        vrt          d¦  «        }nt          d¦  «        }t                               ||z  |d|d         ¬¦  «         dS )	NrK   r  r*  rq   zundefined label: %rzDFailed to create a cross reference. A title or caption not found: %r)rM   rÑ  ÚsubtypeT)r@   r=  r   r–   r—   )rG  r¼   rn   ru   Úmsgs        rA   Úwarn_missing_referencerû  b  s†   € àð 
�6”; %Ò'Ð'¨D°¬O¸uÒ,DÐ,DØˆtà�kÔ"ˆØ˜Ô*Ð*Ð*ÝÐ*Ñ+Ô+ˆCˆCåÐ[Ñ\Ô\ˆCå�Š�s˜V‘|¨d¸ÈÈYÌˆÑXÔXÐXØˆtrC   c                 óz   — |                       t          ¦  «         |                      dt          ¦  «         dddddœS )Nzwarn-missing-referenceÚbuiltinr-   T)ÚversionÚenv_versionÚparallel_read_safeÚparallel_write_safe)Ú
add_domainrV   Úconnectrû  )rG  s    rA   Úsetupr  q  sG   € Ø‡N‚N•>Ñ"Ô"Ð"Ø‡K‚KÐ(Õ*@ÑAÔAÐAð ØØ"Ø#ð	ð ð rC   ró  )^re   rÒ   Úsysr   Útypingr   r   r   r   r   r	   r
   r   r   r   r   r   Údocutilsr   Údocutils.nodesr   r   r   Údocutils.parsers.rstr   r   Údocutils.statemachiner   Úsphinxr   Úsphinx.addnodesr   r   Úsphinx.directivesr   Úsphinx.domainsr   r   Úsphinx.localer   r   Úsphinx.rolesr   r    Úsphinx.utilr!   r"   r#   Úsphinx.util.docutilsr$   Úsphinx.util.nodesr%   r&   r'   Úsphinx.util.typingr(   r)   Úsphinx.applicationr*   Úsphinx.buildersr+   Úsphinx.environmentr,   Ú	getLoggerrb   r–   Úversion_infor0   r  r”   ÚUr	  rž   rf   r2   rj   rm   r|   r�   rÃ   rÉ   rÔ   rö  rO   rÚ   rÞ   rà   r  r  r%  rV   rz   rû  r  rh   rC   rA   ú<module>r     sÔ  ðØ Ð à 	€	€	€	Ø 
€
€
€
Ø Ð Ð Ð Ð Ð ð.ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð .ð Ð Ð Ð Ð Ð Ø 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ø 6Ð 6Ð 6Ð 6Ð 6Ð 6Ð 6Ð 6Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,à Ð Ð Ð Ð Ð Ø 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ø /Ð /Ð /Ð /Ð /Ð /Ø *Ð *Ð *Ð *Ð *Ð *Ð *Ð *Ø Ð Ð Ð Ð Ð Ð Ð Ø 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ø 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AØ 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7àð 4Ø)Ð)Ð)Ð)Ð)Ð)Ø'Ð'Ð'Ð'Ð'Ð'Ø3Ð3Ð3Ð3Ð3Ð3à	ˆÔ	˜8Ñ	$Ô	$€àÔ�B�Q�BÔ˜6Ò!Ð!ØÐÐÐÐÐÐà€Eð �”Ð?Ñ@Ô@€àˆ2Œ:Ð)¨2¬4Ñ0Ô0€àÐÑÔ€	ð))ð ))ð ))ð ))ð ))Ð% cÔ*ñ ))ô ))ð ))ðX2ð 2ð 2ð 2ð 2ˆ]ñ 2ô 2ð 2ð1ð 1ð 1ð 1ð 1�Xñ 1ô 1ð 1ð*,&ð ,&ð ,&ð ,&ð ,&ˆ_ñ ,&ô ,&ð ,&ð^f5ð f5ð f5ð f5ð f5Ð! #Ô&ñ f5ô f5ð f5ðRð ð ð ð ˆoñ ô ð ð(ð ð ð ð �Xñ ô ð ð ð ¨¨h°s¬mÔ)<ð ð ð ð ðÐ.ð ¸8ÀD¼>ð ÐVYð Ø"ðØ,/ðØ:=ðØINÌðà!œJðð ð ð ð<o!ð o!ð o!ð o!ð o!ˆñ o!ô o!ð o!ðdð �cð ¨Cð ¸¸d¼ð ð ð ð ðB67ð 67ð 67ð 67ð 67�_ñ 67ô 67ð 67ðr	ð 	ð 	ð 	ð 	�Hñ 	ô 	ð 	ð~ð ~ð ~ð ~ð ~�Vñ ~ô ~ð ~ðB ð °&ð Àð Ø (¨¤ðð ð ð ð	ˆxð 	˜D  c œNð 	ð 	ð 	ð 	ð 	ð 	rC   