
    zi                    .   d Z ddlmZ ddl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 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m Z  erddl!m"Z" ddl#m$Z$  ej%        e&          Z' G d de          Z(ddZ)ddZ*dS ) zManual pages builder.    )annotationsN)path)TYPE_CHECKINGAny)OptionParser)
FileOutput)addnodes)Builder)__)logging)	darkgreen)progress_message)inline_all_toctrees)	ensuredirmake_filename_from_project)ManualPageTranslatorManualPageWriter)Sphinx)Configc                      e Zd ZU dZdZdZ ed          ZeZ	g Z
ded<   ddZdd
ZdddZ e ed                    dd            ZddZdS )ManualPageBuilderz4
    Builds groff output in manual page format.
    manz#The manual pages are in %(outdir)s.z	list[str]supported_image_typesreturnNonec                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    b/var/www/tmov.alphamb/tmov_inventario/venv/lib/python3.11/site-packages/sphinx/builders/manpage.pyinitzManualPageBuilder.init(   sJ    {$ 	2NN2 0 1 1 2 2 2 2 2	2 	2    str | list[str]c                    dS )Nzall manpages r!   s    r#   get_outdated_docsz#ManualPageBuilder.get_outdated_docs-   s    ~r%   Ndocnamestrtyp
str | Nonec                    dS )N r(   )r"   r*   r,   s      r#   get_target_uriz ManualPageBuilder.get_target_uri0   s    rr%   writingignoredr   c           	        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   
isinstancer+   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docsettingsrN   r*   namedescriptionrI   rJ   dirname
targetnamedestinationtreedocnames	largetreependingnodes                    r#   rV   zManualPageBuilder.write3   s   $T**	$&& 	= 	=#H7IJJJJ  ,*%<"& (  (  ( );(:(<(< 		= 	= 	= 	= 	= 	= 	= 	= 	= 	= 	= 	= 	= 	= 	= K) (	4 (	4D;?8GT;dh///r #0  1  129; ; ;'3'' ! !&iGG G $K#.K ")K")K{5 1!G+$)DK99::: '::$::::

 $00w00
KK	*--5DKAAA$!%4;
!C!C " " "K 8''00D!$H+D(GT,5yB BI!,IKK4K(((H''	7DAAA(001FGG ? ?(()=>>>>OOI{3333Q(	4 (	4s   AA::A>A>c                    d S Nr(   r!   s    r#   finishzManualPageBuilder.finishi   s    r%   )r   r   )r   r&   rc   )r*   r+   r,   r-   r   r+   )r2   r   r   r   )__name__
__module____qualname____doc__rY   formatr   epilogr   default_translator_classr   __annotations__r$   r)   r0   r   rV   rd   r(   r%   r#   r   r      s           DFR566F3')))))2 2 2 2
        bbmm$$34 34 34 %$34j     r%   r   r   r   r   *list[tuple[str, str, str, list[str], int]]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   m   sD    )&.99H_h6>(L(LFN(L(Lm_a! " "r%   appr   dict[str, Any]c                    |                      t                     |                     dt          d           |                     ddd           |                     ddd           ddddS )Nr   Fman_show_urlsrK   builtinT)versionparallel_read_safeparallel_write_safe)add_builderr   add_config_valuerv   )rw   s    r#   setupr   t   sy    OO%&&&&7???%7775ueDDD "#  r%   )r   r   r   rm   )rw   r   r   rx   )+rh   
__future__r   r>   osr   typingr   r   docutils.frontendr   docutils.ior   sphinxr	   sphinx.buildersr
   sphinx.localer   sphinx.utilr   sphinx.util.consoler   sphinx.util.displayr   sphinx.util.nodesr   sphinx.util.osutilr   r   sphinx.writers.manpager   r   sphinx.applicationr   sphinx.configr   	getLoggerre   r   r   rv   r   r(   r%   r#   <module>r      s     " " " " " "        % % % % % % % % * * * * * * " " " " " "       # # # # # #             ) ) ) ) ) ) 0 0 0 0 0 0 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`" " " "     r%   