暫無描述
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

cm-help.es.txt 369KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174
  1. == CMD_DESCRIPTION_ACL ==
  2. Configura permisos para un objeto.
  3. == CMD_USAGE_ACL ==
  4. Sintaxis:
  5. cm acl (--user=<usr_name> | --group=<group_name>)
  6. (-allowed|-denied|-overrideallowed|-overridedenied=+|-<permission>[,...])[,...]
  7. <objectspec>
  8. --user Nombre de usuario.
  9. --group Nombre de grupo.
  10. -allowed Habilita los permisos indicados. Use una coma para
  11. separar permisos. (Use 'cm showpermissions' para mostrar
  12. los permisos disponibles.)
  13. -denied Deniega los permisos indicados. Use una coma para
  14. separar permisos. (Use 'cm showpermissions' para mostrar
  15. los permisos disponibles.)
  16. -overrideallowed Anula los permisos habilitados. Use una coma para separar
  17. permisos. (Use 'cm showpermissions' para mostrar
  18. los permisos disponibles.)
  19. -overridedenied Anula los permisos denegados. Use una coma para separar
  20. permisos. (Use 'cm showpermissions' para mostrar
  21. los permisos disponibles.)
  22. objectspec Objeto sobre el que configurar los permisos.
  23. Este objeto puede ser uno de los siguientes:
  24. servidor de repositorios, repositorio, rama, etiqueta
  25. o atributo.
  26. (Use 'cm help objectspec' para más información sobre
  27. las especificaciones de objetos.)
  28. Uso especial para rutas seguras:
  29. cm acl [(--user=<usr_name> | --group=<group_name>)
  30. (-allowed|-denied|-overrideallowed|-overridedenied=+|-<permission>[,...])[,...]]
  31. [--delete] [--branches=[+ | -]<branch>[,...]]
  32. <spec>
  33. --delete Elimina una ruta segura.
  34. Consulte las Notas para más información.
  35. --branches Configura los permisos de una ruta segura a un grupo de
  36. ramas. Use una coma para separar las ramas.
  37. Opcionalmente, cada rama puede ir precedida de un signo
  38. + o - para especificar si la rama debe añadirse o
  39. eliminarse de la lista cuando se está editando.
  40. Consulte las Notas para más información.
  41. spec La ruta segura donde configurar los permisos.
  42. == CMD_HELP_ACL ==
  43. La configuración de permisos requiere entender cómo funciona la seguridad en
  44. Unity VCS. Lea la Guía de Seguridad para aprender cómo funcionan estos
  45. permisos:
  46. https://www.plasticscm.com/download/help/securityguide
  47. Notas:
  48. Este comando configura permisos para un usuario o un grupo en los objetos,
  49. repositorios, ramas, etiquetas o rutas de servidor especificados.
  50. Especificaciones de objeto:
  51. (Use 'cm help objectspec' para más información sobre las especificaciones
  52. de objetos.)
  53. El comando acl usa un tipo especial de especificación: rutas seguras.
  54. - Especificación de rutas seguras:
  55. path:server_path[#tag]
  56. Ejemplos: path:/src/foo.c
  57. path:/doc/pdf
  58. path:/doc/pdf#documents
  59. Acciones de permisos:
  60. Use -allowed y -denied para especificar qué permisos aplicar.
  61. Use los argumentos -overrideallowed y -overridedenied para especificar
  62. qué permisos se anulan.
  63. Cada acción requiere una lista de permisos separados por comas.
  64. Nombres de permisos:
  65. Cada nombre de permiso debe ir precedido del símbolo + o -.
  66. El símbolo + aplica el permiso y el símbolo - lo elimina.
  67. Para ver los permisos de un objeto use el comando 'cm showacl'.
  68. Permisos anulados:
  69. Anular un permiso usando --overrideallowed y --overridedenied permite
  70. evitar la herencia de permisos.
  71. Esto es útil para evitar los permisos aplicados a nivel de repositorio o
  72. de servidor.
  73. Por ejemplo:
  74. cm acl --user=vio -allowed=+ci -overrideallowed=+ci br:qa@test
  75. (Permite a la usuaria 'vio' hacer checkin en la rama 'qa' del
  76. repositorio 'test' incluso si ella tiene los permisos denegados a
  77. nivel de repositorio.)
  78. Permisos de rutas de servidor (rutas seguras):
  79. - Se pueden especificar permisos para una ruta de servidor dada.
  80. - Estos permisos se comprueban durante la operación de checkin.
  81. - Estos permisos también se pueden comprobar durante la operación de
  82. update y se pueden usar para evitar que ciertos directorios y ficheros
  83. se descarguen al espacio de trabajo.
  84. - Por cada ítem que se proteja (checkin), el servidor intenta concordar
  85. la ruta del ítem con una ruta segura. Si se encuentra, entonces la
  86. operación de checkin comprueba si el ítem tiene permisos para ser
  87. protegido (checked in).
  88. Los permisos que se pueden definir para una ruta segura son:
  89. ci, change, add, move, rm, read
  90. Si la comprobación de permisos no es satisfactoria para ninguno de los
  91. ítems involucrados, entonces la operación de checkin se revierte.
  92. Para aplicar permisos de rutas seguras a un grupo de ramas, use la
  93. opción --branches.
  94. Por ejemplo:
  95. cm acl --user=jo -denied=+ci path:/src#rule0 --branches=main,main/rel0
  96. Para editar el ACL asociado a una ruta segura, use el símbolo "#".
  97. Por ejemplo:
  98. cm acl --user=jo -denied=+rm path:/src#rule0
  99. (Sin "#", la lista de ramas tendría que especificarse de nuevo).
  100. La lista de ramas de una ruta segura se puede editar.
  101. Por ejemplo:
  102. cm acl path:/src#rule0 --branches=-main,+main/rel1
  103. (Elimina 'main' de la lista y añade 'main/rel1'.)
  104. Para eliminar una ruta segura, use el argumento --delete.
  105. Por ejemplo:
  106. cm acl --user=jo --delete path:/src#rule0
  107. Herencia:
  108. Herencia es una opción que proviene de los inicios de Plastic SCM 3.0.
  109. Es una opción avanzada pero también obsoleta.
  110. Permite a un objeto heredar los permisos de otro objeto anulando las
  111. relaciones de herencia por defecto.
  112. Use la opción -cut para cortar la cadena de herencia.
  113. Usd la opción -cutncpy para cortar y copiar los permisos heredados.
  114. (Esto está inspirado en los permisos de sistema de Windows donde se
  115. puede cortar herencia pero mantener los permisos actuales.)
  116. La opción -inherit permiter heredar de una especificación de objeto.
  117. Por ejemplo: '-inherit=object_spec'
  118. Ejemplos:
  119. cm acl --user=danipen -denied=+ci rep:core
  120. (Deniega el permiso de checkin al usuario 'danipen' en el repositorio 'core'.)
  121. cm acl --group=developers -allowed=+view,-read -denied=+chgperm br:main
  122. (Otorga el permiso 'view', elimina el permiso 'read' y deniega el permiso
  123. 'chgperm' al grupo 'developers' en la rama 'main'.)
  124. Ejemplos con rutas de servidor:
  125. cm acl --group=devs -denied=+ci path:/server#rel --branches=main,main/2.0
  126. (Deniega el permiso de checkin al grupo 'devs' para cualquier ruta que
  127. concuerde con '/server' en las ramas 'main' y 'main/2.0'. La etiqueta '#rel'
  128. se crea para poder referirse a ella más adelante.)
  129. cm acl path:/server#rel --branches=-/main,+/main/Rel2.1
  130. (Actualiza la ruta segura '/server' cuya etiqueta es 'rel', borrando la
  131. rama 'main' y añadiendo la rama 'main/Rel2.1' al grupo de ramas al que la
  132. ruta segura aplica. Teniendo en cuenta el ejemplo anterior, ahora la lista
  133. de ramas contendrá 'main/Rel2.1' y 'main/2.0'.)
  134. cm acl --user=vsanchezm -allowed=-read -overrideallowed=+read path:/doc
  135. (Eliminar el permiso de lectura 'read' a 'vsanchezm' anulándolo en la ruta
  136. '/doc'.)
  137. == CMD_DESCRIPTION_ACTIVATEUSER ==
  138. Activa un usuario con licencia.
  139. == CMD_USAGE_ACTIVATEUSER ==
  140. Sintaxis:
  141. cm activateuser | au <user-name>[ ...] [--server=<rep-server-spec>]
  142. user-name Nombre o nombres de usuario a activar. Use comillas dobles (" ")
  143. para especificar nombres de usuario que contengan espacios. Use
  144. un espacio en blanco para separar nombres de usuarios.
  145. Opciones:
  146. --server=<rep-server-spec> Activa al usuario en el servidor indicado.
  147. Si no se especifica ningún servidor, el comando
  148. se ejecuta en el servidor por defecto indicado
  149. en el fichero client.conf.
  150. (Use 'cm help objectspec' para más información
  151. sobre las especificaciones de servidores de
  152. repositorios.)
  153. == CMD_HELP_ACTIVATEUSER ==
  154. Notas:
  155. Para activar un usuario debe haber sido desactivado previamente.
  156. Por defecto, un usuario se activa por primera vez cuando lleva a cabo una
  157. operación de escritura en Unity VCS. El usuario se activa automáticamente
  158. si no se ha excedido el número máximo de usuarios.
  159. (Use 'cm help deactivateuser' para más información sobre desactivar usuarios
  160. en Unity VCS.)
  161. Examples:
  162. cm activateuser john
  163. cm activateuser david "mary collins"
  164. cm au peter --server=localhost:8087
  165. == CMD_DESCRIPTION_ADD ==
  166. Añade un ítem al control de versiones.
  167. == CMD_USAGE_ADD ==
  168. Sintaxis:
  169. cm add [-R | -r | --recursive] [--silent] [--ignorefailed]
  170. [--skipcontentcheck] [--coparent] [--filetypes=<file>] [--noinfo]
  171. [--format=<str-format>] [--errorformat=<str-format>]
  172. <item-path>[ ...]
  173. item-path Ítem o ítems a añadir. Use comillas dobles (" ") para especificar
  174. rutas que contengan espacios. Use un espacio en blanco para
  175. separar rutas de ítems.
  176. Use * para añadir todo el contenido del directorio actual.
  177. Opciones:
  178. -R|-r|--recursive Añade los ítems recursivamente.
  179. --silent No muestra ninguna salida.
  180. --ignorefailed Si un ítem no se puede añadir, la operación de add
  181. continuará sin él. Importante: si un directorio no se
  182. puede añadir, su contenido tampoco se añadirá.
  183. --skipcontentcheck Cuando la extensión no es suficiente para determinar si
  184. el fichero es de texto o binario, se asumirá que es
  185. binario en lugar de usar el contenido para detectar el
  186. tipo. Este funcionamiento se asume para aumentar el
  187. rendimiento en grandes operaciones de checkin.
  188. --coparent Hace checkout al padre del ítem que se va a añadir.
  189. --filetypes Fichero con los tipos de ficheros a usar. Consulte el
  190. siguiente enlace para más información:
  191. http://blog.plasticscm.com/2008/03/custom-file-types.html
  192. --noinfo No muestra información de progreso.
  193. --format Muestra el mensaje de salida con el formato indicado.
  194. Consulte los ejemplos para más información.
  195. --errorformat Muestra el mensaje de error (si existe) con el formato
  196. indicado. Consulte los ejemplos para más información.
  197. == CMD_HELP_ADD ==
  198. Notas:
  199. Requisitos para añadir ítems:
  200. - El directorio padre del ítem a añadir debe haber sido añadido previamente.
  201. Lectura desde stdin:
  202. El comando 'add' puede leer rutas desde stdin. Para ello, pase como
  203. argumento un guión "-".
  204. Por ejemplo: cm add -
  205. Las rutas se leerán hasta que se introduzca una línea en blanco.
  206. Este tipo de lectura permite usar una tubería (pipe) para especificar qué
  207. ficheros se van a añadir.
  208. Por ejemplo:
  209. dir /S /B *.c | cm add -
  210. (En Windows, añade todos los ficheros del workspace con extensión .c.)
  211. Ejemplos:
  212. cm add file1.txt file2.txt
  213. (Añade los ítems file1.txt y file2.txt.)
  214. cm add c:\workspace\file.txt
  215. (Añade el ítem file.txt en la ruta c:\workspace.)
  216. cm add -R c:\workspace\src
  217. (Añade recursivamente el contenido de la ruta src.)
  218. cm add -R *
  219. (Añade recursivamente todo el contenido del directorio actual.)
  220. cm add -R * --filetypes=filetypes.conf
  221. (Añade recursivamente todo el contenido del directorio actual usando el
  222. fichero 'filetypes.conf' para asignar un tipo a cada fichero basándose en su
  223. extensión en lugar de en el contenido.)
  224. cm add --coparent c:\workspace\dir\file.txt
  225. (Añade el fichero 'file.txt' y hace checkout a 'dir'.)
  226. cm add -R * --format="ADD {0}" --errorformat="ERR {0}"
  227. (Añade recursivamente todo el contenido del directorio actual y muestra por
  228. pantalla 'ADD <item>' para cada archivo añadido y 'ERR <item>' para cada
  229. archivo que no se pudo añadir.)
  230. == CMD_USAGE_ADDIGNOREPATTERN ==
  231. Uso:
  232. cm addignorepattern <pattern>[ ...]
  233. [--workspace=<wkpath> | --allworkspaces] [--remove]
  234. == CMD_DESCRIPTION_ADMIN ==
  235. Ejecuta comandos de administración en el servidor.
  236. == CMD_USAGE_ADMIN ==
  237. Sintaxis:
  238. cm admin <command> [options]
  239. Comandos:
  240. readonly
  241. Para obtener más información de cada uno de los comandos use lo siguiente:
  242. cm admin <command> --usage
  243. cm admin <command> --help
  244. == CMD_HELP_ADMIN ==
  245. Notas:
  246. Sólo el administrador del servidor puede ejecutar comandos de administración.
  247. Ejemplos:
  248. cm admin readonly enter
  249. cm admin readonly status
  250. == CMD_DESCRIPTION_ADMIN_READONLY ==
  251. Habilita/deshabilita el modo solo lectura del servidor.
  252. == CMD_USAGE_ADMIN_READONLY ==
  253. Sintaxis:
  254. cm admin readonly (enter | leave | status) [<server>]
  255. Acciones:
  256. enter Habilita el modo solo lectura en el servidor. Las operaciones de
  257. escritura se rechazan.
  258. leave Deshabilita el modo solo lectura en el servidor.
  259. status Muestra el estado del modo solo lectura en el servidor.
  260. Opciones:
  261. server Ejecuta el comando en el servidor indicado (servidor:puerto). (Use
  262. 'cm help objectspec' para más información sobre las especificaciones
  263. de servidor.)
  264. Si no se especifica ningún servidor, el comando actúa en el servidor
  265. del espacio de trabajo actual.
  266. Si la ruta actual no corresponde a un espacio de trabajo, el comando
  267. actúa sobre el servidor por defecto indicado en el fichero client.conf.
  268. == CMD_HELP_ADMIN_READONLY ==
  269. Notas:
  270. Solo el administrador del servidor puede configurarlo como solo lectura.
  271. Ejemplos:
  272. cm admin readonly enter diana:8086
  273. cm admin readonly leave
  274. == CMD_DESCRIPTION_ANNOTATE ==
  275. Muestra el changeset donde se modificó por última vez y por quién cada línea de
  276. un fichero.
  277. == CMD_USAGE_ANNOTATE ==
  278. Sintaxis:
  279. cm annotate | blame <spec>[ ...]
  280. [--format=<str_format>]
  281. [--comparisonmethod=(ignoreeol | ignorewhitespaces
  282. | ignoreeolandwhitespaces | recognizeall)]
  283. [--dateformat=<str_date_format>]
  284. [--encoding=<name>]
  285. [--stats]
  286. [--repository=<repspec>]
  287. spec Especificación del fichero que se va a anotar.
  288. (Use 'cm help objectspec' para obtener más información sobre
  289. especificaciones.)
  290. Use comillas dobles (" ") para especificar rutas que contengan
  291. espacios.
  292. Opciones:
  293. --format Muestra el mensaje de salida en el formato indicado.
  294. Consulte las Notas para más información.
  295. --comparisonmethod Configura el método de comparación indicado.
  296. Consulte las Notas para más información.
  297. --dateformat Configura el formato de salida para la impresión de fechas.
  298. --encoding Especifica el encoding que se usará en la salida, por
  299. ejemplo, utf-8. Consulte la documentación de MSDN en
  300. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  301. para obtener la tabla de codificaciones soportadas y su
  302. formato (al final de la página en la columna "Name").
  303. --stats Muestra estadísticas.
  304. --repository Especifica el repositorio a usar para calcular las
  305. anotaciones. Por defecto, se usa el repositorio del
  306. workspace cuya revisión está cargada. (Use
  307. 'cm help objectspec' para más información sobre las
  308. especificaciones de repositorio.)
  309. == CMD_HELP_ANNOTATE ==
  310. Notas:
  311. Los ítems de tipo binario no pueden ser anotados.
  312. Métodos de comparación (opción --comparisonmethod):
  313. ignoreeol Ignora diferencias en final de línea.
  314. ignorewhitespaces Ignora diferencias en espacios.
  315. ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios.
  316. recognizeall Detecta diferencias en final de línea y espacios.
  317. Parámetros de formato de salida (opción --format):
  318. Este comando acepta una cadena de formato para mostrar la salida.
  319. Los parámetros de salida de este comando son los siguientes:
  320. {owner} Usuario que hizo el último cambió en la línea.
  321. {rev} Especificación de la revisión de la línea.
  322. {content} Contenido de la línea.
  323. {date} Fecha de checkin de la línea.
  324. {comment} Comentario de la revisión de la línea.
  325. {changeset} Changeset de la revisión de la línea.
  326. {line} Número de línea del fichero.
  327. {id} Identificador del ítem.
  328. {parentid} Identificador del padre del ítem.
  329. {rep} Repositorio del ítem.
  330. {branch} Rama de la revisión de la línea.
  331. {ismergerev} Si la revisión de la línea se creó en un merge.
  332. --dateformat:
  333. Para especificar el formato en el que se escribirán las fechas en pantalla.
  334. Consulte los formatos soportados:
  335. https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
  336. --repository:
  337. Para devolver los datos de un repositorio remoto. Esto es útil cuando se
  338. trabaja con escenarios distribuidos.
  339. Ejemplos:
  340. cm blame c:\workspace\src --comparisonmethod=ignoreeolandwhitespaces --encoding=utf-8
  341. cm annotate c:\workspace\file.txt --comparisonmethod=ignoreeol
  342. cm annotate c:\workspace\file.txt --format="{owner} {date, 10} {content}"
  343. (Muestra el usuario que hizo el último cambio, un espacio, la fecha alineada
  344. a la derecha, un espacio y el contenido de la línea.)
  345. cm blame c:\workspace\file.txt --format="{owner, -7} {comment} {date}" \
  346. --dateformat=yyyyMMdd
  347. (Muestra en 7 espacios (y alineado a la izquierda) el usuario que hizo el
  348. último cambio, un espacio, el comentario seguido de otro espacio y la fecha
  349. formateada (por ejemplo, 20170329).)
  350. cm annotate c:\workspace\file.txt --repository=centralRep@myserver:8084
  351. cm blame serverpath:/src/client/checkin/Checkin.cs#cs:73666
  352. (Muestra las anotaciones del fichero (usando una especificacion de ruta de
  353. servidor) comenzando por el changeset 73666.)
  354. == CMD_DESCRIPTION_APPLYLOCAL ==
  355. Busca cambios locales (movidos localmente, borrados localmente y modificados
  356. localmente) y los aplica para que Unity VCS pueda monitorizarlos.
  357. == CMD_USAGE_APPLYLOCAL ==
  358. Sintaxis:
  359. cm applylocal | al [--dependencies] [<item_path>[ ...]]
  360. [--machinereadable [--startlineseparator=<sep>]
  361. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  362. Opciones:
  363. --dependencies Añade las dependencias de cambios locales a los ítems
  364. a aplicar.
  365. item_path Ítems a aplicar. Use comillas dobles (" ")
  366. para especificar rutas que contengan espacios. Use un
  367. espacio en blanco para separar rutas de ítems.
  368. --machinereadable Muestra el resultado en un formato fácil de parsear.
  369. --startlineseparator Usado con '--machinereadable', indica cómo deben
  370. empezar las líneas del resultado.
  371. --endlineseparator Usado con '--machinereadable', indica cómo deben
  372. terminar las líneas del resultado.
  373. --fieldseparator Usado con '--machinereadable', indica cómo deben
  374. separarse los campos de cada línea resultante.
  375. == CMD_HELP_APPLYLOCAL ==
  376. Notas:
  377. - Si no se especifican las opciones --dependencies y <item_path>, la operación
  378. involucra a todos los cambios locales en el espacio de trabajo.
  379. - Siempre se aplican recursivamente desde la ruta indicada.
  380. Ejemplos:
  381. cm applylocal foo.c bar.c
  382. cm applylocal .
  383. (Aplica todos los cambios locales del directorio actual.)
  384. cm applylocal
  385. (Aplica todos los cambios locales del espacio de trabajo.)
  386. cm applylocal --machinereadable
  387. (Aplica todos los cambios locales del espacio de trabajo y muestra por
  388. pantalla el resultado en un formato simple y fácil de parsear.)
  389. cm applylocal --machinereadable --startlineseparator=">" \
  390. --endlineseparator="<" --fieldseparator=","
  391. (Aplica todos los cambios locales del espacio de trabajo y muestra por
  392. pantalla el resultado en un formato simple y fácil de parsear, comenzando y
  393. terminando cada línea con los separadores indicados y separando los campos
  394. de cada línea con el separador también indicado.)
  395. == CMD_DESCRIPTION_ARCHIVE ==
  396. Almacena datos en almacenamiento externo.
  397. == CMD_USAGE_ARCHIVE ==
  398. Sintaxis:
  399. cm archive | arch <revspec>[ ...] [-c=<str_comment>]
  400. [--file=<base_file>]
  401. (Extrae datos del repositorio y los almacena en un almacenamiento externo.)
  402. cm archive | arch <revspec>[ ...] --restore
  403. (Restaura al repositorio datos previamente almacenados.)
  404. revspec Una o más especificaciones de revisión.(Use 'cm help objectspec'
  405. para más información sobre especificaciones de revisiones.)
  406. --restore Restaura desde los ficheros generados durante el almacenamiento
  407. los datos previamente almacenados. El almacenamiento externo y
  408. el fichero externaldata.conf tienen que estar disponibles en el
  409. momento de la restauración de la revisión. Consulte las Notas
  410. para más información.
  411. Opciones:
  412. -c Aplica un comentario en los ficheros de almacenamiento que
  413. se van a crear.
  414. --file Prefijo y ruta (opcional) de los nuevos ficheros de
  415. almacenamiento de datos.
  416. == CMD_HELP_ARCHIVE ==
  417. Notas:
  418. Este comando extrae datos del repositorio y los almacena en un almacenamiento
  419. externo, ahorrando así espacio en la base de datos.
  420. El comando también restaura (--restore) las revisiones que previamente
  421. fueron archivadas para volverlas a introducir en el repositorio.
  422. Use 'cm help objectspec' para saber más sobre especificaciones de revisiones.
  423. El usuario que ejecute este comando debe ser administrador del servidor
  424. de Unity VCS (propietario del servidor de repositorios) para que se le
  425. permita completar la operación.
  426. Cada segmento de datos de las revisiones especificadas se almacenará en
  427. un fichero diferente cuyo nombre comenzará por el texto definido en el
  428. argumento --file. Este argumento puede ser un path completo incluyendo un
  429. prefijo o únicamente el prefijo.
  430. Una vez archivados los datos de las revisiones, se podrá acceder a ellos
  431. de dos maneras:
  432. 1. Desde el cliente: El cliente de Unity VCS detectará si los datos fueron
  433. fueron archivados y pedirá al usuario que indique la ubicación de los
  434. ficheros.
  435. El usuario configurará las ubicaciones de almacenamiento externo en un
  436. fichero llamado externaldata.conf. El fichero se creará en las ubicaciones
  437. estándar donde se encuentran los ficheros de configuración y siguiendo las
  438. mismas reglas que se aplican para el fichero client.conf. El fichero
  439. externaldata.conf contendrá las rutas en los que se encuentren los datos
  440. archivados.
  441. 2. Desde el servidor: Con este método, los usuarios no tienen que saber si
  442. los datos han sido archivados o no ya que las peticiones se resuelven de
  443. forma transparente por el servidor. Para ello, el administrador creará un
  444. fichero llamado externaldata.conf en el directorio del servidor e
  445. introducirá las rutas donde se archivaron los datos.
  446. Para restaurar (restore) los datos de una revisión (o conjunto de
  447. revisiones), el cliente tiene que poder acceder a los ficheros donde los
  448. datos se almacenaron. Por tanto, no es posible restaurar datos que estén
  449. siendo resueltos por el servidor (método 2) porque el cliente no podrá
  450. identificarlos como archivados.
  451. Para restaurar usando el método 2, el administrador tiene que editar el
  452. fichero externaldata.conf en el servidor para eliminar el acceso a los
  453. ficheros archivados para que puedan ser restaurados.
  454. Ejemplo para archivar:
  455. 1) Archivar una revisión:
  456. cm archive Assets/RoofTextures/Textures/Wooden_Roof_05.png --file=/Users/ruben/archive/battle
  457. 2) Es posible comprobar la revisión archivada en la ruta especificada:
  458. ls -al /Users/ruben/archive/battle*
  459. -rw-r--r-- 1 ruben staff 2220039 Nov 9 10:52 /Users/ruben/archive/battle-100280-167
  460. Ejemplo para restaurar:
  461. 1) Añadir la ruta de almacenamiento al fichero externaldata.conf:
  462. vi /Users/ruben/.plastic4/externaldata.conf
  463. /Users/ruben/archive
  464. 2) Restaurar la revisión:
  465. cm archive Assets/RoofTextures/Textures/Wooden_Roof_05.png --restore
  466. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  467. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  468. configurada pero no se indica ningún comentario, el editor se abrirá para
  469. que pueda escribir el comentario.
  470. Lectura desde stdin:
  471. El comando 'archive' puede leer rutas desde stdin. Para ello, pase como
  472. argumento un guión "-".
  473. Por ejemplo: cm archive -
  474. Las rutas se leerán hasta que se introduzca una línea en blanco.
  475. Este tipo de lectura permite usar una tubería (pipe) para especificar qué
  476. ficheros se van a almacenar (archive).
  477. Por ejemplo:
  478. dir /S /B *.c | cm archive --all -
  479. (En Windows, almacena (archive) todos los ficheros del workspace con
  480. extensión .c.)
  481. Ejemplos:
  482. cm archive bigfile.zip#br:/main
  483. (Almacena la última revisión de 'bigfile.zip' en la rama 'main'.)
  484. cm archive bigfile.zip#br:/main --restore
  485. (Restaura la revisión almacenada.)
  486. cm archive rev:myfile.pdf#cs:2 -c="big pdf file" --file=c:\arch_files\arch
  487. (Archiva la revisión del changeset 2 de myfile.pdf en la carpeta
  488. 'c:\archived_files'. El nombre del fichero de almacenamiento comenzará con
  489. 'arch' (por ejemplo, arch_11_56).)
  490. cm find "revs where size > 26214400" --format="{item}#{branch}" \
  491. --nototal | cm archive -c="volume00" --file="volume00" -
  492. (Archiva todos los ficheros de tamaño mayor de 25Mb en ficheros de
  493. almacenamiento cuyo nombre empiece por 'volume00'.)
  494. == CMD_DESCRIPTION_ATTRIBUTE ==
  495. Permite al usuario administrar atributos.
  496. == CMD_USAGE_ATTRIBUTE ==
  497. Sintaxis:
  498. cm attribute | att <command> [options]
  499. Comandos:
  500. create | mk
  501. delete | rm
  502. set
  503. unset
  504. rename
  505. edit
  506. Para obtener más información de cada uno de los comandos use lo siguiente:
  507. cm attribute <command> --usage
  508. cm attribute <command> --help
  509. == CMD_HELP_ATTRIBUTE ==
  510. Ejemplos:
  511. cm attribute create status
  512. cm attribute set att:status br:/main/SCM105 open
  513. cm attribute unset att:status br:/main/SCM105
  514. cm attribute delete att:status
  515. cm attribute rename att:status "buildStatus"
  516. cm attribute edit att:status "Status of the task in the CI pipeline"
  517. == CMD_DESCRIPTION_CHANGELIST ==
  518. Agrupa los cambios pendientes en listas de cambios (changelists).
  519. == CMD_USAGE_CHANGELIST ==
  520. Sintaxis:
  521. a) Manejo de los objetos 'changelist':
  522. cm changelist | clist [--symlink]
  523. (Muestra todas las listas de cambios.)
  524. cm changelist | clist create <clist_name>
  525. [<clist_desc>] [--persistent | --notpersistent] [--symlink]
  526. (Crea una lista de cambios.)
  527. cm changelist | clist delete <clist_name> [--symlink]
  528. (Borra la lista de cambios indicada. Si dicha lista contiene cambios
  529. pendientes, estos se moverán a lista de cambios 'default'.)
  530. cm changelist | clist edit <clist_name> [<action_name> <action_value>]
  531. [--persistent | --notpersistent] [--symlink]
  532. (Edita la lista de cambios indicada.)
  533. b) Manejo del contenido de un 'changelist':
  534. cm changelist | clist <clist_name> (add | rm) <path_name>[ ...]
  535. [--symlink]
  536. (Edita la lista de cambios indicada y añade (add) o quita (rm) los cambios
  537. que concuerden con la ruta especificada. Use un espacio en blanco para
  538. separar rutas. Use comillas dobles (" ") para especificar rutas que
  539. contengan espacios. El estado de las rutas debe ser 'Added' o
  540. 'Checked-out'.)
  541. Opciones:
  542. clist_name El nombre de la lista de cambios (changelist). Se puede
  543. usar la ruta a un archivo que contenga el nombre en su
  544. lugar. Más información en --namefile.
  545. clist_desc La descripción de la lista de cambios. Se puede usar la
  546. ruta a un archivo que contenga el nombre en su lugar.
  547. Más información en --descriptionfile.
  548. action_name Seleccione 'rename' o 'description' para modificar un
  549. changelist.
  550. action_value Aplica el nuevo cambio o la nueva descripción al editar
  551. la lista de cambios.
  552. --persistent La lista de cambios permanecerá en el espacio de trabajo
  553. aun cuando los cambios en ella se hayan protegido
  554. (checked-in) o deshecho.
  555. --notpersistent (Por defecto.) La lista de cambios no permanecerá en el
  556. espacio de trabajo cuando los cambios en ella se protejan
  557. (checked-in) o se deshagan.
  558. --symlink Aplica la operación al symlink pero no al destino
  559. (target).
  560. --namefile Una ruta válida al archivo que contiene el nombre de la
  561. lista de cambios. El archivo debe existir en esa ruta, debe
  562. contener algo de texto y no puede contener saltos de línea.
  563. --newnamefile Una ruta válida al archivo que contiene el nuevo nombre de
  564. la lista de cambios cuando se edita para renombrar. El
  565. archivo debe existir en esa ruta, debe de contener algo de
  566. texto y no puede contener saltos de línea.
  567. --descriptionfile Una ruta válida al archivo que contiene la descripción deseada
  568. para la lista de cambios. El archivo debe existir en esa ruta.
  569. == CMD_HELP_CHANGELIST ==
  570. Notas:
  571. El comando 'changelist' gestiona tanto las listas de cambios pendientes del
  572. espacio de trabajo como los cambios dentro de la lista.
  573. Ejemplos:
  574. cm changelist
  575. (Muestra las listas de cambios del espacio de trabajo actual.)
  576. cm changelist create config_changes "dotConf files" --persistent
  577. (Crea una nueva lista de cambios llamada 'config_changes' con descripción
  578. 'dotConf files' que permanecerá en el espacio de trabajo después de que sus
  579. cambios se hayan protegido (checked-in) o deshecho.)
  580. cm changelist create --namefile="name.txt" --descriptionfile="desc.txt"
  581. (Crea una nueva lista de cambios cuyo nombre y descripción son tomados de
  582. archivos.)
  583. cm changelist edit config_changes rename config_files --notpersistent
  584. (Edita la lista de cambios 'config_changes' renombrándola a 'config_files'
  585. y haciéndola no persistente.)
  586. cm changelist edit config_changes --notpersistent
  587. (Edita la lista de cambios 'config_changes' haciéndola no persistente.)
  588. cm changelist delete config_files
  589. (Elimina la lista de cambios 'config_files' del espacio de trabajo actual.)
  590. cm changelist delete --namefile="name.txt"
  591. (Elimina la lista de cambios identificada por el nombre contenido en 'name.txt'
  592. del espacio de trabajo actual.)
  593. cm changelist config_files add foo.conf
  594. (Añade el fichero 'foo.conf' a la lista de cambios 'config_files'.)
  595. cm changelist config_files rm foo.conf readme.txt
  596. (Elimina los ficheros 'foo.conf' y 'readme.txt' de la lista de cambios
  597. 'config_files' y los mueve la lista de cambios por defecto del sistema.)
  598. cm changelist edit --namefile="name.txt" description --descriptionfile="desc.txt"
  599. (Edita la lista de cambios identificada por el nombre contenido en 'name.txt', cambiando
  600. su descripción por el contenido del archivo 'desc.txt'.)
  601. cm changelist edit --namefile="name.txt" rename --newnamefile="newname.txt"
  602. (Edita la lista de cambios identificada por el nombre contenido en 'name.txt' file,
  603. renombrándola por el contenido del archivo 'newname.txt'.)
  604. == CMD_DESCRIPTION_CHANGESET ==
  605. Ejecuta operaciones avanzadas sobre changesets.
  606. == CMD_USAGE_CHANGESET ==
  607. Sintaxis:
  608. cm changeset <command> [options]
  609. Comandos:
  610. move | mv
  611. delete | rm
  612. editcomment | edit
  613. Para obtener más información de cada uno de los comandos use lo siguiente:
  614. cm changeset <command> --usage
  615. cm changeset <command> --help
  616. == CMD_HELP_CHANGESET ==
  617. Ejemplos:
  618. cm changeset move cs:15@myrepo br:/main/scm005@myrepo
  619. cm changeset delete cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
  620. == CMD_DESCRIPTION_CHANGESET_EDITCOMMENT ==
  621. Modifica el comentario de un changeset.
  622. == CMD_USAGE_CHANGESET_EDITCOMMENT ==
  623. Sintaxis:
  624. cm changeset editcomment | edit <csetspec> <new_comment>
  625. Opciones:
  626. csetspec El changeset cuyo comentario se va a editar. (Use
  627. 'cm help objectspec' para más información sobre
  628. especificaciones de changesets.)
  629. new_comment El nuevo comentario que se aplicará al changeset indicado.
  630. == CMD_HELP_CHANGESET_EDITCOMMENT ==
  631. Notas:
  632. - La especificación del changeset debe ser válida.
  633. Ejemplos:
  634. cm changeset editcomment cs:15@myrepo "I forgot to add the checkin details"
  635. cm changeset edit cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
  636. "This comment text will replace the previous one."
  637. cm changeset edit "89095131-895d-4173-9440-ff9ef9b2538d@project@cloud" \
  638. "Changing my comment"
  639. == CMD_DESCRIPTION_CHANGESET_MOVE ==
  640. Mueve un changeset y todos sus descendientes a otra rama.
  641. == CMD_USAGE_CHANGESET_MOVE ==
  642. Sintaxis:
  643. cm changeset move | mv <csetspec> <branchspec>
  644. Opciones:
  645. csetspec El primer changeset que debe moverse a una rama
  646. diferente. Todos los changeset descendientes en la
  647. misma rama se moverán también.
  648. (Use 'cm help objectspec' para más información sobre
  649. especificaciones de changesets.)
  650. branchspec La rama destino a la que mover los changesets
  651. seleccionados. Debe estar vacía o no existir. En caso
  652. de no existir, el comando la creará.
  653. (Use 'cm help objectspec' para más información sobre
  654. especificaciones de ramas.)
  655. == CMD_HELP_CHANGESET_MOVE ==
  656. Notas:
  657. - La especificación del changeset debe ser válida.
  658. - La rama de destino debe estar vacía o no existir.
  659. - Si la rama de destino no existe, el comando la creará.
  660. - Los enlaces de merge no se verán afectados dado que las ramas no están
  661. involucradas en ellos.
  662. Ejemplos:
  663. cm changeset move cs:15@myrepo br:/main/scm005@myrepo
  664. cm changeset move cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a br:/hotfix/TL-352
  665. == CMD_DESCRIPTION_CHANGESET_DELETE ==
  666. Elimina un changeset del repositorio.
  667. == CMD_USAGE_CHANGESET_DELETE ==
  668. Sintaxis:
  669. cm changeset delete | rm <csetspec>
  670. Opciones:
  671. csetspec El changeset a eliminar. Debe cumplir con una serie de
  672. condiciones. Consulte las Notas para más información.
  673. (Use 'cm help objectspec' para más información sobre
  674. especificaciones de changesets.)
  675. == CMD_HELP_CHANGESET_DELETE ==
  676. Notas:
  677. - El changeset debe ser el último en su rama.
  678. - El changeset no puede ser el padre de otro changeset.
  679. - El changeset no debe ser origen de un merge ni formar parte de un intervalo
  680. de merge.
  681. - El changeset no tiene que tener ninguna etiqueta.
  682. - El changeset no puede ser el changeset raíz (cs:0).
  683. Ejemplos:
  684. cm changeset rm cs:4525@myrepo@myserver
  685. cm changeset delete cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
  686. == CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
  687. Cambia el password del usuario (UP).
  688. == CMD_USAGE_CHANGEUSERPASSWORD ==
  689. Sintaxis:
  690. cm changepassword | passwd
  691. == CMD_HELP_CHANGEUSERPASSWORD ==
  692. Notas:
  693. Este comando está disponible solo si la configuración de seguridad es UP
  694. (user/password).
  695. Lea la Guía del Administrador para más información:
  696. https://www.plasticscm.com/download/help/adminguide
  697. Las contraseñas antigua y nueva son obligatorias.
  698. Ejemplo:
  699. cm passwd
  700. == CMD_DESCRIPTION_CHECKCONNECTION ==
  701. Comprueba la conexión con el servidor.
  702. == CMD_USAGE_CHECKCONNECTION ==
  703. Sintaxis:
  704. cm checkconnection | cc
  705. == CMD_HELP_CHECKCONNECTION ==
  706. Notas:
  707. - Este comando devuelve un mensaje indicando si existe una conexión válida
  708. con el servidor de Unity VCS configurado.
  709. - El comando comprueba la compatibilidad de versiones con el servidor.
  710. - El comando también comprueba si el usuario configurado es válido o no.
  711. == CMD_DESCRIPTION_CHECKDB ==
  712. Comprueba la integridad de los repositorios.
  713. == CMD_USAGE_CHECKDB ==
  714. Sintaxis:
  715. cm checkdatabase | chkdb [<repserverspec> | <repspec>]
  716. Options:
  717. repserverspec Servidor de repositorios.
  718. repspec Repositorio.
  719. (Use 'cm help objectspec' para más información sobre especificaciones de
  720. servidor de repositorios y repositorio..)
  721. == CMD_HELP_CHECKDB ==
  722. Notas:
  723. - Si no se indica ninguna especificación (de servidor de repositorios o de
  724. repositorio), la comprobación se hará sobre el servidor indicado en el
  725. fichero client.conf.
  726. Ejemplos:
  727. cm checkdatabase repserver:localhost:8084
  728. cm chkdb rep:default@localhost:8084
  729. == CMD_DESCRIPTION_CHECKIN ==
  730. Guarda (protege) los cambios en el repositorio.
  731. == CMD_USAGE_CHECKIN ==
  732. Sintaxis:
  733. cm checkin | ci [<item_path>[ ...]]
  734. [-c=<comentario> | -commentsfile=<fichero_comentario>]
  735. [--all|-a] [--applychanged] [--private] [--update] [--symlink]
  736. [--noshowchangeset]
  737. [--machinereadable [--startlineseparator=<sep>]
  738. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  739. Opciones:
  740. item_path Ítems a guardar (checkin). Use comillas dobles (" ")
  741. para especificar rutas que contengan espacios. Use un
  742. espacio en blanco para separar rutas de ítems.
  743. Use . para hacer checkin al directorio actual.
  744. -c Asigna el comentario indicado al changeset que se crea
  745. en el checkin.
  746. -commentsfile Asigna el comentario especificado en el fichero al
  747. changeset que se crea en el checkin.
  748. --all | -a Incluye en el checkin los ítems de las rutas indicadas
  749. que han sido cambiados, movidos y borrados localmente.
  750. --applychanged Incluye en el checkin los ítems cambiados y los
  751. desprotegidos (checked-out).
  752. --private Incluye en el checkin los ítems privados.
  753. --update Procesa automáticamente un update-merge si fuera
  754. necesario.
  755. --symlink Incluye en el checkin al symlink pero no al destino
  756. (target).
  757. --noshowchangeset No muestra el changeset resultante.
  758. --machinereadable Muestra el resultado en un formato fácil de parsear.
  759. --startlineseparator Usado con '--machinereadable', indica cómo deben
  760. empezar las líneas del resultado.
  761. --endlineseparator Usado con '--machinereadable', indica cómo deben
  762. terminar las líneas del resultado.
  763. --fieldseparator Usado con '--machinereadable', indica cómo deben
  764. separarse los campos de cada línea resultante.
  765. == CMD_HELP_CHECKIN ==
  766. Notas:
  767. - Si no se especifica ningún <item_path>, el checkin afecta a todos los
  768. cambios pendientes en el workspace.
  769. - El checkin siempre se aplica recursivamente desde la ruta especificada.
  770. - Para proteger (checkin) un ítem:
  771. - El ítem tiene que estar controlado (checked-in).
  772. - Si el ítem es privado (no está controlado), es necesario indicar el
  773. argumento --private para poder protegerlo (checkin).
  774. - El ítem tiene que estar desprotegido (checked-out).
  775. - Si el ítem ha cambiado pero no está desprotegido (no checked-out), no es
  776. necesario indicar el argumento --applychanged a no ser que <item_path>
  777. sea un directorio o contenga wildcards ('*').
  778. El contenido de la revisión a proteger (checkin) debería ser diferente de la
  779. revisión anterior.
  780. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  781. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  782. configurada pero no se indica ningún comentario, el editor se abrirá para
  783. que pueda escribir el comentario.
  784. Lectura desde stdin:
  785. El comando 'checkin' puede leer rutas desde stdin. Para ello, pase como
  786. argumento un guión "-".
  787. Por ejemplo: cm checkin -
  788. Las rutas se leerán hasta que se introduzca una línea en blanco.
  789. Este tipo de lectura permite usar una tubería (pipe) para especificar qué
  790. ficheros se van a proteger (checkin).
  791. Por ejemplo:
  792. dir /S /B *.c | cm checkin --all -
  793. (En Windows, protege (checkin) todos los ficheros del workspace con
  794. extensión .c.)
  795. Ejemplos:
  796. cm checkin file1.txt file2.txt
  797. (Protege (checkin) los ficheros desprotegidos (checked-out) 'file1.txt' y
  798. 'file2.txt'.)
  799. cm checkin . -commentsfile=micomentario.txt
  800. (Protege (checkin) el directorio actual y aplica el comentario incluido en
  801. el fichero 'mycomment.txt'.)
  802. cm checkin link --symlink
  803. (Protege (checkin) el fichero symlink y no el destino (target).)
  804. cm ci file1.txt -c="my comment"
  805. (Protege (checkin) el fichero 'file1.txt' y aplica el comentario.)
  806. cm status --short --compact --changelist=pending_to_review | cm checkin -
  807. (Obtiene los ítems de la lista de cambios (changelist) 'pending_to_review' y
  808. las redirecciona como entrada al comando checkin para protegerlos.)
  809. cm ci . --machinereadable
  810. (Protege (checkin) el directorio actual y muestra por pantalla el resultado
  811. en un formato simple y fácil de parsear.)
  812. cm ci . --machinereadable --startlineseparator=">" --endlineseparator="<" --fieldseparator=","
  813. (Protege (checkin) el directorio actual y muestra por pantalla el resultado
  814. en un formato simple y fácil de parsear, comenzando y terminando cada línea
  815. con los separadores indicados y separando los campos de cada línea con el
  816. separador también indicado.)
  817. == CMD_DESCRIPTION_CHECKOUT ==
  818. Marca los ficheros para ser modificados (desprotege).
  819. == CMD_USAGE_CHECKOUT ==
  820. Sintaxis:
  821. cm checkout | co [<item_path>[ ...]] [-R | -r | --recursive]
  822. [--format=<str_format>]
  823. [--errorformat=<str_format>] [--resultformat=<str_format>]
  824. [--silent] [--symlink] [--ignorefailed]
  825. [--machinereadable [--startlineseparator=<sep>]
  826. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  827. Opciones:
  828. item_path Ítems a desproteger (checkout). Use comillas dobles (" ")
  829. para especificar rutas que contengan espacios. Use un
  830. espacio en blanco para separar rutas de ítems.
  831. Use . para hacer checkout al directorio actual.
  832. -R Desprotege (checkout) los ficheros recursivamente.
  833. --format Muestra el progreso en la salida con el formato
  834. indicado. Consulte los ejemplos para más información.
  835. --resultformat Muestra el resultado en la salida con el formato
  836. indicado. Consulte los ejemplos para más información.
  837. --silent No muestra nada en la salida.
  838. --symlink Incluye en el checkout al symlink pero no al destino
  839. (target).
  840. --ignorefailed Si no se puede hacer un checkout exclusivo (bloqueo)
  841. de un ítem, el checkout continuará sin él.
  842. --machinereadable Muestra el resultado en un formato fácil de parsear.
  843. --startlineseparator Usado con '--machinereadable', indica cómo deben
  844. empezar las líneas del resultado.
  845. --endlineseparator Usado con '--machinereadable', indica cómo deben
  846. terminar las líneas del resultado.
  847. --fieldseparator Usado con '--machinereadable', indica cómo deben
  848. separarse los campos de cada línea resultante.
  849. == CMD_HELP_CHECKOUT ==
  850. Notas:
  851. Para desproteger (checkout) un ítem:
  852. - El ítem tiene que estar controlado (bajo control de versiones)
  853. - El ítem debe estar protegido (checked-in).
  854. Si los bloqueos están configurados en el servidor (existe el fichero
  855. lock.conf), cada vez que se produza un checkout en un ítem, Unity VCS
  856. comprueba si se cumple alguna de las reglas de bloqueo. Si se cumple, el
  857. ítem se bloqueará (checkout exclusivo) y nadie podrá hacer otro checkout.
  858. Para conocer los bloqueos que existen en cualquier momento en el servidor
  859. usa el comando 'cm lock list'.
  860. Lea la Guía del Administrador para más información:
  861. https://www.plasticscm.com/download/help/adminguide
  862. El texto en el argumento --format reemplaza a la variable '{0}' del ítem que
  863. se va a desproteger (checkout). Consulte los ejemplos para más información.
  864. Lectura desde stdin:
  865. El comando 'checkout' puede leer rutas desde stdin. Para ello, pase como
  866. argumento un guión "-".
  867. Por ejemplo: cm checkout -
  868. Las rutas se leerán hasta que se introduzca una línea en blanco.
  869. Este tipo de lectura permite usar una tubería (pipe) para especificar qué
  870. ficheros se van a desproteger (checkout).
  871. Por ejemplo:
  872. dir /S /B *.c | cm checkout --all -
  873. (En Windows, desprotege (checkout) todos los ficheros del workspace con
  874. extensión .c.)
  875. Ejemplos:
  876. cm checkout file1.txt file2.txt
  877. (Desprotege (checkout) los ficheros 'file1.txt' y 'file2.txt'.)
  878. cm co *.txt
  879. (Desprotege (checkout) todos los ficheros con extensión .txt.)
  880. cm checkout .
  881. (Desprotege (checkout) el directorio actual.)
  882. cm checkout -R c:\workspace\src
  883. (Desprotege (checkout) recursivamente el contenido de la carpte 'src'.)
  884. cm co file.txt --format="Checking out item {0}"
  885. --resultformat="Item {0} checked out"
  886. (Desprotege (checkout) el fichero 'file.txt' y usa un formato determinado
  887. para mostrar el progreso de la operación y el resultado.)
  888. cm checkout link --symlink
  889. (Desprotege (checkout) el fichero symlink y no el destino (target).)
  890. cm checkout . -R --ignorefailed
  891. (Desprotege (checkou) recursivamente el directorio actual ignorando aquellos
  892. ficheros que no se pueden desproteger.)
  893. cm co . --machinereadable --startlineseparator=">"
  894. (Desprotege (checkout) el directorio actual y muestra por pantalla el
  895. resultado en un formato simple y fácil de parsear, comenzando cada línea con
  896. el separador indicado.)
  897. == CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
  898. Comprueba la sintaxis de un selector.
  899. == CMD_USAGE_CHECKSELECTORSYNTAX ==
  900. Sintaxis:
  901. cm checkselectorsyntax | css --file=<selector_file>
  902. (Comprueba la sintaxis del fichero del selector.)
  903. cat <selector_file> | cm checkselectorsyntax | css -
  904. (Unix. Comprueba el fichero del selector desde la entrada estándar.)
  905. type <selector_file> | cm checkselectorsyntax | css -
  906. (Windows. Comprueba el fichero del selector desde la entrada estándar.)
  907. --file Fichero desde el que leer el selector.
  908. == CMD_HELP_CHECKSELECTORSYNTAX ==
  909. Notas:
  910. Este comando lee el selector tanto de un fichero o de la entrada estándar, y
  911. comprueba su sintaxis. Si esta comprobación falla, los motivos de este fallo
  912. se mostrarán por la salida estándar.
  913. Ejemplos:
  914. cm checkselectorsyntax --file=myselector.txt
  915. (Comprueba la sintaxis del fichero 'myselector.txt'.)
  916. cat myselector.txt | cm checkselectorsyntax
  917. (Comprueba la sintaxis del fichero 'myselector.txt' desde la entrada estándar.)
  918. == CMD_DESCRIPTION_CHANGEREVISIONTYPE ==
  919. Cambia el tipo de revisión (binario o texto) de un ítem.
  920. == CMD_USAGE_CHANGEREVISIONTYPE ==
  921. Sintaxis:
  922. cm changerevisiontype | chgrevtype | crt <item_path>[ ...] --type=(bin | txt)
  923. item_path Ítems a los que cambiar el tipo de revisión. Use comillas
  924. dobles (" ") para especificar rutas que contengan
  925. espacios. Use un espacio en blanco para separar rutas de
  926. ítems.
  927. --type Tipo de revisión: 'bin' (binario) o 'txt' (texto).
  928. == CMD_HELP_CHANGEREVISIONTYPE ==
  929. Notas:
  930. Este comando solo se puede aplicar a ficheros y no a directorios.
  931. El tipo especificado debe ser uno de los soportados por el sistema: 'bin'
  932. (binario) o 'txt' (texto).
  933. Ejemplos:
  934. cm changerevisiontype c:\workspace\file.txt --type=txt
  935. (Cambia el tipo de revisión del fichero 'file.txt' a texto.)
  936. cm chgrevtype comp.zip "image file.jpg" --type=bin
  937. (Cambia el tipo de revisión de los ficheros 'comp.zip' e 'image file.jpg' a
  938. binario.)
  939. cm crt *.* --type=txt
  940. (Cambia el tipo de revisión de todos los ficheros a texto.)
  941. == CMD_DESCRIPTION_TRIGGER_EDIT ==
  942. Edita un trigger.
  943. == CMD_USAGE_TRIGGER_EDIT ==
  944. Sintaxis:
  945. cm trigger | tr edit <subtype_type> <position_number>
  946. [--position=<new_position>]
  947. [--name=<new_name>] [--script=<script_path>]
  948. [--filter=<str_filter>] [--server=<repserverspec>]
  949. subtype_type Ejecución y operación del trigger.
  950. (Use 'cm showtriggertypes' para ver la lista de tipos de
  951. triggers.)
  952. position_number Posición que ocupa el trigger que se va a modificar.
  953. Opciones:
  954. --position Nueva posición del trigger a modificar.
  955. Esta posición no debe estar en uso por otro trigger del
  956. mismo tipo.
  957. --name Nuevo nombre del trigger a modificar.
  958. --script Nueva ruta de ejecución del script del trigger a modificar.
  959. Si el script comienza con "webtrigger ", el trigger se
  960. considerará como trigger de tipo web. Consulte las Notas
  961. para más información.
  962. --filter Comprueba solo los ítems que cumplen con el filtro
  963. indicado.
  964. --server Modifica el trigger del servidor indicado.
  965. Si no se especifica ningún trigger, entonces el comando
  966. se ejecuta en el servidor configurado en el cliente.
  967. (Use 'cm help objectspec' para más información sobre
  968. especificaciones de servidor.)
  969. == CMD_HELP_TRIGGER_EDIT ==
  970. Notas:
  971. Web triggers: Un trigger web se crea escribiendo "webtrigger <target-uri>"
  972. como comando del trigger. En este caso, el trigger ejecutará una consulta
  973. POST contra el URI especificado en la que el cuerpo de la petición
  974. contiene un diccionario JSON con las variables de entorno del trigger y una
  975. clave INPUT apuntando a un vector de cadenas de texto .
  976. Ejemplos:
  977. cm trigger edit after-setselector 6 --name="Backup2 manager" --script="/new/path/al/script"
  978. cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
  979. cm trigger edit after-add 2 --script="webtrigger http://myserver.org/api"
  980. == CMD_DESCRIPTION_CODEREVIEW ==
  981. Crea, edita o elimina revisiones de código.
  982. == CMD_USAGE_CODEREVIEW ==
  983. Sintaxis:
  984. cm codereview <spec> <title> [--status=<status_name>]
  985. [--assignee=<user_name>] [--format=<str_format>]
  986. [--repository=<rep_spec>]
  987. (Crea una revisión de código.)
  988. cm codereview -e <id> [--status=<status_name>] [--assignee=<user_name>]
  989. [--repository=<rep_spec>]
  990. (Edita una revisión de código.)
  991. cm codereview -d <id> [ ...] [--repository=<rep_spec>]
  992. (Borra una o más revisiones de código.)
  993. spec Puede ser una especificación de changeset, una especificación de
  994. shelve o una especificación de rama. Creará la nueva revisión de
  995. código de dicha especificación. (Use 'cm help objectspec' para más
  996. información sobre especificaciones de changeset o rama.)
  997. title Cadena de texto que se usará como título de la revisión de
  998. código.
  999. id Número de identificación de la revisión de código. También se
  1000. puede usar un GUID.
  1001. Opciones:
  1002. -e Edita los parámetros de una revisión de código.
  1003. -d Elimina una o más revisiones de código. Use un espacio en
  1004. blanco para separar los identificadores de las revisiones de
  1005. código.
  1006. --status Aplica el nuevo estado a la revisión de código. Consulte las
  1007. Notas para más información.
  1008. --assignee Aplica el nuevo usuario asignado a la revisión de código.
  1009. --format Muestra el mensaje de salida con el formato indicado.
  1010. Consulte las Notas para más información.
  1011. --repository Indica el repositorio que se utilizará por defecto. (Use
  1012. 'cm help objectspec' para más información sobre
  1013. especificaciones de repositorio.)
  1014. == CMD_HELP_CODEREVIEW ==
  1015. Notas:
  1016. Este comando permite a los usuarios gestionar revisiones de código: crear,
  1017. editar y eliminar revisiones de código de changesets o ramas.
  1018. Para crear una nueva revisión de código se requiere una especificación de
  1019. changeset o rama además de un título. También se puede indicar el estado
  1020. inicial y el usuario asignado como revisor de los cambios.
  1021. Como resultado se devolverá el identificador ID (o GUID).
  1022. Para editar o eliminar una revisión de código existente debe indicar el ID
  1023. (o GUID) de la misma. No se mostrarán mensajes si no ha habido errores.
  1024. El parámetro 'status' debe tener uno de los siguientes valores:
  1025. 'Under review' (valor por defecto), 'Reviewed' o 'Rework required'.
  1026. El parámetro 'repository' sirve para especificar el repositorio por defecto.
  1027. Esto es útil cuando el usuario quiere gestionar revisiones de código de un
  1028. servidor diferente del asociado al espacio de trabajo actual o cuando no
  1029. existe un espacio de trabajo.
  1030. Parámetros de formato de salida (opción --format):
  1031. Este comando acepta una cadena de formato para mostrar la salida.
  1032. Los parámetros de salida de este comando son los siguientes:
  1033. {0} id
  1034. {1} guid
  1035. Tenga en cuenta que el parámetro --format solo tiene efecto al crear una
  1036. nueva revisión de código.
  1037. Ejemplos:
  1038. cm codereview cs:1856@myrepo@myserver:8084 "My code review" --assignee=dummy
  1039. cm codereview br:/main/task001@myrepo@myserver:8084 "My code review" \
  1040. --status="Rework required" --assignee=newbie --format="{id} -> {guid}"
  1041. cm codereview 1367 -e --assignee=new_assignee
  1042. cm codereview -e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --status=Reviewed
  1043. cm codereview -d 1367 --repository=myremoterepo@myremoteserver:18084
  1044. cm codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -d
  1045. == CMD_DESCRIPTION_CRYPT ==
  1046. Encripta una contraseña.
  1047. == CMD_USAGE_CRYPT ==
  1048. Sintaxis:
  1049. cm crypt <mypassword>
  1050. mypassword Contraseña que se va a encriptar.
  1051. == CMD_HELP_CRYPT ==
  1052. Notas:
  1053. Este comando encripta la contraseña que se pasa como argumento.
  1054. Está diseñado para encriptar las contraseñas de los ficheros de
  1055. configuración y aumentar así su seguridad.
  1056. Ejemplos:
  1057. cm crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
  1058. (Encripta la contraseña en el fichero de configuración de la base de datos:
  1059. 'db.conf'.)
  1060. == CMD_DESCRIPTION_DEACTIVATEUSER ==
  1061. Desactiva un usuario con licencia.
  1062. == CMD_USAGE_DEACTIVATEUSER ==
  1063. Sintaxis:
  1064. cm deactivateuser | du <usr_name>[ ...] [--server=<name:port>]
  1065. [--nosolveuser]
  1066. usr_name Nombre del usuario a desactivar. Use un espacio en
  1067. blanco para separar nombres de usuario.
  1068. Si SID, entonces debe incluir el argumento '--nosolveuser'.
  1069. Options:
  1070. --server Desactiva el usuario en el servidor indicado. Si no se
  1071. indica ningún servidor, el comando se ejecuta en el
  1072. servidor configurado en el cliente.
  1073. --nosolveuser Si se indica esta opción, el comando no comprobará si el
  1074. nombre de usuario existe en el sistema de autentificación.
  1075. El nombre de usuario debe ser un usuario SID.
  1076. == CMD_HELP_DEACTIVATEUSER ==
  1077. Notas:
  1078. Este comando desactiva a un usuario. De este modo no podrá usar Unity VCS.
  1079. (Use 'cm activateuser' para más información sobre cómo activar usuarios de
  1080. Unity VCS.)
  1081. Este comando comprueba si el usuario existe en el sistema de autentificación
  1082. (por ejemplo, ActiveDirectory, LDAP, User/Password...).
  1083. Para forzar la desactivación de un usuario que ya no existe en el sistema de
  1084. autentificación, use la opción '--nosolveuser' option.
  1085. Ejemplos:
  1086. cm deactivateuser john
  1087. cm du peter "mary collins"
  1088. cm deactivateuser john --server=myserver:8084
  1089. cm deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --nosolveuser
  1090. == CMD_DESCRIPTION_DIFF ==
  1091. Muestra las diferencias entre ficheros, changesets o ramas.
  1092. == CMD_USAGE_DIFF ==
  1093. Sintaxis:
  1094. cm diff <csetspec> | <lbspec> | <shspec> [<csetspec> | <lbspec> | <shspec>]
  1095. [<path>]
  1096. [--added] [--changed] [--moved] [--deleted]
  1097. [--repositorypaths] [--download=<download_path>]
  1098. [--encoding=<name>]
  1099. [--comparisonmethod=(ignoreeol | ignorewhitespaces |
  1100. ignoreeolandwhitespaces | recognizeall)]
  1101. [--clean]
  1102. [--integration]
  1103. [--format=<str_format>] [--dateformat=<str_format>]
  1104. Muestra las diferencias entre un changeset o un shelveset 'origen' y un
  1105. changeset o un shelveset 'destino'. Los changesets se pueden especificar
  1106. usando una especificación de changeset o de etiqueta.
  1107. Si se indican dos especificaciones, la primera será el 'origen' del diff
  1108. y la segunda será el 'destino'.
  1109. Si se indica solo una especificación, el 'origen' será el changeset
  1110. padre del 'destino' indicado.
  1111. Si se especifica una ruta, la ventana de Diff se abrirá para mostrar las
  1112. diferencias entre las dos revisiones del fichero indicado.
  1113. cm diff <revspec1> <revspec2>
  1114. Muestra las diferencias entre un par de revisiones. Las diferencias se
  1115. muestran en la ventana de Diff. La primera revisión indicada aparecerá
  1116. a la izquierda.
  1117. cm diff <brspec> [--added] [--changed] [--moved] [--deleted]
  1118. [--repositorypaths] [--download=<download_path>]
  1119. [--encoding=<name>]
  1120. [--comparisonmethod=(ignoreeol | ignorewhitespaces |
  1121. ignoreeolandwhitespaces | recognizeall)]
  1122. [--clean]
  1123. [--integration]
  1124. [--format=<str_format>] [--dateformat=<str_format>]
  1125. [--fullpaths | --fp]
  1126. Muestra las diferencias de rama.
  1127. (Use 'cm help objectspec' para más información sobre especificaciones.)
  1128. Opciones:
  1129. --added Imprime las diferencias de ítems añadidos al repositorio.
  1130. --changed Imprime las diferencias de ítems que han cambiado.
  1131. --moved Imprime las diferencias de ítems movidos o renombrados.
  1132. --deleted Imprime las diferencias de ítems borrados.
  1133. Si no se indica ni '--added' ni '--changed' ni '--moved'
  1134. ni '--deleted', se imprimen todas las diferencias.
  1135. 'A' significa ítems añadidos ('added'.)'
  1136. 'C' significa ítems cambiados ('changed'.)
  1137. 'D' significa ítems borrados ('deleted'.)
  1138. 'M' significa ítems movidos ('moved'). El ítem a la
  1139. izquierda es el original, y el de la derecha es el
  1140. destino.
  1141. --repositorypaths Imprime rutas de repositorio en lugar de rutas de
  1142. workspace. (Esta opción anula la opción '--fullpaths'.)
  1143. --download Guarda el contenido de las diferencias en la ruta de
  1144. salida indicada.
  1145. --encoding Especifica el encoding que se usará en la salida, por
  1146. ejemplo, utf-8. Consulte la documentación de MSDN en
  1147. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1148. para obtener la tabla de codificaciones soportadas y
  1149. su formato (al final de la página en la columna "Name").
  1150. --comparisonmethod Configura el método de comparación indicado.
  1151. Consulte las Notas para más información.
  1152. --clean Omite las diferencias que provienen de un merge mostrando
  1153. solo las diferencias creadas en los checkins.
  1154. --integration Muestra los cambios de la rama que están pendientes de
  1155. integrar en su rama padre. Tiene en cuenta los rebases
  1156. y los merges a la rama padre ya realizados.
  1157. --format Muestra el mensaje de salida en el formato indicado.
  1158. Consulte las Notas para más información.
  1159. --dateformat Configura el formato de salida para la impresión de fechas.
  1160. --fullpaths, --fp Fuerza la impresión de rutas de workspaces absolutas para
  1161. ficheros y directorios siempre que sea posible.
  1162. == CMD_HELP_DIFF ==
  1163. Notas:
  1164. Métodos de comparación (opción --comparisonmethod):
  1165. ignoreeol Ignora diferencias en final de línea.
  1166. ignorewhitespaces Ignora diferencias en espacios.
  1167. ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios.
  1168. recognizeall Detecta diferencias en final de línea y espacios.
  1169. Parámetros de formato de salida (opción --format):
  1170. Este comando acepta una cadena de formato para mostrar la salida.
  1171. Los parámetros de salida de este comando son los siguientes:
  1172. {path} Ruta del ítem.
  1173. {date} Fecha/hora del cambio.
  1174. {owner} Autor del cambio.
  1175. {revid} Identificador de la revisión considerada como
  1176. destino en las diferencias.
  1177. {parentrevid} Identificador del padre de la revisión considerada
  1178. como destino en las diferencias.
  1179. {baserevid} Identificador de la revisión considerada como origen
  1180. en las diferencias.
  1181. {srccmpath} Ruta de servidor antes de mover un ítem (para la
  1182. operación de movido).
  1183. {dstcmpath} Ruta de servidor después de mover un ítem (para la
  1184. operación de movido).
  1185. {type} Tipo de ítem:
  1186. D directorio,
  1187. B fichero binario,
  1188. F fichero de texto,
  1189. S symlink,
  1190. X Xlink.
  1191. {repository} Repositorio del ítem.
  1192. {status} Estado del ítem:
  1193. A añadido,
  1194. D borrado,
  1195. M movido,
  1196. C cambiado.
  1197. {fsprotection} Muestra los permisos del ítem (Linux/Mac chmod).
  1198. {srcfsprotection} Muestra los permisos de la revisión padre del ítem.
  1199. {newline} Inserta una nueva línea.
  1200. Notas sobre 'revid':
  1201. Para ítems añadidos, 'baserevid' y 'parentrevid' es -1 puesto que no existe
  1202. revisión previa en estos casos.
  1203. Para ítems borrados, 'revid' es el identificador de la revisión origen, y
  1204. 'baserevid' es -1 puesto que no existe revisión destino.
  1205. Para Xlinks, 'baserevid' y 'parentrevid' son siempre -1.
  1206. Ejemplos:
  1207. Comparar ramas:
  1208. cm diff br:/main/task001
  1209. cm diff br:/main/task001 \doc\readme.txt
  1210. cm diff br:/main/task001 --integration
  1211. Comparar changesets:
  1212. cm diff 19
  1213. cm diff 19 25
  1214. cm diff cs:19 cs:25 --format="{path} {parentrevid}"
  1215. cm diff cs:19 cs:23 --format="{date} {path}" --dateformat="yy/dd/MM HH:mm:ss"
  1216. cm diff cs:19 cs:23 --changed
  1217. cm diff cs:19 cs:23 --repositorypaths
  1218. cm diff cs:19 cs:23 --download="D:\temp"
  1219. cm diff cs:19 cs:23 --clean
  1220. cm diff cs:19 cs:23 \doc\readme.txt
  1221. Comparar etiquetas:
  1222. cm diff lb:EtiquetaPrimeraRelease lb:EtiquetaSegundaRelease
  1223. cm diff lb:tag_193.2 cs:34214
  1224. cm diff cs:31492 lb:tag_193.2
  1225. Comparar shelves:
  1226. cm diff sh:2
  1227. cm diff sh:2 sh:4
  1228. Comparar revisiones:
  1229. cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
  1230. cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
  1231. serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
  1232. cm diff rev:foo.c#cs:1 rev:foo.c#cs:2 --comparisonmethod=ignoreeol
  1233. == CMD_DESCRIPTION_DIFFMETRICS ==
  1234. Muestra métricas de diferencias entre dos revisiones.
  1235. == CMD_USAGE_DIFFMETRICS ==
  1236. Sintaxis:
  1237. cm diffmetrics | dm <revspec1> <revspec2> [--format=<str_format>]
  1238. [--encoding=<name>]
  1239. [--comparisonmethod=(ignoreeol | ignorewhitespaces |
  1240. ignoreeolandwhitespaces | recognizeall)]
  1241. revspec Revisiones a comparar.
  1242. (Use 'cm help objectspec' para más información sobre
  1243. especificaciones de revisiones.)
  1244. Options:
  1245. --format Muestra el mensaje de salida en el formato indicado.
  1246. Consulte las Notas para más información.
  1247. --encoding Especifica el encoding que se usará en la salida, por
  1248. ejemplo, utf-8. Consulte la documentación de MSDN en
  1249. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1250. para obtener la tabla de codificaciones soportadas y
  1251. su formato (al final de la página en la columna "Name").
  1252. --comparisonmethod Configura el método de comparación indicado.
  1253. Consulte las Notas para más información.
  1254. == CMD_HELP_DIFFMETRICS ==
  1255. Notas:
  1256. Las métricas que se obtienen son: número de líneas cambiadas, añadidas y
  1257. borradas.
  1258. Parámetros de formato de salida (opción --format):
  1259. Este comando acepta una cadena de formato para mostrar la salida.
  1260. Los parámetros de salida de este comando son los siguientes:
  1261. {0} Número de líneas cambiadas.
  1262. {1} Número de líneas añadidas.
  1263. {2} Número de líneas borradas.
  1264. Métodos de comparación (opción --comparisonmethod):
  1265. ignoreeol Ignora diferencias en final de línea.
  1266. ignorewhitespaces Ignora diferencias en espacios.
  1267. ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios.
  1268. recognizeall Detecta diferencias en final de línea y espacios.
  1269. Ejemplos:
  1270. cm diffmetrics file.txt#cs:2 file.txt#br:/main/scm0211 \
  1271. --format="There are {0} changed, {1} added and {2} deleted lines."
  1272. (Muestra las métricas de diferencias en el formato indicado.)
  1273. cm dm file.txt#cs:2 file.txt#cs:3 --encoding=utf-8 --comparisonmethod=ignorewhitespaces
  1274. == CMD_DESCRIPTION_FASTEXPORT ==
  1275. Exporta los datos de un repositorio de Unity VCS a un formato fast-export.
  1276. == CMD_USAGE_FASTEXPORT ==
  1277. Sintaxis:
  1278. cm fast-export | fe <repspec> <fast-export-file>
  1279. [--import-marks=<marks_file>]
  1280. [--export-marks=<marks_file>]
  1281. [--branchseparator=<chr_separator>]
  1282. [--nodata] [--from=<changesetid>] [--to=<changesetid>]
  1283. Opciones:
  1284. repspec Repositorio cuyos datos serán exportados.
  1285. (Use 'cm help objectspec' para más información sobre
  1286. especificaciones de repositorio.)
  1287. fast-export-file Fichero con los datos del repositorio en formato
  1288. fast-export de Git.
  1289. --import-marks Fichero de marcas usado para la importación incremental.
  1290. Este fichero ha sido previamente exportado con el
  1291. comando --export-marks. Los changesets descritos en este
  1292. fichero no se importarán porque ya lo fueron en una
  1293. importación previa.
  1294. --export-marks Fichero donde se guardan los changesets importados.
  1295. Este fichero se usará en una operación fast-import para
  1296. indicar los changesets que han sido importados.
  1297. --branchseparator Unity VCS usa "/" como separador por defecto en la
  1298. jerarquía de ramas. Esta opción permite usar un carácter
  1299. como separador de jerarquía. Por ejemplo, la rama
  1300. main-task-sub será mapeada en Unity VCS como
  1301. /main/task/sub.
  1302. --nodata Exporta el repositorio pero sin incluir los datos. Esta
  1303. opción es útil para comprobar que la exportación se
  1304. llevará a cabo sin problemas.
  1305. --from Exporta desde el changeset especificado.
  1306. --to Exporta hasta el changeset especificado.
  1307. == CMD_HELP_FASTEXPORT ==
  1308. Notas:
  1309. - Para importar un repositorio de Unity VCS a Git, use un comando como el siguiente:
  1310. cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git
  1311. - La exportación incremental se realiza usando un fichero de marcas que
  1312. contenga los changesets previamente importados (ficheros --import-marks y
  1313. --export-marks).
  1314. Esto significa que solamente se exportarán los changesets que no fueron
  1315. exportados con un fast-export previamente.
  1316. Ejemplos:
  1317. cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm
  1318. (Exporta el repositorio 'repo' en el servidor local al fichero 'repo.fe.00'
  1319. en formato fast-export de Git y crea el fichero de marcas para poder
  1320. realizar una futura exportación incremental.)
  1321. cm fast-export repo@localhost:8087 repo.fe.00 --from=20
  1322. (Exporta el repositorio 'repo' en el servidor local al fichero 'repo.fe.00'
  1323. en formato Git fast-export desde el changeset '20'.)
  1324. == CMD_DESCRIPTION_FASTIMPORT ==
  1325. Importa datos de fast-export de Git a un repositorio.
  1326. == CMD_USAGE_FASTIMPORT ==
  1327. Sintaxis:
  1328. cm fast-import | fi <repspec> <fast-export-file>
  1329. [--import-marks=<marks_file>]
  1330. [--export-marks=<marks_file>]
  1331. [--stats] [--branchseparator=<chr_separator>]
  1332. [--nodata] [--ignoremissingchangesets] [--mastertomain]
  1333. Opciones:
  1334. repspec Repositorio en el cual se importarán los datos.
  1335. Si no existe en el momento de la operación, se
  1336. crea automáticamente. (Use 'cm help objectspec'
  1337. para más información sobre especificaciones de
  1338. repositorio.)
  1339. fast-export-file Fichero con los datos en formato Git
  1340. fast-export.
  1341. --import-marks El fichero de marcas utilizado para
  1342. importaciones incrementales. Dicho fichero se
  1343. ha exportado previamente con --export-marks.
  1344. Los changesets descritos en este fichero no se
  1345. importarán porque ya existían de una importación
  1346. previa.
  1347. --export-marks El fichero en el cual se guardarán los changesets
  1348. importados. Dicho fichero se utilizará en una
  1349. operación posterior de fast-import para indicar
  1350. los changesets que ya han sido importados.
  1351. --stats Muestra estadísticas del proceso de importación.
  1352. --branchseparator Unity VCS usa "/" como separador por defecto
  1353. en la jerarquía de ramas. Esta opción permite
  1354. usar un carácter como separador en esa
  1355. jerarquía. Por ejemplo, la rama main-task-sub
  1356. será mapeada en Unity VCS como /main/task/sub.
  1357. --nodata Importa Git fast-export pero sin incluir datos.
  1358. Esta opción es útil para comprobar que la
  1359. importación exportación se llevará a cabo sin
  1360. problemas.
  1361. --ignoremissingchangesets Los changesets que no pueden ser importados se
  1362. descartan y la operación de fast-import continúa
  1363. sin ellos.
  1364. --mastertomain Realiza la importación usando "main" en lugar
  1365. de "master".
  1366. == CMD_HELP_FASTIMPORT ==
  1367. Notas:
  1368. - Para exportar un repositorio de Git, use un comando como el siguiente:
  1369. git fast-export --all -M --signed-tags=strip --tag-of-filtered-object=drop> ..\git-fast-export.dat
  1370. La opción -M es importante para detectar ítems movidos.
  1371. - El repositorio indicado se crea en caso de que no exista.
  1372. - La importación incremental se realiza usando los ficheros de marcas que
  1373. contengan los changesets previamente importados (ficheros --import-marks y
  1374. --export-marks).
  1375. Esto significa que solamente se importarán los changesets que no fueron
  1376. importados con un fast-import previamente.
  1377. Ejemplos:
  1378. cm fast-import mynewrepo@atenea:8084 repo.fast-export
  1379. (Importa el contenido exportado en el fichero 'repo.fast-export' al
  1380. repositorio 'mynewrepo' del servidor 'atenea:8084'.)
  1381. cm fast-import repo@server:8084 repo.fast-export --export-marks=rep.marks
  1382. (Importa el contenido exportado en el fichero 'repo.fast-export' al
  1383. repositorio 'repo' del servidor 'atenea:8084' y crea un archivo de
  1384. marcas para importaciones incrementales posteriores.)
  1385. cm fast-import repo@server:8084 repo.fast-export --importmarks=repo.marks \
  1386. --export-marks=repo.marks
  1387. (Importa el contenido del fichero 'repo.fast-export'. Solamente se importarán
  1388. los changesets que no están en el fichero de marcas. Se utiliza el mismo
  1389. fichero de marcas para guardar la lista de changesets de nuevo para la
  1390. siguiente importación incremental.)
  1391. == CMD_DESCRIPTION_FILEINFO ==
  1392. Obtiene información detallada de ítems del espacio de trabajo.
  1393. == CMD_USAGE_FILEINFO ==
  1394. Sintaxis:
  1395. cm fileinfo <item_path>[ ...] [--fields=<field_value>[,...]]
  1396. [[--xml | -x [=<output_file>]] | [--format=<str_format>]]
  1397. [--symlink] [--encoding=<name>]
  1398. item_path Ítems a mostrar. Use comillas dobles (" ") para especificar
  1399. rutas que contengan espacios. Use un espacio en blanco para
  1400. separar rutas de ítems.
  1401. Opciones:
  1402. --fields Cadena de valores separados por coma. Indica qué campos Se
  1403. mostrarán por cada ítem. Consulte las Notas para más
  1404. información.
  1405. --xml | -x Imprime el resultado en formato XML a la salida estándar.
  1406. También es posible especificar un fichero de salida.
  1407. Esta opción no puede combinarse con --format.
  1408. --format Muestra el mensaje de salida en un formato específico.
  1409. Consulte las Notas para más información. No puede
  1410. combinarse con --xml.
  1411. --symlink Aplica la operación al symlink pero no al destino.
  1412. --encoding Especifica el encoding que se usará en la salida, por
  1413. ejemplo, utf-8. Consulte la documentación de MSDN en
  1414. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1415. para obtener la tabla de codificaciones soportadas y
  1416. su formato (al final de la página en la columna "Name").
  1417. == CMD_HELP_FILEINFO ==
  1418. Notas:
  1419. Este comando muestra una lista detallada de atributos para cada ítem
  1420. indicado. Cada atributo se muestra en una nueva línea.
  1421. Se puede modificar la lista de atributos para mostrar únicamente los
  1422. atributos que el usuario necesite. Para ello, utilice el argumento
  1423. --fields=<field_list> que acepta una cadena de nombres de atributo
  1424. separados por comas. De este modo, solo se mostrarán aquellos argumentos
  1425. cuyo nombre esté presente en la lista.
  1426. Revision head changeset:
  1427. Esta opción está desactivada por defecto. Tenga en cuenta que la
  1428. recuperación de este atributo es notablemente más lenta que la del resto de
  1429. atributos, por lo que recomendamos agrupar tantos ficheros por ejecución como
  1430. sea posible. Esto mejora los tiempos de ejecución al evitar numerosas
  1431. ejecuciones de 'cm fileinfo' separadas.
  1432. Además, esta característica no se encuentra disponible actualmente para
  1433. directorios controlados.
  1434. A continuación se encuentra la lista completa de nombres de atributo. Los
  1435. nombres marcados con asterisco ('*') no se mostrarán:
  1436. ClientPath Ruta local del ítem en disco.
  1437. RelativePath Ruta relativa del ítem en el espacio de trabajo.
  1438. ServerPath Ruta del repositorio para el ítem.
  1439. (Nota: Los espacios de trabajo transformado no
  1440. están actualmente soportados para esta opción.)
  1441. Size Tamaño del ítem.
  1442. Hash Suma 'hash' del ítem.
  1443. Owner Nombre del usuario propietario del ítem.
  1444. RevisionHeadChangeset (*) Changeset de la revisión cargada en el
  1445. changeset head de la rama.
  1446. (Ver nota más arriba.)
  1447. RevisionChangeset Changeset de la revisión cargada en el espacio
  1448. de trabajo.
  1449. RepSpec Especificación del repositorio para el ítem.
  1450. (Use 'cm help objectspec' para más información
  1451. sobre especificaciones de repositorio.)
  1452. Status Estado del ítem en el espacio de trabajo:
  1453. añadido, desprotegido (checked-out), eliminado...
  1454. Type Tipo de la revisión (texto, binario, directorio,
  1455. symlink o desconocido).
  1456. Changelist Lista de cambios (si existe) a la que pertenece
  1457. el ítem.
  1458. IsLocked (*) Si el ítem está bloqueado por un checkout
  1459. exclusivo o no.
  1460. LockedBy (*) Usuario que bloqueó el ítem mediante
  1461. checkout exclusivo.
  1462. LockedWhere (*) Localización del ítem bloqueado mediante
  1463. checkout exclusivo.
  1464. IsUnderXlink Si el ítem está localizado en un Xlink o no.
  1465. UnderXlinkTarget Destino del Xlink (si existe) donde el ítem se
  1466. encuentra.
  1467. UnderXlinkPath Ruta de servidor del ítem en el repositorio del
  1468. Xlink (si existe).
  1469. UnderXlinkWritable Si el Xlink al que pertenece el ítem es de
  1470. escritura o no.
  1471. UnderXlinkRelative Si el Xlink al que pertenece el ítem es
  1472. relativo o no.
  1473. IsXlink Si el ítem es un Xlink o no.
  1474. XlinkTarget Repositorio destino al que el ítem apunta, si es
  1475. un Xlink.
  1476. XlinkName Nombre del ítem Xlink.
  1477. XlinkWritable Si el ítem Xlink es un Xlink de escritura o no.
  1478. XlinkRelative Si el ítem Xlink es un Xlink relativo o no.
  1479. Parámetros de formato de salida (opción --format):
  1480. Este comando acepta una cadena de formato para mostrar su salida.
  1481. Los parámetros de salida de este comando son los siguientes:
  1482. {ClientPath}
  1483. {RelativePath}
  1484. {ServerPath}
  1485. {Size}
  1486. {Hash}
  1487. {Owner}
  1488. {RevisionHeadChangeset}
  1489. {RevisionChangeset}
  1490. {Status}
  1491. {Type}
  1492. {Changelist}
  1493. {IsLocked}
  1494. {LockedBy}
  1495. {LockedWhere}
  1496. {IsUnderXlink}
  1497. {UnderXlinkTarget}
  1498. {UnderXlinkPath}
  1499. {UnderXlinkWritable}
  1500. {UnderXlinkRelative}
  1501. {IsXlink}
  1502. {XlinkTarget}
  1503. {XlinkName}
  1504. {XlinkWritable}
  1505. {XlinkRelative}
  1506. {RepSpec}
  1507. Tenga en cuenta que las opciones --format y --xml son mutuamente excluyentes,
  1508. por lo que no se pueden utilizar simultáneamente.
  1509. Ejemplos:
  1510. cm fileinfo file1.txt file2.txt dir/
  1511. cm fileinfo "New Project.csproj" --xml
  1512. cm fileinfo assets.art --fields=ServerPath,Size,IsLocked,LockedBy
  1513. cm fileinfo proj_specs.docx --fields=ServerPath,RevisionChangeset --xml
  1514. cm fileinfo samples.ogg --format="{ServerPath}[{Owner}] -> {Size}"
  1515. == CMD_DESCRIPTION_FIND ==
  1516. Obtiene una serie de objetos en base a unos criterios de búsqueda.
  1517. == CMD_USAGE_FIND ==
  1518. Sintaxis:
  1519. cm find <object_type>
  1520. [where <str_conditions>]
  1521. [on repository '<repspec>' | on repositories '<repspec1>','<repspec2>'[,...]]
  1522. [order by <sort_field> ['asc' | 'desc']]
  1523. [[limit <maxresults>] [offset <offset>]]
  1524. [--format=<str_format>] [--dateformat=<date_format>]
  1525. [--nototal] [--file=<dump_file>] [--xml]
  1526. [--encoding=<name>]
  1527. object_type Objecto a buscar.
  1528. Algunos de estos objetos permiten la cláusula 'order by'.
  1529. Use 'cm help showfindobjects' para más información sobre
  1530. estos objetos, aquellos que permiten ordenación y por qué campos.
  1531. Lea la Guía de 'cm find' para más información:
  1532. https://www.plasticscm.com/download/help/cmfind
  1533. Opciones:
  1534. str_conditions Condiciones de búsqueda sobre los atributos del objeto.
  1535. repspec Nombre o especificación del repositorio (o repositorios)
  1536. donde buscar.
  1537. Para 'on repositories', use una coma para separar las
  1538. especificaciones de repositorio.
  1539. (Use 'cm help objectspec' para más información sobre
  1540. especificaciones de repositorio.)
  1541. sort_field Nombre del campo elegido para la ordenación. Tenga en cuenta
  1542. que esos campos son limitados. Use 'cm help showfindobjects' para
  1543. consultar qué objetos se permiten ordenar y por qué campos.
  1544. maxresults Número máximo de resultados devueltos por la búsqueda.
  1545. offset Número de resultados que se omiten antes de empezar a devolver
  1546. los resultados de la búsqueda.
  1547. --format Muestra el mensaje de salida en el formato indicado.
  1548. Lea la Guía de 'cm find' para ver todos los atributos
  1549. de objeto que se pueden usar para el formato de salida:
  1550. https://www.plasticscm.com/download/help/cmfind
  1551. --dateformat Configura el formato de salida para la impresión de fechas.
  1552. --nototal No muestra el número total de registros.
  1553. --file Fichero al que volcar los resultados.
  1554. --xml Imprime el resultado en formato XML a la salida estándar.
  1555. --encoding Especifica el encoding que se usará en la salida, por
  1556. ejemplo, utf-8. Consulte la documentación de MSDN en
  1557. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1558. para obtener la tabla de codificaciones soportadas y
  1559. su formato (al final de la página en la columna "Name").
  1560. == CMD_HELP_FIND ==
  1561. Notas:
  1562. Si no se especifica ningún repositorio, la búsqueda se realiza sobre el
  1563. repositorio configurado en el espacio de trabajo.
  1564. Cuando se ejecutan búsquedas desde la línea de comandos usando operadores de
  1565. comparación (>, <, >=, <=), el intérprete de comandos (o shell) considera a
  1566. estos operadores como redirecciones de E/S. Por lo que es necesario escribir
  1567. la búsqueda entre comillas dobles.
  1568. El comando 'cm find' acepta una cadena de formato para mostrar la salida.
  1569. Cada parámetro de salida se identifica con un nombre, y el usuario se
  1570. puede referir a él escribiéndolo entre llaves '{' y '}'.
  1571. Los parámetros de salida se corresponden normalmente con atributos del objeto.
  1572. Estas son cadenas de formato válidas:
  1573. --format={id}{date}{name}
  1574. --format="{item}#{branch} con fecha {date}"
  1575. Consideraciones sobre XML y encoding:
  1576. Cuando se especifica la opción --xml, se muestra el resultado como texto XML
  1577. en la salida estándar. Por defecto se utiliza la codificación estándar del
  1578. sistema operativo, por lo que es posible que los caracteres no ANSI no se
  1579. visualicen correctamente en la consola. Pero si se redirige la salida a un
  1580. fichero, el contenido se visualizará correctamente.
  1581. Cuando se especifican simultáneamente las opciones --xml y --file, se
  1582. utiliza por defecto la codificación UTF-8.
  1583. Ejemplos:
  1584. cm find revision
  1585. cm find revision "where changeset = 23 and owner = 'user'"
  1586. cm find branch "on repository 'rep1'"
  1587. cm find label "on repositories 'rep1', 'rep:default@localhost:8084'"
  1588. cm find branch "where parent = 'br:/main' on repository 'rep1'"
  1589. cm find revision "where item = 'item:.'" --format="{item}#{branch}"
  1590. cm find revision "where item = 'item:.'" --xml --file=c:\queryresults\revs.xml
  1591. cm find label "where owner='me' limit 10 offset 20"
  1592. cm find branches "where owner='me' order by branchname desc limit 10"
  1593. == CMD_DESCRIPTION_FINDCHANGED ==
  1594. Obtiene una lista de los ficheros cambiados. Este comando está obsoleto y solo
  1595. se mantiene por retrocompatibilidad. Use 'cm status'.
  1596. == CMD_USAGE_FINDCHANGED ==
  1597. Sintaxis:
  1598. cm findchanged | fc [-R | -r | --recursive] [--checkcontent]
  1599. [--onlychanged] [<path>]
  1600. Opciones:
  1601. -R Busca recursivamente en los directorios.
  1602. --checkcontent Compara los ficheros por contenido.
  1603. --onlychanged Encuentra solo los ficheros cambiados; los ficheros
  1604. desprotegidos no se devolverán en la búsqueda.
  1605. path (Por defecto, el directorio actual.)
  1606. Ruta inicial de búsqueda de los ficheros cambiados.
  1607. == CMD_HELP_FINDCHANGED ==
  1608. Notas:
  1609. Si no se especifica la opción '--checkcontent', Unity VCS busca cambiados
  1610. basándose en el registro de tiempo (timestamp) de los ficheros.
  1611. Si se especifica la opción '--checkcontent', entonces lo que se compara es
  1612. el contenido de los ficheros o las carpetas y no el timestamp.
  1613. Este comando es útil para detectar ficheros que han cambiado durante una
  1614. desconexión del servidor de Unity VCS. La salida de este comando permite
  1615. usar una tubería (pipe) con el comando 'checkout' y así poder comprobar
  1616. los cambios más tarde (ver ejemplos).
  1617. Ejemplos:
  1618. cm findchanged .
  1619. (Busca ficheros cambiados en el directorio actual.)
  1620. cm findchanged -R . | cm checkout -
  1621. (Desprotege los elementos cambiados.)
  1622. == CMD_DESCRIPTION_FINDCHECKEDOUT ==
  1623. Obtiene una lista de ficheros desprotegidos. Este comando está obsoleto y se
  1624. mantiene por retrocompatibilidad. Use 'cm status'.
  1625. == CMD_USAGE_FINDCHECKEDOUT ==
  1626. Sintaxis:
  1627. cm findcheckouts | fco [--format=<str_format>] [--basepath]
  1628. Opciones:
  1629. --format Muestra el mensaje de salida con el formato indicado.
  1630. Consulte las Notas para más información.
  1631. --basepath Ruta por la que comenzar a buscar desprotegidos. Si no
  1632. se especifica ninguna ruta, se usará la ruta actual.
  1633. == CMD_HELP_FINDCHECKEDOUT ==
  1634. Notas:
  1635. Este comando es útil para, en un único paso, proteger o deshacer las
  1636. desprotecciones de todos los ficheros desprotegidos, y redirigir la salida
  1637. estándar a otro comando. Vea los ejemplos.
  1638. Parámetros de formato de salida (opción --format):
  1639. Este comando acepta una cadena de formato para mostrar la salida.
  1640. Los parámetros de salida de este comando son los siguientes:
  1641. {0} Fecha.
  1642. {1} Propietario.
  1643. {2} Espacio de trabajo.
  1644. {3} Nombre de la máquina cliente.
  1645. {4} Ruta del fichero.
  1646. {5} Información de rama y repositorio.
  1647. Ejemplos:
  1648. cm findcheckouts --format="File {4} changed on branch {5}"
  1649. (Busca los ficheros desprotegidos y formatea la salida con la ruta del
  1650. fichero y la información de la rama y repositorio.)
  1651. cm findcheckouts --format={4} | cm checkin -
  1652. (Protege todos los ficheros desprotegidos.)
  1653. cm findcheckouts --format={4} | cm undocheckout -
  1654. (Deshace la desprotección de todos los ficheros desprotegidos.)
  1655. == CMD_DESCRIPTION_FINDPRIVATE ==
  1656. Obtiene una lista de ítems privados. Este comando está obsoleto y se mantiene
  1657. por retrocompatibilidad. Use 'cm status'.
  1658. == CMD_USAGE_FINDPRIVATE ==
  1659. Sintaxis:
  1660. cm findprivate | fp [-R | -r | --recursive] [--exclusions] [<path>]
  1661. Opciones:
  1662. -R Busca recursivamente en los directorios.
  1663. --exclusions Permite interrumpir la búsqueda dentro de las rutas
  1664. ignoradas (definidas en el fichero ignore.conf).
  1665. path (Por defecto, directorio actual.)
  1666. Ruta por la que comenzar a buscar los ficheros privados.
  1667. == CMD_HELP_FINDPRIVATE ==
  1668. Notas:
  1669. Si no se especifica ninguna ruta, Unity VCS comenzará a buscar por el
  1670. directorio actual.
  1671. Este comando es útil para añadir los elementos privados de la ruta
  1672. redireccionando la salida estándar al comando 'add'.
  1673. Vea los ejemplos.
  1674. Ejemplos:
  1675. cm findprivate .
  1676. cm findprivate -R | cm add -
  1677. (Busca recursivamente items privados y los añade al repositorio.)
  1678. == CMD_DESCRIPTION_GETCONFIG ==
  1679. Obtiene información de configuración.
  1680. == CMD_USAGE_GETCONFIG ==
  1681. Sintaxis:
  1682. cm getconfig [setfileasreadonly] [location] [extensionworkingmode]
  1683. [extensionprefix] [defaultrepserver]
  1684. setfileasreadonly Muestra si los ficheros protegidos se dejan en modo
  1685. solo lectura o no.
  1686. location Muestra la ruta del fichero de configuración del
  1687. cliente.
  1688. extensionworkingmode Muestra el modo de trabajo de la extensión.
  1689. extensionprefix Muestra el prefijo de la extensión configurada.
  1690. defaultrepserver Muestra el servidor de repositorios configurado por
  1691. defecto.
  1692. == CMD_HELP_GETCONFIG ==
  1693. Ejemplos:
  1694. cm getconfig setfileasreadonly
  1695. == CMD_DESCRIPTION_GETFILE ==
  1696. Descarga el contenido de una revisión especificada.
  1697. == CMD_USAGE_GETFILE ==
  1698. Sintaxis:
  1699. cm getfile | cat <revspec>[[;<output_file>] | [--file=<output_file>]]
  1700. [--debug] [--symlink] [--raw]
  1701. revspec Especificación de la revisión. (Use 'cm help objectspec' para
  1702. más información sobre las especificaciones de revisiones.)
  1703. Opciones:
  1704. --file Fichero donde guardar la salida. Por defecto, se imprime en
  1705. la salida estándar. Esta opción sólo se debe usar cuando
  1706. se proporciona una única revisión. Si se desea añadir más de
  1707. una revisión, esta opción no debería usarse. En su lugar,
  1708. se debería emplear la versión de pares de 'revspec;output_file',
  1709. añadiendo tantos pares como se desee separados por espacios
  1710. en blanco.
  1711. --debug Cuando se especifica la revisión de un directorio, el
  1712. comando muestra el id de la revisión y la protección del
  1713. sistema del fichero.
  1714. --symlink Aplica la operación al symlink pero no al destino (target).
  1715. --raw Muestra los datos del fichero sin procesar (raw data).
  1716. == CMD_HELP_GETFILE ==
  1717. Ejemplos:
  1718. cm cat myfile.txt#br:/main
  1719. (Obtiene la última revisión del fichero 'myfile.txt' en la rama 'br:/main'.)
  1720. cm getfile myfile.txt#cs:3 --file=tmp.txt
  1721. (Obtiene el changeset 3 del fichero 'myfile.txt' y escribe su contenido en
  1722. el fichero 'tmp.txt'.)
  1723. cm cat serverpath:/src/foo.c#br:/main/task003@myrepo
  1724. (Obtiene el contenido del fichero '/src/foo.c' del último changeset de la
  1725. rama '/main/task003' en el repositorio 'myrepo'.)
  1726. cm cat revid:1230@rep:myrep@repserver:myserver:8084
  1727. (Obtiene la revisión con id igual a 1230.)
  1728. cm getfile rev:info\ --debug
  1729. (Obtiene todas las revisiones del directorio 'info'.)
  1730. cm getfile "revid:25@rep:default@repserver:localhost:8084;file_revid25.txt"
  1731. "revid:16@rep:default@repserver:localhost:8084;file_revid_16.txt"
  1732. (Obtiene dos revisiones y las almacena en diferentes archivos. Para listar
  1733. revid es posible usar el comando 'cm find revision'. Considera que para
  1734. especificar colecciones de 'revspec;output_file' podría ser necesario
  1735. entrecomillar cada par individualmente y después separar cada uno por
  1736. espacios en blanco).
  1737. == CMD_DESCRIPTION_GETREVISION ==
  1738. Carga una revisión en el espacio de trabajo.
  1739. == CMD_USAGE_GETREVISION ==
  1740. Este comando modifica la revisión cargada en el espacio de trabajo, con lo que
  1741. puede afectar a futuros merges.
  1742. Este es un comando avanzado heredado de antiguas versiones; úselo con precaución.
  1743. Sintaxis:
  1744. cm getrevision <revspec>
  1745. revspec Especificación de la revisión. (Use 'cm help objectspec' para
  1746. más información sobre las especificaciones de revisiones.)
  1747. == CMD_HELP_GETREVISION ==
  1748. Ejemplos:
  1749. cm getrevision file.txt#cs:3
  1750. (Carga la revisión del changeset 3 del fichero 'file.txt'.)
  1751. == CMD_DESCRIPTION_GETSTATUS ==
  1752. Obtiene el estado de un ítem.
  1753. == CMD_USAGE_GETSTATUS ==
  1754. Este comando está pensado para la automatización de otros comandos. Con lo que,
  1755. es posible, que no resulte muy intuitivo.
  1756. Sintaxis:
  1757. cm getstatus | gs <item_path>[ ...] [--format=<str_format>] [--stats]
  1758. [-R | -r | --recursive]
  1759. item_path Ítem o ítems de los que obtener el estado. Use comillas
  1760. dobles (" ") para especificar rutas que contengan espacios.
  1761. Use un espacio en blanco para separar rutas de ítems.
  1762. Opciones:
  1763. --format Muestra el mensaje de salida en el formato indicado.
  1764. Consulte las Notas para más información.
  1765. --stats Muestra estadísticas sobre el proceso de obtención del estado.
  1766. -R Muestra recursivamente el estado en las rutas indicadas.
  1767. == CMD_HELP_GETSTATUS ==
  1768. Notas:
  1769. Parámetros de formato de salida (opción --format):
  1770. Este comando acepta una cadena de formato para mostrar la salida.
  1771. Los parámetros de salida de este comando son los siguientes:
  1772. {0} Ruta del ítem.
  1773. {1} Estado del ítem:
  1774. 0 privado,
  1775. 1 protegido,
  1776. 2 desprotegido.
  1777. Lectura desde stdin:
  1778. El comando 'getstatus' puede leer rutas desde stdin. Para ello, pase como
  1779. argumento un guión "-".
  1780. Por ejemplo: cm getstatus -
  1781. Las rutas se leerán hasta que se introduzca una línea en blanco.
  1782. Este tipo de lectura permite usar una tubería (pipe) para especificar de qué
  1783. ficheros se van a obtener su estado.
  1784. Por ejemplo:
  1785. dir /S /B *.c | cm getstatus --format="Path {0} Status {1}" -
  1786. (En Windows, obtiene el estado de todos los ficheros del workspace con
  1787. extensión .c.)
  1788. Ejemplos:
  1789. cm getstatus file1.txt file2.txt
  1790. (Obtiene el estado de los ficheros.)
  1791. cm gs info\ -R --format="The item {0} has the status {1}"
  1792. (Obtiene el estado del directorio y de todos sus ficheros y muestra la
  1793. salida formateada.)
  1794. == CMD_DESCRIPTION_GETTASKBRANCHES ==
  1795. Obtiene las ramas asociadas con una tarea.
  1796. == CMD_USAGE_GETTASKBRANCHES ==
  1797. Este comando está pensado para la automatización de otros comandos. Con lo que,
  1798. es posible, que no resulte muy intuitivo.
  1799. Sintaxis:
  1800. cm gettaskbranches | gtb <task_name> [--format=<str_format>]
  1801. [--dateformat=<date_format>]
  1802. task_name Identificador de la tarea.
  1803. Opciones:
  1804. --format Muestra el mensaje de salida en el formato indicado.
  1805. Consulte las Notas para más información.
  1806. --dateformat Configura el formato de salida para la impresión de fechas.
  1807. == CMD_HELP_GETTASKBRANCHES ==
  1808. Notas:
  1809. Parámetros de formato de salida (opción --format):
  1810. Este comando acepta una cadena de formato para mostrar la salida.
  1811. Los parámetros de salida de este comando son los siguientes:
  1812. {tab} Inserta un tabulador.
  1813. {newline} Inserta una nueva línea.
  1814. {name} Nombre de la rama.
  1815. {owner} Propietario de la rama.
  1816. {date} Fecha de creación de la rama.
  1817. {parent} Rama padre.
  1818. {comment} Comentario de la rama.
  1819. {repname} Repositorio donde se encuentra la rama.
  1820. {repserver} Nombre del servidor.
  1821. Ejemplos:
  1822. cm gettaskbranches 4311
  1823. cm gtb 4311 --format="br:{name}"
  1824. cm gtb 4311 --format="br:{name} {date}" --dateformat="yyyy/MM/dd HH:mm:ss"
  1825. == CMD_DESCRIPTION_GETWORKSPACEINFO ==
  1826. Muestra información del selector del espacio de trabajo.
  1827. == CMD_USAGE_GETWORKSPACEINFO ==
  1828. Sintaxis:
  1829. cm wi [<wk_path>]
  1830. wk_path Ruta en disco del workspace a consultar.
  1831. == CMD_HELP_GETWORKSPACEINFO ==
  1832. Notas:
  1833. El comando 'wi' muestra la configuración actual del espacio de trabajo
  1834. (repositorio, rama o etiqueta.)
  1835. Ejemplos:
  1836. cm wi c:\mywk
  1837. == CMD_DESCRIPTION_GETWORKSPACEFROMPATH ==
  1838. Obtiene información del espacio de trabajo a partir de una ruta.
  1839. == CMD_USAGE_GETWORKSPACEFROMPATH ==
  1840. Este comando está pensado para la automatización de otros comandos. Con lo que,
  1841. es posible, que no resulte muy intuitivo.
  1842. Sintaxis:
  1843. cm getworkspacefrompath | gwp <item_path> [--format=<str_format>] [--extended]
  1844. item_path Fichero o directorio en disco.
  1845. Opciones:
  1846. --format Muestra el mensaje de salida en el formato indicado.
  1847. Consulte las Notas para más información.
  1848. --extended Muestra más información sobre el espacio de trabajo: type y
  1849. dynamic además del resto de campos. Consulte las Notas para
  1850. más información.
  1851. == CMD_HELP_GETWORKSPACEFROMPATH ==
  1852. Notas:
  1853. Este comando muestra información del espacio de trabajo de la ruta indicada.
  1854. Parámetros de formato de salida (opción --format):
  1855. Este comando acepta una cadena de formato para mostrar la salida.
  1856. Los parámetros de salida de este comando son los siguientes:
  1857. {0} | {wkname} Nombre del espacio de trabajo.
  1858. {1} | {wkpath} Ruta del espacio de trabajo.
  1859. {2} | {machine} Nombre de la máquina del cliente.
  1860. {3} | {owner} Propietario del espacio de trabajo.
  1861. {4} | {guid} GUID del espacio de trabajo.
  1862. {5} | {type} Tipo de espacio de trabajo: partial (gluon) o regular.
  1863. {6} | {dynamic} Un espacio de trabajo puede ser dynamic (plasticfs)
  1864. o static.
  1865. {tab} Inserta un tabulador.
  1866. {newline} Inserta una nueva línea.
  1867. Ejemplos:
  1868. cm gwp c:\myworkspace\code\file1.cpp --format="Espacio de trabajo: {wkname}"
  1869. cm gwp . --format="Nombre: {wkname} | Tipo: {type}, {dynamic}"
  1870. == CMD_DESCRIPTION_HELP ==
  1871. Muestra la ayuda de un comando de Unity VCS.
  1872. == CMD_USAGE_HELP ==
  1873. Sintaxis:
  1874. cm help <command>
  1875. == CMD_HELP_HELP ==
  1876. == CMD_DESCRIPTION_IOSTATS ==
  1877. Muestra estadísticas relativas al hardware.
  1878. == CMD_USAGE_IOSTATS ==
  1879. Sintaxis:
  1880. cm iostats [<repserverspec>] [<list_of_tests>[ ...]]
  1881. [--nettotalmb=<value_mb>] [--networkiterations=<value_iter>]
  1882. [--diskdatasize=<value_size>] [--disktestpath=<value_path>]
  1883. [--systemdisplaytime=<value_time>]
  1884. [--systemdisplaytimeinterval=<value_interval>]
  1885. Opciones:
  1886. repserverspec Servidor de Unity VCS disponible para poder
  1887. realizar pruebas de red como, por ejemplo,
  1888. "serverUploadTest" o "serverDownloadTest".
  1889. Si no se indica ningún servidor, el comando
  1890. intentará comunicarse con el servidor
  1891. configurado por defecto.
  1892. (Use 'cm help objectspec' para más información
  1893. sobre las especificaciones de servidores.)
  1894. list_of_tests Tests disponibles. Use un espacio en blanco
  1895. para separar los diferentes tests.
  1896. Consulte las Notas para más información.
  1897. --nettotalmb Cantidad de datos de usuario (en MegaBytes)
  1898. transmitidos en un test de red, por ejemplo,
  1899. "serverDownloadTest" y "serverUploadTest".
  1900. Debe ser un valor comprendido entre "4" y "512"
  1901. (por defecto, 16).
  1902. --networkiterations Número de iteraciones de los tests de red
  1903. "serverDownloadTest" y "serverUploadTest".
  1904. Debe ser un valor comprendido entre "1" y "100"
  1905. (por defecto, 1).
  1906. --diskdatasize Cantidad de datos (en MegaBytes) que se
  1907. escribirán y leerán en el test de disco
  1908. "diskTest".
  1909. Debe ser un valor comprendido entre "100" y
  1910. "4096" (por defecto, 512).
  1911. --disktestpath Ruta donde el test de disco "diskTest" escribe
  1912. los ficheros de tests. Si no se indica ninguna
  1913. ruta, se intentará usar el directorio temporal
  1914. del sistema.
  1915. --systemdisplaytime Intervalo de tiempo (en segundos) en el que se
  1916. muestra el uso de los recursos del sistema.
  1917. Esta opción está disponible para los tests
  1918. "systemNetworkUsage" y "systemDiskUsage".
  1919. Debe ser un valor comprendido entre "1" y
  1920. "3600" (por defecto, 5 segundos).
  1921. --systemdisplaytimeinterval Intervalo de tiempo (en segundos) entre las
  1922. muestras de rendimiento del sistema. Esta
  1923. opcion está disponible para los tests
  1924. "systemNetworkUsage" y "systemDiskUsage".
  1925. Debe ser un valor comprendido entre "1" and "60"
  1926. (por defecto, 1 segundo).
  1927. == CMD_HELP_IOSTATS ==
  1928. Notas:
  1929. Este comando requiere de un servidor disponible para usarse durante los tests
  1930. de velocidad de red ("serverUploadTest" y "serverDownloadTest").
  1931. La ruta de la opción '--diskTestPath' debe ser una ruta dentro de la unidad
  1932. física de disco que se va a probar. Si no se especifica ninguna ruta, el
  1933. comando intentará usar la ruta temporal por defecto del sistema.
  1934. La unidad de disco de la ruta especificada debe tener suficiente espacio
  1935. libre para ejecutar la prueba.
  1936. Durante la ejecución del comando, el sistema puede sufrir una caída de
  1937. rendimiento a causa de las pruebas realizadas.
  1938. Test disponibles:
  1939. --serveruploadtest (Defecto). Mide la velocidad de subida de datos
  1940. desde el cliente de Unity VCS al servidor.
  1941. --serverdownloadtest (Defecto). Mide la velocidad de bajada de datos
  1942. desde el servidor de Unity VCS al cliente.
  1943. --disktest (Defecto). Mide la velocidad de lectura y
  1944. escritura de disco.
  1945. --systemnetworkusage Muestra el uso actual de los recursos de red del
  1946. sistema. Se muestran contadores de rendimiento
  1947. de interfaz de red (Network Interface)
  1948. proporcionados por Microsoft Windows.
  1949. Test disponible solo en Microsoft Windows.
  1950. --systemdiskusage Muestra el uso actual de los discos físicos del
  1951. sistema. Se muestran contadores de rendimiento
  1952. de interfaz de red (Network Interface)
  1953. proporcionados por Microsoft Windows.
  1954. Test disponible solo en Microsoft Windows.
  1955. Ejemplos:
  1956. cm iostats MYSERVER:8087 --serveruploadtest --serverdownloadtest --nettotalmb=32
  1957. == CMD_DESCRIPTION_ISSUETRACKER ==
  1958. Obtiene, actualiza o busca el estado de una tarea en el sistema de incidencias
  1959. (issue tracker) especificado.
  1960. == CMD_USAGE_ISSUETRACKER ==
  1961. Sintaxis:
  1962. cm issuetracker <name> status get <task_id> <parameter>[ ...]
  1963. cm issuetracker <name> status update <task_id> <status> <parameter>[ ...]
  1964. cm issuetracker <name> status find <status> <parameter>[ ...]
  1965. cm issuetracker <name> connection check <parameter>[ ...]
  1966. name Nombre del sistema de incidencias.
  1967. Solo Jira está soportado por el momento.
  1968. task_id Número de la tarea que se quiere consultar o actualizar.
  1969. status Estado de tarea válido en el sistema especificado.
  1970. Parámetros de Jira (todos son obligatorios):
  1971. --user=<user> El usuario a autenticar.
  1972. --password=<pwd> La contraseña a autenticar.
  1973. --host=<url> La url del sistema de seguimiento de incidencias.
  1974. --projectkey=<key> La clave del proyecto de Jira.
  1975. == CMD_HELP_ISSUETRACKER ==
  1976. Ejemplos:
  1977. cm issuetracker jira status get 11 --user=user@mail.es --password=pwd \
  1978. --host=https://user.atlassian.net --projectkey=PRJ
  1979. (Obtiene el estado de la tarea 11 para el proyecto 'PRJ'.)
  1980. cm issuetracker jira status update 11 "Done" --user=user@mail.es \
  1981. --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
  1982. (Actualiza el estado a 'Done' de la tarea 11 para el proyecto 'PRJ'.)
  1983. cm issuetracker jira status find "Done" --user=user@mail.es --password=pwd \
  1984. --host=https://user.atlassian.net --projectkey=PRJ
  1985. (Obtiene los ids de las tareas cuyo estado es "Done" en el proyecto 'PRJ'.)
  1986. cm issuetracker jira connection check --user=user@mail.es --password=pwd \
  1987. --host=https://user.atlassian.net --projectkey=PRJ
  1988. (Comprueba si los parámetros de configuración son válidos o no.)
  1989. == CMD_DESCRIPTION_LICENSEINFO ==
  1990. Muestra información de la licencia y de su uso.
  1991. == CMD_USAGE_LICENSEINFO ==
  1992. Sintaxis:
  1993. cm licenseinfo | li [--server=<repserverspec>] [--inactive] [--active]
  1994. [--sort=(name|status)]
  1995. Opciones:
  1996. --server: Obtiene la información de la licencia del servidor
  1997. especificado. Si no se especifica ningún servidor, el
  1998. comando se ejecutará contra el servidor configurado en
  1999. el cliente.
  2000. (Use 'cm help objectspec' para más información sobre
  2001. las especificaciones de servidores.)
  2002. --inactive Muestra únicamente usuarios inactivos en la sección
  2003. "Uso de licencia".
  2004. --active Muestra únicamente usuarios activos en la sección de
  2005. "Uso de licencia".
  2006. --sort Ordena usuarios usando el campo especificado:
  2007. 'name' o 'status'.
  2008. == CMD_HELP_LICENSEINFO ==
  2009. Notas:
  2010. Se muestra información acerca de la fecha de expiración, usuarios activos y
  2011. no activos, etc.
  2012. Ejemplos:
  2013. cm licenseinfo
  2014. cm licenseinfo --server=myserver:8084
  2015. cm licenseinfo --sort=name
  2016. == CMD_DESCRIPTION_LINKTASK ==
  2017. Enlaza un changeset a una tarea de un sistema de control de tareas.
  2018. == CMD_USAGE_LINKTASK ==
  2019. Este comando está pensado para la automatización de otros comandos. Con lo que,
  2020. es posible, que no resulte muy intuitivo.
  2021. Sintaxis:
  2022. cm linktask | lt <csetspec> <ext_prefix> <task_name>
  2023. csetspec Especificación del changeset para enlazarlo a una tarea.
  2024. (Use 'cm help objectspec' para más información sobre las
  2025. especificaciones de changesets.)
  2026. ext_prefix Prefijo del sistema de control de tareas configurado.
  2027. task_name Identificador de la tarea en el sistema de control de tareas.
  2028. == CMD_HELP_LINKTASK ==
  2029. Ejemplos:
  2030. cm lt cs:8@rep:default@repserver:localhost:8084 jira PRJ-1
  2031. == CMD_DESCRIPTION_LOCK_LIST ==
  2032. Muestra los bloqueos de un servidor.
  2033. == CMD_USAGE_LOCK_LIST ==
  2034. Sintaxis:
  2035. cm lock list | ls [<revspec> [ ...]] [--server=<server>] [--anystatus]
  2036. [--repository] [--workingbranch=<brname>] [--anystatus]
  2037. [--onlycurrentuser] [--onlycurrentworkspace]
  2038. [--ignorecase]
  2039. [--machinereadable [--startlineseparator=<sep>]
  2040. [--endlineseparator=<sep>] [--fieldseparator=<sep>]
  2041. [--smartlocks]]
  2042. revspec Si se especifican una o más revisiones, el comando
  2043. mostrará una línea de bloqueo por cada revisión solo si
  2044. el ítem asociado está bloqueado en el servidor.
  2045. Si no se especifica ninguna revisión, el comando mostrará
  2046. todos los ítems bloqueados en el servidor por defecto (o
  2047. en el indicado en la opción '--server').
  2048. Use un espacio en blanco para separar revisiones en caso
  2049. de especificar más de una.
  2050. (Use 'cm help objectspec' para más información sobre las
  2051. especificaciones de revisiones.)
  2052. Opciones:
  2053. --server Especificación del servidor de repositorios.
  2054. Esta opción anula el servidor por defecto que se
  2055. obtiene del espacio de trabajo actual o del fichero
  2056. client.conf.
  2057. (Use 'cm help objectspec' para más información sobre
  2058. las especificaciones de servidores.)
  2059. --repository Especificación del repositorio. Esta opción lista sólo
  2060. los bloqueos del repositorio especificado.
  2061. (Use 'cm help objectspec' para más información sobre
  2062. las especificaciones de repositorios.)
  2063. --workingbranch Nombre de la rama. Esta opción lista sólo los bloqueos
  2064. que aplican a la rama destino de la rama especificada.
  2065. --anystatus Muestra los locks sin filtrar por estado.
  2066. Por defecto, sólo se muestran los locks es estado Locked.
  2067. --onlycurrentuser Filtra el resultado mostrando solo los bloqueos
  2068. llevados a cabo por el usuario actual.
  2069. --onlycurrentworkspace Filtra el resultado mostrando solo los bloqueos
  2070. del espacio de trabajo actual (comparándolos por
  2071. nombre).
  2072. --ignorecase Ignora mayúsculas y minúsculas en las rutas donde
  2073. se usa una especificación de ruta de servidor. Por
  2074. ejemplo, con esta opción, el comando funcionará tanto
  2075. con "/src/foo.c" como con "/sRc/fOO.c".
  2076. --dateformat Configura el formato de salida para la impresión de fechas.
  2077. --machinereadable Muestra el resultado en un formato fácil de parsear.
  2078. --smartlocks Usado con '--^machinereadable', muestra todos los campos
  2079. de los smart locks. Sin él, sólo muestra los campos de
  2080. que mostraba anteriormente. Está opción es necesario para
  2081. manterner la compatibilidad con plugins o integraciones
  2082. antiguas que necesitan el formato anterior.
  2083. --startlineseparator Usado con '--machinereadable', indica cómo deben
  2084. empezar las líneas del resultado.
  2085. --endlineseparator Usado con '--machinereadable', indica cómo deben
  2086. terminar las líneas del resultado.
  2087. --fieldseparator Usado con '--machinereadable', indica cómo deben
  2088. separarse los campos de cada línea resultante.
  2089. == CMD_HELP_LOCK_LIST ==
  2090. Notas:
  2091. El comando muestra una lista de los elementos actualmente bloqueados en el
  2092. servidor por defecto. También acepta una lista de especificaciones de
  2093. revisión; en este caso, solo se mostrarán los bloqueos asociados a los
  2094. elementos especificados.
  2095. Es posible usar también la opción '--server=<server>' para consultar los
  2096. bloqueos en ese servidor en concreto.
  2097. El comando muestra una línea por cada bloqueo en el servidor especificado:
  2098. - Repositorio del elemento bloqueado.
  2099. - Item id del elemento bloqueado.
  2100. - GUID del elemento bloqueado (sólo se imprime con --machinereadable).
  2101. - Fecha de cuando se realizó el bloqueo.
  2102. - Rama de destino donde el bloqueo será liberado.
  2103. - Revision id del elemento bloqueado en la rama de destino.
  2104. - Rama donde se realizó el bloqueo.
  2105. - Revision id del elemento que mantiene el bloqueo.
  2106. - Estado del bloqueo (Locked o Retained)
  2107. - Nombre del usuario que realizó el bloqueo.
  2108. - Nombre del espacio de trabajo donde se realizó el bloqueo.
  2109. - Ruta del elemento bloqueado (formato de ruta de servidor).
  2110. Para el formato --machinereadable sin --smartlocks, los campos mostrados son:
  2111. - GUID del elemento bloqueado.
  2112. - Nombre del usuario que realizó el bloqueo.
  2113. - Nombre del espacio de trabajo donde se realizó el bloqueo.
  2114. - Ruta del elemento bloqueado (formato de ruta de servidor).
  2115. Ejemplos:
  2116. cm lock list
  2117. cm lock ls --server=myserver:8084
  2118. cm lock ls --repository=repo@myserver:8084 --anystatus
  2119. cm lock ls --repository=repo@myserver:8084 --workingbranch=/main/scm21345
  2120. cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
  2121. cm lock ls revid:3521@default itemid:2381@secondary --onlycurrentuser
  2122. cm lock ls --onlycurrentuser --dateformat="yy/dd/MM HH:mm:ss"
  2123. cm lock ls --onlycurrentuser --onlycurrentworkspace
  2124. cm lock list --machinereadable --startlineseparator=">" \
  2125. --endlineseparator="<" --fieldseparator=","
  2126. cm lock list --machinereadable --smartlocks --startlineseparator=">" \
  2127. --endlineseparator="<" --fieldseparator=","
  2128. == CMD_DESCRIPTION_LISTUSERS ==
  2129. Lista usuarios y grupos.
  2130. == CMD_USAGE_LISTUSERS ==
  2131. Sintaxis:
  2132. cm listusers | lu <repserverspec> [--onlyusers] [--onlygroups]
  2133. [--filter= <str_filter>]
  2134. cm listusers | lu <repserverspec> --group=<group_name>
  2135. repserverspec Especificación del servidor de repositorios.
  2136. (Use 'cm help objectspec' para más información sobre
  2137. especificaciones de servidores de repositorio.)
  2138. Opciones:
  2139. --onlyusers Muestra únicamente los usuarios.
  2140. --onlygroups Muestra únicamente los grupos.
  2141. --filter Muestra únicamente los usuarios o grupos que coinciden con
  2142. el filtro especificado.
  2143. --group Muestra únicamente los usuarios que pertenecen a un grupo
  2144. determinado. Esta opción no es compatible con onlyusers,
  2145. onlygroups, ni filter.
  2146. == CMD_HELP_LISTUSERS ==
  2147. Ejemplos:
  2148. cm lu localhost:8084
  2149. (Muestra todos los usuarios del servidor.)
  2150. cm listusers localhost:8084 --onlyusers --filter=m
  2151. (Muestra los usuarios del servidor cuyo nombre contiene 'm'.)
  2152. cm listusers codice@cloud --group=Administrators
  2153. (Muestra los usuarios del grupo Administrators de la organización 'codice@cloud'.)
  2154. == CMD_DESCRIPTION_LOCATION ==
  2155. Muestra la ruta del cliente 'cm'.
  2156. == CMD_USAGE_LOCATION ==
  2157. Sintaxis:
  2158. cm location
  2159. == CMD_HELP_LOCATION ==
  2160. == CMD_DESCRIPTION_LOCK ==
  2161. Este comando permite al usuario gestionar bloqueos.
  2162. == CMD_USAGE_LOCK ==
  2163. Sintaxis:
  2164. cm lock <command> [options]
  2165. Comandos:
  2166. list | ls
  2167. unlock
  2168. Para obtener más información de cada uno de los comandos use lo siguiente:
  2169. cm lock <command> --usage
  2170. cm lock <command> --help
  2171. == CMD_HELP_LOCK ==
  2172. Ejemplos:
  2173. cm lock
  2174. (Si no se especifica un subcomando, se ejecuta por omisión el subcomando 'list'.)
  2175. cm lock list --anystatus
  2176. cm lock unlock itemid:56@myrep@localhost:8084
  2177. cm lock create /main/task@myrep itemid:56@myrep
  2178. == CMD_DESCRIPTION_LOG ==
  2179. Obtiene información sobre revisiones en changesets.
  2180. == CMD_USAGE_LOG ==
  2181. Sintaxis:
  2182. cm log [<csetspec> | <repspec>] [--from=<csetspec_from>] [--allbranches]
  2183. [--ancestors] [--csformat=<str_format>] [--itemformat=<str_format>]
  2184. [--dateformat=<str_date_format>]
  2185. [--xml[=<output_file>]] [--encoding=<name>]
  2186. [--repositorypaths | --fullpaths | --fp]
  2187. Opciones:
  2188. csetspec Obtiene todos los cambios hechos en el changeset
  2189. especificado.
  2190. (Use 'cm help objectspec' para más información sobre las
  2191. especificaciones de changesets.)
  2192. repspec Obtiene todos los cambios hechos en el repositorio
  2193. especificado.
  2194. (Use 'cm help objectspec' para más información sobre las
  2195. especificaciones de repositorios.)
  2196. --from Lista todos los cambios hechos en cada changeset desde
  2197. el changeset especificado en [csetspec_from] hasta el
  2198. changeset especificado en [csetspec].
  2199. El changeset [csetspec_from] no se incluye en la salida.
  2200. Esta opción se ignorará si lo que se proporciona es una
  2201. especificación de repositorio.
  2202. --allbranches Muestra información sobre los changesets creados en un
  2203. intervalo especificado para todas las ramas donde dichos
  2204. changesets se crearon.
  2205. --ancestors Muestra información sobre los changesets accesibles
  2206. a través del padre y de los enlaces de mezcla (enlaces
  2207. de merge) para el changeset especificado en [csetspec].
  2208. Si también se especifica el changeset [csetspec_from],
  2209. este se usará como límite inferior para todas las rutas.
  2210. Nota: Los cambios del changeset no se mostrarán cuando
  2211. se use esta opción.
  2212. --csformat Muestra información del changeset en el formato
  2213. especificado. Consulte las Notas para más información.
  2214. No puede combinarse con --xml.
  2215. --itemformat Muestra información del ítem en el formato especificado.
  2216. Consulte las Notas para más información.
  2217. No puede combinarse con --xml.
  2218. --dateformat Configura el formato de salida para la impresión de fechas.
  2219. --xml Imprime el resultado en formato XML a la salida estándar.
  2220. También es posible especificar un fichero de salida. No
  2221. puede combinarse con --csformat o --itemformat.
  2222. --encoding Usado con la opción --xml, especifica el encoding que se
  2223. usará en la salida XML, por ejemplo, utf-8.
  2224. Consulte la documentación de MSDN en
  2225. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  2226. para obtener la tabla de codificaciones soportadas y su
  2227. formato (al final de la página en la columna "Name").
  2228. --fullpaths, --fp Imprime las rutas completas de espacio de trabajo para
  2229. ficheros y directorios cuando sea posible.
  2230. --repositorypaths Imprime las rutas de repositorio (rutas de servidor) en
  2231. lugar de las rutas de espacio de trabajo. (Esta opción
  2232. anula la opción '--fullpaths'.)
  2233. == CMD_HELP_LOG ==
  2234. Notas:
  2235. - Si no se especifica ningún changeset [csetspec] ni ninguna otra opción,
  2236. el comando muestra información de cada changeset creado en el último mes
  2237. en cada rama.
  2238. - Si solo se especifica la opción '--from', el comando muestra información
  2239. de cada changeset desde el especificado en '--from' hasta el último
  2240. changeset de la rama donde el especificado fue creado.
  2241. - Si la opción '--allbranches' se indica sin ningún intervalo, el comando
  2242. muestra la misma información que aparecería si solo se hubiera especificado
  2243. 'csetspec'.
  2244. - Si se usa la opción '--from', el comando muestra información desde el
  2245. changeset 'csetspec_from'+1 en adelante.
  2246. - El repositorio qe se utiliza para mostrar la información de los changesets
  2247. es el repositorio cargado en la ruta desde donde se ejecuta el comando.
  2248. Este comando acepta una cadena de formato para los ítems ('--itemformat') y
  2249. una cadena de formato para los changesets ('--csformat').
  2250. Los parámetros de salida de '--csformat' son los siguientes:
  2251. {tab} Inserta un tabulador.
  2252. {newline} Inserta una línea nueva.
  2253. {changesetid} Número de changeset.
  2254. {branch} Rama donde se creó el changeset.
  2255. {date} Fecha de creación del changeset.
  2256. {owner} Propietario del changeset.
  2257. {comment} Comentario del changeset.
  2258. {items} Ítems involucrados en el changeset.
  2259. {repository} Repositorio donde existe el changeset.
  2260. {repserver} Nombre del servidor.
  2261. Los parámetros de salida de '--itemformat' son los siguientes:
  2262. {tab} Inserta un tabulador.
  2263. {newline} Inserta una línea nueva.
  2264. {path} Ruta del ítem.
  2265. {branch} Rama donde se creó el changeset.
  2266. {date} Fecha de creación del changeset.
  2267. {owner} Propietario del changeset.
  2268. {shortstatus} Imprime el estado en el formato corto. Vea abajo.
  2269. {fullstatus} Imprime el estado en el formato largo. Vea abajo.
  2270. Formato corto para el estado y su correspondiente formato largo:
  2271. 'A' Added
  2272. 'D' Deleted
  2273. 'M' Moved
  2274. 'C' Changed
  2275. Estas son cadenas válidas de formateo de salida:
  2276. --csformat="{newline}Changeset {changesetid} creado en {date};{tab} ítems cambiados: {items}."
  2277. --itemformat="{newline}El ítem {path} se creó en la rama {branch}."
  2278. --dateformat:
  2279. Para especificar el formato en el que se escribirán las fechas en pantalla.
  2280. Consulte los formatos soportados:
  2281. https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
  2282. Ejemplos:
  2283. cm log
  2284. (Muestra información de todos los changesets creados en el último mes en
  2285. cualquier rama.)
  2286. cm log cs:16
  2287. (Muestra la información de los cambios realizados en el changeset 16 en la
  2288. rama en que se creó dicho changeset.)
  2289. cm log cs:16 --csformat="{newline}Changeset {changesetid} creado el día {date}; \
  2290. {tab} ítems cambiados: {items}."
  2291. (Muestra la información en el formato especificado.)
  2292. cm log --from=cs:20 cs:50
  2293. (Muestra información de todas las revisiones de todos los changesets
  2294. comprendidos entre el 21 y el 50.)
  2295. cm log --from=cs:20 cs:50 --allbranches
  2296. (Muestra información de todas las revisiones de todos los changesets
  2297. comprendidos entre el 21 y el 50 en todas las ramas del repositorio.)
  2298. cm log rep:myrep@localhost:8084
  2299. (Muestra información de todos los changesets creados en el repositorio
  2300. especificado. No hay que especificar ningún espacio de trabajo para ejecutar
  2301. el comando.)
  2302. cm log --from=cs:20@rep:mainRep@localhost:8084
  2303. (Muestra información de todas las revisiones de todos los changesets desde
  2304. el changeset 21. No hay que especificar ningún espacio de trabajo para
  2305. ejecutar el comando porque se está indicando una especificación completa de
  2306. changeset.)
  2307. == CMD_DESCRIPTION_LIST ==
  2308. Lista el contenido de árbol.
  2309. == CMD_USAGE_LIST ==
  2310. Sintaxis:
  2311. cm ls | dir [<paths>[ ...]] [--format=<str_format>] [--symlink]
  2312. [--selector[=<selector_format>]] [--tree=<obj_spec>]
  2313. [-R | -r | --recursive]
  2314. [--xml[=<output_file>]] [--encoding=<name>]
  2315. Opciones:
  2316. paths Lista de rutas a mostrar. Use un espacio en blanco para
  2317. separar rutas.
  2318. Use comillas dobles (" ") para especificar rutas que
  2319. contengan espacios.
  2320. --format Muestra el mensaje de salida en el formato indicado.
  2321. Consulte las Notas para más información. No puede
  2322. combinarse con --xml.
  2323. --symlink Incluye en el checkin al symlink pero no al destino
  2324. (target).
  2325. --selector Obtiene el contenido del selector del espacio de trabajo
  2326. activo.
  2327. Si se especifica un valor para 'selector_format', entonces
  2328. muestra el selector especificado.
  2329. Esta opción está prácticamente obsoleta ya que los
  2330. selectores no son una parte central de Unity VCS desde la
  2331. versión 4.x.
  2332. --tree Lista el árbol en el changeset o rama especificados.
  2333. (Use 'cm help objectspec' para más información sobre
  2334. especificaciones.)
  2335. -R Lista recursivamente.
  2336. --xml Imprime el resultado en formato XML a la salida estándar.
  2337. También es posible especificar un fichero de salida. No
  2338. puede combinarse con --format.
  2339. --encoding Usado con la opción --xml, especifica el encoding que se
  2340. usará en la salida XML, por ejemplo, utf-8.
  2341. Consulte la documentación de MSDN en
  2342. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  2343. para obtener la tabla de codificaciones soportadas y su
  2344. formato (al final de la página en la columna "Name").
  2345. == CMD_HELP_LIST ==
  2346. Notas:
  2347. - Es posible especificar rutas con metacaracteres (*, ?, ...).
  2348. - La lista resultante depende del selector del espacio de trabajo.
  2349. - La salida del comando se puede formatear especificando una cadena de formato.
  2350. - Si no se especifica alguna de estas opciones '--tree' o '--selector',
  2351. entonces la ruta indicada tiene que ser una ruta de servidor ('cm path'),
  2352. por ejemplo, /dir/file.txt, y no una ruta de espacio de trabajo, por
  2353. ejemplo, C:\Users\myuser\mywk\dir\file.txt.
  2354. - Si no se indica ninguna ruta, se asumirá que la ruta de espacio de trabajo
  2355. es el directorio actual. Si se especifica alguna de estas opciones '--tree'
  2356. o '--selector', entonces se asumirá como ruta la raíz ("/").
  2357. La cadena de formato por defecto que se mostrará es:
  2358. "{size,10} {date:dd/MM/yyyy} {date:HH:mm} \
  2359. {type,-6} {location,-12} {checkout,-5} {name} \
  2360. {symlinktarget}"
  2361. Parámetros de formato de salida (opción --format):
  2362. Este comando acepta una cadena de formato para mostrar la salida.
  2363. Los parámetros de salida de este comando son los siguientes:
  2364. {size}
  2365. {formattedsize}
  2366. {date}
  2367. {type}
  2368. dir directorio,
  2369. txt fichero de texto,
  2370. File fichero.
  2371. {location} Por ejemplo: br:branch#cset
  2372. {checkout}
  2373. {name}
  2374. {changeset}
  2375. {path}
  2376. {repspec}
  2377. {owner}
  2378. {revid}
  2379. {parentrevid}
  2380. {itemid}
  2381. {brid}
  2382. {repid}
  2383. {server}
  2384. {symlinktarget}
  2385. {hash}
  2386. {chmod}
  2387. {wkpath} Ruta relativa a la raíz del espacio de trabajo
  2388. {branch}
  2389. {newlocation} cset@branch
  2390. {guid} (El comando tardará más tiempo en resolverse)
  2391. {itemguid}
  2392. {transformed} Muestra la regla aplicada para ítems transformados.
  2393. Lea la Guía del Administrador para más información sobre
  2394. Transformable workspaces:
  2395. https://www.plasticscm.com/download/help/adminguide
  2396. You can customize the 'ls' format setting the PLASTIC_LS_FORMAT environment
  2397. variable.
  2398. Configure la variable de entorno PLASTIC_LS_FORMAT para especificar la
  2399. salida del comando y evitar así tener que especificar un valor para la
  2400. opción '--format' cada vez que ejecute el comando 'cm ls'.
  2401. Ejemplos:
  2402. cm ls
  2403. cm ls c:\workspace\src
  2404. cm ls --format={name}
  2405. (Muestra solo nombres de ficheros.)
  2406. cm ls --symlink
  2407. (Muestra información de los symlinks y no del fichero o directorio al que
  2408. apuntan.)
  2409. cm ls code --selector
  2410. (Muestra el contenido del subdirectorio 'code' del selector del espacio de
  2411. trabajo actual.)
  2412. cm ls /code --selector="rep 'myrep' path '/' branch '/main'"
  2413. (Muestra el contenido del subdirectorio '/code' del selector especificado.
  2414. La ruta se ha especificado en formato servidor.)
  2415. cm ls /code --tree=44@myrep@denver:7070
  2416. (Lista el subdirectorio '/code' en el changeset 44 del repositorio 'myrep'
  2417. en el servidor 'denver:7070'.)
  2418. cm ls /code --tree=br:/main/scm13596@myrep@denver:7070
  2419. (Lista el subdirectorio '/code' en el último changeset de la rama
  2420. '/main/scm13596' del repositorio 'myrep' en el servidor 'denver:7070'.)
  2421. cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070
  2422. (Lista el subdirectorio '/code' en el changeset
  2423. ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 del repositorio 'myrep' en el servidor
  2424. 'denver:7070'.)
  2425. == CMD_DESCRIPTION_TRIGGER_LIST ==
  2426. Lista los triggers de un determinado tipo en un servidor.
  2427. == CMD_USAGE_TRIGGER_LIST ==
  2428. Sintaxis:
  2429. cm trigger | tr list | ls [<subtype-type>] [--server=<repserverspec>]
  2430. [--format=<str_format>]
  2431. Opciones:
  2432. subtype-type Ejecución y operación del trigger.
  2433. (Use 'cm showtriggertypes' para ver la lista de tipos de
  2434. triggers.)
  2435. --server Lista los triggers del servidor especificado.
  2436. Si no se especifica ningún servidor, el comando se
  2437. ejecuta en el servidor configurado en el cliente.
  2438. (Use 'cm help objectspec' para más información sobre
  2439. las especificaciones de servidor.)
  2440. --format Muestra el mensaje de salida en el formato indicado.
  2441. Consulte las Notas para más información.
  2442. == CMD_HELP_TRIGGER_LIST ==
  2443. Notas:
  2444. Si no se especifica el tipo, muestra todos los triggers del servidor.
  2445. Parámetros de formato de salida (opción --format):
  2446. Este comando acepta una cadena de formato para mostrar la salida.
  2447. Los parámetros de salida de este comando son los siguientes:
  2448. {0} Posición del trigger.
  2449. {1} Nombre del trigger.
  2450. {2} Ruta del trigger.
  2451. {3} Propietario del trigger.
  2452. {4} Tipo del trigger.
  2453. {5} Filtro del trigger.
  2454. Ejemplos:
  2455. cm trigger list after-mklabel
  2456. (Lista todos los triggers del tipo 'after-mklabel' en el servidor configurado
  2457. en el cliente.)
  2458. cm tr ls before-mkbranch --server=myserver:8084
  2459. (Lista todos los triggers del tipo 'before-mkbranch' en el servidor
  2460. 'myserver:8084'.)
  2461. == CMD_DESCRIPTION_MANIPULATESELECTOR ==
  2462. Cambia el selector a una fecha.
  2463. == CMD_USAGE_MANIPULATESELECTOR ==
  2464. Este comando está pensado para la automatización de otros comandos. Con lo que,
  2465. es posible, que no resulte muy intuitivo.
  2466. Sintaxis:
  2467. cm manipulateselector | ms [<wk_path> | <wk_spec>] --atdate=<sel_date>
  2468. wk_path Ruta del espacio de trabajo.
  2469. wk_spec Especificación del espacio de trabajo.
  2470. (Use 'cm help objectspec' para más información sobre
  2471. especificaciones de espacios de trabajo.)
  2472. Opciones:
  2473. --atdate Devuelve un selector que recreará el espacio de trabajo con
  2474. los contenidos que se cargarían en la fecha especificada.
  2475. == CMD_HELP_MANIPULATESELECTOR ==
  2476. Notas:
  2477. Si no se indica ni la ruta o la especificación del espacio de trabajo, el
  2478. comando tomará el directorio actual como ruta del espacio de trabajo.
  2479. Ejemplos:
  2480. cm manipulateselector c:\workspace --atdate=yyyy-MM-ddTHH:mm:ss
  2481. cm manipulateselector --atdate=yyyy-MM-ddTHH:mm:ss
  2482. cm manipulateselector > mySelector.txt --atdate=yyyy-MM-ddTHH:mm:ss
  2483. cm manipulateselector wk:build_wk@BUILDER --atdate=yyyy-MM-ddTHH:mm:ss
  2484. == CMD_DESCRIPTION_MERGE ==
  2485. Mezcla una rama con otra.
  2486. == CMD_USAGE_MERGE ==
  2487. Sintaxis:
  2488. cm merge <source_spec> [--merge] [--cherrypicking] [--forced]
  2489. [--mergetype=(onlyone|onlysrc|onlydst|try|forced)]
  2490. [--interval-origin=<csetspec> | --ancestor=<csetspec>]
  2491. [--keepsource | --ks] [--keepdestination | --kd]
  2492. [--automaticresolution=<conflict-types>[;...]]
  2493. [--subtractive] [--mount] [--printcontributors]
  2494. [--noprintoperations] [--silent]
  2495. [(--to=<brspec> | --destination=<brspec>)[--shelve]]
  2496. [--no-dst-changes]
  2497. [-c=<str_comment> | --commentsfile=<comments_file>]
  2498. [--resolveconflict --conflict=<index>
  2499. --resolutionoption=(src|dst|(rename --resolutioninfo=<strname>))
  2500. --mergeresultfile=<path> --solvedconflictsfile=<path>]
  2501. [--nointeractiveresolution]
  2502. [--xml[=<output_file>]] [--encoding=<name>]
  2503. [--machinereadable [--startlineseparator=<sep>]
  2504. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  2505. source_spec Especificación del objeto origen de la mezcla (merge).
  2506. Este puede ser:
  2507. - especificación de una rama: '[br:/]br_name'
  2508. - especificación de una etiqueta: 'lb:lb_name'
  2509. - especificación de un changeset: 'cs:cs_number'
  2510. - especificación de un almacenamiento (shelve): 'sh:shelve_number'
  2511. (Use 'cm help objectspec' para más información sobre
  2512. especificaciones.)
  2513. Opciones:
  2514. --merge Realiza el merge. Si no se especifica esta opción,
  2515. se muestran los conflictos encontrados.
  2516. --cherrypicking Realiza el merge de los cambios incluidos en los
  2517. changesets origen. Esta opción se omitirá si el
  2518. origen del merge es una etiqueta.
  2519. --forced No comprueba si el origen y el destino ya están
  2520. conectados.
  2521. Esta opción solo es válida para el merge de intervalo
  2522. y para el cherry picking.
  2523. --mergetype Especifica el tipo de merge. Consulte las Notas
  2524. para más información.
  2525. --interval-origin Especifica el changeset inicio del intervalo. El
  2526. merge solo tendrá en cuenta las diferencias entre
  2527. el changeset origen y el inicio del intervalo
  2528. especificado.
  2529. --ancestor Alias para '--interval-origin'.
  2530. --keepsource Acepta todos los cambios del contribuidor origen
  2531. para los elementos con conflictos.
  2532. --keepdestination Preserva los cambios del contribuidor destino
  2533. para elementos con conflictos.
  2534. --automaticresolution Opción para resolver conflictos de directorio. Esta
  2535. opción permite elegir automáticamente entre el
  2536. contribuidor origen (source) o el contribuidor
  2537. destino (destination) para resolver el conflicto.
  2538. Use punto y coma (;) para separar los tipos de
  2539. conflicto. Consulte las Notas para más información.
  2540. --subtractive Elimina los cambios introducidos por un merge.
  2541. El parámetro (source_spec) que se pasa al comando
  2542. especifica el origen a partir del cual eliminar los
  2543. cambios. Debe ser un changeset. En el caso de un
  2544. intervalo de changesets, debe utilizar la opción
  2545. '--interval-origin' para definir el inicio del
  2546. intervalo. Para eliminar un cambio, el sistema
  2547. crea una nueva revisión desprotegida con todo el
  2548. contenido anterior excepto los cambios eliminados.
  2549. --mount El punto de montaje del repositorio especificado.
  2550. --printcontributors Muestra los contribuidores (base, origen y destino).
  2551. --noprintoperations Resuelve las mezclas (merges) sin mostrar
  2552. información sobre la resolución.
  2553. --silent Solo se imprimen mensajes en caso de error.
  2554. --to | --destination Realiza una operación de merge-to a la rama de
  2555. especificada con resolución completa de conflictos.
  2556. (Use 'cm help objectspec' para más información sobre
  2557. las especificaciones de ramas.)
  2558. Una mezcla "merge-to" (o mezcla sin espacio de
  2559. trabajo) es una mezcla que se hace en el lado del
  2560. servidor. Mientras que las mezclas normales
  2561. ocurren en un espacio de trabajo mezclando desde
  2562. ("from") una rama, etiqueta o changeset, una mezcla
  2563. "merge-to" tiene lugar en el servidor. Mientras que
  2564. en mezclas normales el destino es el espacio de
  2565. trabajo, en una mezcla "merge-to" se debe
  2566. especificar el destino (por eso se llama "to",
  2567. 'hacia' en inglés).
  2568. Lea la siguiente guía para más información:
  2569. https://www.plasticscm.com/download/help/mergeto
  2570. --shelve Crea un almacenamiento (shelve) con los cambios del
  2571. resultado del merge (además de información de
  2572. trazabilidad de la mezcla) en lugar de crear
  2573. un nuevo changeset. Esta opción no es válida cuando
  2574. el origen del merge es un shelve. Esta opción sólo
  2575. está disponible para el merge del lado del servidor
  2576. (merge-to). Por ello, hay que especificar las
  2577. opciones '--to' y '--merge'.
  2578. --no-dst-changes Asegura que el contribuidor destino no tiene cambios
  2579. (el changeset destino es también el antecesor
  2580. común). Cuando hay cambios en el destino, no se
  2581. permite hacer el merge.
  2582. -c Añade un comentario al changeset que se crea al
  2583. hacer la mezcla.
  2584. --commentsfile Asigna el comentario especificado en el fichero al
  2585. changeset que se crea al hacer la mezcla.
  2586. --resolveconflict (Usado principalmente por plugins. Consulte las
  2587. Notas para más información.)
  2588. Usado para resolver un conflicto de directorio.
  2589. --conflict Usado con '--resolveconflict', especifica el
  2590. índice del conflicto a resolver empezando por 1.
  2591. --resolutionoption Usado con '--resolveconflict', indica el tipo de
  2592. resolución de conflicto. Puede ser una de las
  2593. siguientes opciones: 'src', 'dst', 'rename'.
  2594. Consulte las Notas para más información.
  2595. --resolutioninfo Usado con '--resolveconflict', proporciona el
  2596. nombre que se usará cuando la opción
  2597. '--resolutionoption' es 'rename'.
  2598. --mergeresultfile Usado con '--resolveconflict', guarda en un fichero
  2599. la información del resultado de la mezcla entre
  2600. diferentes llamadas. El fichero especificado se
  2601. crea en la primera llamada y se actualiza en las
  2602. las siguientes llamadas.
  2603. --solvedconflictsfile Usado con '--resolveconflict', guarda en un fichero
  2604. la información de los conflictos solucionados
  2605. entre diferentes llamadas. El fichero especificado
  2606. se crea en la primera llamada y se actualiza en
  2607. las siguientes llamadas.
  2608. --nointeractiveresolution (Usado principalmente por plugins. Consulte las
  2609. Notas para más información.)
  2610. Evita preguntar al usuario cuando hay un conflicto
  2611. manual. Así, por ejemplo, un conflicto de directorio
  2612. no podrá ser resuelto.
  2613. --machinereadable (Usado principalmente por plugins. Consulte las
  2614. Notas para más información.)
  2615. Muestra el resultado en un formato fácil de parsear.
  2616. --xml Imprime el resultado en formato XML a la salida estándar.
  2617. También es posible especificar un fichero de salida. No
  2618. puede combinarse con --format ni --resolveconflict.
  2619. --encoding Usado con la opción --xml, especifica el encoding que se
  2620. usará en la salida XML, por ejemplo, utf-8.
  2621. Consulte la documentación de MSDN en
  2622. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  2623. para obtener la tabla de codificaciones soportadas y su
  2624. formato (al final de la página en la columna "Name").
  2625. --startlineseparator Usado con '--machinereadable', indica cómo deben
  2626. empezar las líneas del resultado. (Por defecto,
  2627. una cadena de texto vacía.)
  2628. --endlineseparator Usado con '--machinereadable', indica cómo deben
  2629. terminar las líneas del resultado. (Por defecto,
  2630. una cadena de texto vacía.)
  2631. --fieldseparator Usado con '--machinereadable', indica cómo deben
  2632. separarse los campos de cada línea resultante.
  2633. (Por defecto, un espacio en blanco.)
  2634. == CMD_HELP_MERGE ==
  2635. Notas:
  2636. Este comando se utiliza para meclar cambios entre dos ramas, o entre una
  2637. etiqueta y una rama. El destino del merge siempre debe ser una rama.
  2638. El origen del merge se especifica como argumento.
  2639. El destino es el contenido actual del espacio de trabajo.
  2640. Por ejemplo, para mostrar los elementos que se mezclarán desde la rama
  2641. task001 a la rama principal, el selector debe apuntar a la rama principal,
  2642. el espacio de trabajo debe estar actualizado, y entonces ejecutar:
  2643. cm merge br:/task001
  2644. Para que el merge se realice, hay que añadir la opción '--merge':
  2645. cm merge br:/task001 --merge
  2646. Para definir el origen de la mezcla, puede usar las siguientes especificaciones:
  2647. - Especificación de rama (brspec):
  2648. [br:/]br_name
  2649. Por ejemplo: br:/main/task001
  2650. (Mezcla desde el último changeset de la rama especificada.)
  2651. - Especificación de etiqueta (lbspec):
  2652. lb:lb_name
  2653. Por ejemplo: lb:BL001
  2654. (Mezcla desde el último changeset etiquetado.)
  2655. - Especificación de changeset (csetspec):
  2656. cs:cs_number
  2657. Por ejemplo: cs:25
  2658. (Mezcla desde el contenido del changeset especificado.)
  2659. - Especificación de almancenamiento o shelve (shspec):
  2660. sh:shelve_number
  2661. Por ejemplo: sh:2
  2662. (Mezcla desde el contenido del shelve.)
  2663. Para resolver automáticamente conflictos de directorio use la opción
  2664. "--automaticresolution" y especifique el tipo de conflicto seguido por el
  2665. contribuidor (origen o destino) que se seleccionará durante el merge.
  2666. (Separe cada par "tipo de conflicto"-"contribuidor" con punto y coma (;).)
  2667. Por ejemplo:
  2668. cm merge cs:2634 --merge --automaticresolution=eviltwin-src;changedelete-src
  2669. (La operación de merge desde el changeset 2634 resuelve los conflictos
  2670. "eviltwin" y "changedelete" manteniendo al contribuidor origen ("-src")
  2671. en ambos conflictos.)
  2672. - El sufijo "-src" añadido después del tipo de conflicto indica al comando
  2673. merge que debe mantener los cambios del contribuidor origen (source).
  2674. - El sufijo "-dst" mantendrá los cambios del contribuidor destino
  2675. (destination).
  2676. Esta es la lista de tipos de conflictos que soporta el comando merge:
  2677. "movedeviltwin", "eviltwin", "changedelete", "deletechange", "movedelete",
  2678. "deletemove", "loadedtwice", "addmove", "moveadd", "divergentmove",
  2679. "cyclemove", "all".
  2680. El valor "all" anula el resto de opciones. En el siguiente ejemplo, el
  2681. conflicto "eviltwin-dst" será ignorado:
  2682. cm merge br:/main/task062 --merge --automaticresolution=all-src;eviltwin-dst
  2683. Consulte el siguiente enlace para más información sobre conflictos de merge:
  2684. https://www.plasticscm.com/download/help/directorymerges
  2685. Estas son los valores para la opción --mergetype:
  2686. onlyone Merge automático si solo uno de los contribuidores modificó
  2687. el elemento.
  2688. onlysrc Merge automático si solo el contribuidor origen modificó el
  2689. elemento.
  2690. onlydst Merge automático si solo el contribuidor destino modificó el
  2691. elemento.
  2692. try Merge automático si solo un contribuidor ha modificado la
  2693. parte del fichero en conflicto (para cada conflicto).
  2694. forced Intenta resolver siempre los conflictos no automáticos.
  2695. Estas son las opciones que se usan principalmente por plugins e integraciones:
  2696. - "--resolveconflict" para resolver un conflicto de directorio. Se
  2697. deben usar las siguientes opciones:
  2698. - "--conflict" es el índice del conflicto que se quiere resolver
  2699. (empezando por 1).
  2700. - "--resolutionoption" indica el tipo de resolución de conflicto.
  2701. Puede ser:
  2702. - "src" para mantener el cambio del origen y descartar el
  2703. cambio del destino
  2704. - "dst" para mantener el cambio del destino y descartar el
  2705. cambio del origen
  2706. - "rename" (solo si el tipo de conflicto soporta esta
  2707. resolución) para renombar el destino al nombre
  2708. proporcionado en la opción "--resolutioninfo".
  2709. - "--resolutioninfo" para proporcionar el nombre a usar
  2710. con el tipo de resolución "rename"
  2711. - "--mergeresultfile" y "--solvedconflictsfile", ambos se usan
  2712. para guardar informacación de la mezcla entre las diferentes
  2713. llamadas.
  2714. - "nointeractiveresolution" indica a la mezcla que no pregunte al usuario
  2715. en caso de necesitarse una resolución manual de un conflicto.
  2716. - "--machinereadable" y "--startlineseparator", "--endlineseparator",
  2717. "fieldseparator" se usan para imprimir la salida a un formato fácil
  2718. de leer, tratar o parsear.
  2719. Por ejemplo:
  2720. cm merge --machinereadable --startlineseparator=start@_@line \
  2721. --endlineseparator=new@_@line --fieldseparator=def#_#sep \
  2722. --mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \
  2723. --solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \
  2724. --resolveconflict --conflict=1 --resolutionoption=rename \
  2725. --resolutioninfo=bin_dst br:/main/task --merge
  2726. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  2727. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  2728. configurada pero no se indica ningún comentario, el editor se abrirá para
  2729. que pueda escribir el comentario.
  2730. Ejemplos:
  2731. cm merge br:/task001
  2732. (No realiza la mezcla, simplemente muestra los elementos que se van a
  2733. mezclar.)
  2734. cm merge br:/task001 --merge
  2735. (Realiza el merge desde la rama task001.)
  2736. cm merge cs:5 --merge --cherrypicking --interval-origin=cs:2
  2737. (Cherry pick del intervalo de changesets (2,5].)
  2738. cm merge cs:8 --merge --subtractive --keepdestination
  2739. (Merge sustractivo del changeset 8, preservando los cambios del destino
  2740. para aquellos elementos con conflictos.)
  2741. cm merge br:/main/task001 --to=br:/main --merge -c="Integrated new UI"
  2742. (Realiza el merge en el lado del servidor -a.k.a. "merge-to"-, desde la
  2743. rama 'task001' hasta la rama 'main' y añade un comentario.)
  2744. cm merge br:/main/task001 --to=br:/main --merge --shelve
  2745. (Realiza el merge en el lado del servidor desde la rama 'task001' a la rama
  2746. 'main' y deja el resultado en un shelve.)
  2747. cm merge sh:2 --to=br:/main --merge --no-dst-changes
  2748. (Aplica el shelve 2 en la rama 'main' solo si fue creado desde la cabeza
  2749. actual de 'main'.)
  2750. == CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
  2751. Crea un atributo nuevo.
  2752. == CMD_USAGE_ATTRIBUTE_CREATE ==
  2753. Sintaxis:
  2754. cm attribute | att create | mk <att_name>
  2755. att_name Nombre del atributo.
  2756. == CMD_HELP_ATTRIBUTE_CREATE ==
  2757. Notas:
  2758. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  2759. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  2760. configurada pero no se indica ningún comentario, el editor se abrirá para
  2761. que pueda escribir el comentario.
  2762. Ejemplos:
  2763. cm attribute create status
  2764. (Crea el atributo 'status'.)
  2765. cm att mk integrated
  2766. (Crea el atributo 'integrated'.)
  2767. == CMD_DESCRIPTION_BRANCH ==
  2768. Permite al usuario gestionar ramas.
  2769. == CMD_USAGE_BRANCH ==
  2770. Sintaxis:
  2771. cm branch | br <command> [options]
  2772. Comandos:
  2773. create | mk
  2774. delete | rm
  2775. rename
  2776. history
  2777. showmain
  2778. showmerges
  2779. Para obtener más información sobre cada comando:
  2780. cm branch command --usage
  2781. cm branch command --help
  2782. == CMD_HELP_BRANCH ==
  2783. Ejemplos:
  2784. cm branch /main/scm21345
  2785. cm branch create /main/scm21345
  2786. cm branch delete /main/scm21345
  2787. cm branch rename /main/scm21345 scm21346
  2788. cm branch history /main/scm21345
  2789. cm branch showmain
  2790. cm branch showmerges file.txt
  2791. == CMD_DESCRIPTION_BRANCH_CREATE ==
  2792. Crea una rama.
  2793. == CMD_USAGE_BRANCH_CREATE ==
  2794. Sintaxis:
  2795. cm branch | br [create | mk] <brspec>
  2796. [--changeset=<csetspec> | --label=<lbspec>]
  2797. [-c=<str_comment> | -commentsfile=<comments_file>]
  2798. brspec Nombre o especificación de la nueva rama.
  2799. (Use 'cm help objectspec' para más información sobre
  2800. especificaciones de ramas.)
  2801. Opciones:
  2802. --changeset Changeset usado como punto de partida de la nueva rama.
  2803. (Use 'cm help objectspec' para más información sobre
  2804. especificaciones de changesets.)
  2805. --label Etiqueta usada como punto de partida de la nueva rama.
  2806. (Use 'cm help objectspec' para más información sobre
  2807. especificaciones de ramas.)
  2808. -c Asigna el comentario especificado a la nueva rama.
  2809. --commentsfile Asigna el comentario especificado en el fichero a la
  2810. nueva rama.
  2811. == CMD_HELP_BRANCH_CREATE ==
  2812. Notas:
  2813. Para crear una rama de primer nivel, especifique el nombre sin jerarquía.
  2814. Por ejemplo:
  2815. cm br /dev
  2816. Si no se especifica el parámetro '--changeset', la base de la nueva rama
  2817. será el último changeset de la rama madre. En caso de que la rama sea de
  2818. primer nivel, se utilizará como base el changeset 0.
  2819. Para especificar comentarios use la opción "-c" o "-m" del siguiente modo:
  2820. cm branch main/task001 -c="Este es el comentario"
  2821. cm branch main/task001 -m "Este es el comentario"
  2822. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  2823. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  2824. configurada pero no se indica ningún comentario, el editor se abrirá para
  2825. que pueda escribir el comentario.
  2826. Ejemplos:
  2827. cm branch task001
  2828. cm branch create task001
  2829. cm branch mk task001
  2830. cm br mk task001
  2831. (Todos los ejemplos anteriores, crean una rama de primer nivel llamada
  2832. 'task001' en el repositorio del espacio de trabajo actual.)
  2833. cm branch br:/task001/task002
  2834. (Crea la rama 'task002' como hija de 'task001'.)
  2835. cm br /main/task001@myrep@myserver:8084 -c="my comment"
  2836. (Crea la rama 'task001' como hija de 'main' en el repositorio
  2837. 'myrepo@myserver:8084' y asigna como comentario el texto 'my comment'.)
  2838. cm br mk br:/main/task001 --changeset=2837 -commentsfile=commenttask001.txt
  2839. (Crea la rama 'task001' como hija de 'main' con base el changeset '2837'
  2840. y asigna como comentario el texto del fichero 'commenttask001.txt'.)
  2841. == CMD_DESCRIPTION_BRANCH_DELETE ==
  2842. Borra una o más ramas.
  2843. == CMD_USAGE_BRANCH_DELETE ==
  2844. Sintaxis:
  2845. cm branch | br delete | rm <brspec>[ ...]
  2846. brspec Rama a borrar. Use un espacio en blanco para separar ramas.
  2847. (Use 'cm help objectspec' para más información sobre
  2848. especificaciones de ramas.)
  2849. == CMD_HELP_BRANCH_DELETE ==
  2850. Notas:
  2851. Este comando borra una o más ramas.
  2852. Ejemplos:
  2853. cm branch delete /main/task001
  2854. (Borra la rama con nombre 'task001' que es hija de 'main' en el repositorio
  2855. del espacio de trabajo actual.)
  2856. cm br rm main/task002 /main/task012@reptest@myserver:8084
  2857. (Borra la rama '/main/task002' del repositorio del espacio de trabajo actual
  2858. y la rama '/main/task012' del repositorio 'reptest@myserver:8084'.)
  2859. == CMD_DESCRIPTION_BRANCH_RENAME ==
  2860. Renombra una rama.
  2861. == CMD_USAGE_BRANCH_RENAME ==
  2862. Sintaxis:
  2863. cm branch | br rename <brspec> <new_name>
  2864. brspec Rama a renombrar.
  2865. (Use 'cm help objectspec' para más información sobre
  2866. especificaciones de ramas.)
  2867. new_name Nuevo nombre para la rama.
  2868. == CMD_HELP_BRANCH_RENAME ==
  2869. Notas:
  2870. Este comando renombra una rama.
  2871. Ejemplos:
  2872. cm branch rename /main/task0 task1
  2873. (Renombra la rama '/main/task0' a '/main/task1'.)
  2874. cm br rename br:/main@reptest@server2:8084 secondary
  2875. (Renombra la rama 'main' del repositorio 'reptest' a 'secondary'.)
  2876. == CMD_DESCRIPTION_BRANCH_HISTORY ==
  2877. Muestra la historia de una rama.
  2878. == CMD_USAGE_BRANCH_HISTORY ==
  2879. Sintaxis:
  2880. cm branch | br history <brspec> [--dateformat=<date_format>]
  2881. [--machinereadable]
  2882. brspec Especificación de la rama de la que obtener la historia.
  2883. (Use 'cm help objectspec' para más información sobre
  2884. especificaciones de ramas.)
  2885. Opciones:
  2886. --dateformat Configura el formato de salida para la impresión de
  2887. fechas.
  2888. --machinereadable Muestra el resultado en un formato fácil de parsear.
  2889. == CMD_HELP_BRANCH_HISTORY ==
  2890. Ejemplos:
  2891. cm branch history br:/main/scm001@myrepository@myserver:8084
  2892. (Muestra la historia de la rama '/main/scm001' del repositorio 'myrepository'
  2893. en el servidor 'myserver'.)
  2894. cm br history main --dateformat="yyyy, dd MMMM" --machinereadable
  2895. (Muestra la historia de la rama 'main' del repositorio actual con un formato
  2896. de fecha determinado y con un formato sencillo de parsear.)
  2897. == CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
  2898. Muestra la rama principal de un repositorio.
  2899. Con toda probabilidad, la rama principal de sus repositorios se denominará '/main'.
  2900. Este comando está pensado para la automatización de otros comandos.
  2901. == CMD_USAGE_BRANCH_SHOWMAIN ==
  2902. Sintaxis:
  2903. cm branch | br showmain [<repspec>] [--encoding=<name>]
  2904. [--format=<format_str>] [--dateformat=<date_format>]
  2905. repspec Especificación del repositorio de donde mostrar la rama principal.
  2906. Si no se especifica ningún repositorio, se mostrará la rama
  2907. principal del repositorio del espacio de trabajo actual.
  2908. (Use 'cm help objectspec' para más información sobre
  2909. especificaciones de repositorio.)
  2910. Opciones:
  2911. --encoding Especifica el encoding que se usará en la salida, por
  2912. ejemplo, utf-8. Consulte la documentación de MSDN en
  2913. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  2914. para obtener la tabla de codificaciones soportadas y
  2915. su formato (al final de la página en la columna "Name").
  2916. --format Muestra el mensaje de salida en el formato indicado.
  2917. Consulte las Notas para más información.
  2918. --dateformat Configura el formato de salida para la impresión de fechas.
  2919. == CMD_HELP_BRANCH_SHOWMAIN ==
  2920. Notas:
  2921. Este comando muestra la rama principal de un repositorio.
  2922. Parámetros de formato de salida (opción --format):
  2923. Este comando acepta una cadena de formato para mostrar la salida.
  2924. Los parámetros de salida de este comando son los siguientes:
  2925. {id} Id de la rama.
  2926. {comment} Comentario.
  2927. {date} Fecha.
  2928. {name} Nombre.
  2929. {owner} Propietario.
  2930. {parent} Nombre de la rama madre.
  2931. {repository} Repositorio.
  2932. {repname} Nombre del repositorio.
  2933. {repserver} Servidor.
  2934. {changeset} Último changeset de la rama (head).
  2935. Ejemplos:
  2936. cm branch showmain
  2937. (Muestra la rama principal del repositorio del espacio de trabajo actual.)
  2938. cm branch showmain repo@server:8084
  2939. (Muestra la rama principal del repositorio 'repo' en el servidor
  2940. 'server:8084'.)
  2941. cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8
  2942. (Muestra la rama principal del repositorio con las fechas en un determinado
  2943. formato y la salida codificada en utf-8.)
  2944. cm br showmain --format="{id} - {name}"
  2945. (Muestra la rama principal del repositorio mostrando únicamente su id y
  2946. nombre.)
  2947. == CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
  2948. Muestra las ramas que están pendientes de mezclar (merge).
  2949. == CMD_USAGE_BRANCH_SHOWMERGES ==
  2950. Este comando está pensado para la automatización de otros comandos. Con lo que,
  2951. es posible, que no resulte muy intuitivo.
  2952. Sintaxis:
  2953. cm branch | br showmerges <item_path>[ ...]
  2954. [--format=<format_str>]
  2955. [--dateformat=<date_format>]
  2956. Opciones:
  2957. --format Muestra el mensaje de salida en el formato indicado.
  2958. Consulte las Notas para más información.
  2959. --dateformat Configura el formato de salida para la impresión de fechas.
  2960. == CMD_HELP_BRANCH_SHOWMERGES ==
  2961. Notas:
  2962. Parámetros de formato de salida (opción --format):
  2963. Este comando acepta una cadena de formato para mostrar la salida.
  2964. Los parámetros de salida de este comando son los siguientes:
  2965. {id} Id de la rama.
  2966. {comment} Comentario.
  2967. {date} Fecha.
  2968. {name} Nombre.
  2969. {owner} Propietario.
  2970. {parent} Nombre de la rama madre.
  2971. {parentid} Id de la rama madre.
  2972. {repid} Id del repositorio.
  2973. {repository} Repositorio.
  2974. {repname} Nombre del repositorio.
  2975. {repserver} Servidor del repositorio.
  2976. Ejemplos:
  2977. cm branch showmerges file.txt
  2978. (Muestra las ramas involucradas en el merge pendiente del fichero file.txt.)
  2979. cm branch showmerges file.txt --format="{date} {name}" --dateformat="ddMMyy"
  2980. (Muestra las ramas involucradas en el merge mostrando solo la fecha y el
  2981. nombre y con las fechas en un determinado formato.)
  2982. == CMD_DESCRIPTION_REPOSITORY ==
  2983. Permite al usuario administrar repositorios.
  2984. == CMD_USAGE_REPOSITORY ==
  2985. Sintaxis:
  2986. cm repository | repo <command> [options]
  2987. Comandos:
  2988. create | mk
  2989. delete | rm
  2990. list | ls
  2991. rename
  2992. add
  2993. Para obtener más información sobre cada comando:
  2994. cm repository <command> --usage
  2995. cm repository <command> --help
  2996. == CMD_HELP_REPOSITORY ==
  2997. Ejemplos:
  2998. cm repository
  2999. cm repository list
  3000. cm repository newrepo
  3001. cm repository create newrepo
  3002. cm repository rename oldname newname
  3003. cm repository add C:\repo\
  3004. == CMD_DESCRIPTION_REPOSITORY_CREATE ==
  3005. Crea un repositorio en un servidor.
  3006. == CMD_USAGE_REPOSITORY_CREATE ==
  3007. Sintaxis:
  3008. cm repository | repo <rep_name>
  3009. cm repository | repo <repserverspec> <rep_name>[ ...]
  3010. cm repository | repo [create | mk] <rep_name>
  3011. repserverspec Especificación del servidor de repositorios.
  3012. (Use 'cm help objectspec' para más información sobre
  3013. especificaciones de repositorios de servidor.)
  3014. rep_name Nombre del nuevo repositorio. Use un espacio en
  3015. blanco para separar nombres de repositorio.
  3016. == CMD_HELP_REPOSITORY_CREATE ==
  3017. Ejemplos:
  3018. cm repository MyRep
  3019. cm repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
  3020. cm repo create Rep01
  3021. cm repo mk list
  3022. == CMD_DESCRIPTION_REPOSITORY_DELETE ==
  3023. Borra un repositorio de un servidor.
  3024. == CMD_USAGE_REPOSITORY_DELETE ==
  3025. Sintaxis:
  3026. cm repository | repo delete | rm <repspec>
  3027. repspec Especificación del repositorio.
  3028. (Use 'cm help objectspec' para más información sobre
  3029. especificaciones de repositorios.)
  3030. == CMD_HELP_REPOSITORY_DELETE ==
  3031. Nota:
  3032. Borra un repositorio del servidor de repositorios.
  3033. No borra los datos de la base de datos; simplemente "desconecta" el
  3034. repositorio de la base de datos para que no sean accesibles. (Los datos
  3035. se pueden "reconectar" de nuevo con el comando 'cm repository add'.)
  3036. Ejemplos:
  3037. cm repository delete myrepository@repserver:myserver:8084
  3038. cm repository rm myrepository@myserver:8084
  3039. cm repo rm myrepository
  3040. == CMD_DESCRIPTION_REPOSITORY_LIST ==
  3041. Lista los repositorios de un servidor.
  3042. == CMD_USAGE_REPOSITORY_LIST ==
  3043. Sintaxis:
  3044. cm repository | repo [list | ls] [<repserverspec>] [--format=<str_format>]
  3045. repserverspec Especificación del servidor de repositorios.
  3046. (Use 'cm help objectspec' para más información sobre
  3047. especificaciones de servidor de repositorios.)
  3048. --format Muestra el mensaje de salida en el formato indicado.
  3049. Consulte las Notas para más información.
  3050. == CMD_HELP_REPOSITORY_LIST ==
  3051. Notas:
  3052. Parámetros de formato de salida (opción --format):
  3053. Este comando acepta una cadena de formato para mostrar la salida.
  3054. Los parámetros de salida de este comando son los siguientes:
  3055. {repid} | {0} Identificador del repositorio.
  3056. {repname} | {1} Nombre del repositorio.
  3057. {repserver} | {2} Nombre del servidor del repositorio.
  3058. {repowner} | {3} Propietario del repositorio.
  3059. {repguid} | {4} Identificador único del repositorio.
  3060. {tab} Inserta un tabulador.
  3061. {newline} Inserta una nueva línea.
  3062. Si el valor de opción '--format' es 'TABLE', la salida se imprimirá en formato
  3063. tabla con los siguientes campos: {repid}, {repname} y {repserver}.
  3064. Ejemplos:
  3065. cm repository
  3066. (Lista todos los repositorios.)
  3067. cm repository list localhost:8084 --format="{1, -20} {3}"
  3068. (Muestra el nombre del repositorio utilizando 20 espacios y alineado a la
  3069. izquierda, un espacio y el propietario del repositorio.)
  3070. cm repository ls localhost:8084 --format="{repname, -20} {repowner}"
  3071. (Muestra el mismo resultado que el ejemplo anterior.)
  3072. cm repo ls localhost:8084 --format=TABLE
  3073. (Muestra la lista de repositorios en formato tabla con los siguientes
  3074. campos: id del repositorio, nombre del repositorio, y el nombre del servidor
  3075. de repositorios.)
  3076. == CMD_DESCRIPTION_REPOSITORY_RENAME ==
  3077. Renombra un repositorio.
  3078. == CMD_USAGE_REPOSITORY_RENAME ==
  3079. Sintaxis:
  3080. cm repository | repo rename [<repspec>] <new_name>
  3081. repspec Repositorio a renombrar.
  3082. (Use 'cm help objectspec' para más información sobre
  3083. especificaciones de repositorio.)
  3084. new_name Nuevo nombre para el repositorio.
  3085. == CMD_HELP_REPOSITORY_RENAME ==
  3086. Notas:
  3087. Este comando renombre un repositorio.
  3088. Si no se proporciona ninguna especificación de repositorio, el comando tomará
  3089. por defecto el repositorio actual.
  3090. Ejemplos:
  3091. cm repository rename development
  3092. (El repositorio actual se renombra a 'development'.)
  3093. cm repo rename rep:default@SERVER:8084 development
  3094. (El repositorio 'default' del servidor 'SERVER' se renombra a 'development'.)
  3095. == CMD_DESCRIPTION_REPOSITORY_ADD ==
  3096. Conecta un repositorio existente añadiendo su base de datos.
  3097. == CMD_USAGE_REPOSITORY_ADD ==
  3098. Sintaxis:
  3099. cm repository | repo add <db_file> <rep_name> <repserverspec>
  3100. db_file Nombre del fichero de la base de datos.
  3101. rep_name Nombre del repositorio.
  3102. repserverspec Especificación del servidor de repositorios.
  3103. (Use 'cm help objectspec' para más información sobre
  3104. especificaciones de servidor de repositorios.)
  3105. == CMD_HELP_REPOSITORY_ADD ==
  3106. Nota:
  3107. Reconecta una base de datos de repositorio ya existente al servidor. Este
  3108. comando es útil para mover un repositorio de un servidor a otro, o para
  3109. restaurar o reconectar un repositorio después de haber usado el comando
  3110. 'cm repository delete'.
  3111. Ejemplos:
  3112. cm repository add rep_27 myrepository myserver:8084
  3113. == CMD_DESCRIPTION_TRIGGER_CREATE ==
  3114. Crea un nuevo trigger en un servidor.
  3115. == CMD_USAGE_TRIGGER_CREATE ==
  3116. Sintaxis:
  3117. cm trigger | tr create | mk <subtype-type> <new_name> <script_path>
  3118. [--position=<new_position>]
  3119. [--filter=<str_filter>]
  3120. [--server=<repserverspec>]
  3121. subtype-type Ejecución y operación del trigger.
  3122. (Use 'cm showtriggertypes' para ver la lista de tipos de
  3123. triggers.)
  3124. new_name Nombre del nuevo trigger.
  3125. script_path Ruta en disco del servidor donde se encuentra el script
  3126. a ejecutar. Si la línea comienza con "webtrigger ", el
  3127. trigger entenderá que se trata de un trigger web.
  3128. Consulte las Notas para más información.
  3129. Opciones:
  3130. --position Posición para el trigger especificado. Esta posición no
  3131. tiene que estar en uso por ningún otro trigger del mismo
  3132. tipo.
  3133. --filter Comprueba solo los ítems que concuerdan con el filtro
  3134. especificado.
  3135. --server Crea el trigger en el servidor especificado.
  3136. Si no se especifica ningún servidor, el comando se
  3137. ejecuta en el servidor configurado en el cliente.
  3138. (Use 'cm help objectspec' para más información sobre
  3139. las especificaciones de servidor.)
  3140. == CMD_HELP_TRIGGER_CREATE ==
  3141. Notas:
  3142. Web triggers: Para crear triggers web escriba "webtrigger <target-uri>"
  3143. como comando de trigger. En este caso, el trigger ejecutará una consulta
  3144. POST contra el URI especificado (donde el cuerpo de la petición contiene un
  3145. diccionario JSON con las variables de entorno del trigger) y una clave INPUT
  3146. apuntando a un array de cadenas de texto.
  3147. Ejemplos:
  3148. cm trigger create after-setselector "BackupMgr" "/path/to/script" --position=4
  3149. cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
  3150. cm tr mk after-mklabel Log "/path/to/script" --filter="rep:myRep,LB*"
  3151. (Este trigger se ejecutará solo si la etiqueta ha sido creada en el
  3152. repositorio 'myRep' y si el nombre de la etiqueta comienza por 'LB'.)
  3153. cm tr mk after-checkin NotifyTeam "webtrigger http://myserver.org/api"
  3154. == CMD_DESCRIPTION_MOVE ==
  3155. Mueve o renombra un ítem.
  3156. == CMD_USAGE_MOVE ==
  3157. Sintaxis:
  3158. cm move ruta_origen ruta_destino
  3159. ruta_origen: Ruta origen del ítem.
  3160. ruta_destino: Ruta destino del ítem.
  3161. == CMD_HELP_MOVE ==
  3162. Notas:
  3163. Este comando mueve o renombra un ítem en el repositorio.
  3164. Los cambios también se realizan en el sistema de ficheros local.
  3165. Si la ruta de origen es un fichero, el destino puede ser un fichero o un
  3166. directorio. En el primer caso, el fichero se renombra, si no, el ítem se
  3167. mueve al directorio destino.
  3168. Si la ruta de origen es un directorio, la ruta destino ha de serlo también.
  3169. Requisitos para mover o renombrar un ítem:
  3170. El ítem ha de estar controlado por Unity VCS.
  3171. El directorio padre del ítem origen y del ítem destino han de estar desprotegidos.
  3172. Ejemplos:
  3173. cm move fichero.txt fichero.old (renombra el ítem)
  3174. cm move .\fichero.old .\antiguos (mueve fichero.old al directorio antiguos)
  3175. cm move .\src .\src2 (renombra el directorio)
  3176. == CMD_DESCRIPTION_LABEL ==
  3177. Este comando permite al usuario efectuar operaciones con etiquetas.
  3178. == CMD_USAGE_LABEL ==
  3179. Sintaxis:
  3180. cm label | lb command [options]
  3181. Comandos:
  3182. create | mk
  3183. delete | rm
  3184. rename
  3185. Para obtener más información sobre cada uno de los comandos ejecute:
  3186. cm label command --usage
  3187. cm label command --help
  3188. == CMD_HELP_LABEL ==
  3189. Ejemplos
  3190. cm label myNewLabel cs:42
  3191. (el comando 'create' es opcional)
  3192. cm label rename myNewLabel newLabelName
  3193. cm label delete newLabelName
  3194. == CMD_DESCRIPTION_LABEL_CREATE ==
  3195. Crea una etiqueta nueva o etiqueta una changeset dado.
  3196. == CMD_USAGE_LABEL_CREATE ==
  3197. Sintaxis:
  3198. cm label [create] spec_etiqueta [spec_changeset | ruta]
  3199. [--allxlinkedrepositories]
  3200. [-c=str_comment | -commentsfile=<comments_file>]
  3201. spec_etiqueta: Especificación de la etiqueta. Usa 'cm help objectspec' para
  3202. obtener más información sobre especificaciones.
  3203. spec_changeset: Nombre o especificación del changeset a etiquetar. Usa
  3204. 'cm help objectspec' para obtener más información sobre especificaciones.
  3205. ruta: Ruta del workspace a etiquetar
  3206. Si no se especifica spec_changeset ni ruta se asumirá el directorio actual
  3207. como workspace a etiquetar.
  3208. Opciones:
  3209. --allxlinkedrepositories (-s): Crea la etiqueta en todos los repositorios
  3210. enlazados.
  3211. -c: Añade un comentario a la etiqueta creada.
  3212. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  3213. == CMD_HELP_LABEL_CREATE ==
  3214. Notas:
  3215. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  3216. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  3217. configurada pero no se indica ningún comentario, el editor se abrirá para
  3218. que pueda escribir el comentario.
  3219. Ejemplos:
  3220. cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt
  3221. cm label BL002 cs:=1203 -c="first release"
  3222. == CMD_DESCRIPTION_LABEL_DELETE ==
  3223. Borra una o más etiquetas.
  3224. == CMD_USAGE_LABEL_DELETE ==
  3225. Sintaxis:
  3226. cm label delete spec_etiqueta1 spec_etiqueta2 ...
  3227. spec_etiqueta: Etiquetas a borrar, separadas por espacios.
  3228. Usa 'cm help objectspec' para obtener más información
  3229. sobre la especificación de etiquetas.
  3230. == CMD_HELP_LABEL_DELETE ==
  3231. Notas:
  3232. Este comando borra una o más etiquetas creadas previamente.
  3233. Ejemplos:
  3234. cm label delete lb:BL001 (Se borra la etiqueta 'BL001')
  3235. cm label delete lb:BL001 lb:BL002
  3236. == CMD_DESCRIPTION_LABEL_RENAME ==
  3237. Renombra una etiqueta.
  3238. == CMD_USAGE_LABEL_RENAME ==
  3239. Sintaxis:
  3240. cm label rename spec_etiqueta nuevo_nombre
  3241. sepec_etiqueta: Especificación de la etiqueta que se va a renombrar.
  3242. Usa 'cm help objectspec' para obtener más información sobre
  3243. la especificación de etiquetas.
  3244. nuevo_nombre: Nuevo nombre para la etiqueta.
  3245. == CMD_HELP_LABEL_RENAME ==
  3246. Notas:
  3247. Este comando renombra una etiqueta.
  3248. Ejemplos:
  3249. cm label rename lb:BL001 BL002
  3250. (La etiqueta 'BL001' se renombra a 'BL002')
  3251. == CMD_DESCRIPTION_OBJECTSPEC ==
  3252. Explica cómo escribir object specs (especificaciones de objetos).
  3253. == CMD_USAGE_OBJECTSPEC ==
  3254. Sintaxis:
  3255. cm objectspec
  3256. Para obtener toda la información sobre cómo construir specs de objetos.
  3257. == CMD_HELP_OBJECTSPEC ==
  3258. Muchos comandos de Unity VCS esperan 'object specs' como entrada para
  3259. referirse a un objeto concreto (normalmente una rama, un changeset, un
  3260. repositorio, etc.).
  3261. Esta documentación describe los diferentes tipos de "specs" disponibles y
  3262. cómo construirlas.
  3263. Cada tipo de especificación comienza con un tag único, por ejemplo "rep:" o "cs:".
  3264. El tag se debe indicar para comandos que reciban especificaciones generales
  3265. de objetos, como por ejemplo "cm setowner object_spec", pero a menudo se pueden
  3266. omitir en comandos que solo acepten un tipo de especificación, como por ejemplo
  3267. "cm getfile revision_spec".
  3268. == Repository server spec (repserverspec) ==
  3269. repserver:name:port
  3270. Ejemplos:
  3271. cm lrep repserver:skull:8084
  3272. cm lrep skull:8084
  3273. Nota:
  3274. Lo llamamos "rep" server spec (con el 'rep' delante) en lugar de
  3275. simplemente 'server spec' por motivos históricos. Hace mucho tiempo
  3276. Unity VCS tenía servidores de workspaces y repositorios separados, y
  3277. el nombre ha sobrevivido.
  3278. == Repository spec (repspec) ==
  3279. rep:rep_name@[repserverspec]
  3280. Ejemplos:
  3281. cm showowner rep:codice@localhost:6060
  3282. (Aquí la "rep:" es necesaria porque el comando showowner admite
  3283. todo tipo de objetos).
  3284. == Branch spec (brspec) ==
  3285. br:[/]br_name[@repspec]
  3286. Ejemplos:
  3287. cm switch br:/main@rep:plastic@repserver:skull:9095
  3288. (En este caso "br:", "rep:" y "repserver:" no son necesarios así
  3289. que el comando se puede escribir de forma mucho más compacta:
  3290. "cm switch main@plastic@skull:9095" .)
  3291. cm find revisions "where branch='br:/main/task001'"
  3292. Nota:
  3293. La barra inicial '/' en las ramas no es obligatoria. Solíamos escribir
  3294. todas las ramas como /main, /main/task001, etc. Pero ahora preferimos
  3295. user formatos más cortos tipo main, main/task001.
  3296. == Changeset spec (csetspec) ==
  3297. cs:cs_number|cs_guid[@repspec]
  3298. Se puede especificar el número o el GUID del changeset.
  3299. Ejemplos:
  3300. cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
  3301. == Label spec (labelspec) ==
  3302. lb:lb_name[@repspec]
  3303. Ejemplos:
  3304. cm switch lb:RELEASE2.0
  3305. cm switch lb:RELEASE1.4@myrep@MYSERVER:8084
  3306. == Revision spec ==
  3307. Hay distintos tipos de specs de revisiones:
  3308. rev:item_path[#(brspec|csetspec|labelspec)]
  3309. rev:serverpath:item_path#(brspec|cset_spec|lb_spec)
  3310. rev:revid:rev_id[@rep_spec]
  3311. rev:itemid:item_id#(br_spec|cset_spec|lb_spec)
  3312. Ejemplos:
  3313. cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
  3314. cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
  3315. serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
  3316. cm cat revid:1230@rep:myrep@repserver:myserver:8084
  3317. == Item spec ==
  3318. Hay distintos tipos de specs de ítem. Se usan principamente con los
  3319. comandos relacionados con bloqueos (checkout exclusivo).
  3320. item:item_path
  3321. item:itemid:item_id[@rep_spec]
  3322. Ejemplos:
  3323. cm lock unlock item:audio.wav
  3324. cm lock unlock itemid:1234@rep:myrep@repserver:myserver:8084
  3325. == Attribute spec ==
  3326. att:att_name[@repspec]
  3327. Ejemplo:
  3328. cm rmattributereal att:merged@code@doe:8084 cs:25@code@doe:8084
  3329. == Workspace specs ==
  3330. wk:name@clientmachine
  3331. Se usa muy poco porque solamente aplica a los comandos relacionados con los
  3332. workspaces. Es útil para indicar el nombre del workspace en lugar del path.
  3333. Ejemplo:
  3334. cm showselector wk:codebase@modok
  3335. Nota:
  3336. Estas specs vienen de los viejos tiempos de Plastic SCM 2.x en los que
  3337. los 'workspace servers' eran una forma de almacenar metadatos de forma
  3338. centralizada. Se eliminaron por cuestiones de rendimiento.
  3339. == CMD_DESCRIPTION_PARTIAL ==
  3340. Ejecuta comandos en un espacio de trabajo parcial.
  3341. == CMD_USAGE_PARTIAL ==
  3342. Sintaxis:
  3343. cm partial comando [opciones]
  3344. Comandos:
  3345. configure
  3346. add
  3347. undo
  3348. co | checkout
  3349. unco | undocheckout
  3350. ci | checkin
  3351. mv | move
  3352. rm | remove
  3353. stb | switch
  3354. upd | update
  3355. shelve | shelveset
  3356. Para obtener más información de cada uno de los comandos ejecute:
  3357. cm partial comando --usage
  3358. cm partial comando --help
  3359. == CMD_HELP_PARTIAL ==
  3360. Ejemplos:
  3361. cm partial configure +/fondo-azul.png
  3362. cm partial update paisaje-1024.png
  3363. cm partial checkin ojos-verde.png ojos-negro.png
  3364. == CMD_DESCRIPTION_PARTIAL_ADD ==
  3365. Añade un ítem al repositorio.
  3366. == CMD_USAGE_PARTIAL_ADD ==
  3367. Sintaxis:
  3368. cm partial add [-R | -r | --recursive] [--silent] [--parents] [--ignorefailed]
  3369. [--skipcontentcheck]
  3370. [--format=<str-format>] [--errorformat=<str-format>]
  3371. <rutas>+
  3372. rutas Rutas de los ítems a añadir separados por espacios.
  3373. Usa comillas (") para especificar rutas con espacios.
  3374. Usa * para añadir todo el contenido del directorio
  3375. actual.
  3376. Opciones:
  3377. -R Añade los ítems recursivamente.
  3378. --silent No muestra ninguna salida.
  3379. --parents Incluye los directorios padre de los ítems indicados en
  3380. la operación.
  3381. --ignorefailed Si un ítem no se puede añadir, la operación de add
  3382. continuará sin él. Importante: si un directorio no se
  3383. puede añadir, su contenido tampoco se añadirá.
  3384. --skipcontentcheck Cuando la extensión no es suficiente para determinar si
  3385. el fichero es de tipo texto o binario, se asumirá que es
  3386. binario en lugar de usar el contenido para detectar el
  3387. tipo.
  3388. --format Devuelve la salida en el formato especificado. Consulta
  3389. los ejemplos para más información.
  3390. --errorformat En caso de error, devuelve el mensaje en el formato
  3391. especificado. Consulta los ejemplos para más información.
  3392. == CMD_HELP_PARTIAL_ADD ==
  3393. Notas:
  3394. Requisitos para añadir ítems:
  3395. - El directorio padre del ítem a añadir debe existir en el repositorio.
  3396. Ejemplos:
  3397. cm partial add pic1.png pic2.png
  3398. (Añade los ítems pic1.png y pic2.png.)
  3399. cm partial add c:\workspace\imagen.png
  3400. (Añade el ítem imagen.png en el directorio c:\workspace.)
  3401. cm partial add -R c:\workspace\src
  3402. (Añade recursivamente todos los ítems del directorio especificado.)
  3403. cm partial add --parents ejemplos\diseño01.png
  3404. (Añade el ítem diseño01.png y su directorio padre ejemplos.)
  3405. cm partial add -R *
  3406. (Añade recursivamente todo el contenido del directorio actual.)
  3407. cm partial add -R * --format="ADD {0}" --errorformat="ERR {0}"
  3408. (Añade recursivamente todo el contenido del directorio actual imprimiendo
  3409. por pantalla 'ADD <item>' para los archivos añadidos correctamente y
  3410. 'ERR <item>' para los archivos que no se pudieron añadir.)
  3411. == CMD_DESCRIPTION_PARTIAL_CHECKIN ==
  3412. Crea una nueva revisión de un ítem.
  3413. == CMD_USAGE_PARTIAL_CHECKIN ==
  3414. Sintaxis:
  3415. cm partial checkin | ci [opciones] [<ruta>+]
  3416. [-c=<str_comment> | -commentsfile=<comments_file>]
  3417. [--all | -a] [--applychanged] [--keeplock]
  3418. [--symlink] [--ignorefailed]
  3419. [--machinereadable [--startlineseparator=<sep>]
  3420. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  3421. ruta Rutas de los ítems a proteger, separados por espacios.
  3422. Usa comillas (") para especificar rutas con espacios.
  3423. Usa . para aplicar la operación de checkin al directorio
  3424. actual.
  3425. Opciones:
  3426. -c Añade un comentario al changeset creado en la operación
  3427. de protección.
  3428. -commentsfile Añade el comentario existente en el fichero especificado
  3429. al changeset creado en la operación de protección.
  3430. --all | -a Los ítems cambiados, movidos y borrados localmente en
  3431. las rutas especificadas también son protegidos.
  3432. --applychanged Protege los ítems cambiados localmente junto con los
  3433. ítems desprotegidos.
  3434. --private Incluye en el checkin los ítems privados.
  3435. --keeplock Mantiene el bloqueo de aquellos elementos que estaban
  3436. bloqueados después de la operación de protección.
  3437. --symlink Realizar la operación de checkin sobre el fichero de
  3438. link y no al que apunta.
  3439. --ignorefailed Los cambios locales que no se pueden aplicar (porque el
  3440. bloqueo (checkout exclusivo) no se puede obtener o
  3441. porque están en conflicto con los cambios del servidor)
  3442. son descartados y el checkin continúa sin ellos.
  3443. --machinereadable Muestra el resultado en un formato fácil de parsear.
  3444. --startlineseparator Usado con '--machinereadable', indica cómo deben
  3445. empezar las líneas del resultado.
  3446. --endlineseparator Usado con '--machinereadable', indica cómo deben
  3447. terminar las líneas del resultado.
  3448. --fieldseparator Usado con '--machinereadable', indica cómo deben
  3449. separarse los campos de cada línea resultante.
  3450. == CMD_HELP_PARTIAL_CHECKIN ==
  3451. Notas:
  3452. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  3453. todos los cambios pendientes en el espacio de trabajo.
  3454. - La operación de protección se aplica siempre recursivamente desde la
  3455. ruta indicada.
  3456. - Requisitos para proteger un ítem:
  3457. - El ítem debe estar controlado por Unity VCS.
  3458. - El ítem ha de estar desprotegido.
  3459. - Si un ítem ha sido cambiado pero no desprotegido, no es necesario
  3460. especificar la opción --applychanged, salvo que en las rutas a ser
  3461. protegidas se incluyan directorios o rutas con wildcards ('*').
  3462. La revisión ha de tener cambios. Es decir, no se pueden proteger los
  3463. mismos datos.
  3464. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  3465. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  3466. configurada pero no se indica ningún comentario, el editor se abrirá para
  3467. que pueda escribir el comentario.
  3468. Ejemplos:
  3469. cm partial checkin figura.png paisaje.png
  3470. (Protege los ítems figura.png and paisaje.png.)
  3471. cm partial checkin . -commentsfile=micomentario.txt
  3472. (Protege los ítems de la ruta actual y aplica el comentario existente en el
  3473. fichero micomentario.txt.)
  3474. cm partial ci fondo.png -c="Nuevo fondo añadido" --keeplock
  3475. (Protege el ítem fondo.png, incluye el comentario especificado y mantiene el
  3476. bloqueo.)
  3477. cm partial checkin --applychanged
  3478. (Protege todos los cambios pendientes en el espacio de trabajo.)
  3479. cm partial checkin link --symlink
  3480. (Proteger el fichero de symlink y no al que apunta.)
  3481. == CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
  3482. Desprotege los ítems dejándolos preparados para ser modificados.
  3483. == CMD_USAGE_PARTIAL_CHECKOUT ==
  3484. Síntaxis:
  3485. cm partial checkout | co [<ruta>+] [--resultformat=str_format]
  3486. [--silent] [--ignorefailed]
  3487. Opciones:
  3488. ruta Rutas de los ítems a desproteger, separados por
  3489. espacios.
  3490. Usa comillas (") para especificar rutas con espacios.
  3491. Usa . para aplicar la operación de checkout al
  3492. directorio actual.
  3493. --resultformat Devuelve la salida en el formato especificado.
  3494. --silent No muestra ninguna salida.
  3495. --ignorefailed Si un ítem no se puede desproteger/bloquear (no se puede
  3496. hacer un checkout exclusivo), la operación de checkout
  3497. continuará sin él.
  3498. == CMD_HELP_PARTIAL_CHECKOUT ==
  3499. Notas:
  3500. Para desproteger un ítem:
  3501. - El ítem debe estar controlado por Unity VCS.
  3502. - El ítem debe estar protegido.
  3503. Si se han configurado bloqueos en el servidor (existe el fichero lock.conf),
  3504. entonces cada vez que se produzca una desprotección, Unity VCS comprobará si
  3505. se aplica alguna de las reglas. Si es así, la ruta permanecerá en checkout
  3506. exclusivo (bloqueada), con lo que nadie podrá desprotegerlo simultáneamente.
  3507. Puedes obtener todos los bloqueos del servidor usando 'cm listlocks'.
  3508. Lee la documentación Administrator Guide para más información.
  3509. Examples:
  3510. cm partial checkout imagen1.png imagen2.png
  3511. (Desprotege los ítems imagen1.png and imagen2.png.)
  3512. cm partial co *.png
  3513. (Desprotege todos los ítems png.)
  3514. cm partial checkout .
  3515. (Desprotege el directorio actual.)
  3516. cm partial checkout -R c:\workspace\paisaje
  3517. (Desprotege recursivamente el directorio paisaje.)
  3518. cm partial co diseño01.png --exclusive
  3519. (Desprotege el ítem exclusivamente.)
  3520. == CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
  3521. Permite configurar tu espacio de trabajo, cargando o descargando elementos.
  3522. == CMD_USAGE_PARTIAL_CONFIGURE ==
  3523. Sintaxis:
  3524. cm partial configure <+|-ruta>+ [--silent] [--ignorefailed] [--ignorecase]
  3525. [--restorefulldirs]
  3526. [--machinereadable [--startlineseparator=<sep>]
  3527. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  3528. ruta Rutas a cargar o descargar, separadas por espacios.
  3529. Usa comillas (") para especificar rutas con espacios.
  3530. Todas las rutas deben comenzar con "/".
  3531. Opciones:
  3532. --silent No muestra ninguna salida.
  3533. --ignorefailed Ignora cualquier error durante la operación.
  3534. --ignorecase Ignora mayúsculas y minúsculas. Con esta opción el
  3535. comando funcionará para "/Data/Textures" incluso si el
  3536. usuario indica "/data/teXtures".
  3537. --restorefulldirs Resetea una configuración de directorio incorrecta
  3538. (ocurre cuando una operación no parcial es ejecutada en
  3539. un espacio de trabajo parcial).
  3540. Los directorios de esta lista se configuran por
  3541. completo (full check), lo que significa que bajarán
  3542. automáticamente el nuevo contenido durante el update.
  3543. Esta operación no descarga ningún fichero, simplemente
  3544. restaura la configuración de directorio en un espacio
  3545. de trabajo parcial.
  3546. --machinereadable Muestra el resultado en un formato fácil de parsear.
  3547. --startlineseparator Usado con '--machinereadable', indica cómo deben
  3548. empezar las líneas del resultado.
  3549. --endlineseparator Usado con '--machinereadable', indica cómo deben
  3550. terminar las líneas del resultado.
  3551. --fieldseparator Usado con '--machinereadable', indica cómo deben
  3552. separarse los campos de cada línea resultante.
  3553. == CMD_HELP_PARTIAL_CONFIGURE ==
  3554. Notas:
  3555. El comando siempre asume recursividad.
  3556. Ejemplos:
  3557. cm partial configure +/paisaje-gris.png
  3558. (Carga paisaje-gris.png.)
  3559. cm partial configure -/paisaje-negro.png
  3560. (Descarga paisaje-negro.)
  3561. cm partial configure +/textura -/textura/textura01.png
  3562. (Carga todo el contenido del directorio textura excepto textura01.png.)
  3563. cm partial configure -/
  3564. (Descarga todo el directorio de trabajo.)
  3565. cm partial configure -/ +/
  3566. (Carga todo el directorio de trabajo.)
  3567. cm partial configure +/figura-64.png --ignorefailed
  3568. (Carga figura-64.png, estuviera o no ya cargado previamente.)
  3569. cm partial configure +/ --restorefulldirs
  3570. (Fija todos los directorios para que descarguen el nuevo contenido automáticamente.)
  3571. cm partial configure +/src/lib --restorefulldirs
  3572. (Fija sólo /src/lib y sus subdirectorios para que descarguen el nuevo contenido automáticamente.)
  3573. == CMD_DESCRIPTION_PARTIAL_MOVE ==
  3574. Mueve o renombra un archivo o directorio.
  3575. == CMD_USAGE_PARTIAL_MOVE ==
  3576. Sintaxis:
  3577. cm partial move | mv src_path dst_path [--format=str_format]
  3578. src_path Ruta origen del ítem.
  3579. dst_path Ruta destino del ítem.
  3580. Options:
  3581. --format Devuelve la salida en el formato especificado.
  3582. == CMD_HELP_PARTIAL_MOVE ==
  3583. Notas:
  3584. Este comando mueve o renombra un ítem en el repositorio.
  3585. Los cambios también se aplican localmente.
  3586. Si la ruta de origen es un fichero, el destino puede ser un fichero o un
  3587. directorio. En el primer caso, el fichero se renombra. En el segundo, el
  3588. fichero se renombra.
  3589. Si la ruta de origen en un directorio, el destino ha de serlo también.
  3590. El ítem a mover o renombrar debe existir.
  3591. Formato:
  3592. {0} Ruta de origen.
  3593. {1} Ruta de destino.
  3594. Examples:
  3595. cm partial move fichero.png fichero-azul.png
  3596. (Renombra el ítem.)
  3597. cm partial mv .\fichero-azul.png .\azulFicheros
  3598. (Mueve fichero-azul.png a azulFicheros.)
  3599. cm partial move .\diseño .\marketing
  3600. (Renombra un directorio.)
  3601. == CMD_DESCRIPTION_PARTIAL_REMOVE ==
  3602. Borra un ítem del control de versiones.
  3603. == CMD_USAGE_PARTIAL_REMOVE ==
  3604. Sintaxis:
  3605. cm partial remove | rm <ruta>+ [--nodisk]
  3606. ruta Ítems a borrar, separados por espacios.
  3607. Usa comillas (") para especificar rutas con espacios.
  3608. Opciones:
  3609. --nodisk Borra del control de versiones, pero mantiene el ítem en
  3610. disco.
  3611. == CMD_HELP_PARTIAL_REMOVE ==
  3612. Notas:
  3613. Los ítems se borran de disco. Los ítems borrados son borrados del directorio
  3614. padre en el control de versiones.
  3615. Requisitos:
  3616. - El ítem debe estar controlado.
  3617. Ejemplos:
  3618. cm partial remove src
  3619. (Borra src. Si src es un directorio, equivale a ejecutar:
  3620. cm partial remove -R src.)
  3621. cm partial remove c:\workspace\pic01.png --nodisk
  3622. (Borra pic01.png del control de versiones, pero lo mantiene en el disco.)
  3623. == CMD_DESCRIPTION_PARTIAL_SHELVESET ==
  3624. Use este comando para administrar shelvesets parciales.
  3625. == CMD_USAGE_PARTIAL_SHELVESET ==
  3626. Sintaxis:
  3627. cm partial shelveset | shelve <command> [options]
  3628. Comandos:
  3629. create | mk
  3630. apply
  3631. delete | rm
  3632. Para obtener más información sobre cada comando:
  3633. cm partial shelveset <command> --usage
  3634. cm partial shelveset <command> --help
  3635. == CMD_HELP_PARTIAL_SHELVESET ==
  3636. Ejemplos:
  3637. cm partial shelveset create -c="my comment"
  3638. cm partial shelveset apply sh:3
  3639. cm partial shelveset delete sh:5
  3640. == CMD_DESCRIPTION_PARTIAL_SHELVESET_CREATE ==
  3641. Almacena los cambios pendientes escogidos.
  3642. == CMD_USAGE_PARTIAL_SHELVESET_CREATE ==
  3643. Sintaxis:
  3644. cm partial shelveset | shelve create | mk [<item_path>[ ...]]
  3645. [-c=<str_comment> | -commentsfile=<comments_file>]
  3646. [--applychanged] [--symlink] [--ignorefailed]
  3647. [--machinereadable [--startlineseparator=<sep>]
  3648. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  3649. Opciones:
  3650. -c Añade un comentario al shelveset creado en la operación
  3651. de protección.
  3652. -commentsfile Añade el comentario existente en el fichero especificado
  3653. al shelveset creado en la operación de protección.
  3654. --applychanged Protege los ítems cambiados localmente junto con los
  3655. ítems desprotegidos.
  3656. --symlink Realizar la operación de shelve sobre el fichero de
  3657. link y no al que apunta.
  3658. --ignorefailed Los cambios locales que no se pueden aplicar (porque el
  3659. bloqueo (checkout exclusivo) no se puede obtener o
  3660. porque están en conflicto con los cambios del servidor)
  3661. son descartados y el shelve continúa sin ellos.
  3662. --machinereadable Muestra el resultado en un formato fácil de parsear.
  3663. --startlineseparator Usado con '--machinereadable', indica cómo deben
  3664. empezar las líneas del resultado.
  3665. --endlineseparator Usado con '--machinereadable', indica cómo deben
  3666. terminar las líneas del resultado.
  3667. --fieldseparator Usado con '--machinereadable', indica cómo deben
  3668. separarse los campos de cada línea resultante.
  3669. == CMD_HELP_PARTIAL_SHELVESET_CREATE ==
  3670. El comando partial shelveset create almacena los ítems en checkout especificados
  3671. dentro del repositorio. De este modo el contenido queda almacenado en el
  3672. servidor sin necesidad de hacer checkin.
  3673. Notas:
  3674. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  3675. todos los cambios pendientes en el espacio de trabajo.
  3676. - La operación de protección se aplica siempre recursivamente desde la
  3677. ruta indicada.
  3678. - La operacion de creación de protección es la operación por defecto,
  3679. lo que significa que si no se especifica ninguna otra, el comando tratará
  3680. de ejecutar una nueva creación de protección.
  3681. - Requisitos para proteger un ítem:
  3682. - El ítem debe estar controlado por Unity VCS.
  3683. - El ítem ha de estar desprotegido.
  3684. - Si un ítem ha sido cambiado pero no desprotegido, no es necesario
  3685. especificar la opción --applychanged, salvo que en las rutas a ser
  3686. protegidas se incluyan directorios o rutas con wildcards ('*').
  3687. La revisión ha de tener cambios. Es decir, no se pueden proteger los
  3688. mismos datos.
  3689. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  3690. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  3691. configurada pero no se indica ningún comentario, el editor se abrirá para
  3692. que pueda escribir el comentario.
  3693. Ejemplos:
  3694. cm partial shelveset figura.png paisaje.png
  3695. (Crea un nuevo shelveset con los ítems figura.png and paisaje.png.)
  3696. cm partial shelveset . -commentsfile=micomentario.txt
  3697. (Crea un nuevo shelveset con los ítems de la ruta actual y aplica el
  3698. comentario existente en el fichero micomentario.txt.)
  3699. cm partial shelve fondo.png -c="Nuevo fondo añadido"
  3700. (Crea un nuevo shelveset el ítem fondo.png, incluye el comentario
  3701. especificado.)
  3702. cm partial shelveset --applychanged
  3703. (Crea un nuevo shelveset con todos los cambios locales junto con los
  3704. cambios controlados pendientes en el espacio de trabajo.)
  3705. cm partial shelveset link --symlink
  3706. (Crea un nuevo shelveset con fichero de symlink, en lugar del fichero al
  3707. que apunta.)
  3708. == CMD_DESCRIPTION_PARTIAL_SHELVESET_APPLY ==
  3709. El comando partial shelveset apply restaura los contenidos almancenados en el
  3710. repositorio.
  3711. == CMD_USAGE_PARTIAL_SHELVESET_APPLY ==
  3712. Sintaxis:
  3713. cm partial shelveset apply shelve_spec [opciones]
  3714. shelve_spec: Restaura los contenidos almancenados en el repositorio
  3715. identificados por "shelve_spec"
  3716. Opciones:
  3717. --encoding=codificación: Especifica la codificación de los ficheros de
  3718. origen (por ejemplo, UTF-8 o Unicode)
  3719. --comparisonmethod=tipo: cualquiera de las siguientes opciones:
  3720. ignoreeol: Ignora diferencias de final de línea.
  3721. ignorewhitespaces: Ignora diferencias de espacios en blanco.
  3722. ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en
  3723. blanco.
  3724. recognizeall: Detecta diferencias de final de línea y espacios en
  3725. blanco.
  3726. == CMD_HELP_PARTIAL_SHELVESET_APPLY ==
  3727. El comando partial shelveset apply restaura los contenidos almancenados en el
  3728. repositorio.
  3729. Ejemplo: Aplicar un shelve almacenado en el repositorio:
  3730. cm partial shelveset apply sh:3
  3731. == CMD_DESCRIPTION_PARTIAL_SHELVESET_DELETE ==
  3732. Borra un shelveset.
  3733. == CMD_USAGE_PARTIAL_SHELVESET_DELETE ==
  3734. Sintaxis:
  3735. cm partial shelveset delete shelve_spec
  3736. shelve_spec: Elimina los contenidos almancenados en el repositorio
  3737. identificados por "shelve_spec"
  3738. == CMD_HELP_PARTIAL_SHELVESET_DELETE ==
  3739. El comando partial shelveset delete borra un shelveset creado anteriormente.
  3740. Ejemplo:
  3741. cm partial shelveset delete sh:3
  3742. (Elimina un shelveset almacenado en el repositorio.)
  3743. == CMD_DESCRIPTION_PARTIAL_SWITCH ==
  3744. Establece la rama especificada como rama de trabajo.
  3745. == CMD_USAGE_PARTIAL_SWITCH ==
  3746. Sintaxis:
  3747. cm switch branch_spec [--report | --silent] [--workspace=path] [--noinput]
  3748. (Establece la rama de trabajo y actualiza el workspace.)
  3749. cm switch branch_spec --configure <+|-ruta>+ [--silent]
  3750. [--ignorefailed] [--ignorecase] [--workspace=path]
  3751. (Establece la rama de trabajo y configura el workspace como haría el
  3752. comando 'cm partial configure'.)
  3753. branch_spec Especificación de rama.
  3754. ruta Rutas a cargar o descargar, separadas por espacios.
  3755. Usa comillas (") para especificar rutas con espacios.
  3756. Todas las rutas deben comenzar con "/".
  3757. Opciones:
  3758. --silent No muestra salida.
  3759. --report Imprime una lista de los cambios efectuados una vez
  3760. termina la operación. Pierde efecto si se utiliza
  3761. la opción --silent conjuntamente.
  3762. --configure Configura (carga / descarga rutas) el espacio de
  3763. trabajo después de haber actualizado la rama de trabajo.
  3764. Usa 'cm partial configure --help' para aprender más
  3765. sobre como especificar las rutas a configurar.
  3766. --ignorefailed Ignora cualquier error durante la operación
  3767. de configuración.
  3768. --ignorecase Ignora mayúsculas y minúsculas en las rutas a
  3769. configurar. Con esta opción el comando funcionará
  3770. para "/Data/Textures" incluso si el usuario indica
  3771. "/data/teXtures".
  3772. --noinput Ignora las pregunta interactiva para continuar la
  3773. operación haciendolos shelve a los cambios pendientes.
  3774. --workspace=path Ruta del espacio de trabajo a cambiar.
  3775. --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
  3776. redirige la salida estándar.
  3777. Usa 'cm help objectspec' para aprender más sobre cómo indicar especificaciones
  3778. de ramas.
  3779. == CMD_HELP_PARTIAL_SWITCH ==
  3780. Notas:
  3781. Este comando permite a los usuarios especificar una rama, como rama de
  3782. trabajo. Después de actualizar la rama, actualiza el espacio de trabajo
  3783. a la nueva rama como haría un 'cm partial update'. Sin embargo, si se
  3784. especifica la opción --configure, permite configurar el espacio de trabajo
  3785. teniendo en cuenta los elementos cargados en la nueva rama como haría un
  3786. 'cm partial configure'.
  3787. Ejemplos:
  3788. cm switch br:/main/task
  3789. (Establece /main/task como rama de trabajo y actualiza el espacio de
  3790. trabajo.)
  3791. cm switch br:/main/task --configure +/art/images
  3792. (Establece /main/task como rama de trabajo y configura el directorio
  3793. /art/images.)
  3794. == CMD_DESCRIPTION_PARTIAL_UNDOCHECKOUT ==
  3795. Deshace la desprotección de un ítem.
  3796. == CMD_USAGE_PARTIAL_UNDOCHECKOUT ==
  3797. Sintaxis:
  3798. cm partial undocheckout | unco <ruta>+ [--silent] [--keepchanges | -k]
  3799. ruta Ítems sobre los que aplicar la operación, separados por
  3800. espacios.
  3801. Usa comillas (") para especificar rutas con espacios.
  3802. Usa . para aplicar la operación al directorio actual.
  3803. Opciones:
  3804. --silent No muestra ninguna salida.
  3805. --keepchanges (-k) Deshace la desprotección dejando los cambios locales.
  3806. Ejemplo: un checkout lo deja como changed con el
  3807. contenido en disco que tenia antes de hacer el unco.
  3808. Esta opción no puede utilizarse con workspaces dinámicos.
  3809. == CMD_HELP_PARTIAL_UNDOCHECKOUT ==
  3810. Notas:
  3811. Si un ítem está desprotegido y no quieres protegerlo, puede deshacer la
  3812. desprotección usando este comando.
  3813. Se puede deshacer la desprotección tanto a ficheros como a carpetas.
  3814. El ítem se actualizará al estado anterior previo a ser desprotegido.
  3815. Requisitos:
  3816. - El ítem debe estar controlado.
  3817. - El ítem debe estar desprotegido.
  3818. Ejemplos:
  3819. cm partial undocheckout .
  3820. (Deshace las desprotecciones del directorio actual.)
  3821. cm partial undocheckout pic1.png pic2.png
  3822. cm unco c:\workspace\diseño01.png
  3823. (Deshace las desprotecciones de los ítems especificados.)
  3824. == CMD_DESCRIPTION_PARTIAL_UNDO ==
  3825. Deshace cambios en un workspace.
  3826. == CMD_USAGE_PARTIAL_UNDO ==
  3827. Syntaxis:
  3828. cm partial undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
  3829. [Opciones de salida]
  3830. path Rutas de los ficheros o carpetas a los que aplicar
  3831. la operación, separados por espacios. Se pueden
  3832. utilizar comillas (") para especificar rutas con
  3833. espacios. Si no se especifica ninguna ruta, por
  3834. defecto la operación se ejecutará sobre los ficheros
  3835. en el directorio actual.
  3836. Opciones:
  3837. --symlink Aplica la operación de undo al enlace simbólico y
  3838. no a su destino.
  3839. -r Ejecuta el undo de manera recursiva.
  3840. Filtros:
  3841. Si ninguna de estas opciones está presente, por defecto se deshacen todos
  3842. los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
  3843. opciones.
  3844. Si un fichero o directorio tiene uno o más de los tipos de cambio
  3845. especificados, todos los cambios en ese fichero o directorio serán
  3846. deshechos.
  3847. Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
  3848. está tanto movido como checkedout, ambos cambios se desharán.
  3849. --checkedout Selecciona ficheros y directorios marcados para
  3850. cambios.
  3851. --unchanged Selecciona ficheros sin modificaciones en su
  3852. contenido.
  3853. --changed Selecciona ficheros y directorios cambiados o
  3854. marcados para cambios.
  3855. --deleted Selecciona ficheros y directorios eliminados.
  3856. --moved Selecciona ficheros y directorios movidos.
  3857. --added Selecciona ficheros y directorios añadidos.
  3858. Opciones de salida:
  3859. --silent | --machinereadable [--startlineseparator=sep]
  3860. [--endlineseparator=sep] [--fieldseparator=sep]
  3861. --silent No muestra ninguna salida.
  3862. --machinereadable Muestra la salida en un formato fácil de tratar.
  3863. --startlineseparator Usado en conjunto con la opción '--machinereadable',
  3864. especifica cómo deberían comenzar las líneas.
  3865. --endlineseparator Usado en conjunto con la opción '--machinereadable',
  3866. especifica cómo deberían terminar las líneas.
  3867. --fieldseparator Usado en conjunto con la opción '--machinereadable',
  3868. especifica cómo deberían separarse las líneas.
  3869. == CMD_HELP_PARTIAL_UNDO ==
  3870. Notas:
  3871. El comand undo es peligroso - deshace trabajo de una manera irreversible.
  3872. Una vez que el undo termina, no hay manera posible de recuperar el estado
  3873. anterior de los ficheros y directorios afectados. Si no se especifica
  3874. ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
  3875. los elementos del directorio actual, pero NO de manera recursiva.
  3876. Estos comandos son equivalentes ejecutados desde el directorio /src:
  3877. /src
  3878. |- file.txt
  3879. |- code.cs
  3880. \- /test
  3881. |- test_a.py
  3882. \- test_b.py
  3883. $ cm partial undo
  3884. $ cm partial undo *
  3885. $ cm partial undo file.txt code.cs /test
  3886. $ cm partial undo .
  3887. $ cm partial undo /src file.txt code.cs
  3888. Si se quiere que la operación sea recursiva, se necesita especificar la
  3889. opción -r.
  3890. Para deshacer todos los cambios debajo de un directorio (incluyendo los
  3891. cambios sobre el propio directorio):
  3892. $ cm partial undo dirpath -r
  3893. Si dirpath es la ruta de un workspace, todos los cambios dentro del
  3894. workspace serán deshechos.
  3895. Examples:
  3896. $ cm partial undo . -r
  3897. (Deshace todos los cambios en el directorio actual de manera recursiva. Si
  3898. se ejecuta desde la raíz del workspace, deshace todos los cambios en el
  3899. workspace completo.)
  3900. $ cm partial co file.txt
  3901. $ cm partial undo file.txt
  3902. (Deshace el checkout en file.txt.)
  3903. $ echo content >> file.txt
  3904. $ cm partial undo file.txt
  3905. (Deshace el cambio local en file.txt.)
  3906. $ cm partial undo src
  3907. (Deshace los cambios en el directorio src y en todos los ficheros
  3908. controlados que contenga)
  3909. $ cm partial undo src/*
  3910. (Deshace los cambios en todos los elementos contenidos en src, sin afectar
  3911. al propio directorio. Por la expansión del wildcard, es equivalente a
  3912. 'cm partial undo src/file1.txt src/file2.txt').
  3913. $ cm partial undo *.cs
  3914. (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
  3915. directorio actual.)
  3916. $ cm partial undo *.cs -r
  3917. (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
  3918. directorio actual, y en cada directorio por debajo de una manera recursiva.)
  3919. $ cm partial co file1.txt file2.txt
  3920. $ echo content >> file1.txt
  3921. $ cm partial undo --unchanged
  3922. (Deshace el checkout en file2.txt por no estar modificado, ignorando
  3923. file1.txt ya que tiene cambios locales.)
  3924. $ echo content >> file1.txt
  3925. $ echo content >> file2.txt
  3926. $ cm partial co file1.txt
  3927. $ cm partial undo --checkedout
  3928. (Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
  3929. ya que no está en checkout.)
  3930. $ cm partial add file.txt
  3931. $ cm partial undo file.txt
  3932. (Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
  3933. $ rm file1.txt
  3934. $ echo content >> file2.txt
  3935. $ cm partial add file3.txt
  3936. $ cm partial undo --deleted --added *
  3937. (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
  3938. el cambio en file2.txt.)
  3939. == CMD_DESCRIPTION_PARTIAL_UPDATE ==
  3940. Actualiza el espacio de trabajo parcial.
  3941. == CMD_USAGE_PARTIAL_UPDATE ==
  3942. Sintaxis:
  3943. cm partial update [<ruta>+]
  3944. [--changeset=número]
  3945. [--silent | --report] [--dontmerge]
  3946. [--xml[=<output_file>]] [--encoding=<name>]
  3947. [--machinereadable [--startlineseparator=<sep>]
  3948. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  3949. ruta Rutas a actualizar, separadas por espacios. Las dobles
  3950. comillas (") deben usarse para especificar rutas que
  3951. contienen espacios.
  3952. Si se usa . entonces se actualiza el directorio actual.
  3953. Si no se especifica ninguna ruta, entonces se actualiza todo
  3954. el espacio de trabajo parcial.
  3955. Opciones:
  3956. --changeset Actualiza el espacio de trabajo parcial al changeset
  3957. especificado.
  3958. --silent No muestra salida a no ser que ocurra un error.
  3959. --xml Imprime por defecto a la salida estándar en formato
  3960. XML. Se permite especificar un fichero de salida.
  3961. --encoding Se usa junto con la opción '--xml' y especifica qué formato
  3962. de encoding se va a usar en la salida de XML, p.e.: utf-8.
  3963. Se puede consultar información sobre posibles encodings aquí:
  3964. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  3965. (tabla "List of encodings", columna "Name").
  3966. Por defecto, se asigna "utf-8".
  3967. --report Imprime una lista de los cambios efectuados una vez que
  3968. termina la operación. Esta opción no tiene efecto si se
  3969. utiliza la opción --silent.
  3970. --dontmerge No procesa los conflictos de fichero. El resto de cambios
  3971. se procesan con normalidad. Esta opción puede ser útil en
  3972. automatización para evitar interacción con el usuario.
  3973. --machinereadable Muestra el resultado en un formato fácil de parsear.
  3974. --startlineseparator Usado con '--machinereadable', indica cómo deben
  3975. empezar las líneas del resultado.
  3976. --endlineseparator Usado con '--machinereadable', indica cómo deben
  3977. terminar las líneas del resultado.
  3978. --fieldseparator Usado con '--machinereadable', indica cómo deben
  3979. separarse los campos de cada línea resultante.
  3980. == CMD_HELP_PARTIAL_UPDATE ==
  3981. Notas:
  3982. El comando update actualiza los ficheros desactualizados.
  3983. El comando update siempre asume recursividad.
  3984. Si todas las rutas especificadas son ficheros dentro del mismo xlink y
  3985. se usa la opción --changeset, entonces las versiones a actualizar se buscan
  3986. dentro del changeset del repositorio del xlink.
  3987. Ejemplos:
  3988. cm partial update
  3989. (Actualiza todo el espacio de trabajo parcial.)
  3990. cm partial update .
  3991. (Actualiza todos los hijos del directorio actual.)
  3992. cm partial update fichero1.txt
  3993. (Actualiza el fichero fichero1.txt.)
  3994. cm partial update fichero1.txt fichero2.txt
  3995. (Actualiza los ficheros fichero1.txt y fichero2.txt.)
  3996. cm partial update src --report
  3997. (Actualiza todos los hijos del directorio src, mostrando una lista de los
  3998. cambios aplicados al finalizar.)
  3999. cm partial update src --changeset=4
  4000. (Actualiza todos los hijos del directorio src, al contenido
  4001. que cargaban en el changeset 4.)
  4002. cm partial update xlink/first.png --changeset=4
  4003. (Actualiza el fichero xlink/first.png al contenido que cargaba en el
  4004. changeset 4 del repositorio del xlink.)
  4005. cm partial update . --changeset=2 --xml=output.xml 2>errors.txt
  4006. (Actualiza todos los hijos del directorio actual al contenido que cargaba en el
  4007. changeset 2 del repositorio e informa del resultado en formato XML. La salida
  4008. la almacena en un archivo output.xml y los potenciales errores los redirige
  4009. al archivo errors.txt.
  4010. NOTA: la redirección puede variar dependiendo de la consola empleada.)
  4011. == CMD_DESCRIPTION_PATCH ==
  4012. Genera un parche a partir de una spec o aplica un parche generado en el workspace actual.
  4013. == CMD_USAGE_PATCH ==
  4014. Sintaxis:
  4015. cm patch [source_spec] source_spec
  4016. [--output=output_file] [--tool=/path/to/diff]
  4017. cm patch --apply patch_file [--tool=/path/to/patch]
  4018. source_spec Especificación de rama o changeset
  4019. output_file Fichero que contendrá la salida del comando. Se
  4020. mostrará en pantalla si no se especifica.
  4021. Opciones:
  4022. --output Indica el fichero de destino para almacenar los
  4023. contenidos del parche.
  4024. --tool Especifica la ruta hacia la herramienta necesaria para
  4025. ejecutar la operación (diff o patch).
  4026. == CMD_HELP_PATCH ==
  4027. Notas:
  4028. Este comando genera un fichero patch que contiene las diferencias de una
  4029. rama o un changeset, así como las diferencias entre changesets. Encuentra
  4030. diferencias para ficheros tanto de texto como binarios.
  4031. El parámetro --apply permite aplicar los contenidos de un fichero patch
  4032. en el workspace actual.
  4033. Limitaciones:
  4034. Si el fichero de salida de patch ya existe, el comando no lo
  4035. sobreescribirá.
  4036. Si el fichero con modificaciones en el patch no existe, el comando no
  4037. creará uno nuevo para aplicar los cambios.
  4038. Importante:
  4039. Este comando requiere las utilidades Diff y Patch, disponibles
  4040. en http://gnuwin32.sourceforge.net/packages/patch.htm y
  4041. http://gnuwin32.sourceforge.net/packages/diffutils.htm
  4042. Tras su instalación se recomienda agregar su ubicación a la variable
  4043. de entorno PATH.
  4044. Ejemplos:
  4045. cm patch cs:4@default@localhost:8084
  4046. (Muestra en pantalla las diferencias del changeset 4 en formato patch.)
  4047. cm patch br:/main --output=file.patch
  4048. (Obtiene un fichero file.patch con las diferencias de la rama "main".)
  4049. cm patch br:/main --output=file.patch --tool=C:\gnu\diff.exe
  4050. (Misma operación con un ejecutable indicado explícitamente.)
  4051. cm patch cs:2@default cs:4@default
  4052. (Muestra en pantalla las diferencias entre los changeset 2 y 4.)
  4053. cm patch --apply file.patch --tool=C:\gnu\patch.exe
  4054. (Aplica el parche contenido en file.patch al workspace actual con un
  4055. ejecutable indicado explícitamente.)
  4056. == CMD_DESCRIPTION_PROFILE ==
  4057. Permite al usuario administrar perfiles de conexión configurados en el cliente.
  4058. == CMD_USAGE_PROFILE ==
  4059. Sintaxis:
  4060. cm profile | profile <command> [options]
  4061. Comandos:
  4062. list | ls
  4063. create | mk
  4064. delete | rm
  4065. Para obtener más información sobre cada comando:
  4066. cm profile <command> --usage
  4067. cm profile <command> --help
  4068. == CMD_HELP_PROFILE ==
  4069. Ejemplos:
  4070. cm profile
  4071. cm profile list
  4072. cm profile create
  4073. cm profile delete 1
  4074. == CMD_DESCRIPTION_PROFILE_LIST ==
  4075. Lista los perfiles de conexión configurados en el cliente.
  4076. == CMD_USAGE_PROFILE_LIST ==
  4077. Sintaxis:
  4078. cm profile [list | ls] [--format=<str_format>]
  4079. Opciones:
  4080. --format Muestra el mensaje de salida en el formato indicado.
  4081. Consulte las notas para más información.
  4082. == CMD_HELP_PROFILE_LIST ==
  4083. Notas:
  4084. Parámetros de formato de salida (opción --format):
  4085. Este comando acepta una cadena de formato para mostrar la salida.
  4086. Los parámetros de salida de este comando son los siguientes:
  4087. {index} | {0} Índice del perfil dentro de la lista
  4088. {name} | {1} Nombre del perfil
  4089. {server} | {2} Servidor del perfil
  4090. {user} | {3} Usuario del perfil
  4091. {workingmode} | {4} Modo de trabajo del perfil
  4092. {securityconfig} | {5} Configuración de seguridad del perfil
  4093. {tab} Inserta un tabulador
  4094. {newline} Inserta una nueva línea
  4095. Ejemplos:
  4096. cm profile
  4097. (Lista todos los perfiles usando el formato por defecto.)
  4098. cm profile --format="{index,2} {server,-20}"
  4099. (Muestra el índice del perfil utilizando 2 espacios y alineado a la derecha,
  4100. dos espacios, y el servidor de repositorios utilizando veinte espacios,
  4101. alineado a la izquierda.)
  4102. cm profile --format="{0,2} {2,-20}"
  4103. (Muestra el mismo resultado que el ejemplo anterior.)
  4104. == CMD_DESCRIPTION_PROFILE_CREATE ==
  4105. Crea un nuevo perfil de conexión.
  4106. == CMD_USAGE_PROFILE_CREATE ==
  4107. Sintaxis:
  4108. cm profile [create | mk]
  4109. (Crea un nuevo perfil de conexión de manera interactiva.)
  4110. cm profile [create | mk] --server=<server_addr> --username=<username>
  4111. --password=<password> --workingmode=<workingmode>
  4112. (Crea un nuevo perfil de conexión usando un modo de autenticación basado
  4113. en usuario y contraseña.)
  4114. cm profile [create | mk] --server=<server_addr> --username=<username>
  4115. --token=<token> --workingmode=SSOWorkingMode
  4116. (Crea un nuevo perfil de conexión usando un modo de autenticación basado
  4117. en Single Sign On.)
  4118. Opciones:
  4119. --server Crea el perfil de conexión para el servidor especificado.
  4120. --username El nombre de usuario que va a ser utilizado en el perfil de
  4121. conexión.
  4122. --password La contraseña, en texto plano, que será usada en el perfil
  4123. de conexión. Esta opción solo es válida para los modos de
  4124. autenticación basados en usuario y contraseña.
  4125. --token El token, en texto plano, que será usado en el perfil de
  4126. conexión. Esta opción solo es válida para los modos de
  4127. autenticación basados en token (por ahora solo SSOWorkingMode).
  4128. --workingmode El modo de autenticación del servidor.
  4129. Modos de autenticación disponibles:
  4130. LDAPWorkingMode (LDAP)
  4131. UPWorkingMode (User and password)
  4132. SSOWorkingMode (Single Sign On)
  4133. == CMD_HELP_PROFILE_CREATE ==
  4134. Notas:
  4135. Cuando se utiliza este comando en modo interactivo (sin opciones) el cliente
  4136. trata de conectarse con el servidor para obtener el modo de autenticación y
  4137. comprobar las credenciales. Esto garantiza que el perfil de conexión
  4138. resultante sea correcto.
  4139. Cuando se utiliza este comando con opciones, el cliente genera el perfil de
  4140. conexión sin conectar con el servidor. Esto es útil para crear perfiles de
  4141. conexión para su uso en automatización.
  4142. Ejemplos:
  4143. cm profile create
  4144. (Crea un perfil de conexión de manera interactiva.)
  4145. cm profile create --server=plastic.domain.com:8087 --username=sergio
  4146. --password=thisissupersecret --workingmode=LDAPWorkingMode
  4147. (Crea un perfil de conexión contra 'plastic.domain.com:8087' con el usuario
  4148. 'sergio' y la contraseña 'thisissupersecret' usando el modo de autenticación
  4149. LDAP.)
  4150. cm profile mk --server=plastic.domain.com:8087 --username=sergio
  4151. --token="TOKENAMoKJ9iAA(...)12fssoprov:unityid"
  4152. (Crea un perfil de conexión contra 'plastic.domain.com:8087' con el usuario
  4153. 'sergio' y el token especificado usando el modo de autenticación Single Sign
  4154. On.)
  4155. == CMD_DESCRIPTION_PROFILE_DELETE ==
  4156. Borra un perfil de conexión de la configuración del cliente.
  4157. == CMD_USAGE_PROFILE_DELETE ==
  4158. Sintaxis:
  4159. cm profile delete | rm <index | name>
  4160. cm profile delete | rm --index=<index>
  4161. cm profile delete | rm --name=<name>
  4162. index Índice del perfil en la lista de perfiles de conexión.
  4163. name Nombre del perfil.
  4164. Opciones:
  4165. --index Utilizado para desambiguación en caso de que un perfil tenga un
  4166. número por nombre.
  4167. --name Utilizado para desambiguación en caso de que un perfil tenga un
  4168. número por nombre.
  4169. == CMD_HELP_PROFILE_DELETE ==
  4170. Notas:
  4171. Borra un perfil de conexión de la configuración del cliente.
  4172. Funciona especificando tanto el índice del perfil como su nombre.
  4173. El comando 'cm profile list' no muestra el nombre del perfil por defecto,
  4174. use 'cm profile list --help' para saber cómo mostrar el nombre del perfil.
  4175. Ejemplos:
  4176. cm profile delete 1
  4177. (Borra el perfil con índice 1)
  4178. cm profile delete 192.168.0.2:8087_UPWorkingMode
  4179. (Borra el perfil con nombre '192.168.0.2:8087_UPWorkingMode'.)
  4180. cm profile delete --name=12
  4181. (Borra el perfil con nombre '12'.)
  4182. == CMD_DESCRIPTION_QUERY ==
  4183. Ejecuta una consulta SQL contra la base de datos del servidor.
  4184. == CMD_USAGE_QUERY ==
  4185. Uso:
  4186. cm query comandosql [--outputfile=ruta]
  4187. [--solveuser=nombre_columna1,nombre_columna2,...]
  4188. [--solvepath=nombre_columna1,nombre_columna2,...]
  4189. [--columnwidth=valor]
  4190. --outputfile: Escribe en un fichero el resultado de la consulta.
  4191. --solveuser: Indica al intérprete de consultas que la(s) columna(s)
  4192. especificada(s) contiene(n) usuarios. Se tratarán de resolver
  4193. identificadores de usuario a nombres de usuario.
  4194. --solvepath: Indica al intérprete de consultas que la(s) columna(s)
  4195. especificadas(s) contiene(n) identificadores de ítem. Se tratarán de
  4196. resolver los identificadores a rutas de disco.
  4197. --columnwidth: Especifica la anchura de cada columna del resultado de la
  4198. consulta.
  4199. == CMD_HELP_QUERY ==
  4200. Notas:
  4201. Este comando permite a los usuarios ejecutar consultas SQL directamente
  4202. contra la base de datos del servidor.
  4203. A continuación se detalla el esquema (tablas y campos de cada tabla)
  4204. disponibles para realizar consultas.
  4205. ITEMS
  4206. OBJECTID (integer)
  4207. CREATIONDATE (datetime)
  4208. OWNER (string)
  4209. REVISIONS
  4210. OBJECTID (integer)
  4211. SIZEBYTES (integer)
  4212. ITEMID (integer)
  4213. BRANCHID (integer)
  4214. CHANGESET (integer)
  4215. COMMENT (string)
  4216. CREATIONDATE (datetime)
  4217. OWNER (string)
  4218. CHECKOUTS
  4219. REVISIONID (integer)
  4220. WORKSPACESERVER (string)
  4221. CLIENTMACHINE (string)
  4222. EXCLUSIVE (char)
  4223. CREATIONDATE (datetime)
  4224. OWNER (string)
  4225. BRANCHES
  4226. OBJECTID (integer)
  4227. NAME (string)
  4228. PARENTBRANCHID (integer)
  4229. CREATIONDATE (datetime)
  4230. OWNER (string)
  4231. LABELS
  4232. OBJECTID (integer)
  4233. NAME (string)
  4234. CREATIONDATE (datetime)
  4235. OWNER (string)
  4236. LABELEDREVISIONS
  4237. LABELID (integer)
  4238. REVISIONID (integer)
  4239. CREATIONDATE (datetime)
  4240. OWNER (string)
  4241. LINKS
  4242. OBJECTID (integer)
  4243. NAME (string)
  4244. CREATIONDATE (datetime)
  4245. OWNER (string)
  4246. LINKEDOBJECTS
  4247. LINKID (integer)
  4248. SOURCEOBJECTID (integer)
  4249. DESTINATIONOBJECTID (integer)
  4250. CREATIONDATE (datetime)
  4251. OWNER (string)
  4252. ATTRIBUTES
  4253. OBJECTID (integer)
  4254. NAME (string)
  4255. CREATIONDATE (datetime)
  4256. OWNER (string)
  4257. OBJECTSWITHATTRIBUTES
  4258. ATTRIBUTEID (integer)
  4259. SOURCEOBJECTID (integer)
  4260. ATTRIBUTEVALUE (string)
  4261. CREATIONDATE (datetime)
  4262. OWNER (string)
  4263. CHANGESETS
  4264. CHANGESETNUMBER (integer)
  4265. CREATIONDATE (datetime)
  4266. OWNER (string)
  4267. Además, a la hora de escribir consultas, existen dos functiones predefinidas
  4268. para trabajar con usuarios y rutas de disco.
  4269. Estas funciones son las siguientes:
  4270. * SolveUser(nombre_usuario), resuelve el nombre de usuario dado al formato que
  4271. maneja Unity VCS.
  4272. * SolvePath(path), resuelve rutas de disco a identificadores de ítem itemid.
  4273. Para mostrar el resultado de las consultas de forma legible al usuario, se
  4274. puede indicar al intérprete de consultas que convierta identificadores de
  4275. usuario a nombres de usuario, e identificadores de ítem a rutas de disco.
  4276. Para ello se utilizan las opciones:
  4277. --solveuser=nombre_columna
  4278. --solvepath=nombre_columna
  4279. Se pueden especificar varios nombres de columnas separados por comas.
  4280. Ejemplos:
  4281. cm query "SELECT * FROM revision"
  4282. cm query "SELECT b.sname as br_name, o.dtimestamp as date from branch b, object o, seid s
  4283. where b.iobjid=o.iobjid and o.fidowner=s.iseidid and s.scode='SolveUser(juan)'"
  4284. cm query "SELECT * FROM REVISION WHERE itemid=SolvePath(c:\mi_workspace)"
  4285. cm query "SELECT r.iobjid, r.fiditem as ruta, s.scode as nombre_usuario FROM revision r, object o, seid s
  4286. WHERE r.iobjid=o.iobjid and o.fidowner=s.iseidid" --solveuser=nombre_usuario --solvepath=ruta
  4287. == CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
  4288. Borra uno o más atributos.
  4289. == CMD_USAGE_ATTRIBUTE_DELETE ==
  4290. Sintaxis:
  4291. cm attribute | att delete | rm <att_spec>[ ...]
  4292. att_spec Atributos a borrar. Use un espacio en blanco para separar
  4293. atributos.
  4294. (Use 'cm help objectspec' para más información sobre
  4295. las especificaciones de atributos.)
  4296. == CMD_HELP_ATTRIBUTE_DELETE ==
  4297. Notas:
  4298. Este comando borra uno o más atributos.
  4299. Ejemplos:
  4300. cm attribute delete att:status
  4301. (Borra el atributo 'status'.)
  4302. cm att rm status att:integrated@reptest@server2:8084
  4303. (Borra los atributos 'status' e 'integrated'.)
  4304. == CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
  4305. Desasigna un atributo a un objeto.
  4306. == CMD_USAGE_ATTRIBUTE_UNSET ==
  4307. Sintaxis:
  4308. cm attribute | att unset <att_spec> <object_spec>
  4309. att_spec Especificación del atributo. (Use 'cm help objectspec'
  4310. para más información sobre las especificaciones de
  4311. atributos.)
  4312. object_spec Especificación del objeto sobre el que desasignar el
  4313. atributo. Se pueden fijar atributos a ramas, changesets,
  4314. shelvesets, etiquetas, items y revisiones.
  4315. (Use 'cm help objectspec' para más información sobre
  4316. especificaciones.)
  4317. == CMD_HELP_ATTRIBUTE_UNSET ==
  4318. Notas:
  4319. Este comando elimina la asignación de un atributo que ha sido aplicado
  4320. previamente a un objeto. Este comando no borra el atributo en sí.
  4321. Ejemplo:
  4322. cm attribute unset att:status br:/main/SCM105
  4323. (Desasigna el atributo 'status' que estaba aplicado a la rama 'main/SCM105'.)
  4324. cm att unset att:integrated@reptest@localhost:8084 cs:25@reptest@localhost:8084
  4325. (Desasigna el atributo 'integrated' que estaba aplicado al changeset 25.
  4326. Tanto el atributo como el changeset se encuentran en el repositorio 'reptest'.)
  4327. == CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
  4328. Renombra un atributo.
  4329. == CMD_USAGE_ATTRIBUTE_RENAME ==
  4330. Sintaxis:
  4331. cm attribute | att rename <att_spec> <new_name>
  4332. att_spec Atributo a renombrar. (Use 'cm help objectspec' para
  4333. más información sobre especificaciones de atributos.)
  4334. new_name Nuevo nombre para el atributo.
  4335. == CMD_HELP_ATTRIBUTE_RENAME ==
  4336. Notas:
  4337. Este comando renombra un atributo.
  4338. Ejemplos:
  4339. cm attribute rename att:status state
  4340. (Renombra el atributo 'status' a 'state')
  4341. == CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
  4342. Edita el comentario de un atributo.
  4343. == CMD_USAGE_ATTRIBUTE_EDIT ==
  4344. Sintaxis:
  4345. cm attribute | att edit <att_spec> <new_comment>
  4346. att_spec Atributo al cual editar su comentario.
  4347. (Use 'cm help objectspec' para más información sobre
  4348. especificaciones de atributos.)
  4349. new_comment Nuevo comentario para el atributo. Este comentario puede ser
  4350. una lista de posibles valores que el usuario puede seleccionar
  4351. cuando asigne un atributo a un objeto. Consulte las Notas
  4352. para más información.
  4353. == CMD_HELP_ATTRIBUTE_EDIT ==
  4354. Notas:
  4355. Este comando cambia el comentario de un atributo.
  4356. Para especificar la lista de valores por defecto para un atributo, indique
  4357. un texto como este en el comentario del atributo:
  4358. 'default: valor_uno, "valor dos", valor3, "Valor final"'.
  4359. Ejemplos:
  4360. cm attribute edit att:status "The status of a branch in the CI pipeline."
  4361. (Edita el comentario del atributo 'status'.)
  4362. cm attribute edit att:status "Status of a branch. default: open, resolved, reviewed"
  4363. (Edita el comentario del atributo 'status'. Y también especifica una lista
  4364. de valores. De este modo, cuando el usuario asigne el atribute 'status' a un
  4365. objeto, podrá seleccionar uno de los siguientes valores: 'open', 'resolved'
  4366. o 'reviewed'.)
  4367. == CMD_DESCRIPTION_REPLICATE ==
  4368. ATENCIÓN: Este comando se ha declarado obsoleto.
  4369. Ha sido reemplazado por 'pull' (equivalente a 'replicate') y por 'push'
  4370. (equivalente a 'replicate --push').
  4371. Replica datos desde un repositorio remoto.
  4372. == CMD_USAGE_REPLICATE ==
  4373. Uso:
  4374. cm replicate br_spec dst_rep_spec [--nodata] [translateOptions] [authOptions]
  4375. cm replicate hydrate br_spec [src_rep_spec] [authOptions]
  4376. cm replicate hydrate cs_spec [src_rep_spec] [authOptions]
  4377. cm replicate br_spec --package=packagename [--changeset=número]
  4378. cm replicate dst_rep_spec --import=packagename
  4379. br_spec: la rama para ser replicada/hidratada. Es una especificación
  4380. completa de rama con el siguiente formato:
  4381. br:/NOMBRE_RAMA[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
  4382. cs_spec: changeset para ser hidratado. Es una espec. de changeset:
  4383. cs:NUMERO_CHANGESET[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
  4384. src_rep_sec: repositorio origen de los datos. Es una especificación
  4385. completa de repositorio:
  4386. rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
  4387. dst_rep_sec: repositorio destino de la replica. Es una especificación
  4388. completa de repositorio:
  4389. rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
  4390. Opciones:
  4391. --package para crear un paquete de replicación.
  4392. --import para importar un paquete concreto.
  4393. --nodata para replicar los cambios de una rama sin replicar sus datos. Esta
  4394. opción no se puede usar para la réplica con paquetes ni con la opción
  4395. --push.
  4396. Opciones de traducción:
  4397. --trmode=[copy | name | table] para especificar cómo tratar los
  4398. nombres de usuario cuando se importen los datos en el
  4399. repositorio de destino:
  4400. * copy -> es el utilizado por defecto. Copia los SEIDs en el
  4401. repositorio de destino.
  4402. * name -> realiza una traducción por nombre entre el modo
  4403. de autentificación de origen y el de destino.
  4404. * table -> se usará una tabla de traducción en la que se
  4405. especifican los nombres de origen y cómo han de quedar
  4406. en el destino.
  4407. --trtable=[translationTable]
  4408. una tabla de traducción es un fichero que contiene entradas
  4409. en la forma nombre antiguo;nombre nuevo.
  4410. Opciones de autentificación:
  4411. Hay dos formas de especificar los datos de autentificación:
  4412. 1) Especificando un fichero de autentificación.
  4413. --authfile=fichero, un fichero que contiene dos líneas: el modo de
  4414. autentificación en la primera línea y los datos de autentificación
  4415. (ver --authdata) o una cadena vacía en la segunda.
  4416. 2) Especificando la autentificación mediante parámetros.
  4417. Para ello hay que especificar el modo de autentificación mediante el
  4418. modificador:
  4419. --authmode=[NameWorkingMode | NameIDWorkingMode |
  4420. LDAPWorkingMode | ADWorkingMode | UPWorkingMode]
  4421. Si está trabajando en UPWorkingMode o LDAPWorkingMode, puede
  4422. especificar los datos de autentificación de dos formas:
  4423. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  4424. --authdata=datos_de_autentificación
  4425. Ejemplos:
  4426. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  4427. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  4428. 2.2) Solamente para UPWorkingMode:
  4429. --user=usuario
  4430. --password=contraseña
  4431. == CMD_HELP_REPLICATE ==
  4432. Notas:
  4433. El comando 'replicate' replica datos desde una rama hacia un
  4434. repositorio de destino. Todos los datos de la rama de origen, incluyendo
  4435. revisiones, ítems, changesets, etiquetas, revisiones de código, links
  4436. y seguridad serán replicados.
  4437. Su cliente Unity VCS debe estar configurado para trabajar con el
  4438. repositorio de destino.
  4439. La replicación también gestiona la 'reconciliación' de ramas que han
  4440. sido modificadas tanto en origen como en destino, mediante la creación
  4441. de 'ramas de entrega' (fetch branches) que podrán ser integradas
  4442. posteriormente para resolver los conflictos.
  4443. La replicación puede funcionar en tres modos diferentes:
  4444. 1- Comunicación directa entre servidores: lo que significa que el servidor
  4445. de destino se comunicará con el de origen para sincronizar la rama
  4446. especificada.
  4447. 2- Generación de paquete de exportación: el cliente se conectará
  4448. únicamente con el destino para generar un paquete de replicación con los
  4449. datos y los metadatos de la rama especificada. Se usará el modificador
  4450. --package. El usuario podrá especificar, opcionalmente, un changeset
  4451. inicial desde el cual generar la replicación.
  4452. 3- Importar un paquete generado previamente, usando la opción --import.
  4453. En los modos 1 y 2 será necesaria la autentificación contra el servidor
  4454. de origen. El comando 'replicate' acepta parámetros para especificar los
  4455. diferentes modos de autentificación.
  4456. Ejemplos:
  4457. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090
  4458. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=name
  4459. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=table --trtable=tabla.txt
  4460. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --authmode=NameWorkingMode --user=john.doe
  4461. Significa que se autentificará contra el servidor 'MADRID' usando NameWorkingMode como usuario 'john.doe'
  4462. cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data
  4463. Creará un paquete de replicación
  4464. cm replicate rep:mine@repserver:casa:9094 --import=replicationpackage.data
  4465. Importará el paquete creado con anterioridad
  4466. cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data --changeset=1230
  4467. Generará un paquete de replicación de la rama br:/main/releaseBL060 desde el changeset 1230
  4468. cm replicate /main@project1@LONDRES:8084 projectx@localhost:8084 --nodata
  4469. Replicará la rama /main del servidor LONDRES a mi servidor sin replica los datos.
  4470. cm replicate hydrate /main@projectx@localhost:8084 project1@LONDRES:8084
  4471. Hidratará los datos de la rama /main de mi servidor, usando los datos del servidor LONDRES.
  4472. Nota adicional:
  4473. La tabla de traducción tiene entradas (una por línea) con el siguiente
  4474. formato:
  4475. nombre antiguo;nombre nuevo
  4476. == CMD_DESCRIPTION_PULL ==
  4477. Replica datos desde un repositorio remoto.
  4478. == CMD_USAGE_PULL ==
  4479. Uso:
  4480. cm pull src_br_spec dst_rep_spec
  4481. [--preview] [--nodata] [translateOptions]
  4482. [--user=usr_name [--password=pwd] | AuthOptions]
  4483. (Replicación directa entre servidores. Hace pull de una rama desde un
  4484. repositorio.)
  4485. cm pull dst_rep_spec --package=pack_file [AuthOptions]
  4486. (Replicación basada en paquetes. Importa el paquete en el servidor de
  4487. destino.)
  4488. cm pull hydrate dst_br_spec [src_rep_spec]
  4489. [--user=usr_name [--password=pwd] | AuthOptions]
  4490. (Introduce los datos restantes para todos los changesets de una rama
  4491. replicada previamente con la opción --nodata. Si no se especifica un
  4492. repositorio del que obtener los datos, Unity VCS intentará usar el
  4493. origen de replicación original de la rama.)
  4494. cm pull hydrate dst_cs_spec [src_rep_spec]
  4495. [--user=usr_name [--password=pwd] | AuthOptions]
  4496. (Introduce los datos restantes para un changeset replicado previamente
  4497. con la opción --nodata. Si no se especifica un repositorio del que obtener
  4498. los datos, Unity VCS intentará usar el origen de replicación original de
  4499. la rama.)
  4500. src_br_spec La rama a ser replicada desde un repositorio remoto.
  4501. dst_br_spec La rama a ser hidratada.
  4502. Especificación de ramas:
  4503. [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  4504. dst_cs_spec El changeset a ser hidratado.
  4505. Especificación de changesets:
  4506. cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  4507. dst_rep_spec El repositorio de destino.
  4508. Especificación de repositorio:
  4509. [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
  4510. --package El fichero de donde se importa un paquete de replicación
  4511. creado anteriormente.
  4512. Es útil para mover datos entre servidores sin una
  4513. conexión de red directa.
  4514. Consule 'cm push' para crear paquetes de replicación.
  4515. Opciones:
  4516. --preview Proporciona información sobre qué cambios serán traídos
  4517. durante el pull, pero no se ejecuta ninguna acción más.
  4518. Esta opción es útil para comprobar qué datos serán
  4519. replicados antes de ejecutar el pull.
  4520. --user, --password Credenciales para utilizar en caso de que el modo de
  4521. autenticación de los servidores origen y destino
  4522. difieran, y no exista un profile para autenticarse
  4523. contra el remoto.
  4524. --nodata Replica los metadatos de una rama sin replicar los
  4525. datos. Esta opción no se puede utilizar al importar un
  4526. paquete de replicación.
  4527. Opciones de traducción (translateOptions):
  4528. --trmode={copy|name|table}
  4529. El servidor de origen y de destino pueden utilizar modos distintos de
  4530. autenticación. Este argumento especifica cómo se han de traducir los
  4531. nombres de usuario del origen al destino.
  4532. - copy El modo por defecto, indica que los nombres de usuario serán
  4533. simplemente copiados.
  4534. - name Los nombres de usuario serán emparejados entre origen y
  4535. destino por coincidencia.
  4536. - table Se utilizará una tabla de traducción (más información a
  4537. continuación).
  4538. --trtable={translation_table_file}
  4539. Si el modo de traducción es 'table', entonces una tabla de traducción
  4540. es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
  4541. Cuando la rama se escribe en el repositorio de destino, los objetos
  4542. creados por un usuario identificado por "nombreantiguo" en el
  4543. repositorio de origen serán asignados al usuario identificado por
  4544. "nombrenuevo" en el repositorio de destino.
  4545. Opciones de autentificación (AuthOptions):
  4546. Hay dos formas de especificar los datos de autentificación:
  4547. 1) Especificando la autentificación mediante parámetros:
  4548. --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
  4549. (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  4550. (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
  4551. El parámetro '--authdata' es el contenido del campo <SecurityConfig>
  4552. en los ficheros client.conf o profiles.conf. El fichero profiles.conf
  4553. puede ser generado desde la GUI de Unity VCS (Windows).
  4554. Si se utiliza UPWorkingMode, se puede especificar simplemente:
  4555. --authmode=UPWorkingMode --user=user --password=pwd
  4556. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  4557. --authdata=datos_de_autentificación
  4558. Ejemplos:
  4559. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  4560. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  4561. 2.2) Solamente para UPWorkingMode:
  4562. --user=usuario
  4563. --password=contraseña
  4564. 1) Especificando un fichero de autentificación. Se pueden tener varios
  4565. ficheros de autenticación, uno por servidor al que se conecte,
  4566. conteniendo las credenciales específicas para dicho servidor.
  4567. --authfile=fichero
  4568. Contiene 2 líneas:
  4569. Línea 1) modo de autenticación, igual que para --authmode.
  4570. Línea 2) datos de autenticación, igual que para --authdata.
  4571. == CMD_HELP_PULL ==
  4572. Notas:
  4573. El comando pull replica ramas (junto a sus changesets) entre un repositorio
  4574. origen y otro destino. Los repositorios pueden encontrarse en diferentes
  4575. servidores.
  4576. Hay dos operaciones de replicación: push y pull.
  4577. Una operación de 'pull' significa que la operación de replicación hará que
  4578. el servidor destino obtenga datos desde el origen. El cliente se conectará
  4579. con el servidor destino, y, desde ese host, establecerá una conexión con el
  4580. repositorio origen para recuperar los datos pedidos. Durante el pull, será
  4581. el servidor destino el que se conecte al origen.
  4582. Aunque en un escenario distribuido típico el desarrollador haga pùsh de los
  4583. cambios en su servidor local al servidor central, también puede ser
  4584. necesario hacer pull de los últimos cambios en el servidor central al
  4585. servidor local.
  4586. La replicación puede resolver situaciones en las que se hagan cambios
  4587. concurrentes en la misma rama en dos repositorios replicados:
  4588. - Push: si se intenta hacer push de datos locales a un repositorio que tenga
  4589. datos más nuevos que los que se están enviando, el sistema pedirá hacer
  4590. pull de los últimos cambios, resolver el merge resultante y, finalmente,
  4591. tratar de repetir el push.
  4592. - Pull: cuando se hace pull de changesets de una rama remota, estos estarán
  4593. correctamente enlazados a sus changesets padre. Si el changeset que se ha
  4594. traído no es un hijo del último changeset de la rama, entonces aparecerá
  4595. un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
  4596. dicho de otro modo, más de un changeset final de rama. Será necesario
  4597. hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
  4598. El pull puede funcionar de dos modos:
  4599. 1) Comunicación directa entre servidores: lo que significa que el servidor
  4600. de destino se comunicará con el de origen para sincronizar la rama
  4601. especificada.
  4602. 2) Importación de un paquete de replicación generado con push, con la opción
  4603. --package.
  4604. El modo 1) requere que el usuario que ejecute el comando esté autenticado
  4605. contra el servidor remoto, bien o usando la autenticación por defecto en
  4606. el fichero client.conf, mediante un profile creado previamente, o
  4607. especificando los argumentos --authmode y --authdata (o --user y --password
  4608. en caso de que el modo de autenticación sea UPWorkingMode).
  4609. El modo 2) require usar un paquete de replicación generado previamente con
  4610. el comando push.
  4611. Recuerde que la replicación pull funciona de una manera indirecta. Cuando
  4612. se ejecuta, el comando pide al repositorio destino que se conecte con el
  4613. origen para obtener la rama especificada.
  4614. Sin embargo, esto se puede hacer de manera directa utilizando el comando
  4615. push, que hará que sea el repositorio origen quien envíe los datos
  4616. directamente al destino.
  4617. Ejemplos:
  4618. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084
  4619. (Hace pull de la rama principal de remoteserver a myserver. En este caso,
  4620. ambos servidores están configurados con el mismo modo de autenticación.)
  4621. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  4622. (Hace pull de la misma rama que antes, pero ahora el servidor remoto está
  4623. configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
  4624. se puede conectar de una máquina Linux a un servidor Windows configurado
  4625. para usar Active Directory. Para ello, se especificará el usuario y la
  4626. contraseña cifrada.)
  4627. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
  4628. (Hace pull de la misma rama, pero ahora ambos usuarios están autenticados
  4629. en el servidor remoto mediante el sistema de gestión de usuarios integrado
  4630. en Unity VCS.)
  4631. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --nodata
  4632. (Hace pull de la rama principal de remoteserver a myserver pero sin datos.)
  4633. cm pull hydrate br:/main@projectx@myserver:8084 projectx@remoteserver:8084
  4634. (Introduce los datos de todos los changesets de la rama principal obteniendo
  4635. dichos datos del repositorio en remoteserver.)
  4636. cm pull hydrate cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
  4637. (Introduce los datos del changeset 122169 en myserver obteniendo dichos
  4638. datos del repositorio en remoteserver.)
  4639. Nota adicional:
  4640. La tabla de traducción tiene entradas (una por línea) de la forma:
  4641. nombre antiguo;nombre nuevo
  4642. == CMD_DESCRIPTION_PUSH ==
  4643. Replica datos hacia un repositorio remoto.
  4644. == CMD_USAGE_PUSH ==
  4645. Uso:
  4646. cm push src_br_spec dst_rep_spec
  4647. [--preview] [translateOptions]
  4648. [--user=usr_name [--password=pwd] | AuthOptions]
  4649. (Replicación directa entre servidores. Hace push de una rama hacia un
  4650. repositorio.)
  4651. cm push src_br_spec --package=pack_file [AuthOptions]
  4652. (Replicación basada en paquetes. Crea un paquete de replicación con la
  4653. rama especificada.)
  4654. src_br_spec La rama a ser replicada desde un repositorio remoto.
  4655. Especificación de ramas:
  4656. [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  4657. dst_cs_spec El changeset a ser hidratado.
  4658. Especificación de changesets:
  4659. cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  4660. dst_rep_spec El repositorio de destino.
  4661. Especificación de repositorio:
  4662. [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
  4663. --package Exporta un paquete de replicación al fichero especificado.
  4664. Es útil para mover datos entre servidores sin una
  4665. conexión de red directa.
  4666. Opciones:
  4667. --preview Proporciona información sobre qué cambios serán enviados
  4668. durante el push, pero no se ejecuta ninguna acción más.
  4669. Esta opción es útil para comprobar qué datos serán
  4670. replicados antes de ejecutar el push.
  4671. --user, --password Credenciales para utilizar en caso de que el modo de
  4672. autenticación de los servidores origen y destino
  4673. difieran, y no exista un profile para autenticarse
  4674. contra el remoto.
  4675. --nodata Replica los metadatos de una rama sin replicar los
  4676. datos. Esta opción no se puede utilizar al exportar un
  4677. paquete de replicación.
  4678. Opciones de traducción (translateOptions):
  4679. --trmode={copy|name|table}
  4680. El servidor de origen y de destino pueden utilizar modos distintos de
  4681. autenticación. Este argumento especifica cómo se han de traducir los
  4682. nombres de usuario del origen al destino.
  4683. - copy El modo por defecto, indica que los nombres de usuario serán
  4684. simplemente copiados.
  4685. - name Los nombres de usuario serán emparejados entre origen y
  4686. destino por coincidencia.
  4687. - table Se utilizará una tabla de traducción (más información a
  4688. continuación).
  4689. --trtable={translation_table_file}
  4690. Si el modo de traducción es 'table', entonces una tabla de traducción
  4691. es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
  4692. Cuando la rama se escribe en el repositorio de destino, los objetos
  4693. creados por un usuario identificado por "nombreantiguo" en el
  4694. repositorio de origen serán asignados al usuario identificado por
  4695. "nombrenuevo" en el repositorio de destino.
  4696. Opciones de autentificación (AuthOptions):
  4697. Hay dos formas de especificar los datos de autentificación:
  4698. 1) Especificando la autentificación mediante parámetros:
  4699. --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
  4700. (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  4701. (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
  4702. El parámetro '--authdata' es el contenido del campo <SecurityConfig>
  4703. en los ficheros client.conf o profiles.conf. El fichero profiles.conf
  4704. puede ser generado desde la GUI de Unity VCS (Windows).
  4705. Si se utiliza UPWorkingMode, se puede especificar simplemente:
  4706. --authmode=UPWorkingMode --user=user --password=pwd
  4707. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  4708. --authdata=datos_de_autentificación
  4709. Ejemplos:
  4710. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  4711. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  4712. 2.2) Solamente para UPWorkingMode:
  4713. --user=usuario
  4714. --password=contraseña
  4715. 1) Especificando un fichero de autentificación. Se pueden tener varios
  4716. ficheros de autenticación, uno por servidor al que se conecte,
  4717. conteniendo las credenciales específicas para dicho servidor.
  4718. --authfile=fichero
  4719. Contiene 2 líneas:
  4720. Línea 1) modo de autenticación, igual que para --authmode.
  4721. Línea 2) datos de autenticación, igual que para --authdata.
  4722. == CMD_HELP_PUSH ==
  4723. Notas:
  4724. El comando pull replica ramas (junto a sus changesets) entre un repositorio
  4725. origen y otro destino. Los repositorios pueden encontrarse en diferentes
  4726. servidores.
  4727. Hay dos operaciones de replicación: push y pull.
  4728. Una operación de 'push' significa que la operación de replicación enviará
  4729. datos desde el repositorio origen al repositorio destino. En este caso, el
  4730. cliente se conectará al repositorio origen, recuperando los datos para ser
  4731. replicados, y entonces los enviará al repositorio destino. Mientras que el
  4732. origen necesita tener conectividad con el destino, el destino no se
  4733. conectará con el origen.
  4734. En un escenario distribuido típico el desarrollador hace push de los
  4735. cambios en su servidor local al servidor central. También puede ser
  4736. necesario hacer pull de los últimos cambios en el servidor central al
  4737. servidor local.
  4738. La replicación puede resolver situaciones en las que se hagan cambios
  4739. concurrentes en la misma rama en dos repositorios replicados:
  4740. - Push: si se intenta hacer push de datos locales a un repositorio que tenga
  4741. datos más nuevos que los que se están enviando, el sistema pedirá hacer
  4742. pull de los últimos cambios, resolver el merge resultante y, finalmente,
  4743. tratar de repetir el push.
  4744. - Pull: cuando se hace pull de changesets de una rama remota, estos estarán
  4745. correctamente enlazados a sus changesets padre. Si el changeset que se ha
  4746. traído no es un hijo del último changeset de la rama, entonces aparecerá
  4747. un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
  4748. dicho de otro modo, más de un changeset final de rama. Será necesario
  4749. hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
  4750. El push puede funcionar de dos modos:
  4751. 1) Comunicación directa entre servidores: lo que significa que el servidor
  4752. de origen se comunicará con el de destino para sincronizar la rama
  4753. especificada.
  4754. 2) Exportación de un paquete de replicación: El cliente únicamente se
  4755. conectará con el origen y generará un paquete de replicación que contenga
  4756. tanto los datos como los metadatos para la rama especificada. Para ello
  4757. se utilizará el argumento --package.
  4758. Ambos modos requeren que el usuario ejecutando el comando esté autenticado
  4759. contra el servidor, bien o usando la autenticación por defecto en el fichero
  4760. client.conf, mediante un profile creado previamente, o especificando los
  4761. argumentos --authmode y --authdata (o --user y --password en caso de que
  4762. el modo de autenticación sea UPWorkingMode).
  4763. La replicación push funciona de una manera directa. Cuando se ejecuta, el
  4764. comando replicará la rama seleccionada del origen al destino, en vez de
  4765. pedir al repositorio destino que se conecte al repositorio origen para
  4766. obtener la rama especificada (como hace pull).
  4767. Ejemplos:
  4768. cm push br:/main@project1@myserver:8084 projectx@remoteserver:8084
  4769. (Hace push de la rama main desde myserver a remoteserver. En este caso,
  4770. ambos servidores están configurados con el mismo modo de autenticación.)
  4771. cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  4772. (Hace push de la misma rama que antes, pero ahora el servidor remoto está
  4773. configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
  4774. se puede conectar de una máquina Linux a un servidor Windows configurado
  4775. para usar Active Directory. Para ello, se especificará el usuario y la
  4776. contraseña cifrada.)
  4777. cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
  4778. (Hace push de la misma rama, pero ahora ambos usuarios están autenticados
  4779. en el servidor remoto mediante el sistema de gestión de usuarios integrado
  4780. en Unity VCS.)
  4781. Nota adicional:
  4782. La tabla de traducción tiene entradas (una por línea) de la forma:
  4783. nombre antiguo;nombre nuevo
  4784. == CMD_DESCRIPTION_CLONE ==
  4785. Clona un repositorio remoto.
  4786. == CMD_USAGE_CLONE ==
  4787. Sintaxis:
  4788. cm clone <src_rep_spec> [<dst_rep_spec> | <dst_repserver_spec>]
  4789. [--user=<usr_name> [--password=<pwd>] | AuthOptions]
  4790. [TranslateOptions]
  4791. (Clonado directo repositorio-a-repositorio.)
  4792. cm clone <src_rep_spec> --package=<pack_file>
  4793. [--user=<usr_name> [--password=<pwd>] | AuthOptions]
  4794. (Clonado a un paquete intermedio que se podrá importar posteriormente al
  4795. repositorio destino mediante un pull.)
  4796. src_rep_spec Repositorio origen de la operación de clonado.
  4797. (Use 'cm help objectspec' para más información sobre
  4798. las especificaciones de repositorio.)
  4799. dst_rep_spec Repositorio destino de la operación de clonado. Si
  4800. existe, debe estar vacío. Si no existe, se creará.
  4801. Si no se especifica, el comando utilizará el servidor
  4802. de repositorios por defecto.
  4803. (Use 'cm help objectspec' para más información sobre
  4804. las especificaciones de repositorios.
  4805. dst_repserver_spec Servidor de repositorios destino de la operación de
  4806. clonado. Si existe un repositorio con el mismo nombre
  4807. que <src_rep_spec>, debe estar vacío. Si no existe, se
  4808. creará.
  4809. Si no se especifica, el comando utilizará el servidor
  4810. de repositorios por defecto.
  4811. (Use 'cm help objectspec' para más información sobre
  4812. las especificaciones de servidor de repositorio.)
  4813. Options:
  4814. --user, --password Credenciales para utilizar en caso de que el modo de
  4815. autenticación de los servidores origen y destino
  4816. difieran, y no exista un perfil para autentificarse
  4817. en el destino.
  4818. --package Exporta el repositorio indicado a un fichero de paquete
  4819. en lugar de a otro repositorio.
  4820. Es útil para mover datos entre servidores sin una
  4821. conexión de red directa.
  4822. El paquete resultante se importará mediante el comando
  4823. pull.
  4824. TranslateOptions Consulte las opciones de traducción para más información.
  4825. AuthOptions Consulte las opciones de autentificación para más
  4826. información.
  4827. Opciones de traducción (TranslateOptions):
  4828. --trmode=(copy|name|table --trtable=<translation_table_file>)
  4829. Los repositorios origen y destino pueden utilizar distintos modos de
  4830. autenticación. La opción --trmode especifica cómo se han de traducir los
  4831. nombres de usuario del origen al destino. La opción --trmode puede tener
  4832. uno de los siguientes valores:
  4833. copy (Defecto.) Indica que los identificadores de los usuario
  4834. serán simplemente copiados.
  4835. name Los identificadores de usuario serán emparejados entre origen
  4836. y destino por nombre.
  4837. table Se utilizará la tabla de traducción indicada en la opción
  4838. --trtable (más información a continuación).
  4839. --trtable=<translation_table_file>
  4840. Si el modo de traducción es 'table', entonces una tabla de traducción
  4841. es un fichero que contiene líneas de la forma <nombreantiguo;nombrenuevo>
  4842. (uno por línea). Cuando la rama se escribe en el repositorio de destino,
  4843. los objetos creados por un usuario identificado por "nombreantiguo" en
  4844. el repositorio de origen serán asignados al usuario identificado por
  4845. "nombrenuevo" en el repositorio de destino.
  4846. Opciones de autentificación (AuthOptions):
  4847. Hay dos formas de especificar los datos de autentificación:
  4848. 1) Usando parámetros de autentificación: --authmode=<mode> --authdata=<data>
  4849. --authmode=(NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode)
  4850. Por ejemplo:
  4851. (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  4852. (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
  4853. La línea '--authdata' es el contenido de la entrada <SecurityConfig>
  4854. en los ficheros client.conf o profiles.conf. El fichero profiles.conf
  4855. puede ser generado desde la GUI de Unity VCS en la pestaña Perfiles
  4856. de Conexión en la ventana de Preferencias.
  4857. Si se utiliza UPWorkingMode, se puede especificar:
  4858. --authmode=UPWorkingMode --user=<user> --password=<pwd>
  4859. 2) Especificando un fichero de autentificación. Pueden existir varios
  4860. ficheros de autentificación, uno por cada servidor al que se conecte,
  4861. conteniendo las credenciales específicas para dicho servidor.
  4862. --authfile=<authentication_file>
  4863. Contiene 2 líneas:
  4864. Línea 1) modo de autenticación, igual que para --authmode.
  4865. Línea 2) datos de autenticación, igual que para --authdata.
  4866. == CMD_HELP_CLONE ==
  4867. Notas:
  4868. El comando clone puede replicar ramas (junto a sus changesets, etiquetas,
  4869. atributos, reviews, etc.) desde un repositorio origen a un repositorio
  4870. destino. Los repositorios pueden encontrarse en diferentes servidores.
  4871. El repositorio destino puede existir de antemano, pero si contiene datos
  4872. previos, la operación de clonado fallará.
  4873. La operación de clonado NO clona submódulos ni repositorios que se encuentren
  4874. bajo un Xlink.
  4875. Ejemplos:
  4876. cm clone awesomeProject@tardis@cloud
  4877. (Clona el repositorio 'awesomeProject' de la organización Cloud tardis@cloud
  4878. a un repositorio local del mismo nombre.)
  4879. cm clone repo@server.home:9095 repo-local
  4880. (Clona 'repo' desde 'server.home:9095' en 'repo-local' localizado en el
  4881. servidor de repositorios por defecto del usuario.)
  4882. cm clone project@192.168.111.130:8084 repserver:192.168.111.200:9095
  4883. (Clona 'project' desde '192.168.111.130:8084' a
  4884. 'project@192.168.111.200:9095'.)
  4885. cm clone project@ldapserver:8084 --authfile=credentials.txt --trmode=table --trtable=table.txt
  4886. (Clona el repositorio 'project' desde 'ldapserver:8084' utilizando un fichero
  4887. de autentificación contra el servidor remoto, y traduciendo los usuarios
  4888. siguiendo la tabla de traducción especificada.)
  4889. cm clone project@server.home:9095 --package=project.plasticpkg
  4890. cm mkrep project@mordor.home:8084
  4891. cm pull --package=project.plasticpkg project@mordor.home:8084
  4892. (Clona 'project' desde 'server.home:9095' al paquete 'project.plasticpkg'
  4893. que se importa posteriormente en el repositorio 'project' de
  4894. 'mordor.home:8084' mediante una operación de pull.)
  4895. == CMD_DESCRIPTION_REVERT ==
  4896. Carga en el espacio de trabajo la revisión especificada y desprotege el elemento.
  4897. == CMD_USAGE_REVERT ==
  4898. Sintaxis:
  4899. cm revert cset_spec
  4900. cset_spec Especificación del changeset que contiene la revisión del ítem
  4901. cuyo contenido se desea cargar en el espacio de trabajo.
  4902. Usa 'cm help objectspec' para obtener más información sobre la
  4903. especificación de changesets.
  4904. == CMD_HELP_REVERT ==
  4905. Notas:
  4906. El ítem ha de esta estar protegido.
  4907. Ejemplos:
  4908. cm revert dir#cs:0
  4909. cm revert C:\mywks\dir\file1.txt#cs:23456
  4910. == CMD_DESCRIPTION_HISTORY ==
  4911. Muestra la historia de un ítem.
  4912. == CMD_USAGE_HISTORY ==
  4913. Sintaxis:
  4914. cm history | hist <item_path>[ ...] [--long | --format=<str_format>]
  4915. [--symlink] [--xml[=<output_file>]] [--encoding=<name>]
  4916. [--moveddeleted]
  4917. item_path Ruta de los ítems. Use un espacio en blanco para separar
  4918. rutas de ítems. Use comillas dobles (" ") para especificar
  4919. rutas que contengan espacios.
  4920. Las rutas pueden ser rutas de revisiones en servidor.
  4921. (Use 'cm help objectspec' para más información sobre las
  4922. especificaciones.)
  4923. Opciones:
  4924. --long Muestra información adicional.
  4925. --format Muestra el mensaje de salida en el formato indicado.
  4926. Consulte las Notas para más información. No puede
  4927. combinarse con --xml.
  4928. --symlink Aplica la operación al symlink pero no al destino (target).
  4929. --xml Imprime el resultado en formato XML a la salida estándar.
  4930. También es posible especificar un fichero de salida. No
  4931. puede combinarse con --format.
  4932. --encoding Usado con la opción --xml, especifica el encoding que se
  4933. usará en la salida XML, por ejemplo, utf-8.
  4934. Consulte la documentación de MSDN en
  4935. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  4936. para obtener la tabla de codificaciones soportadas y su
  4937. formato (al final de la página en la columna "Name").
  4938. --moveddeleted Incluye las operaciones de movidos y borrado en la historia.
  4939. --limit Muestra las N revisiones más recientes para los elementos
  4940. especificados, ordenados por fecha y por changeset id. Si
  4941. se proporciona un número negativo, el comando devolverá una
  4942. lista vacía. Si se proporciona un número mayor al número de
  4943. revisiones del elemento solicitado, devolverá las existentes.
  4944. == CMD_HELP_HISTORY ==
  4945. Notas:
  4946. Este comando muestra una lista de revisiones para el ítem indicado, e
  4947. información de etiqueta, rama y comentario de cada revisión.
  4948. Parámetros de formato de salida (opción --format):
  4949. Este comando acepta una cadena de formato para mostrar la salida.
  4950. Los parámetros de salida de este comando son los siguientes:
  4951. {0} | {date} Fecha.
  4952. {1} | {changesetid} Número de changeset.
  4953. {2} | {branch} Rama.
  4954. {4} | {comment} Comentario.
  4955. {5} | {owner} Propietario de la revisión.
  4956. {6} | {id} Id de revisión.
  4957. {7} | {repository} Repositorio.
  4958. {8} | {server} Servidor.
  4959. {9} | {repspec} Especificación de repositorio.
  4960. {10}| {datastatus} Disponibilidad del dato de la revision.
  4961. {11}| {path} Ruta o spec pasada como <item_path>.
  4962. {12}| {itemid} Id del elemento.
  4963. {13}| {size} Tamaño.
  4964. {14}| {hash} Código hash.
  4965. {tab} Inserta un tabulador.
  4966. {newline} Inserta una nueva línea.
  4967. Ejemplos
  4968. cm history file1.txt "file2.txt"
  4969. cm hist c:\workspace --long
  4970. (Muestra toda la información.)
  4971. cm history link --symlink
  4972. (Aplica la operación al fichero de symlink y no al destino.)
  4973. cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
  4974. (Muestra la historia de una revisión de una ruta de servidor en la rama
  4975. especificada.)
  4976. cm history bar.c, foo.c --long --limit=2
  4977. (Muestra las últimas 2 revisiones para los elemetos bar.c and foo.c.)
  4978. == CMD_DESCRIPTION_REVISION_TREE ==
  4979. Muestra un árbol de revisiones para el ítem dado.
  4980. == CMD_USAGE_REVISION_TREE ==
  4981. Sintaxis:
  4982. cm tree ruta
  4983. ruta: Ruta del ítem sobre el que se mostrará el árbol.
  4984. Opciones:
  4985. --symlink: Efectúa la operación sobre el fichero de link y no sobre el ítem
  4986. al que apunta.
  4987. == CMD_HELP_REVISION_TREE ==
  4988. Ejemplos:
  4989. cm tree fichero1.txt
  4990. cm tree c:\workspace
  4991. cm tree link --symlink
  4992. (Efectúa la operación sobre el fichero de symlink
  4993. y no sobre el que apunta.)
  4994. == CMD_DESCRIPTION_REMOVE ==
  4995. Use este comando para borrar ficheros y directorios.
  4996. == CMD_USAGE_REMOVE ==
  4997. Sintaxis:
  4998. cm remove | em comando [opciones]
  4999. Comandos:
  5000. controlled (opcional)
  5001. private
  5002. Para obtener más información sobre cada comando:
  5003. cm remove comando --usage
  5004. cm remove comando --help
  5005. == CMD_HELP_REMOVE ==
  5006. Ejemplos:
  5007. cm remove \fichero_controlado.txt
  5008. cm remove private \fichero_privado.txt
  5009. == CMD_DESCRIPTION_REMOVE_CONTROLLED ==
  5010. Borra un ítem del control de versiones.
  5011. == CMD_USAGE_REMOVE_CONTROLLED ==
  5012. Sintaxis:
  5013. cm remove [opciones] rutas
  5014. rutas: Rutas de los ítem a borrar.
  5015. Opciones:
  5016. -R: Descender recursivamente dentro de directorios.
  5017. == CMD_HELP_REMOVE_CONTROLLED ==
  5018. Notas:
  5019. El ítem nunca borra del disco.
  5020. Requisitos para borrar:
  5021. El ítem ha de estar controlado en Unity VCS.
  5022. El directorio padre debe estar desprotegido.
  5023. El elemento no debe estar desprotegido.
  5024. Si el ítem es un directorio, no debe tener desprotecciones pendientes.
  5025. Ejemplos:
  5026. cm remove src (borra el directorio 'src')
  5027. cm remove c:\workspace\fichero.txt
  5028. == CMD_DESCRIPTION_REMOVE_PRIVATE ==
  5029. Borra ficheros y directorios privados.
  5030. Advertencia: este comando elimina permanentemente ficheros y directorios, y no
  5031. son recuperables. Es recomendable utilizar antes la opción '--dry-run' para
  5032. comprobar qué ficheros y directorios serán afectados por el comando.
  5033. == CMD_USAGE_REMOVE_PRIVATE ==
  5034. Sintaxis:
  5035. cm remove | rm private <ruta>+ [-r] [--verbose] [--dry-run]
  5036. ruta Ruta del fichero o directorio a borrar.
  5037. Se pueden usar comillas (") para especificar rutas que
  5038. contengan espacios.
  5039. Opciones:
  5040. --r Elimina ficheros privados recursivamente dentro de
  5041. directorios controlados.
  5042. --ignored También se elimina ficheros y directorios ignorados y
  5043. cloaked.
  5044. --verbose Muestra todos las rutas afectadas.
  5045. --dry-run Ejecuta el comando sin hacer cambios en disco.
  5046. == CMD_HELP_REMOVE_PRIVATE ==
  5047. Notas:
  5048. Si la ruta especificada corresponde a un fichero o directorio privados, este
  5049. será eliminado de disco.
  5050. Si la ruta corresponde a un fichero bajo control de versiones, el comando
  5051. fallará.
  5052. Si la ruta pertenece a un directorio bajo control de versiones, el comando
  5053. fallará salvo que se especifique la opción '-r', en cuyo caso se borrarán
  5054. todos los ficheros y directorios privados dentro del directorio controlado
  5055. especificado.
  5056. Ejemplos:
  5057. cm remove private private_directory
  5058. (Eliminina el directorio 'private_directory'.)
  5059. cm remove private c:\workspace\controlled_directory
  5060. (Falla, pues el directorio 'controlled_directory' no es privado.)
  5061. cm remove private -r c:\workspace\controlled_directory
  5062. (Elimina todos los ficheros y directorios privados dentro de
  5063. 'controlled_directory'.)
  5064. cm rm private --dry-run --verbose c:\workspace\controlled_directory -r
  5065. (Muestra todas las rutas afectadas por la operación de borrado de elementos
  5066. privados dentro de 'controlled_directory' sin borrar nada.)
  5067. cm rm private --verbose c:\workspace\controlled_directory -r
  5068. (Muestra todas las rutas afectadas por la operación de borrado de elementos
  5069. privados dentro de 'controlled_directory', ejecutando el borrado.)
  5070. == CMD_DESCRIPTION_TRIGGER_DELETE ==
  5071. Borra un trigger.
  5072. == CMD_USAGE_TRIGGER_DELETE ==
  5073. Sintaxis:
  5074. cm trigger | tr delete | rm <subtype-type> <position_number>
  5075. [--server=<repserverspec>]
  5076. subtype-type Ejecución y operación del trigger.
  5077. (Use 'cm showtriggertypes' para ver la lista de tipos de
  5078. triggers.)
  5079. position_number Posición asignada al trigger cuando se creó.
  5080. Opciones:
  5081. --server Borra el trigger del servidor especificado.
  5082. Si no se especifica ningún servidor, el comando se
  5083. ejecuta en el servidor configurado en el cliente.
  5084. == CMD_HELP_TRIGGER_DELETE ==
  5085. Ejemplos:
  5086. cm trigger delete after-setselector 4
  5087. cm tr rm after-setselector 4
  5088. == CMD_DESCRIPTION_ATTRIBUTE_SET ==
  5089. Asigna un atributo al objeto indicado.
  5090. == CMD_USAGE_ATTRIBUTE_SET ==
  5091. Sintaxis:
  5092. cm attribute | att set <att_spec> <object_spec> <att_value>
  5093. att_spec Especificación del atributo. (Use 'cm help objectspec'
  5094. para más información sobre especificaciones de atributos.)
  5095. object_spec Especificación del objeto al que asignar el atributo.
  5096. Objetos válidos para este comando: rama, changeset,
  5097. shelveset, etiqueta, item y revisión.
  5098. (Use 'cm help objectspec' para más información sobre
  5099. especificaciones.)
  5100. att_value Valor del atributo que se asignará al objeto.
  5101. == CMD_HELP_ATTRIBUTE_SET ==
  5102. Notas:
  5103. Un atributo se asigna a un objeto para añadirle más información.
  5104. Se pueden asignar atributos a los siguientes objetos: ramas, changesets,
  5105. shelvesets, etiquetas, items y revisiones.
  5106. Ejemplo:
  5107. cm attribute set att:status br:/main/SCM105 open
  5108. (Aplica el atributo 'status' a la rama 'SCM105' asignándola el valor 'open'.)
  5109. cm att set att:integrated@reptest@server2:8084 lb:LB008@reptest@server2:8084 yes
  5110. (Aplica el atributo 'integrated' a la etiqueta 'LB008' del repositorio 'reptest
  5111. asignándola el valor 'yes'.)
  5112. == CMD_DESCRIPTION_SETOWNER ==
  5113. Establece el propietario de un objeto.
  5114. == CMD_USAGE_SETOWNER ==
  5115. Sintaxis:
  5116. cm setowner | sto --user=usuario | --group=grupo spec_objeto
  5117. --user Nombre de usuario. Nuevo propietario del objeto.
  5118. --group Nombre de grupo. Nuevo propietario del objeto.
  5119. spec_objeto Especificación del objeto sobre el que asignar el nuevo
  5120. propietario.
  5121. Se puede asignar nuevo usuario a los siguientes objetos:
  5122. repserver, repositorio, rama, changeset, etiqueta, item,
  5123. revisión y atributo.
  5124. Usa 'cm help objectspec' para obtener más información
  5125. sobre la especificación de objetos.
  5126. == CMD_HELP_SETOWNER ==
  5127. Notas:
  5128. Es posible modificar el propietario de un objeto mediante el comando
  5129. setowner. El propietario de un objeto puede ser un usuario o un grupo.
  5130. Para especificar un usuario se utiliza la opción –-user=xxx y para
  5131. especificar un grupo se utiliza la opción -–group=xxx. El objeto que se
  5132. quiere modificar se especifica mediante una especificación de objeto.
  5133. Se puede modificar el propietario de los siguientes objetos:
  5134. servidor de repositorios, repositorio, rama, changeset, etiqueta, item,
  5135. revisión y atributo.
  5136. Ejemplos:
  5137. cm setowner --user=danipen repserver:localhost:8084
  5138. (establece a 'danipen' como propietario del servidor de repositorios)
  5139. cm sto --group=development rep:principal@PlasticServer:8084
  5140. (establece al grupo 'development' como el propietario del repositorio 'principal')
  5141. == CMD_DESCRIPTION_SETSELECTOR ==
  5142. Establece un selector para un espacio de trabajo.
  5143. == CMD_USAGE_SETSELECTOR ==
  5144. Sintaxis:
  5145. cm setselector [opciones] [wk_ruta | wk_spec] [--noinput]
  5146. wk_ruta Ruta del espacio de trabajo sobre el que establecer el
  5147. selector.
  5148. wk_spec Especificación del espacio de trabajo sobre el que
  5149. establecer el selector.
  5150. Usa 'cm help objectspec' para obtener más información
  5151. sobre especificaciones de espacios de trabajo.
  5152. Opciones:
  5153. --file Fichero del que cargar un selector.
  5154. --ignorechanges Ignora el mensaje de aviso de cambios pendientes que se
  5155. muestra si existen cambios pendientes cuando se
  5156. actualiza el espacio de trabajo.
  5157. --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
  5158. redirige la salida estándar.
  5159. --noinput Ignora las preguntas interactivas para continuar la
  5160. operación con cambios pendientes o haciendolos shelve.
  5161. == CMD_HELP_SETSELECTOR ==
  5162. Notas:
  5163. Este comando establece un selector para un espacio de trabajo determinado.
  5164. Un workspace necesita información acerca de dónde obtener las revisiones
  5165. con las que trabajará el usuario. Para especificar esa información se
  5166. utilizan los selectores.
  5167. Mediante un selector se puede indicar, por ejemplo, que se carguen las
  5168. revisiones desde una rama determinada o desde la rama ‘main’, desde una
  5169. etiqueta, y especificar la rama donde se alojarán las desprotecciones.
  5170. Si no se especifica ningún fichero del que cargar el selector se abrirá
  5171. un editor de texto.
  5172. Indicar una ruta o una especificación de workspace es opcional. Si no se
  5173. especifica ninguno el selector se fijará para el espacio de trabajo en
  5174. el que se encuentra el usuario.
  5175. Un selector de ejemplo:
  5176. repository "default" // indica el repositorio con el que se trabaja
  5177. path "/" // se aplica al path raíz
  5178. branch "/main" // se obtendrán las últimas revisiones de br:/main
  5179. checkout "/main" // los checkouts se ubicarán en la rama br:/main
  5180. Ejemplos:
  5181. cm setselector
  5182. cm setselector --file=c:\selectores\miRama.xml
  5183. cm setselector --file=c:\selectores\rama5.xml MiWorkspace
  5184. cm setselector wk:workspace_projA@BEARDTONGUE
  5185. == CMD_DESCRIPTION_SHELVE ==
  5186. El comando shelve almacena el contenido de las revisiones en checkout.
  5187. == CMD_USAGE_SHELVE ==
  5188. Este comando está obsoleto. Se ha reemplazado por 'cm shelveset'.
  5189. Sintaxis:
  5190. cm shelve [opciones] [rutas]
  5191. rutas: rutas de los items a guardar.
  5192. Opciones:
  5193. --apply=shelve_spec : Restaura los contenidos almancenados en el
  5194. repositorio, identificados por "shelve_spec" en el espacio de trabajo
  5195. local.
  5196. --delete=shelve_spec: Elimina los contenidos almancenados en el repositorio
  5197. identificados por "shelve_spec"
  5198. --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
  5199. rutas dadas, también serán guardados.
  5200. --dependencies: Incluir las dependencias de los cambios locales entre los
  5201. ítems a guardar.
  5202. -c=comentarios: Añade un comentario al shelve creado en la operación.
  5203. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  5204. --summaryformat: El comando imprime sólamente la especificación del
  5205. objeto creado en el repositorio principal, omitiendo los objetos
  5206. que pudieran crearse en repositorios 'xlinked'. También se omite
  5207. cualquier otro mensaje que el comando pudiera imprimir.
  5208. Opción diseñada para implementar automatizaciones.
  5209. --mount: El punto de montaje del respositorio especificado.
  5210. --encoding=codificación: Especifica la codificación de los ficheros de
  5211. origen (por ejemplo, UTF-8 o Unicode)
  5212. --comparisonmethod=tipo: cualquiera de las siguientes opciones:
  5213. ignoreeol: Ignora diferencias de final de línea.
  5214. ignorewhitespaces: Ignora diferencias de espacios en blanco.
  5215. ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en
  5216. blanco.
  5217. recognizeall: Detecta diferencias de final de línea y espacios en
  5218. blanco.
  5219. == CMD_HELP_SHELVE ==
  5220. Notas:
  5221. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  5222. todos los cambios pendientes en el espacio de trabajo.
  5223. - La operación de shelve se aplica siempre recursivamente desde la
  5224. ruta indicada.
  5225. - Requisitos para hacer shelve de un ítem:
  5226. * El ítem debe estar controlado por Unity VCS.
  5227. * El ítem ha de estar desprotegido.
  5228. Ejemplos:
  5229. cm shelve
  5230. cm shelve fichero1.txt fichero2.txt
  5231. Comentarios:
  5232. Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
  5233. cm shelve -c="my comment"
  5234. cm shelve -m "my comment"
  5235. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  5236. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  5237. configurada pero no se indica ningún comentario, el editor se abrirá para
  5238. que pueda escribir el comentario.
  5239. Ejemplo: Aplicar un shelve almacenado en el repositorio:
  5240. cm shelve --apply=sh:3
  5241. Ejemplo: Eliminar un shelve almacenado en el repositorio
  5242. cm shelve --delete=sh:3
  5243. Ejemplo: Shelve 'changelist'
  5244. cm status --short --changelist=pending_to_review | cm shelve -
  5245. (El comando listará los paths en el changelist llamado 'pending_to_review'
  5246. y dicha lista será redirigida a la entrada del comando 'shelve').
  5247. == CMD_DESCRIPTION_SHELVESET ==
  5248. Use este comando para administrar shelvesets.
  5249. == CMD_USAGE_SHELVESET ==
  5250. Sintaxis:
  5251. cm shelveset comando [opciones]
  5252. Comandos:
  5253. create | mk
  5254. delete | rm
  5255. apply
  5256. Para obtener más información sobre cada comando:
  5257. cm shelveset command --usage
  5258. cm shelveset command --help
  5259. == CMD_HELP_ATTRIBUTE ==
  5260. Ejemplos:
  5261. cm shelveset create -c="my comment"
  5262. cm shelveset delete sh:3
  5263. cm shelve apply sh:3
  5264. == CMD_DESCRIPTION_SHELVESET_CREATE ==
  5265. El comando shelve almacena los cambios pendientes.
  5266. == CMD_USAGE_SHELVESET_CREATE ==
  5267. Sintaxis:
  5268. cm shelveset create [opciones] [rutas]
  5269. rutas: rutas de los items a guardar.
  5270. Opciones:
  5271. --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
  5272. rutas dadas, también serán guardados.
  5273. --dependencies: Incluir las dependencias de los cambios locales entre los
  5274. ítems a guardar.
  5275. -c=comentarios: Añade un comentario al shelve creado en la operación.
  5276. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  5277. --summaryformat: El comando imprime sólamente la especificación del
  5278. objeto creado en el repositorio principal.
  5279. == CMD_HELP_SHELVESET ==
  5280. Ejemplos:
  5281. cm shelveset create -c="my comment"
  5282. cm shelveset delete sh:3
  5283. cm shelve apply sh:3
  5284. == CMD_HELP_SHELVESET_CREATE ==
  5285. El comando shelveset create almacena los ítems en checkout especificados
  5286. dentro del repositorio. De este modo el contenido queda almacenado en el
  5287. servidor sin necesidad de hacer check in.
  5288. Notas:
  5289. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  5290. todos los cambios pendientes en el espacio de trabajo.
  5291. - La operación de shelve se aplica siempre recursivamente desde la
  5292. ruta indicada.
  5293. - Requisitos para hacer shelve de un ítem:
  5294. * El ítem debe estar controlado por Unity VCS.
  5295. * El ítem ha de estar desprotegido.
  5296. Ejemplos:
  5297. cm shelveset create
  5298. cm shelveset fichero1.txt fichero2.txt
  5299. Comentarios:
  5300. Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
  5301. cm shelveset -c="my comment"
  5302. cm shelveset -m "my comment"
  5303. Configure la variable de entorno PLASTICEDITOR para especificar un editor
  5304. para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
  5305. configurada pero no se indica ningún comentario, el editor se abrirá para
  5306. que pueda escribir el comentario.
  5307. Ejemplo: Shelve 'changelist'
  5308. cm status --short --changelist=pending_to_review | cm shelveset -
  5309. (El comando listará los paths en el changelist llamado 'pending_to_review'
  5310. y dicha lista será redirigida a la entrada del comando 'shelve').
  5311. == CMD_DESCRIPTION_SHELVESET_DELETE ==
  5312. Borra un shelveset almacenado en el repositorio.
  5313. == CMD_USAGE_SHELVESET_DELETE ==
  5314. Sintaxis:
  5315. cm shelveset delete shelve_spec
  5316. shelve_spec: Elimina los contenidos almancenados en el repositorio
  5317. identificados por "shelve_spec"
  5318. == CMD_HELP_SHELVESET_DELETE ==
  5319. El comando shelveset delete borra un shelveset creado anteriormente.
  5320. Ejemplo:
  5321. cm shelveset delete sh:3
  5322. (Elimina un shelveset almacenado en el repositorio.)
  5323. == CMD_DESCRIPTION_SHELVESET_APPLY ==
  5324. El comando shelveset apply restaura los contenidos almancenados en el
  5325. repositorio.
  5326. == CMD_USAGE_SHELVESET_APPLY ==
  5327. Sintaxis:
  5328. cm shelveset apply shelve_spec [<change_path>[ ...]] [opciones]
  5329. shelve_spec: Restaura los contenidos almancenados en el repositorio
  5330. identificados por "shelve_spec"
  5331. change_path: Ruta(s) del cambio(s) a aplicar. Es la ruta de servidor,
  5332. una de las que se imprime con la opción --preview. Cuando no se indica
  5333. ninguna ruta se aplican todos los cambios del shelve.
  5334. Opciones:
  5335. --preview: Muestra los cambios a aplicar en el workpsace sin aplicarles
  5336. --mount: El punto de montaje del respositorio especificado.
  5337. --encoding=codificación: Especifica la codificación de los ficheros de
  5338. origen (por ejemplo, UTF-8 o Unicode)
  5339. --comparisonmethod=tipo: cualquiera de las siguientes opciones:
  5340. ignoreeol: Ignora diferencias de final de línea.
  5341. ignorewhitespaces: Ignora diferencias de espacios en blanco.
  5342. ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en
  5343. blanco.
  5344. recognizeall: Detecta diferencias de final de línea y espacios en
  5345. blanco.
  5346. == CMD_HELP_SHELVESET_APPLY ==
  5347. El comando shelveset apply restaura los contenidos almancenados en el
  5348. repositorio.
  5349. Ejemplo: Aplicar un shelve almacenado en el repositorio:
  5350. cm shelveset apply sh:3
  5351. Ejemplo: Aplicar solo 1 cambio almacenado en un shelve en el repositorio:
  5352. cm shelveset apply sh:3 /src/foo.c
  5353. == CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
  5354. Muestra la lista de objetos disponibles y sus atributos correspondientes.
  5355. == CMD_USAGE_SHOW_FIND_OBJECTS ==
  5356. Sintaxis:
  5357. cm showfindobjects
  5358. == CMD_HELP_SHOW_FIND_OBJECTS ==
  5359. Objetos y atributos disponibles:
  5360. attribute:
  5361. Se puede buscar atributos filtrando por los siguientes campos:
  5362. Type : string.
  5363. Value : string.
  5364. Date : fecha.
  5365. Consulte la sección "constantes de fecha" en esta guía para más
  5366. info.
  5367. Owner : usuario.
  5368. Admite el usuario especial 'me'.
  5369. GUID : Identificador Global Único.
  5370. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5371. Comment : string.
  5372. SrcObj : object spec.
  5373. ID : integer.
  5374. attributetype:
  5375. Se puede buscar tipos de atributo filtrando por los siguientes campos:
  5376. Name : string.
  5377. Value : string.
  5378. Date : fecha.
  5379. Consulte la sección "constantes de fecha" en esta guía para más
  5380. info.
  5381. Owner : usuario.
  5382. Admite el usuario especial 'me'.
  5383. GUID : Identificador Global Único.
  5384. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5385. Comment : string.
  5386. Source : object spec.
  5387. ID : integer.
  5388. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  5389. en esta guía para más información sobre:
  5390. ReplLogId
  5391. ReplSrcDate
  5392. ReplSrcId
  5393. ReplSrcRepository
  5394. ReplSrcServer
  5395. branch:
  5396. Se puede buscar ramas filtrando por los siguientes campos:
  5397. Name : string.
  5398. Date : fecha.
  5399. Consulte la sección "constantes de fecha" en esta guía para más
  5400. info.
  5401. Changesets : fecha (de los changesets en la rama).
  5402. Consulte la sección "constantes de fecha" en esta guía para más
  5403. info.
  5404. Attribute : string.
  5405. AttrValue : string.
  5406. Owner : usuario.
  5407. Admite el usuario especial 'me'.
  5408. Parent : branch spec.
  5409. Comment : string.
  5410. GUID : Identificador Global Único.
  5411. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5412. Item : item spec or item id (integer).
  5413. ID : integer.
  5414. Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
  5415. por los siguientes campos:
  5416. date
  5417. branchname
  5418. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  5419. en esta guía para más información sobre:
  5420. ReplLogId
  5421. ReplSrcDate
  5422. ReplSrcId
  5423. ReplSrcRepository
  5424. ReplSrcServer
  5425. changeset:
  5426. Se puede buscar changesets filtrando por los siguientes campos:
  5427. Branch : branch spec.
  5428. ChangesetId : integer.
  5429. Attribute : string.
  5430. AttrValue : string.
  5431. Date : fecha.
  5432. Consulte la sección "constantes de fecha" en esta guía
  5433. para más info.
  5434. Owner : usuario.
  5435. Admite el usuario especial 'me'.
  5436. GUID : Identificador Global Único.
  5437. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5438. Comment : string.
  5439. OnlyWithRevisions : boolean.
  5440. ReturnParent : boolean.
  5441. Parent : changeset id (integer).
  5442. ID : integer.
  5443. Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
  5444. por los siguientes campos:
  5445. date
  5446. changesetid
  5447. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  5448. en esta guía para más información sobre:
  5449. ReplLogId
  5450. ReplSrcDate
  5451. ReplSrcId
  5452. ReplSrcRepository
  5453. ReplSrcServer
  5454. label:
  5455. Se puede buscar etiquetas filtrando por los siguientes campos:
  5456. Name : string.
  5457. Attribute : string.
  5458. AttrValue : string.
  5459. Date : fecha.
  5460. Consulte la sección "constantes de fecha" en esta guía para más
  5461. info.
  5462. Owner : usuario.
  5463. Admite el usuario especial 'me'.
  5464. GUID : Identificador Global Único.
  5465. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5466. Branch : branch spec.
  5467. Branchid : integer.
  5468. Changeset : changeset id (integer).
  5469. Comment : string.
  5470. ID : integer.
  5471. Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
  5472. por los siguientes campos:
  5473. date
  5474. labelname
  5475. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  5476. en esta guía para más información sobre:
  5477. ReplLogId
  5478. ReplSrcDate
  5479. ReplSrcId
  5480. ReplSrcRepository
  5481. ReplSrcServer
  5482. merge:
  5483. Se puede buscar merges filtrando por los siguientes campos:
  5484. SrcBranch : branch spec.
  5485. SrcChangeset : changeset id (integer).
  5486. DstBranch : branch spec.
  5487. DstChangeset : changeset id (integer).
  5488. Date : fecha.
  5489. Consulte la sección "constantes de fecha" en esta guía para
  5490. más info.
  5491. Owner : usuario.
  5492. Admite el usuario especial 'me'.
  5493. GUID : Identificador Global Único.
  5494. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5495. Type : string.
  5496. Los posibles valores son 'merge', 'cherrypick',
  5497. 'cherrypicksubstractive', 'interval', 'intervalcherrypick'
  5498. e 'intervalcherrypicksubstractive'
  5499. ID : integer.
  5500. replicationlog:
  5501. Se puede buscar replication log filtrando por los siguientes campos:
  5502. Branch : branch spec.
  5503. RepositoryName : string.
  5504. Owner : usuario.
  5505. Admite el usuario especial 'me'.
  5506. Date : fecha.
  5507. Consulte la sección "constantes de fecha" en esta guía para
  5508. más info.
  5509. Server : string.
  5510. Package : boolean.
  5511. ID : integer.
  5512. review:
  5513. Se puede buscar code reviews filtrando por los siguientes campos:
  5514. Status : string.
  5515. Assignee : string.
  5516. Title : string.
  5517. Target : object spec.
  5518. TargetId : integer.
  5519. TargetType : string.
  5520. Los posibles valores son 'branch' y 'changeset'.
  5521. Date : fecha.
  5522. Consulte la sección "constantes de fecha" en esta guía para más
  5523. info.
  5524. Owner : usuario.
  5525. Admite el usuario especial 'me'.
  5526. GUID : Identificador Global Único.
  5527. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5528. Id : integer.
  5529. Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
  5530. por los siguientes campos:
  5531. date
  5532. modifieddate
  5533. status
  5534. revision:
  5535. Se puede buscar revisiones filtrando por los siguientes campos:
  5536. Branch : branch spec.
  5537. Changeset : changeset id (integer).
  5538. Item : string o integer.
  5539. ItemId : integer.
  5540. Attribute : string.
  5541. AttrValue : string.
  5542. Archived : boolean.
  5543. Comment : string.
  5544. Date : fecha.
  5545. Consulte la sección "constantes de fecha" en esta guía
  5546. para más info.
  5547. GUID : Identificador Global Único.
  5548. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5549. Owner : usuario.
  5550. Admite el usuario especial 'me'.
  5551. Parent : revision id (integer).
  5552. ReturnParent : boolean.
  5553. Shelve : shelve id (integer).
  5554. Size : integer (en bytes).
  5555. Type : string.
  5556. Los posibles valores son 'dir', 'bin' y 'txt'.
  5557. WorkspaceCheckoutId : integer.
  5558. ID : integer.
  5559. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  5560. en esta guía para más información sobre:
  5561. ReplLogId
  5562. ReplSrcDate
  5563. ReplSrcId
  5564. ReplSrcRepository
  5565. ReplSrcServer
  5566. shelve:
  5567. Se puede buscar shelves filtrando por los siguientes campos:
  5568. Owner : usuario.
  5569. Admite el usuario especial 'me'.
  5570. Date : fecha.
  5571. Consulte la sección "constantes de fecha" en esta guía para más
  5572. info.
  5573. Attribute : string.
  5574. AttrValue : string.
  5575. Comment : string.
  5576. GUID : Identificador Global Único.
  5577. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  5578. Parent : integer.
  5579. ShelveId : integer.
  5580. ID : integer.
  5581. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  5582. en esta guía para más información sobre:
  5583. ReplLogId
  5584. ReplSrcDate
  5585. ReplSrcId
  5586. ReplSrcRepository
  5587. ReplSrcServer
  5588. Campos relacionados con la réplica:
  5589. Muchos objetos mantienen información de replicación, lo que significa que
  5590. Unity VCS mantiene el rastro de dónde se crearon originalmente.
  5591. Los campos que se pueden utilizar son:
  5592. ReplSrcServer : Significa "servidor origen de la réplica", y es el
  5593. servidor de donde se trajeron los objetos.
  5594. Ejemplo:
  5595. cm find branch "where replsrcserver='skull.codicefactory.com:9095'"
  5596. ReplSrcRepository : string. Significa "repositorio origen de la réplica",
  5597. y es el repositorio de donde se trajeron los objetos.
  5598. Ejemplo:
  5599. cm find branch "where \
  5600. replsrcserver = 'skull.codicefactory.com:9095' \
  5601. and replsrcrepository = 'codice'"
  5602. ReplLogId : integer. El identificador de la operación de réplica.
  5603. En Unity VCS, cada vez que un objeto nuevo se crea de una
  5604. réplica, también se crea un nuevo 'replicationlog'.
  5605. Ejemplo:
  5606. cm find replicationlog
  5607. 324054 9/13/2018 02:00:15 /main/scm23064 sluisp plasticscm.com T
  5608. 327255 9/11/2018 12:33:38 /main/scm23042 maria plasticscm.com T
  5609. 329631 9/17/2018 13:06:49 /main/scm23099 sluisp plasticscm.com T
  5610. Ahora se pueden buscar las ramas creadas en la réplica 327255, en
  5611. caso de haber alguna:
  5612. cm find branch "where replogid=327255"
  5613. ReplSrcDate: fecha. Es la fecha en la que la operación de réplica tuvo
  5614. lugar. Los objetos replicados mantienen la fecha en la que
  5615. fueron creados originalmente, por lo que este campo es útil
  5616. si se necesita buscar objetos que fueron replicados en un
  5617. determinado marco temporal.
  5618. Ejemplo:
  5619. cm find replicationlog "where date > 'one week ago'"
  5620. 8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc
  5621. Ahora se puede verificar que la rama replicada se creó antes de la
  5622. propia operación de réplica:
  5623. cm find branch "where repllogid = 8780433"
  5624. 8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
  5625. ReplSrcId: integer. Es el ID del servidor origen de la réplica
  5626. (ReplSrcServer). Este ID se puede descubrir buscando objetos
  5627. de tipo 'replicationsource' con el comando 'cm find'.
  5628. Ejemplo:
  5629. cm find replicationsource
  5630. 7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
  5631. 8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
  5632. Ahora se pueden buscar los changesets replicados desde
  5633. codice@AFRODITA:8087 de la siguiente forma:
  5634. cm find changesets "where replsrcid = 7860739"
  5635. Constantes de fecha:
  5636. Se pueden usar fechas formateadas siguiendo la configuración de localización
  5637. del Sistema Operativo. Por ejemplo, si el SO muestra fechas en el formato
  5638. 'dd/MM/yyyy', se pueden utilizar fechas como '31/12/2018' en las consultas.
  5639. Sin embargo, también se pueden utilizar las siguientes constantes para
  5640. facilitar la escritura de las queries:
  5641. 'today' : la fecha de hoy.
  5642. 'yesterday' : la fecha de ayer.
  5643. 'this week' : la fecha del lunes de la semana actual.
  5644. 'this month' : la fecha del primer día del mes actual.
  5645. 'this year' : la fecha del 1 de enero del año actual.
  5646. 'one day ago' : un día antes de la fecha actual.
  5647. 'one week ago' : una semana antes de la fecha actual.
  5648. 'one month ago' : un mes antes de la fecha actual.
  5649. 'n days ago' : 'n' días antes de la fecha actual.
  5650. 'n months ago' : 'n' meses antes de la fecha actual.
  5651. 'n years ago' : 'n' años antes de la fecha actual.
  5652. Las siguientes cláusulas 'where' son válidas para campos que admitan fechas:
  5653. '(...) where date > 'today' (...)'
  5654. '(...) where date < 'yesterday' (...)'
  5655. '(...) where date > 'this week' (...)'
  5656. '(...) where date > 'this month' (...)'
  5657. '(...) where date < 'one day ago' and date > '3 days ago' (...)'
  5658. '(...) where date < 'one week ago' and date > '3 weeks ago' (...)'
  5659. '(...) where date < 'one month ago' and date > '3 months ago' (...)'
  5660. '(...) where date > '1 year ago' (...)'
  5661. También se puede forzar un determinado formato de fecha en el comando
  5662. 'cm find' utilizando el flag --dateformat. Lee 'cm find --help' para más
  5663. información.
  5664. == CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
  5665. Muestra la lista de los tipos de triggers disponibles.
  5666. == CMD_USAGE_TRIGGER_SHOWTYPES ==
  5667. Sintaxis:
  5668. cm trigger showtypes
  5669. == CMD_DESCRIPTION_SHOWACL ==
  5670. Muestra la ACL (Lista de Control de Acceso) de un elemento.
  5671. == CMD_USAGE_SHOWACL ==
  5672. Sintaxis:
  5673. cm showacl [opciones] spec_objeto
  5674. spec_objeto Especificación del objeto sobre el que mostrar el ACL.
  5675. Objetos válidos para este comando son repserver,
  5676. repositorio, rama, changeset, etiqueta, item y atributo.
  5677. Usa 'cm help objectspec' para obtener más información
  5678. sobre la especificación de objetos.
  5679. Opciones:
  5680. --extended Muestra información detallada.
  5681. --xml Permite volcar la salida del comando en formato xml
  5682. a la salida estándar. También se permite especificar
  5683. un fichero de salida (--xml=output.xml).
  5684. --encoding Si se utiliza con la opción --xml, permite especificar
  5685. el encoding con el que se guardará la salida del
  5686. comando. Por ejemplo: --encoding=utf-8
  5687. Consulte la documentación de la MSDN para obtener la
  5688. tabla completa de codificaciones soportadas y su formato;
  5689. al final de la página en la columna "Name":
  5690. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  5691. == CMD_HELP_SHOWACL ==
  5692. Notas:
  5693. Este comando se utiliza para obtener una lista de permisos de un usuario o
  5694. un grupo sobre un elemento del repositorio.
  5695. Ejemplos:
  5696. cm showacl repserver:PlasticServer:8084
  5697. cm showacl br:/main --extended
  5698. == CMD_DESCRIPTION_SHOWCOMMANDS ==
  5699. Muestra todos los comandos disponibles.
  5700. == CMD_USAGE_SHOWCOMMANDS ==
  5701. Sintaxis:
  5702. cm showcommands
  5703. == CMD_HELP_SHOWCOMMANDS ==
  5704. == CMD_DESCRIPTION_SHOWOWNER ==
  5705. Muestra el propietario de un elemento del repositorio.
  5706. == CMD_USAGE_SHOWOWNER ==
  5707. Sintaxis:
  5708. cm showowner spec_objeto
  5709. spec_objeto Especificación del objeto para mostar su propietario.
  5710. Usa 'cm help objectspec' para obtener más información
  5711. sobre la especificación de objetos.
  5712. El objeto debe ser uno de los siguientes: repserver,
  5713. repositorio, rama, changeset, etiqueta, atributo,
  5714. revisión e item.
  5715. == CMD_HELP_SHOWOWNER ==
  5716. Notas:
  5717. Este comando muestra el propietario de un elemento del repositorio.
  5718. Puede ser un usuario o un grupo.
  5719. El propietario se puede modificar con el comando 'cm setowner'.
  5720. Ejemplos:
  5721. cm showowner repserver:PlasticServer:8084
  5722. cm showowner rev:fichero.cs#br:/main#LAST
  5723. == CMD_DESCRIPTION_SHOWPERMISSIONS ==
  5724. Muestra la lista de los permisos disponibles.
  5725. == CMD_USAGE_SHOWPERMISSIONS ==
  5726. Sintaxis:
  5727. cm showpermissions
  5728. == CMD_HELP_SHOWPERMISSIONS ==
  5729. Ejemplos:
  5730. cm showpermissions
  5731. == CMD_DESCRIPTION_SHOWSELECTOR ==
  5732. Muestra el selector del espacio de trabajo actual.
  5733. == CMD_USAGE_SHOWSELECTOR ==
  5734. Sintaxis:
  5735. cm showselector [wk_ruta | wk_spec]
  5736. wk_ruta Ruta del espacio de trabajo para mostrar su selector
  5737. wk_spec Especificación del espacio de trabajo para mostrar su
  5738. selector.
  5739. Usa 'cm help objectspec' para obtener más información sobre
  5740. especificaciones de espacios de trabajo.
  5741. == CMD_HELP_SHOWSELECTOR ==
  5742. Notas:
  5743. Si no se especifica una ruta o un especificador de espacio de trabajo,
  5744. el comando tomará como ruta el directorio actual.
  5745. Ejemplos:
  5746. cm showselector c:\workspace
  5747. cm showselector
  5748. cm showselector > miSelector.txt
  5749. cm showselector wk:build_wk@BUILDER
  5750. == CMD_DESCRIPTION_SUPPORT ==
  5751. Este comando permite al usuario efectuar operaciones de soporte.
  5752. == CMD_USAGE_SUPPORT ==
  5753. Sintaxis:
  5754. cm support comando [opciones]
  5755. Comandos:
  5756. bundle
  5757. Para obtener más información sobre cada uno de los comandos ejecute:
  5758. cm support comando --usage
  5759. cm support comando --help
  5760. == CMD_HELP_SUPPORT ==
  5761. Ejemplos:
  5762. cm support
  5763. cm support bundle
  5764. cm support bundle c:\outputfile.zip
  5765. == CMD_DESCRIPTION_SUPPORT_BUNDLE ==
  5766. Crea el paquete de soporte con los ficheros de log relevantes.
  5767. Este paquete se puede adjuntar cuando se solicita la ayuda, cuando
  5768. se pregunte por información extra o cuando se envíe un error.
  5769. == CMD_USAGE_SUPPORT_BUNDLE ==
  5770. Sintaxis:
  5771. cm support bundle [outputfile]
  5772. Opciones:
  5773. outputfile Crea el paquete de soporte en la ruta especificado.
  5774. == CMD_HELP_SUPPORT_BUNDLE ==
  5775. Notas:
  5776. Este comando permite al usuario crear un paquete de soporte con los
  5777. ficheros de log relevantes. Es posible especificar un fichero de salida.
  5778. Ejemplos:
  5779. cm support bundle
  5780. (Crea el paquete de soporte en el directorio temporal)
  5781. cm support bundle c:\outputfile.zip
  5782. (Crea el paquete de soporte en la ruta especificado)
  5783. == CMD_DESCRIPTION_SWITCH ==
  5784. Actualiza el espacio de trabajo a la rama, etiqueta, changeset o shelve especificado.
  5785. == CMD_USAGE_SWITCH ==
  5786. Sintaxis:
  5787. cm switch brspec | csetspec | lbspec | shspec
  5788. [--workspace=path] [--repository=name]
  5789. [--forcedetailedprogress] [--noinput]
  5790. [--silent] [--verbose] [--xml[=<output_file>]] [--encoding=<name>]
  5791. Opciones:
  5792. --workspace Ruta del espacio de trabajo a cambiar.
  5793. --repository Repositorio al que se va a cambiar.
  5794. --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
  5795. redirige la salida estándar.
  5796. --noinput Ignora las preguntas interactivas para continuar la
  5797. operación con cambios pendientes o haciendolos shelve.
  5798. --silent Solo se imprimen mensajes en caso de error.
  5799. --verbose Muestra información adicional.
  5800. --xml Imprime el resultado en formato XML a la salida
  5801. estándar. También es posible especificar un fichero
  5802. de salida.
  5803. --encoding Usado con la opción --xml, especifica el encoding
  5804. que se usará en la salida XML, por ejemplo, utf-8.
  5805. Consulte la documentación de MSDN en
  5806. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  5807. para obtener la tabla de codificaciones soportadas y
  5808. su formato (al final de la página en la columna "Name").
  5809. Usa 'cm help objectspec' para aprender más sobre cómo indicar
  5810. especificaciones de changesets, ramas y etiquetas.
  5811. == CMD_HELP_SWITCH ==
  5812. Notas:
  5813. Este comando permite a los usuarios actualizar el espacio de trabajo
  5814. con el contenido del objeto especificado (rama, etiqueta o changeset).
  5815. Ejemplos:
  5816. cm switch br:/main
  5817. cm switch lb:Rel1.1
  5818. cm switch Rel2.0
  5819. cm switch cs:4375
  5820. cm switch 5632
  5821. cm switch sh:2
  5822. == CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
  5823. Establece la rama especificada como rama de trabajo.
  5824. == CMD_USAGE_SWITCH_TO_BRANCH ==
  5825. Sintaxis:
  5826. cm switchtobranch [opciones] [spec_rama]
  5827. spec_rama: Especificación de rama.
  5828. Opciones:
  5829. --label=nombre | --changeset=número: Carga las revisiones de la etiqueta
  5830. o changeset especificado. Si no se especifica spec_rama, una de
  5831. estas opciones es obligatoria.
  5832. --workspace | -wk=path: Ruta del espacio de trabajo a cambiar.
  5833. == CMD_HELP_SWITCH_TO_BRANCH ==
  5834. Notas:
  5835. Este comando permite a los usuarios especificar una rama, como rama de
  5836. trabajo. Adicionalmente se puede especificar una etiqueta o un changeset,
  5837. desde la cual se cargarán las revisiones.
  5838. Si no se especifica rama, se ha de especificar una etiqueta o un changeset
  5839. obligatoriamente. Consulte el manual para obtener más información.
  5840. Si no se especifica repositorio, la rama se fija sobre el repositorio
  5841. actual.
  5842. Ejemplos:
  5843. cm switchtobranch br:/main
  5844. cm switchtobranch br:/main/tarea001
  5845. cm switchtobranch --label=BL050
  5846. (Configuración de sólo lectura. Se cargan revisiones del changeset etiquetado)
  5847. == CMD_DESCRIPTION_SYNC ==
  5848. Sincroniza con Git
  5849. == CMD_USAGE_SYNC ==
  5850. Sintaxis:
  5851. cm synchronize | sync repspec git [url [--user=usr_name --pwd=pwd]] [--author]
  5852. [[--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent]=value]
  5853. [--skipgitlfs] [--gitpushchunk=<value>]
  5854. repspec Especificación del repositorio.
  5855. Usa 'cm help objectspec' para obtener más información
  5856. sobre la especificación de repositorios.
  5857. git (Default).
  5858. Opciones:
  5859. url URL del repositorio remoto
  5860. (http(s):// o git:// o una URL ssh).
  5861. --user Nombre de usuario para la URL especificada.
  5862. --pwd Contraseña para la URL especificada.
  5863. --txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent
  5864. Opciones para detectar ítems movidos, del mismo modo que
  5865. lo hace la GUI de Unity VCS.
  5866. --author Usa los valores de nombre y fecha (timestamp) del autor
  5867. en git (git committer by default).
  5868. --skipgitlfs Ignora la configuración de Git LFS que haya en el
  5869. fichero '.gitattributes'. Se comporta como si no
  5870. tuviese soporte de Git LFS.
  5871. --gitpushchunk Procesa la operación de push (exportar cambios de
  5872. Unity VCS a Git) en bloques de un determinado número
  5873. de changesets. Esta opción solo es útil en
  5874. repositorios muy grandes para evitar problemas con
  5875. la red o con el tamaño del paquete a enviar a Git o
  5876. simplemente con el fin de depurar otros problemas.
  5877. Usa bloques de 1000 changesets si no se especifica
  5878. un valor concreto.
  5879. == CMD_HELP_SYNC ==
  5880. Notas:
  5881. En caso de sincronizar con un servidor que no requiera credenciales, tras
  5882. la primera sincronización no es necesario introducir el parámetro URL.
  5883. Este comando no soporta repositorios locales.
  5884. En el caso de usar el protocolo SSH, es necesario tener añadido al PATH
  5885. el cliente por línea de comandos 'ssh' y que esté correctamente configurado
  5886. para conectarse al servidor remoto (claves públicas/privadas).
  5887. Ejemplos:
  5888. cm sync default@localhost:8087 git git://localhost/repository
  5889. == CMD_DESCRIPTION_TRIGGER ==
  5890. Use este comando para administrar triggers.
  5891. == CMD_USAGE_TRIGGER ==
  5892. Sintaxis:
  5893. cm trigger | tr <command> [options]
  5894. Comandos:
  5895. create | mk
  5896. delete | rm
  5897. edit
  5898. list | ls
  5899. showtypes
  5900. Para obtener más información sobre cada comando:
  5901. cm trigger <command> --usage
  5902. cm trigger <command> --help
  5903. == CMD_HELP_TRIGGER ==
  5904. Ejemplos:
  5905. cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
  5906. cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
  5907. cm tr ls before-mkbranch --server=myserver:8084
  5908. cm tr rm after-setselector 4
  5909. cm tr showtypes
  5910. == CMD_DESCRIPTION_TUBE ==
  5911. Ejecuta comandos relacionados con Plastic Tube.
  5912. == CMD_USAGE_TUBE ==
  5913. Sintaxis:
  5914. cm tube config -u=user -p=password
  5915. cm tube create remoteuser
  5916. cm tube remove remoteuser
  5917. cm tube local
  5918. cm tube remote
  5919. cm tube share <repository_spec>+ -u=remoteuser -a=access_mode
  5920. cm tube unshare <repository_spec>+ -u=remoteuser
  5921. cm tube connect
  5922. cm tube disconnect
  5923. cm tube status
  5924. Opciones:
  5925. -u Usuario de Tube (el usuario de plasticscm.com)
  5926. -p Password del usuario
  5927. -a Acceso: pull, push o ambos (pull | push | pull,push)
  5928. rep_spec Especificación del repositorio.
  5929. Usa 'cm help objectspec' para obtener más información
  5930. sobre la especificación de repositorios.
  5931. == CMD_HELP_TUBE ==
  5932. Notas:
  5933. config
  5934. Configura Unity VCS para usar Plastic Tube con el usuario y password
  5935. especificados.
  5936. create
  5937. Crea el Tube remoteuser -> myuser.
  5938. El usuario 'myuser' permite a 'remoteuser' conectarse al servidor
  5939. de 'myuser'.
  5940. Pueden establecerse conexiones de 'remoteuser' a 'myuser'.
  5941. Sólo pueden crearse un Tube de otro usuario al usuario actual de
  5942. Plastic Tube.
  5943. remove
  5944. Elimina el Tube remoteuser -> myuser.
  5945. local
  5946. Lista los repositorios locales compartidos en el servidor local y los
  5947. usuarios con quien son compartidos.
  5948. remote
  5949. Lista los repositorios remotamente compartidos que son compartidos con
  5950. el usuario actual de Plastic Tube.
  5951. share
  5952. Comparte el repositorio(s) local con el usuario y remoto y los permisos
  5953. especificados.
  5954. unshare
  5955. Deja de compartir el repositorio local con el usuario remoto.
  5956. connect
  5957. Conecta el servidor de Unity VCS a Plastic Tube.
  5958. disconnect
  5959. Desconecta el servidor de Unity VCS de Plastic Tube.
  5960. status
  5961. Muestra si el servidor de Unity VCS está conectado a Plastic Tube.
  5962. Ejemplos:
  5963. cm tube config -u=ruben@codicesoftware.com -p=rubenpassword
  5964. cm tube create pablo@codicesoftware.com
  5965. ('pablo@codicesoftware.com' puede conectar con el usuario actual del Tube)
  5966. cm tube remove pablo@codicesoftware.com
  5967. cm tube local
  5968. cm tube remote
  5969. cm tube share repo@server:8087 -u=pablo@codicesoftware.com -a=pull,push
  5970. cm tube share repo@server:8087 doc@server:8087 -u=pablo@codicesoftware.com -a=push
  5971. cm tube unshare repo@server:8087 -u=pablo@codicesoftware.com
  5972. cm tube connect
  5973. cm tube disconnect
  5974. cm tube status
  5975. == CMD_DESCRIPTION_UNDOCHECKOUT ==
  5976. Deshace la desprotección de un ítem.
  5977. == CMD_USAGE_UNDOCHECKOUT ==
  5978. Sintaxis:
  5979. cm undocheckout | unco <item_path>+ [--all] [--symlink] [--silent]
  5980. [--keepchanges | -k]
  5981. item_path Especificación de los ítems para deshacer la desprotección,
  5982. separados por comas.
  5983. Se pueden usar comillas (") para especificar rutas que
  5984. contengan espacios.
  5985. Use . para aplicar la operación al directorio actual.
  5986. Opciones:
  5987. --all (-a) Los ítems especificados que han sido cambiados, movidos
  5988. y borrados localmente también serán deshechos.
  5989. --symlink Deshace la protección del fichero de link y no al
  5990. elemento al que apunta.
  5991. --silent No muestra salida.
  5992. --keepchanges (-k) Deshace la desprotección dejando los cambios locales.
  5993. Ejemplo: un checkout lo deja como changed con el
  5994. contenido en disco que tenia antes de hacer el unco.
  5995. Esta opción no puede utilizarse con workspaces dinámicos.
  5996. == CMD_HELP_UNDOCHECKOUT ==
  5997. Notas:
  5998. Si se desean descartar los cambios realizados en un ítem desprotegido
  5999. previamente, se utiliza este comando.
  6000. El ítem se cambia a la revisión justamente anterior.
  6001. Requisitos para deshacer la desprotección:
  6002. El ítem ha de estar controlado por Unity VCS
  6003. El ítem ha de estar desprotegido
  6004. Ejemplos:
  6005. cm undocheckout .
  6006. (Desprotege el directorio actual)
  6007. cm undocheckout fichero1.txt fichero2.txt
  6008. cm unco c:\workspace\fichero.txt
  6009. cm undocheckout -R c:\workspace\src
  6010. (Deshace la desprotección de 'src' recursivamente)
  6011. cm unco link --symlink
  6012. (Efectúa la desprotección sobre el fichero de symlink y no del que apunta.)
  6013. cm unco code\cgame\cg_main.c --all
  6014. (Deshace la desprotección del fichero cambiado)
  6015. Deshacer 'changelist'. Ejemplo:
  6016. cm status --short --changelist=pending_to_review | cm undocheckout -
  6017. (El comando listará los paths en el changelist llamado 'pending_to_review'
  6018. y dicha lista será redirigida a la entrada del comando 'uncheckout').
  6019. == CMD_DESCRIPTION_UNDOCHECKOUTUNCHANGED ==
  6020. Deshace la desprotección en elementos que no han cambiado.
  6021. == CMD_USAGE_UNDOCHECKOUTUNCHANGED ==
  6022. Sintaxis:
  6023. cm uncounchanged [opciones]
  6024. Opciones:
  6025. -R|-r|--recursive Descender recursivamente dentro de directorios.
  6026. == CMD_HELP_UNDOCHECKOUTUNCHANGED ==
  6027. Notas:
  6028. Este comando se aplica desde la raíz del workspace recursivamente.
  6029. Ejemplos:
  6030. cm uncounchanged
  6031. == CMD_DESCRIPTION_UNDELETE ==
  6032. Recupera en el espacio de trabajo la revisión especificada en la ruta dada.
  6033. == CMD_USAGE_UNDELETE ==
  6034. Sintaxis:
  6035. cm undelete rev_spec ruta
  6036. rev_spec: Especificación de la revisión del ítem cuyo contenido se desea
  6037. cargar en el espacio de trabajo.
  6038. path: Ruta donde se va a restaurar.
  6039. == CMD_HELP_UNDELETE ==
  6040. Notas:
  6041. El elemento a recuperar no debe de estar ya cargado en el workspace.
  6042. La operación de recuperar no esta soportada para xlinks.
  6043. Ejemplos:
  6044. cm undelete revid:756 C:\mywks\src\foo.c
  6045. cm undelete itemid:68#cs:2 C:\mywks\dir\myfile.pdf
  6046. cm undelete serverpath:/src#br:/main C:\mywks\Dir
  6047. == CMD_DESCRIPTION_UNDOCHANGE ==
  6048. Deshace los cambios hechos en un fichero.
  6049. == CMD_USAGE_UNDOCHANGE ==
  6050. Notas:
  6051. Si se desean descartar los cambios en un ítem, independientemente de su
  6052. estado (desprotegido o modificado sin hacer desprotección), este comando
  6053. vuelve a la revisión anterior. Si se ordena realizar la operación sobre
  6054. un directorio en vez de un fichero la acción se realiza recursivamente por
  6055. defecto.
  6056. Ejemplos:
  6057. cm unc . (Descarta los cambios de los ítems del directorio actual).
  6058. cm unc fichero1.txt fichero2.txt
  6059. cm unc c:\workspace\fichero1.txt
  6060. == CMD_HELP_UNDOCHANGE ==
  6061. Ejemplos:
  6062. cm unc . (Descarta los cambios de los ítems del directorio actual).
  6063. cm unc fichero1.txt fichero2.txt
  6064. cm unc c:\workspace\fichero1.txt
  6065. == CMD_DESCRIPTION_UNDO ==
  6066. Deshace cambios en un workspace.
  6067. == CMD_USAGE_UNDO ==
  6068. Syntaxis:
  6069. cm undo [<path> [...]] [--symlink] [-r | --recursive] [<filter> [...]]
  6070. [--silent | --machinereadable [--startlineseparator=<sep>]
  6071. [--endlineseparator=<sep>]
  6072. [--fieldseparator=<sep>]]
  6073. path Rutas de los ficheros o directorios sobre los que deshacer los
  6074. cambios. Use comillas dobles (" ") para especificar rutas que
  6075. contengan espacios. Use un espacio en blanco para separar rutas
  6076. de ítems.
  6077. Si no se especifica ninguna ruta, la operación se ejecutará
  6078. sobre los ficheros del directorio actual.
  6079. filter Aplica el filtro o filtros indicados a las rutas especificadas.
  6080. Use un espacio en blanco para separar filtros. Consulte la
  6081. sección Filtros para más información.
  6082. Opciones:
  6083. --symlink Deshace los cambios en el symlink pero no en el
  6084. destino (target).
  6085. -r Deshace los cambios recursivamente.
  6086. --silent No muestra ninguna salida.
  6087. --machinereadable Muestra el resultado en un formato fácil de parsear.
  6088. --startlineseparator Usado con '--machinereadable', indica cómo deben
  6089. empezar las líneas del resultado.
  6090. --endlineseparator Usado con '--machinereadable', indica cómo deben
  6091. terminar las líneas del resultado.
  6092. --fieldseparator Usado con '--machinereadable', indica cómo deben
  6093. separarse los campos de cada línea resultante.
  6094. Filtros:
  6095. Las rutas se pueden filtrar usando uno o varios de los filtros a continuación.
  6096. Cada uno de estos filtros se refiere a un tipo de cambio:
  6097. --checkedout Selecciona ficheros y directorios desprotegidos (checked-out).
  6098. --unchanged Selecciona ficheros sin cambios.
  6099. --changed Selecciona ficheros y directorios cambiados o desprotegidos
  6100. (checked-out).
  6101. --deleted Selecciona ficheros y directorios borrados.
  6102. --moved Selecciona ficheros y directorios movidos.
  6103. --added Selecciona ficheros y directorios añadidos.
  6104. Si la ruta contiene alguno de los tipos de cambios especificados en los
  6105. filtros, entonces solo esos tipos de cambios se desharán en dicha ruta.
  6106. Por ejemplo, si se especifica a la vez --checkedout y --moved, si un fichero
  6107. está tanto movido como checkedout, ambos tipos de cambios se desharán.
  6108. Si no se especifica ningun filtro, se deshacen todos los tipos de cambios.
  6109. == CMD_HELP_UNDO ==
  6110. Notas:
  6111. - Si no se especifica ninguna ruta, se deshacen todos los cambios en el
  6112. directorio actual pero no recursivamente.
  6113. - Si se especifica una o más rutas, se deshacen todos los cambios en las
  6114. rutas especificadas pero no recursivamente.
  6115. - Para hacer que el undo sea recursivo hay que especificar la opción -r.
  6116. Así para deshacer todos los cambios de un directorio incluyendo los cambios
  6117. sobre el propio directorio habría que ejecutar lo siguiente:
  6118. cm undo dirpath -r
  6119. Si dirpath es la ruta de un workspace, entonces se deshacen todos los
  6120. cambios dentro del workspace.
  6121. - El comando undo es peligroso porque deshace los cambios irreversiblemente.
  6122. Es decir, no hay manera posible de recuperar el estado anterior de los
  6123. ficheros y directorios afectados.
  6124. - En el siguiente escenario:
  6125. /src
  6126. |- file.txt
  6127. |- code.cs
  6128. \- /test
  6129. |- test_a.py
  6130. \- test_b.py
  6131. Estos comandos son equivalentes (ejecutados desde el directorio /src):
  6132. cm undo
  6133. cm undo *
  6134. cm undo file.txt code.cs /test
  6135. Y estos también son equivalentes (también ejecutados desde /src):
  6136. cm undo .
  6137. cm undo /src file.txt code.cs
  6138. Ejemplos:
  6139. cm undo .
  6140. (Deshace todos los cambios en el directorio actual.
  6141. No deshará los cambios contenidos en subdirectorios.)
  6142. cm undo . -r
  6143. (Deshace recursivamente todos los cambios en el directorio actual. Si
  6144. se ejecuta desde la raíz del workspace, deshace todos los cambios en el
  6145. workspace completo.)
  6146. cm co file.txt
  6147. cm undo file.txt
  6148. (Deshace el checkout en file.txt.)
  6149. cm undo c:\otroworkspace\file.txt
  6150. (Deshace los cambios en 'file.txt' que se encuentra en un workspace distinto
  6151. del que se está trabajando.)
  6152. echo content >> file.txt
  6153. cm undo file.txt
  6154. (Deshace el cambio local en file.txt.)
  6155. cm undo src
  6156. (Deshace los cambios en el directorio src y en todos los ficheros
  6157. controlados que contenga)
  6158. cm undo src/*
  6159. (Deshace los cambios en todos ficheros y directorios en src sin afectar
  6160. al propio directorio.)
  6161. cm undo *.cs
  6162. (Deshace cambios en cada fichero y directorio que cumpla el patrón *.cs en
  6163. el directorio actual.)
  6164. cm undo *.cs -r
  6165. (Deshace recursivamente cambios en cada fichero y directorio que cumpla el
  6166. patrón *.cs en el directorio actual y en cada directorio por debajo.)
  6167. cm co file1.txt file2.txt
  6168. echo content >> file1.txt
  6169. cm undo --unchanged
  6170. (Deshace el checkout en file2.txt y no en file1.txt ya que file1.txt sí
  6171. tiene cambios locales.)
  6172. echo content >> file1.txt
  6173. echo content >> file2.txt
  6174. cm co file1.txt
  6175. cm undo --checkedout
  6176. (Deshace el cambio en el fichero desprotegido (checked-out) file1.txt e
  6177. ignora file2.txt ya que no está en checked-out.)
  6178. cm add file.txt
  6179. cm undo file.txt
  6180. (Deshace el añadido de file.txt dejándolo de nuevo como privado.)
  6181. $ rm file1.txt
  6182. $ echo content >> file2.txt
  6183. $ cm add file3.txt
  6184. $ cm undo --deleted --added *
  6185. (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
  6186. el cambio en file2.txt.)
  6187. == CMD_DESCRIPTION_LOCK_UNLOCK ==
  6188. Deshace los bloqueos en los elementos de un servidor.
  6189. == CMD_USAGE_LOCK_UNLOCK ==
  6190. Sintaxis:
  6191. cm lock unlock <itemspec>[ ...] [--remove]
  6192. --remove Elimina completamente el bloqueo para el elemento
  6193. específicado. Si esta opción no se espefica,
  6194. simplemente se libera el bloqueo actual.
  6195. itemspec Una o más especificaciones de ítem.(Use 'cm help objectspec'
  6196. para más información sobre especificaciones de ítem.)
  6197. == CMD_HELP_LOCK_UNLOCK ==
  6198. Notas:
  6199. - Sólo el administrador del servidor puede ejecutar 'cm unlock --remove'
  6200. para elminar bloqueos.
  6201. - Sólo el administrador del servidor puede liberar bloqueos que pertenecen
  6202. a otros usuarios. Cualquier usuario puede liberar su propios bloqueos.
  6203. Ejemplos:
  6204. cm lock unlock itemid:56@myrep@DIGITALIS:8084
  6205. (Libera el bloqueo del ítem id 56 en el repo 'myrep@DIGITALIS'.)
  6206. cm lock unlock item:/workspace/foo.psd item:/workspace/bar.psd
  6207. (Libera el bloqueo de los items especificados.)
  6208. cm lock unlock itemid:56@myrep itemid:89@myrep --remove
  6209. (Elimina el bloqueo de los items especificados.)
  6210. cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
  6211. (Deshace el bloqueo del ítem indicado.)
  6212. cm lock unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \
  6213. bcb98a61-2f62-4309-9a26-e21a2685e075
  6214. (Deshace los bloqueos de los ítems indicados del servidor 'DIGITALIS'.)
  6215. cm lock unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \
  6216. 71263c17-5eaf-5271-4d2c-a25f72e101d4
  6217. (Deshace los bloqueos de los ítems indicados del servidor cloud 'tardis'.)
  6218. == CMD_DESCRIPTION_LOCK_CREATE ==
  6219. Crea bloqueos en los elementos de un servidor.
  6220. == CMD_USAGE_LOCK_CREATE ==
  6221. Sintaxis:
  6222. cm lock create | mk <branchspec> <itemspec>[ ...]
  6223. branchspec La rama donde los bloqueos serán creados.
  6224. (Use 'cm help objectspec' para más información sobre
  6225. especificaciones de rama.)
  6226. itemspec Una o más especificaciones de ítem.
  6227. (Use 'cm help objectspec' para más información sobre
  6228. especificaciones de ítem.)
  6229. == CMD_HELP_LOCK_CREATE ==
  6230. Notas:
  6231. - Sólo el administrador del servidor puede crear bloqueos.
  6232. - Todos los bloqueos creados con este comando son inicializados en el
  6233. estado Retained.
  6234. - Si la revisión cargada en la rama especificada (por cada elemento
  6235. especificado) coincide con la revision cargada en la rama de destino
  6236. (/main por defecto), el lock no será creado.
  6237. - El repositorio de la branchspec debe ser el mismo que el de todos las
  6238. itemspecs especificadas.
  6239. Ejemplos:
  6240. cm lock create /main/task@myrep itemid:56@myrep
  6241. (Crea bloqueo para el ítem id 56 en la rama /main/task@myrep.)
  6242. cm lock create br:/main/task item:/workspace/foo.psd item:/workspace/bar.psd
  6243. (Crea bloqueos para los items especificados en la rama /main/task.)
  6244. == CMD_DESCRIPTION_UPDATE ==
  6245. Actualiza el espacio de trabajo.
  6246. == CMD_USAGE_UPDATE ==
  6247. Sintaxis:
  6248. cm update [<ruta> | --last]
  6249. [--changeset=csetspec] [--cloaked] [--dontmerge] [--forced]
  6250. [--ignorechanges] [--override] [--recursewk] [--skipchangedcheck]
  6251. [--silent] [--verbose] [--xml[=output_file]] [--encoding=name]
  6252. [--machinereadable [--startlineseparator=<sep>]
  6253. [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
  6254. [--forcedetailedprogress] [--noinput]
  6255. ruta Ruta a actualizar.
  6256. Use . para aplicar la actualización al directorio actual.
  6257. Si no se especifica ninguna ruta, se actualiza todo
  6258. el workspace.
  6259. --last Antes de la actualización, cambia el selector del
  6260. espacio de trabajo (workspace) desde una configuración
  6261. de changeset o de etiqueta a una configuración de
  6262. rama.
  6263. El selector se cambia a la rama a la que pertenece el
  6264. changeset o la etiqueta.
  6265. Opciones:
  6266. --changeset Actualiza el espacio de trabajo a un changeset concreto.
  6267. (Use 'cm help objectspec' para obtener más información
  6268. sobre la especificación de changesets.)
  6269. --cloaked Incluye los ítems cloaked en la operación de update.
  6270. Si no se utiliza esta opción, se ignorarán durante
  6271. la actualización todos los ítems cloaked.
  6272. --dontmerge El update merge no se llevará cabo en el caso en que
  6273. se requiera esa operación.
  6274. --forced Fuerza la actualización de todos los ítems a aquella
  6275. revisión especificada en el selector.
  6276. --ignorechanges Si existen cambios pendientes durante la actualización
  6277. del espacio de trabajo, se ignorarán y se continuará
  6278. con la actualización.
  6279. --noinput Ignora las preguntas interactivas para continuar la
  6280. operación con cambios pendientes o haciendolos shelve.
  6281. --override Ignoran los ficheros cambiados fuera del control de
  6282. Unity VCS. Su contenido se sobrescribirá con el
  6283. contenido del servidor.
  6284. --recursewk Actualiza todos los espacios de trabajo de la ruta
  6285. actual. Esto es útil para actualizar todos los
  6286. espacios de trabajo contenidos en la ruta indicada.
  6287. --skipchangedcheck Comprueba si hay cambios locales en el workspace
  6288. antes de actualizar. Esta opción es útil para
  6289. acelerar la actualización cuando siempre se
  6290. desprotegen (checkout) ficheros antes de
  6291. modificarlos.
  6292. --silent Solo se imprimen mensajes en caso de error.
  6293. --verbose Muestra información adicional.
  6294. --xml Imprime el resultado en formato XML a la salida
  6295. estándar. También es posible especificar un fichero
  6296. de salida.
  6297. --encoding Usado con la opción --xml, especifica el encoding
  6298. que se usará en la salida XML, por ejemplo, utf-8.
  6299. Consulte la documentación de MSDN en
  6300. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  6301. para obtener la tabla de codificaciones soportadas y
  6302. su formato (al final de la página en la columna "Name").
  6303. --machinereadable Muestra el resultado en un formato fácil de parsear.
  6304. --startlineseparator Usado con '--machinereadable', indica cómo deben
  6305. empezar las líneas del resultado.
  6306. --endlineseparator Usado con '--machinereadable', indica cómo deben
  6307. terminar las líneas del resultado.
  6308. --fieldseparator Usado con '--machinereadable', indica cómo deben
  6309. separarse los campos de cada línea resultante.
  6310. --forcedetailedprogress Fuerza mostrar el progreso detallado incluso cuando
  6311. se redirige la salida estándar.
  6312. == CMD_HELP_UPDATE ==
  6313. Notas:
  6314. El comando 'update' solo descarga los ficheros necesarios.
  6315. El comando asume recursividad.
  6316. Cuando se especifica la opción --last, no es necesario especificar una ruta.
  6317. En ese caso, el espacio de trabajo del directorio actual se actualizará.
  6318. (Especificar la opción --last puede hacer que el selector del espacio de
  6319. trabajo cambie a un configuración de rama si previamente apuntaba a un
  6320. changeset o una etiqueta.)
  6321. Ejemplos:
  6322. cm update
  6323. (Actualiza el espacio de trabajo actual.)
  6324. cm update .
  6325. (Actualiza recursivamente el contenido del directorio actual.)
  6326. cm update . --forced --verbose
  6327. (Fuerza la actualización de todas las revisiones y muestra información
  6328. adicional.)
  6329. cm update --last
  6330. cm update . --machinereadable --startlineseparator=">"
  6331. (Actualiza recursivamente el directorio actual y muestra por pantalla el
  6332. resultado en un formato simple y fácil de parsear, comenzando cada línea con
  6333. el separador indicado.)
  6334. == CMD_DESCRIPTION_VERSION ==
  6335. Muestra el número de versión del cliente.
  6336. == CMD_USAGE_VERSION ==
  6337. Sintaxis:
  6338. cm version
  6339. == CMD_HELP_VERSION ==
  6340. == CMD_DESCRIPTION_WHOAMI ==
  6341. Muestra el usuario actual de Unity VCS.
  6342. == CMD_USAGE_WHOAMI ==
  6343. Sintaxis:
  6344. cm whoami
  6345. == CMD_HELP_WHOAMI ==
  6346. == CMD_USAGE_WKTREENODESTATUS ==
  6347. Uso:
  6348. cm wktreenodestatus path1, path2, ...
  6349. == CMD_DESCRIPTION_WORKSPACE ==
  6350. Use este comando para administrar workspaces.
  6351. == CMD_USAGE_WORKSPACE ==
  6352. Sintaxis:
  6353. cm workspace | wk comando [options]
  6354. Comandos:
  6355. list | ls
  6356. create | mk
  6357. delete | rm
  6358. move | mv
  6359. rename
  6360. Para obtener más información sobre cada comando:
  6361. cm workspace comando --usage
  6362. cm workspace comando --help
  6363. == CMD_HELP_WORKSPACE ==
  6364. Ejemplos:
  6365. cm workspace create myWorkspace wk_path
  6366. cm workspace list
  6367. cm workspace delete myWorkspace
  6368. == CMD_DESCRIPTION_WORKSPACE_CREATE ==
  6369. Crea un nuevo workspace.
  6370. == CMD_USAGE_WORKSPACE_CREATE ==
  6371. Sintaxis:
  6372. cm workspace | wk [create | mk] <rep_spec>
  6373. [create | mk] <nombre> <ruta> [<rep_spec>]
  6374. [create | mk] <nombre> <ruta> [--selector[=<fichero_selector>]
  6375. (Crea un nuevo workspace.)
  6376. cm workspace | wk [create | mk] <nombre> <ruta> --dynamic --tree=[<tree>]
  6377. (Crea un workspace dinámico. Esta característica es experimental,
  6378. y solamente se encuentra disponible en Windows.)
  6379. nombre Nombre del nuevo workspace.
  6380. ruta Ruta de acceso del workspace.
  6381. rep_spec Crea el nuevo workspace con el repositorio especificado.
  6382. Use 'cm help objectspec' para obtener más
  6383. información sobre especificaciones de repositorios.
  6384. Opciones:
  6385. --selector Edita el selector para el nuevo workspace.
  6386. Si se especifica selector-file, entonces el selector
  6387. para el nuevo workspace se fiha desde el fichero
  6388. especificado.
  6389. --dynamic Crea un workspace dinámico. Esta funcionalidad es
  6390. todavía experimental, y solo está disponible para
  6391. Windows. Si se usa esta opción, es obligatorio usar el
  6392. parámetro --tree.
  6393. --tree Especifica el punto inicial al que apuntará el
  6394. workspace dinámico. Puede ser una especificación de
  6395. rama, changeset o etiqueta. El workspace continuará
  6396. usando el repositorio de la especificación. Use
  6397. 'cm help objectspec' para obtener más información sobre
  6398. la especificación.
  6399. == CMD_HELP_WORKSPACE_CREATE ==
  6400. Notas:
  6401. - Un workspace es una vista del repositorio mapeado en el sistema de
  6402. ficheros local, en un directorio especificado. Utilice los comandos
  6403. 'cm showselector' y 'cm setselector' para ver y modificar el selector.
  6404. - Si no se especifica rep_spec ni --selector, el workspace cargará
  6405. automáticamente el contenido del primer repositorio (alfabéticamente) del
  6406. servidor configurado en el fichero de configuración client.conf
  6407. - Los workspaces dinámicos son una funcionalidad experimental (sólo Windows),
  6408. y requiere que el programa plasticfs.exe se esté ejecutando en segundo
  6409. plano.
  6410. Ejemplos:
  6411. cm workspace create mycode
  6412. cm wk mk mycode
  6413. (Crea un workspace llamado 'mycode' apuntando al repositorio del mismo nombre.
  6414. El directorio del workspace se creará bajo el directorio actual.)
  6415. cm wk mk mycode@localhost:8084
  6416. cm wk mk mycode@myorganization@cloud
  6417. (Crea un workspace llamado 'mycode' igual que antes, pero es posible especificar
  6418. un servidor de repositorios diferente.)
  6419. cm workspace create myworkspace c:\workspace
  6420. cm wk mk myworkspace /home/john/wkspace
  6421. (Crea el workspace 'myworkspace' en 'c:\workspace' y '/home/john/wkspace'
  6422. respectivamente.)
  6423. cm wk mywktest c:\wks\wktest --selector=myselector.txt
  6424. (Crea 'mywktest' utilizando como selector 'myselector.txt'.)
  6425. cm wk mywkprj c:\wks\wkprj myrep@repserver:localhost:8084
  6426. (Crea 'mywkprj' en 'c:\wks\wkprj' con el repositorio seleccionado.)
  6427. cm wk mywkprj c:\dynwks\mywkprj --dynamic --tree=br:/main@myrep@localhost:8084
  6428. (Crea el workspace dinámico 'mywkprj' en 'c:\dynwks\mywkprj' con el
  6429. repositorio 'myrep@localhost:8084', apuntando a la rama '/main' la primera
  6430. vez que se monte.)
  6431. == CMD_DESCRIPTION_WORKSPACE_DELETE ==
  6432. Borra un workspace.
  6433. == CMD_USAGE_WORKSPACE_DELETE ==
  6434. Sintaxis:
  6435. cm workspace | wk delete | rm [ruta | wkspec] [--keepmetadata]
  6436. ruta Ruta del workspace.
  6437. wkspec Especificación del workspace a borrar.
  6438. Use 'cm help objectspec' para obtener más información sobre la
  6439. especificación de espacios de trabajo.
  6440. Opciones:
  6441. --keepmetadata: No elimina los archivos de metadatos del directorio
  6442. .plastic.
  6443. == CMD_HELP_WORKSPACE_DELETE ==
  6444. Notas:
  6445. Si no se especifican parámetros, se borrará el workspace actual.
  6446. Ejemplos:
  6447. cm workspace delete
  6448. (Elimina el workspace actual)
  6449. cm wk delete c:\workspace
  6450. cm workspace rm /home/danipen/wks
  6451. cm wk rm wk:MiWorkspace
  6452. cm wk rm wk:MiWorkspace@DIGITALIS
  6453. == CMD_DESCRIPTION_WORKSPACE_LIST ==
  6454. Muestra la lista de workspaces.
  6455. == CMD_USAGE_WORKSPACE_LIST ==
  6456. Sintaxis:
  6457. cm workspace | wk [list | ls] [--format=str_format]
  6458. Opciones:
  6459. --format Devuelve el mensaje de respuesta con el formato
  6460. especificado. Consulte la ayuda para más información.
  6461. == CMD_HELP_WORKSPACE_LIST ==
  6462. Notas:
  6463. Este comando acepta una cadena de texto formateada para mostrar la
  6464. salida.
  6465. Los parámetros de salida del comando son los siguientes:
  6466. {0} | {wkname} Nombre del workspace.
  6467. {1} | {machine} Nombre de la máquina.
  6468. {2} | {path} Ruta del workspace.
  6469. {3} | {wkid} Identificador único del workspace.
  6470. {4} | {wkspec} Especificación del workspace en el formato:
  6471. 'wkname@machine'.
  6472. {tab} Inserta un tabulador.
  6473. {newline} Inserta una nueva línea.
  6474. Ejemplos:
  6475. cm wk
  6476. (Lista todos los workspaces.)
  6477. cm workspace list --format={0}#{3,40}
  6478. cm workspace list --format={wkname}#{wkid,40}
  6479. (Lista todos los workspaces mostrando el nombre del workspaces, el
  6480. símbolo '#' y el identificador del workspace utilizando 40 espacios y
  6481. alineado a la izquierda.)
  6482. cm wk --format="Workspace {0} in path {2}"
  6483. cm wk --format="Workspace {wkname} in path {path}"
  6484. (Lista todos los workspaces, mostrando los resultados en cadenas
  6485. formateadas.)
  6486. == CMD_DESCRIPTION_WORKSPACE_MOVE ==
  6487. Mueve un workspace.
  6488. == CMD_USAGE_WORKSPACE_MOVE ==
  6489. Sintaxis:
  6490. cm workspace | wk move | mv [wkspec] ruta
  6491. Opciones:
  6492. wkspec Especificación del workspace a ser movido.
  6493. Use 'cm help objectspec' para obtener más información sobre la
  6494. especificación de espacios de trabajo.
  6495. ruta La ruta destino a la que mover el workspace.
  6496. == CMD_HELP_WORKSPACE_MOVE ==
  6497. Notas:
  6498. Este comando permite al usuario mover workspace a otro lugar en disco.
  6499. Ejemplos:
  6500. cm workspace move myWorkspace \new\workspaceDirectory
  6501. (Mueve el workspace a la ruta especificada.)
  6502. cm wk mv C:\wkspaces\newpath
  6503. (Mueve el workspace de trabajo a 'C:\wkspaces\newpath')
  6504. == CMD_DESCRIPTION_WORKSPACE_RENAME ==
  6505. Cambia el nombre de un workspace.
  6506. == CMD_USAGE_WORKSPACE_RENAME ==
  6507. Sintaxis:
  6508. cm workspace | wk rename [nombre_antiguo] nombre_nuevo
  6509. nombre_antiguo Nombre antiguo del workspace.
  6510. nombre_nuevo Nombre nuevo del workspace.
  6511. == CMD_HELP_WORKSPACE_RENAME ==
  6512. Notas:
  6513. Este comando renombra un workspace. Si no se especifica nombre_antiguo,
  6514. el sistema tomará el nombre del workspace actual.
  6515. Ejemplos:
  6516. cm workspace rename miworkspace wk2
  6517. (El workspace 'miworkspace' se renombra a 'wk2'.)
  6518. cm wk rename nuevoNombre
  6519. (El workspace actual se renombra a 'nuevoNombre'.)
  6520. == CMD_DESCRIPTION_WORKSPACESTATUS ==
  6521. Muestra el changeset cargado en un workspace y si los hay los elementos cambios que contiene.
  6522. == CMD_USAGE_WORKSPACESTATUS ==
  6523. Sintaxis:
  6524. cm status [workspacepath] [opciones] [tipos_de_búsqueda]
  6525. workspacepath: El path de un workspace determinado o una ruta por debajo
  6526. del mismo. La búsqueda de cambiados se realizará a partir del path
  6527. especificado y de manera recursiva.
  6528. Opciones generales:
  6529. --changelist=NAME: Muestra los cambios en el 'changelist' llamado "NAME".
  6530. --changelists: Muestra los cambios agrupados en 'changelists'.
  6531. --cutignored: Evita mostrar los contenidos de los directorios ignorados.
  6532. Requiere el tipo de búsqueda --ignored.
  6533. --header: Solo imprimirá la información del changeset cargado en el
  6534. workspace, no realizará la búsqueda de elementos cambiados.
  6535. --noheader: El comando no imprimirá el estado del workspace, sólo
  6536. realizará e imprimirá la búsqueda de elementos cambiados.
  6537. --nomergesinfo: La información de los merges de los cambios no se imprimirá.
  6538. --head: El comando imprimirá el estado del último changeset de la rama.
  6539. --short: Muestra únicamente rutas de elementos que tienen cambios.
  6540. --symlink: Aplica la operación a los enlaces simbólicos en lugar de
  6541. aplicarla a sus destinos.
  6542. --dirwithchanges: Muestra directorios que contienen cambios (ítems
  6543. añadidos, movidos o eliminados en su interior).
  6544. --xml: Permite volcar la salida del comando en formato xml. Por defecto la
  6545. salida sale en la pantalla, pero si se especifica un fichero
  6546. (--xml=output.xml) la salida se vuelca en dicho fichero.
  6547. --pretty: Imprime los cambios del workspace en formato de tabla.
  6548. --encoding: si se utiliza con la opción --xml, permite especificar el
  6549. encoding con el que se guardará la salida del comando. Consulte la
  6550. documentación de la MSDN para obtener la tabla completa de
  6551. codificaciones soportadas y su formato; al final de la página en la
  6552. columna "Name":
  6553. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  6554. --wkrootrelativepaths, --wrp: Muestra rutas relativas a la raíz del
  6555. workspace en vez de rutas relativas al directorio actual.
  6556. --fullpaths, --fp: Fuerza al comando a imprimir rutas absolutas,
  6557. sobreescribiendo cualquier otra configuración acerca de impresión
  6558. de rutas.
  6559. --iscochanged: Incluye información sobre si el contenido de un fichero en
  6560. checkout ha sido o modificado o no. Esta opción sólo está disponible en
  6561. combinación con las opciones "--compact", "--xml" y
  6562. "--machinereadable".
  6563. Si no se especifica la opción "--iscochanged", las opciones
  6564. "--compact", "--xml" o "--machinereadable" sólamente mostrarán el
  6565. estado "CO" para un fichero en checkout cuyo contenido ha cambiado.
  6566. Si se especifica la opción "--iscochanged", las opciones "--compact",
  6567. "--xml" o "--machinereadable" mostrarán el estado "CO+CH" para un
  6568. fichero en checkout cuyo contenido ha cambiado.
  6569. Opciones del viejo formato:
  6570. --cset: El comando imprimirá el estado del workspace en el viejo formato.
  6571. --compact: El comando imprimirá el estado del workspace y la búsqueda de
  6572. elementos cambiados en el viejo formato.
  6573. --noheaders: Usado junto con --compact, la información de cada grupo de
  6574. cambiós no se imprimirá. (No aplica al nuevo formato.)
  6575. Tipos de búsqueda:
  6576. --added: El comando busca elementos añadidos.
  6577. --checkout: El comando busca elementos en checkout.
  6578. --changed: El comando busca elementos cambiados.
  6579. --copied: El comando busca elementos copiados.
  6580. --replaced: El comando busca elementos reemplazados.
  6581. --deleted: El comando busca elementos borrados.
  6582. --localdeleted: El comando busca elementos borrados localmente.
  6583. --moved: El comando busca elementos movidos.
  6584. --localmoved: El comando busca elementos movidos localmente.
  6585. --percentofsimilarity (-p)=valor: Porcentaje de similitud entre dos
  6586. ficheros para considerarlos el mismo en la búsqueda de movidos
  6587. locales, su valor por defecto es un 20%.
  6588. --txtsameext: Sólo aquellos ficheros de texto que tengan la misma
  6589. extensión serán tenidos en cuenta para la búsqueda de movidos basada
  6590. en la similitud del contenido. Por defecto todos los ficheros de texto
  6591. son procesados.
  6592. --binanyext: Cualquier fichero binario es tenido en cuenta para la
  6593. búsqueda de movidos basada en la similitud del contenido. Por defecto
  6594. sólo aquellos ficheros binarios que tengan la misma extensión
  6595. son procesados.
  6596. --private: El comando busca elementos no controlados.
  6597. --ignored: El comando busca elementos ignorados.
  6598. --hiddenchanged: El comando busca elementos cambiados marcados como
  6599. ocultos (incluye '--changed').
  6600. --cloaked: El comando busca elementos marcados como cloaked.
  6601. --controlledchanged: Este modificador engloba los siguientes parámetros:
  6602. '--added' '--checkout' '--copied' '--replaced' '--deleted' '--moved'.
  6603. --all (-a): Este modificador engloba los siguientes parámetros:
  6604. '--controlledchanged' '--changed' '--localdeleted' '--localmoved'
  6605. '--private'.
  6606. == CMD_HELP_WORKSPACESTATUS ==
  6607. Notas:
  6608. El comando status muestra el changeset cargado en un workspace
  6609. y si los hay, los cambios que contiene.
  6610. Se puede utilizar el comando para saber cuál es el changeset con el que se
  6611. está trabajando en un momento dado, y poder utilizarlo, por ejemplo, para
  6612. marcar configuraciones concretas mediante etiquetas de tipo changeset.
  6613. También es útil para conocer los cambios pendientes que existen dentro
  6614. del workspace, los tipos de cambios que deseamos obtener del workspace pueden
  6615. ser modificados gracias a los parámetros que el comando admite. Por defecto
  6616. se muestran todos los cambios, controlados y locales.
  6617. El porcentaje de similitud entre dos ficheros usado por el algoritmo de
  6618. cálculo de movidos locales se puede especicifar mediante la option '--percentofsimilarity'
  6619. o '-p' y su rango va desde 0 hasta 100. Si este parámetro no es especidicado
  6620. su valor por por defecto es del 20%.
  6621. A través de éste comando, también es posible mostrar los cambios agrupados
  6622. en 'changelists' de cliente. El changelist por defecto del sistema (llamado
  6623. 'default'), agrupa los cambios que no están contenidos en el resto de
  6624. 'changelists', por lo que los cambios que se muestran especificando éste
  6625. 'changelist', dependerán del tipo de búsquedas especificados en el comando.
  6626. La opción de mostrar cambios agrupados en 'changelists' requiere mostrar cambios
  6627. controlados (en estado 'added', 'checkout', 'copied', 'replaced', 'deleted' o
  6628. 'moved'), por lo que la opción '--controlledchanged' se activará automáticamente
  6629. cuando se muestren 'changelists'.
  6630. El formato por defecto para la salida en XML es UTF-8. Es posible cambiar
  6631. dicho encoding usando la opción --encoding=otro_encoding.
  6632. El comando 'status' imprime por defecto rutas relativas al directorio de trabajo,
  6633. a menos que se especifiquen las opciones '--machinereadable' o '--short'
  6634. (en cuyo caso, se imprimen rutas absolutas).
  6635. Si se usa la opción '--xml', el comando 'status' imprimirá por defecto rutas
  6636. relativas a la raíz del workspace, a menos que se especifique adicionalmente
  6637. la opción '--fp' (en cuyo caso, se imprimen rutas absolutas).
  6638. Ejemplos:
  6639. cm status
  6640. (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
  6641. y los elementos en checkout, añadidos, copiados, reemplazados, borrados, borrados locales,
  6642. movidos, movidos locales, y privados. La busqueda de los elementos se realiza
  6643. sobre el workspace de forma recursiva)
  6644. cm status --controlledchanged
  6645. (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
  6646. y los elementos del workspace en checkout, añadidos, copiados, reemplazados,
  6647. borrados, y movidos)
  6648. cm status --added
  6649. (Ejecutándolo dentro de workspace el comando imprime el changeset cargado
  6650. y solamente los elementos añadidos. La búsqueda de los elementos se realiza
  6651. sobre el workspace de forma recursiva)
  6652. cm status c:\workspaceLocation\code\client --added
  6653. (El comando imprime el changeset cargado y solamente los elementos añadidos.
  6654. La búsqueda de los elementos se realiza sobre el path proporcionado de forma recursiva)
  6655. cm status --changelists
  6656. cm status --changelist
  6657. (El comando muestra todos los cambios en el espacio de trabajo, agrupados
  6658. por 'changelists').
  6659. cm status --changelist=pending_to_review
  6660. (El comando muestra los cambios que contiene el changelist 'pending_to_review')
  6661. cm status --changelist=default --private
  6662. (El comando muestra los cambios que contiene el changelist 'default',
  6663. el changelist por defecto del sistema, mostrando elementos privados,
  6664. además de elementos con cambios controlados si los hubiese).
  6665. cm status --short --changelist=pending_to_review | cm checkin -
  6666. (Se protegen los cambios en el changelist llamado 'pending_to_review').
  6667. cm status c:\workspaceLocation\code\client --xml=output.xml
  6668. (Guarda la salida del status en el fichero output.xml, en formato XML y
  6669. usando UTF-8.)
  6670. cm status --ignored
  6671. (Muestra todos los elementos ignorados)
  6672. Salida:
  6673. IG src
  6674. IG src/version.c
  6675. IG out/app.exe
  6676. cm status --ignored --cutignored
  6677. (Muestra ficheros ignorados cuyo directorio padre no está ignorado y
  6678. directorios ignorados pero no el árbol de sus contenidos)
  6679. Salida:
  6680. IG src
  6681. IG out/app.exe
  6682. == CMD_DESCRIPTION_XLINK ==
  6683. Crea, edita o muestra un xlink
  6684. == CMD_USAGE_XLINK ==
  6685. Sintaxis:
  6686. cm xlink [-w] [-rs] xlink_path / <csetspec | lbspec | brspec> [<expansion_rules>+]
  6687. (Crea un xlink).
  6688. cm xlink [-rs] xlink_path /relative_path <csetspec | lbspec | brspec> [<expansion_rules>+]
  6689. (Crea un xlink parcial de solo lectura apuntando a /relative_path en lugar
  6690. de apuntar a la raíz por defecto / ).
  6691. cm xlink -e xlink_path <csetspec | lbspec | brspec>
  6692. (Edita un xlink para cambiar la especificación destino).
  6693. cm xlink -s|--show xlink_path
  6694. (Muestra la información de un xlink incluyendo las reglas de expansión).
  6695. cm xlink -ar|--addrules xlink_path <expansion_rules>+
  6696. (Añade al xlink las reglas de expansión proporcionadas).
  6697. cm xlink -dr|--deleterules xlink_path <expansion_rules>+
  6698. (Borra del xlink las reglas de expansión especificadas).
  6699. xlink_path Ruta en el espacio de trabajo actual donde se cargan
  6700. los contenidos del repositorio que se va a enlazar
  6701. (cuando se crea un xlink) o que ya está enlazado
  6702. (cuando se edita un xlink).
  6703. csetspec Especificación del changeset que se va a enlazar.
  6704. Determina qué versión y rama se carga en el espacio de
  6705. trabajo para el repositorio enlazado.
  6706. Usa 'cm help objectspec' para obtener más información
  6707. sobre la especificación de changesets.
  6708. lbspec Especificación de la etiqueta que se va a enlazar.
  6709. Usa 'cm help objectspec' para obtener más información
  6710. sobre la especificación de etiquetas.
  6711. brspec Especificación de la rama que se va a enlazar.
  6712. Usa el changeset actual a donde la rama especificada
  6713. está apuntando.
  6714. Usa 'cm help objectspec' para obtener más información
  6715. sobre la especificación de ramas.
  6716. -e Indica que el comando va a editar un xlink existente
  6717. para cambiar la especificación del changeset enlazado.
  6718. -s | --show Muestra información sobre el xlink seleccionado.
  6719. -ar | --addrules Añade una o más reglas de expansión al xlink indicado.
  6720. -dr | --deleterules Borra una o más reglas de expansión del xlink indicado.
  6721. expansion_rules Especifica una o más reglas de expansión. Cada regla de
  6722. expansión es un par (rama)-(rama a enlazar)
  6723. br:/main/fix-br:/main/develop/fix
  6724. Opciones:
  6725. -w Crea un xlink de escritura. Esto significa que los
  6726. contenidos bajo el xlink se podrán editar mediante el
  6727. uso de autoexpansión de ramas.
  6728. -rs Relative server. Permite crear un xlink a un repositorio
  6729. que es una réplica de otro que existe en un servidor
  6730. central. De este modo se reconcilian automáticamente los
  6731. repositorios replicados con el original.
  6732. Ejemplos:
  6733. cm xlink codigo\segundorepositorio / 1@segundo@localhost:8084
  6734. cm xlink codigo\segundorepositorio / lb:LB001@segundo@localhost:8084
  6735. cm xlink -s codigo\segundorepositorio
  6736. cm xlink -ar codigo\segundorepositorio br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
  6737. cm xlink -dr codigo\segundorepositorio br:/main/fix-br:/main/develop/fix
  6738. == CMD_HELP_XLINK ==
  6739. Notas:
  6740. Este comando crea un xlink al changeset especificado. Por defecto se
  6741. creará como un xlink de sólo lectura. Esto significa que los contenidos
  6742. correspondientes a otro repositorio cargados por debajo del xlink no
  6743. podrán ser modificados.
  6744. Para la edición del changeset de un xlink se puede utilizar una sintaxis
  6745. reducida en la que no hay que especificar el resto de parámetros del
  6746. xlink. Solamente es necesario en nuevo changeset al que apuntará.
  6747. Auto-expansión de ramas:
  6748. Cuando se realiza un cambio en uno de los repositorios enlazados en modo
  6749. de lectura y escritura (opción -e) es necesario crear una nueva rama en
  6750. dicho repositorio basándose en la rama en la que se está trabajando en el
  6751. repositorio principal. Para determinar el nombre de dicha rama, se aplican
  6752. las siguientes reglas:
  6753. 1) Se comprueba si el nombre completo de la rama existe en el
  6754. repositorio enlazado:
  6755. - Si existe, se utiliza dicha rama.
  6756. - Si no existe, Unity VCS construye el nombre de la rama de esta forma:
  6757. - Nombre de la rama que contiene el changeset enlazado + nombre
  6758. de la rama del repositorio principal.
  6759. - Si existe una rama con dicho nombre, se utiliza como rama de
  6760. trabajo.
  6761. - Si no, se crea una rama nueva con el nombre así construido y
  6762. se establece como base de la rama el changeset enlazado.
  6763. 2) Después, se crea una nueva versión del xlink dentro de la nueva rama
  6764. apuntando al nuevo changeset.
  6765. De este modo, la estructura completa del xlink se mantiene actualizada con
  6766. los últimos cambios en las versiones correctas.
  6767. Ejemplos:
  6768. cm xlink code\firstrepo / 1@first@localhost:8084
  6769. (Crea un xlink en la carpeta 'firstrepo' en el espacio de trabajo actual
  6770. donde el changeset '1' en el repositorio 'first' se enlazará).
  6771. cm xlink opengl\include /includes/opengl 1627@includes@localhost:8087
  6772. (Crea un xlink parcial de solo lectura en la ruta 'opengl\include' en el
  6773. espacio de trabajo actual donde la ruta '/includes/opengl' en el changeset
  6774. '1627' del repositorio 'includes' se enlazará como raíz. Esto significa
  6775. que cualquier ítem dentro de '/includes/opengl' se enlazará en
  6776. 'opengl\include' mientras que el resto del repositorio se ignorará).
  6777. cm xlink -w -rs code\secondrepo / lb:LB001@second@localhost:8084
  6778. (Crea un xlink de escritura y relativo en la ruta 'secondrepo' en el
  6779. espacio de trabajo actual donde la etiqueta'LB001' en el repositorio
  6780. 'second' se enlazará).
  6781. cm xlink code\thirdrepo / 3@third@localhost:8087 br:/main-br:/main/scm003
  6782. (Crea un xlink en la ruta 'thirdrepo' dentro del espacio de trabajo actual
  6783. donde el changeset '3' en el repositorio 'third' se enlazará).
  6784. cm xlink -e code\secondrepo br:/main/task1234@second@localhost:8084
  6785. (Edita el xlink 'code\secondrepo' para cambiar el repositorio destino
  6786. enlazando la rama 'main/task1234' en el repositorio 'second').
  6787. cm xlink --show code\thirdrepo
  6788. (Muestra información del xlink 'code\thirdrepo' incluyendo las reglas de
  6789. expansión si éstas existen).
  6790. cm xlink -ar code\secondrepo br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
  6791. (Añade dos reglas de expansión al xlink 'code\secondrepo').
  6792. cm xlink -dr code\secondrepo br:/main/fix-br:/main/develop/fix
  6793. (Borra la regla de expansión del xlink 'code\secondrepo').
  6794. cm xlink code\secondrepo / 1@second@localhost:8084
  6795. cm xlink code\secondrepo / lb:LB001@second@localhost:8084
  6796. == CMD_USAGE_AUTOCOMPLETE ==
  6797. Sintaxis:
  6798. cm autocomplete install
  6799. Instala el autocompletado de comandos para 'cm' en la shell.
  6800. cm autocomplete uninstall
  6801. Desinstala el autocompletado de comandos para 'cm' de la shell.
  6802. cm autocomplete --line <shell_line> --position <cursor_position>
  6803. Devuelve sugerencias de autocompletado para 'shell_line', que deben ser
  6804. insertadas en 'cursor_position'. Este comando no está pensado para ser
  6805. ejecutado por el usuario final, pero está documentado en caso de que se
  6806. quiera extender el soporte de autocompletado a otras shells.
  6807. shell_line La linea que el usuario ha escrito en la shell cuando se
  6808. pidió el autocompletado.
  6809. En Bash, encuentra en la variable de entorno COMP_LINE.
  6810. En PowerShell, se encuentra en la variable $wordToComplete.
  6811. cursor_position La posición del cursor cuando se pidió el autocompletado.
  6812. En Bash, se encuentra en la variable de entorno COMP_POINT.
  6813. En PowerShell, se encuentra en la variable $cursorPoint.
  6814. == CMD_DESCRIPTION_API ==
  6815. Arranca un servidor HTTP local que escucha peticiones de REST API.
  6816. == CMD_USAGE_API ==
  6817. Sintaxis:
  6818. cm api [(-p|--port)=<portnumber>] [(-r|--remote)]
  6819. Opciones:
  6820. -p | --port Pide al servidor escuchar en el puerto <portnumber>
  6821. en lugar del 9090.
  6822. -r | --remote Permite conexiones entrantes remotas, es decir,
  6823. aquellas que provienen de otras máquinas en vez de
  6824. la local.
  6825. == CMD_HELP_API ==
  6826. Notas:
  6827. El comando 'cm api' permite a los programadores realizar operaciones Unity VCS
  6828. de cliente en sus máquinas.
  6829. Lea la Guía de Unity VCS API para más información:
  6830. https://www.plasticscm.com/documentation/restapi/plastic-scm-version-control-rest-api-guide
  6831. Por defecto, la API escucha solamente conexiones locales en el puerto 9090.
  6832. Para detener el servidor, presione la tecla Enter.
  6833. Ejemplos:
  6834. cm api
  6835. (Arranca la API en el puerto 9090; únicamente conexiones locales.)
  6836. cm api -r
  6837. (Arranca la API en el puerto 9090; permite cualquier conexión entrante.)
  6838. cm api --port=15000 -r
  6839. (Arranca la API en el puerto 15000; permite cualquier conexión entrante.)
  6840. == CMD_DESCRIPTION_CONFIGURECLIENT ==
  6841. Configura el cliente de Unity VCS y especificar un servidor por defecto para el usuario actual.
  6842. == CMD_USAGE_CONFIGURECLIENT ==
  6843. Sintaxis:
  6844. cm configure [--language=<idioma> --workingmode=<modo> [AuthParameters]
  6845. --server=<servidor> [--port=<puerto>]] [--clientconf=<ruta_clientconf>]
  6846. --language Idiomas disponibles:
  6847. en (English)
  6848. es (Spanish)
  6849. --workingmode Modos de seguridad/usuarios disponibles:
  6850. NameWorkingMode (Name)
  6851. NameIDWorkingMode (Name + ID)
  6852. LDAPWorkingMode (LDAP)
  6853. ADWorkingMode (Active Directory)
  6854. UPWorkingMode (User and password)
  6855. SSOWorkingMode (Single Sign On)
  6856. AuthParameters Parámetros de autenticación (solo para modos LDAPWorkingMode y UPWorkingMode):
  6857. --user=<usuario>
  6858. --password=<contraseña>
  6859. Parámetros de Single Sign On (solo para modos SSOWorkingMode):
  6860. --user=<usuario>
  6861. --token=<token>
  6862. --server Nombre/dirección IP del servidor de Unity VCS
  6863. --port Puerto del servidor de Unity VCS
  6864. (el puerto es opcional para servidores de Cloud)
  6865. --clientconf Ruta del fichero de configuración a crear (opcional)
  6866. Este argumento puede ser una ruta completa, un nombre de fichero o un directorio.
  6867. Si no se especifica este parámetro, el directorio por defecto para el fichero
  6868. de configuración 'client.conf' será:
  6869. * '%LocalAppData%\plastic4' en Windows
  6870. * '$HOME/.plastic4' en linux/macOS
  6871. Ejemplos:
  6872. --clientconf=c:/path/to/myclient.conf
  6873. (La ruta especificada se utilizará para crear el fichero de configuración del cliente)
  6874. --clientconf=myclient.conf
  6875. (Se utilizará el fichero 'myclient.conf' dentro del directorio de configuración por defecto)
  6876. --clientconf=c:/exisitingDirectory
  6877. (Se utilizará el nombre de fichero por defecto, client.conf, en el directorio especificado)
  6878. == CMD_HELP_CONFIGURECLIENT ==
  6879. Notas:
  6880. El comando 'cm configure' no podrá ser usado en las versiones Cloud Edition o DVCS Edition de Unity VCS.
  6881. Use de forma alternativa la aplicación 'plastic --configure'.
  6882. Ejemplos:
  6883. cm configure
  6884. (ejecuta la versión interactiva del comando de configuración del cliente de Unity VCS)
  6885. cm configure --language=en --workingmode=LDAPWorkingMode --user=jack --password=01234 \
  6886. --server=plastic.mymachine.com --port=8084
  6887. (configura el cliente de Unity VCS con los parámetros especificados, y creará el fichero
  6888. de configuración 'client.conf' en el directorio por defecto).
  6889. cm configure --language=en --workingmode=NameWorkingMode --server=plastic.mymachine.com \
  6890. --port=8084 --clientconf=clientconf_exp.conf
  6891. (configura el cliente de Unity VCS con los parámetros especificados, y creará el fichero
  6892. de configuración 'client.conf' en el directorio especificado).
  6893. == CMD_DESCRIPTION_PURGE ==
  6894. Este comando permite al usuario inspeccionar, registrar y ejecutar purgas sobre un repositorio. Las revisiones purgadas ya no son accesibles para el repositorio en cuestión, ayudando de esta manera a liberar espacio.
  6895. ADVERTENCIA: Las acciones de purga son irreversibles. Una vez son ejecutadas, ya NO podrá cargar las revisiones purgadas - ya sea cambiando su workspace o al mostrar las diferencias de una rama o changeset.
  6896. == CMD_USAGE_PURGE ==
  6897. Sintaxis:
  6898. cm purge <comandos> [opciones]
  6899. Comandos:
  6900. - register
  6901. - execute
  6902. - show
  6903. - history
  6904. - unregister
  6905. Para obtener más información sobre cada comando:
  6906. cm purge <command> --^usage
  6907. cm purge <command> --^help
  6908. == CMD_HELP_PURGE ==
  6909. Examples:
  6910. cm purge register ".mkv" "1955-Nov-05 6:00 AM" --repository=timemachine
  6911. (registra una acción de purga para el repositorio 'timemachine')
  6912. cm purge history
  6913. (enumera el GUID y el statu de todas las acciones de purga registradas
  6914. anteriormente en el servidor)
  6915. cm purge show 545ec81b-23ea-462c-91f4-d7c62a6e8817 --verbose
  6916. (muestra en detalle los metadatos de la acción de purga dado su ID,
  6917. incluyendo los elementos y revisiones afectados por la purga)
  6918. cm purge execute 545ec81b-23ea-462c-91f4-d7c62a6e8817
  6919. (inicia una acción de purga previamente registrada)
  6920. cm purge unregister 545ec81b-23ea-462c-91f4-d7c62a6e8817
  6921. (las purgas que no hayan sido ejecutadas pueden eliminarse del registro)
  6922. == CMD_DESCRIPTION_PURGE_REGISTER ==
  6923. Calcula y registra una acción de purga. Se considerarán candidatas para la purga aquellas revisiones anteriores a la(s) fecha(s) seleccionadas durante el registro. Como regla, siempre preservamos revisiones etiquetadas así como al menos una revisión en todas las cabezas de rama. Puede utilizar el comando "cm purge show" para verificar las revisiones seleccionadas antes de ejecutar la purga mediante el comando "cm purge execute".
  6924. == CMD_USAGE_PURGE_REGISTER ==
  6925. Sintaxis:
  6926. cm purge register (<extension> <before_date>)... [--repository=<rep_spec>]
  6927. Opciones:
  6928. --repository El repositorio donde se pretende aplicar la purga.
  6929. No es necesario bajo de la ruta de un espacio de trabajo salvo para
  6930. elegir uno diferente.
  6931. extensión Extensión del tipo de fichero a ser purgado. Note que las revisiones de
  6932. elementos renombrados se considerarán también para su eliminación.
  6933. antes_de_fecha Sólo aquellas revisiones anteriores a esta fecha se considerarán para
  6934. su eliminación.
  6935. == CMD_HELP_PURGE_REGISTER ==
  6936. Ejemplos:
  6937. cm purge register ".mkv" "1955-Nov-05 6:00 AM"
  6938. (registra una acción de purga sobre las revisiones de ficheros Matroska creadas antes de una fecha)
  6939. cm purge register ".mkv" "6:00 AM"
  6940. (puede especificar sólamente la fecha o la hora)
  6941. cm purge register ".mkv" "6:00Z"
  6942. (puede especificar una hora UTC en vez de una hora local)
  6943. cm purge register ".mkv" "1955-Nov-05" --repository=timemachine
  6944. (puede especificar un repositorio diferente para registrar la purga)
  6945. cm purge register ".mkv" "1955-Nov-05" ".mp3" "1955-Nov-12"
  6946. (puede proporcionar varias parejas de extensión y fecha a la vez)
  6947. == CMD_DESCRIPTION_PURGE_EXECUTE ==
  6948. Ejecuta una acción de purga registrada previamente.
  6949. ADVERTENCIA: Las acciones de purga son irreversibles. Una vez son ejecutadas, ya NO podrá cargar las revisiones purgadas - ya sea cambiando su workspace o al mostrar las diferencias de una rama o changeset. Use este comando bajo su propia responsabilidad.
  6950. Asegúrese de comprobar la historia del fichero para confirmar cuáles de las revisiones/changesets no son relevantes. No dude en utilizar el comando "cm purge show" antes de ejecutar la purga para verificar que ninguna revisión inesperada esté seleccionada para su eliminación.
  6951. == CMD_USAGE_PURGE_EXECUTE ==
  6952. Sintaxis:
  6953. cm purge execute <purge_guid> [--server=<server>]
  6954. Opciones:
  6955. --server Permite especificar en que servidor se consultarán
  6956. las acciones de purga.
  6957. purge_guid El GUID devuelto por el comando "cm purge register".
  6958. == CMD_HELP_PURGE_EXECUTE ==
  6959. Ejemplos:
  6960. cm purge execute be5b9145-1bd9-4c43-bd90-f2ff727bbf13
  6961. (Ejecuta una purga dado su ID)
  6962. cm purge execute be5b9145-1bd9-4c43-bd90-f2ff727bbf13 --server=myorg@cloud
  6963. (Puede especificar un servidor concreto si así lo necesita)
  6964. == CMD_DESCRIPTION_PURGE_SHOW ==
  6965. Proporciona un informe del estado de la purga y sus contenidos.
  6966. == CMD_USAGE_PURGE_SHOW ==
  6967. Sintaxis:
  6968. cm purge show <purge_guid> [--verbose | --server=<server>]
  6969. Opciones:
  6970. --server Permite especificar en que servidor se consultarán
  6971. las acciones de purga.
  6972. --verbose Expande el informe incluyendo los elementos y
  6973. revisiones involucrados en la purga.
  6974. purge_guid El GUID devuelto por el comando "cm purge register".
  6975. == CMD_HELP_PURGE_SHOW ==
  6976. Ejemplos:
  6977. cm purge show be5b9145-1bd9-4c43-bd90-f2ff727bbf13
  6978. (Proporciona un breve informe del estado de la purga)
  6979. cm purge show be5b9145-1bd9-4c43-bd90-f2ff727bbf13 --verbose
  6980. (Proporciona información adicional por extensión purgada,
  6981. incluyendo elementos y revisiones)
  6982. cm purge show be5b9145-1bd9-4c43-bd90-f2ff727bbf13 --server=myorg@cloud
  6983. (Puede especificar un servidor diferente si así lo desea)
  6984. == CMD_DESCRIPTION_PURGE_HISTORY ==
  6985. Permite a los usuarios comprobar el estado de todas las purgas registradas en el servidor en algún momento.
  6986. También es útil para obtener algunos datos sobre ellas que se preservan para posibles consultas, tales como el autor, la fecha de ejecución o el tamaño del almacenamiento y los tipos afectados por la purga.
  6987. == CMD_USAGE_PURGE_HISTORY ==
  6988. Sintaxis:
  6989. cm purge history [--verbose | --server=<server>]
  6990. [--sort=(desc|asc)]
  6991. [--skip=<skip> | --limit=<limit>]
  6992. Opciones:
  6993. --server Permite especificar en que servidor se consultarán
  6994. las acciones de purga.
  6995. --verbose Por omisión, sólo se muestra el ID y el estado para
  6996. cada purga. Esta opción también incluye información
  6997. más detallada.
  6998. --sort Especifica un orden para las purgas mostradas en el
  6999. resultado. Este puede ser descendente (desc) o
  7000. ascendente (asc).
  7001. --skip Especifica un número de entradas a omitir que no se
  7002. verán reflejadas en el resultado.
  7003. --limit Especifica el número máximo de entradas que se
  7004. mostrarán simultáneamente.
  7005. == CMD_HELP_PURGE_HISTORY ==
  7006. Ejemplos:
  7007. cm purge history
  7008. (muestra el ID y el estado para todas las purgas registradas en el servidor)
  7009. cm purge history --server=stoltz@cloud
  7010. (puede esplicitar un servidor para usar uno diferente si así lo necesita)
  7011. cm purge history --verbose
  7012. (incluye datos más detallados asociados a las purgas mostradas)
  7013. cm purge history --sort=asc
  7014. (muestra la historia empezando por las purgas más antiguas)
  7015. cm purge history --skip=0 --limit=20
  7016. cm purge history --skip=20 --limit=20
  7017. cm purge history --skip=40 --limit=20
  7018. (en lugar de mostrar todo a la vez, puede paginar los resultados)
  7019. == CMD_DESCRIPTION_PURGE_UNREGISTER ==
  7020. Las acciones de purga puede eliminarse del registro si decide no ejecutarlas.
  7021. Recuerde que no es posible eliminar aquellas purgas que ya se hayan iniciado.
  7022. == CMD_USAGE_PURGE_UNREGISTER ==
  7023. Sintaxis:
  7024. cm purge unregister <purge_guid> [--server=<server>]
  7025. Opciones:
  7026. --server Permite especificar en que servidor se consultarán
  7027. las acciones de purga.
  7028. purge_guid El GUID devuelto por el comando "cm purge register".
  7029. == CMD_HELP_PURGE_UNREGISTER ==
  7030. Ejemplos:
  7031. cm purge unregister 545ec81b-23ea-462c-91f4-d7c62a6e8817
  7032. (las purgas que no hayan sido ejecutadas pueden eliminarse del registro)
  7033. cm purge unregister 545ec81b-23ea-462c-91f4-d7c62a6e8817 --server=myorg@cloud
  7034. (puede especificar un servidor diferente para eliminar la purga de su registro)