§
    _÷#d¢  ã            
       óx  — d 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 ddlmZ ddlmZ ddlmZ ddlmZ dd	l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  ddl!m"Z"m#Z# ddl$m%Z%m&Z&  ej'        e(¦  «        Z) G d„ de¦  «        Z*dedee
e+e+e+ee+         e,f                  fd„Z-dedee+ef         fd„Z.dS )zManual pages builder.é    N)Úpath)ÚAnyÚDictÚListÚOptionalÚSetÚTupleÚUnion)ÚOptionParser)Ú
FileOutput)Úaddnodes)ÚSphinx)ÚBuilder)ÚConfig)Ú__)ÚloggingÚprogress_message)Ú	darkgreen)Úinline_all_toctrees)Ú	ensuredirÚmake_filename_from_project)ÚManualPageTranslatorÚManualPageWriterc                   óî   — e Zd ZU dZdZdZ ed¦  «        ZeZ	g Z
ee         ed<   dd„Zdeeee         f         fd„Zdd	ed
ee         defd„Z e ed¦  «        ¦  «        deddfd„¦   «         Zdd„ZdS )ÚManualPageBuilderz4
    Builds groff output in manual page format.
    Úmanz#The manual pages are in %(outdir)s.Úsupported_image_typesÚreturnNc                 óp   — | j         j        s)t                               t	          d¦  «        ¦  «         d S d S )NzBno "man_pages" config value found; no manual pages will be written)ÚconfigÚ	man_pagesÚloggerÚwarningr   ©Úselfs    ú9/usr/lib/python3/dist-packages/sphinx/builders/manpage.pyÚinitzManualPageBuilder.init#   sJ   € ØŒ{Ô$ð 	2Ý�NŠN�2ð 0ñ 1ô 1ñ 2ô 2ð 2ð 2ð 2ð	2ð 	2ó    c                 ó   — dS )Nzall manpages© r$   s    r&   Úget_outdated_docsz#ManualPageBuilder.get_outdated_docs(   s   € Øˆ~r(   ÚdocnameÚtypc                 ó   — dS )NÚ r*   )r%   r,   r-   s      r&   Úget_target_uriz ManualPageBuilder.get_target_uri+   s   € Øˆrr(   ÚwritingÚignoredc           	      ó  — t          | ¦  «        }t          j        ¦   «         5  t          j        dt          ¬¦  «         t          | j        j        |fd¬¦  «                             ¦   «         }d d d ¦  «         n# 1 swxY w Y   | j	        j
        D �]í}|\  }}}}}	|| j        j        vr)t                               t          d¦  «        |¦  «         ŒBt          |t           ¦  «        r|r|g}ng }||_        ||_        ||_        |	|_        | j	        j        r7d|	z  }
