File: //usr/lib/python3/dist-packages/sphinx/builders/__pycache__/manpage.cpython-310.pyc
o
�$�af �
@ s8 d Z ddlmZ ddlmZmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZm Z dd
l m Z ddl m Z ddl!m"Z"m#Z# ddl$m%Z%m&Z& e�'e(�Z)G dd� de�Z*dedeee+e+e+ee+ e,f fdd�Z-dedee+ef fdd�Z.dS )z�
sphinx.builders.manpage
~~~~~~~~~~~~~~~~~~~~~~~
Manual pages builder.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�path)�Any�Dict�List�Set�Tuple�Union)� OptionParser)�
FileOutput)�addnodes)�Sphinx)�Builder)�Config��NoUri)�__)�logging�progress_message)� darkgreen)�inline_all_toctrees)� ensuredir�make_filename_from_project)�ManualPageTranslator�ManualPageWriterc @ s� e Zd ZU dZdZdZed�ZeZ g Z
e e e
d< ddd�Zdee e e f fd d
�Zdd e d e de fd
d�Zeed��deddfdd��Zddd�ZdS )�ManualPageBuilderz4
Builds groff output in manual page format.
�manz#The manual pages are in %(outdir)s.�supported_image_types�returnNc C s | j js
t�td�� d S d S )NzBno "man_pages" config value found; no manual pages will be written)�config� man_pages�logger�warningr ��self� r$ �9/usr/lib/python3/dist-packages/sphinx/builders/manpage.py�init+ s �zManualPageBuilder.initc C s dS )Nz all manpagesr$ r" r$ r$ r% �get_outdated_docs0 � z#ManualPageBuilder.get_outdated_docs�docname�typc C s |dkrdS t ||��)N�token� r )r# r) r* r$ r$ r% �get_target_uri3 s
z ManualPageBuilder.get_target_uri�writing�ignoredc G sn t | �}t| jj|fdd��� }| jjD ]�}|\}}}}} || jjvr,t� t
d�|� qt |t �r9|r7|g}ng }||_
||_||_| |_| jjr^d| }
tt�| j|
�� d|
|| f } nd|| f } tjt| �d dd� tt�| j| �d d
�} | j�|�}
t� }t| |||
t|g�}||_tjd dd� | j� ||| � |� t j �D ]}|� |j!� q�|�"|| � qd S ) NT)�defaults�
components�read_config_filesz7"man_pages" config value references unknown document %szman%sz%s/%s.%sz%s.%sz { )�nonlzutf-8)�destination_path�encodingz} )#r r �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�traverser � pending_xref� replace_self�children�write)r# r/ � docwriter� docsettingsrC r) �name� descriptionr> r? �dirname�
targetname� destination�tree�docnames� largetree� pendingnoder$ r$ r% rK 8 sZ ��
�
�
��zManualPageBuilder.writec C s d S �Nr$ r" r$ r$ r% �finishj r( zManualPageBuilder.finish)r NrW )�__name__�
__module__� __qualname__�__doc__rN �formatr �epilogr �default_translator_classr r r; �__annotations__r& r r' r- r r rK rX r$ r$ r$ r% r s
1r r r c C s, t | j�}| j|d| j| jf | jgdfgS )z$ Better default man_pages settings. z%s %s� )r �project�root_doc�release�author)r �filenamer$ r$ r% �default_man_pagesn s
�rg �appc C s@ | � t� | �dtd � | �ddd � | �ddd � dddd�S )Nr �
man_show_urlsFr@ �builtinT)�version�parallel_read_safe�parallel_write_safe)� add_builderr �add_config_valuerg )rh r$ r$ r% �setupu s
�rp N)/r\ �osr �typingr r r r r r �docutils.frontendr � docutils.ior
�sphinxr �sphinx.applicationr �sphinx.buildersr
�
sphinx.configr �
sphinx.errorsr �
sphinx.localer � sphinx.utilr r �sphinx.util.consoler �sphinx.util.nodesr �sphinx.util.osutilr r �sphinx.writers.manpager r � getLoggerrY r r r; �intrg rp r$ r$ r$ r% �<module> s(
(N