*(UddlZddlZddlZddlmZmZmZmZmZm Z m Z m Z m Z ddl mZmZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z!m"Z"ddl#m$Z$ddl%m&Z&m'Z'm(Z(ee!j@ge)fZ*e d Z+e ee)e)e*fZ,e ee)e)e*e)fZ-ee.ge/fZ0ee)ee)fZ1ee!j@e)e)ge)fZ2d d d ed ed ed hZ3e e)e4d <ejjjlejjjnejjjpejjjrejjjtejjjvejjjxejjjzejjj|ejjj~ejjjejjjejjjg ZCee)e4d<ejjjldejjjndejjjpdejjjxdejjjrdejjjtdejjjzdejjjvdejjj|dejjj~dejjjdejjjdejjjdi ZDee)e)fe4d<dZEdZFdZGd ZHd!ZId"ZJeEeFeGeHeIeJgZKee)e4d#<eEd$eFd%eGd&eHd'eId(eJd)iZLee)e)fe4d*< dd+e)d,ee)e)fd-eMd.e/d/ee)f d0ZNd1e!j@d/e)fd2ZOd3e)d/ee e)ee)ffd4ZPd+e)d5e/d1e!j@d/e)fd6ZQ dd7ee)d8e)d9ee)d/dfd:ZRd1e!j@d;e)dZSd1e!j@d?e)d/e/fd@ZTd1e!j@dzlistexts..s)K]!t)]s %s:%s: %s  rs %s )sorteditemsanyr&appendinsert)r+r,r-r.rstnamer7s @r8listextsrCsr C  .JD$!c)K])K&K JJ~d(CC D/  1kF*+ Jrc\td|jd}|jtt dt j d|jtt dt j|jdj|}|S)N extensionsTenabled extensions:r.sdisabled extensions:rD) loaddoc splitlinesextendrCr renableddisabledverbosejoin)rrAdocs r8extshelprQs '-  $ / / 5CJJ $ %z'9'9';D  JJ % &    !::  ((3-C JrDtextc|dddk(rAd}|j|}|dk\r(||t|zd}|d||jddfSyy)zdgiven a text 'abc (DEFAULT: def.ghi)', returns (b'abc', (b'def', b'ghi')). Otherwise return NoneN)s (DEFAULT: r.)findlensplit)rRmarkerpositems r8parsedefaultmarkerr^sg BCyDii !8c&k)B/D:tzz$22 2 rDrNcLg}d}|D]N}t|dk(r |\}}} } n|\}}} td} |stfdtDrHd} | 4t } | '| \\} }|j | |r d} td} d}|rd|z}d |z}| durd |z}t | tjr| j} | rCt| s8tj| }| dur td }td || zzz t | tr |d | zz }d}n| t | ts|d| zz }|j||fQ|r|tdz }d|zg}|j!t#j$|ddj'|S)NFsVALUEc3&K|]}|v ywr2r3r4s r8r9zoptrst..s@-QqDy-r:rDTs from config-s--s--[no-]sons (default: %s)s %s [+]s %ss ([+] can be repeated)s %s: r )rYr r>r&r^ configbool isinstancer customoptgetdefaultvaluecallablerbytestrlistboolr?rKr maketablerO)r+optionsrNrdata multioccuroptionshortoptlongoptdefaultoptlabeldefaultstrsuffix parseresultsectionrBsolo defaultstrrAr7s @r8optrstrzs DJ v;! 9? 6Hgwh/5 ,Hgw{H3@-@@  ?,T2K&*5'==$/"G'('9$  B W_ d?g%B gy22 3--/G 8G, "))'2J$uX A'(J9I,IJ JD gt $ *x' 'BJ!:gt+D &8# #B RTN#UX!-.. & !CJJw  q)* 88C=rDrAomitted notomittedcZ|jd|z|r|jd|zyy)Ns" .. container:: omitted %s s% .. container:: notomitted %s )r?)rAr{r|s r8indicateomittedr~s0JJ:WDE AJNOrDcmdkwrPc,|js|jdr|dk7ry|js;|ssyt|ddrt|ddsyrt fdt Dry|dk(rt|ddsy|j d d |zryy) NdebugTaliasFowndocc3&K|]}|v ywr2r3)r5r6rPs r8r9zfiltercmd.. s7AqCxr: shortlist helpbasichelpshidden-command.%s) debugflag startswithrNrr>r&rc)rrfuncrrPs `r8 filtercmdrs <.lowercontains&sX^^I...rD)topicscommandsrFextensioncommandsrrrWrDrFrVrTrFcmdtable(no help text available)r)rr helptablesummaprgrr?tabler=rYr rgetdocr# firstliner parsealiasesr itertoolschainrrLrM rpartitionload ImportErrorrr)rcommandsrrresultsrnamesr+rPrBrentrysummaryrdocscmdnamemodcmddocs ` r8 topicmatchrs  B/ G "1QZvs M5) *V$ -B"88Dr4( "))58V*<=nn**, U u:?AhGGQx&'.3 9 g.-2E$..t4**3/2GWdB5 K ' ''(: ;- oo5!'')##% d t$R(  -"5 M " ) )41E1Ed1K*L M //"dC0C"#z26<<>JCSySZ!^ eAh0G!..s3A6Qx!.'11'&/BF:;FR$F;,-44gv5FG?6 N   sK44 LLsubdircDdtjdtffd }|S)z+Return a delayed loader for help/topic.txt.rr/cd}r|dzz }tj|dz5}t|j}dddtj gD] }||}S#1swY0xYw)Nsmercurial.helptextrVs.txt)r" open_resourcerread helphooksget)rpackagefprPrewriterrrs r8loaderzloaddoc..loaderjsw'  tf} $G  ' ' AR"'')$CB! eR0H2uc*C1 B As A00A9)uimodrbytes)rrrs`` r8rIrIgs!588 MrDs bid-mergesBid Merge Algorithms internals)rsbundle2sBundle2sbundlessBundlesscborsCBORscensorsCensors changegroupss ChangegroupssConfig Registrars dirstate-v2sdirstate-v2 file formatrF extensions Extension APIs mergestates Mergestates requirementssRepository Requirementssrevlogss Revision Logss wireprotocols Wire ProtocolswireprotocolrpcsWire Protocol RPCswireprotocolv2sWire Protocol Version 2internalstablec|ddg}tD]\}}}|jd|d|fz!dj|S)z-Generate the index for the "internals" topic.s>To access a subtopic, use "hg help internals.{subtopic-name}"  :%s: %s rrD)rr?rO)rlinesrr+rPs r8 internalshelprsO K  E-vs ]eAh%778- 88E?rDs bundlespecsBundle File FormatsscolorsColorizing OutputsshgrcsConfiguration Filess deprecatedsDeprecated Featuressdatess Date FormatssflagssCommand-line flagsspatternssFile Name Patternss environmentsenvsEnvironment Variables) revisionssrevssrevsetssrevsets multirevssmrevssSpecifying Revisionsr)rustsrustextsrhgsRust in MercurialrsfilesetssfilesetsSpecifying File Setssdiffss Diff Formats) merge-toolss mergetoolss mergetools Merge Toolsr)s templating templatesstemplatesstylesTemplate Usagersurlss URL PathssUsing Additional FeaturesssubreposssubreposSubrepositoriesshgwebsConfiguring hgwebsglossarysGlossaryshgignoresignores!Syntax for Mercurial Ignore FilessphasessWorking with Phasess evolutions'Safely rewriting history (EXPERIMENTAL)s scriptings+Using Mercurial from scripts and automationsTechnical implementation topicsspagers Pager Supportr subtopicsrrcNtj|gj|yr2)r setdefaultr?)rrs r8 addtopichookros #**84rDr[r=dedentc g}t|D]9}tj||xsdj r$|jst fdt DrUt  |r3tj jdjd j}|dg} |ddD]g} | jjdrnF|r | j| jF| jd| jzi|jd j!| <d j!|}|j#||S) zExtract docstring from the items key to function mapping, build a single documentation block and use it to overwrite the marker in doc. rDc3&K|]}|v ywr2r3)r5r6rRs r8r9zmakeitemsdoc..s-OAa4ir:latin1rr Ns>>>s rs )r<rrrstriprNr>r&rtextwraprdecodeencoderJstriprr?rOreplace) rrrPr[r=rentriesrBrdoclineslrRs @r8 makeitemsdocrss!Gu d ,3;;=2::#-O-O*O t} ??4;;x#89@@JD!!H:qrAwwy##F+ + 12 uzz(+,%&ll7#G ;;vw ''rDcjdtjdtdtffd }t||y)NrrrPc&t|||S)Nr)r)rrrPrr[symbolss r8addzaddtopicsymbols..addsBsFGFKKrD)rrrr)rr[rrrs ``` r8addtopicsymbolsrs1LLLULrDs.. bundlecompressionmarkers.. predicatesmarkers.. internaltoolsmarkers.. keywordsmarkers.. filtersmarkers.. functionsmarkers.. webcommandsmarkerTrcd}tjfd}tjdtj|z||S)Ns.. tweakdefaultsmarkercjDcgc]}|jd|z}}dj|Scc}w)Nr r)rJgrouprO)msrrepls r8subzinserttweakrc..subs@)-):;):Aa):;zz%  eAh"5%(3H1H!H u+Y2y)  2 . 5 5y&6I J d?rD unknowncmdfullsubtopicfullnamec tjdtdttdttffd }d!dtt dttffd d!dtdttdttffd } d!dtdttdttffd } d!dtdttdttffd g} j d } | s6tfd Dr!txsd } g}j d r|dtdfgz }j dr|dtdfgz }|s2dtdfdtdfdtdfdtdfg}|D]a\}}| |s | jd|z| jtjt| |d| jdc| s!td}td}tj ||rdk7rg}r|gz }j d r|| gz }j dr||gz }|s| || f}|D] } ||} nrtj"|r|}n}|r|}n}td|z}td|z}tj ||j$s td dg} | jd!itj&d j)| S#tj"$rYwxYw)"z Generate the help for 'name' as unformatted restructured text. If 'name' is None, describe the commands available. rBrr/c4 tj| j\}}g}t |dddrY|j|djdz|djr' |j|dj|S|St|dkDrI|djdr|jd|dzn4|jd |d|dfzn|jd |dz rIjs=t|d kDr/|jt!d d j#|d dz|jdt%t'j(|d}|s t!d}t+j,|ddrm|dj.}|dj0jdr"t!d|dj0d d||fz}nt!d|dj0||fz}|j3d}js s|j|dn|j||jd t5j6|} t%t'j(| xsd}d|j9vr$t!d||fz} |jd| zjs8|d r3|jt=t!d|d j>j>r:|jt=t!d j@j>j>sG s|jt!d|z|Sjs|jt!d|S#tj$r%}|j fd}|}|cYd}~Sd}~wwxYw#tj$rY|SwxYw#t:$rY@wxYw)N)strictcRtj|djS)Nr)rrr)rprefixs r8z(help_..helpcmd.. s w33A6q9DDVLrDrbadaliasrrWshgs%s s hg %s %s shg %s r s aliases: %s , r definition!s(shell alias for: %s %s defined by: %s s%alias for: hg %s %s defined by: %s TrDs7(use 'hg help -e %s' to show help for the %s extension) %s soptionsglobal optionss$ (use 'hg %s -h' to show more help) s; (some details hidden, use --verbose to show complete help))!rfindcmdrrAmbiguousCommandr rr?r rrKrUnknownCommandrYrquietr rOrrrr safehasattrsourcer rJrrXrKeyErrorrzrN globalopts)rBraliasesrinstrrArPrrmsgr rr helpextcmdhelplistrrs @r8helpcmdzhelp_..helpcmds $__hnnZNGU 58Z . JJuQx((50 1Qx""JJz%(*:*:;<J3J u:>Qx""5) 7U1X-. =GAJa+AAB JJzGAJ. / S\A%5 JJq+,uzz'!"+/FF G 5hooeAh/0/0C   E!Hl 31X__FQx""--d3HI!H''+M EF!H''J nnT" 884 JJs1v  JJsO 5 //$'C(//#./63C #)4L! 9s?+ xxE!H JJva mU1Xrzz2F G :: JJ'((*=*=rzz2  zz 1FG$NO XX 2 }%% [[FLF6"CJ   ++Jj   sB%N5,$O0)A-P 5O-O("O-(O-0PP PPrc ztj|\}gs(jsjt dSjsZdk(rjt dn:dk(rjt dnjt ddt t ddffd }d vr |nt|jttz }|r'jd tj|ztD]d}|j|g}|st|d kDr&tt |}jd |zjd||f|j}|dxs|dxs|d } s^| r[t#t dt%j&j(} | r"jdj+| jt dt-t.\} } t| jtt0z }|r'jdtj|zt0D]|}| j|g} | st| d kDr&tt2|}jd |zjd| D]\}}jd||fz~jr Sj(r^jdt5t dj6j(zdk(rjt dSdk(rjt dSr!sjt dzSr3r1jvrjt dzSjt dxrdzxsdzS) Nsno commands defined rsbasic commands: rs,debug commands (internal and unsupported): slist of commands: cmdsr/ct|}|D]O}|}jrdj|}|jdd}j d||fzQy)Nr :s\:r)r<rNrOrr?)r r display_cmdrrArrs r8 appendcmdsz+help_..helplist..appendcmds|s`$>? rD)rrs/help categories missing from CATEGORY_ORDER: %sr s %s: rkeywordr extensionrGrHs additional help topics: s5help categories missing from TOPIC_CATEGORY_ORDER: %srrrs/ (use 'hg help' for the full list of commands) sF (use 'hg help' for the full list of commands or 'hg -v' for details) s/ (use 'hg help %s' to show the full help text) sF (use 'hg help -v -e %s' to show built-in aliases and global options) sB (use 'hg help -v%s' to show built-in aliases and global options) r;rD)rrrr?r rrsetkeysr' develwarnr# forcebytestrrrYrr(rCrrLrNrKrrr)r*rzr)roptsrr$ missing_orderrcatfnscatnameexanyoptsr,r topicsynstopicstr7rrArrrrBrs @@@r8rzhelp_..helplisths/ f a88 1567Jxx|# 1345! 1NOP 1345 @Xe_ @ @ @ + + qM  ,s>/BBM F --m<= &#r*4y1}").*="> :#78JJu%v&&XXY-I9 (HK#I()""$!zzD  5! 4 JJq78 9#s*C"D :#78JJu%#)4 =At9#<=$*, 88 R QZZ JJ'((*=*=rzz2  |# JK@ 9|# 56 +d JK( !$4499;#6 9   1+t 2s 4 rDcd\}}rP|tvrHt|D] \}}}|vs ntfdt|Dstj||s/tD]}|dd\}}}||vsntj|t j |g}|s|jdtdzt|r*|| jDcgc]}d|z c}z } jstd}t|| tj| j|jtd||fz|Scc}w#tj$rY|SwxYw) N)NNc3,K|] }|dv yw)rNr3)r5rrs r8r9z+help_..helptopic..sAAx1Q4'srrs %s r:(some details hidden, use --verbose to show complete help)s4 use 'hg help -c %s' to see help for the %s command )rr>rrrrrvr?r rgrJrNr~rrr) rBrr+rPrrrArr{rrs ` r8 helptopiczhelp_..helptopics}   )&/o"vsu$'6A4AA**400"%*1QZ"vs5=# **400v&' JJ{Q'B%CC D C= SW-?-?-AB-AK!O-AB BCzz+G C )  OOD(.. 1 JJKL,   #C##    s$ E?EE65E6c: tj|}ttj|xs t d}d|vr|d}}n|jdd\}}t d|jdd|fzg}|r1|j|jd|jd jst d }t!|||rQ |j"}|D chc]} | j'd d } } |j | j(|S|jt d |S#t $r2d}tj|}|stj|Y@wxYw#t$$ri}YwxYwcc} w) Nsno help text availablerrDr s%s extension - %s rVrTTr6|rB(use 'hg help extensions' for information on enabling extensions) )rrXrrrr r disabled_helprrrZrrKrJr?rNr~rAttributeError partition __contains__) rBrrrPheadtailrAr{ctrmodcmdsrrs r8helpextzhelp_..helpexts 1//$'C(//#./O15N3OC  c$D5!,JD$)*dood.CB.G-NNO  JJtt, - JJu zz+G C )  \\688Rq{{4(+RG8 JJx 4 45 6 JJ&   I 1C**40C**400 12"  8s*AE  F-F 7FF FFctj|jdd\}}}tj|}t t d|z||idd}|jd|jt d|S) Nuisstricts,'%s' is provided by the following extension:T)r-r.rr:)r disabledcmdrcr#rrCr r?)rBrrextrPrArs r8rzhelp_..helpextcmd>s#.. bmmE95 S#""3' = > D #J   5 !   rDskeywordc3(K|] }| ywr2r3)r5or+s r8r9zhelp_..Ws!84a$q'4srDrrFs ExtensionsscommandrsCommandsrsTopicsrsExtension Commandss%s: r rs no matchess"try 'hg help' for a list of topics)hintrsno such help topic: %sstry 'hg help --keyword %s'sMercurial Distributed SCM r2)r byteskwargsrrr _SelectFnrr>rr r?rKrrkr<r InputErrorrr strkwargsrO)rrrBrrrrr+rr7rCrArmatches helpareasr3titlerrKqueriesr formatnamehintnamerrs````` ` @@r8help_rVs]    %Dcecxc4;ccJ),U B))%)DK)V(e(x($u+(V26' e. C * B T\c!84!88R4;37 88L ! =!M*:;< '?@ I "HAuqz :-. 7,,VGAJ-?CD 5! " M"C:;D""3T2 2 $,&   | #G 88L ! y G 88J  y G '7J?GA h'**400!)J!%J'H#H12Z?67(B&&s66xx34e 88C=/''  s L88M Mkeepc |g}n t|}dx}x}} |c|jd} | jd}| r|tvr| jd}| r$t j dj | } |jdd} |jdz } | dks| | kr| } t|||f||||d|} tj| |\}}d |vr|jd n|jd tj| |\}}| rtj|| }| r%|r|s!tjt!d |ztj"|| S) zget help for a given topic (as a dotted name) as rendered rst Either returns the rendered help text or raises an exception. NrVrrEs textwidthrW)rrrr)rWsverbosesomitteds notomittedshelp section not found: %s)rirZpoprrrrO configint termwidthrVrparser?filtersectionsrrNr formatplain)rrrrWrrr+rBrrv nameparts textwidthr[rRblockspruneds r8 formattedhelprcsv |Dz!%$D$8gNN4( }}Q * }}Q'H nnTYYy%9:G UL1I "IA~Y.        D]]4d3NFFV J M"]]4d3NFF''8 4q!>?(JKK   vy 11rD)r Fr2)F)FTNN)NFT)lrrrtypingrrrrrrr r r i18nr rrrrrrrrrrrrrrrrrrrhgwebr utilsr!r"r#r _DocLoader _HelpEntryr$r%objectrjrM _SynonymTable _TopicHookr&__annotations__rCATEGORY_REPO_CREATIONCATEGORY_REMOTE_REPO_MANAGEMENTCATEGORY_COMMITTINGCATEGORY_CHANGE_MANAGEMENTCATEGORY_CHANGE_ORGANIZATIONCATEGORY_FILE_CONTENTSCATEGORY_CHANGE_NAVIGATIONCATEGORY_WORKING_DIRECTORYCATEGORY_IMPORT_EXPORTCATEGORY_MAINTENANCE CATEGORY_HELP CATEGORY_MISCrr'r(TOPIC_CATEGORY_IDSTOPIC_CATEGORY_OUTPUTTOPIC_CATEGORY_CONFIGTOPIC_CATEGORY_CONCEPTSTOPIC_CATEGORY_MISCrr)r*intrCrQr^rzr~rrrrIr<rrrrrrrrbundlecompressiontopicsr internalsdockeywordsfiltersfuncsrrrrrVrcr3rDr8rs]     $ uxxj%' ( C D T%[%;<tE{E:uDE fXt^ $ UDK'( uxx.5 6 mo  s5z ",, 55 )) 00 22 ,, 00 00 ,, ** ## ## ##U &,,.D 557V ))+= 002F 002H 224J 002Q ,,.H ,,.E **,E ##W ##%> ##%>&UE\""!!% %d5k0.5[)0 ,d5%<(   ue|     %[ $e$3U3xeT%[6H0I'J3555D5ehh555rEIP eP$P2:5/P P%((%e.EEHHEUEtEH H %H %eE5L)* *+HV 5 (5/ Z  .4N $ % L 6 q}gj&NO q}gj&NO AgJ EF a lGIl$KL   o  OL 9 K ! " Il 3   ( ) N< 8 L )   M, 7 O m  M, 7   ( ) OL 9 L   J| 4     OL 9  " # &| <   ( ) %l ; o<>.)*>B ehh 5 +1O $ % M " #  J # $ H  !   $ % I  !  O $ % M "   J o  H  !  J # $ H  !  M # $ K   V $ & ' N # !    % & L !    " # G  ! * % % & K   J o  H  !   : n  N # !   A  L ! !  AlOWW%57IJ O * +  !  * %  ! K #  J " # H  !  M kN K #  ) $ 2 3 K   K $ % I  #  N 8 9 L ! #  N < = L !   N 0 1    J   H  !  o]_+ 4& '_F.6 4t011 2 ,. 4tJ'' (-5555 (  (  (  (  ( u  (  (  (H:? 26 !'K'')  3W__E-y/E/E 4fnnE 2J4G4GH 1?3J3JK 3]5H5HI %{';';D  ":. 4tE%,/00 14tE{8J3K KL( Y & $ $a a a a  a uo auoa aP '+ :2 :2uo:2 8E? # :2  :2  :2 :2rD