t-          t/          j        | j        |
¦  «        ¦  «         |
›d|›d|	›�}n|›d|	›�}t                               t7          |¦  «        d	z   d¬
¦  «         t9          t/          j        | j        |¦  «        d¬¦  «        }| j                             |¦  «        }t=          ¦   «         }t?          | |||t6          |g¦  «        }||_        t                               dd¬
¦  «         | j                              ||| ¦  «         | !                    tD          j#        ¦  «        D ]}| $                    |j%        ¦  «         Œ| &                    ||¦  «         �Œïd S )NÚignore)ÚcategoryT)ÚdefaultsÚ
componentsÚread_config_filesz7"man_pages" config value references unknown document %szman%sú/ú.z { )Únonlzutf-8)Údestination_pathÚencodingz} )'r   ÚwarningsÚcatch_warningsÚfilterwarningsÚDeprecationWarningr   ÚenvÚsettingsÚget_default_valuesr    r!   Úall_docsr"   r#   r   Ú
isinstanceÚstrÚtitleÚsubtitleÚauthorsÚsectionÚman_make_section_directoryr   r   ÚjoinÚoutdirÚinfor   r   Úget_doctreeÚsetr   Úresolve_referencesÚfindallr   Úpending_xrefÚreplace_selfÚchildrenÚwrite)r%   r2   Ú	docwriterÚdocsettingsrO   r,   ÚnameÚdescriptionrJ   rK   ÚdirnameÚ
targetnameÚdestinationÚtreeÚdocnamesÚ	largetreeÚpendingnodes                    r&   rW   zManualPageBuilder.write.   sæ  € å$ TÑ*Ô*ˆ	ÝÔ$Ñ&Ô&ð 	=ð 	=ÝÔ# HÕ7IÐJÑJÔJÐJõ  ,ØœÔ*Ø%˜<Ø"&ð (ñ  (ô  (÷ );Ò(:Ñ(<Ô(<ð ð		=ð 	=ð 	=ñ 	=ô 	=ð 	=ð 	=ð 	=ð 	=ð 	=ð 	=øøøð 	=ð 	=ð 	=ð 	=ð ”KÔ)ð (	4ñ (	4ˆDØ;?Ñ8ˆG�T˜;¨°Ø˜dœhÔ/Ð/Ð/Ý—’�rð #0ñ  1ô  1Ø29ñ;ô ;ð ;àÝ˜'¥3Ñ'Ô'ð !Øð !Ø&˜i�G�Gà �Gà $ˆKÔØ#.ˆKÔ Ø")ˆKÔØ")ˆKÔàŒ{Ô5ð 7Ø! GÑ+�Ý�$œ) D¤K°Ñ9Ô9Ñ:Ô:Ð:Ø+2¨7¨7°D°D°D¸'¸'ÐB�
�
à(,¨¨¨g¨gÐ6�
å�KŠK�	 *Ñ-Ô-°Ñ5¸DˆKÑAÔAÐAÝ$Ý!%¤¨4¬;¸
Ñ!CÔ!CØ ð"ñ "ô "ˆKð ”8×'Ò'¨Ñ0Ô0ˆDÝ!$¡¤ˆHÝ+¨D°(¸GÀTÝ,5¸°yñBô BˆIà!,ˆIÔÝ�KŠK˜ 4ˆKÑ(Ô(Ð(ØŒH×'Ò'¨	°7¸DÑAÔAÐAà(×0Ò0µÔ1FÑGÔGð ?ð ?�Ø×(Ò(¨Ô)=Ñ>Ô>Ð>Ð>à�OŠO˜I {Ñ3Ô3Ð3Ñ3ðQ(	4ð (	4s   £AA:Á:A>ÂA>c                 ó   — d S ©Nr*   r$   s    r&   ÚfinishzManualPageBuilder.finishd   s   € Øˆr(   )r   Nrd   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__rZ   Úformatr   Úepilogr   Údefault_translator_classr   r   rG   Ú__annotations__r'   r
   r+   r   r0   r   r   rW   re   r*   r(   r&   r   r      s  € € € € € € ðð ð €DØ€FØˆRÐ5Ñ6Ô6€Fà3ÐØ')Ð˜4 œ9Ð)Ð)Ñ)ð2ð 2ð 2ð 2ð
 5¨¨d°3¬i¨Ô#8ð ð ð ð ðð  cð °¸´ð Èð ð ð ð ð Ð�b�b˜‘m”mÑ$Ô$ð34˜cð 34 dð 34ð 34ð 34ñ %Ô$ð34ðjð ð ð ð ð r(   r   r    r   c                 ón   — t          | j        ¦  «        }| j        || j        ›d| j        ›�| j        gdfgS )z$ Better default man_pages settings. ú é   )r   ÚprojectÚroot_docÚreleaseÚauthor)r    Úfilenames     r&   Údefault_man_pagesrv   h   sA   € å)¨&¬.Ñ9Ô9€HØŒ_˜h°6´>°>°>À6Ä>À>Ð(RØŒmˆ_˜að!ð "ð "r(   Úappc                 óÖ   — |                       t          ¦  «         |                      dt          d¦  «         |                      ddd¦  «         |                      ddd¦  «         ddddœS )Nr!   FÚman_show_urlsrL   ÚbuiltinT)ÚversionÚparallel_read_safeÚparallel_write_safe)Úadd_builderr   Úadd_config_valuerv   )rw   s    r&   Úsetupr€   o   sy   € Ø‡O‚OÕ%Ñ&Ô&Ð&à×Ò˜Õ&7¸Ñ?Ô?Ð?Ø×Ò˜¨%°Ñ7Ô7Ð7Ø×ÒÐ5°u¸eÑDÔDÐDð Ø"Ø#ðð ð r(   )/ri   r>   Úosr   Útypingr   r   r   r   r   r	   r
   Údocutils.frontendr   Údocutils.ior   Úsphinxr   Úsphinx.applicationr   Úsphinx.buildersr   Úsphinx.configr   Úsphinx.localer   Úsphinx.utilr   r   Úsphinx.util.consoler   Úsphinx.util.nodesr   Úsphinx.util.osutilr   r   Úsphinx.writers.manpager   r   Ú	getLoggerrf   r"   r   rG   Úintrv   r€   r*   r(   r&   ú<module>r‘      sú  ðØ Ð à €€€Ø Ð Ð Ð Ð Ð Ø ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?à *Ð *Ð *Ð *Ð *Ð *Ø "Ð "Ð "Ð "Ð "Ð "à Ð Ð Ð Ð Ð Ø %Ð %Ð %Ð %Ð %Ð %Ø #Ð #Ð #Ð #Ð #Ð #Ø  Ð  Ð  Ð  Ð  Ð  Ø Ð Ð Ð Ð Ð Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ø )Ð )Ð )Ð )Ð )Ð )Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ø DÐ DÐ DÐ DÐ DÐ DÐ DÐ DØ IÐ IÐ IÐ IÐ IÐ IÐ IÐ Ià	ˆÔ	˜8Ñ	$Ô	$€ðMð Mð Mð Mð M˜ñ Mô Mð Mð`"˜fð "¨¨e°C¸¸cÀ4ÈÄ9ÈcÐ4QÔ.RÔ)Sð "ð "ð "ð "ðˆvð ˜$˜s C˜xœ.ð ð ð ð ð ð r(   