3
T'ícS ã @ s( d Z ddlmZ ddlmZmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZmZ dd lm Z dd
l m Z ddl m Z m!Z! ddl"m#Z#m$Z$ ej%e&Z'G dd deZ(eeee)e)e)ee) e*f dddZ+eee)ef dddZ,dS )zManual pages builder.é )Úpath)ÚAnyÚDictÚListÚSetÚTupleÚUnion)Ú OptionParser)Ú
FileOutput)Úaddnodes)ÚSphinx)ÚBuilder)ÚConfig)Ú__)ÚloggingÚprogress_message)Ú darkgreen)Úinline_all_toctrees)Ú ensuredirÚmake_filename_from_project)ÚManualPageTranslatorÚManualPageWriterc @ s e Zd ZU dZdZdZedZeZ g Z
e e
ddddZ
ee e e f ddd Zde e e d
d d Zeed
eddddZddddZdS )ÚManualPageBuilderz4
Builds groff output in manual page format.
Zmanz#The manual pages are in %(outdir)s.N)Úreturnc C s | j jstjtd d S )NzBno "man_pages" config value found; no manual pages will be written)ÚconfigÚ man_pagesÚloggerÚwarningr )Úself© r ú9/tmp/pip-build-gk9425m9/sphinx/sphinx/builders/manpage.pyÚinit" s zManualPageBuilder.initc C s dS )Nz all manpagesr )r r r r Úget_outdated_docs' s z#ManualPageBuilder.get_outdated_docs)ÚdocnameÚtypr c C s dS )NÚ r )r r# r$ r r r Úget_target_uri* s z ManualPageBuilder.get_target_uriÚwriting)Úignoredr c G s| t | }t| jj|fddj }xT| jjD ]F}|\}}}}} || jjkr^tj t
d| q,t |t rx|rt|g}ng }||_
||_||_| |_| jjrÂd| }
ttj| j|
d|
|| f } n d|| f } tjt| d dd ttj| j| d d
} | jj|}
t }t| |||
t|g}||_tjd dd | jj ||| x"|j t j D ]}|j |j! qRW |j"|| q,W d S ) NT)ÚdefaultsÚ
componentsZread_config_filesz7"man_pages" config value references unknown document %szman%sz%s/%s.%sz%s.%sz { )Znonlzutf-8)Zdestination_pathÚencodingz} )#r r ÚenvÚsettingsÚget_default_valuesr r Zall_docsr r r Ú
isinstanceÚstrÚtitleZsubtitleÚauthorsÚsectionÚman_make_section_directoryr r ÚjoinZoutdirÚinfor r
Z get_doctreeÚsetr Zresolve_referencesÚfindallr Z pending_xrefZ replace_selfÚchildrenÚwrite)r r( Z docwriterZ docsettingsr6 r# ÚnameÚ descriptionr2 r3 ÚdirnameZ
targetnameZ destinationÚtreeZdocnamesZ largetreeZ pendingnoder r r r: - sL
zManualPageBuilder.writec C s d S )Nr )r r r r Úfinish_ s zManualPageBuilder.finish)N)Ú__name__Ú
__module__Ú __qualname__Ú__doc__r; Úformatr Úepilogr Zdefault_translator_classZsupported_image_typesr r0 r! r r" r& r r r: r? 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 ÚprojectZroot_docÚreleaseÚauthor)r Úfilenamer r r Údefault_man_pagesc s
rK )Úappr c C s@ | j t | jdtd | jddd | jddd ddddS )Nr Z
man_show_urlsFr4 ÚbuiltinT)ÚversionZparallel_read_safeZparallel_write_safe)Z add_builderr Zadd_config_valuerK )rL r r r Úsetupj s
rO N)-rC Úosr Útypingr r r r r r Zdocutils.frontendr Z docutils.ior
Zsphinxr Zsphinx.applicationr Zsphinx.buildersr
Z
sphinx.configr Z
sphinx.localer Z sphinx.utilr r Zsphinx.util.consoler Zsphinx.util.nodesr Zsphinx.util.osutilr r Zsphinx.writers.manpager r Ú getLoggerr@ r r r0 ÚintrK rO r r r r Ú<module> s$
L&