cm-help.es.txt 290 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677
  1. == CMD_DESCRIPTION_ACL ==
  2. Establece permisos para un usuario, en un objeto dado.
  3. == CMD_USAGE_ACL ==
  4. Sintaxis:
  5. cm acl --user=usr_name | --group=group_name <action=<+|-permission>+>+ spec_objeto
  6. --user Nombre de usuario.
  7. --group Nombre de grupo.
  8. action Acción a aplicar: permitir, denegar o sobrescribir.
  9. -allowed para habilitar permisos
  10. -denied para denegar
  11. -overrideallowed
  12. -overridedenied
  13. permission Permiso a aplicar.
  14. Usa comas para separar permisos.
  15. (Usa 'cm showpermissions' para mostrar todos los
  16. permisos disponibles.)
  17. spec_objeto Especificación del objeto sobre el que se van a fijar
  18. los permisos.
  19. Objetos válidos para este comando son:
  20. repserver, repositorio, rama, changeset, etiqueta, item
  21. y atributo.
  22. (Usa 'cm help objectspec' para obtener más información
  23. sobre especificaciones.)
  24. La especificación puede ser también una ruta segura.
  25. Consulta las Notas para obtener más información sobre
  26. las rutas seguras.
  27. Uso especial para rutas seguras:
  28. cm acl [regular options] [--delete] [--branches=comma separated list] spec
  29. (Opcionalmente, cada rama especificada en --branches se puede preceder con
  30. los signos + o - para especificar si una rama se añadirá o se eliminará de
  31. la lista cuando se edite.)
  32. == CMD_HELP_ACL ==
  33. La configuración de permisos requiere comprender cómo se gestiona la seguridad
  34. en Plastic SCM. Lee la Guía de Seguridad para aprender cómo funcionan estos
  35. permisos de seguridad:
  36. https://www.plasticscm.com/documentation/security/plastic-scm-version-control-security-guide.shtml
  37. Notas:
  38. Este comando fija permisos de usuario o grupo a los objetos, repositorios,
  39. ramas, etiquetas y/o rutas de servidor especificados.
  40. Object specs:
  41. Usa 'cm help objectspec' para aprender cómo especificar objetos.
  42. El comando acl usa un tipo especial de especificación: rutas seguras.
  43. - Especificación de rutas seguras (secured paths):
  44. path:server_path[#tag]
  45. Ejemplos: path:/src/foo.c
  46. path:/doc/pdf
  47. path:/doc/pdf#documents
  48. Acciones de permisos:
  49. Usa -allowed y -denied para especificar qué permisos aplicar.
  50. Usa los argumentos -overrideallowed y -overridedenied para especificar
  51. qué permisos se sobrescriben.
  52. Cada acción requiere una lista de permisos separados por comas.
  53. Nombres de permisos:
  54. Cada nombre de permiso debe ir precedido del símbolo + o -.
  55. El símbolo + aplica el permiso y el símbolo - lo elimina.
  56. Para ver los permisos de un objeto, usa el comando 'cm showacl'.
  57. Permisos sobrescritos:
  58. Sobrescribir un permiso usando --overrideallowed y --overridedenied te
  59. permite evitar la herencia de permisos.
  60. Esto es útil para evitar los permisos aplicados a nivel de repositorio o
  61. de servidor.
  62. Por ejemplo:
  63. cm acl --user=vio -allowed=+ci -overrideallowed=+ci br:qa@test
  64. (Permite a la usuaria 'vio' hacer checkin en la rama 'qa' del
  65. repositorio 'test' incluso si ella tiene los permisos denegados a
  66. nivel de repositorio.)
  67. Permisos de rutas de servidor (rutas seguras):
  68. - Es posible especificar permisos para una ruta de servidor dada.
  69. - Estos permisos se comprueban durante la operación de check-in.
  70. - Estos permisos también pueden ser comprobados durante la operación de
  71. update y usados para prevenir ciertos directorios y ficheros sean
  72. descargados al espacio de trabajo.
  73. - Por cada ítem que se proteja (checkin), el servidor intenta concordar
  74. la ruta del ítem con una ruta segura. Si se encuentra, entonces la
  75. operación de checkin comprueba si el ítem tiene permisos para ser
  76. protegido (checked in).
  77. Los permisos que se pueden definir para una ruta segura son:
  78. ci, change, add, move, rm, read
  79. Si la comprobación de permisos no es satisfactoria para ninguno de los
  80. ítems involucrados, entonces la operación de checkin se cancelará.
  81. Para aplicar permisos de rutas seguras a un grupo de ramas, usa la
  82. opción --branches.
  83. Por ejemplo:
  84. cm acl --user=jo -denied=+ci path:/src#rule0 --branches=main,main/rel0
  85. Para editar el ACL asociado a una ruta segura, usa el símbolo "#".
  86. Por ejemplo:
  87. cm acl --user=jo -denied=+rm path:/src#rule0
  88. (Sin "#", la lista de ramas tendría que ser especificada de nuevo).
  89. Es posible también editar la lista de ramas de una ruta segura.
  90. Por ejemplo:
  91. cm acl path:/src#rule0 --branches=-main,+main/rel1
  92. (Elimina main de la lista y añade main/rel1.)
  93. Para eliminar una ruta segura, usa el argumento --delete.
  94. Por ejemplo:
  95. cm acl --user=jo --delete path:/src#rule0
  96. Herencia:
  97. Herencia es una opción que proviene de los inicios de Plastic SCM 3.0.
  98. Es una opción avanzada, pero también está obsoleta.
  99. Permite a un objeto heredar los permisos de otro objeto, sobrescribiendo
  100. las relaciones de herencia por defecto.
  101. Usa la opción -cut para cortar la cadena de herencia.
  102. Usa la opción -cutncpy para cortar y copiar los permisos heredados.
  103. (Estas características vienen inspiradas por los permisos de sistema de
  104. Windows donde puedes cortar herencia pero mantener los permisos
  105. actuales.)
  106. La opción -inherit permiter heredar de una especificación de objeto.
  107. Por ejemplo: '-inherit=object_spec'
  108. Ejemplos:
  109. cm acl --user=danipen -denied=+ci rep:core
  110. (Deniega el permiso de checkin al usuario danipen en el repositorio 'core'.)
  111. cm acl --group=developers -allowed=+view,-read -denied=+chgperm br:main
  112. (Otorga el permiso 'view', elimina el permiso 'read' y deniega el permiso
  113. 'chgperm' al grupo 'developers' en la rama 'main'.)
  114. Ejemplos con rutas de servidor:
  115. cm acl --group=devs -denied=+ci path:/server#rel --branches=main,main/2.0
  116. (Deniega el permiso de checkin al grupo 'devs' para cualquier ruta que
  117. concuerde con '/server' en las ramas 'main' y 'main/2.0'. La etiqueta #rel
  118. se crea para poder referirse a ella más adelante.)
  119. cm acl path:/server#rel --branches=-/main,+/main/Rel2.1
  120. (Actualiza la ruta segura '/server', cuya etiqueta es 'rel', borrando la
  121. rama 'main' y añadiendo la rama 'main/Rel2.1' al grupo de ramas al que la
  122. ruta segura aplica. Teniendo en cuenta el ejemplo anterior, ahora la lista
  123. de ramas contendrá main/Rel2.1 y main/2.0)
  124. cm acl --user=vsanchezm -allowed=-read -overrideallowed=+read path:/doc
  125. (Eliminar el permiso de lectura a vsanchezm, sobrescribiéndolo, en la ruta
  126. /doc.)
  127. == CMD_DESCRIPTION_ACTIVATEUSER ==
  128. Activa un usuario de licencia desactivado previamente.
  129. == CMD_USAGE_ACTIVATEUSER ==
  130. Sintaxis:
  131. cm activateuser nombre1 nombre2 ... [opciones]
  132. nombre: Nombre del usuario que se desea activar.
  133. Opciones:
  134. --server: activa el usuario en el servidor especificado.
  135. Usa 'cm help objectspec' para saber más sobre especificaciones.
  136. == CMD_HELP_ACTIVATEUSER ==
  137. Notas:
  138. Este comando activa un usuario para que pueda utilizar Plastic SCM.
  139. Para activar un usuario, éste ha de estar desactivado previamente.
  140. Para activar un usuario por primera vez, basta con utilizar Plastic SCM
  141. con las credenciales del usuario a activar, siempre que no se sobrepase
  142. el número máximo de usuarios autorizados.
  143. Ejemplos:
  144. cm activate user juan
  145. == CMD_DESCRIPTION_ADD ==
  146. Añade un ítem al repositorio.
  147. == CMD_USAGE_ADD ==
  148. Sintaxis:
  149. cm add [options]* <ruta>+
  150. ruta Rutas de los ítems a añadir, separados por espacios.
  151. Usa comillas (") para especificar rutas que contengan
  152. espacios.
  153. Usa * para añadir todo el contenido del directorio
  154. actual.
  155. Opciones:
  156. -R|-r|--recursive Añade los ítems recursivamente.
  157. --silent No muestra ninguna salida.
  158. --ignorefailed Si un ítem no se puede añadir, la operación de add
  159. continuará sin él. Importante: si un directorio no se
  160. puede añadir, su contenido tampoco se añadirá.
  161. --skipcontentcheck Cuando la extensión no es suficiente para determinar si
  162. el fichero es de texto o binario, se asumirá que es
  163. binario en lugar de usar el contenido para detectar el
  164. tipo. Este funcionamiento se asume para aumentar el
  165. rendimiento en grandes operaciones de checkin.
  166. == CMD_HELP_ADD ==
  167. Notas:
  168. Requisitos para añadir items:
  169. - El directorio padre del ítem a añadir debe existir en el repositorio.
  170. Ejemplos:
  171. cm add file1.txt file2.txt
  172. (Añade los ítems file1.txt y file2.txt.)
  173. cm add c:\workspace\file.txt
  174. (Añade el ítem file.txt en la ruta c:\workspace.)
  175. cm add -R c:\workspace\src
  176. (Añade recursivamente el contenido de la ruta src.)
  177. cm add -R *
  178. (Añade recursivamente todo el contenido del directorio actual.)
  179. == CMD_USAGE_ADDIGNOREPATTERN ==
  180. Uso:
  181. cm addignorepattern pattern1 pattern2 ... patternN [--workspace=wkpath | --allworkspaces][--remove]
  182. == CMD_DESCRIPTION_ADMIN ==
  183. Ejecuta comandos de administración en el servidor.
  184. == CMD_USAGE_ADMIN ==
  185. Sintaxis:
  186. cm admin comando [opciones]
  187. Comandos:
  188. readonly
  189. Para obtener más información de cada uno de los comandos ejecute:
  190. cm changeset command --usage
  191. cm changeset command --help
  192. == CMD_HELP_ADMIN ==
  193. Notas:
  194. Sólo el administrador del servidor puede ejecutar el comando admin.
  195. Ejemplos:
  196. cm admin readonly enter
  197. cm admin readonly status
  198. == CMD_DESCRIPTION_ADMIN_READONLY ==
  199. Permite habilitar/deshabilitar el modo solo-lectura en el servidor.
  200. == CMD_USAGE_ADMIN_READONLY ==
  201. Sintaxis:
  202. cm admin readonly acción [servidor]
  203. Acciones:
  204. enter: habilita el modo de solo-lectura en el servidor.
  205. leave: deshabilita el modo de solo-lectura en el servidor.
  206. status: muestra el estado del modo de solo-lectura del servidor.
  207. Opciones:
  208. servidor: El comando se ejecuta en el servidor especificado
  209. (servidor:puerto; usa 'cm help objectspec' para más información.)
  210. Si no se especifica un servidor, el comando se ejecuta
  211. en servidor del espacio de trabajo actual.
  212. Si la ruta actual no está en un espacio de trabajo,
  213. se ejecuta en el servidor por defecto configurado en
  214. client.conf.
  215. == CMD_HELP_ADMIN_READONLY ==
  216. Notas:
  217. Sólo el administrador del servidor puede ejecutar el comando readonly.
  218. Ejemplos:
  219. cm admin readonly enter diana:8086
  220. cm admin readonly leave
  221. == CMD_DESCRIPTION_ANNOTATE ==
  222. Lista el contenido de un fichero o directorio, indicando para cada línea el propietario y la revisión en la cual fue introducida.
  223. == CMD_USAGE_ANNOTATE ==
  224. Sintaxis:
  225. cm annotate spec [opciones]
  226. spec Especificación del fichero que se va a anotar.
  227. Usa 'cm help objectspec' para obtener más información
  228. sobre especificaciones.
  229. Opciones:
  230. --format=cadena: Cadena con el formato de salida.
  231. --dateformat=cadena: Cadena con el formato en que se escribirán las fechas.
  232. --ignore=método_de_comparación: Cambia la forma de calcular las diferencias.
  233. --repository=repspec: Especificación del repositorio para calcular las
  234. anotaciones. Por defecto, este comando utiliza el
  235. repositorio del workspace cuya revisión está cargada.
  236. Usa 'cm help objectspec' para más información sobre las
  237. especificaciones de repositorio.
  238. método_de_comparación:
  239. none (por defecto)
  240. eol (ignora diferencias en retornos de carro)
  241. whitespaces (ignora diferencias en espacios en blanco)
  242. eol&whitespaces (las dos anteriores)
  243. == CMD_HELP_ANNOTATE ==
  244. Notas:
  245. Los items de tipo binario no están soportados por este commando.
  246. Este comando admite una cadena de formato para mostrar la salida.
  247. Los parametros de salida de este comando son los siguientes:
  248. {owner}: El propietario de la línea.
  249. {rev}: La especificación de la revision donde apareció la línea.
  250. {content}: El contenido de la línea.
  251. {date}: La fecha de la revisión donde fue introducida la línea.
  252. {comment}: El comentario de la revisión donde apareció la línea.
  253. {changeset}: El changeset de la revisión donde apareció la línea.
  254. {line}: El número de línea dentro del fichero.
  255. {branch}: La rama de la revisión donde apareció la línea.
  256. {ismergerev}: La revisión donde apareció la línea fue creada en una
  257. operación de merge.
  258. Puede usar la opción --dateformat para especificar el formato en el que se
  259. escribirán las fechas en pantalla.
  260. El commando annotate puede recuperar los datos de un repositorio remoto
  261. usando la opción --repository. Esto es útil cuando se trabaja con
  262. repositorios replicados.
  263. Ejemplos:
  264. cm ann c:\workspace\src
  265. cm ann c:\workspace\file.txt
  266. cm ann c:\workspace\file.txt --format"{owner} {date} {content}"
  267. cm ann c:\workspace\file.txt --format"{owner, -7} {content} [{date}]" \
  268. --dateformat=yyyyMMdd
  269. cm ann c:\workspace\file.txt --repository=centralRep@myserver:8084
  270. cm blame serverpath:/src/client/checkin/Checkin.cs#cs:73666
  271. (Anota el fichero empezando en el changeset 73666 y usando un server path.)
  272. == CMD_DESCRIPTION_APPLY_LOCAL ==
  273. Aplica los cambios locales (movidos, borrados y modificados localmente).
  274. == CMD_USAGE_APPLY_LOCAL ==
  275. Sintaxis:
  276. cm applylocal [opciones] [rutas]
  277. rutas: rutas de los cambios locales a aplicar. Por defecto son los de todo
  278. el workspace.
  279. Opciones:
  280. --dependencies: Incluir las dependencias de los cambios locales entre los
  281. ítems a proteger.
  282. == CMD_HELP_APPLY_LOCAL ==
  283. Notas:
  284. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  285. todos los cambios locales en el espacio de trabajo.
  286. - La operación se aplica siempre recursivamente desde la ruta indicada.
  287. Ejemplos:
  288. cm applylocal fichero1.txt fichero2.txt
  289. cm applylocal . (Aplica los cambios locales para el directorio actual y
  290. todo su contenido)
  291. cm applylocal (Aplica los cambios locales para todo el workspace)
  292. == CMD_DESCRIPTION_ARCHIVE ==
  293. Almacena o restaura datos en almacenamiento externo de un conjunto dado de revisiones especificadas.
  294. == CMD_USAGE_ARCHIVE ==
  295. Sintaxis:
  296. cm archive [revspec]+ [-c=comentario] [-f=path y nombre de fichero base]
  297. cm archive [revspec]+ --restore
  298. [revspec]+ una o más especificaciones de revisión. Se pueden leer desde la
  299. entrada estándar (STDIN) con el modificador de comando "-". Usa
  300. 'cm help objectspec' para más información sobre especificaciones.
  301. [-c | --comment] especifica el comentario que se agregará a los datos
  302. archivados que se generen.
  303. [-f | --file] especifica el nombre y (opcionalmente) el path de los ficheros
  304. que se crearán para almacenar los datos por archivar.
  305. [--restore] restaura los datos previamente archivados utilizando los
  306. ficheros de almacenamiento generados.
  307. == CMD_HELP_ARCHIVE ==
  308. Notas:
  309. El comando permite extraer datos desde la base de datos de un repositorio
  310. y volcarlos en almacenamiento externo, ahorrando espacio en la base de
  311. datos.
  312. Usa 'cm help objectspec' para saber más sobre cómo especificar una revisión.
  313. El comando también puede usarse para restaurar las revisiones 'archivadas',
  314. volviéndolas a introducir en la base de datos (opción --restore).
  315. El usuario que ejecute este comando debe ser administrador del servidor
  316. de Plastic SCM (propietario del servidor de repositorios) para que se le
  317. permita completar la operación.
  318. Cada segmento de datos de las revisiones especificadas se almacenará en
  319. un fichero diferente, prefijado por el contenido del argumento --file.
  320. Este argumento puede contener tanto un 'path' completo con un prefijo de
  321. nombre de archivo como únicamente dicho prefijo.
  322. Una vez archivados los datos de las revisiones, se podrá acceder a ellos
  323. de dos maneras:
  324. 1) Desde el cliente: el cliente de Plastic SCM detectará que los datos
  325. fueron archivados y pedirá al usuario que indique la ubicación en la que
  326. se encuentran. El usuario puede configurar las ubicaciones de los datos
  327. externos creando un fichero 'externaldata.conf' (en las ubicaciones
  328. estándar para ficheros de configuración, siguiendo las mismas reglas que se
  329. aplican para el fichero client.conf) que contendrá los paths en los que
  330. se encuentren los datos archivados.
  331. 2) Desde el servidor: de esta forma los usuarios estarán totalmente
  332. aislados del hecho de que los datos han sido archivados, ya que las
  333. peticiones se resolverán de forma transparente por el servidor. Para
  334. ello, el administrador creará un fichero 'externaldata.conf' en el
  335. directorio del servidor con los paths de los datos externos.
  336. Para restaurar (unarchive) los datos de una revisión (o conjunto de
  337. revisiones) los datos archivados deberán estar accesibles desde el cliente.
  338. Por tanto, no es posible restaurar datos que estén siendo resueltos por el
  339. servidor -método 2)- porque el cliente no será capaz de identificarlos como
  340. archivados, al resolverse de forma transparente por el servidor. Si se están
  341. resolviendo los datos externos en servidor, para poder restaurar será
  342. necesario que el administrador elimine los volúmenes por restaurar de las
  343. ubicaciones accesibles por el servidor o que configure 'externaldata.conf'
  344. apropiadamente.
  345. Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
  346. ejecutable de un editor de texto, y no se especifica un comentario al
  347. archivar, el editor se abrirá automáticamente para que especifique
  348. un comentario.
  349. Especificaciones de revisión:
  350. rev:path[#(brSpec|csetSpec|lbSpec)], ej: rev:fichero.cs#cs:5
  351. rev:fichero.cs#br:/main/task1
  352. Ejemplos:
  353. Archivar bigfile.zip:
  354. $ cm archive bigfile.zip#br:/main#13
  355. Archivar todos los ficheros mayores de 25Mb
  356. $ cm find "revs where size > 26214400" --format="{item}#{branch}" --nototal | cm archive --comment="volume00" -f="volume00" -
  357. Restaurar todos los ficheros archivados mayores de 25 Mb
  358. $ cm find "revs where size > 26214400 and archived='true'" --format="{item}#{branch}" --nototal | cm archive --restore
  359. == CMD_DESCRIPTION_ATTRIBUTE ==
  360. Use este comando para administrar atributos.
  361. == CMD_USAGE_ATTRIBUTE ==
  362. Sintaxis:
  363. cm attribute | att command [options]
  364. Comandos:
  365. create | mk
  366. delete | rm
  367. set
  368. unset
  369. rename
  370. edit
  371. Para obtener más información sobre cada comando:
  372. cm attribute comando --usage
  373. cm attribute comando --help
  374. == CMD_HELP_ATTRIBUTE ==
  375. Ejemplos:
  376. cm attribute create estado
  377. cm attribute set att:estado br:/main/SCM105 abierto
  378. cm attribute unset att:estado br:/main/SCM105
  379. cm attribute delete att:estado
  380. cm attribute rename att:estado estadoBuild
  381. cm attribute edit att:estado "Estado de la tarea en CI"
  382. == CMD_DESCRIPTION_CHANGELIST ==
  383. Permite organizar los cambios pendientes del espacio de trabajo en diferentes changelists.
  384. == CMD_USAGE_CHANGELIST ==
  385. Sintaxis:
  386. a) Manejo de los objetos 'changelist':
  387. cm changelist [list]
  388. Muestra los changelists en el espacio de trabajo actual.
  389. cm changelist add changelistName [descpription_text] [--persistent | --notpersistent]
  390. Crea un nuevo changelist con nombre = "changelistName":
  391. "descpription_text": descripción para el nuevo changelist.
  392. "--persistent | --notpersistent": Especifica si el changelist ha de eliminarse o no si el
  393. contenido del changelist se queda vacío (los cambios que contiene se protegen o se
  394. deshacen).
  395. (valor por defecto: "--notpersistent").
  396. cm changelist rm changelistName
  397. Borra un changelist con nombre = "changelistName".
  398. cm changelist edit changelistName [editParameterAction newValue] [--persistent | --notpersistent]
  399. Modifica un changelist con nombre = "changelistName:
  400. "editParameterAction": Posibles valores: "rename" | "description"
  401. "--persistent | --notpersistent": Especifica si el changelist ha de eliminarse o no si el
  402. contenido del changelist se queda vacío (los cambios que contiene se deshacen o se les
  403. ejecuta una operación de check-in.
  404. (valor por defecto: "--notpersistent").
  405. b) Manejo del contenido de un 'changelist' concreto:
  406. cm changelist changelistName (add | rm) ruta(s)
  407. Añade / elimina del changelist con nombre = "changelistName" el cambio que
  408. coincide con la(s) ruta(s) especificada(s).
  409. Opciones:
  410. clist_name El nombre un changelist.
  411. clist_desc La descripción un changelist.
  412. action_name Utiliza '^rename' o '^description' para modificar un
  413. changelist.
  414. action_value Realiza la operación de renombrado o cambio de la descripción
  415. cuando editas un changelist.
  416. --persistent El changelist permacenerá en el workspace incluso si se ha ejecutado
  417. una operación de check-in o de revert.
  418. --notpersistent (Default) El changelist no permanecerá en el workspace.
  419. --symlink Realizar la operacion de checkin sobre el fichero de link y no
  420. al que apunta..
  421. == CMD_HELP_CHANGELIST ==
  422. Notas:
  423. El comando 'changelist' permite administrar los changelists existentes en un
  424. espacio de trabajo, así como los cambios que contiene cada uno de ellos.
  425. Ejemplos del manejo de los changelists existentes en el espacio de trabajo:
  426. $ cm changelist
  427. (lista los changelists en el espacio de trabajo actual).
  428. $ cm changelist add config_changes "dotConf files" --persistent
  429. (crea un changelist con nombre "config_changes", descripción "dotConf files",
  430. que además quedará persistente en el espacio de trabajo una vez que se
  431. haga check-in o revert de dicho changelist).
  432. $ cm changelist edit config_changes rename "config_files" --notpersistent
  433. (edita el changelist con nombre "config_changes" y lo renombra a
  434. "config_files". Además convierte el changelist en no persistente).
  435. $ cm changelist edit config_changes --notpersistent
  436. (edita el changelist con nombre "config_changes" y lo convierte en no persistente).
  437. $ cm changelist rm "config_files"
  438. (elimina el changelist "congig_files" del espacio de trabajo actual).
  439. Ejemplos del manejo del contenido de un changelist:
  440. (Nota, los ficheros que se manejan en los siguientes comandos han de
  441. encontrarse en estado "Added" or "Checked-out".
  442. $ cm changelist "config_files" add "foo.conf"
  443. (añade el fichero "foo.conf" al changelist "config_files")
  444. $ cm changelist "config_files" rm "foo.conf"
  445. (elimina el fichero "foo.conf" del changelist "config_files" y
  446. lo mueve al changelist por defecto del sistema).
  447. == CMD_DESCRIPTION_CHANGESET ==
  448. Ejecuta operaciones avanzadas sobre changesets.
  449. == CMD_USAGE_CHANGESET ==
  450. Sintaxis:
  451. cm changeset comando [opciones]
  452. Comandos:
  453. move | mv
  454. delete | rm
  455. editcomment | edit
  456. Para obtener más información de cada uno de los comandos ejecute:
  457. cm changeset command --usage
  458. cm changeset command --help
  459. == CMD_HELP_CHANGESET ==
  460. Ejemplos:
  461. cm changeset move cs:15@myrepo br:/main/scm005@myrepo
  462. cm changeset delete cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
  463. == CMD_DESCRIPTION_CHANGESET_EDIT_COMMENT ==
  464. Modifica el comentario de un changeset.
  465. == CMD_USAGE_CHANGESET_EDIT_COMMENT ==
  466. Sintaxis:
  467. cm changeset editcomment | edit <cset_spec> <nuevo_comentario>
  468. Opciones:
  469. spec_cset El changeset objetivo para editar su comentario.
  470. Usa 'cm help objectspec' para más información.
  471. nuevo_comentario El nuevo comentario que será asignado al changeset
  472. seleccionado.
  473. == CMD_HELP_CHANGESET_EDIT_COMMENT ==
  474. Notas:
  475. - La especificación del changeset objetivo debe ser válida.
  476. Ejemplos:
  477. cm changeset editcomment cs:15@myrepo "Olvidé añadir detalles importantes."
  478. cm changeset edit cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
  479. "Este texto de comentario sustituirá al anterior."
  480. == CMD_DESCRIPTION_CHANGESET_MOVE ==
  481. Mueve un changeset y todos sus descendientes en la misma rama a otra rama distinta.
  482. == CMD_USAGE_CHANGESET_MOVE ==
  483. Sintaxis:
  484. cm changeset move | mv <spec_cset> <spec_branch>
  485. Opciones:
  486. spec_cset El primer changeset que debe moverse a una rama
  487. diferente. Todos los changeset descendientes en la
  488. misma rama se moverán también.
  489. spec_branch La rama destino a la que mover los changesets
  490. seleccionados. Debe estar vacía o no existir. En caso
  491. de no existir, el comando la creará.
  492. Usa 'cm help objectspec' para obtener más información sobre cómo indicar
  493. especificaciones de changeset y rama.
  494. == CMD_HELP_CHANGESET_MOVE ==
  495. Notas:
  496. - La especificación del changeset objetivo debe ser válida.
  497. - La rama de destino debe estar vacía o no existir.
  498. - Si la rama de destino no existe, el comando la creará.
  499. - Los enlaces de merge no se verán afectados dado que las ramas no están
  500. involucradas en ellos.
  501. Ejemplos:
  502. cm changeset move cs:15@myrepo br:/main/scm005@myrepo
  503. cm changeset move cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
  504. br:/hotfix/TL-352
  505. == CMD_DESCRIPTION_CHANGESET_DELETE ==
  506. Elimina un changeset del repositorio.
  507. == CMD_USAGE_CHANGESET_DELETE ==
  508. Sintaxis:
  509. cm changeset delete | rm <spec_cset>
  510. Opciones:
  511. spec_cset El changeset seleccionado para eliminar. Debe cumplir
  512. una serie de condiciones; ver ayuda completa para
  513. más información. Usa 'cm help objectspec' para aprender
  514. cómo construir las especificaciones.
  515. == CMD_HELP_CHANGESET_DELETE ==
  516. Notas:
  517. - El changeset objetivo debe ser el último en su rama.
  518. - No debe haber ningún otro changeset que tenga al objetivo como padre.
  519. - El changeset objetivo no debe ser origen de merge ni estar envuelto en
  520. el intervalo origen de un merge de intervalo.
  521. - No debe haber etiquetas aplicadas al changeset objetivo.
  522. - El changeset objetivo no puede ser el changeset raíz (cs:0)
  523. Ejemplos:
  524. cm changeset rm cs:4525@myrepo@myserver
  525. cm changeset delete cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
  526. == CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
  527. Cambia la contraseña del usuario actual cuando la configuración de seguridad es usuario/contraseña.
  528. == CMD_USAGE_CHANGEUSERPASSWORD ==
  529. Sintaxis:
  530. cm changeuserpassword
  531. == CMD_HELP_CHANGEUSERPASSWORD ==
  532. Notas:
  533. Este comando solamente está disponible cuando el sistema de seguridad y
  534. usuarios está configurado en modo de funcionamiento de usuario/contraseña.
  535. Ejemplo:
  536. cm changeuserpassword
  537. == CMD_DESCRIPTION_CHECKCONNECTION ==
  538. Comprueba la conexión del cliente de Plastic SCM contra el servidor.
  539. == CMD_USAGE_CHECKCONNECTION ==
  540. Sintaxis:
  541. cm checkconnection
  542. == CMD_HELP_CHECKCONNECTION ==
  543. Notas:
  544. Este comando retorna un mensaje indicando si hay una conexión valida contra
  545. el servidor de Plastic SCM o no.
  546. El comando comprueba si el usuario configurado es válido.
  547. También comprueba si la versión del cliente es compatible con la del
  548. servidor.
  549. == CMD_DESCRIPTION_CHECKDB ==
  550. Comprueba la integridad de las bases de datos.
  551. == CMD_USAGE_CHECKDB ==
  552. Sintaxis:
  553. cm checkdatabase [spec]
  554. spec: Especificación del servidor o de un repositorio.
  555. Usa 'cm help objectspec' para aprender cómo indicar especificaciones
  556. de servidor y repositorio.
  557. == CMD_HELP_CHECKDB ==
  558. Notas:
  559. - Si no se especifica [spec], el comando utilizará el valor del servidor
  560. del fichero client.conf.
  561. Ejemplos:
  562. cm checkdatabase repserver:localhost:8084
  563. cm checkdatabase rep:default@localhost:8084
  564. == CMD_DESCRIPTION_CHECKIN ==
  565. Crea una nueva revisión de un ítem.
  566. == CMD_USAGE_CHECKIN ==
  567. Se pueden proteger tanto ficheros como directorios.
  568. Sintaxis:
  569. cm checkin [opciones] [rutas]
  570. rutas: rutas de los items a proteger.
  571. Opciones:
  572. --nchk: (No check) No chequea el contenido del fichero al proteger.
  573. Ver notas para mas información.
  574. --symlink: Realizar la operacion de checkin sobre el fichero de link y no
  575. al que apunta.
  576. -c: Añade un comentario al changeset creado en la operación de protección.
  577. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  578. --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
  579. rutas dadas, también serán protegidos.
  580. --dependencies: Incluir las dependencias de los cambios locales entre los
  581. ítems a proteger.
  582. --private: Los ítems privados también serán protegidos.
  583. == CMD_HELP_CHECKIN ==
  584. Notas:
  585. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  586. todos los cambios pendientes en el espacio de trabajo.
  587. - La operación de protección se aplica siempre recursivamente desde la
  588. ruta indicada.
  589. - Requisitos para proteger un ítem:
  590. * El ítem debe estar controlado por Plastic SCM.
  591. * El ítem ha de estar desprotegido.
  592. * La revisión ha de tener cambios. Es decir, no se pueden proteger los
  593. mismos datos. Para eliminar la desprotección descartando los cambios,
  594. se utiliza el comando uncheckout.
  595. * Con la opción --nchk, se fuerza la protección del ítem, sin comprobar
  596. los datos.
  597. Ejemplos:
  598. cm checkin fichero1.txt fichero2.txt
  599. cm checkin . (Protege el directorio actual)
  600. (Proteger recursivamente el contenido de 'src')
  601. cm checkin link --symlink
  602. (Proteger el fichero de link y no al que apunta, opción disponible en UNIX)
  603. Comentarios:
  604. Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
  605. cm ci file1.txt -c="my comment"
  606. cm ci file1.txt -m "my comment"
  607. Proteger 'changelist'. Ejemplo:
  608. cm status --short --compact --changelist=pending_to_review | cm checkin -
  609. (El comando listará los paths en el changelist llamado 'pending_to_review'
  610. y dicha lista será redirigida a la entrada del comando 'checkin').
  611. Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
  612. ejecutable de un editor de texto, y no se especifica un comentario al
  613. hacer checkin, el editor se abrirá automáticamente para que especifique
  614. un comentario.
  615. == CMD_DESCRIPTION_CHECKOUT ==
  616. Desprotege un ítem dado.
  617. == CMD_USAGE_CHECKOUT ==
  618. Sintaxis:
  619. cm co [Opciones] paths
  620. paths: Rutas de los elementos que se desean desproteger.
  621. Opciones:
  622. -R: Descender recursivamente dentro del ítem.
  623. --symlink: Efectúar la desprotección sobre el fichero de link y no al que
  624. apunta.
  625. --ignorefailed: Si un ítem no se puede bloquear (no se le puede hacer un
  626. checkout exclusivo), la operación de checkout continuará sin él.
  627. == CMD_HELP_CHECKOUT ==
  628. Notas:
  629. Cuando un ítem del workspace se desea modificar, se debe desproteger.
  630. La forma de desproteger un ítem es utilizando el comando co.
  631. Se pueden desproteger tanto ficheros como directorios.
  632. Requisitos: Para poder desproteger elementos:
  633. El ítem debe estar controlado por Plastic.
  634. El ítem debe estar protegido previamente.
  635. Ejemplos:
  636. cm co . (Desproteger el directorio actual)
  637. cm co c:\workspace\fichero.txt
  638. cm co fichero1.cs fichero2.cs
  639. cm co –R c:\workspace\src (desprotege recursivamente todo el contenido de ‘src’)
  640. cm co –R * (desprotege recursivamente todos los elementos del directorio actual)
  641. cm co link --symlink
  642. (desprotege el fichero de link y no el fichero al que apunta, disponible en UNIX)
  643. == CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
  644. Comprueba la sintaxis de un selector.
  645. == CMD_USAGE_CHECKSELECTORSYNTAX ==
  646. Uso:
  647. cm checkselectorsyntax [--file=file]
  648. Opciones:
  649. --file=file: El fichero del cual leer el selector; si no se especifica se
  650. supone la entrada estándar.
  651. == CMD_HELP_CHECKSELECTORSYNTAX ==
  652. Notas:
  653. Este comando lee el selector desde un fichero o desde la entrada estándar
  654. y comprueba si su sintaxis es válida. Si falla la comprobación se muestra
  655. en la salida estándar.
  656. == CMD_DESCRIPTION_CHGREVTYPE ==
  657. Cambia el tipo de todas las revisiones de un ítem.
  658. == CMD_USAGE_CHGREVTYPE ==
  659. Sintaxis:
  660. cm changerevisiontype | chgrevtype | crt rutas --type=tipo
  661. rutas: Rutas de los items para alterar el tipo de sus revisiones.
  662. tipo: Tipo al que se fijarán las revisiones.
  663. == CMD_HELP_CHGREVTYPE ==
  664. Notas:
  665. Este comando sólo puede aplicarse a ficheros, no a directorios.
  666. El tipo especificado, ha de ser alguno soportado por el sistema:
  667. bin
  668. txt
  669. ...
  670. Ejemplos:
  671. cm changerevisiontype c:\workspace\file.txt --type=txt
  672. (Cambia el tipo de revisión de 'file.txt' a 'txt'.)
  673. cm chgrevtype comp.zip "image file.jpg" --type=bin
  674. (Cambia el tipo de revisión de 'comp.zip' e "image file.jpg" a 'bin'.)
  675. cm crt *.* --type=txt
  676. (Cambia el tipo de revisión de todos los archivos a 'txt'.)
  677. == CMD_DESCRIPTION_TRIGGER_EDIT ==
  678. Cambia la información asociada a un trigger existente.
  679. == CMD_USAGE_TRIGGER_EDIT ==
  680. Sintaxis:
  681. cm trigger edit subtipo-tipo posición [opciones]
  682. subtipo-tipo: Tipo y subtipo de trigger.
  683. Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
  684. trigger disponibles. Algunos ejemplos son:
  685. before-mkbranch
  686. after-mkwokspace
  687. after-setselector
  688. posición: posición que ocupa el trigger que deseamos modificar.
  689. Opciones:
  690. --position=posición: nueva posición para el trigger especificado.
  691. --name=nombre: nuevo nombre para el trigger especificado.
  692. --script=ruta: nueva ruta de ejecución para el script del trigger
  693. especificado. Si esta ruta comienza por "webtrigger ", se
  694. considerará como web trigger. Consulte la ayuda del comando para obtener
  695. detalles adicionales.
  696. --filter=filtro: Comprueba sólo aquellos elementos que coincidan con el
  697. filtro de busqueda indicado.
  698. --server=servidor: modifica el trigger en el servidor especificado.
  699. Si no se especifica ninguno lo busca en el que se configuró en el cliente.
  700. Usa 'cm help objectspec' para más información.
  701. == CMD_HELP_TRIGGER_EDIT ==
  702. Notas:
  703. Web triggers: Para crear web triggers, escriba "webtrigger <target-uri>"
  704. como comando de trigger. En este caso, el trigger ejecutará una consulta
  705. POST contra el URI especificado, en la que el cuerpo de la petición
  706. contiene un diccionario JSON con las variables de entorno del trigger.
  707. También estará presente una clave INPUT apuntando a un vector de cadenas de
  708. texto para aquellos triggers que escriban en la entrada estándar de sus
  709. comandos asociados.
  710. Ejemplos:
  711. cm trigger edit after-setselector 6 --name="Gestiona backup2" --script="/nuevo/path/al/script"
  712. cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
  713. cm tr edit after-add 2 --script="webtrigger http://myserver.org/api"
  714. == CMD_DESCRIPTION_CODEREVIEW ==
  715. Crea, edita o elimina revisiones de código.
  716. == CMD_USAGE_CODEREVIEW ==
  717. Sintaxis:
  718. cm codereview <spec> <título> [--status=nombre_estado]
  719. [--assignee=nombre_usuario] [--format=cad_formato]
  720. [--repository=rep_spec]
  721. spec Puede tratarse tanto de una especificación de
  722. changeset como de una especificación de rama.
  723. Determina el objetivo de la nueva revisión de código.
  724. título Una cadena de texto para utilizarla como título de la
  725. nueva revisión de código.
  726. cm codereview -e <id> [--status=nombre_estado]
  727. [--assignee=nombre_usuario] [--repository=rep_spec]
  728. cm codereview -d <id> [id...] [--repository=rep_spec]
  729. id Número identificador de la revisión de código. Puede
  730. utilizarse también su GUID.
  731. Opciones:
  732. -e Edita los parámetros de una revisión de código
  733. existente.
  734. -d Elimina una revisión de código existente.
  735. --status Modifica el estado de una revisión de código. Consulte
  736. las notas para más información.
  737. --assignee Modifica el usuario asignado a la revisión de código.
  738. --repository Indica el repositorio que se utilizará por defecto.
  739. --format Devuelve el mensaje de respuesta con el formato
  740. especificado. Consulte la ayuda para más información.
  741. == CMD_HELP_CODEREVIEW ==
  742. Notas:
  743. Este comando permite manipular revisiones de código: crear, editar
  744. y eliminar revisiones de código de changesets o ramas.
  745. Para crear una nueva revisión de código se requiere una especificación de
  746. changeset o rama, junto con un título. Además, puede indicarse tanto
  747. el usuario asignado (revisor de los cambios) como el estado inicial.
  748. Como resultado se devolverá un ID (o GUID, si así se solicitó).
  749. Para editar o eliminar una revisión de código existente se requiere el ID
  750. (o GUID) de la misma. No se mostrarán mensajes si no se detectan errores.
  751. El parámetro 'status' sólo puede tener como valor uno de los siguientes:
  752. 'Under review' (valor por defecto), 'Reviewed' o 'Rework required'.
  753. El parámetro 'repository' se encuentra disponible para actuar sobre las
  754. revisiones de código de un repositorio diferente al asociado al espacio
  755. de trabajo actual (o para situaciones en las que no exista espacio de
  756. trabajo).
  757. Personalización del formato de salida:
  758. Este comando acepta una cadena de formato para mostrar su salida.
  759. Los parámetros de salida del comando son los siguientes:
  760. {0} id
  761. {1} guid
  762. Por favor, tenga en cuenta que el parámetro --format sólo tiene efecto
  763. al crear una nueva revisión de código.
  764. Ejemplos:
  765. cm codereview cs:1856@myrepo@myserver:8084 "Mi nueva revisión" --assignee=dummy
  766. cm codereview br:/main/task001@myrepo@myserver:8084 "Mi nueva revisión" --status="Rework required" --assignee=newbie --format="{id} -> {guid}"
  767. cm codereview 1367 -e --assignee=new_assignee
  768. cm codereview -e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --status=Reviewed
  769. cm codereview -d 1367 --repository=myremoterepo@myremoteserver:18084
  770. cm codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -d
  771. == CMD_DESCRIPTION_CRYPT ==
  772. Encripta una contraseña.
  773. == CMD_USAGE_CRYPT ==
  774. Sintaxis:
  775. cm crypt mypassword
  776. mypassword Contraseña que se va a encriptar.
  777. == CMD_HELP_CRYPT ==
  778. Notas:
  779. Este comando encripta una contraseña cualquiera pasada como argumento.
  780. Está diseñado para encriptar las contraseñas de los ficheros de
  781. configuración y aumentar así su seguridad.
  782. Ejemplos:
  783. cm crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
  784. (Encripta la contraseña en el fichero de la base de datos de configuración:
  785. db.conf)
  786. == CMD_DESCRIPTION_DEACTIVATEUSER ==
  787. Desactiva un usuario activado previamente.
  788. == CMD_USAGE_DEACTIVATEUSER ==
  789. Sintaxis:
  790. cm deactivateuser nombre1 nombre2 ... [opciones]
  791. nombre: Nombre del usuario que se desea desactivar.
  792. Opciones:
  793. --nosolveuser: Intenta desactivar el usuario especificado sin resolver
  794. el nombre dado en el sistema de autenticación subyacente.
  795. --server: desactiva el usuario en el servidor especificado.
  796. == CMD_HELP_DEACTIVATEUSER ==
  797. Notas:
  798. Este comando deshabilita a un usuario para el uso de Plastic SCM.
  799. Por favor, consulte la guía de usuario, o el comando "activateuser" para
  800. obtener más información acerca de la habilitación de usuarios de Plastic SCM.
  801. Para activar un usuario por primera vez, basta con utilizar Plastic SCM con
  802. las credenciales del usuario a activar, siempre que no se sobrepase el
  803. número máximo de usuarios autorizados.
  804. El comando comprueba que el usuario a deshabilitar existe en el sistema de
  805. autenticación subyacente (p.ej: ActiveDirectory, LDAP, Usuario/Contraseña ...).
  806. Si se desea desactivar un usuario que ya no existe en el sistema de autenticación,
  807. utilice la opción --nosolveuser
  808. Ejemplos:
  809. cm deactivateuser juan
  810. cm deactivateuser juan --server=miservidor:8084
  811. cm deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --nosolveuser
  812. == CMD_DESCRIPTION_DIFF ==
  813. Muestra las diferencias existentes entre dos revisiones o dos changesets
  814. == CMD_USAGE_DIFF ==
  815. Sintaxis:
  816. cm differences [opciones] version1 [version2] [ruta]
  817. version1: especificación de rama, primera revisión, changeset, etiqueta o
  818. shelve a comparar.
  819. version2: segunda especificación de revisión, changeset, etiqueta o shelve
  820. a comparar.
  821. ruta: muestra las diferencias en el fichero especificado
  822. Usa 'cm help objectspec' para obtener más información sobre especificaciones.
  823. Opciones:
  824. --added: imprime sólo las diferencias consistentes en items añadidos
  825. --changed: imprime sólo las diferencias consistentes en items cambiados
  826. --moved: imprime sólo las diferencias consistentes en items movidos
  827. o renombrados
  828. --deleted: imprime sólo las diferencias consistentes en items borrados
  829. --all: imprime todas las diferencias
  830. La primera letra de cada línea que se imprime denota el tipo de cambio:
  831. A significa que el ítem fue añadido
  832. C signnifica que el ítem fue cambiado
  833. D significa que el ítem fue borrado
  834. M significa que el ítem fue movido o renombrado. El ítem a la izquierda
  835. es el nombre original, el ítem a la derecha es el nombre en destino
  836. --clean: limpia las diferencias de la rama (omite las diferencias que vienen
  837. de los merges
  838. --download: almacena el contenido de las diferencias en la ruta especificada.
  839. --fullpaths, --fp: Fuerza al comando a imprimir rutas de workspace absolutas
  840. siempre que sea posible.
  841. --repositorypaths: imprime rutas de repositorio en lugar de rutas
  842. de workspace. (Ésta opción prevalece sobre la opción "--fullpaths").
  843. == CMD_HELP_DIFF ==
  844. Notas:
  845. Este comando muestra las diferencias en una rama si el segundo comando no se
  846. especifica o entre dos revisiones, changesets o etiquetas si se especifica
  847. el segundo parámetro.
  848. Comparar ramas:
  849. cm diff br:/main/task001
  850. cm diff br:/main/task001 \doc\readme.txt
  851. Comparar changesets:
  852. cm diff 19
  853. cm diff 19 25
  854. cm diff cs:19 cs:25
  855. cm diff cs:19 cs:23 --changed
  856. cm diff cs:19 cs:23 --repositorypaths
  857. cm diff cs:19 cs:23 \doc\readme.txt
  858. Comparar etiquetas:
  859. cm diff lb:EtiquetaPrimeraRelease lb:EtiquetaSegundaRelease
  860. cm diff lb:tag_193.2 cs:34214
  861. cm diff cs:31492 lb:tag_193.2
  862. Comaprar shelves:
  863. cm diff sh:2
  864. cm diff sh:2 sh:4
  865. Comparar revisiones:
  866. cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
  867. cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
  868. serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
  869. == CMD_DESCRIPTION_DIFFMETRICS ==
  870. Muestra métricas sobre las diferencias de dos revisiones (líneas añadidas, cambiadas y borradas).
  871. == CMD_USAGE_DIFFMETRICS ==
  872. (líneas cambiadas, añadidas y borradas)
  873. Sintaxis:
  874. cm diffmetrics [opciones] spec_revision1 spec_revision2
  875. spec_revision1: Especificación de revisión.
  876. spec_revision2: La otra especificación de revisión.
  877. Usa 'cm help objectspec' para más información sobre especificaciones.
  878. Opciones:
  879. --format=str: Cadena de formato de salida. Ver notas para más información.
  880. --encoding=tipo_codificación: Cambia la codificación.
  881. --ignore=método_de_comparación: Cambia la forma de calcular las diferencias.
  882. tipo_codificación : ascii
  883. unicode
  884. bigendian
  885. utf7
  886. utf8
  887. método_de_comparación:
  888. none (por defecto)
  889. eol (ignora diferencias en retornos de carra)
  890. whitespaces (ignora diferencias en espacios en blanco)
  891. eol&whitespaces (las dos anteriores)
  892. == CMD_HELP_DIFFMETRICS ==
  893. Notas:
  894. Este comando acepta una cadena de formato para mostrar la salida.
  895. Cada parámetro de salida se identifica con un número, y el usuario se
  896. puede referir a él escribiéndolo entre los símbolos '{' y '}'.
  897. Los parámetros de salida de este comando son los siguientes:
  898. 0: Número de líneas cambiadas
  899. 1: Número de líneas añadidas
  900. 2: Número de líneas borradas
  901. Éstas son cadenas de formato válidas:
  902. --format={0}{1}{2}
  903. --format="Hay {0} líneas cambiadas, {1} líneas añadidas y {2} líneas borradas"
  904. Ejemplos:
  905. cm diffmetrics fichero.txt#br:/main#2 fichero.txt#br:/main/scm0211#4
  906. cm diffmetrics fichero.txt#br:/main#2 fichero.txt#br:/main#3 --encoding=utf8 --ignore=whitespaces
  907. == CMD_DESCRIPTION_FASTEXPORT ==
  908. Exporta los datos de un repositorio de Plastic SCM a un formato fast-export.
  909. == CMD_USAGE_FASTEXPORT ==
  910. Sintaxis:
  911. cm ^fast-export | ^fe <repspec> <fast-export-file>
  912. [--^import-marks=<marks_file>]
  913. [--^export-marks=<marks_file>]
  914. [--^branchseparator=<chr_separator>]
  915. [--^nodata] [--^from=<changesetid>] [--^to=<changesetid>]
  916. Opciones:
  917. repspec Repositorio cuyos datos serán exportados.
  918. (Usa 'cm help objectspec' para aprender cómo especificar
  919. un repositorio.)
  920. fast-export-file Fichero con los datos del repositorio en formato
  921. fast-export de Git.
  922. --import-marks Fichero de marcas usado para la importación incremental.
  923. Este fichero habrá sido previamente exportado con el
  924. comando --export-marks. Los changesets descritos en este
  925. fichero no serán importados porque ya lo fueron en una
  926. importación previa.
  927. --export-marks Fichero donde se guardan los changesets importados.
  928. Este fichero podrá ser usado en una operación fast-import
  929. para indicar los changesets que han sido importados.
  930. --branchseparator Plastic SCM usa "/" como separador por defecto en la
  931. jerarquía de ramas. Esta opción permite usar un carácter
  932. como separador de jerarquía. Por ejemplo, la rama
  933. main-task-sub será mapeada en Plastic como /main/task/sub.
  934. --nodata Realiza la exportaciónExporta pero sin incluir datos.
  935. Esta opción es útil si se desea comprobar que la
  936. exportación se ejecutará sin problemas.
  937. --from Exporta desde el changeset especificado.
  938. --to Exporta hasta el changeset especificado.
  939. == CMD_HELP_FASTEXPORT ==
  940. Notas:
  941. - Para importar un repositorio de Plastic a Git, usa el siguiente comando:
  942. cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git
  943. - La exportación incremental es soportado usando un fichero de marcas que
  944. contenga los changesets previamente importados (ficheros --import-marks y
  945. --export-marks).
  946. Esto significa que solamente los nuevos changesets que no fueron
  947. exportados en una operación previa de fast-export serán exportados.
  948. Ejemplos:
  949. cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm
  950. (Exporta el repositorio "repo" en el servidor local al fichero "repo.fe.00"
  951. en formato fast-export de Git y crea el fichero de marcas para poder
  952. realizar una futura exportación incremental.)
  953. cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
  954. (Exporta el repositorio "repo" en el servidor local al fichero "repo.fe.00"
  955. en formato Git fast-export desde el changeset '20'.)
  956. == CMD_DESCRIPTION_FASTIMPORT ==
  957. Importa datos de fast-export de Git en el repositorio.
  958. == CMD_USAGE_FASTIMPORT ==
  959. Sintaxis:
  960. cm ^fast-import | ^fi <repspec> <fast-export-file>
  961. [--^import-marks=<marks_file>]
  962. [--^export-marks=<marks_file>]
  963. [--^stats] [--^branchseparator=<chr_separator>]
  964. [--^nodata] [--^ignoremissingchangesets] [--^mastertomain]
  965. Opciones:
  966. repspec Repositorio en el cual se importarán los datos.
  967. Si no existe en el momento de la operación, se
  968. crea automáticamente. (Usa 'cm help objectspec'
  969. para aprender cómo especificar un repositorio.)
  970. fast-export-file Fichero con los datos en formato Git
  971. fast-export.
  972. --import-marks El fichero de etiquetas (marks) utilizado para
  973. importaciones incrementales. Dicho fichero se
  974. ha exportado previamente con --export-marks.
  975. Los changesets descritos en este fichero no se
  976. importarán porque ya existían de una importación
  977. previa.
  978. --export-marks El fichero en el cual se guardarán los changesets
  979. importados. Dicho fichero se utiliza en una
  980. operación posterior de fast-import para señalar
  981. los changesets que ya han sido importados.
  982. --stats Muestra estadísticas del proceso de importación.
  983. --branchseparator Plastic SCM usa "/" como separador por defecto
  984. en la jerarquía de ramas. Esta opción permite
  985. usar un carácter como separador en esa
  986. jerarquía. Por ejemplo, la rama main-task-sub
  987. será mapeada en Plastic SCM como /main/task/sub.
  988. --nodata Realiza la importación pero sin incluir datos.
  989. Esta opción es útil si se desea comprobar que la
  990. importación se ejecutará sin problemas.
  991. --ignoremissingchangesets Los changesets que no pueden ser importados se
  992. descartan y la operación de fast-import continúa
  993. sin ellos.
  994. --mastertomain Realiza la importación usando "main" en lugar
  995. de "master".
  996. == CMD_HELP_FASTIMPORT ==
  997. Notas:
  998. * Para exportar un repositorio de Git, utilice un comando como el
  999. siguiente:
  1000. git fast-export --all -M --signed-tags=strip
  1001. --tag-of-filtered-object=drop> ..\git-fast-export.dat
  1002. La opción -M es importante para detectar ítems movidos.
  1003. * El repositorio especificado se crea en caso de que no exista.
  1004. * Se soporta una importación incremental utilizando ficheros de marcas que
  1005. contienen los changesets ya importados (--import-marks and --export-marks).
  1006. Esto significa que solamente se importarán los changesets que no fueron
  1007. importados previamente.
  1008. Ejemplos:
  1009. cm fast-import mynewrepo@atenea:8084 repo.fast-export
  1010. Importa el contenido exportado en el fichero repo.fast-export en el
  1011. repositorio "mynewrepo" del servidor atenea:8084.
  1012. cm fast-import repo@server:8084 repo.fast-export --export-marks=rep.marks
  1013. Importa el contenido del fichero de exportaciones repo.fast-export en el
  1014. repositorio "mynewrepo" del servidor atenea:8084 y crea un archivo de
  1015. marcas para importaciones incrementales posteriores.
  1016. cm fast-import repo@server:8084 repo.fast-export --importmarks=repo.marks
  1017. --export-marks=repo.marks
  1018. Importa el contenido del fichero repo.fast-export. Solamente se importarán
  1019. los changesets que no están en el fichero de marcas. Se utiliza el mismo
  1020. fichero de marcas para guardar los changesets que se importarán esta vez,
  1021. de nuevo con el fin de otra importación incremental posterior.
  1022. == CMD_DESCRIPTION_FILEINFO ==
  1023. Obtiene información detallada sobre elementos en el espacio de trabajo.
  1024. == CMD_USAGE_FILEINFO ==
  1025. Sintaxis:
  1026. cm fileinfo <item_path> [--fields=field_list] [--xml[=output_file]]
  1027. [--format=str_format] [--encoding=name]
  1028. item_path Elementos para mostrar, separados por espacios. Pueden
  1029. utilizarse comillas (") para aquellas rutas que
  1030. contengan espacios.
  1031. Opciones:
  1032. --fields Una cadena de valores separados por coma. Indica
  1033. qué campos se mostrarán por cada elemento.
  1034. Puede encontrar información adicional mediante el
  1035. comando 'cm help fileinfo'.
  1036. --xml Vuelca la salida en formato XML a la salida estándar.
  1037. Es posible especificar un fichero de salida. Esta opción
  1038. no puede combinarse con --format.
  1039. --format Obtiene el mensaje de salida en un formato específico.
  1040. Consulte las notas para más información. No puede
  1041. combinarse con --xml.
  1042. --symlink Aplica la operación fileinfo al enlace simbólico y no
  1043. a su destino.
  1044. --encoding Especifica la codificación de salida. P. ej.: UTF-8.
  1045. Consulte la documentación MSDN para obtener la lista de
  1046. codificaciones soportadas y su formato, al final de la
  1047. página. La columna "Name":
  1048. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1049. == CMD_HELP_FILEINFO ==
  1050. Notas:
  1051. Este comando muestra una lista detallada de atributos para cada elemento
  1052. seleccionado. Cada atributo se muestra en una nueva línea por defecto.
  1053. Se puede modificar la lista de atributos para mostrar únicamente los
  1054. atributos que el usuario necesite. A tal efecto se puede utilizar el
  1055. argumento --fields=lista, que acepta una cadena de nombres de atributo
  1056. separados por comas. De este modo, solo se mostrarán aquellos argumentos
  1057. cuyo nombre esté presente en la lista.
  1058. Revision Head Changeset:
  1059. Esta opción está desactivada por defecto. Tenga en cuenta que la
  1060. recuperación de este atributo es notablemete más lenta que el resto, por
  1061. lo que recomendamos al usuario agrupar tantos ficheros por ejecución como
  1062. sea posible. Esto mejora los tiempos de ejecución, al evitar numerosas
  1063. ejecuciones 'cm fileinfo' separadas.
  1064. Adicionalmente, esta característica no se encuentra disponible actualmente
  1065. para directorios controlados por PlasticSCM.
  1066. A continuación se encuentra la lista completa de nombres de atributo. Los
  1067. nombres marcados con asterisco ('*') no se muestran por defecto:
  1068. ClientPath Ruta local del elemento en disco.
  1069. RelativePath Ruta del elemento relativa al workspace.
  1070. ServerPath Ruta del elemento en el repositorio.
  1071. (Nota: las rutas afectadas por workspace
  1072. transformables no están soportadas actualmente)
  1073. Size Tamaño del elemento.
  1074. Hash Suma 'hash' del elemento
  1075. Owner Nombre del usuario propietario del elemento.
  1076. RevisionHeadChangeset* Changeset de la revisión cargada en el último
  1077. changeset de la rama (ver párrafo anterior).
  1078. RevisionChangeset Changeset de la revisión cargada en el workspace
  1079. RepSpec Especificación del repositorio al que pertenece
  1080. el elemento (repositorio@servidor).
  1081. Status Estado actual del elemento en el espacio de
  1082. trabajo (añadido, eliminado, checkout, etc.).
  1083. Type Tipo de la revisión (texto, binario, directorio,
  1084. enlace simbólico o desconocido).
  1085. Changelist Lista de cambios a la que pertenece el elemento
  1086. (si la hubiere).
  1087. IsLocked* Muestra si el elemento está bloqueado o no.
  1088. LockedBy* Usuario que bloqueó el elemento mediante
  1089. checkout exclusivo.
  1090. LockedWhere* Localización del elemento bloqueado mediante
  1091. checkout exclusivo.
  1092. IsUnderXlink Muestra si el elemento se encuentra bajo un
  1093. Xlink o no.
  1094. UnderXlinkTarget Repositorio destino del Xlink en que se
  1095. encuentra el elemento, si lo hubiere.
  1096. UnderXlinkPath Ruta en el repositorio apuntado por el Xlink
  1097. en que se encuentra el elemento, si lo hubiere.
  1098. UnderXlinkWritable Muestra si el Xlink bajo el que se encuentra el
  1099. elemento es de escritura o no.
  1100. UnderXlinkRelative Muestra si el Xlink bajo el que se encuentra el
  1101. elemento es relativo o no.
  1102. IsXlink Muestra si el elemento es un Xlink o no.
  1103. XlinkTarget Repositorio objetivo del Xlink, si el elemento
  1104. lo es.
  1105. XlinkName Nombre del Xlink, si el elemento lo es.
  1106. XlinkWritable Muestra si el elemento es un Xlink de escritura
  1107. o no.
  1108. XlinkRelative Muestra si el elemento es un Xlink relativo o no
  1109. Personalización del formato de salida:
  1110. Este comando acepta una cadena de formato para mostrar su salida.
  1111. Los parámetros de salida de este comando son los siguientes:
  1112. ClientPath
  1113. RelativePath
  1114. ServerPath
  1115. Size
  1116. Hash
  1117. Owner
  1118. RevisionHeadChangeset
  1119. RevisionChangeset
  1120. Status
  1121. Type
  1122. Changelist
  1123. IsLocked
  1124. LockedBy
  1125. LockedWhere
  1126. IsUnderXlink
  1127. UnderXlinkTarget
  1128. UnderXlinkPath
  1129. UnderXlinkWritable
  1130. UnderXlinkRelative
  1131. IsXlink
  1132. XlinkTarget
  1133. XlinkName
  1134. XlinkWritable
  1135. XlinkRelative
  1136. RepSpec
  1137. Tenga en cuenta que las opciones --format y --xml son mutuamente
  1138. exclusivas, por lo que no se pueden utilizar simultáneamente.
  1139. Ejemplos:
  1140. cm fileinfo file1.txt file2.txt dir/
  1141. cm fileinfo "New Project.csproj" --xml
  1142. cm fileinfo assets.art --fields=ServerPath,Size,IsLocked,LockedBy
  1143. cm fileinfo proj_specs.docx --fields=ServerPath,RevisionChangeset --xml
  1144. cm fileinfo samples.ogg --format="{ServerPath}[{Owner}] -> {Size}"
  1145. == CMD_DESCRIPTION_FIND_QUERY ==
  1146. Obtiene una serie de objetos en base a unos criterios de búsqueda.
  1147. == CMD_USAGE_FIND_QUERY ==
  1148. Sintaxis:
  1149. cm find objeto [where str_condiciones]
  1150. [on repository 'repspec' | on repositories <'repspec'>+]
  1151. [--format=str_format] [--dateformat=date_format]
  1152. [--nototal] [--file=dump_file] [--xml] [--encoding=name]
  1153. cm find objeto [where condiciones] [on repositorios] [opciones]
  1154. objeto Objeto a buscar.
  1155. Lee la guía sobre'cm find' para ver los objetos que
  1156. puedes buscar:
  1157. https://www.plasticscm.com/documentation/cmfind/plastic-scm-version-control-query-system-guide.shtml
  1158. Opciones:
  1159. condiciones Condiciones de búsqueda sobre los atributos del objeto.
  1160. repspec Nombre o especificación del repositorio donde buscar.
  1161. En el caso de "repositories", debes separar las
  1162. especificaciones (repspec) por comas.
  1163. Usa 'cm help objectspec' para obtener más información
  1164. sobre las especificaciones de repositorios.
  1165. --format Devuelve el mensaje de salida en un formato determinado.
  1166. Lee la guía sobre 'cm find' para ver todos los atributos
  1167. de los objetos que puedes usar para formatear la salida:
  1168. https://www.plasticscm.com/documentation/cmfind/plastic-scm-version-control-query-system-guide.shtml
  1169. --dateformat Formato de las fechas. Por defecto "dd/MM/yyy HH:mm:ss".
  1170. --nototal No muestra el número total de registros.
  1171. --file Fichero en el que se vuelcan los resultados.
  1172. --xml Formatea salida como XML.
  1173. --encoding Especifica la codificación con la que se quiere mostrar
  1174. la salida del comando o escribir el fichero de
  1175. resultado, por ejemplo, utf-8.
  1176. Consulte la documentación de MSDN para obtener
  1177. la tabla completa de codificaciones soportadas y su
  1178. formato (al final de la página, en la columna "Name"):
  1179. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1180. == CMD_HELP_FIND_QUERY ==
  1181. Notas:
  1182. Si no se especifica ningún repositorio, la búsqueda se realiza sobre el
  1183. repositorio actual.
  1184. Cuando se ejecutan búsquedas desde la línea de comandos usando operadores de
  1185. comparación (>, <, >=, <=), el intérprete de comandos (o shell) considera a
  1186. estos operadores como redirecciones de E/S. Por lo que es necesario escribir
  1187. la búsqueda entre dobles comillas.
  1188. El comando cm find acepta una cadena de formato para mostrar la salida.
  1189. Cada parámetro de salida se identifica con un nombre, y el usuario se
  1190. puede referir a él escribiéndolo entre los símbolos '{' y '}'.
  1191. Los parámetros de salida se corresponden en la mayoría de los casos con
  1192. los atributos del objeto.
  1193. Estas son cadenas de formato válidas:
  1194. --format={id}{date}{name}
  1195. --format="{item}#{branch} con fecha {date}"
  1196. Consideraciones sobre XML y codificación (encoding):
  1197. Cuando se especifica la opción --xml, se muestra por consola el resultado
  1198. como un texto XML. Por defecto se utiliza la codificación estándar del
  1199. sistema operativo. Es posible que si hay caracteres extraños (tildes o
  1200. eñes), no se visualicen correctamente en la consola. Pero si se redirige la
  1201. salida a un fichero, el contenido se visualizará correctamente.
  1202. Cuando se especifican simultáneamente las opciones --xml y --file, se
  1203. utiliza por defecto la codificación UTF-8.
  1204. Ejemplos:
  1205. cm find revision
  1206. cm find revision "where changeset = 23 and owner = 'user'"
  1207. cm find branch "on repository 'rep1'"
  1208. cm find label "on repositories 'rep1', 'rep:default@localhost:8084'"
  1209. cm find branch "where parent = 'br:/main' on repository 'rep1'"
  1210. cm find revision "where item = 'item:.'" --format="{item}#{branch}"
  1211. cm find revision "where item = 'item:.'" --xml --file=c:\queryresults\revs.xml
  1212. == CMD_DESCRIPTION_FINDCHANGED ==
  1213. Obtiene una lista de los ficheros que se han modificado fuera del control de
  1214. Plastic SCM. Este comando se considera obsoleto y se mantiene únicamente por
  1215. retrocompatibilidad. Reemplazado por cm status.
  1216. == CMD_USAGE_FINDCHANGED ==
  1217. fuera del control de Plastic
  1218. Sintaxis:
  1219. cm findchanged [opciones][ruta]
  1220. ruta: Ruta inicial de búsqueda.
  1221. Opciones:
  1222. -R|-r|--recursive Descender recursivamente dentro de directorios.
  1223. --checkcontent Comparar los ficheros por el contenido.
  1224. --onlychanged Con esta opción los elementos desprotegidos no serán
  1225. devueltos entre los cambiados.
  1226. == CMD_HELP_FINDCHANGED ==
  1227. Notas:
  1228. El comando findchanged se utiliza para identificar los items que se han
  1229. modificado en el espacio de trabajo. Si no se utiliza opción
  1230. –checkcontent solamente se comparan los timestamp para obtener los ficheros
  1231. cambiados. Si se utiliza la opción –checkcontent, se compara el contenido del
  1232. fichero.
  1233. Cuando por alguna razón no podemos obtener conexión con el servidor y se
  1234. trabaja desconectado, y se modifica una serie de ficheros, se puede utilizar
  1235. este comando para identificar los elementos cambiados.
  1236. Ejemplos:
  1237. cm findchanged .
  1238. cm findchanged -R . | cm checkout - (desprotege los elementos cambiados)
  1239. == CMD_DESCRIPTION_FINDCHECKEDOUT ==
  1240. Obtiene un listado de desprotecciones pendientes. Este comando está deprecado y
  1241. se mantiene únicamente por retrocompatibilidad. Reemplazado por cm status.
  1242. == CMD_USAGE_FINDCHECKEDOUT ==
  1243. Sintaxis:
  1244. cm findcheckouts [opciones]
  1245. Opciones:
  1246. --all: Muestra desprotecciones de todos los usuarios.
  1247. --format=cadena: Cadena de formato de salida.
  1248. Ver notas para más información.
  1249. == CMD_HELP_FINDCHECKEDOUT ==
  1250. Notas:
  1251. Este comando se utiliza para encontrar las protecciones pendientes en un
  1252. espacio de trabajo. Se puede combinar con el comando 'checkin' para
  1253. proteger todos los elementos desprotegidos, utilizando la redirección de
  1254. la salida estándar. Vea los ejemplos para más información.
  1255. Este comando acepta una cadena de formato para mostrar la salida.
  1256. Cada parámetro de salida se identifica con un número, y el usuario se puede
  1257. referir a él escribiéndolo entre los símbolos '{' y '}'.
  1258. Los parámetros de salida de este comando son los siguientes:
  1259. 0: Fecha de modificación.
  1260. 1: Propietario.
  1261. 2: Información del espacio de trabajo.
  1262. 3: Máquina.
  1263. 4: Ruta del ítem.
  1264. 5: Información de repositorio y rama.
  1265. Éstas son cadenas de formato válidas:
  1266. --format={0}{1}{2}{3}{4}{5}
  1267. --format="El fichero {4} está desprotegido por el usuario {1}"
  1268. Ejemplos:
  1269. cm findcheckouts
  1270. cm findcheckouts --all
  1271. cm findcheckouts --format={4} | cm checkin -
  1272. (Protege todos los items desprotegidos)
  1273. cm findcheckouts --format={4} | cm uncheckout -
  1274. (Deshace las desprotecciones de todos los items desprotegidos)
  1275. == CMD_DESCRIPTION_FINDPRIVATE ==
  1276. Obtiene un listado de items privados en el espacio de trabajo. Este comando
  1277. está deprecado y se mantiene únicamente por retrocompatibilidad. Reemplazado
  1278. por cm status.
  1279. == CMD_USAGE_FINDPRIVATE ==
  1280. Sintaxis:
  1281. cm findprivate [opciones][ruta]
  1282. rutas: Ruta inicial de búsqueda.
  1283. Opciones:
  1284. -R|-r|--recursive Descender recursivamente dentro de directorios.
  1285. --exclusions Ignora los elementos excluidos.
  1286. == CMD_HELP_FINDPRIVATE ==
  1287. Notas:
  1288. Si no se proporciona una ruta, se tomará el directorio actual.
  1289. Este comando es útil para añadir solamente los elementos privados de una
  1290. ruta al repositorio, utilizando la redirección de la salida estándar.
  1291. Ver ejemplos.
  1292. Ejemplos:
  1293. cm findprivate .
  1294. cm findprivate -R | cm add - --coparent
  1295. (busca recursivamente items privados, y los añade al
  1296. repositorio desprotegiendo los padres si es necesario)
  1297. == CMD_DESCRIPTION_GETCONFIG ==
  1298. Obtiene la información de configuración solicitada.
  1299. == CMD_USAGE_GETCONFIG ==
  1300. Sintaxis:
  1301. cm getconfig setting
  1302. setting: Parámetro de configuración que se quiere consultar.
  1303. Los parámetros disponibles son:
  1304. setfileasreadonly : indica si los ficheros protegidos se dejan en sólo lectura.
  1305. location: devuelve la ruta del fichero de configuración del cliente.
  1306. extensionworkingmode: devuelve el modo de trabajo de la extensión.
  1307. extensionprefix: devuelve el prefijo de la extensión configurada.
  1308. defaultrepserver: devuelve el servidor de repositorios configurado por defecto.
  1309. Devuelve el valor de la clave solicitada.
  1310. == CMD_HELP_GETCONFIG ==
  1311. Ejemplos:
  1312. cm getconfig setfileasreadonly
  1313. == CMD_DESCRIPTION_GETFILE ==
  1314. Obtiene una revisión especificada.
  1315. == CMD_USAGE_GETFILE ==
  1316. Sintaxis:
  1317. cm cat spec [opciones]
  1318. spec: Especificación de la revisión. Usa 'cm help objectspec' para obtener
  1319. más información sobre especificaciones.
  1320. Opciones:
  1321. --file=fichero: Fichero de salida, opcional. Si no se especifica
  1322. el resultado, se escribe en la salida estándar.
  1323. --debug: Cuando se especifica la revisión de un directorio, el
  1324. comando muestra su id de revisión y sus permisos.
  1325. == CMD_HELP_GETFILE ==
  1326. Notas:
  1327. Una especificación de revisión se define como:
  1328. [rev:]RUTA[#(brSpec|csetSpec|lbSpec)][@repSpec]
  1329. [rev:]revid:rev_id[@repSpec]
  1330. [rev:]serverpath:ruta_de_servidor#(brSpec|csetSpec|lbSpec)[@repSpec]
  1331. brSpec: br:NOMBRE_RAMA[#LAST]
  1332. csetSpec: cs:NUMERO_CSET
  1333. lbSpec: lb:NOMBRE_ETIQUETA
  1334. repSpec: [rep:]NOMBRE_REPOSITORIO[@[repserver:]NOMBRE_SERVIDOR:PUERTO_SERVIDOR]
  1335. Ejemplos:
  1336. Obtener la última revisión de la rama main del ítem fichero.txt:
  1337. cm cat fichero.txt#br:/main
  1338. Obtener la revisión del changeset 3 del ítem fichero.txt y escribirlo en el
  1339. fichero tmp.txt:
  1340. cm cat fichero.txt#cs:3 --file=tmp.txt
  1341. Obtener la revisión id 1230:
  1342. cm cat revid:1230@rep:myrepos@repserver:london:8084
  1343. Obtener el fichero /src/foo.c en el último changeset de la rama
  1344. br:/main/task003 del repositorio 'myrepo':
  1345. cm cat serverpath:/src/foo.c#br:/main/task003@myrepo
  1346. == CMD_DESCRIPTION_GETREVISION ==
  1347. Trae una revisión especifica al espacio de trabajo actual
  1348. == CMD_USAGE_GETREVISION ==
  1349. Sintaxis:
  1350. cm getrevision revision_spec
  1351. revision_spec: Especificación de la revisión que se desea obtener. Usa
  1352. 'cm help objectspec' para obtener más información sobre especificaciones.
  1353. == CMD_HELP_GETREVISION ==
  1354. Notas:
  1355. Una especificación de revisión se define como:
  1356. [rev:]RUTA[#(brSpec|csetSpec|lbSpec)][@repSpec]
  1357. [rev:]revid:[#(brSpec|csetSpec|lbSpec)][@repSpec]
  1358. brSpec: br:NOMBRE_RAMA[#LAST]
  1359. csetSpec: cs:NUMERO_CSET
  1360. lbSpec: lb:NOMBRE_ETIQUETA
  1361. repSpec: [rep:]NOMBRE_REPOSITORIO[@[repserver:]NOMBRE_SERVIDOR:PUERTO_SERVIDOR]
  1362. Ejemplos:
  1363. cm getrevision fichero.txt#cs:3 (Establece la revisión del changeset 3 del
  1364. fichero.txt)
  1365. == CMD_DESCRIPTION_GETSTATUS ==
  1366. Obtiene el estado de un ítem.
  1367. == CMD_USAGE_GETSTATUS ==
  1368. Sintaxis:
  1369. cm getstatus [opciones] rutas
  1370. rutas: Rutas de los items sobre los que se desea consultar su estado.
  1371. Opciones:
  1372. -R|-r|--recursive Descender recursivamente dentro de directorios.
  1373. == CMD_HELP_GETSTATUS ==
  1374. Notas:
  1375. Los estados posibles de un ítem son los siguientes:
  1376. privado: El ítem no está controlado por Plastic SCM.
  1377. desprotegido: El ítem está desprotegido, y por tanto controlado por Plastic SCM.
  1378. protegido: El ítem está protegido, y por tanto controlado por Plastic SCM.
  1379. Ejemplos:
  1380. cm getstatus fichero1.txt fichero2.txt
  1381. == CMD_DESCRIPTION_GETTASKBRANCHES ==
  1382. Obtiene las ramas asociadas con la tarea especificada.
  1383. == CMD_USAGE_GETTASKBRANCHES ==
  1384. Sintaxis:
  1385. cm gettaskbranches tarea [opciones]
  1386. tarea: el identificador de la tarea.
  1387. Opciones:
  1388. --format=cadena: Cadena de formato de salida.
  1389. --dateformat: Formato de las fechas.
  1390. == CMD_HELP_GETTASKBRANCHES ==
  1391. Notas:
  1392. Este comando admite una cadena de formato para mostrar la salida.
  1393. Los parametros de salida de este comando son los siguientes:
  1394. tab: Introduce un tabulador.
  1395. newline: Introduce una nueva línea.
  1396. name: El nombre de la rama.
  1397. owner: El propietario de la rama.
  1398. date: La fecha en la que fue creada la rama.
  1399. type: El tipo de la rama ('T' si es smart o 'F' si no lo es).
  1400. parent: La rama padre.
  1401. comment: El comentario de la rama.
  1402. repname: El repositorio donde se encuentra la rama.
  1403. repserver: El nombre del servidor.
  1404. Ejemplos:
  1405. cm gtb 4311
  1406. cm gtb 4311 --format="br:{name}"
  1407. cm gtb 4311 --format="br:{name} {date}" --dateformat="yyyy/MM/dd HH:mm:ss"
  1408. == CMD_DESCRIPTION_GETWWI ==
  1409. Muestra información acerca del selecetor del espacio de trabajo.
  1410. == CMD_USAGE_GETWWI ==
  1411. Uso:
  1412. cm wi [ruta_workspace]
  1413. ruta_workspace: Ruta en disco del workspace a consultar.
  1414. == CMD_HELP_GETWWI ==
  1415. Notas:
  1416. Este comando muestra información acerca de la configuración del selector
  1417. del espacio de trabajo (en qué repositorio, rama y etiqueta se está
  1418. trabajando).
  1419. Ejemplos:
  1420. cm wi c:\mywk
  1421. == CMD_DESCRIPTION_GWP ==
  1422. Obtiene información acerca del workspace a partir de un path.
  1423. == CMD_USAGE_GWP ==
  1424. Uso:
  1425. cm getworkspacefrompath | gwp <ruta> [--format=str_format]
  1426. ruta Fichero o directorio en disco.
  1427. Opciones:
  1428. --format Devuelve el mensaje de salida con un formato determinado.
  1429. Más información en las notas.
  1430. == CMD_HELP_GWP ==
  1431. Notas:
  1432. Este comando muestra por pantalla información del workspace al que
  1433. pertenece una ruta determinada.
  1434. Este comando acepta una cadena especificando el formato con el que se
  1435. debe mostrar la salida. Los parámetros de salida son los siguientes:
  1436. {0} | {wkname} Nombre del workspace.
  1437. {1} | {wkpath} Ruta del workspace.
  1438. {2} | {machine} Nombre de la máquina del workspace.
  1439. {3} | {owner} Propietario del workspace.
  1440. {4} | {guid} GUID del workspace.
  1441. {tab} Inserta un tabulador.
  1442. {newline} Inserta un salto de línea.
  1443. Ejemplos:
  1444. cm gwp c:\myworkspace\code\file1.cpp --format="Nombre del wkspace: {wkname}"
  1445. == CMD_DESCRIPTION_HELP ==
  1446. Muestra ayuda acerca de un comando.
  1447. == CMD_USAGE_HELP ==
  1448. Sintaxis:
  1449. cm help nombre_comando
  1450. == CMD_HELP_HELP ==
  1451. == CMD_DESCRIPTION_IOSTATS ==
  1452. Muestra estadísticas de rendimiento relativas al hardware
  1453. == CMD_USAGE_IOSTATS ==
  1454. Sintaxis:
  1455. cm iostats [server_spec] list_of_tests [options]
  1456. server_spec: Servidor válido de PlasticSCM para ejecutar las pruebas de red,
  1457. tales como "serverUploadTest" y/o "serverDownloadTest".
  1458. Si no se especifica ningún parámetro, se intentará usar el servidor
  1459. configureado por defecto.
  1460. Usa 'cm help objectspec' para aprender cómo indicar la especificación
  1461. del servidor.
  1462. list_of_tests: Test disponibles:
  1463. --serverUploadTest: mide la velocidad de subida de datos a través de la
  1464. red desde el cliente de Plastic SCM al servidor.
  1465. --serverDownloadTest: mide la velocidad de bajada de datos a través de
  1466. la red desde el servidor de Plastic SCM al cliente.
  1467. --diskTest: mide la velocidad de escritura y lectura a disco.
  1468. --systemNetworkUsage: muestra el uso actual de los recursos de red del
  1469. sistema. (Se usan contadores de rendimiento del sistema operativo).
  1470. (Sólo disponible en plataformas Windows).
  1471. --systemDiskUsage: muestra el uso actual de los discos físico del
  1472. sistema. (Se usan contadores de rendimiento del sistema operativo).
  1473. (Sólo disponible en plataformas Windows).
  1474. Opciones (options):
  1475. --netTotalMB: cantidad de datos de usuario (en MegaBytes) que se
  1476. transmitirán en un test de red, tales como"serverDownloadTest"
  1477. o "serverUploadTest".
  1478. Debe ser un valor comprendido entre "4" y "512" (por defecto: 16).
  1479. --networkIterations: indica el número de iteraciones para los tests de red:
  1480. "serverUploadTest" o "serverDownloadTest".
  1481. Debe ser un valor comprendido entre "1" y "100". (por defecto: 1).
  1482. --diskDataSize: cantidad de datos (en MegaBytes) que se escribirán y leerán
  1483. en el test de disco ("diskTest").
  1484. Debe ser un valor comprendido entre "100" y "4096". (por defecto: 512).
  1485. --diskTestPath: Ruta donde el test de disco escribe los datos para la
  1486. realización de la prueba. Si no se especifica ningún parámetro, se
  1487. intentará usar un directorio dentro del directorio temporal del sistema.
  1488. --systemDisplayTime: Espacio de tiempo (en segundos) en el que se muestra el uso
  1489. de los recursos del sistema. Éste parámetro es tenido en cuenta para los tests:
  1490. "systemNetworkUsage" y "systemDiskUsage".
  1491. Debe ser un valor comprendido entre "1" y "3600". (por defecto: 5 segundos).
  1492. --systemDisplayTimeInterval: Periodo de tiempo (en segundos) entre las muestras
  1493. que se toman sobre el uso de los recursos del sistema. Este parámetro
  1494. es tenido en cuenta para los tests: "systemNetworkUsage" y "systemDiskUsage".
  1495. Debe ser un valor comprendido entre "1" y "60". (por defecto: 1 segundo).
  1496. Ejemplo:
  1497. cm iostats MYSERVER:8087 --serverUploadTest --serverDownloadTest --netTotalMB=32
  1498. == CMD_HELP_IOSTATS ==
  1499. Notas:
  1500. Éste comando necesita un servidor de Plastic SCM que se usará para las
  1501. pruebas de velocidad de la red ("serverUploadTest" y/o
  1502. "serverDownloadTest").
  1503. El parámetro "--diskTestPath" debe apuntar a una ruta que pertenezca a la
  1504. unidad física de disco que se pretende probar.
  1505. Si no se especifica ninguna ruta, el comando intentará utilizar la ruta
  1506. de almacenamiento temporal del sistema.
  1507. La unidad de disco del directorio de pruebas de disco debe contener suficiente
  1508. espacio libre para ejecutar la prueba.
  1509. Durante la ejecución del comando se puede experimentar una caída de rendimiento
  1510. de la máquina debido a las pruebas realizadas.
  1511. == CMD_DESCRIPTION_ISSUETRACKER ==
  1512. Obtiene, actualiza o busca el estado de una tarea del sistema de incidencias especificado.
  1513. == CMD_USAGE_ISSUETRACKER ==
  1514. Sintaxis:
  1515. cm issuetracker <name> status get <task_id> <parameter>+
  1516. cm issuetracker <name> status update <task_id> <status> <parameter>+
  1517. cm issuetracker <name> status find <status> <parameter>+
  1518. cm issuetracker <name> connection check <parameter>+
  1519. name: Nombre del sistema de seguimiento de incidencias contra
  1520. el que se va a conectar.
  1521. Sólo Jira está soportado por el momento.
  1522. task_id: Número de la tarea que se quiere consultar o actualizar.
  1523. status: Un estado de tarea válido en el sistema especificado.
  1524. Parámetros de Jira (son todos obligatorios):
  1525. --user=user El usuario a autenticar.
  1526. --password=pwd La contraseña a autenticar.
  1527. --host=url La url del sistema de seguimiento de incidencias.
  1528. --projectkey=clave La clave del proyecto en Jira.
  1529. == CMD_HELP_ISSUETRACKER ==
  1530. Ejemplos:
  1531. cm issuetracker jira status get 11 --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
  1532. (Obtiene el estado de la tarea 11 para el proyecto PRJ)
  1533. cm issuetracker jira status update 11 "Done" --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
  1534. (Actualiza el estado a "Done" de la tarea 11 para el proyecto PRJ)
  1535. cm issuetracker jira status find "Done" --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
  1536. (Obtiene los ids de tarea cuyo estado es "Done" para el proyecto PRJ)
  1537. cm issuetracker jira connection check --user=user@mail.es --password=pwd --host=https://user.atlassian.net
  1538. (Comprueba si los parámetros de configuración son válidos o no)
  1539. == CMD_DESCRIPTION_LICENSEINFO ==
  1540. Muestra información de la licencia y de su uso.
  1541. == CMD_USAGE_LICENSEINFO ==
  1542. Sintaxis:
  1543. cm licenseinfo | li [--server=repserverspec] [--inactive] [--active] [--sort={name|status}]
  1544. Opciones:
  1545. --server: Obtiene la información de la licencia para el servidor
  1546. especificado. Si no se especifica ningún servidor, el
  1547. comando se ejecutará contra el servidor configurado en
  1548. el cliente.
  1549. Usa 'cm help objectspec' para obtener más información
  1550. sobre especificaciones.
  1551. --inactive Muestra únicamente usuarios inactivos en la sección de
  1552. "uso de licencia".
  1553. --active Muestra únicamente usuarios activos en la sección de
  1554. "uso de licencia".
  1555. --sort Ordena usuarios usando el campo especificado:
  1556. 'name' o 'status'.
  1557. == CMD_HELP_LICENSEINFO ==
  1558. Notas:
  1559. Se muestra información acerca de la fecha de expiración, los usuarios
  1560. activos y no activos, etc.
  1561. Ejemplos:
  1562. cm licenseinfo
  1563. cm licenseinfo --server=myserver:8084
  1564. == CMD_DESCRIPTION_LINKTASK ==
  1565. Enlaza un changeset a tareas pertenecientes a un control de tareas.
  1566. == CMD_USAGE_LINKTASK ==
  1567. Sintaxis:
  1568. cm linktask changesetSpec extensionPrefix taskKey
  1569. changesetSpec: Especificación completa del changeset para ser enlazado a una
  1570. tarea en el sistema de control de tareas. Usa 'cm help objectspec' para
  1571. obtener más información sobre especificaciones.
  1572. extensionPrefix: Prefijo del sistema de control de tareas configurado.
  1573. taskKey: Identificador de la tarea para asociar al changeset especificado.
  1574. == CMD_HELP_LINKTASK ==
  1575. Ejemplos:
  1576. cm lt cs:8@rep:default@repserver:localhost:8084 jira PRJ-1
  1577. == CMD_DESCRIPTION_LOCK_LIST ==
  1578. Muestra los elementos bloqueados (checkouts exclusivos) en el servidor especificado.
  1579. == CMD_USAGE_LOCK_LIST ==
  1580. Sintaxis:
  1581. cm lock list [revspec [revspec ...]] [flags]
  1582. revspec: especificación de revisión. Usa 'cm help objectspec' para aprender
  1583. cómo indicar las especificaciones de las revisiones.
  1584. Opciones:
  1585. flags:
  1586. --server=<server>: muestra los elementos bloqueados en el
  1587. servidor, sobreescribiendo el valor por defecto (tomado del espacio
  1588. de trabajo actual o del fichero client.conf).
  1589. Usa 'cm help objectspec' para más información sobre especificaciones.
  1590. --onlycurrentuser: Filtra los resultados mostrando únicamente los
  1591. bloqueos efectuados por el usuario actual de Plastic SCM.
  1592. --onlycurrentworkspace: Filtra los resultados mostrando únicamente los
  1593. bloqueos efectuados en el espacio de trabajo actual. (Se cotejan
  1594. los resultados por nombre de espacio de trabajo).
  1595. --ignorecase: Ignora mayúsculas y minúsculas cuando una servepath spec
  1596. es usada. Con esta opción el comando funcionará para "/src/foo.c"
  1597. incluso si el usuario indica"/sRc/fOO.c".
  1598. == CMD_HELP_LOCK_LIST ==
  1599. Ejemplos:
  1600. cm lock list
  1601. cm lock ls --server=DIGITALIS:8084
  1602. cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
  1603. cm lock ls revid:3521@default itemid:2381@secondary --onlycurrentuser
  1604. cm lock ls --onlycurrentuser
  1605. cm lock ls --onlycurrentuser --onlycurrentworkspace
  1606. Notas:
  1607. El comando muestra una lista de los elementos actualmente bloqueados en el
  1608. servidor por defecto. También acepta una lista de especificaciones de
  1609. revisión; en ese caso, solo se mostrarán los elementos bloqueados que
  1610. estén asociados a al menos una de las revisiones especificadas como
  1611. argumentos del comando. Adicionalmente, se puede utilizar el parámetro
  1612. opcional --server=<server> para modificar el servidor que se
  1613. consultará por defecto.
  1614. El comando muestra una línea por cada bloqueo almacenado en el servidor,
  1615. con la siguiente información:
  1616. GUID del elemento bloqueado.
  1617. Nombre de usuario que realizó el bloqueo.
  1618. Ruta del elemento bloqueado (formato de ruta de servidor).
  1619. Nombre del espacio de trabajo donde se realizó el bloqueo.
  1620. == CMD_DESCRIPTION_LISTUSERS ==
  1621. Lista los usuarios y grupos conocidos por el servidor.
  1622. == CMD_USAGE_LISTUSERS ==
  1623. Sintaxis:
  1624. cm listusers server [opciones]
  1625. server: especificación del servidor de repositorios.
  1626. Usa 'cm help objectspec' para más información sobre especificaciones.
  1627. Opciones:
  1628. --onlyusers (-u): Lista sólo los usuarios.
  1629. --onlygroups (-g): Lista sólo los grupos.
  1630. --filter : Lista sólo aquellos usuarios y/o grupos que coincidan con el
  1631. filtro de busqueda indicado.
  1632. == CMD_HELP_LISTUSERS ==
  1633. Ejemplos:
  1634. cm listusers localhost:8084
  1635. cm listusers localhost:8084 -u
  1636. == CMD_DESCRIPTION_LOCATION ==
  1637. Muestra la ruta completa donde se ubica el ejecutable del cliente.
  1638. == CMD_USAGE_LOCATION ==
  1639. Sintaxis:
  1640. cm location
  1641. == CMD_HELP_LOCATION ==
  1642. == CMD_DESCRIPTION_LOCK ==
  1643. Use este comando para administrar workspaces.
  1644. == CMD_USAGE_LOCK ==
  1645. Sintaxis:
  1646. cm lock command [options]
  1647. Comandos:
  1648. list | ls
  1649. unolck
  1650. Para obtener más información sobre cada comando:
  1651. cm lock comando --usage
  1652. cm lock comando --help
  1653. == CMD_HELP_LOCK ==
  1654. Ejemplos:
  1655. cm lock list
  1656. cm lock
  1657. (list es opcional si no hay argumentos)
  1658. cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
  1659. cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
  1660. == CMD_DESCRIPTION_LOG ==
  1661. Devuelve información sobre las revisiones creadas en la rama del changeset
  1662. especificado, o de un intervalo de changesets.
  1663. == CMD_USAGE_LOG ==
  1664. Sintaxis:
  1665. cm log [repSpec|csSpec] [--from|-f=csSpecFrom] [--allbranches|-a]
  1666. [--csFormat=format] [--itemFormat=format] [--xml[=outputfile]]
  1667. [--encoding] [--repositorypaths | --fullpaths]
  1668. repSpec: Especificación del repositorio del cual se obtendrá información de
  1669. las revisiones en sus changesets. Usa 'cm help objectspec' para más información.
  1670. csSpec: Especificación del changeset del cual se obtendrá la información de
  1671. sus revisiones. Usa 'cm help objectspec' para más información.
  1672. Opciones:
  1673. --from, -f=csSpecFrom: Especificación del changeset a partir del cual se
  1674. mostrará información de revisiones. Dicho changeset no se incluye en la
  1675. salida. Ignorado si se indica una especificación de un repositorio.
  1676. --allbranches, -a: Muestra información de los changesets creados en un
  1677. intervalo especificado para cualquier rama.
  1678. --ancestors: muestra la información acerca de los changesets alcanzables
  1679. siguiendo los enlaces de parentesco y de merge para el changeset dado
  1680. ([csSpec]). Si el changeset from ([csSpecFrom]) también es proporcionado,
  1681. este será usado como límite inferior para todos los paths.
  1682. Notas: los cambios de los changeset no se mostrarán con esta opción.
  1683. --csFormat=format: Especificación del formato en el cual se desea obtener
  1684. la información de los changesets.
  1685. --itemFormat=format: Especificación del formato en el cual se desea obtener
  1686. la información de los items involucrados en cada changeset.
  1687. --xml: Permite volcar la salida del comando en formato xml a la salida
  1688. estándar. También se permite especificar un fichero de salida
  1689. (--xml=output.xml).
  1690. --fullpaths, --fp: Fuerza al comando a imprimir rutas de workspace
  1691. absolutas siempre que sea posible.
  1692. --repositorypaths: imprime rutas de repositorio en lugar de rutas
  1693. de workspace. (Ésta opción prevalece sobre la opción "--fullpaths").
  1694. --encoding: si se utiliza con la opción --xml, permite especificar el
  1695. encoding con el que se guardará la salida del comando. Consulte la
  1696. documentación de la MSDN para obtener la tabla completa de codificaciones
  1697. soportadas y su formato; al final de la página en la columna "Name":
  1698. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1699. == CMD_HELP_LOG ==
  1700. Notas:
  1701. Si no se especifica ni changeset ni opción, mostrará información de todos
  1702. los changeset creados en el último mes en cualquier rama.
  1703. Si solamente se incluye la opción -f=[csSpecFrom], se mostrará la
  1704. información de todos los changesets desde el especificado hasta el momento
  1705. actual en la rama en la cual se creó dicho changeset.
  1706. Si se especifica la opción -a sin un intervalo, a todos los efectos el
  1707. comando funcionará exactamente igual que si solamente se especificara
  1708. [csSpec].
  1709. Si se utiliza la opción -f=[csSpecFrom], la salida muestra información
  1710. desde el changeset [csSpecFrom]+1 en adelante.
  1711. El repositorio que se utiliza para mostrar la información de los changesets
  1712. es el repositorio cargado en el path desde el cual se lanza el comando.
  1713. Este comando acepta una cadena de formato para mostrar la salida.
  1714. Se puede especificar un formato para la información de los changeset y
  1715. otro para la información de los ítems.
  1716. Cada parámetro de salida se identifica con un descriptor, y el usuario se
  1717. puede referir a él escribiéndolo entre los símbolos '{' y '}'.
  1718. Los parámetros de salida de este comando son los siguientes:
  1719. csFormat=
  1720. tab: Introduce un tabulador.
  1721. newline: Introduce una nueva línea.
  1722. changesetid: Número de changeset.
  1723. branch: Información de rama.
  1724. date: Fecha de creación del changeset.
  1725. owner: Propietario del changeset.
  1726. comment: Comentarios del changeset.
  1727. items: Items afectados en el changeset.
  1728. repository: Nombre del repositorio donde se encuentra el changeset.
  1729. repserver: Nombre del servidor.
  1730. itemFormat=
  1731. tab: Introduce un tabulador.
  1732. newline: Introduce una nueva línea.
  1733. path: Ruta del ítem en disco.
  1734. branch: Información de rama.
  1735. owner: Propietario del changeset.
  1736. date: Fecha de creación del changeset.
  1737. shortstatus: Formato corto. Ver más abajo.
  1738. fullstatus: Formato largo. Ver más abajo.
  1739. Formato corto y su correspondiente formato largo:
  1740. A = Added.
  1741. C = Changed.
  1742. M = Moved.
  1743. D = Deleted.
  1744. Éstas son cadenas de formato válidas:
  1745. --csFormat="{newline}Changeset {changesetid} generado el día {date};{tab} ítems cambiados: {items}."
  1746. --itemFormat="{newline}El ítem {path} se ha cambiado en la rama {branch} en el changeset {changesetid}."
  1747. Ejemplos:
  1748. cm log
  1749. (Muestra información de todos los changesets creados en el último mes en
  1750. cualquier rama).
  1751. cm log cs:16
  1752. (Muestra la información de los cambios realizados en el changeset 16 en la
  1753. rama en que se creó dicho changeset).
  1754. cm log cs:16 --csFormat="{newline}Changeset {changesetid} generado el día {date};{tab} ítems cambiados: {items}."
  1755. (Muestra la información el el formato especificado).
  1756. cm log --from=cs:20 cs:50
  1757. (Muestra información de todos los cambios de cada changeset comprendido
  1758. entre el 21 y el 50 en la rama br:/main).
  1759. cm log --from=cs:20 cs:50 -a
  1760. (Muestra información de todos los cambios de cada changeset comprendido
  1761. entre el 21 y el 50 en todas las ramas del repositorio).
  1762. cm log rep:myrep@localhost:8084
  1763. (Muestra la información de todos los changeset de otro repositorio diferente
  1764. al configurado en el selector del workspace. Puede ejecutarse fuera de
  1765. un workspace).
  1766. == CMD_DESCRIPTION_LS ==
  1767. Lista el contenido de un workspace o de un árbol de changeset, rama o selector.
  1768. == CMD_USAGE_LS ==
  1769. Sintaxis:
  1770. cm ls [opciones][rutas]
  1771. rutas: Rutas de los items para obtener el listado.
  1772. Opciones:
  1773. --format=cadena: cadena de formato
  1774. --symlink: aplica la operación al propio symlink y no a su destino
  1775. --selector: obtiene el contenido del selector del workspace actual
  1776. --selector="selector": obtiene el contenido del selector especificado
  1777. --tree=spec: lista el árbol de un changeset (a partir de su número o guid)
  1778. o de una rama (a partir de su nombre completo). Usa 'cm help objectspec'
  1779. para aprender cómo indicar una especificación.
  1780. -R|-r|--recursive: recorre los directorios recursivamente
  1781. --xml: Permite volcar la salida del comando en formato xml a la salida
  1782. estándar. También se permite especificar un fichero de salida
  1783. (--xml=output.xml).
  1784. --encoding: si se utiliza con la opción --xml, permite especificar el
  1785. encoding con el que se guardará la salida del comando. Consulte la
  1786. documentación de la MSDN para obtener la tabla completa de codificaciones
  1787. soportadas y su formato; al final de la página en la columna "Name":
  1788. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  1789. == CMD_HELP_LS ==
  1790. Notas:
  1791. Las rutas se pueden escribir con metacaracteres (*, ?, ...)
  1792. La salida del comando 'ls' se puede formatear usando una 'cadena de formato'
  1793. en la cual cada parámetro se identifica mediante un nombre (o un número para
  1794. mantener compatibilidad con las versiones anteriores).
  1795. La cadena de formato por defecto es:
  1796. "{<size>,10} {<date>:dd/MM/yyyy} {<date>:HH:mm} \
  1797. {<type>,-6} {<location>,-12} {<co>,-5} \
  1798. {name} {symlinktarget}"
  1799. También se pueden especificar los nombres como {nombre} para cadenas de
  1800. formato más sencillas:
  1801. "{size} {date} {name}"
  1802. Los nombres de los parámetros válidos para la cadena de formato son:
  1803. size 0
  1804. date 1
  1805. type 2
  1806. location 3 imprime br:branch#cset
  1807. checkout 4
  1808. co 4
  1809. name 5
  1810. changeset 6
  1811. cset 6
  1812. fullpath 7
  1813. path 7
  1814. repspec 8
  1815. owner 9
  1816. formattedsize 10
  1817. revid 11
  1818. parentrevid 12
  1819. itemid 13
  1820. brid 14
  1821. repid 15
  1822. server 16
  1823. symlinktarget 17
  1824. hash 18
  1825. chmod 19
  1826. wkpath 20 imprime un path relativo a la raíz del workspace
  1827. branch 21
  1828. newlocation 22 imprime cset@branch
  1829. guid 23 imprime el guid de cada elemento (tarda más tiempo)
  1830. itemguid 24
  1831. transformed 25 muestra las reglas aplicadas en cada elemento que
  1832. haya sufrido transformación.
  1833. Se puede personalizar la salida del comando ls sin necesidad de especificar
  1834. --format cada vez, definiendo la variable de entorno PLASTIC_LS_FORMAT.
  1835. Ejemplos:
  1836. cm ls
  1837. cm ls c:\workspace\src
  1838. cm ls --format={name} (muestra nombres de ficheros y directorios)
  1839. cm ls --symlink (muestra información de los symlinks y no del fichero o
  1840. directorio al que apunta. Disponible en entornos Linux/Mac/Unix)
  1841. cm ls code --selector (muestra el contenido del subdirectorio 'code' cargado
  1842. del selector asociado al workspace actual)
  1843. cm ls /code --selector="rep 'arevalo' path '/' branch '/main'" (muestra el
  1844. contenido del subdirectorio '/code' cargado del selector especificado.
  1845. Es importante destacar que el path se especifica en "formato servidor")
  1846. cm ls /code --tree=44@arevalo@cyl:7070 (lista el contenido del
  1847. subdirectorio /code en el changeset 44 del repositorio 'arevalo' en el
  1848. servidor 'cyl:7070')
  1849. cm ls /code --tree=br:/main/scm13596@arevalo@cyl:7070 (lista el contenido del
  1850. subdirectorio /code en el último changeset de la rama /main/scm13596
  1851. del repositorio 'arevalo' en el servidor 'cyl:7070')
  1852. cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@arevalo@cyl:7070
  1853. (lista el subdirectorio /code en el changeset con guid
  1854. ae1390ed-7ce9-4ec3-a155-e5a61de0dc77
  1855. en el repositorio 'arevalo' del servidor 'cyl:7070')
  1856. == CMD_DESCRIPTION_TRIGGER_LIST ==
  1857. Muestra la información relativa a los triggers de un determinado tipo.
  1858. == CMD_USAGE_TRIGGER_LIST ==
  1859. Sintaxis:
  1860. cm trigger list [subtipo-tipo] [opciones]
  1861. subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
  1862. Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
  1863. trigger disponibles. Algunos ejemplos son:
  1864. before-mkbranch
  1865. after-mkwokspace
  1866. after-setselector
  1867. Opciones:
  1868. --server=servidor: Lista los triggers del servidor especificado.
  1869. --format: formato de salida.
  1870. == CMD_HELP_TRIGGER_LIST ==
  1871. Notas:
  1872. Si no se especifica tipo, muestra todos los triggers del servidor
  1873. configurado en el cliente.
  1874. Formato de salida:
  1875. {0}: Posición.
  1876. {1}: Nombre del trigger.
  1877. {2}: Ruta del ejecutable.
  1878. {3}: Propietario.
  1879. {4}: Tipo.
  1880. {5}: Filtro del trigger.
  1881. Ejemplos:
  1882. cm trigger list after-mklabel
  1883. cm tr ls before-mkbranch --server=myserver:8084
  1884. == CMD_DESCRIPTION_MANIPULATESELECTOR ==
  1885. Permite cambiar el selector para reflejar cambios en los comandos.
  1886. == CMD_USAGE_MANIPULATESELECTOR ==
  1887. Uso:
  1888. cm manipulateselector [wkpath | wkspec] [options]
  1889. path: Ruta del espacio de trabajo.
  1890. wkspec: Especificación del espacio de trabajo. Usa 'cm help objectspec'
  1891. para más información sobre especificaciones.
  1892. Opciones:
  1893. --atdate=date: Devuelve un selector que recreará el espacio de trabajo con
  1894. los contenidos que se cargarían en la fecha especificada.
  1895. == CMD_HELP_MANIPULATESELECTOR ==
  1896. Notas:
  1897. Si no se indica alguna de las rutas o especificaciones de espacio de
  1898. trabajo el comando supondrá el directorio actual como ruta al espacio de
  1899. trabajo.
  1900. Ejemplos:
  1901. cm manipulateselector c:\workspace --atdate=yyyy-MM-ddTHH:mm:ss
  1902. cm manipulateselector --atdate=yyyy-MM-ddTHH:mm:ss
  1903. cm manipulateselector > mySelector.txt --atdate=yyyy-MM-ddTHH:mm:ss
  1904. cm manipulateselector wk:build_wk@BUILDER --atdate=yyyy-MM-ddTHH:mm:ss
  1905. == CMD_DESCRIPTION_MERGE ==
  1906. Mezcla el contenido de una rama con otra.
  1907. == CMD_USAGE_MERGE ==
  1908. Sintaxis:
  1909. cm merge spec_origen [--merge] [--cherrypicking] [--forced]
  1910. [--mergetype=merge_type]
  1911. [--interval-origin=csetspec | --ancestor=csetspec]
  1912. [--keepsource | --ks] [--keepdestination | --kd]
  1913. [--automaticresolution=<conflict-types>+]
  1914. [--subtractive] [--mount] [--printcontributors]
  1915. [--noprintoperations] [--silent]
  1916. [(--to=brspec | --destination=brspec) [--shelve]]
  1917. [-c=str_comment | --commentsfile=<comments_file>]
  1918. [--resolveconflict --conflict=index
  1919. --resolutionoption=src|dst|<rename --resolutioninfo=strname>
  1920. --mergeresultfile=path --solvedconflictsfile=path]
  1921. [--nointeractiveresolution]
  1922. [--machinereadable [--startlineseparator=sep]
  1923. [--endlineseparator=sep] [--fieldseparator=sep]]
  1924. spec_origen Especificación del origen del merge. Este puede ser:
  1925. - una rama: [br:]/nombre_rama
  1926. - una etiqueta: lb:nombre_etiqueta
  1927. - un changeset: cs:numero_changeset
  1928. - un shelve: sh:numero_shelve
  1929. Usa 'cm help objectspec' para más información sobre
  1930. especificaciones.
  1931. Opciones:
  1932. --merge Realiza el merge. Si no se especifica esta opción,
  1933. se muestran los conflictos encontrados.
  1934. --cherrypicking Realiza el merge de los cambios incluidos en los
  1935. changesets origen. Esta opción no se considera si
  1936. el origen del merge es una etiqueta.
  1937. --forced No comprueba si el origen y el destino ya están
  1938. conectados.
  1939. Esta opción solo es válida para el merge de intervalo
  1940. y para el cherrypicking.
  1941. --mergetype Especifica el tipo de merge. Puede ser uno de los
  1942. siguientes: onlyone, onlysrc, onlydst, try, forced.
  1943. --interval-origin Especificación del changeset que queremos que actúe
  1944. como origen del intervalo, de manera que el merge
  1945. introducirá los cambios realizados desde el
  1946. changeset común hasta el changeset especificado
  1947. como origen del merge.
  1948. --ancestor Alias para --interval-origin.
  1949. --keepsource Acepta todos los cambios del contribuidor origen
  1950. para elementos con conflictos.
  1951. --keepdestination Preserva los cambios del contribuidor destino
  1952. para elementos con conflictos.
  1953. --automaticresolution Opción para resolver conflictos de directorio. Esta
  1954. opción permite elegir si el contribuidor origen
  1955. (source) o el contribuidor destino (destination)
  1956. debe ser seleccionado automáticamente para
  1957. resolver el conflicto.
  1958. Debes especificar los tipos de conflictos separados
  1959. por punto y coma ";".
  1960. Más información en las notas.
  1961. --subtractive Se utiliza para quitar cambios ya introducidos en
  1962. el sistema, ya sea por un checkin o por un merge.
  1963. El parámetro que se pasa al comando (spec_origen)
  1964. es el origen desde donde se quieren eliminar los
  1965. cambios. Puede ser la especificación de un
  1966. changeset o de un intervalo de ellos. En el caso
  1967. de un intervalo de changesets, se utiliza la opción
  1968. --interval-origin para definir el origen del
  1969. intervalo.
  1970. --mount El punto de montaje del respositorio especificado.
  1971. --printcontributors Imprime los contribuidores (base, origen y destino).
  1972. --noprintoperations Resuelve las mezclas de manera silenciosa sin
  1973. mostrar información sobre la resolución.
  1974. --silent No muestra ninguna salida.
  1975. --to | --destination Realiza una operación de merge-to a la rama de
  1976. destino especificada, con resolución de conflictos
  1977. completa. Una mezcla "merge-to" (o mezcla sin
  1978. workspace) es una mezcla hecha en el lado del
  1979. servidor. Mientras que en mezclas normales el
  1980. destino es el workspace, en una operación de
  1981. "merge-to" se debe especificar el destino (por
  1982. eso se llama "to", 'hacia' en inglés).
  1983. En la siguiente página se puede encontrar más
  1984. información sobre esta funcionalidad:
  1985. https://www.plasticscm.com/download/help/mergeto
  1986. --shelve Crea un shelve con los cambios del resultado del
  1987. merge (incluida la trazabilidad) en lugar de crear
  1988. un changeset. Esta opción no es válida cuando el
  1989. origen del merge es un shelve. Esta opción sólo
  1990. está disponible para el merge en el lado del
  1991. servidor (merge-to). Por ello, se requieren las
  1992. opciones "--to" y "--merge".
  1993. --no-dst-changes Asegura que el contribuidor destino no tiene cambios
  1994. (que el changeset destino es también el antecesor
  1995. común). Cuando hay cambios en el destino, no se
  1996. permite hacer el merge.
  1997. -c Añade un comentario al changeset creado en la
  1998. operación de mezcla.
  1999. --commentsfile Carga el comentario del fichero especificado y lo
  2000. añade al changeset creado en la operación de
  2001. mezcla.
  2002. --resolveconflict (Usado principalmente por plugins. Más información
  2003. en las notas.)
  2004. Usado para resolver un conflicto de directorio.
  2005. --conflict Usado con '--resolveconflict', especifica el
  2006. índice del conflicto a resolver empezando por 1.
  2007. --resolutionoption Usado con '--resolveconflict', indica el tipo de
  2008. resolución de conflicto. Puede ser una de las
  2009. siguientes opciones: src, dst, rename.
  2010. Más información en las notas.
  2011. --resolutioninfo Usado con '--resolveconflict', proporciona el
  2012. nombre que se usará cuando la opción
  2013. '--resolutionoption' es "rename".
  2014. --mergeresultfile Usado con '--resolveconflict', guarda en un fichero
  2015. la información del resultado de la mezcla entre
  2016. diferentes llamadas. El fichero especificado se
  2017. crea durante la primera llamada y se actualiza en
  2018. cada siguiente llamada.
  2019. --solvedconflictsfile Usado con '--resolveconflict', guarda en un fichero
  2020. la información de los conflictos solucionados
  2021. entre diferentes llamadas. El fichero especificado
  2022. se crea durante la primera llamada y se actualiza
  2023. en cada siguiente llamada.
  2024. --nointeractiveresolution (Usado principalmente por plugins. Más información
  2025. en las notas.)
  2026. Evita preguntar al usuario cuando hay un conflicto
  2027. manual. Así, por ejemplo, un conflicto de directorio
  2028. no podrá ser resuelto.
  2029. --machinereadable (Usado principalmente por plugins. Más información
  2030. en las notas.)
  2031. Muestra la salida en un formato fácil de tratar.
  2032. --startlineseparator Usado con '--machinereadable', especifica cómo
  2033. deben comenzar las líneas. Por defecto, una cadena
  2034. de texto vacía.
  2035. --endlineseparator Usado con '--machinereadable', especifica cómo
  2036. deben terminar las líneas. Por defecto, una cadena
  2037. de texto vacía.
  2038. --fieldseparator Usado con '--machinereadable', especifica cómo
  2039. deben separarse los campos. Por defecto, un
  2040. espacio en blanco.
  2041. == CMD_HELP_MERGE ==
  2042. Notas:
  2043. Este comando se utiliza para meclar cambios entre dos ramas, o entre una
  2044. etiqueta y una rama. El destino del merge siempre debe ser una rama.
  2045. El origen del merge se especifica como argumento.
  2046. El destino de la rama es (salvo en el merge-to) el contenido actual del
  2047. workspace.
  2048. Por ejemplo, para mostrar los elementos que serán mezclados desde la rama
  2049. task001 a la rama principal, el selector debe apuntar a la rama principal,
  2050. el espacio de trabajo debe estar actualizado, y entonces ejecutar:
  2051. cm merge br:/task001
  2052. Para que el merge se realice, se añade el modificador "--merge":
  2053. cm merge br:/task001 --merge
  2054. El origen del merge es la especificación de un objeto (rama, etiqueta,
  2055. changeset o shelve).
  2056. Usa 'cm help objectspec' para más información sobre especificaciones.
  2057. Para resolver automáticamente conflictos de directorio debes usar la opción
  2058. "--automaticresolution" y especificar el tipo de conflicto seguido por el
  2059. contribuidor (origen o destino) que se seleccionará durante el merge.
  2060. (Recuerda separar cada par "tipo de conflicto"-"contribuidor" con punto y
  2061. coma (;).)
  2062. Por ejemplo:
  2063. cm merge cs:2634 --merge --automaticresolution=eviltwin-src;changedelete-src
  2064. (La operación de merge desde el changeset 2634 resuelve los conflictos
  2065. "eviltwin" y "changedelete" manteniendo al contribuidor origen ("-src")
  2066. en ambos conflictos.)
  2067. - El sufijo "-src" añadido después del tipo de conflicto indica al comando
  2068. merge que debe mantener los cambios del contribuidor origen (source).
  2069. - El sufijo "-dst" indicará que se mantendrán los cambios del contribuidor
  2070. destino (destination).
  2071. Esta es la lista de tipos de conflictos que soporta el comando merge:
  2072. "movedeviltwin", "eviltwin", "changedelete", "deletechange", "movedelete",
  2073. "deletemove", "loadedtwice", "addmove", "moveadd", "divergentmove",
  2074. "cyclemove", "all".
  2075. El valor "all" sobrescribe al resto de opciones. En el siguiente ejemplo,
  2076. el conflicto "eviltwin-dst" será ignorado:
  2077. cm merge br:/main/task062 --merge --automaticresolution=all-src;eviltwin-dst
  2078. Consulta el siguiente enlace para aprender más sobre conflictos de merge:
  2079. https://www.plasticscm.com/download/help/directorymerges
  2080. Estas son las opciones para el argumento --mergetype:
  2081. onlyone Merge automático si solo uno de los contribuidores modificó
  2082. el elemento.
  2083. onlysrc Merge automático si solo el contribuidor origen modificó
  2084. el elemento.
  2085. onlydst Merge automático si solo el contribuidor destino modificó
  2086. el elemento.
  2087. try Merge automático si solo un contribuidor ha modificado la
  2088. parte del fichero en conflicto (para cada conflicto).
  2089. forced Intentar resolver siempre los conflictos no automáticos.
  2090. Estas son las opciones que se usan principalmente por plugins e integraciones:
  2091. - "--resolveconflict" para resolver un conflicto de directorio. Se
  2092. deben usar las siguientes opciones:
  2093. - "--conflict" es el índice del conflicto que se quiere resolver
  2094. (empezando por 1).
  2095. - "--resolutionoption" indica el tipo de resolución de conflicto.
  2096. Puede ser:
  2097. - "src" para mantener el cambio del origen y descartar el
  2098. cambio del destino
  2099. - "dst" para mantener el cambio del destino y descartar el
  2100. cambio del origen
  2101. - "rename" (solo si el tipo de conflicto soporta esta
  2102. resolución), para renombar el destino al nombre
  2103. proporcionado en la opción "--resolutioninfo".
  2104. - "--resolutioninfo" para proporcionar el nombre a usar
  2105. con el tipo de resolución "rename"
  2106. - "--mergeresultfile" y "--solvedconflictsfile", ambos se usan
  2107. para guardar informacación de la mezcla entre las diferentes
  2108. llamadas.
  2109. - "nointeractiveresolution" indica a la mezcla que no pregunte al usuario
  2110. en caso de necesitarse una resolución manual de un conflicto.
  2111. - "--machinereadable" y "--startlineseparator", "--endlineseparator",
  2112. "fieldseparator" se usan para imprimir la salida a un formato fácil
  2113. de leer, tratar o parsear.
  2114. Por ejemplo:
  2115. cm merge --machinereadable --startlineseparator=start@_@line
  2116. --endlineseparator=new@_@line --fieldseparator=def#_#sep
  2117. --mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp
  2118. --solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp
  2119. --resolveconflict --conflict=1 --resolutionoption=rename --resolutioninfo=bin_dst
  2120. br:/main/task --merge
  2121. Ejemplos:
  2122. cm merge br:/task001
  2123. (No realiza la mezcla, simplemente escribe los elementos que van a ser
  2124. mezclados.)
  2125. cm merge br:/task001 --merge
  2126. (Realiza el merge desde la rama task001.)
  2127. cm merge cs:5 --merge --cherrypicking --interval-origin=cs:2
  2128. (Cherrypick del intervalo de changesets (2,5].)
  2129. cm merge cs:8 --merge --subtractive --keepdestination
  2130. (Merge sustractivo del changeset 8, preservando los cambios del destino
  2131. para aquellos elementos con conflictos.)
  2132. cm merge br:/main/task001 --to=br:/main --merge -c="Integrated new UI"
  2133. (Realiza el merge en el lado del servidor -a.k.a. "merge-to"-, desde la
  2134. rama task001 hasta la rama main, con un comentario.)
  2135. cm merge br:/main/task001 --to=br:/main --merge --shelve
  2136. (Realiza el merge en el lado del servidor desde la rama task001 a la rama
  2137. main y deja el resultado en un shelve.)
  2138. cm merge sh:2 --to=br:/main --merge --no-dst-changes
  2139. (Aplica el shelve 2 en la rama main solo si fue creado desde la cabeza
  2140. actual de main.)
  2141. == CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
  2142. Crea un atributo nuevo.
  2143. == CMD_USAGE_ATTRIBUTE_CREATE ==
  2144. Sintaxis:
  2145. cm attribute create nombre
  2146. nombre: Nombre del atributo.
  2147. Opciones:
  2148. -c: Añade un comentario al atributo creado.
  2149. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  2150. == CMD_HELP_ATTRIBUTE_CREATE ==
  2151. Ejemplos:
  2152. cm attribute create Estado
  2153. == CMD_DESCRIPTION_BRANCH ==
  2154. Use este comando para administrar ramas.
  2155. == CMD_USAGE_BRANCH ==
  2156. Sintaxis:
  2157. cm branch command [options]
  2158. Comandos:
  2159. [(create)|delete|rename|history|showmain|showmerges]
  2160. Para obtener más información sobre cada comando:
  2161. cm branch command --usage
  2162. cm branch command --help
  2163. == CMD_HELP_BRANCH ==
  2164. Ejemplos:
  2165. cm branch /main/scm21345
  2166. cm branch create /main/scm21345
  2167. cm branch delete /main/scm21345
  2168. cm branch rename /main/scm21345 scm21346
  2169. cm branch history /main/scm21345
  2170. cm branch showmain
  2171. cm branch showmerges file.txt
  2172. == CMD_DESCRIPTION_BRANCH_CREATE ==
  2173. Crea una rama en el repositorio actual.
  2174. == CMD_USAGE_BRANCH_CREATE ==
  2175. Sintaxis:
  2176. cm branch | br [create | mk] brspec [--changeset=csetspec | --label=lbspec]
  2177. [-c=str_comment | -commentsfile=<comments_file>]
  2178. brspec Nombre o especificación de la nueva rama.
  2179. Usa 'cm help objectspec' para más información sobre
  2180. especificaciones.
  2181. Opciones:
  2182. --changeset Changeset usado como punto de inicio de la nueva rama.
  2183. Especificación del changeset: [cs:]cs_number.
  2184. --label Etiqueta usada como punto de inicio de la nueva rama.
  2185. Usa 'cm help objectspec' para más información sobre
  2186. especificaciones.
  2187. -c Rellena el comentario de la nueva rama con el texto
  2188. especificado.
  2189. --commentsfile Rellena el comentario de la nueva rama con el contenido
  2190. del fichero de texto especificado.
  2191. == CMD_HELP_BRANCH_CREATE ==
  2192. Notas:
  2193. Para crear una rama de primer nivel, especifique el nombre sin jerarquía.
  2194. Por ejemplo:
  2195. cm br /dev
  2196. Si no se especifica el parámetro 'changeset', se utilizará el último
  2197. changeset de la rama madre. En caso de que la rama sea de primer nivel, se
  2198. utilizará como base el changeset 0.
  2199. Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
  2200. cm branch main/task001 -c="Este es el comentario"
  2201. cm branch main/task001 -m "Este es el comentario"
  2202. Se puede escoger qué editor se lanzará para escribir el comentario
  2203. mediante la variable de entorno PLASTICEDITOR. Si dicha variable de entorno
  2204. tiene un valor, y no se especifica un comentario, el editor escogido se
  2205. abrirá automáticamente para que se espefique el comentario.
  2206. Ejemplos:
  2207. cm branch task001
  2208. cm branch create task001
  2209. cm branch mk task001
  2210. cm br mk task001
  2211. (Crea la rama de primer nivel 'task001' en el repositorio al que apunta
  2212. el workspace actual.)
  2213. cm branch br:/task001/task002
  2214. (Crea la rama 'task002' como hija de 'task001'.)
  2215. cm br /main/task001@myrep@myserver:8084 -c="my comment"
  2216. (Crea la rama 'task001' como hija de 'main' en el repositorio
  2217. 'myrepo@myserver:8084' con el comentario 'my comment'.)
  2218. cm br mk br:/main/task001 --changeset=2837 -commentsfile=commenttask001.txt
  2219. (Crea la rama 'task001' tomando como base el changeset '2837' de la rama
  2220. 'main' con el comentario contenido en el fichero 'commenttask001.txt'.)
  2221. == CMD_DESCRIPTION_BRANCH_DELETE ==
  2222. Borra una o más ramas.
  2223. == CMD_USAGE_BRANCH_DELETE ==
  2224. Sintaxis:
  2225. cm branch | br delete | rm <spec_rama>+
  2226. spec_rama: Ramas a borrar, separadas por espacios.
  2227. Usa 'cm help objectspec' para obtener más información
  2228. sobre la especificación de ramas.
  2229. == CMD_HELP_BRANCH_DELETE ==
  2230. Notas:
  2231. Este comando borra una o más ramas.
  2232. Ejemplos:
  2233. cm branch delete /main/task001
  2234. (Borra la rama con nombre 'task001' que sea hija de 'main' en el
  2235. repositorio al que apunta el workspace actual.)
  2236. cm br rm main/task002 /main/task012@reptest@myserver:8084
  2237. (Borra la rama '/main/task002' del repositorio al que apunta el workspace
  2238. actual, y la rama '/main/task012' del repositorio 'reptest@myserver:8084'.)
  2239. == CMD_DESCRIPTION_BRANCH_RENAME ==
  2240. Renombra una rama.
  2241. == CMD_USAGE_BRANCH_RENAME ==
  2242. Sintaxis:
  2243. cm branch | br rename spec_rama nuevo_nombre
  2244. spec_rama: Especificación de la rama que se va a renombrar.
  2245. Usa 'cm help objectspec' para obtener más información sobre
  2246. la especificación de ramas.
  2247. nuevo_nombre Nuevo nombre para la rama.
  2248. == CMD_HELP_BRANCH_RENAME ==
  2249. Notas:
  2250. Este comando renombra una rama.
  2251. Ejemplos:
  2252. cm branch rename /main/task0 task1
  2253. (Renombra la rama '/main/task0' a '/main/task1'.)
  2254. cm br rename br:/main@reptest@server2:8084 secondary
  2255. (Renombra la rama principal del repositorio 'reptest' a 'secondary'.)
  2256. == CMD_DESCRIPTION_BRANCH_HISTORY ==
  2257. Muestra la historia de una rama (merges y punto de partida).
  2258. == CMD_USAGE_BRANCH_HISTORY ==
  2259. Sintaxis:
  2260. cm branch | br history spec_rama
  2261. [--dateformat=date_format] [--machinereadable]
  2262. spec_rama Especificación de la rama para obtener la historia.
  2263. Usa 'cm help objectspec' para obtener más información.
  2264. Opciones:
  2265. --dateformat Formato utilizado para mostrar fechas.
  2266. --machinereadable Devuelve el resultado en un formato sencillo de
  2267. parsear.
  2268. == CMD_HELP_BRANCH_HISTORY ==
  2269. Ejemplos:
  2270. cm branch history br:/main/scm001@myrepository@myserver:8084
  2271. (Muestra la historia de '/main/scm001' en el repositorio 'myrepository'.)
  2272. cm br history main --dateformat="yyyy, dd MMMM" --machinereadable
  2273. (Muestra la historia de 'main' con un formato de fecha determinado y con
  2274. un formato sencillo de parsear.)
  2275. == CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
  2276. Muestra la rama principal del repositorio.
  2277. Este es un comando de automatización, diseñado para automatizar el comando cm.
  2278. Muy probablemente la rama principal de sus repositorios sea /main.
  2279. == CMD_USAGE_BRANCH_SHOWMAIN ==
  2280. Sintaxis:
  2281. cm branch | br showmain [repspec] [--encoding=name]
  2282. [--format=format_str] [--dateformat=date_format]
  2283. repspec Especificación del repositorio donde buscar la rama principal.
  2284. Si no se especifica, se utilizará el repositorio al que apunte
  2285. el workspace actual.
  2286. Opciones:
  2287. --encoding Permite especificar la codificación con el que se
  2288. guardará la salida del comando. Consulte la
  2289. documentación de la MSDN para obtener la tabla completa
  2290. de codificaciones soportadas y su formato; al final de
  2291. la página en la columna "Name":
  2292. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  2293. --format Devuelve el mensaje de salida con un formato determinado.
  2294. Más información en las notas.
  2295. --dateformat Formato utilizado para mostrar fechas.
  2296. == CMD_HELP_BRANCH_SHOWMAIN ==
  2297. Notas:
  2298. Este comando muestra la rama principal de un repositorio.
  2299. Este comando acepta una cadena especificando el formato con el que se
  2300. debe mostrar la salida. Los parámetros de salida son los siguientes:
  2301. {id} Id de la rama.
  2302. {comment} Comentario.
  2303. {date} Fecha.
  2304. {owner} Propietario.
  2305. {name} Nombre.
  2306. {parent} Nombre de la rama madre.
  2307. {repository} Repositorio.
  2308. {repname} Nombre del repositorio.
  2309. {repserver} Servidor.
  2310. {changeset} Id del último changeset de la rama.
  2311. Ejemplos:
  2312. cm branch showmain
  2313. (Muestra la rama principal del repositorio del workspace actual.)
  2314. cm branch showmain repo@repserver:8084
  2315. (Muestra la rama principal del repositorio 'repo' en el servidor
  2316. 'repserver:8084'.)
  2317. cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8
  2318. (Muestra la rama principal del repositorio, con las fechas en un determinado
  2319. formato, y la salida está codificada en utf-8.)
  2320. cm br showmain --format="{id} - {name}"
  2321. (Muestra la rama principal del repositorio, devolviendo únicamente su id y
  2322. nombre.)
  2323. == CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
  2324. Muestra información sobre elementos pendientes en ramas a mezclar.
  2325. == CMD_USAGE_BRANCH_SHOWMERGES ==
  2326. Este es un comando de automatización, diseñado para automatizar el comando cm.
  2327. Sintaxis:
  2328. cm branch | br showmerges <item_path>+
  2329. [--format=format_str] [--dateformat=date_format]
  2330. Opciones:
  2331. --format Devuelve el mensaje de salida con un formato determinado.
  2332. Más información en las notas.
  2333. --dateformat Formato utilizado para mostrar fechas.
  2334. == CMD_HELP_BRANCH_SHOWMERGES ==
  2335. Notas:
  2336. Este comando acepta una cadena especificando el formato con el que se
  2337. debe mostrar la salida. Los parámetros de salida son los siguientes:
  2338. {id} Id de la rama.
  2339. {comment} Comentario.
  2340. {date} Fecha.
  2341. {name} Nombre.
  2342. {owner} Propietario.
  2343. {parent} Nombre de la rama madre.
  2344. {parentid} Id de la rama madre.
  2345. {repid} Id del repositorio.
  2346. {repository} Repositorio.
  2347. {repname} Nombre del repositorio.
  2348. {repserver} Servidor.
  2349. Ejemplos:
  2350. cm branch showmerges file.txt
  2351. (Muestra las ramas involucradas en el merge pendiente del fichero file.txt.)
  2352. cm branch showmerges file.txt --format="{date} {name}" --dateformat="ddMMyy"
  2353. (Muestra las ramas involucradas en el merge, mostrando solo la fecha y el
  2354. nombre, con las fechas en un determinado formato.)
  2355. == CMD_DESCRIPTION_REPOSITORY ==
  2356. Administra repositorios.
  2357. == CMD_USAGE_REPOSITORY ==
  2358. Sintaxis:
  2359. cm repository | repo commmand [options]
  2360. Comandos:
  2361. create | mk
  2362. delete | rm
  2363. list | ls
  2364. rename
  2365. add
  2366. Para obtener más información sobre cada comando:
  2367. cm repository command --usage
  2368. cm repository command --help
  2369. == CMD_HELP_REPOSITORY ==
  2370. Ejemplos:
  2371. cm repository
  2372. cm repository list
  2373. cm repository newrepo
  2374. cm repository create newrepo
  2375. cm repository rename oldname newname
  2376. cm repository add C:\repo\
  2377. == CMD_DESCRIPTION_REPOSITORY_CREATE ==
  2378. Crea un repositorio en un servidor.
  2379. == CMD_USAGE_REPOSITORY_CREATE ==
  2380. Sintaxis:
  2381. cm repository rep_name
  2382. cm repository servidor <nombre_repositorio>+
  2383. cm repository [create | mk] rep_name
  2384. servidor Especificación del servidor.
  2385. Usa 'cm help objectspec' para más información sobre
  2386. especificaciones.
  2387. nombre_repositorio Nombre del nuevo repositorio.
  2388. == CMD_HELP_REPOSITORY_CREATE ==
  2389. Ejemplos:
  2390. cm repository MyRep
  2391. cm repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
  2392. cm repo create Rep01
  2393. cm repo mk list
  2394. == CMD_DESCRIPTION_REPOSITORY_DELETE ==
  2395. Borra un repositorio del servidor.
  2396. == CMD_USAGE_REPOSITORY_DELETE ==
  2397. Sintaxis:
  2398. cm repository delete | rm repositoryspec
  2399. repositoryspec Especificación del repositorio a borrar.
  2400. Usa 'cm help objectspec' para obtener más información
  2401. sobre la especificación de repositorios.
  2402. == CMD_HELP_REPOSITORY_DELETE ==
  2403. Nota:
  2404. Elimina un repositorio del servidor de repositorios.
  2405. No borra los datos del sistema gestor de bases de datos,
  2406. simplemente desconecta el repositorio del sistema de modo
  2407. que ya no sea accesible (los datos pueden ser añadidos de
  2408. nuevo, véase 'cm repository add').
  2409. Ejemplos:
  2410. cm repository delete myrepository@repserver:myserver:8084
  2411. cm repository rm myrepository@myserver:8084
  2412. cm repo rm myrepository
  2413. == CMD_DESCRIPTION_REPOSITORY_LIST ==
  2414. Lista los repositorios de un servidor.
  2415. == CMD_USAGE_REPOSITORY_LIST ==
  2416. Sintaxis:
  2417. cm repository
  2418. cm repository list [servidor] [--format=str_format]
  2419. servidor Especificación del servidor.
  2420. Usa 'cm help objectspec' para más información sobre
  2421. especificaciones.
  2422. --format Devuelve la salida en el formato especificado.
  2423. == CMD_HELP_REPOSITORY_LIST ==
  2424. Notas:
  2425. Este comando acepta una cadena de texto formateada para mostrar la
  2426. salida.
  2427. Los parámetros de salida del comando son los siguientes:
  2428. {repid} | {0} Identificador del repositorio.
  2429. {repname} | {1} Nombre del repositorio.
  2430. {repserver} | {2} Nombre del servidor del repositorio.
  2431. {repowner} | {3} Propietario del repositorio.
  2432. {repguid} | {4} Identificador único del repositorio.
  2433. {tab} Inserta un tabulador.
  2434. {newline} Inserta una nueva línea.
  2435. Si el valor del formato es "TABLE", la salida se imprimirá en formato
  2436. tabla con los siguientes campos: {repid}, {repname} y {repserver}.
  2437. Ejemplos:
  2438. cm repository
  2439. (Lista todos los repositorios.)
  2440. cm repository list localhost:8084 --format="{1, -20} {3}"
  2441. (Escribe el campo "nombre del repositorio" utilizando 20 espacios,
  2442. alineado a la izquierda, un espacio, y a continuación el propietario.)
  2443. cm repository ls localhost:8084 --format="{repname, -20} {repowner}"
  2444. (Escribe lo mismo que el ejemplo anterior.)
  2445. cm repo ls localhost:8084 --format=TABLE
  2446. (Escribe la lista de repositorios en formato tabla con los siguientes
  2447. campos: el id del repositorio, el nombre del repositorio, y el nombre
  2448. del servidor de repositorios.)
  2449. == CMD_DESCRIPTION_REPOSITORY_RENAME ==
  2450. Renombra un repositorio.
  2451. == CMD_USAGE_REPOSITORY_RENAME ==
  2452. Sintaxis:
  2453. cm repository rename [spec_repositorio] nuevo_nombre
  2454. spec_repositorio Especificación del repositorio a renombrar.
  2455. Usa 'cm help objectspec' para obtener más
  2456. información sobre la especificación de repositorios.
  2457. nuevo_nombre Nuevo nombre para el repositorio.
  2458. == CMD_HELP_REPOSITORY_RENAME ==
  2459. Notas:
  2460. Este comando renombre un repositorio.
  2461. Si no se proporciona ninguna especificación de repositorio, se tomará el
  2462. repositorio actual como spec_repositorio.
  2463. Ejemplos:
  2464. cm repository rename desarrollo
  2465. (El repositorio actual se renombra a 'desarrollo'.)
  2466. cm repo rename rep:default@SERVER:8084 desarrollo
  2467. (El repositorio 'default' del servidor 'SERVER' se renombra a 'desarrollo'.)
  2468. == CMD_DESCRIPTION_REPOSITORY_ADD ==
  2469. Añade una base de datos de repositorio al sistema.
  2470. == CMD_USAGE_REPOSITORY_ADD ==
  2471. Uso:
  2472. cm repository add databasename nombre repserverspec
  2473. databasename El nombre de la base de datos a reconectar.
  2474. nombre Nombre del repositorio.
  2475. repserverspec Especificación del servidor de repositorios.
  2476. Usa 'cm help objectspec' para obtener más
  2477. información sobre la especificación de servidores.
  2478. == CMD_HELP_REPOSITORY_ADD ==
  2479. Nota:
  2480. Reconecta una base de datos de repositorio al servidor. Puede
  2481. usarse para mover un repositorio de un servidor a otro o para
  2482. restaurar datos.
  2483. Ejemplos:
  2484. cm repository add rep_27 myrepository myserver:8084
  2485. == CMD_DESCRIPTION_TRIGGER_CREATE ==
  2486. Crea un nuevo trigger en un determinado servidor.
  2487. == CMD_USAGE_TRIGGER_CREATE ==
  2488. Sintaxis:
  2489. cm trigger create subtipo-tipo nombre script [opciones]
  2490. subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
  2491. Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
  2492. trigger disponibles. Algunos ejemplos son:
  2493. before-mkbranch
  2494. after-mkwokspace
  2495. after-setselector
  2496. nombre: nombre que queremos dar al trigger.
  2497. script: ruta del servidor en la que se encuentra el script
  2498. que deseamos ejecutar. Si esta ruta comienza por "webtrigger ", se
  2499. considerará como web trigger. Consulte la ayuda del comando para obtener
  2500. detalles adicionales.
  2501. Opciones:
  2502. --position=posicion: Intenta crear el trigger en la posición especificada
  2503. si esta no esta cogida por otro del mismo tipo.
  2504. --filter=filtro: Comprueba sólo aquellos elementos que coincidan con el
  2505. filtro de busqueda indicado. Se pueden especificar varios filtros
  2506. separados por comas, si es así el el trigger se ejecutará si el elemento
  2507. coincide con cualquiera de los filtros. Si uno de los filtros comienza
  2508. con "rep:", el trigger se ejecutara sólo para las operaciones realizadas
  2509. sobre el repositorio con el nombre especificado (ver ejemplo).
  2510. --server=servidor: Crea el trigger en el servidor especificado. Si no se
  2511. especifica ninguno se crea en el servidor configurado en el cliente.
  2512. == CMD_HELP_TRIGGER_CREATE ==
  2513. Notas:
  2514. Web triggers: Para crear web triggers, escriba "webtrigger <target-uri>"
  2515. como comando de trigger. En este caso, el trigger ejecutará una consulta
  2516. POST contra el URI especificado, en la que el cuerpo de la petición
  2517. contiene un diccionario JSON con las variables de entorno del trigger.
  2518. También estará presente una clave INPUT apuntando a un vector de cadenas de
  2519. texto para aquellos triggers que escriban en la entrada estándar de sus
  2520. comandos asociados.
  2521. Ejemplos:
  2522. cm trigger create after-setselector "backup" "/path/al/script" --position=4
  2523. cm tr mk before-mklabel new "/path/al/script" --server=myserver:8084
  2524. cm tr mk after-mklabel Log "/path/al/script" --filter="rep:myRep,LB*"
  2525. Este trigger se ejecutará sólo si el nombre de la etiqueta creada
  2526. comienza por 'LB' y si está siendo creada en el repositorio 'myrep'.
  2527. cm tr mk after-checkin Notify "webtrigger http://myserver.org/endpoint"
  2528. == CMD_DESCRIPTION_MOVE ==
  2529. Mueve o renombra un ítem.
  2530. == CMD_USAGE_MOVE ==
  2531. Sintaxis:
  2532. cm move ruta_origen ruta_destino
  2533. ruta_origen: Ruta origen del ítem.
  2534. ruta_destino: Ruta destino del ítem.
  2535. == CMD_HELP_MOVE ==
  2536. Notas:
  2537. Este comando mueve o renombra un ítem en el repositorio.
  2538. Los cambios también se realizan en el sistema de ficheros local.
  2539. Si la ruta de origen es un fichero, el destino puede ser un fichero o un
  2540. directorio. En el primer caso, el fichero se renombra, si no, el ítem se
  2541. mueve al directorio destino.
  2542. Si la ruta de origen es un directorio, la ruta destino ha de serlo también.
  2543. Requisitos para mover o renombrar un ítem:
  2544. El ítem ha de estar controlado por Plastic SCM.
  2545. El directorio padre del ítem origen y del ítem destino han de estar desprotegidos.
  2546. Ejemplos:
  2547. cm move fichero.txt fichero.old (renombra el ítem)
  2548. cm move .\fichero.old .\antiguos (mueve fichero.old al directorio antiguos)
  2549. cm move .\src .\src2 (renombra el directorio)
  2550. == CMD_DESCRIPTION_LABEL ==
  2551. Este comando permite al usuario efectuar operaciones con etiquetas.
  2552. == CMD_USAGE_LABEL ==
  2553. Sintaxis:
  2554. cm label | lb command [options]
  2555. Comandos:
  2556. create | mk
  2557. delete | rm
  2558. rename
  2559. Para obtener más información sobre cada uno de los comandos ejecute:
  2560. cm label command --usage
  2561. cm label command --help
  2562. == CMD_HELP_LABEL ==
  2563. Ejemplos
  2564. cm label myNewLabel cs:42
  2565. (el comando 'create' es opcional)
  2566. cm label rename myNewLabel newLabelName
  2567. cm label delete newLabelName
  2568. == CMD_DESCRIPTION_LABEL_CREATE ==
  2569. Crea una etiqueta nueva o etiqueta una changeset dado.
  2570. == CMD_USAGE_LABEL_CREATE ==
  2571. Sintaxis:
  2572. cm label [create] spec_etiqueta [spec_changeset | ruta]
  2573. [--allxlinkedrepositories]
  2574. [-c=str_comment | -commentsfile=<comments_file>]
  2575. spec_etiqueta: Especificación de la etiqueta. Usa 'cm help objectspec' para
  2576. obtener más información sobre especificaciones.
  2577. spec_changeset: Nombre o especificación del changeset a etiquetar. Usa
  2578. 'cm help objectspec' para obtener más información sobre especificaciones.
  2579. ruta: Ruta del workspace a etiquetar
  2580. Si no se especifica spec_changeset ni ruta se asumirá el directorio actual
  2581. como workspace a etiquetar.
  2582. Opciones:
  2583. --allxlinkedrepositories (-s): Crea la etiqueta en todos los repositorios
  2584. enlazados.
  2585. -c: Añade un comentario a la etiqueta creada.
  2586. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  2587. == CMD_HELP_LABEL_CREATE ==
  2588. Notas:
  2589. Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
  2590. ejecutable de un editor de texto el editor se abrirá automáticamente
  2591. para que especifique un comentario.
  2592. Ejemplos:
  2593. cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt
  2594. cm label BL002 cs:=1203 -c="first release"
  2595. == CMD_DESCRIPTION_LABEL_DELETE ==
  2596. Borra una o más etiquetas.
  2597. == CMD_USAGE_LABEL_DELETE ==
  2598. Sintaxis:
  2599. cm label delete spec_etiqueta1 spec_etiqueta2 ...
  2600. spec_etiqueta: Etiquetas a borrar, separadas por espacios.
  2601. Usa 'cm help objectspec' para obtener más información
  2602. sobre la especificación de etiquetas.
  2603. == CMD_HELP_LABEL_DELETE ==
  2604. Notas:
  2605. Este comando borra una o más etiquetas creadas previamente.
  2606. Ejemplos:
  2607. cm label delete lb:BL001 (Se borra la etiqueta 'BL001')
  2608. cm label delete lb:BL001 lb:BL002
  2609. == CMD_DESCRIPTION_LABEL_RENAME ==
  2610. Renombra una etiqueta.
  2611. == CMD_USAGE_LABEL_RENAME ==
  2612. Sintaxis:
  2613. cm label rename spec_etiqueta nuevo_nombre
  2614. sepec_etiqueta: Especificación de la etiqueta que se va a renombrar.
  2615. Usa 'cm help objectspec' para obtener más información sobre
  2616. la especificación de etiquetas.
  2617. nuevo_nombre: Nuevo nombre para la etiqueta.
  2618. == CMD_HELP_LABEL_RENAME ==
  2619. Notas:
  2620. Este comando renombra una etiqueta.
  2621. Ejemplos:
  2622. cm label rename lb:BL001 BL002
  2623. (La etiqueta 'BL001' se renombra a 'BL002')
  2624. == CMD_DESCRIPTION_OBLITERATE ==
  2625. DEPRECATED
  2626. == CMD_USAGE_OBLITERATE ==
  2627. == CMD_HELP_OBLITERATE ==
  2628. == CMD_DESCRIPTION_OBJECTSPEC ==
  2629. Explica cómo escribir object specs (especificaciones de objetos).
  2630. == CMD_USAGE_OBJECTSPEC ==
  2631. Sintaxis:
  2632. cm objectspec
  2633. Para obtener toda la información sobre cómo construir specs de objetos.
  2634. == CMD_HELP_OBJECTSPEC ==
  2635. Muchos comandos de Plastic SCM esperan 'object specs' como entrada para
  2636. referirse a un objeto concreto (normalmente una rama, un changeset, un
  2637. repositorio, etc.).
  2638. Esta documentación describe los diferentes tipos de "specs" disponibles y
  2639. cómo construirlas.
  2640. Cada tipo de especificación comienza con un tag único, por ejemplo "rep:" o "cs:".
  2641. El tag se debe indicar para comandos que reciban especificaciones generales
  2642. de objetos, como por ejemplo "cm setowner object_spec", pero a menudo se pueden
  2643. omitir en comandos que solo acepten un tipo de especificación, como por ejemplo
  2644. "cm getfile revision_spec".
  2645. == Repository server spec (repserverspec) ==
  2646. repserver:name:port
  2647. Ejemplos:
  2648. cm lrep repserver:skull:8084
  2649. cm lrep skull:8084
  2650. Nota:
  2651. Lo llamamos "rep" server spec (con el 'rep' delante) en lugar de
  2652. simplemente 'server spec' por motivos históricos. Hace mucho tiempo
  2653. Plastic tenía servidores de workspaces y repositorios separados, y
  2654. el nombre ha sobrevivido.
  2655. == Repository spec (repspec) ==
  2656. rep:rep_name@[repserverspec]
  2657. Ejemplos:
  2658. cm showowner rep:codice@localhost:6060
  2659. (Aquí la "rep:" es necesaria porque el comando showowner admite
  2660. todo tipo de objetos).
  2661. == Branch spec (brspec) ==
  2662. br:[/]br_name[@repspec]
  2663. Ejemplos:
  2664. cm switch br:/main@rep:plastic@repserver:skull:9095
  2665. (En este caso "br:", "rep:" y "repserver:" no son necesarios así
  2666. que el comando se puede escribir de forma mucho más compacta:
  2667. "cm switch main@plastic@skull:9095" .)
  2668. cm find revisions "where branch='br:/main/task001'"
  2669. Nota:
  2670. La barra inicial '/' en las ramas no es obligatoria. Solíamos escribir
  2671. todas las ramas como /main, /main/task001, etc. Pero ahora preferimos
  2672. user formatos más cortos tipo main, main/task001.
  2673. == Changeset spec (csetspec) ==
  2674. cs:cs_number|cs_guid[@repspec]
  2675. Se puede especificar el número o el GUID del changeset.
  2676. Ejemplos:
  2677. cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
  2678. == Label spec (labelspec) ==
  2679. lb:lb_name[@repspec]
  2680. Ejemplos:
  2681. cm switch lb:RELEASE2.0
  2682. cm switch lb:RELEASE1.4@myrep@MYSERVER:8084
  2683. == Revision spec ==
  2684. Hay distintos tipos de specs de revisiones:
  2685. rev:item_path[#(brspec|csetspec|labelspec)]
  2686. rev:serverpath:item_path#(brspec|cset_spec|lb_spec)
  2687. rev:revid:rev_id[@rep_spec]
  2688. rev:itemid:item_id#(br_spec|cset_spec|lb_spec)
  2689. Ejemplos:
  2690. cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
  2691. cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
  2692. serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
  2693. cm cat revid:1230@rep:myrep@repserver:myserver:8084
  2694. == Item spec ==
  2695. Se usa muy raras veces.
  2696. item:path
  2697. Ejemplo:
  2698. cm find revision "where item='item:.'"
  2699. == Attribute spec ==
  2700. att:att_name[@repspec]
  2701. Ejemplo:
  2702. cm rmattributereal att:merged@code@doe:8084 cs:25@code@doe:8084
  2703. == Workspace specs ==
  2704. wk:name@clientmachine
  2705. Se usa muy poco porque solamente aplica a los comandos relacionados con los
  2706. workspaces. Es útil para indicar el nombre del workspace en lugar del path.
  2707. Ejemplo:
  2708. cm showselector wk:codebase@modok
  2709. Nota:
  2710. Estas specs vienen de los viejos tiempos de Plastic SCM 2.x en los que
  2711. los 'workspace servers' eran una forma de almacenar metadatos de forma
  2712. centralizada. Se eliminaron por cuestiones de rendimiento.
  2713. == CMD_DESCRIPTION_PARTIAL ==
  2714. Ejecuta comandos en un espacio de trabajo parcial.
  2715. == CMD_USAGE_PARTIAL ==
  2716. Sintaxis:
  2717. cm partial comando [opciones]
  2718. Comandos:
  2719. configure
  2720. add
  2721. undo
  2722. co | checkout
  2723. unco | undocheckout
  2724. ci | checkin
  2725. mv | move
  2726. rm | remove
  2727. stb | switch
  2728. upd | update
  2729. Para obtener más información de cada uno de los comandos ejecute:
  2730. cm partial comando --usage
  2731. cm partial comando --help
  2732. == CMD_HELP_PARTIAL ==
  2733. Ejemplos:
  2734. cm partial configure +/fondo-azul.png
  2735. cm partial update paisaje-1024.png
  2736. cm partial checkin ojos-verde.png ojos-negro.png
  2737. == CMD_DESCRIPTION_PARTIAL_ADD ==
  2738. Añade un ítem al repositorio.
  2739. == CMD_USAGE_PARTIAL_ADD ==
  2740. Sintaxis:
  2741. cm partial add [-R | -r | --recursive] [--silent] [--parents] [--ignorefailed]
  2742. [--skipcontentcheck] <rutas>+
  2743. rutas Rutas de los ítems a añadir separados por espacios.
  2744. Usa comillas (") para especificar rutas con espacios.
  2745. Usa * para añadir todo el contenido del directorio
  2746. actual.
  2747. Opciones:
  2748. -R Añade los ítems recursivamente.
  2749. --silent No muestra ninguna salida.
  2750. --parents Incluye los directorios padre de los ítems indicados en
  2751. la operación.
  2752. --ignorefailed Si un ítem no se puede añadir, la operación de add
  2753. continuará sin él. Importante: si un directorio no se
  2754. puede añadir, su contenido tampoco se añadirá.
  2755. --skipcontentcheck Cuando la extensión no es suficiente para determinar si
  2756. el fichero es de tipo texto o binario, se asumirá que es
  2757. binario en lugar de usar el contenido para detectar el
  2758. tipo.
  2759. == CMD_HELP_PARTIAL_ADD ==
  2760. Notas:
  2761. Requisitos para añadir ítems:
  2762. - El directorio padre del ítem a añadir debe existir en el repositorio.
  2763. Ejemplos:
  2764. cm partial add pic1.png pic2.png
  2765. (Añade los ítems pic1.png y pic2.png.)
  2766. cm partial add c:\workspace\imagen.png
  2767. (Añade el ítem imagen.png en el directorio c:\workspace.)
  2768. cm partial add -R c:\workspace\src
  2769. (Añade recursivamente todos los ítems del directorio especificado.)
  2770. cm partial add --parents ejemplos\diseño01.png
  2771. (Añade el ítem diseño01.png y su directorio padre ejemplos.)
  2772. cm partial add -R *
  2773. (Recursively adds all the contents of the current directory.)
  2774. == CMD_DESCRIPTION_PARTIAL_CHECKIN ==
  2775. Crea una nueva revisión de un ítem.
  2776. == CMD_USAGE_PARTIAL_CHECKIN ==
  2777. Sintaxis:
  2778. cm partial checkin | ci [opciones] [<ruta>+]
  2779. ruta Rutas de los ítems a proteger, separados por espacios.
  2780. Usa comillas (") para especificar rutas con espacios.
  2781. Usa . para aplicar la operación de checkin al directorio
  2782. actual.
  2783. Opciones:
  2784. -c Añade un comentario al changeset creado en la operación
  2785. de protección.
  2786. -commentsfile Añade el comentario existente en el fichero especificado
  2787. añ changeset creado en la operación de protección.
  2788. --all | -a Los ítems cambiados, movidos y borrados localmente en
  2789. las rutas especificadas también son protegidos.
  2790. --applychanged Protege los ítems cambiados localmente junto con los
  2791. ítems desprotegidos.
  2792. --keeplock Mantiene el bloqueo de aquellos elementos que estaban
  2793. bloqueados después de la operación de protección.
  2794. --symlink Realizar la operación de checkin sobre el fichero de
  2795. link y no al que apunta.
  2796. --ignorefailed Los cambios locales que no se pueden aplicar (porque el
  2797. bloqueo (checkout exclusivo) no se puede obtener o
  2798. porque están en conflicto con los cambios del servidor)
  2799. son descartados y el checkin continúa sin ellos.
  2800. == CMD_HELP_PARTIAL_CHECKIN ==
  2801. Notas:
  2802. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  2803. todos los cambios pendientes en el espacio de trabajo.
  2804. - La operación de protección se aplica siempre recursivamente desde la
  2805. ruta indicada.
  2806. - Requisitos para proteger un ítem:
  2807. - El ítem debe estar controlado por Plastic SCM.
  2808. - El ítem ha de estar desprotegido.
  2809. - Si un ítem ha sido cambiado pero no desprotegido, no es necesario
  2810. especificar la opción --applychanged, salvo que en las rutas a ser
  2811. protegidas se incluyan directorios o rutas con wildcards ('*').
  2812. La revisión ha de tener cambios. Es decir, no se pueden proteger los
  2813. mismos datos.
  2814. Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
  2815. ejecutable de un editor de texto, y no se especifica un comentario al
  2816. hacer checkin, el editor se abrirá automáticamente para que especifique
  2817. un comentario.
  2818. Ejemplos:
  2819. cm partial checkin figura.png paisaje.png
  2820. (Protege los ítems figura.png and paisaje.png.)
  2821. cm partial checkin . -commentsfile=micomentario.txt
  2822. (Protege los ítems de la ruta actual y aplica el comentario existente en el
  2823. fichero micomentario.txt.)
  2824. cm partial ci fondo.png -c="Nuevo fondo añadido" --keeplock
  2825. (Protege el ítem fondo.png, incluye el comentario especificado y mantiene el
  2826. bloqueo.)
  2827. cm partial checkin --applychanged
  2828. (Protege todos los cambios pendientes en el espacio de trabajo.)
  2829. cm partial checkin link --symlink
  2830. (Proteger el fichero de link y no al que apunta, opción disponible en UNIX)
  2831. == CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
  2832. Desprotege los ítems dejándolos preparados para ser modificados.
  2833. == CMD_USAGE_PARTIAL_CHECKOUT ==
  2834. Síntaxis:
  2835. cm partial checkout | co [<ruta>+] [--resultformat=str_format]
  2836. [--silent] [--ignorefailed]
  2837. Opciones:
  2838. ruta Rutas de los ítems a desproteger, separados por
  2839. espacios.
  2840. Usa comillas (") para especificar rutas con espacios.
  2841. Usa . para aplicar la operación de checkout al
  2842. directorio actual.
  2843. --resultformat Devuelve la salida en el formato especificado.
  2844. --silent No muestra ninguna salida.
  2845. --ignorefailed Si un ítem no se puede desproteger/bloquear (no se puede
  2846. hacer un checkout exclusivo), la operación de checkout
  2847. continuará sin él.
  2848. == CMD_HELP_PARTIAL_CHECKOUT ==
  2849. Notas:
  2850. Para desproteger un ítem:
  2851. - El ítem debe estar controlado por Plastic.
  2852. - El ítem debe estar protegido.
  2853. Si se han configurado bloqueos en el servidor (existe el fichero lock.conf),
  2854. entonces cada vez que se produzca una desprotección, Plastic comprobará si
  2855. se aplica alguna de las reglas. Si es así, la ruta permanecerá en checkout
  2856. exclusivo (bloqueada), con lo que nadie podrá desprotegerlo simultáneamente.
  2857. Puedes obtener todos los bloqueos del servidor usando 'cm listlocks'.
  2858. Lee la documentación Administrator Guide para más información.
  2859. Examples:
  2860. cm partial checkout imagen1.png imagen2.png
  2861. (Desprotege los ítems imagen1.png and imagen2.png.)
  2862. cm partial co *.png
  2863. (Desprotege todos los ítems png.)
  2864. cm partial checkout .
  2865. (Desprotege el directorio actual.)
  2866. cm partial checkout -R c:\workspace\paisaje
  2867. (Desprotege recursivamente el directorio paisaje.)
  2868. cm partial co diseño01.png --exclusive
  2869. (Desprotege el ítem exclusivamente.)
  2870. == CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
  2871. Permite configurar tu espacio de trabajo, cargando o descargando elementos.
  2872. == CMD_USAGE_PARTIAL_CONFIGURE ==
  2873. Sintaxis:
  2874. cm partial configure <+|-ruta>+ [--silent] [--ignorefailed] [--ignorecase]
  2875. [--restorefulldirs]
  2876. ruta Rutas a cargar o descargar, separadas por espacios.
  2877. Usa comillas (") para especificar rutas con espacios.
  2878. Todas las rutas deben comenzar con "/".
  2879. Opciones:
  2880. --silent No muestra ninguna salida.
  2881. --ignorefailed Ignora cualquier error durante la operación.
  2882. --ignorecase Ignora mayúsculas y minúsculas. Con esta opción el
  2883. comando funcionará para "/Data/Textures" incluso si el
  2884. usuario indica "/data/teXtures".
  2885. --restorefulldirs Resetea una configuración de directorio incorrecta
  2886. (ocurre cuando una operación no parcial es ejecutada en
  2887. un espacio de trabajo parcial).
  2888. Los directorios de esta lista se configuran por
  2889. completo (full check), lo que significa que bajarán
  2890. automáticamente el nuevo contenido durante el update.
  2891. Esta operación no descarga ningún fichero, simplemente
  2892. restaura la configuración de directorio en un espacio
  2893. de trabajo parcial.
  2894. == CMD_HELP_PARTIAL_CONFIGURE ==
  2895. Notas:
  2896. El comando siempre asume recursividad.
  2897. Ejemplos:
  2898. cm partial configure +/paisaje-gris.png
  2899. (Carga paisaje-gris.png.)
  2900. cm partial configure -/paisaje-negro.png
  2901. (Descarga paisaje-negro.)
  2902. cm partial configure +/textura -/textura/textura01.png
  2903. (Carga todo el contenido del directorio textura excepto textura01.png.)
  2904. cm partial configure -/
  2905. (Descarga todo el directorio de trabajo.)
  2906. cm partial configure -/ +/
  2907. (Carga todo el directorio de trabajo.)
  2908. cm partial configure +/figura-64.png --ignorefailed
  2909. (Carga figura-64.png, estuviera o no ya cargado previamente.)
  2910. cm partial configure +/ --restorefulldirs
  2911. (Fija todos los directorios para que descarguen el nuevo contenido automáticamente.)
  2912. cm partial configure +/src/lib --restorefulldirs
  2913. (Fija sólo /src/lib y sus subdirectorios para que descarguen el nuevo contenido automáticamente.)
  2914. == CMD_DESCRIPTION_PARTIAL_MOVE ==
  2915. Mueve o renombra un archivo o directorio.
  2916. == CMD_USAGE_PARTIAL_MOVE ==
  2917. Sintaxis:
  2918. cm partial move | mv src_path dst_path [--format=str_format]
  2919. src_path Ruta origen del ítem.
  2920. dst_path Ruta destino del ítem.
  2921. Options:
  2922. --format Devuelve la salida en el formato especificado.
  2923. == CMD_HELP_PARTIAL_MOVE ==
  2924. Notas:
  2925. Este comando mueve o renombra un ítem en el repositorio.
  2926. Los cambios también se aplican localmente.
  2927. Si la ruta de origen es un fichero, el destino puede ser un fichero o un
  2928. directorio. En el primer caso, el fichero se renombra. En el segundo, el
  2929. fichero se renombra.
  2930. Si la ruta de origen en un directorio, el destino ha de serlo también.
  2931. El ítem a mover o renombrar debe existir.
  2932. Formato:
  2933. {0} Ruta de origen.
  2934. {1} Ruta de destino.
  2935. Examples:
  2936. cm partial move fichero.png fichero-azul.png
  2937. (Renombra el ítem.)
  2938. cm partial mv .\fichero-azul.png .\azulFicheros
  2939. (Mueve fichero-azul.png a azulFicheros.)
  2940. cm partial move .\diseño .\marketing
  2941. (Renombra un directorio.)
  2942. == CMD_DESCRIPTION_PARTIAL_RM ==
  2943. Borra un ítem del control de versiones.
  2944. == CMD_USAGE_PARTIAL_RM ==
  2945. Sintaxis:
  2946. cm partial remove | rm <ruta>+ [--nodisk]
  2947. ruta Ítems a borrar, separados por espacios.
  2948. Usa comillas (") para especificar rutas con espacios.
  2949. Opciones:
  2950. --nodisk Borra del control de versiones, pero mantiene el ítem en
  2951. disco.
  2952. == CMD_HELP_PARTIAL_RM ==
  2953. Notas:
  2954. Los ítems se borran de disco. Los ítems borrados son borrados del directorio
  2955. padre en el control de versiones.
  2956. Requisitos:
  2957. - El ítem debe estar controlado.
  2958. Ejemplos:
  2959. cm partial remove src
  2960. (Borra src. Si src es un directorio, equivale a ejecutar:
  2961. cm partial remove -R src.)
  2962. cm partial remove c:\workspace\pic01.png --nodisk
  2963. (Borra pic01.png del control de versiones, pero lo mantiene en el disco.)
  2964. == CMD_DESCRIPTION_PARTIAL_SWITCH ==
  2965. Establece la rama especificada como rama de trabajo.
  2966. == CMD_USAGE_PARTIAL_SWITCH ==
  2967. Sintaxis:
  2968. cm switch branch_spec [--report | --silent] [--workspace=path]
  2969. (Establece la rama de trabajo y actualiza el workspace.)
  2970. cm switch branch_spec --configure <+|-ruta>+ [--silent]
  2971. [--ignorefailed] [--ignorecase] [--workspace=path]
  2972. (Establece la rama de trabajo y configura el workspace como haría el
  2973. comando 'cm partial configure'.)
  2974. branch_spec Especificación de rama.
  2975. ruta Rutas a cargar o descargar, separadas por espacios.
  2976. Usa comillas (") para especificar rutas con espacios.
  2977. Todas las rutas deben comenzar con "/".
  2978. Opciones:
  2979. --silent No muestra salida.
  2980. --report Imprime una lista de los cambios efectuados una vez
  2981. termina la operación. Pierde efecto si se utiliza
  2982. la opción --silent conjuntamente.
  2983. --configure Configura (carga / descarga rutas) el espacio de
  2984. trabajo después de haber actualizado la rama de trabajo.
  2985. Usa 'cm partial configure --help' para aprender más
  2986. sobre como especificar las rutas a configurar.
  2987. --ignorefailed Ignora cualquier error durante la operación
  2988. de configuración.
  2989. --ignorecase Ignora mayúsculas y minúsculas en las rutas a
  2990. configurar. Con esta opción el comando funcionará
  2991. para "/Data/Textures" incluso si el usuario indica
  2992. "/data/teXtures".
  2993. --workspace=path Ruta del espacio de trabajo a cambiar.
  2994. --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
  2995. redirige la salida estándar.
  2996. Usa 'cm help objectspec' para aprender más sobre cómo indicar especificaciones
  2997. de ramas.
  2998. == CMD_HELP_PARTIAL_SWITCH ==
  2999. Notas:
  3000. Este comando permite a los usuarios especificar una rama, como rama de
  3001. trabajo. Después de actualizar la rama, actualiza el espacio de trabajo
  3002. a la nueva rama como haría un 'cm partial update'. Sin embargo, si se
  3003. especifica la opción --configure, permite configurar el espacio de trabajo
  3004. teniendo en cuenta los elementos cargados en la nueva rama como haría un
  3005. 'cm partial configure'.
  3006. Ejemplos:
  3007. cm switch br:/main/task
  3008. (Establece /main/task como rama de trabajo y actualiza el espacio de
  3009. trabajo.)
  3010. cm switch br:/main/task --configure +/art/images
  3011. (Establece /main/task como rama de trabajo y configura el directorio
  3012. /art/images.)
  3013. == CMD_DESCRIPTION_PARTIAL_UNCO ==
  3014. Deshace la desprotección de un ítem.
  3015. == CMD_USAGE_PARTIAL_UNCO ==
  3016. Sintaxis:
  3017. cm partial undocheckout | unco <ruta>+ [--silent]
  3018. ruta Ítems sobre los que aplicar la operación, separados por
  3019. espacios.
  3020. Usa comillas (") para especificar rutas con espacios.
  3021. Usa . para aplicar la operación al directorio actual.
  3022. Opciones:
  3023. --silent No muestra ninguna salida.
  3024. == CMD_HELP_PARTIAL_UNCO ==
  3025. Notas:
  3026. Si un ítem está desprotegido y no quieres protegerlo, puede deshacer la
  3027. desprotección usando este comando.
  3028. Se puede deshacer la desprotección tanto a ficheros como a carpetas.
  3029. El ítem se actualizará al estado anterior previo a ser desprotegido.
  3030. Requisitos:
  3031. - El ítem debe estar controlado.
  3032. - El ítem debe estar desprotegido.
  3033. Ejemplos:
  3034. cm partial undocheckout .
  3035. (Deshace las desprotecciones del directorio actual.)
  3036. cm partial undocheckout pic1.png pic2.png
  3037. cm unco c:\workspace\diseño01.png
  3038. (Deshace las desprotecciones de los ítems especificados.)
  3039. == CMD_DESCRIPTION_PARTIAL_UNDO ==
  3040. Deshace cambios en un workspace.
  3041. == CMD_USAGE_PARTIAL_UNDO ==
  3042. Syntaxis:
  3043. cm partial undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
  3044. [Opciones de salida]
  3045. path Rutas de los ficheros o carpetas a los que aplicar
  3046. la operación, separados por espacios. Se pueden
  3047. utilizar comillas (") para especificar rutas con
  3048. espacios. Si no se especifica ninguna ruta, por
  3049. defecto la operación se ejecutará sobre los ficheros
  3050. en el directorio actual.
  3051. Opciones:
  3052. --symlink Aplica la operación de undo al enlace simbólico y
  3053. no a su destino.
  3054. -r Ejecuta el undo de manera recursiva.
  3055. Filtros:
  3056. Si ninguna de estas opciones está presente, por defecto se deshacen todos
  3057. los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
  3058. opciones.
  3059. Si un fichero o directorio tiene uno o más de los tipos de cambio
  3060. especificados, todos los cambios en ese fichero o directorio serán
  3061. deshechos.
  3062. Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
  3063. está tanto movido como checkedout, ambos cambios se desharán.
  3064. --checkedout Selecciona ficheros y directorios marcados para
  3065. cambios.
  3066. --unchanged Selecciona ficheros sin modificaciones en su
  3067. contenido.
  3068. --changed Selecciona ficheros y directorios cambiados o
  3069. marcados para cambios.
  3070. --deleted Selecciona ficheros y directorios eliminados.
  3071. --moved Selecciona ficheros y directorios movidos.
  3072. --added Selecciona ficheros y directorios añadidos.
  3073. Opciones de salida:
  3074. --silent | --machinereadable [--startlineseparator=sep]
  3075. [--endlineseparator=sep] [--fieldseparator=sep]
  3076. --silent No muestra ninguna salida.
  3077. --machinereadable Muestra la salida en un formato fácil de tratar.
  3078. --startlineseparator Usado en conjunto con la opción '--machinereadable',
  3079. especifica cómo deberían comenzar las líneas.
  3080. --endlineseparator Usado en conjunto con la opción '--machinereadable',
  3081. especifica cómo deberían terminar las líneas.
  3082. --fieldseparator Usado en conjunto con la opción '--machinereadable',
  3083. especifica cómo deberían separarse las líneas.
  3084. == CMD_HELP_PARTIAL_UNDO ==
  3085. Notas:
  3086. El comand undo es peligroso - deshace trabajo de una manera irreversible.
  3087. Una vez que el undo termina, no hay manera posible de recuperar el estado
  3088. anterior de los ficheros y directorios afectados. Si no se especifica
  3089. ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
  3090. los elementos del directorio actual, pero NO de manera recursiva.
  3091. Estos comandos son equivalentes ejecutados desde el directorio /src:
  3092. /src
  3093. |- file.txt
  3094. |- code.cs
  3095. \- /test
  3096. |- test_a.py
  3097. \- test_b.py
  3098. $ cm partial undo
  3099. $ cm partial undo *
  3100. $ cm partial undo file.txt code.cs /test
  3101. $ cm partial undo .
  3102. $ cm partial undo /src file.txt code.cs
  3103. Si se quiere que la operación sea recursiva, se necesita especificar la
  3104. opción -r.
  3105. Para deshacer todos los cambios debajo de un directorio (incluyendo los
  3106. cambios sobre el propio directorio):
  3107. $ cm partial undo dirpath -r
  3108. Si dirpath es la ruta de un workspace, todos los cambios dentro del
  3109. workspace serán deshechos.
  3110. Examples:
  3111. $ cm partial undo . -r
  3112. (Deshace todos los cambios en el directorio actual de manera recursiva. Si
  3113. se ejecuta desde la raíz del workspace, deshace todos los cambios en el
  3114. workspace completo.)
  3115. $ cm partial co file.txt
  3116. $ cm partial undo file.txt
  3117. (Deshace el checkout en file.txt.)
  3118. $ echo content >> file.txt
  3119. $ cm partial undo file.txt
  3120. (Deshace el cambio local en file.txt.)
  3121. $ cm partial undo src
  3122. (Deshace los cambios en el directorio src y en todos los ficheros
  3123. controlados que contenga)
  3124. $ cm partial undo src/*
  3125. (Deshace los cambios en todos los elementos contenidos en src, sin afectar
  3126. al propio directorio. Por la expansión del wildcard, es equivalente a
  3127. 'cm partial undo src/file1.txt src/file2.txt').
  3128. $ cm partial undo *.cs
  3129. (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
  3130. directorio actual.)
  3131. $ cm partial undo *.cs -r
  3132. (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
  3133. directorio actual, y en cada directorio por debajo de una manera recursiva.)
  3134. $ cm partial co file1.txt file2.txt
  3135. $ echo content >> file1.txt
  3136. $ cm partial undo --unchanged
  3137. (Deshace el checkout en file2.txt por no estar modificado, ignorando
  3138. file1.txt ya que tiene cambios locales.)
  3139. $ echo content >> file1.txt
  3140. $ echo content >> file2.txt
  3141. $ cm partial co file1.txt
  3142. $ cm partial undo --checkedout
  3143. (Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
  3144. ya que no está en checkout.)
  3145. $ cm partial add file.txt
  3146. $ cm partial undo file.txt
  3147. (Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
  3148. $ rm file1.txt
  3149. $ echo content >> file2.txt
  3150. $ cm partial add file3.txt
  3151. $ cm partial undo --deleted --added *
  3152. (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
  3153. el cambio en file2.txt.)
  3154. == CMD_DESCRIPTION_PARTIAL_UPDATE ==
  3155. Actualiza el espacio de trabajo parcial.
  3156. == CMD_USAGE_PARTIAL_UPDATE ==
  3157. Sintaxis:
  3158. cm partial update [<ruta>+]
  3159. [--changeset=número]
  3160. [--silent | --report]
  3161. ruta Rutas a actualizar, separadas por espacios. Las dobles
  3162. comillas (") deben usarse para especificar rutas que
  3163. contienen espacios.
  3164. Si se usa . entonces se actualiza el directorio actual.
  3165. Si no se especifica ninguna ruta, entonces se actualiza todo
  3166. el espacio de trabajo parcial.
  3167. Opciones:
  3168. --changeset Actualiza el espacio de trabajo parcial al changeset
  3169. especificado.
  3170. --silent No muestra salida.
  3171. --report Imprime una lista de los cambios efectuados una vez que
  3172. termina la operación. Esta opción no tiene efecto si se
  3173. utiliza la opción --silent.
  3174. --dontmerge No procesa los conflictos de fichero. El resto de cambios
  3175. se procesan con normalidad. Esta opción puede ser útil en
  3176. automatización para evitar interacción con el usuario.
  3177. == CMD_HELP_PARTIAL_UPDATE ==
  3178. Notas:
  3179. El comando update actualiza los ficheros desactualizados.
  3180. El comando update siempre asume recursividad.
  3181. Si todas las rutas especificadas son ficheros dentro del mismo xlink y
  3182. se usa la opción --changeset, entonces las versiones a actualizar se buscan
  3183. dentro del changeset del repositorio del xlink.
  3184. Ejemplos:
  3185. cm partial update
  3186. (Actualiza todo el espacio de trabajo parcial.)
  3187. cm partial update .
  3188. (Actualiza todos los hijos del directorio actual.)
  3189. cm partial update fichero1.txt
  3190. (Actualiza el fichero fichero1.txt.)
  3191. cm partial update fichero1.txt fichero2.txt
  3192. (Actualiza los ficheros fichero1.txt y fichero2.txt.)
  3193. cm partial update src --report
  3194. (Actualiza todos los hijos del directorio src, mostrando una lista de los
  3195. cambios aplicados al finalizar.)
  3196. cm partial update src --changeset=4
  3197. (Actualiza todos los hijos del directorio src, al contenido
  3198. que cargaban en el changeset 4.)
  3199. cm partial update xlink/first.png --changeset=4
  3200. (Actualiza el fichero xlink/first.png al contenido que cargaba en el
  3201. changeset 4 del repositorio del xlink.)
  3202. == CMD_DESCRIPTION_PATCH ==
  3203. Genera un parche a partir de una spec o aplica un parche generado en el workspace actual.
  3204. == CMD_USAGE_PATCH ==
  3205. Sintaxis:
  3206. cm patch [source_spec] source_spec
  3207. [--output=output_file] [--tool=/path/to/diff]
  3208. cm patch --apply patch_file [--tool=/path/to/patch]
  3209. source_spec Especificación de rama o changeset
  3210. output_file Fichero que contendrá la salida del comando. Se
  3211. mostrará en pantalla si no se especifica.
  3212. Opciones:
  3213. --output Indica el fichero de destino para almacenar los
  3214. contenidos del parche.
  3215. --tool Especifica la ruta hacia la herramienta necesaria para
  3216. ejecutar la operación (diff o patch).
  3217. == CMD_HELP_PATCH ==
  3218. Notas:
  3219. Este comando genera un fichero patch que contiene las diferencias de una
  3220. rama o un changeset, así como las diferencias entre changesets. Encuentra
  3221. diferencias para ficheros tanto de texto como binarios.
  3222. El parámetro --apply permite aplicar los contenidos de un fichero patch
  3223. en el workspace actual.
  3224. Limitaciones:
  3225. Si el fichero de salida de patch ya existe, el comando no lo
  3226. sobreescribirá.
  3227. Si el fichero con modificaciones en el patch no existe, el comando no
  3228. creará uno nuevo para aplicar los cambios.
  3229. Importante:
  3230. Este comando requiere las utilidades Diff y Patch, disponibles
  3231. en http://gnuwin32.sourceforge.net/packages/patch.htm y
  3232. http://gnuwin32.sourceforge.net/packages/diffutils.htm
  3233. Tras su instalación se recomienda agregar su ubicación a la variable
  3234. de entorno PATH.
  3235. Ejemplos:
  3236. cm patch cs:4@default@localhost:8084
  3237. (Muestra en pantalla las diferencias del changeset 4 en formato patch.)
  3238. cm patch br:/main --output=file.patch
  3239. (Obtiene un fichero file.patch con las diferencias de la rama "main".)
  3240. cm patch br:/main --output=file.patch --tool=C:\gnu\diff.exe
  3241. (Misma operación con un ejecutable indicado explícitamente.)
  3242. cm patch cs:2@default cs:4@default
  3243. (Muestra en pantalla las diferencias entre los changeset 2 y 4.)
  3244. cm patch --apply file.patch --tool=C:\gnu\patch.exe
  3245. (Aplica el parche contenido en file.patch al workspace actual con un
  3246. ejecutable indicado explícitamente.)
  3247. == CMD_DESCRIPTION_QUERY ==
  3248. Ejecuta una consulta SQL contra la base de datos del servidor.
  3249. == CMD_USAGE_QUERY ==
  3250. Uso:
  3251. cm query comandosql [--outputfile=ruta]
  3252. [--solveuser=nombre_columna1,nombre_columna2,...]
  3253. [--solvepath=nombre_columna1,nombre_columna2,...]
  3254. [--columnwidth=valor]
  3255. --outputfile: Escribe en un fichero el resultado de la consulta.
  3256. --solveuser: Indica al intérprete de consultas que la(s) columna(s)
  3257. especificada(s) contiene(n) usuarios. Se tratarán de resolver
  3258. identificadores de usuario a nombres de usuario.
  3259. --solvepath: Indica al intérprete de consultas que la(s) columna(s)
  3260. especificadas(s) contiene(n) identificadores de ítem. Se tratarán de
  3261. resolver los identificadores a rutas de disco.
  3262. --columnwidth: Especifica la anchura de cada columna del resultado de la
  3263. consulta.
  3264. == CMD_HELP_QUERY ==
  3265. Notas:
  3266. Este comando permite a los usuarios ejecutar consultas SQL directamente
  3267. contra la base de datos del servidor.
  3268. A continuación se detalla el esquema (tablas y campos de cada tabla)
  3269. disponibles para realizar consultas.
  3270. ITEMS
  3271. OBJECTID (integer)
  3272. CREATIONDATE (datetime)
  3273. OWNER (string)
  3274. REVISIONS
  3275. OBJECTID (integer)
  3276. SIZEBYTES (integer)
  3277. ITEMID (integer)
  3278. BRANCHID (integer)
  3279. CHANGESET (integer)
  3280. COMMENT (string)
  3281. CREATIONDATE (datetime)
  3282. OWNER (string)
  3283. CHECKOUTS
  3284. REVISIONID (integer)
  3285. WORKSPACESERVER (string)
  3286. CLIENTMACHINE (string)
  3287. EXCLUSIVE (char)
  3288. CREATIONDATE (datetime)
  3289. OWNER (string)
  3290. BRANCHES
  3291. OBJECTID (integer)
  3292. NAME (string)
  3293. PARENTBRANCHID (integer)
  3294. CREATIONDATE (datetime)
  3295. OWNER (string)
  3296. LABELS
  3297. OBJECTID (integer)
  3298. NAME (string)
  3299. CREATIONDATE (datetime)
  3300. OWNER (string)
  3301. LABELEDREVISIONS
  3302. LABELID (integer)
  3303. REVISIONID (integer)
  3304. CREATIONDATE (datetime)
  3305. OWNER (string)
  3306. LINKS
  3307. OBJECTID (integer)
  3308. NAME (string)
  3309. CREATIONDATE (datetime)
  3310. OWNER (string)
  3311. LINKEDOBJECTS
  3312. LINKID (integer)
  3313. SOURCEOBJECTID (integer)
  3314. DESTINATIONOBJECTID (integer)
  3315. CREATIONDATE (datetime)
  3316. OWNER (string)
  3317. ATTRIBUTES
  3318. OBJECTID (integer)
  3319. NAME (string)
  3320. CREATIONDATE (datetime)
  3321. OWNER (string)
  3322. OBJECTSWITHATTRIBUTES
  3323. ATTRIBUTEID (integer)
  3324. SOURCEOBJECTID (integer)
  3325. ATTRIBUTEVALUE (string)
  3326. CREATIONDATE (datetime)
  3327. OWNER (string)
  3328. CHANGESETS
  3329. CHANGESETNUMBER (integer)
  3330. CREATIONDATE (datetime)
  3331. OWNER (string)
  3332. Además, a la hora de escribir consultas, existen dos functiones predefinidas
  3333. para trabajar con usuarios y rutas de disco.
  3334. Estas funciones son las siguientes:
  3335. * SolveUser(nombre_usuario), resuelve el nombre de usuario dado al formato que
  3336. maneja Plastic SCM.
  3337. * SolvePath(path), resuelve rutas de disco a identificadores de ítem itemid.
  3338. Para mostrar el resultado de las consultas de forma legible al usuario, se
  3339. puede indicar al intérprete de consultas que convierta identificadores de
  3340. usuario a nombres de usuario, e identificadores de ítem a rutas de disco.
  3341. Para ello se utilizan las opciones:
  3342. --solveuser=nombre_columna
  3343. --solvepath=nombre_columna
  3344. Se pueden especificar varios nombres de columnas separados por comas.
  3345. Ejemplos:
  3346. cm query "SELECT * FROM revision"
  3347. cm query "SELECT b.sname as br_name, o.dtimestamp as date from branch b, object o, seid s
  3348. where b.iobjid=o.iobjid and o.fidowner=s.iseidid and s.scode='SolveUser(juan)'"
  3349. cm query "SELECT * FROM REVISION WHERE itemid=SolvePath(c:\mi_workspace)"
  3350. cm query "SELECT r.iobjid, r.fiditem as ruta, s.scode as nombre_usuario FROM revision r, object o, seid s
  3351. WHERE r.iobjid=o.iobjid and o.fidowner=s.iseidid" --solveuser=nombre_usuario --solvepath=ruta
  3352. == CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
  3353. Borra uno o más atributos.
  3354. == CMD_USAGE_ATTRIBUTE_DELETE ==
  3355. Sintaxis:
  3356. cm attribute delete spec_atributo1 spec_atributo2 ...
  3357. spec_atributo Atributos a borrar, separados por espacios.
  3358. Usa 'cm help objectspec' para obtener más información
  3359. sobre la especificación de atributos.
  3360. == CMD_HELP_ATTRIBUTE_DELETE ==
  3361. Notas:
  3362. Este comando borra uno o más atributos creados previamente.
  3363. Los parámetros son especificaciones de atributos, dados en el formato
  3364. att:nombre.
  3365. Ejemplos:
  3366. cm attribute delete att:Status
  3367. (Borra el atributo 'Status'.)
  3368. cm att rm status att:integrated@reptest@server2:8084
  3369. (Borrar los atributos 'status' e 'integrated'.)
  3370. == CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
  3371. Borra un atributo que ha sido fijado previamente en un objeto.
  3372. == CMD_USAGE_ATTRIBUTE_UNSET ==
  3373. Sintaxis:
  3374. cm attribute unset spec_atributo spec_objeto
  3375. spec_atributo Especificación del atributo.
  3376. spec_objeto Especificación del objeto sobre el que fijar
  3377. el atributo.
  3378. Se pueden fijar atributos sobre ramas, changesets,
  3379. shelvesets, etiquetas, items y revisiones.
  3380. Usa 'cm help objectspec' para obtener más información sobre especificación
  3381. de objetos.
  3382. == CMD_HELP_ATTRIBUTE_UNSET ==
  3383. Notas:
  3384. Un atributo que ha sido fijado previamente a un objeto puede ser borrado
  3385. con este comando. Se borra la realización del atributo en el objeto pero
  3386. no el atributo.
  3387. Usa 'cm help objectspec' para aprender cómo indicar especificaciones de
  3388. objetos.
  3389. Ejemplo:
  3390. cm attribute unset att:Status br:/main/SCM105
  3391. == CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
  3392. Renombra un atributo.
  3393. == CMD_USAGE_ATTRIBUTE_RENAME ==
  3394. Sintaxis:
  3395. cm attribute rename spec_atributo nuevo_nombre
  3396. spec_atributo: Especificación del atributo que se va a renombrar.
  3397. Usa 'cm help objectspec' para obtener más información sobre
  3398. la especificación de atributos.
  3399. nuevo_nombre: Nuevo nombre para el atributo.
  3400. == CMD_HELP_ATTRIBUTE_RENAME ==
  3401. Notas:
  3402. Este comando renombra un atributo.
  3403. Ejemplos:
  3404. cm attribute rename att:Status state
  3405. (El atributo 'Status' se renombra a 'state')
  3406. == CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
  3407. Editar el comentario de un atributo.
  3408. == CMD_USAGE_ATTRIBUTE_EDIT ==
  3409. Sintaxis:
  3410. cm attribute edit spec_atributo nuevo_comentario
  3411. spec_atributo: Especificación del atributo objetivo del cambio.
  3412. Usa 'cm help objectspec' para obtener más información sobre
  3413. la especificación de atributos.
  3414. nuevo_comentario: Nuevo comentario para el atributo. También puedes
  3415. especificar una lista de valores por defecto para el
  3416. atributo.
  3417. == CMD_HELP_ATTRIBUTE_EDIT ==
  3418. Notas:
  3419. Este comando cambia el comentario de un atributo.
  3420. Para especificar la lista de valores por defecto para un atributo, solo
  3421. tienes que incluir un texto como este en el comentario del atributo:
  3422. 'default: valor_uno, "valor dos", valor3, "Valor final"'.
  3423. Ejemplos:
  3424. cm attribute edit att:status "The status of a branch in the CI pipeline."
  3425. (Edita el comentario del atributo "status".)
  3426. cm attribute edit att:status "Status of a branch. default: open, resolved, reviewed"
  3427. (Edita el comentario del atributo "status". Y también especifica una lista
  3428. de valores. De este modo, cuando apliques el atribute "status" a un objeto,
  3429. podrás seleccionar uno de los siguientes valores: "open", "resolved" o
  3430. "reviewed".)
  3431. == CMD_DESCRIPTION_REPLICATE ==
  3432. ATENCIÓN: Este comando se ha declarado obsoleto.
  3433. Ha sido reemplazado por 'pull' (equivalente a 'replicate') y por 'push'
  3434. (equivalente a 'replicate --push').
  3435. Replica datos desde un repositorio remoto.
  3436. == CMD_USAGE_REPLICATE ==
  3437. Uso:
  3438. cm replicate br_spec dst_rep_spec [--nodata] [translateOptions] [authOptions]
  3439. cm replicate hydrate br_spec [src_rep_spec] [authOptions]
  3440. cm replicate hydrate cs_spec [src_rep_spec] [authOptions]
  3441. cm replicate br_spec --package=packagename [--changeset=número]
  3442. cm replicate dst_rep_spec --import=packagename
  3443. br_spec: la rama para ser replicada/hidratada. Es una especificación
  3444. completa de rama con el siguiente formato:
  3445. br:/NOMBRE_RAMA[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
  3446. cs_spec: changeset para ser hidratado. Es una espec. de changeset:
  3447. cs:NUMERO_CHANGESET[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
  3448. src_rep_sec: repositorio origen de los datos. Es una especificación
  3449. completa de repositorio:
  3450. rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
  3451. dst_rep_sec: repositorio destino de la replica. Es una especificación
  3452. completa de repositorio:
  3453. rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
  3454. Opciones:
  3455. --package para crear un paquete de replicación.
  3456. --import para importar un paquete concreto.
  3457. --nodata para replicar los cambios de una rama sin replicar sus datos. Esta
  3458. opción no se puede usar para la réplica con paquetes ni con la opción
  3459. --push.
  3460. Opciones de traducción:
  3461. --trmode=[copy | name | table] para especificar cómo tratar los
  3462. nombres de usuario cuando se importen los datos en el
  3463. repositorio de destino:
  3464. * copy -> es el utilizado por defecto. Copia los SEIDs en el
  3465. repositorio de destino.
  3466. * name -> realiza una traducción por nombre entre el modo
  3467. de autentificación de origen y el de destino.
  3468. * table -> se usará una tabla de traducción en la que se
  3469. especifican los nombres de origen y cómo han de quedar
  3470. en el destino.
  3471. --trtable=[translationTable]
  3472. una tabla de traducción es un fichero que contiene entradas
  3473. en la forma nombre antiguo;nombre nuevo.
  3474. Opciones de autentificación:
  3475. Hay dos formas de especificar los datos de autentificación:
  3476. 1) Especificando un fichero de autentificación.
  3477. --authfile=fichero, un fichero que contiene dos líneas: el modo de
  3478. autentificación en la primera línea y los datos de autentificación
  3479. (ver --authdata) o una cadena vacía en la segunda.
  3480. 2) Especificando la autentificación mediante parámetros.
  3481. Para ello hay que especificar el modo de autentificación mediante el
  3482. modificador:
  3483. --authmode=[NameWorkingMode | NameIDWorkingMode |
  3484. LDAPWorkingMode | ADWorkingMode | UPWorkingMode]
  3485. Si está trabajando en UPWorkingMode o LDAPWorkingMode, puede
  3486. especificar los datos de autentificación de dos formas:
  3487. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  3488. --authdata=datos_de_autentificación
  3489. Ejemplos:
  3490. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  3491. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  3492. 2.2) Solamente para UPWorkingMode:
  3493. --user=usuario
  3494. --password=contraseña
  3495. == CMD_HELP_REPLICATE ==
  3496. Notas:
  3497. El comando 'replicate' replica datos desde una rama hacia un
  3498. repositorio de destino. Todos los datos de la rama de origen, incluyendo
  3499. revisiones, ítems, changesets, etiquetas, revisiones de código, links
  3500. y seguridad serán replicados.
  3501. Su cliente Plastic SCM debe estar configurado para trabajar con el
  3502. repositorio de destino.
  3503. La replicación también gestiona la 'reconciliación' de ramas que han
  3504. sido modificadas tanto en origen como en destino, mediante la creación
  3505. de 'ramas de entrega' (fetch branches) que podrán ser integradas
  3506. posteriormente para resolver los conflictos.
  3507. La replicación puede funcionar en tres modos diferentes:
  3508. 1- Comunicación directa entre servidores: lo que significa que el servidor
  3509. de destino se comunicará con el de origen para sincronizar la rama
  3510. especificada.
  3511. 2- Generación de paquete de exportación: el cliente se conectará
  3512. únicamente con el destino para generar un paquete de replicación con los
  3513. datos y los metadatos de la rama especificada. Se usará el modificador
  3514. --package. El usuario podrá especificar, opcionalmente, un changeset
  3515. inicial desde el cual generar la replicación.
  3516. 3- Importar un paquete generado previamente, usando la opción --import.
  3517. En los modos 1 y 2 será necesaria la autentificación contra el servidor
  3518. de origen. El comando 'replicate' acepta parámetros para especificar los
  3519. diferentes modos de autentificación.
  3520. Ejemplos:
  3521. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090
  3522. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=name
  3523. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=table --trtable=tabla.txt
  3524. cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --authmode=NameWorkingMode --user=john.doe
  3525. Significa que se autentificará contra el servidor 'MADRID' usando NameWorkingMode como usuario 'john.doe'
  3526. cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data
  3527. Creará un paquete de replicación
  3528. cm replicate rep:mine@repserver:casa:9094 --import=replicationpackage.data
  3529. Importará el paquete creado con anterioridad
  3530. cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data --changeset=1230
  3531. Generará un paquete de replicación de la rama br:/main/releaseBL060 desde el changeset 1230
  3532. cm replicate /main@project1@LONDRES:8084 projectx@localhost:8084 --nodata
  3533. Replicará la rama /main del servidor LONDRES a mi servidor sin replica los datos.
  3534. cm replicate hydrate /main@projectx@localhost:8084 project1@LONDRES:8084
  3535. Hidratará los datos de la rama /main de mi servidor, usando los datos del servidor LONDRES.
  3536. Nota adicional:
  3537. La tabla de traducción tiene entradas (una por línea) con el siguiente
  3538. formato:
  3539. nombre antiguo;nombre nuevo
  3540. == CMD_DESCRIPTION_PULL ==
  3541. Replica datos desde un repositorio remoto.
  3542. == CMD_USAGE_PULL ==
  3543. Uso:
  3544. cm pull src_br_spec dst_rep_spec
  3545. [--preview] [--nodata] [translateOptions]
  3546. [--user=usr_name [--password=pwd] | AuthOptions]
  3547. (Replicación directa entre servidores. Hace pull de una rama desde un
  3548. repositorio.)
  3549. cm pull dst_rep_spec --package=pack_file [AuthOptions]
  3550. (Replicación basada en paquetes. Importa el paquete en el servidor de
  3551. destino.)
  3552. cm pull hydrate dst_br_spec [src_rep_spec]
  3553. [--user=usr_name [--password=pwd] | AuthOptions]
  3554. (Introduce los datos restantes para todos los changesets de una rama
  3555. replicada previamente con la opción --nodata. Si no se especifica un
  3556. repositorio del que obtener los datos, Plastic intentará usar el origen
  3557. de replicación original de la rama.)
  3558. cm pull hydrate dst_cs_spec [src_rep_spec]
  3559. [--user=usr_name [--password=pwd] | AuthOptions]
  3560. (Introduce los datos restantes para un changeset replicado previamente
  3561. con la opción --nodata. Si no se especifica un repositorio del que obtener
  3562. los datos, Plastic intentará usar el origen de replicación original de
  3563. la rama.)
  3564. src_br_spec La rama a ser replicada desde un repositorio remoto.
  3565. dst_br_spec La rama a ser hidratada.
  3566. Especificación de ramas:
  3567. [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  3568. dst_cs_spec El changeset a ser hidratado.
  3569. Especificación de changesets:
  3570. cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  3571. dst_rep_spec El repositorio de destino.
  3572. Especificación de repositorio:
  3573. [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
  3574. --package El fichero de donde se importa un paquete de replicación
  3575. creado anteriormente.
  3576. Es útil para mover datos entre servidores sin una
  3577. conexión de red directa.
  3578. Consule 'cm push' para crear paquetes de replicación.
  3579. Opciones:
  3580. --preview Proporciona información sobre qué cambios serán traídos
  3581. durante el pull, pero no se ejecuta ninguna acción más.
  3582. Esta opción es útil para comprobar qué datos serán
  3583. replicados antes de ejecutar el pull.
  3584. --user, --password Credenciales para utilizar en caso de que el modo de
  3585. autenticación de los servidores origen y destino
  3586. difieran, y no exista un profile para autenticarse
  3587. contra el remoto.
  3588. --nodata Replica los metadatos de una rama sin replicar los
  3589. datos. Esta opción no se puede utilizar al importar un
  3590. paquete de replicación.
  3591. Opciones de traducción (translateOptions):
  3592. --trmode={copy|name|table}
  3593. El servidor de origen y de destino pueden utilizar modos distintos de
  3594. autenticación. Este argumento especifica cómo se han de traducir los
  3595. nombres de usuario del origen al destino.
  3596. - copy El modo por defecto, indica que los nombres de usuario serán
  3597. simplemente copiados.
  3598. - name Los nombres de usuario serán emparejados entre origen y
  3599. destino por coincidencia.
  3600. - table Se utilizará una tabla de traducción (más información a
  3601. continuación).
  3602. --trtable={translation_table_file}
  3603. Si el modo de traducción es 'table', entonces una tabla de traducción
  3604. es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
  3605. Cuando la rama se escribe en el repositorio de destino, los objetos
  3606. creados por un usuario identificado por "nombreantiguo" en el
  3607. repositorio de origen serán asignados al usuario identificado por
  3608. "nombrenuevo" en el repositorio de destino.
  3609. Opciones de autentificación (AuthOptions):
  3610. Hay dos formas de especificar los datos de autentificación:
  3611. 1) Especificando la autentificación mediante parámetros:
  3612. --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
  3613. (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  3614. (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
  3615. El parámetro '--authdata' es el contenido del campo <SecurityConfig>
  3616. en los ficheros client.conf o profiles.conf. El fichero profiles.conf
  3617. puede ser generado desde la GUI de Plastic SCM (Windows).
  3618. Si se utiliza UPWorkingMode, se puede especificar simplemente:
  3619. --authmode=UPWorkingMode --user=user --password=pwd
  3620. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  3621. --authdata=datos_de_autentificación
  3622. Ejemplos:
  3623. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  3624. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  3625. 2.2) Solamente para UPWorkingMode:
  3626. --user=usuario
  3627. --password=contraseña
  3628. 1) Especificando un fichero de autentificación. Se pueden tener varios
  3629. ficheros de autenticación, uno por servidor al que se conecte,
  3630. conteniendo las credenciales específicas para dicho servidor.
  3631. --authfile=fichero
  3632. Contiene 2 líneas:
  3633. Línea 1) modo de autenticación, igual que para --authmode.
  3634. Línea 2) datos de autenticación, igual que para --authdata.
  3635. == CMD_HELP_PULL ==
  3636. Notas:
  3637. El comando pull replica ramas (junto a sus changesets) entre un repositorio
  3638. origen y otro destino. Los repositorios pueden encontrarse en diferentes
  3639. servidores.
  3640. Hay dos operaciones de replicación: push y pull.
  3641. Una operación de 'pull' significa que la operación de replicación hará que
  3642. el servidor destino obtenga datos desde el origen. El cliente se conectará
  3643. con el servidor destino, y, desde ese host, establecerá una conexión con el
  3644. repositorio origen para recuperar los datos pedidos. Durante el pull, será
  3645. el servidor destino el que se conecte al origen.
  3646. Aunque en un escenario distribuido típico el desarrollador haga pùsh de los
  3647. cambios en su servidor local al servidor central, también puede ser
  3648. necesario hacer pull de los últimos cambios en el servidor central al
  3649. servidor local.
  3650. La replicación puede resolver situaciones en las que se hagan cambios
  3651. concurrentes en la misma rama en dos repositorios replicados:
  3652. - Push: si se intenta hacer push de datos locales a un repositorio que tenga
  3653. datos más nuevos que los que se están enviando, el sistema pedirá hacer
  3654. pull de los últimos cambios, resolver el merge resultante y, finalmente,
  3655. tratar de repetir el push.
  3656. - Pull: cuando se hace pull de changesets de una rama remota, estos estarán
  3657. correctamente enlazados a sus changesets padre. Si el changeset que se ha
  3658. traído no es un hijo del último changeset de la rama, entonces aparecerá
  3659. un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
  3660. dicho de otro modo, más de un changeset final de rama. Será necesario
  3661. hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
  3662. El pull puede funcionar de dos modos:
  3663. 1) Comunicación directa entre servidores: lo que significa que el servidor
  3664. de destino se comunicará con el de origen para sincronizar la rama
  3665. especificada.
  3666. 2) Importación de un paquete de replicación generado con push, con la opción
  3667. --package.
  3668. El modo 1) requere que el usuario que ejecute el comando esté autenticado
  3669. contra el servidor remoto, bien o usando la autenticación por defecto en
  3670. el fichero client.conf, mediante un profile creado previamente, o
  3671. especificando los argumentos --authmode y --authdata (o --user y --password
  3672. en caso de que el modo de autenticación sea UPWorkingMode).
  3673. El modo 2) require usar un paquete de replicación generado previamente con
  3674. el comando push.
  3675. Recuerde que la replicación pull funciona de una manera indirecta. Cuando
  3676. se ejecuta, el comando pide al repositorio destino que se conecte con el
  3677. origen para obtener la rama especificada.
  3678. Sin embargo, esto se puede hacer de manera directa utilizando el comando
  3679. push, que hará que sea el repositorio origen quien envíe los datos
  3680. directamente al destino.
  3681. Ejemplos:
  3682. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084
  3683. (Hace pull de la rama principal de remoteserver a myserver. En este caso,
  3684. ambos servidores están configurados con el mismo modo de autenticación.)
  3685. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  3686. (Hace pull de la misma rama que antes, pero ahora el servidor remoto está
  3687. configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
  3688. se puede conectar de una máquina Linux a un servidor Windows configurado
  3689. para usar Active Directory. Para ello, se especificará el usuario y la
  3690. contraseña cifrada.)
  3691. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
  3692. (Hace pull de la misma rama, pero ahora ambos usuarios están autenticados
  3693. en el servidor remoto mediante el sistema de gestión de usuarios integrado
  3694. en Plastic SCM.)
  3695. cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --nodata
  3696. (Hace pull de la rama principal de remoteserver a myserver pero sin datos.)
  3697. cm pull hydrate br:/main@projectx@myserver:8084 projectx@remoteserver:8084
  3698. (Introduce los datos de todos los changesets de la rama principal obteniendo
  3699. dichos datos del repositorio en remoteserver.)
  3700. cm pull hydrate cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
  3701. (Introduce los datos del changeset 122169 en myserver obteniendo dichos
  3702. datos del repositorio en remoteserver.)
  3703. Nota adicional:
  3704. La tabla de traducción tiene entradas (una por línea) de la forma:
  3705. nombre antiguo;nombre nuevo
  3706. == CMD_DESCRIPTION_PUSH ==
  3707. Replica datos hacia un repositorio remoto.
  3708. == CMD_USAGE_PUSH ==
  3709. Uso:
  3710. cm push src_br_spec dst_rep_spec
  3711. [--preview] [translateOptions]
  3712. [--user=usr_name [--password=pwd] | AuthOptions]
  3713. (Replicación directa entre servidores. Hace push de una rama hacia un
  3714. repositorio.)
  3715. cm push src_br_spec --package=pack_file [AuthOptions]
  3716. (Replicación basada en paquetes. Crea un paquete de replicación con la
  3717. rama especificada.)
  3718. src_br_spec La rama a ser replicada desde un repositorio remoto.
  3719. Especificación de ramas:
  3720. [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  3721. dst_cs_spec El changeset a ser hidratado.
  3722. Especificación de changesets:
  3723. cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
  3724. dst_rep_spec El repositorio de destino.
  3725. Especificación de repositorio:
  3726. [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
  3727. --package Exporta un paquete de replicación al fichero especificado.
  3728. Es útil para mover datos entre servidores sin una
  3729. conexión de red directa.
  3730. Opciones:
  3731. --preview Proporciona información sobre qué cambios serán enviados
  3732. durante el push, pero no se ejecuta ninguna acción más.
  3733. Esta opción es útil para comprobar qué datos serán
  3734. replicados antes de ejecutar el push.
  3735. --user, --password Credenciales para utilizar en caso de que el modo de
  3736. autenticación de los servidores origen y destino
  3737. difieran, y no exista un profile para autenticarse
  3738. contra el remoto.
  3739. --nodata Replica los metadatos de una rama sin replicar los
  3740. datos. Esta opción no se puede utilizar al exportar un
  3741. paquete de replicación.
  3742. Opciones de traducción (translateOptions):
  3743. --trmode={copy|name|table}
  3744. El servidor de origen y de destino pueden utilizar modos distintos de
  3745. autenticación. Este argumento especifica cómo se han de traducir los
  3746. nombres de usuario del origen al destino.
  3747. - copy El modo por defecto, indica que los nombres de usuario serán
  3748. simplemente copiados.
  3749. - name Los nombres de usuario serán emparejados entre origen y
  3750. destino por coincidencia.
  3751. - table Se utilizará una tabla de traducción (más información a
  3752. continuación).
  3753. --trtable={translation_table_file}
  3754. Si el modo de traducción es 'table', entonces una tabla de traducción
  3755. es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
  3756. Cuando la rama se escribe en el repositorio de destino, los objetos
  3757. creados por un usuario identificado por "nombreantiguo" en el
  3758. repositorio de origen serán asignados al usuario identificado por
  3759. "nombrenuevo" en el repositorio de destino.
  3760. Opciones de autentificación (AuthOptions):
  3761. Hay dos formas de especificar los datos de autentificación:
  3762. 1) Especificando la autentificación mediante parámetros:
  3763. --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
  3764. (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  3765. (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
  3766. El parámetro '--authdata' es el contenido del campo <SecurityConfig>
  3767. en los ficheros client.conf o profiles.conf. El fichero profiles.conf
  3768. puede ser generado desde la GUI de Plastic SCM (Windows).
  3769. Si se utiliza UPWorkingMode, se puede especificar simplemente:
  3770. --authmode=UPWorkingMode --user=user --password=pwd
  3771. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  3772. --authdata=datos_de_autentificación
  3773. Ejemplos:
  3774. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  3775. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  3776. 2.2) Solamente para UPWorkingMode:
  3777. --user=usuario
  3778. --password=contraseña
  3779. 1) Especificando un fichero de autentificación. Se pueden tener varios
  3780. ficheros de autenticación, uno por servidor al que se conecte,
  3781. conteniendo las credenciales específicas para dicho servidor.
  3782. --authfile=fichero
  3783. Contiene 2 líneas:
  3784. Línea 1) modo de autenticación, igual que para --authmode.
  3785. Línea 2) datos de autenticación, igual que para --authdata.
  3786. == CMD_HELP_PUSH ==
  3787. Notas:
  3788. El comando pull replica ramas (junto a sus changesets) entre un repositorio
  3789. origen y otro destino. Los repositorios pueden encontrarse en diferentes
  3790. servidores.
  3791. Hay dos operaciones de replicación: push y pull.
  3792. Una operación de 'push' significa que la operación de replicación enviará
  3793. datos desde el repositorio origen al repositorio destino. En este caso, el
  3794. cliente se conectará al repositorio origen, recuperando los datos para ser
  3795. replicados, y entonces los enviará al repositorio destino. Mientras que el
  3796. origen necesita tener conectividad con el destino, el destino no se
  3797. conectará con el origen.
  3798. En un escenario distribuido típico el desarrollador hace push de los
  3799. cambios en su servidor local al servidor central. También puede ser
  3800. necesario hacer pull de los últimos cambios en el servidor central al
  3801. servidor local.
  3802. La replicación puede resolver situaciones en las que se hagan cambios
  3803. concurrentes en la misma rama en dos repositorios replicados:
  3804. - Push: si se intenta hacer push de datos locales a un repositorio que tenga
  3805. datos más nuevos que los que se están enviando, el sistema pedirá hacer
  3806. pull de los últimos cambios, resolver el merge resultante y, finalmente,
  3807. tratar de repetir el push.
  3808. - Pull: cuando se hace pull de changesets de una rama remota, estos estarán
  3809. correctamente enlazados a sus changesets padre. Si el changeset que se ha
  3810. traído no es un hijo del último changeset de la rama, entonces aparecerá
  3811. un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
  3812. dicho de otro modo, más de un changeset final de rama. Será necesario
  3813. hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
  3814. El push puede funcionar de dos modos:
  3815. 1) Comunicación directa entre servidores: lo que significa que el servidor
  3816. de origen se comunicará con el de destino para sincronizar la rama
  3817. especificada.
  3818. 2) Exportación de un paquete de replicación: El cliente únicamente se
  3819. conectará con el origen y generará un paquete de replicación que contenga
  3820. tanto los datos como los metadatos para la rama especificada. Para ello
  3821. se utilizará el argumento --package.
  3822. Ambos modos requeren que el usuario ejecutando el comando esté autenticado
  3823. contra el servidor, bien o usando la autenticación por defecto en el fichero
  3824. client.conf, mediante un profile creado previamente, o especificando los
  3825. argumentos --authmode y --authdata (o --user y --password en caso de que
  3826. el modo de autenticación sea UPWorkingMode).
  3827. La replicación push funciona de una manera directa. Cuando se ejecuta, el
  3828. comando replicará la rama seleccionada del origen al destino, en vez de
  3829. pedir al repositorio destino que se conecte al repositorio origen para
  3830. obtener la rama especificada (como hace pull).
  3831. Ejemplos:
  3832. cm push br:/main@project1@myserver:8084 projectx@remoteserver:8084
  3833. (Hace push de la rama main desde myserver a remoteserver. En este caso,
  3834. ambos servidores están configurados con el mismo modo de autenticación.)
  3835. cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  3836. (Hace push de la misma rama que antes, pero ahora el servidor remoto está
  3837. configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
  3838. se puede conectar de una máquina Linux a un servidor Windows configurado
  3839. para usar Active Directory. Para ello, se especificará el usuario y la
  3840. contraseña cifrada.)
  3841. cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
  3842. (Hace push de la misma rama, pero ahora ambos usuarios están autenticados
  3843. en el servidor remoto mediante el sistema de gestión de usuarios integrado
  3844. en Plastic SCM.)
  3845. Nota adicional:
  3846. La tabla de traducción tiene entradas (una por línea) de la forma:
  3847. nombre antiguo;nombre nuevo
  3848. == CMD_DESCRIPTION_CLONE ==
  3849. Clona un repositorio remoto.
  3850. == CMD_USAGE_CLONE ==
  3851. Sintaxis:
  3852. cm clone src_rep_spec [dst_rep_spec | repserver:dst_repserver_spec]
  3853. [--user=usr_name [--password=pwd] | AuthOptions]
  3854. [TranslateOptions]
  3855. (Clonado directo repositorio-a-repositorio.)
  3856. cm clone src_rep_spec --package=pack_file
  3857. [--user=usr_name [--password=pwd] | AuthOptions]
  3858. (Clonado utilizando un paquete intermedio, que se podrá importar
  3859. posteriormente al repositorio destino mediante un pull.)
  3860. src_rep_spec Repositorio origen de la operación de clonado.
  3861. dst_rep_spec Repositorio destino de la operación de clonado.
  3862. Si existe, debe estar vacío. Si no existe, será creado
  3863. automáticamente.
  3864. Si no se especifica, el comando utilizará el servidor
  3865. de repositorios por defecto.
  3866. Usa 'cm help objectspec' para obtener más información
  3867. sobre la especificación de repositorios.
  3868. dst_repserver_spec Servidor de repositorios destino de la operación de
  3869. clonado. Si existe un repositorio con el mismo nombre
  3870. que src_rep_spec, debe estar vacío. Si no existe, será
  3871. creado automáticamente.
  3872. Si no se especifica, el comando utilizará el servidor
  3873. de repositorios por defecto.
  3874. Usa 'cm help objectspec' para obtener más información
  3875. sobre la especificación servidores de repositorio.
  3876. pack_file Ruta de destino del paquete.
  3877. Options:
  3878. --user, --password Credenciales para utilizar en caso de que el modo de
  3879. autenticación de los servidores origen y destino
  3880. difieran, y no exista un profile para autenticarse
  3881. contra el remoto.
  3882. --package Exporta un paquete de replicación al fichero
  3883. especificado.
  3884. Es útil para mover datos entre servidores sin una
  3885. conexión de red directa.
  3886. El paquete resultante ha de ser importado mediante el
  3887. comand pull.
  3888. Opciones de traducción (TranslateOptions):
  3889. --trmode={copy|name|table}
  3890. El servidor de origen y de destino pueden utilizar modos distintos de
  3891. autenticación. Este argumento especifica cómo se han de traducir los
  3892. nombres de usuario del origen al destino.
  3893. - copy El modo por defecto, indica que los nombres de usuario serán
  3894. simplemente copiados.
  3895. - name Los nombres de usuario serán emparejados entre origen y
  3896. destino por coincidencia.
  3897. - table Se utilizará una tabla de traducción (más información a
  3898. continuación).
  3899. --trtable={translation_table_file}
  3900. Si el modo de traducción es 'table', entonces una tabla de traducción
  3901. es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
  3902. Cuando la rama se escribe en el repositorio de destino, los objetos
  3903. creados por un usuario identificado por "nombreantiguo" en el
  3904. repositorio de origen serán asignados al usuario identificado por
  3905. "nombrenuevo" en el repositorio de destino.
  3906. Opciones de autentificación (AuthOptions):
  3907. Hay dos formas de especificar los datos de autentificación:
  3908. 1) Especificando la autentificación mediante parámetros:
  3909. --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
  3910. (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
  3911. (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
  3912. El parámetro '--authdata' es el contenido del campo <SecurityConfig>
  3913. en los ficheros client.conf o profiles.conf. El fichero profiles.conf
  3914. puede ser generado desde la GUI de Plastic SCM (Windows).
  3915. Si se utiliza UPWorkingMode, se puede especificar simplemente:
  3916. --authmode=UPWorkingMode --user=user --password=pwd
  3917. 2.1) Para UPWorkingMode o LDAPWorkingMode:
  3918. --authdata=datos_de_autentificación
  3919. Ejemplos:
  3920. --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
  3921. --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
  3922. 2.2) Solamente para UPWorkingMode:
  3923. --user=usuario
  3924. --password=contraseña
  3925. 1) Especificando un fichero de autentificación. Se pueden tener varios
  3926. ficheros de autenticación, uno por servidor al que se conecte,
  3927. conteniendo las credenciales específicas para dicho servidor.
  3928. --authfile=fichero
  3929. Contiene 2 líneas:
  3930. Línea 1) modo de autenticación, igual que para --authmode.
  3931. Línea 2) datos de autenticación, igual que para --authdata.
  3932. == CMD_HELP_CLONE ==
  3933. Notas:
  3934. El comando clone replica ramas (junto a sus changesets, etiquetas, atributos,
  3935. reviews, etc.) desde un repositorio origen a otro repositorio destino.
  3936. Los repositorios pueden encontrarse en diferentes servidores.
  3937. El repositorio destino puede existir de antemano, pero si contiene datos
  3938. previos, la operación de clone fallará.
  3939. La operación de clone NO clona submódulos, ni repositorios que se encuentren
  3940. debajo de un xLink.
  3941. Ejemplos:
  3942. cm clone awesomeProject@tardis@cloud
  3943. (Clona el repositorio 'awesomeProject' de la organización Cloud tardis@cloud
  3944. en un repositorio local del mismo nombre.)
  3945. cm clone repo@server.home:9095 repo-local
  3946. (Clona 'repo' desde 'server.home:9095' en 'repo-local' localizado en el
  3947. servidor de repositorios por defecto del usuario.)
  3948. cm clone project@192.168.111.130:8084 repserver:192.168.111.200:9095
  3949. (Clona 'project' desde '192.168.111.130:8084' en
  3950. 'project@192.168.111.200:9095'.)
  3951. cm clone project@ldapserver:8084 --authfile=credentials.txt --trmode=table --trtable=table.txt
  3952. (Clona el repositorio 'project' desde 'ldapserver:8084' utilizando un fichero
  3953. para autenticarse contra el servidor remoto, y traduciendo los usuarios
  3954. siguiendo la tabla de traducción especificada.)
  3955. cm clone project@server.home:9095 --package=project.plasticpkg
  3956. cm mkrep project@mordor.home:8084
  3957. cm pull --package=project.plasticpkg project@mordor.home:8084
  3958. (Clona 'project' desde 'server.home:9095' al paquete 'project.plasticpkg',
  3959. que se importa posteriormente en el repositorio 'project' de
  3960. 'mordor.home:8084' mediante una operación de pull.)
  3961. Nota adicional:
  3962. La tabla de traducción tiene entradas (una por línea) de la forma:
  3963. nombre antiguo;nombre nuevo
  3964. == CMD_DESCRIPTION_REVERT ==
  3965. Carga en el espacio de trabajo la revisión especificada y desprotege el elemento.
  3966. == CMD_USAGE_REVERT ==
  3967. Sintaxis:
  3968. cm revert cset_spec
  3969. cset_spec Especificación del changeset que contiene la revisión del ítem
  3970. cuyo contenido se desea cargar en el espacio de trabajo.
  3971. Usa 'cm help objectspec' para obtener más información sobre la
  3972. especificación de changesets.
  3973. == CMD_HELP_REVERT ==
  3974. Notas:
  3975. El ítem ha de esta estar protegido.
  3976. Ejemplos:
  3977. cm revert dir#cs:0
  3978. cm revert C:\mywks\dir\file1.txt#cs:23456
  3979. == CMD_DESCRIPTION_REVISION_HISTORY ==
  3980. Muestra la historia de revisiones de un ítem.
  3981. == CMD_USAGE_REVISION_HISTORY ==
  3982. Sintaxis:
  3983. cm history [opciones] rutas
  3984. rutas: Rutas de los ítems a mostrar, separadas por comas.
  3985. También pueden ser especificaciones de revisiones en servidor.
  3986. Usa comillas (") para indicar rutas que contengan espacios.
  3987. Usa 'cm help objectspec' para obtener más información sobre la
  3988. especificación de estas rutas.
  3989. Opciones:
  3990. -R: Descender recursivamente dentro de los directorios.
  3991. --long: Muestra información adicional.
  3992. --format: Muestra la salida con el formato especificado.
  3993. No compatible con la opción '--long'. Significado:
  3994. {0} fecha, {1} changeset, {2} rama, {3} etiquetas,
  3995. {4} comentario, {5} propietario, {6} revisionid
  3996. --symlink: Efectúa la operación "history" sobre el fichero de link y
  3997. no sobre el ítem al que apunta
  3998. --xml: Permite volcar la salida del comando en formato xml a la salida
  3999. estándar. También se permite especificar un fichero de salida
  4000. (--xml=output.xml).
  4001. --encoding: si se utiliza con la opción --xml, permite especificar el
  4002. encoding con el que se guardará la salida del comando. Consulte la
  4003. documentación de la MSDN para obtener la tabla completa de codificaciones
  4004. soportadas y su formato; al final de la página en la columna "Name":
  4005. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  4006. == CMD_HELP_REVISION_HISTORY ==
  4007. Notas:
  4008. Este comando muestra una lista con todas revisiones de un ítem determinado.
  4009. Para cada una de ellas se muestra la rama a la que pertenece, comentarios
  4010. de checkin y información sobre las etiquetas.
  4011. Este comando acepta formato para mostrar la salida.
  4012. Los parámetros que acepta son los siguientes:
  4013. {0} | {date} Fecha.
  4014. {1} | {changesetid} Número de changeset.
  4015. {2} | {branch} Rama.
  4016. {4} | {comment} Comentario.
  4017. {5} | {owner} Propietario.
  4018. {6} | {id} Id de revisión.
  4019. {7} | {repository} Repositorio.
  4020. {8} | {server} Servidor.
  4021. {9} | {repspec} Especificación de repositorio.
  4022. {tab} Inserta un tabulador.
  4023. {newline} Inserta una nueva línea.
  4024. Ejemplos
  4025. cm history fichero1.txt fichero2.txt
  4026. cm history c:\workspace
  4027. cm history link --symlink
  4028. (Recupera la historia del fichero de link y no sobre el elemento al que
  4029. apunta)
  4030. cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
  4031. (Recupera la historia del elemento /src/foo/bar.c presente en el último
  4032. changeset de la rama /main/task001 del repositorio 'myserver')
  4033. == CMD_DESCRIPTION_REVISION_TREE ==
  4034. Muestra un árbol de revisiones para el ítem dado.
  4035. == CMD_USAGE_REVISION_TREE ==
  4036. Sintaxis:
  4037. cm tree ruta
  4038. ruta: Ruta del ítem sobre el que se mostrará el árbol.
  4039. Opciones:
  4040. --symlink: Efectúa la operación sobre el fichero de link y no sobre el ítem
  4041. al que apunta.
  4042. == CMD_HELP_REVISION_TREE ==
  4043. Ejemplos:
  4044. cm tree fichero1.txt
  4045. cm tree c:\workspace
  4046. cm tree link --symlink
  4047. (Efectúa la operación sobre el fichero de link
  4048. y no sobre el que apunta, disponible en entornos UNIX).
  4049. == CMD_DESCRIPTION_RM ==
  4050. Use este comando para borrar ficheros y directorios.
  4051. == CMD_USAGE_RM ==
  4052. Sintaxis:
  4053. cm remove | em comando [opciones]
  4054. Comandos:
  4055. controlled (opcional)
  4056. private
  4057. Para obtener más información sobre cada comando:
  4058. cm remove comando --usage
  4059. cm remove comando --help
  4060. == CMD_HELP_RM ==
  4061. Ejemplos:
  4062. cm remove \fichero_controlado.txt
  4063. cm remove private \fichero_privado.txt
  4064. == CMD_DESCRIPTION_RM_CONTROLLED ==
  4065. Borra un ítem del control de versiones.
  4066. == CMD_USAGE_RM_CONTROLLED ==
  4067. Sintaxis:
  4068. cm remove [opciones] rutas
  4069. rutas: Rutas de los ítem a borrar.
  4070. Opciones:
  4071. -R: Descender recursivamente dentro de directorios.
  4072. == CMD_HELP_RM_CONTROLLED ==
  4073. Notas:
  4074. El ítem nunca borra del disco.
  4075. Requisitos para borrar:
  4076. El ítem ha de estar controlado en Plastic SCM.
  4077. El directorio padre debe estar desprotegido.
  4078. El elemento no debe estar desprotegido.
  4079. Si el ítem es un directorio, no debe tener desprotecciones pendientes.
  4080. Ejemplos:
  4081. cm remove src (borra el directorio 'src')
  4082. cm remove c:\workspace\fichero.txt
  4083. == CMD_DESCRIPTION_RM_PRIVATE ==
  4084. Borra ficheros y directorios privados.
  4085. Advertencia: este comando elimina permanentemente ficheros y directorios, y no
  4086. son recuperables. Es recomendable utilizar antes la opción '--dry-run' para
  4087. comprobar qué ficheros y directorios serán afectados por el comando.
  4088. == CMD_USAGE_RM_PRIVATE ==
  4089. Sintaxis:
  4090. cm remove | rm private <ruta>+ [-r] [--verbose] [--dry-run]
  4091. ruta Ruta del fichero o directorio a borrar.
  4092. Se pueden usar comillas (") para especificar rutas que
  4093. contengan espacios.
  4094. Opciones:
  4095. --r Elimina ficheros privados recursivamente dentro de
  4096. directorios controlados.
  4097. --ignored También se elimina ficheros y directorios ignorados y
  4098. cloaked.
  4099. --verbose Muestra todos las rutas afectadas.
  4100. --dry-run Ejecuta el comando sin hacer cambios en disco.
  4101. == CMD_HELP_RM_PRIVATE ==
  4102. Notas:
  4103. Si la ruta especificada corresponde a un fichero o directorio privados, este
  4104. será eliminado de disco.
  4105. Si la ruta corresponde a un fichero bajo control de versiones, el comando
  4106. fallará.
  4107. Si la ruta pertenece a un directorio bajo control de versiones, el comando
  4108. fallará salvo que se especifique la opción '-r', en cuyo caso se borrarán
  4109. todos los ficheros y directorios privados dentro del directorio controlado
  4110. especificado.
  4111. Ejemplos:
  4112. cm remove private private_directory
  4113. (Eliminina el directorio 'private_directory'.)
  4114. cm remove private c:\workspace\controlled_directory
  4115. (Falla, pues el directorio 'controlled_directory' no es privado.)
  4116. cm remove private -r c:\workspace\controlled_directory
  4117. (Elimina todos los ficheros y directorios privados dentro de
  4118. 'controlled_directory'.)
  4119. cm rm private --dry-run --verbose c:\workspace\controlled_directory -r
  4120. (Muestra todas las rutas afectadas por la operación de borrado de elementos
  4121. privados dentro de 'controlled_directory' sin borrar nada.)
  4122. cm rm private --verbose c:\workspace\controlled_directory -r
  4123. (Muestra todas las rutas afectadas por la operación de borrado de elementos
  4124. privados dentro de 'controlled_directory', ejecutando el borrado.)
  4125. == CMD_DESCRIPTION_TRIGGER_DELETE ==
  4126. Elimina un trigger identificado por un tipo y una posicion de un servidor dado.
  4127. == CMD_USAGE_TRIGGER_DELETE ==
  4128. Sintaxis:
  4129. cm trigger delete subtipo-tipo posicion [opciones]
  4130. subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
  4131. Teclee 'cm showtriggertypes' para ver una lista completa de los tipos
  4132. de trigger disponibles. Algunos ejemplos son:
  4133. before-mkbranch
  4134. after-mkwokspace
  4135. after-setselector
  4136. posicion: posicion que se le asigno al trigger en el momento de su creación.
  4137. Opciones:
  4138. --server=servidor: Elimina el trigger del servidor especificado.
  4139. Si no se especifica ninguno lo elimina en aquél configurado
  4140. en el cliente.
  4141. == CMD_HELP_TRIGGER_DELETE ==
  4142. Ejemplos:
  4143. cm trigger delete after-setselector 4
  4144. cm tr rm after-setselector 4
  4145. == CMD_DESCRIPTION_ATTRIBUTE_SET ==
  4146. Fija un atributo al objeto indicado.
  4147. == CMD_USAGE_ATTRIBUTE_SET ==
  4148. Sintaxis:
  4149. cm attribute set spec_atributo spec_objeto valor_atributo
  4150. spec_atributo Especificación del atributo.
  4151. spec_objeto Especificación del objeto sobre el que fijar el atributo.
  4152. Objetos válidos para este comando son: rama, changeset,
  4153. shelveset, etiqueta, item y revisión.
  4154. valor_atributo Valor con el que se quiere fijar el atributo indicado
  4155. para ese objeto.
  4156. Usa 'cm help objectspec' para obtener más información sobre especificaciones.
  4157. == CMD_HELP_ATTRIBUTE_SET ==
  4158. Notas:
  4159. A los objetos se les puede fijar un atributo para poder guardar información
  4160. adicional en el objeto.
  4161. Se pueden fijar atributos sobre los siguientes objetos:
  4162. ramas, changesets, shelvesets, etiquetas, items y revisiones.
  4163. Ejemplo:
  4164. cm attribute set att:Status br:/main/SCM105 Integrated
  4165. == CMD_DESCRIPTION_SETOWNER ==
  4166. Establece el propietario de un objeto.
  4167. == CMD_USAGE_SETOWNER ==
  4168. Sintaxis:
  4169. cm setowner | sto --user=usuario | --group=grupo spec_objeto
  4170. --user Nombre de usuario. Nuevo propietario del objeto.
  4171. --group Nombre de grupo. Nuevo propietario del objeto.
  4172. spec_objeto Especificación del objeto sobre el que asignar el nuevo
  4173. propietario.
  4174. Se puede asignar nuevo usuario a los siguientes objetos:
  4175. repserver, repositorio, rama, changeset, etiqueta, item,
  4176. revisión y atributo.
  4177. Usa 'cm help objectspec' para obtener más información
  4178. sobre la especificación de objetos.
  4179. == CMD_HELP_SETOWNER ==
  4180. Notas:
  4181. Es posible modificar el propietario de un objeto mediante el comando
  4182. setowner. El propietario de un objeto puede ser un usuario o un grupo.
  4183. Para especificar un usuario se utiliza la opción –-user=xxx y para
  4184. especificar un grupo se utiliza la opción -–group=xxx. El objeto que se
  4185. quiere modificar se especifica mediante una especificación de objeto.
  4186. Se puede modificar el propietario de los siguientes objetos:
  4187. servidor de repositorios, repositorio, rama, changeset, etiqueta, item,
  4188. revisión y atributo.
  4189. Ejemplos:
  4190. cm setowner --user=danipen repserver:localhost:8084
  4191. (establece a 'danipen' como propietario del servidor de repositorios)
  4192. cm sto --group=development rep:principal@PlasticServer:8084
  4193. (establece al grupo 'development' como el propietario del repositorio 'principal')
  4194. == CMD_DESCRIPTION_SETSELECTOR ==
  4195. Establece un selector para un espacio de trabajo.
  4196. == CMD_USAGE_SETSELECTOR ==
  4197. Sintaxis:
  4198. cm setselector [opciones] [wk_ruta | wk_spec]
  4199. wk_ruta Ruta del espacio de trabajo sobre el que establecer el
  4200. selector.
  4201. wk_spec Especificación del espacio de trabajo sobre el que
  4202. establecer el selector.
  4203. Usa 'cm help objectspec' para obtener más información
  4204. sobre especificaciones de espacios de trabajo.
  4205. Opciones:
  4206. --file Fichero del que cargar un selector.
  4207. --ignorechanges Ignora el mensaje de aviso de cambios pendientes que se
  4208. muestra si existen cambios pendientes cuando se
  4209. actualiza el espacio de trabajo.
  4210. --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
  4211. redirige la salida estándar.
  4212. == CMD_HELP_SETSELECTOR ==
  4213. Notas:
  4214. Este comando establece un selector para un espacio de trabajo determinado.
  4215. Un workspace necesita información acerca de dónde obtener las revisiones
  4216. con las que trabajará el usuario. Para especificar esa información se
  4217. utilizan los selectores.
  4218. Mediante un selector se puede indicar, por ejemplo, que se carguen las
  4219. revisiones desde una rama determinada o desde la rama ‘main’, desde una
  4220. etiqueta, y especificar la rama donde se alojarán las desprotecciones.
  4221. Si no se especifica ningún fichero del que cargar el selector se abrirá
  4222. un editor de texto.
  4223. Indicar una ruta o una especificación de workspace es opcional. Si no se
  4224. especifica ninguno el selector se fijará para el espacio de trabajo en
  4225. el que se encuentra el usuario.
  4226. Un selector de ejemplo:
  4227. repository "default" // indica el repositorio con el que se trabaja
  4228. path "/" // se aplica al path raíz
  4229. branch "/main" // se obtendrán las últimas revisiones de br:/main
  4230. checkout "/main" // los checkouts se ubicarán en la rama br:/main
  4231. Ejemplos:
  4232. cm setselector
  4233. cm setselector --file=c:\selectores\miRama.xml
  4234. cm setselector --file=c:\selectores\rama5.xml MiWorkspace
  4235. cm setselector wk:workspace_projA@BEARDTONGUE
  4236. == CMD_DESCRIPTION_SHELVE ==
  4237. El comando shelve almacena el contenido de las revisiones en checkout.
  4238. == CMD_USAGE_SHELVE ==
  4239. Este comando está obsoleto. Se ha reemplazado por 'cm shelveset'.
  4240. Sintaxis:
  4241. cm shelve [opciones] [rutas]
  4242. rutas: rutas de los items a guardar.
  4243. Opciones:
  4244. --apply=shelve_spec : Restaura los contenidos almancenados en el
  4245. repositorio, identificados por "shelve_spec" en el espacio de trabajo
  4246. local.
  4247. --delete=shelve_spec: Elimina los contenidos almancenados en el repositorio
  4248. identificados por "shelve_spec"
  4249. --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
  4250. rutas dadas, también serán guardados.
  4251. --dependencies: Incluir las dependencias de los cambios locales entre los
  4252. ítems a guardar.
  4253. -c=comentarios: Añade un comentario al shelve creado en la operación.
  4254. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  4255. --mount: El punto de montaje del respositorio especificado.
  4256. --encoding=codificación: Especifica la codificación de los ficheros de
  4257. origen (por ejemplo, UTF-8 o Unicode)
  4258. --comparisonmethod=tipo: cualquiera de las siguientes opciones:
  4259. IgnoreEol: Ignora diferencias de final de línea.
  4260. IgnoreWhitespaces: Ignora diferencias de espacios en blanco.
  4261. IgnoreEolWhitespaces: Ignora diferencias de final de línea y espacios en
  4262. blanco.
  4263. NotIgnore: Detecta diferencias de final de línea y espacios en
  4264. blanco.
  4265. == CMD_HELP_SHELVE ==
  4266. Notas:
  4267. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  4268. todos los cambios pendientes en el espacio de trabajo.
  4269. - La operación de shelve se aplica siempre recursivamente desde la
  4270. ruta indicada.
  4271. - Requisitos para hacer shelve de un ítem:
  4272. * El ítem debe estar controlado por Plastic SCM.
  4273. * El ítem ha de estar desprotegido.
  4274. Ejemplos:
  4275. cm shelve
  4276. cm shelve fichero1.txt fichero2.txt
  4277. Comentarios:
  4278. Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
  4279. cm shelve -c="my comment"
  4280. cm shelve -m "my comment"
  4281. Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
  4282. ejecutable de un editor de texto, y no se especifica un comentario al
  4283. crear una shelve, el editor se abrirá automáticamente para que especifique
  4284. un comentario.
  4285. Ejemplo: Aplicar un shelve almacenado en el repositorio:
  4286. cm shelve --apply=sh:3
  4287. Ejemplo: Eliminar un shelve almacenado en el repositorio
  4288. cm shelve --delete=sh:3
  4289. Ejemplo: Shelve 'changelist'
  4290. cm status --short --changelist=pending_to_review | cm shelve -
  4291. (El comando listará los paths en el changelist llamado 'pending_to_review'
  4292. y dicha lista será redirigida a la entrada del comando 'shelve').
  4293. == CMD_DESCRIPTION_SHELVESET ==
  4294. Use este comando para administrar shelvesets.
  4295. == CMD_USAGE_SHELVESET ==
  4296. Sintaxis:
  4297. cm shelveset comando [opciones]
  4298. Comandos:
  4299. create | mk
  4300. delete | rm
  4301. apply
  4302. Para obtener más información sobre cada comando:
  4303. cm shelveset command --usage
  4304. cm shelveset command --help
  4305. == CMD_HELP_ATTRIBUTE ==
  4306. Ejemplos:
  4307. cm shelveset create -c="my comment"
  4308. cm shelveset delete sh:3
  4309. cm shelve apply sh:3
  4310. == CMD_DESCRIPTION_SHELVESET_CREATE ==
  4311. El comando shelve almacena los cambios pendientes.
  4312. == CMD_USAGE_SHELVESET_CREATE ==
  4313. Sintaxis:
  4314. cm shelveset create [opciones] [rutas]
  4315. rutas: rutas de los items a guardar.
  4316. Opciones:
  4317. --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
  4318. rutas dadas, también serán guardados.
  4319. --dependencies: Incluir las dependencias de los cambios locales entre los
  4320. ítems a guardar.
  4321. -c=comentarios: Añade un comentario al shelve creado en la operación.
  4322. --commentsfile=comment.txt: Carga el comentario del fichero especificado.
  4323. == CMD_HELP_SHELVESET ==
  4324. Ejemplos:
  4325. cm shelveset create -c="my comment"
  4326. cm shelveset delete sh:3
  4327. cm shelve apply sh:3
  4328. == CMD_HELP_SHELVESET_CREATE ==
  4329. El comando shelveset create almacena los ítems en checkout especificados
  4330. dentro del repositorio. De este modo el contenido queda almacenado en el
  4331. servidor sin necesidad de hacer check in.
  4332. Notas:
  4333. - Si no se especifican [opciones] ni [rutas], la operación involucrará a
  4334. todos los cambios pendientes en el espacio de trabajo.
  4335. - La operación de shelve se aplica siempre recursivamente desde la
  4336. ruta indicada.
  4337. - Requisitos para hacer shelve de un ítem:
  4338. * El ítem debe estar controlado por Plastic SCM.
  4339. * El ítem ha de estar desprotegido.
  4340. Ejemplos:
  4341. cm shelveset create
  4342. cm shelveset fichero1.txt fichero2.txt
  4343. Comentarios:
  4344. Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
  4345. cm shelveset -c="my comment"
  4346. cm shelveset -m "my comment"
  4347. Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
  4348. ejecutable de un editor de texto, y no se especifica un comentario al
  4349. crear una shelve, el editor se abrirá automáticamente para que especifique
  4350. un comentario.
  4351. Ejemplo: Shelve 'changelist'
  4352. cm status --short --changelist=pending_to_review | cm shelveset -
  4353. (El comando listará los paths en el changelist llamado 'pending_to_review'
  4354. y dicha lista será redirigida a la entrada del comando 'shelve').
  4355. == CMD_DESCRIPTION_SHELVESET_DELETE ==
  4356. El comando shelveset delete borra un shelveset.
  4357. == CMD_USAGE_SHELVESET_DELETE ==
  4358. Sintaxis:
  4359. cm shelveset delete shelve_spec
  4360. shelve_spec: Elimina los contenidos almancenados en el repositorio
  4361. identificados por "shelve_spec"
  4362. == CMD_HELP_SHELVESET_DELETE ==
  4363. El comando shelveset delete borra un shelveset creado anteriormente.
  4364. Ejemplo: Eliminar un shelve almacenado en el repositorio
  4365. cm shelveset delete sh:3
  4366. == CMD_DESCRIPTION_SHELVESET_APPLY ==
  4367. El comando shelveset apply restaura los contenidos almancenados en el
  4368. repositorio.
  4369. == CMD_USAGE_SHELVESET_APPLY ==
  4370. Sintaxis:
  4371. cm shelveset apply shelve_spec [opciones]
  4372. shelve_spec: Restaura los contenidos almancenados en el repositorio
  4373. identificados por "shelve_spec"
  4374. Opciones:
  4375. --mount: El punto de montaje del respositorio especificado.
  4376. --encoding=codificación: Especifica la codificación de los ficheros de
  4377. origen (por ejemplo, UTF-8 o Unicode)
  4378. --comparisonmethod=tipo: cualquiera de las siguientes opciones:
  4379. IgnoreEol: Ignora diferencias de final de línea.
  4380. IgnoreWhitespaces: Ignora diferencias de espacios en blanco.
  4381. IgnoreEolWhitespaces: Ignora diferencias de final de línea y espacios en
  4382. blanco.
  4383. NotIgnore: Detecta diferencias de final de línea y espacios en
  4384. blanco.
  4385. == CMD_HELP_SHELVESET_APPLY ==
  4386. El comando shelveset apply restaura los contenidos almancenados en el
  4387. repositorio.
  4388. Ejemplo: Aplicar un shelve almacenado en el repositorio:
  4389. cm shelveset apply sh:3
  4390. == CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
  4391. Muestra la lista de objetos disponibles y sus atributos correspondientes.
  4392. == CMD_USAGE_SHOW_FIND_OBJECTS ==
  4393. Sintaxis:
  4394. cm showfindobjects
  4395. == CMD_HELP_SHOW_FIND_OBJECTS ==
  4396. Objetos y atributos disponibles:
  4397. attribute:
  4398. Se puede buscar atributos filtrando por los siguientes campos:
  4399. Type : string.
  4400. Value : string.
  4401. Date : fecha.
  4402. Consulte la sección "constantes de fecha" en esta guía para más
  4403. info.
  4404. Owner : usuario.
  4405. Admite el usuario especial 'me'.
  4406. GUID : Identificador Global Único.
  4407. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4408. Comment : string.
  4409. SrcObj : object spec.
  4410. ID : integer.
  4411. attributetype:
  4412. Se puede buscar tipos de atributo filtrando por los siguientes campos:
  4413. Name : string.
  4414. Value : string.
  4415. Date : fecha.
  4416. Consulte la sección "constantes de fecha" en esta guía para más
  4417. info.
  4418. Owner : usuario.
  4419. Admite el usuario especial 'me'.
  4420. GUID : Identificador Global Único.
  4421. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4422. Comment : string.
  4423. Source : object spec.
  4424. ID : integer.
  4425. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  4426. en esta guía para más información sobre:
  4427. ReplLogId
  4428. ReplSrcDate
  4429. ReplSrcId
  4430. ReplSrcRepository
  4431. ReplSrcServer
  4432. branch:
  4433. Se puede buscar ramas filtrando por los siguientes campos:
  4434. Name : string.
  4435. Date : fecha.
  4436. Consulte la sección "constantes de fecha" en esta guía para más
  4437. info.
  4438. Changesets : fecha (de los changesets en la rama).
  4439. Consulte la sección "constantes de fecha" en esta guía para más
  4440. info.
  4441. Attribute : string.
  4442. AttrValue : string.
  4443. Owner : usuario.
  4444. Admite el usuario especial 'me'.
  4445. Parent : branch spec.
  4446. Comment : string.
  4447. GUID : Identificador Global Único.
  4448. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4449. Item : item spec or item id (integer).
  4450. ID : integer.
  4451. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  4452. en esta guía para más información sobre:
  4453. ReplLogId
  4454. ReplSrcDate
  4455. ReplSrcId
  4456. ReplSrcRepository
  4457. ReplSrcServer
  4458. changeset:
  4459. Se puede buscar changesets filtrando por los siguientes campos:
  4460. Branch : branch spec.
  4461. ChangesetId : integer.
  4462. Attribute : string.
  4463. AttrValue : string.
  4464. Date : fecha.
  4465. Consulte la sección "constantes de fecha" en esta guía
  4466. para más info.
  4467. Owner : usuario.
  4468. Admite el usuario especial 'me'.
  4469. GUID : Identificador Global Único.
  4470. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4471. Comment : string.
  4472. OnlyWithRevisions : boolean.
  4473. ReturnParent : boolean.
  4474. Parent : changeset id (integer).
  4475. ID : integer.
  4476. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  4477. en esta guía para más información sobre:
  4478. ReplLogId
  4479. ReplSrcDate
  4480. ReplSrcId
  4481. ReplSrcRepository
  4482. ReplSrcServer
  4483. label:
  4484. Se puede buscar etiquetas filtrando por los siguientes campos:
  4485. Name : string.
  4486. Attribute : string.
  4487. AttrValue : string.
  4488. Date : fecha.
  4489. Consulte la sección "constantes de fecha" en esta guía para más
  4490. info.
  4491. Owner : usuario.
  4492. Admite el usuario especial 'me'.
  4493. GUID : Identificador Global Único.
  4494. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4495. Branch : branch spec.
  4496. Branchid : integer.
  4497. Changeset : changeset id (integer).
  4498. Comment : string.
  4499. ID : integer.
  4500. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  4501. en esta guía para más información sobre:
  4502. ReplLogId
  4503. ReplSrcDate
  4504. ReplSrcId
  4505. ReplSrcRepository
  4506. ReplSrcServer
  4507. merge:
  4508. Se puede buscar merges filtrando por los siguientes campos:
  4509. SrcBranch : branch spec.
  4510. SrcChangeset : changeset id (integer).
  4511. DstBranch : branch spec.
  4512. DstChangeset : changeset id (integer).
  4513. Date : fecha.
  4514. Consulte la sección "constantes de fecha" en esta guía para
  4515. más info.
  4516. Owner : usuario.
  4517. Admite el usuario especial 'me'.
  4518. GUID : Identificador Global Único.
  4519. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4520. Type : string.
  4521. Los posibles valores son 'merge', 'cherrypick',
  4522. 'cherrypicksubstractive', 'interval', 'intervalcherrypick'
  4523. e 'intervalcherrypicksubstractive'
  4524. ID : integer.
  4525. replicationlog:
  4526. Se puede buscar replication log filtrando por los siguientes campos:
  4527. Branch : branch spec.
  4528. RepositoryName : string.
  4529. Owner : usuario.
  4530. Admite el usuario especial 'me'.
  4531. Date : fecha.
  4532. Consulte la sección "constantes de fecha" en esta guía para
  4533. más info.
  4534. Server : string.
  4535. Package : boolean.
  4536. ID : integer.
  4537. review:
  4538. Se puede buscar code reviews filtrando por los siguientes campos:
  4539. Status : string.
  4540. Assignee : string.
  4541. Title : string.
  4542. Target : object spec.
  4543. TargetId : integer.
  4544. TargetType : string.
  4545. Los posibles valores son 'branch' y 'changeset'.
  4546. Date : fecha.
  4547. Consulte la sección "constantes de fecha" en esta guía para más
  4548. info.
  4549. Owner : usuario.
  4550. Admite el usuario especial 'me'.
  4551. GUID : Identificador Global Único.
  4552. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4553. Id : integer.
  4554. revision:
  4555. Se puede buscar revisiones filtrando por los siguientes campos:
  4556. Branch : branch spec.
  4557. Changeset : changeset id (integer).
  4558. Item : string o integer.
  4559. ItemId : integer.
  4560. Attribute : string.
  4561. AttrValue : string.
  4562. Archived : boolean.
  4563. Comment : string.
  4564. Date : fecha.
  4565. Consulte la sección "constantes de fecha" en esta guía
  4566. para más info.
  4567. GUID : Identificador Global Único.
  4568. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4569. Owner : usuario.
  4570. Admite el usuario especial 'me'.
  4571. Parent : revision id (integer).
  4572. ReturnParent : boolean.
  4573. Shelve : shelve id (integer).
  4574. Size : integer (en bytes).
  4575. Type : string.
  4576. Los posibles valores son 'dir', 'bin' y 'txt'.
  4577. WorkspaceCheckoutId : integer.
  4578. ID : integer.
  4579. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  4580. en esta guía para más información sobre:
  4581. ReplLogId
  4582. ReplSrcDate
  4583. ReplSrcId
  4584. ReplSrcRepository
  4585. ReplSrcServer
  4586. shelve:
  4587. Se puede buscar shelves filtrando por los siguientes campos:
  4588. Owner : usuario.
  4589. Admite el usuario especial 'me'.
  4590. Date : fecha.
  4591. Consulte la sección "constantes de fecha" en esta guía para más
  4592. info.
  4593. Attribute : string.
  4594. AttrValue : string.
  4595. Comment : string.
  4596. GUID : Identificador Global Único.
  4597. Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  4598. Parent : integer.
  4599. ShelveId : integer.
  4600. ID : integer.
  4601. Campos de replicación. Consulte la sección "campos relacionados con la réplica"
  4602. en esta guía para más información sobre:
  4603. ReplLogId
  4604. ReplSrcDate
  4605. ReplSrcId
  4606. ReplSrcRepository
  4607. ReplSrcServer
  4608. Campos relacionados con la réplica:
  4609. Muchos objetos mantienen información de replicación, lo que significa que
  4610. Plastic mantiene el rastro de dónde se crearon originalmente.
  4611. Los campos que se pueden utilizar son:
  4612. ReplSrcServer : Significa "servidor origen de la réplica", y es el
  4613. servidor de donde se trajeron los objetos.
  4614. Ejemplo:
  4615. cm find branch "where replsrcserver='skull.codicefactory.com:9095'"
  4616. ReplSrcRepository : string. Significa "repositorio origen de la réplica",
  4617. y es el repositorio de donde se trajeron los objetos.
  4618. Ejemplo:
  4619. cm find branch "where \
  4620. replsrcserver = 'skull.codicefactory.com:9095' \
  4621. and replsrcrepository = 'codice'"
  4622. ReplLogId : integer. El identificador de la operación de réplica. En
  4623. Plastic, cada vez que un objeto nuevo se crea de una réplica,
  4624. también se crea un nuevo 'replicationlog'.
  4625. Ejemplo:
  4626. cm find replicationlog
  4627. 324054 9/13/2018 02:00:15 /main/scm23064 sluisp plasticscm.com T
  4628. 327255 9/11/2018 12:33:38 /main/scm23042 maria plasticscm.com T
  4629. 329631 9/17/2018 13:06:49 /main/scm23099 sluisp plasticscm.com T
  4630. Ahora se pueden buscar las ramas creadas en la réplica 327255, en
  4631. caso de haber alguna:
  4632. cm find branch "where replogid=327255"
  4633. ReplSrcDate: fecha. Es la fecha en la que la operación de réplica tuvo
  4634. lugar. Los objetos replicados mantienen la fecha en la que
  4635. fueron creados originalmente, por lo que este campo es útil
  4636. si se necesita buscar objetos que fueron replicados en un
  4637. determinado marco temporal.
  4638. Ejemplo:
  4639. cm find replicationlog "where date > 'one week ago'"
  4640. 8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc
  4641. Ahora se puede verificar que la rama replicada se creó antes de la
  4642. propia operación de réplica:
  4643. cm find branch "where repllogid = 8780433"
  4644. 8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
  4645. ReplSrcId: integer. Es el ID del servidor origen de la réplica
  4646. (ReplSrcServer). Este ID se puede descubrir buscando objetos
  4647. de tipo 'replicationsource' con el comando 'cm find'.
  4648. Ejemplo:
  4649. cm find replicationsource
  4650. 7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
  4651. 8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
  4652. Ahora se pueden buscar los changesets replicados desde
  4653. codice@AFRODITA:8087 de la siguiente forma:
  4654. cm find changesets "where replsrcid = 7860739"
  4655. Constantes de fecha:
  4656. Se pueden usar fechas formateadas siguiendo la configuración de localización
  4657. del Sistema Operativo. Por ejemplo, si el SO muestra fechas en el formato
  4658. 'dd/MM/yyyy', se pueden utilizar fechas como '31/12/2018' en las consultas.
  4659. Sin embargo, también se pueden utilizar las siguientes constantes para
  4660. facilitar la escritura de las queries:
  4661. 'today' : la fecha de hoy.
  4662. 'yesterday' : la fecha de ayer.
  4663. 'this week' : la fecha del lunes de la semana actual.
  4664. 'this month' : la fecha del primer día del mes actual.
  4665. 'this year' : la fecha del 1 de enero del año actual.
  4666. 'one day ago' : un día antes de la fecha actual.
  4667. 'one week ago' : una semana antes de la fecha actual.
  4668. 'one month ago' : un mes antes de la fecha actual.
  4669. 'n days ago' : 'n' días antes de la fecha actual.
  4670. 'n months ago' : 'n' meses antes de la fecha actual.
  4671. 'n years ago' : 'n' años antes de la fecha actual.
  4672. Las siguientes cláusulas 'where' son válidas para campos que admitan fechas:
  4673. '(...) where date > 'today' (...)'
  4674. '(...) where date < 'yesterday' (...)'
  4675. '(...) where date > 'this week' (...)'
  4676. '(...) where date > 'this month' (...)'
  4677. '(...) where date < 'one day ago' and date > '3 days ago' (...)'
  4678. '(...) where date < 'one week ago' and date > '3 weeks ago' (...)'
  4679. '(...) where date < 'one month ago' and date > '3 months ago' (...)'
  4680. '(...) where date > '1 year ago' (...)'
  4681. También se puede forzar un determinado formato de fecha en el comando
  4682. 'cm find' utilizando el flag --dateformat. Lee 'cm find --help' para más
  4683. información.
  4684. == CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
  4685. Muestra la lista de los tipos de triggers disponibles.
  4686. == CMD_USAGE_TRIGGER_SHOWTYPES ==
  4687. Sintaxis:
  4688. cm trigger showtypes
  4689. == CMD_DESCRIPTION_SHOWACL ==
  4690. Muestra la ACL (Lista de Control de Acceso) de un elemento.
  4691. == CMD_USAGE_SHOWACL ==
  4692. Sintaxis:
  4693. cm showacl [opciones] spec_objeto
  4694. spec_objeto Especificación del objeto sobre el que mostrar el ACL.
  4695. Objetos válidos para este comando son repserver,
  4696. repositorio, rama, changeset, etiqueta, item y atributo.
  4697. Usa 'cm help objectspec' para obtener más información
  4698. sobre la especificación de objetos.
  4699. Opciones:
  4700. --extended Muestra información detallada.
  4701. --xml Permite volcar la salida del comando en formato xml
  4702. a la salida estándar. También se permite especificar
  4703. un fichero de salida (--xml=output.xml).
  4704. --encoding Si se utiliza con la opción --xml, permite especificar
  4705. el encoding con el que se guardará la salida del
  4706. comando. Por ejemplo: --encoding=utf-8
  4707. Consulte la documentación de la MSDN para obtener la
  4708. tabla completa de codificaciones soportadas y su formato;
  4709. al final de la página en la columna "Name":
  4710. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  4711. == CMD_HELP_SHOWACL ==
  4712. Notas:
  4713. Este comando se utiliza para obtener una lista de permisos de un usuario o
  4714. un grupo sobre un elemento del repositorio.
  4715. Ejemplos:
  4716. cm showacl repserver:PlasticServer:8084
  4717. cm showacl br:/main --extended
  4718. == CMD_DESCRIPTION_SHOWCOMMANDS ==
  4719. Muestra todos los comandos disponibles.
  4720. == CMD_USAGE_SHOWCOMMANDS ==
  4721. Sintaxis:
  4722. cm showcommands
  4723. == CMD_HELP_SHOWCOMMANDS ==
  4724. == CMD_DESCRIPTION_SHOWOWNER ==
  4725. Muestra el propietario de un elemento del repositorio.
  4726. == CMD_USAGE_SHOWOWNER ==
  4727. Sintaxis:
  4728. cm showowner spec_objeto
  4729. spec_objeto Especificación del objeto para mostar su propietario.
  4730. Usa 'cm help objectspec' para obtener más información
  4731. sobre la especificación de objetos.
  4732. El objeto debe ser uno de los siguientes: repserver,
  4733. repositorio, rama, changeset, etiqueta, atributo,
  4734. revisión e item.
  4735. == CMD_HELP_SHOWOWNER ==
  4736. Notas:
  4737. Este comando muestra el propietario de un elemento del repositorio.
  4738. Puede ser un usuario o un grupo.
  4739. El propietario se puede modificar con el comando 'cm setowner'.
  4740. Ejemplos:
  4741. cm showowner repserver:PlasticServer:8084
  4742. cm showowner rev:fichero.cs#br:/main#LAST
  4743. == CMD_DESCRIPTION_SHOWPERMISSIONS ==
  4744. Muestra la lista de los permisos disponibles.
  4745. == CMD_USAGE_SHOWPERMISSIONS ==
  4746. Sintaxis:
  4747. cm showpermissions
  4748. == CMD_HELP_SHOWPERMISSIONS ==
  4749. Ejemplos:
  4750. cm showpermissions
  4751. == CMD_DESCRIPTION_SHOWSELECTOR ==
  4752. Muestra el selector del espacio de trabajo actual.
  4753. == CMD_USAGE_SHOWSELECTOR ==
  4754. Sintaxis:
  4755. cm showselector [wk_ruta | wk_spec]
  4756. wk_ruta Ruta del espacio de trabajo para mostrar su selector
  4757. wk_spec Especificación del espacio de trabajo para mostrar su
  4758. selector.
  4759. Usa 'cm help objectspec' para obtener más información sobre
  4760. especificaciones de espacios de trabajo.
  4761. == CMD_HELP_SHOWSELECTOR ==
  4762. Notas:
  4763. Si no se especifica una ruta o un especificador de espacio de trabajo,
  4764. el comando tomará como ruta el directorio actual.
  4765. Ejemplos:
  4766. cm showselector c:\workspace
  4767. cm showselector
  4768. cm showselector > miSelector.txt
  4769. cm showselector wk:build_wk@BUILDER
  4770. == CMD_DESCRIPTION_SUPPORT ==
  4771. Este comando permite al usuario efectuar operaciones de soporte.
  4772. == CMD_USAGE_SUPPORT ==
  4773. Sintaxis:
  4774. cm support comando [opciones]
  4775. Comandos:
  4776. bundle
  4777. Para obtener más información sobre cada uno de los comandos ejecute:
  4778. cm support comando --usage
  4779. cm support comando --help
  4780. == CMD_HELP_SUPPORT ==
  4781. Ejemplos:
  4782. cm support
  4783. cm support bundle
  4784. cm support bundle c:\outputfile.zip
  4785. == CMD_DESCRIPTION_SUPPORT_BUNDLE ==
  4786. Crea el paquete de soporte con los ficheros de log relevantes.
  4787. Este paquete se puede adjuntar cuando se solicita la ayuda, cuando
  4788. se pregunte por información extra o cuando se envíe un error.
  4789. == CMD_USAGE_SUPPORT_BUNDLE ==
  4790. Sintaxis:
  4791. cm support bundle [outputfile]
  4792. Opciones:
  4793. outputfile Crea el paquete de soporte en la ruta especificado.
  4794. == CMD_HELP_SUPPORT_BUNDLE ==
  4795. Notas:
  4796. Este comando permite al usuario crear un paquete de soporte con los
  4797. ficheros de log relevantes. Es posible especificar un fichero de salida.
  4798. Ejemplos:
  4799. cm support bundle
  4800. (Crea el paquete de soporte en el directorio temporal)
  4801. cm support bundle c:\outputfile.zip
  4802. (Crea el paquete de soporte en la ruta especificado)
  4803. == CMD_DESCRIPTION_SWITCH ==
  4804. Actualiza el espacio de trabajo a la rama, etiqueta, changeset o shelve especificado.
  4805. == CMD_USAGE_SWITCH ==
  4806. Sintaxis:
  4807. cm switch brspec | csetspec | lbspec | shspec [--repository=name]
  4808. [--workspace=path]
  4809. Opciones:
  4810. --workspace Ruta del espacio de trabajo a cambiar.
  4811. --repository Repositorio al que se va a cambiar.
  4812. Usa 'cm help objectspec' para aprender más sobre cómo indicar
  4813. especificaciones de changesets, ramas y etiquetas.
  4814. == CMD_HELP_SWITCH ==
  4815. Notas:
  4816. Este comando permite a los usuarios actualizar el espacio de trabajo
  4817. con el contenido del objeto especificado (rama, etiqueta o changeset).
  4818. Ejemplos:
  4819. cm switch br:/main
  4820. cm switch lb:Rel1.1
  4821. cm switch Rel2.0
  4822. cm switch cs:4375
  4823. cm switch 5632
  4824. cm switch sh:2
  4825. == CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
  4826. Establece la rama especificada como rama de trabajo.
  4827. == CMD_USAGE_SWITCH_TO_BRANCH ==
  4828. Sintaxis:
  4829. cm switchtobranch [opciones] [spec_rama]
  4830. spec_rama: Especificación de rama.
  4831. Opciones:
  4832. --label=nombre | --changeset=número: Carga las revisiones de la etiqueta
  4833. o changeset especificado. Si no se especifica spec_rama, una de
  4834. estas opciones es obligatoria.
  4835. --workspace | -wk=path: Ruta del espacio de trabajo a cambiar.
  4836. == CMD_HELP_SWITCH_TO_BRANCH ==
  4837. Notas:
  4838. Este comando permite a los usuarios especificar una rama, como rama de
  4839. trabajo. Adicionalmente se puede especificar una etiqueta o un changeset,
  4840. desde la cual se cargarán las revisiones.
  4841. Si no se especifica rama, se ha de especificar una etiqueta o un changeset
  4842. obligatoriamente. Consulte el manual para obtener más información.
  4843. Si no se especifica repositorio, la rama se fija sobre el repositorio
  4844. actual.
  4845. Ejemplos:
  4846. cm switchtobranch br:/main
  4847. cm switchtobranch br:/main/tarea001
  4848. cm switchtobranch --label=BL050
  4849. (Configuración de sólo lectura. Se cargan revisiones del changeset etiquetado)
  4850. == CMD_DESCRIPTION_SYNC ==
  4851. Sincroniza con Git
  4852. == CMD_USAGE_SYNC ==
  4853. Sintaxis:
  4854. cm synchronize | sync repspec git [url [--user=usr_name --pwd=pwd]] [--author]
  4855. [[--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent]=value]
  4856. repspec Especificación del repositorio.
  4857. Usa 'cm help objectspec' para obtener más información
  4858. sobre la especificación de repositorios.
  4859. git (Default).
  4860. Opciones:
  4861. url URL del repositorio remoto
  4862. (http(s):// o git:// o una URL ssh).
  4863. --user Nombre de usuario para la URL especificada.
  4864. --pwd Contraseña para la URL especificada.
  4865. --txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent
  4866. Opciones para detectar ítems movidos, del mismo modo que
  4867. lo hace la GUI de Plastic SCM.
  4868. --author Usa los valores de nombre y fecha (timestamp) del autor
  4869. en git (git committer by default).
  4870. --skipgitlfs Ignora la configuración de Git LFS que haya en el
  4871. fichero '.gitattributes'. Se comporta como si no
  4872. tuviese soporte de Git LFS.
  4873. == CMD_HELP_SYNC ==
  4874. Notas:
  4875. En caso de sincronizar con un servidor que no requiera credenciales, tras
  4876. la primera sincronización no es necesario introducir el parámetro URL.
  4877. Este comando no soporta repositorios locales.
  4878. En el caso de usar el protocolo SSH, es necesario tener añadido al PATH
  4879. el cliente por línea de comandos 'ssh' y que esté correctamente configurado
  4880. para conectarse al servidor remoto (claves públicas/privadas).
  4881. Ejemplos:
  4882. cm sync default@localhost:8087 git git://localhost/repository
  4883. == CMD_DESCRIPTION_TRIGGER ==
  4884. Use este comando para administrar triggers.
  4885. == CMD_USAGE_TRIGGER ==
  4886. Sintaxis:
  4887. cm trigger | tr command [opciones]
  4888. Comandos:
  4889. create | mk
  4890. delete | rm
  4891. edit
  4892. list | ls
  4893. showtypes
  4894. Para obtener más información sobre cada comando:
  4895. cm trigger command --usage
  4896. cm trigger command --help
  4897. == CMD_HELP_TRIGGER ==
  4898. Ejemplos:
  4899. cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
  4900. cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
  4901. cm tr ls before-mkbranch --server=myserver:8084
  4902. cm tr rm after-setselector 4
  4903. cm tr showtypes
  4904. == CMD_DESCRIPTION_TUBE ==
  4905. Ejecuta comandos relacionados con Plastic Tube.
  4906. == CMD_USAGE_TUBE ==
  4907. Sintaxis:
  4908. cm tube config -u=user -p=password
  4909. cm tube create remoteuser
  4910. cm tube remove remoteuser
  4911. cm tube local
  4912. cm tube remote
  4913. cm tube share <repository_spec>+ -u=remoteuser -a=access_mode
  4914. cm tube unshare <repository_spec>+ -u=remoteuser
  4915. cm tube connect
  4916. cm tube disconnect
  4917. cm tube status
  4918. Opciones:
  4919. -u Usuario de Tube (el usuario de plasticscm.com)
  4920. -p Password del usuario
  4921. -a Acceso: pull, push o ambos (pull | push | pull,push)
  4922. rep_spec Especificación del repositorio.
  4923. Usa 'cm help objectspec' para obtener más información
  4924. sobre la especificación de repositorios.
  4925. == CMD_HELP_TUBE ==
  4926. Notas:
  4927. config
  4928. Configura Plastic SCM para usar Plastic Tube con el usuario y password
  4929. especificados.
  4930. create
  4931. Crea el Tube remoteuser -> myuser.
  4932. El usuario 'myuser' permite a 'remoteuser' conectarse al servidor
  4933. de 'myuser'.
  4934. Pueden establecerse conexiones de 'remoteuser' a 'myuser'.
  4935. Sólo pueden crearse un Tube de otro usuario al usuario actual de
  4936. Plastic Tube.
  4937. remove
  4938. Elimina el Tube remoteuser -> myuser.
  4939. local
  4940. Lista los repositorios locales compartidos en el servidor local y los
  4941. usuarios con quien son compartidos.
  4942. remote
  4943. Lista los repositorios remotamente compartidos que son compartidos con
  4944. el usuario actual de Plastic Tube.
  4945. share
  4946. Comparte el repositorio(s) local con el usuario y remoto y los permisos
  4947. especificados.
  4948. unshare
  4949. Deja de compartir el repositorio local con el usuario remoto.
  4950. connect
  4951. Conecta el servidor de Plastic SCM a Plastic Tube.
  4952. disconnect
  4953. Desconecta el servidor de Plastic SCM de Plastic Tube.
  4954. status
  4955. Muestra si el servidor de Plastic SCM está conectado a Plastic Tube.
  4956. Ejemplos:
  4957. cm tube config -u=ruben@codicesoftware.com -p=rubenpassword
  4958. cm tube create pablo@codicesoftware.com
  4959. ('pablo@codicesoftware.com' puede conectar con el usuario actual del Tube)
  4960. cm tube remove pablo@codicesoftware.com
  4961. cm tube local
  4962. cm tube remote
  4963. cm tube share repo@server:8087 -u=pablo@codicesoftware.com -a=pull,push
  4964. cm tube share repo@server:8087 doc@server:8087 -u=pablo@codicesoftware.com -a=push
  4965. cm tube unshare repo@server:8087 -u=pablo@codicesoftware.com
  4966. cm tube connect
  4967. cm tube disconnect
  4968. cm tube status
  4969. == CMD_DESCRIPTION_UNCO ==
  4970. Deshace la desprotección de un ítem.
  4971. == CMD_USAGE_UNCO ==
  4972. Sintaxis:
  4973. cm undocheckout | unco <item_path>+ [--all] [--symlink] [--silent]
  4974. item_path Especificación de los ítems para deshacer la desprotección,
  4975. separados por comas.
  4976. Se pueden usar comillas (") para especificar rutas que
  4977. contengan espacios.
  4978. Use . para aplicar la operación al directorio actual.
  4979. Opciones:
  4980. --all (-a) Los ítems especificados que han sido cambiados, movidos y
  4981. borrados localmente también serán deshechos.
  4982. --symlink Deshace la protección del fichero de link y no al elemento
  4983. al que apunta.
  4984. --silent No muestra salida.
  4985. == CMD_HELP_UNCO ==
  4986. Notas:
  4987. Si se desean descartar los cambios realizados en un ítem desprotegido
  4988. previamente, se utiliza este comando.
  4989. El ítem se cambia a la revisión justamente anterior.
  4990. Requisitos para deshacer la desprotección:
  4991. El ítem ha de estar controlado por Plastic
  4992. El ítem ha de estar desprotegido
  4993. Ejemplos:
  4994. cm undocheckout .
  4995. (Desprotege el directorio actual)
  4996. cm undocheckout fichero1.txt fichero2.txt
  4997. cm unco c:\workspace\fichero.txt
  4998. cm undocheckout -R c:\workspace\src
  4999. (Deshace la desprotección de 'src' recursivamente)
  5000. cm unco link --symlink
  5001. (Efectúa la desprotección sobre el fichero de link y no del que apunta,
  5002. disponible en entornos UNIX)
  5003. cm unco code\cgame\cg_main.c --all
  5004. (Deshace la desprotección del fichero cambiado)
  5005. Deshacer 'changelist'. Ejemplo:
  5006. cm status --short --changelist=pending_to_review | cm undocheckout -
  5007. (El comando listará los paths en el changelist llamado 'pending_to_review'
  5008. y dicha lista será redirigida a la entrada del comando 'uncheckout').
  5009. == CMD_DESCRIPTION_UNCOUNCHANGED ==
  5010. Deshace la desprotección en elementos que no han cambiado.
  5011. == CMD_USAGE_UNCOUNCHANGED ==
  5012. Sintaxis:
  5013. cm uncounchanged [opciones]
  5014. Opciones:
  5015. -R|-r|--recursive Descender recursivamente dentro de directorios.
  5016. == CMD_HELP_UNCOUNCHANGED ==
  5017. Notas:
  5018. Este comando se aplica desde la raíz del workspace recursivamente.
  5019. Ejemplos:
  5020. cm uncounchanged
  5021. == CMD_DESCRIPTION_UNDELETE ==
  5022. Recupera en el espacio de trabajo la revisión especificada en la ruta dada.
  5023. == CMD_USAGE_UNDELETE ==
  5024. Sintaxis:
  5025. cm undelete rev_spec ruta
  5026. rev_spec: Especificación de la revisión del ítem cuyo contenido se desea
  5027. cargar en el espacio de trabajo.
  5028. path: Ruta donde se va a restaurar.
  5029. == CMD_HELP_UNDELETE ==
  5030. Notas:
  5031. El elemento a recuperar no debe de estar ya cargado en el workspace.
  5032. La operación de recuperar no esta soportada para xlinks.
  5033. Ejemplo:
  5034. cm undelete revid:756 C:\mywks\src\foo.c
  5035. cm undelete itemid:68#cs:2 C:\mywks\dir\myfile.pdf
  5036. cm undelete serverpath:/src#br:/main C:\mywks\Dir
  5037. == CMD_DESCRIPTION_UNDOCHANGE ==
  5038. Deshace los cambios hechos en un fichero.
  5039. == CMD_USAGE_UNDOCHANGE ==
  5040. Notas:
  5041. Si se desean descartar los cambios en un ítem, independientemente de su
  5042. estado (desprotegido o modificado sin hacer desprotección), este comando
  5043. vuelve a la revisión anterior. Si se ordena realizar la operación sobre
  5044. un directorio en vez de un fichero la acción se realiza recursivamente por
  5045. defecto.
  5046. Ejemplo:
  5047. cm unc . (Descarta los cambios de los ítems del directorio actual).
  5048. cm unc fichero1.txt fichero2.txt
  5049. cm unc c:\workspace\fichero1.txt
  5050. == CMD_HELP_UNDOCHANGE ==
  5051. Ejemplo:
  5052. cm unc . (Descarta los cambios de los ítems del directorio actual).
  5053. cm unc fichero1.txt fichero2.txt
  5054. cm unc c:\workspace\fichero1.txt
  5055. == CMD_DESCRIPTION_LOCK_UNLOCK ==
  5056. Deshace los bloqueos en los elementos del servidor de bloqueos especificado
  5057. == CMD_USAGE_LOCK_UNLOCK ==
  5058. Sintaxis:
  5059. cm lock unlock [repserverspec] <guid>+
  5060. repserverspec Especificación del servidor de repositorio.
  5061. Usa 'cm help objectspec' para obtener más información
  5062. sobre la especificación de servidores.
  5063. guid Lista de GUIDs de ítems a desbloquear, separados por
  5064. espacios.
  5065. == CMD_DESCRIPTION_UNDO ==
  5066. Deshace cambios en un workspace.
  5067. == CMD_USAGE_UNDO ==
  5068. Syntaxis:
  5069. cm undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
  5070. [Opciones de salida]
  5071. path Rutas de los ficheros o carpetas a los que aplicar
  5072. la operación, separados por espacios. Se pueden
  5073. utilizar comillas (") para especificar rutas con
  5074. espacios. Si no se especifica ninguna ruta, por
  5075. defecto la operación se ejecutará sobre los ficheros
  5076. en el directorio actual.
  5077. Opciones:
  5078. --symlink Aplica la operación de undo al enlace simbólico y
  5079. no a su destino.
  5080. -r Ejecuta el undo de manera recursiva.
  5081. Filtros:
  5082. Si ninguna de estas opciones está presente, por defecto se deshacen todos
  5083. los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
  5084. opciones.
  5085. Si un fichero o directorio tiene uno o más de los tipos de cambio
  5086. especificados, todos los cambios en ese fichero o directorio serán
  5087. deshechos.
  5088. Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
  5089. está tanto movido como checkedout, ambos cambios se desharán.
  5090. --checkedout Selecciona ficheros y directorios marcados para
  5091. cambios.
  5092. --unchanged Selecciona ficheros sin modificaciones en su
  5093. contenido.
  5094. --changed Selecciona ficheros y directorios cambiados o
  5095. marcados para cambios.
  5096. --deleted Selecciona ficheros y directorios eliminados.
  5097. --moved Selecciona ficheros y directorios movidos.
  5098. --added Selecciona ficheros y directorios añadidos.
  5099. Opciones de salida:
  5100. --silent | --machinereadable [--startlineseparator=sep]
  5101. [--endlineseparator=sep] [--fieldseparator=sep]
  5102. --silent No muestra ninguna salida.
  5103. --machinereadable Muestra la salida en un formato fácil de tratar.
  5104. --startlineseparator Usado en conjunto con la opción '--machinereadable',
  5105. especifica cómo deberían comenzar las líneas.
  5106. --endlineseparator Usado en conjunto con la opción '--machinereadable',
  5107. especifica cómo deberían terminar las líneas.
  5108. --fieldseparator Usado en conjunto con la opción '--machinereadable',
  5109. especifica cómo deberían separarse las líneas.
  5110. == CMD_HELP_UNDO ==
  5111. Notas:
  5112. El comand undo es peligroso - deshace trabajo de una manera irreversible.
  5113. Una vez que el undo termina, no hay manera posible de recuperar el estado
  5114. anterior de los ficheros y directorios afectados. Si no se especifica
  5115. ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
  5116. los elementos del directorio actual, pero NO de manera recursiva.
  5117. Estos comandos son equivalentes ejecutados desde el directorio /src:
  5118. /src
  5119. |- file.txt
  5120. |- code.cs
  5121. \- /test
  5122. |- test_a.py
  5123. \- test_b.py
  5124. $ cm undo
  5125. $ cm undo *
  5126. $ cm undo file.txt code.cs /test
  5127. $ cm undo .
  5128. $ cm undo /src file.txt code.cs
  5129. Si se quiere que la operación sea recursiva, se necesita especificar la
  5130. opción -r.
  5131. Para deshacer todos los cambios debajo de un directorio (incluyendo los
  5132. cambios sobre el propio directorio):
  5133. $ cm undo dirpath -r
  5134. Si dirpath es la ruta de un workspace, todos los cambios dentro del
  5135. workspace serán deshechos.
  5136. Ficheros borrados:
  5137. Para deshacer borrados de fichero o directorios es necesario especificar la
  5138. ruta completa del fichero o directorio, o el directorio padre más la opción
  5139. -r (recursivo).
  5140. Por ejemplo:
  5141. $ cm undo .
  5142. (NO deshace los borrados en el directorio actual.)
  5143. $ cm undo . -r
  5144. (Deshace todos los borrados (y otros cambios) recursivamente del directorio
  5145. actual.)
  5146. $ cm undo src/file.txt
  5147. (Deshace el borrado (u otro cambio) del fichero src/file.txt.)
  5148. Ejemplos:
  5149. $ cm undo . -r
  5150. (Deshace todos los cambios en el directorio actual de manera recursiva. Si
  5151. se ejecuta desde la raíz del workspace, deshace todos los cambios en el
  5152. workspace completo.)
  5153. $ cm co file.txt
  5154. $ cm undo file.txt
  5155. (Deshace el checkout en file.txt.)
  5156. $ echo content >> file.txt
  5157. $ cm undo file.txt
  5158. (Deshace el cambio local en file.txt.)
  5159. $ cm undo src
  5160. (Deshace los cambios en el directorio src y en todos los ficheros
  5161. controlados que contenga)
  5162. $ cm undo src/*
  5163. (Deshace los cambios en todos los elementos contenidos en src, sin afectar
  5164. al propio directorio. Por la expansión del wildcard, es equivalente a
  5165. 'cm undo src/file1.txt src/file2.txt').
  5166. $ cm undo *.cs
  5167. (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
  5168. directorio actual.)
  5169. $ cm undo *.cs -r
  5170. (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
  5171. directorio actual, y en cada directorio por debajo de una manera recursiva.)
  5172. $ cm co file1.txt file2.txt
  5173. $ echo content >> file1.txt
  5174. $ cm undo --unchanged
  5175. (Deshace el checkout en file2.txt por no estar modificado, ignorando
  5176. file1.txt ya que tiene cambios locales.)
  5177. $ echo content >> file1.txt
  5178. $ echo content >> file2.txt
  5179. $ cm co file1.txt
  5180. $ cm undo --checkedout
  5181. (Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
  5182. ya que no está en checkout.)
  5183. $ cm add file.txt
  5184. $ cm undo file.txt
  5185. (Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
  5186. $ rm file1.txt
  5187. $ echo content >> file2.txt
  5188. $ cm add file3.txt
  5189. $ cm undo --deleted --added *
  5190. (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
  5191. el cambio en file2.txt.)
  5192. == CMD_HELP_LOCK_UNLOCK ==
  5193. Ejemplos:
  5194. cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
  5195. cm lock unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 bcb98a61-2f62-4309-9a26-e21a2685e075
  5196. Notas:
  5197. El comando utilizará el servidor especificado para realizar los desbloqueos.
  5198. Si no se especifica ningún servidor, el comando intentará obtener un
  5199. servidor válido a través del espacio de trabajo actual.
  5200. Si con los pasos anteriores no se pudo calcular ningún servidor, el comando
  5201. utilizará el servidor especificado en la configuración del cliente.
  5202. Sólo el usuario administrador del servidor de repositorios podrá ejecutar
  5203. el comando "cm unlock".
  5204. Para la especificación de los GUID's de los elementos, el formato ha de ser
  5205. de 32 dígitos separados por guiones (y opcionalmente, rodeado por llaves):
  5206. {00000000-0000-0000-0000-000000000000} ó 00000000-0000-0000-0000-000000000000
  5207. == CMD_DESCRIPTION_UPDATE ==
  5208. Actualiza el espacio de trabajo.
  5209. == CMD_USAGE_UPDATE ==
  5210. Sintaxis:
  5211. cm update [<ruta> | --last]
  5212. [--changeset=csetspec] [--cloaked] [--dontmerge] [--forced]
  5213. [--ignorechanges] [--override] [--recursewk] [--skipchangedcheck]
  5214. [--silent] [--verbose] [--xml[=output_file]] [--encoding=name]
  5215. ruta Ruta a actualizar.
  5216. Usa . para aplicar la actualización al directorio actual.
  5217. Omita la ruta para actualizar todo el espacio de trabajo
  5218. Si no se especifica ninguna ruta, entonces se actualiza
  5219. todo el espacio de trabajo parcial.
  5220. --last Antes de la actualización, cambia el selector del
  5221. espacio de trabajo de una configuración de changeset o
  5222. de etiqueta a una configuración de rama.
  5223. El selector se cambia a la rama a la que pertenece el
  5224. changeset o la etiqueta.
  5225. Opciones:
  5226. --changeset Actualiza el espacio de trabajo a un changeset concreto.
  5227. Usa 'cm help objectspec' para obtener más información
  5228. sobre la especificación de changesets.
  5229. --cloaked Incluye los ítems cloaked en la operación de update. Si
  5230. no se utiliza esta opción, aquellos ítems marcados como
  5231. cloaked serán ignorados en la operación.
  5232. --dontmerge En el caso en que se necesite una operación de update
  5233. merge, esta operación no se realizará.
  5234. --forced Fuerza la escritura de todas las revisiones.
  5235. --ignorechanges Ignora el mensaje de aviso de "cambios pendientes" si
  5236. existen cambios pendientes durante la actualización del
  5237. espacio de trabajo.
  5238. --override Se ignoran los ficheros cambiados fuera del control de
  5239. Plastic SCM, sobrescribiendo su contenido con el del
  5240. control de versiones.
  5241. --recursewk Actualiza todos los espacios de trabajo encontrados en
  5242. la actual ruta. Esto es útil para actualizar todos los
  5243. espacios de trabajo contenidos en la ruta especificada.
  5244. --skipchangedcheck El update comprueba si hay cambios locales en el
  5245. workspace antes de empezar. Si siempre haces co antes
  5246. de modificar un fichero, puedes usar esta opción para
  5247. acelarar la operación.
  5248. --silent No muestra ninguna salida.
  5249. --verbose Muestra información adicional.
  5250. --xml Permite volcar la salida del comando en formato xml a la
  5251. salida estándar. También se permite especificar un
  5252. fichero de salida (--xml=output.xml).
  5253. --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
  5254. redirige la salida estándar.
  5255. --encoding Si se utiliza con la opción --xml, permite especificar
  5256. el encoding con el que se guardará la salida del
  5257. comando. Consulte la documentación de MSDN para obtener
  5258. la tabla completa de codificaciones soportadas y su
  5259. formato (al final de la página, en la columna "Name"):
  5260. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  5261. == CMD_HELP_UPDATE ==
  5262. Notas:
  5263. Cuando se trabaja con varias ramas o cuando varias personas trabajan contra
  5264. una rama, la información que tenemos en el espacio de trabajo puede quedar
  5265. desactualizada. El caso más sencillo se da cuando cambiamos de rama. Al
  5266. cambiar el selector apuntando a otra rama, debemos actualizar el espacio de
  5267. trabajo con las revisiones de esa rama.
  5268. Cuando varias personas trabajan contra una rama, crean revisiones nuevas
  5269. cada poco tiempo y es fundamental poder actualizar el espacio de trabajo
  5270. para obtener las últimas revisiones.
  5271. Para ello utilizaremos el comando update. Este comando actualiza el espacio
  5272. de trabajo con las revisiones que se le indiquen en el selector.
  5273. Solamente obtiene los ficheros necesarios. Si la revisión que hay en el
  5274. espacio de trabajo coincide con la que hay en el repositorio no se
  5275. actualiza, a no ser que se utilice la opción -–forced. Si la revisión del
  5276. espacio de trabajo es más nueva que la que hay en el repositorio tampoco
  5277. se actualiza. En este caso no nos valdrá la opción -–forced.
  5278. NOTA: El comando update siempre asume recursividad.
  5279. Cuando se especifica la opción --last, no es necesario especificar una ruta.
  5280. En ese caso, el espacio de trabajo del directorio actual es actualizado.
  5281. (Recuerde que al especificar el flag --last puede causar que el selector
  5282. del espacio de trabajo cambie a una rama si previamente apuntaba a un
  5283. changeset o una etiqueta).
  5284. Ejemplos:
  5285. cm update (actualiza el espacio de trabajo actual)
  5286. cm update . (obtiene el directorio actual y todos sus hijos)
  5287. cm update . --forced --verbose (fuerza a escibir todas las revisiones,
  5288. y muestra más información)
  5289. cm udpate --last
  5290. == CMD_DESCRIPTION_VERSION ==
  5291. Muestra el número de versión del cliente.
  5292. == CMD_USAGE_VERSION ==
  5293. Sintaxis:
  5294. cm version
  5295. == CMD_HELP_VERSION ==
  5296. == CMD_DESCRIPTION_WHOAMI ==
  5297. Muestra el usuario actual de Plastic SCM.
  5298. == CMD_USAGE_WHOAMI ==
  5299. Sintaxis:
  5300. cm whoami
  5301. == CMD_HELP_WHOAMI ==
  5302. == CMD_USAGE_WKTREENODESTATUS ==
  5303. Uso:
  5304. cm wktreenodestatus path1, path2, ...
  5305. == CMD_DESCRIPTION_WORKSPACE ==
  5306. Use este comando para administrar workspaces.
  5307. == CMD_USAGE_WORKSPACE ==
  5308. Sintaxis:
  5309. cm workspace | wk comando [options]
  5310. Comandos:
  5311. list | ls
  5312. create | mk
  5313. delete | rm
  5314. move | mv
  5315. rename
  5316. Para obtener más información sobre cada comando:
  5317. cm workspace comando --usage
  5318. cm workspace comando --help
  5319. == CMD_HELP_WORKSPACE ==
  5320. Ejemplos:
  5321. cm workspace create myWorkspace wk_path
  5322. cm workspace list
  5323. cm workspace delete myWorkspace
  5324. == CMD_DESCRIPTION_WORKSPACE_CREATE ==
  5325. Crea un nuevo workspace.
  5326. == CMD_USAGE_WORKSPACE_CREATE ==
  5327. Sintaxis:
  5328. cm workspace | wk [create | mk] nombre ruta [rep_spec] [--selector[=selector_file]
  5329. nombre ruta --dynamic --tree=[tree]
  5330. nombre Nombre del nuevo workspace.
  5331. ruta Ruta de acceso del workspace.
  5332. rep_spec Crea el nuevo workspace con el repositorio especificado.
  5333. Use 'cm help objectspec' para obtener más
  5334. información sobre especificaciones de repositorios.
  5335. Opciones:
  5336. --selector Edita el selector para el nuevo workspace.
  5337. Si se especifica selector-file, entonces el selector
  5338. para el nuevo workspace se fiha desde el fichero
  5339. especificado.
  5340. --dynamic Crea un workspace dinámico. Esta funcionalidad es
  5341. todavía experimental, y solo está disponible para
  5342. Windows. Si se usa esta opción, es obligatorio usar el
  5343. parámetro --tree.
  5344. --tree Especifica el punto inicial al que apuntará el
  5345. workspace dinámico. Puede ser una especificación de
  5346. rama, changeset o etiqueta. El workspace continuará
  5347. usando el repositorio de la especificación. Use
  5348. 'cm help objectspec' para obtener más información sobre
  5349. la especificación.
  5350. == CMD_HELP_WORKSPACE_CREATE ==
  5351. Notas:
  5352. - Un workspace es una vista del repositorio mapeado en el sistema de
  5353. ficheros local, en un directorio especificado. Utilice los comandos
  5354. 'cm showselector' y 'cm setselector' para ver y modificar el selector.
  5355. - Si no se especifica rep_spec ni --selector, el workspace cargará
  5356. automáticamente el contenido del primer repositorio (alfabéticamente) del
  5357. servidor configurado en el fichero de configuración client.conf
  5358. - Los workspaces dinámicos son una funcionalidad experimental (sólo Windows),
  5359. y requiere que el programa plasticfs.exe se esté ejecutando en segundo
  5360. plano.
  5361. Ejemplos:
  5362. cm workspace create myworkspace c:\workspace
  5363. cm wk mk myworkspace /home/john/wkspace
  5364. (Crea el workspace 'myworkspace' en 'c:\workspace' y '/home/john/wkspace'
  5365. respectivamente.)
  5366. cm wk mywktest c:\wks\wktest --selector=myselector.txt
  5367. (Crea 'mywktest' utilizando como selector 'myselector.txt'.)
  5368. cm wk mywkprj c:\wks\wkprj myrep@repserver:localhost:8084
  5369. (Crea 'mywkprj' en 'c:\wks\wkprj' con el repositorio seleccionado.)
  5370. cm wk mywkprj c:\dynwks\mywkprj --dynamic --tree=br:/main@myrep@localhost:8084
  5371. (Crea el workspace dinámico 'mywkprj' en 'c:\dynwks\mywkprj' con el
  5372. repositorio 'myrep@localhost:8084', apuntando a la rama '/main' la primera
  5373. vez que se monte.)
  5374. == CMD_DESCRIPTION_WORKSPACE_DELETE ==
  5375. Borra un workspace.
  5376. == CMD_USAGE_WORKSPACE_DELETE ==
  5377. Sintaxis:
  5378. cm workspace | wk delete | rm [ruta | wkspec] [--keepmetadata]
  5379. ruta Ruta del workspace.
  5380. wkspec Especificación del workspace a borrar.
  5381. Use 'cm help objectspec' para obtener más información sobre la
  5382. especificación de espacios de trabajo.
  5383. Opciones:
  5384. --keepmetadata: No elimina los archivos de metadatos del directorio
  5385. .plastic.
  5386. == CMD_HELP_WORKSPACE_DELETE ==
  5387. Notas:
  5388. Si no se especifican parámetros, se borrará el workspace actual.
  5389. Ejemplos:
  5390. cm workspace delete
  5391. (Elimina el workspace actual)
  5392. cm wk delete c:\workspace
  5393. cm workspace rm /home/danipen/wks
  5394. cm wk rm wk:MiWorkspace
  5395. cm wk rm wk:MiWorkspace@DIGITALIS
  5396. == CMD_DESCRIPTION_WORKSPACE_LIST ==
  5397. Muestra la lista de workspaces.
  5398. == CMD_USAGE_WORKSPACE_LIST ==
  5399. Sintaxis:
  5400. cm workspace | wk [list | ls] [--format=str_format]
  5401. Opciones:
  5402. --format Devuelve el mensaje de respuesta con el formato
  5403. especificado. Consulte la ayuda para más información.
  5404. == CMD_HELP_WORKSPACE_LIST ==
  5405. Notas:
  5406. Este comando acepta una cadena de texto formateada para mostrar la
  5407. salida.
  5408. Los parámetros de salida del comando son los siguientes:
  5409. {0} | {wkname} Nombre del workspace.
  5410. {1} | {machine} Nombre de la máquina.
  5411. {2} | {path} Ruta del workspace.
  5412. {3} | {wkid} Identificador único del workspace.
  5413. {4} | {wkspec} Especificación del workspace en el formato:
  5414. 'wkname@machine'.
  5415. {tab} Inserta un tabulador.
  5416. {newline} Inserta una nueva línea.
  5417. Ejemplos:
  5418. cm wk
  5419. (Lista todos los workspaces.)
  5420. cm workspace list --format={0}#{3,40}
  5421. cm workspace list --format={wkname}#{wkid,40}
  5422. (Lista todos los workspaces mostrando el nombre del workspaces, el
  5423. símbolo '#' y el identificador del workspace utilizando 40 espacios y
  5424. alineado a la izquierda.)
  5425. cm wk --format="Workspace {0} in path {2}"
  5426. cm wk --format="Workspace {wkname} in path {path}"
  5427. (Lista todos los workspaces, mostrando los resultados en cadenas
  5428. formateadas.)
  5429. == CMD_DESCRIPTION_WORKSPACE_MOVE ==
  5430. Mueve un workspace.
  5431. == CMD_USAGE_WORKSPACE_MOVE ==
  5432. Sintaxis:
  5433. cm workspace | wk move | mv [wkspec] ruta
  5434. Opciones:
  5435. wkspec Especificación del workspace a ser movido.
  5436. Use 'cm help objectspec' para obtener más información sobre la
  5437. especificación de espacios de trabajo.
  5438. ruta La ruta destino a la que mover el workspace.
  5439. == CMD_HELP_WORKSPACE_MOVE ==
  5440. Notas:
  5441. Este comando permite al usuario mover workspace a otro lugar en disco.
  5442. Ejemplos:
  5443. cm workspace move myWorkspace \new\workspaceDirectory
  5444. (Mueve el workspace a la ruta especificada.)
  5445. cm wk mv C:\wkspaces\newpath
  5446. (Mueve el workspace de trabajo a 'C:\wkspaces\newpath')
  5447. == CMD_DESCRIPTION_WORKSPACE_RENAME ==
  5448. Cambia el nombre de un workspace.
  5449. == CMD_USAGE_WORKSPACE_RENAME ==
  5450. Sintaxis:
  5451. cm workspace | wk rename [nombre_antiguo] nombre_nuevo
  5452. nombre_antiguo Nombre antiguo del workspace.
  5453. nombre_nuevo Nombre nuevo del workspace.
  5454. == CMD_HELP_WORKSPACE_RENAME ==
  5455. Notas:
  5456. Este comando renombra un workspace. Si no se especifica nombre_antiguo,
  5457. el sistema tomará el nombre del workspace actual.
  5458. Ejemplos:
  5459. cm workspace rename miworkspace wk2
  5460. (El workspace 'miworkspace' se renombra a 'wk2'.)
  5461. cm wk rename nuevoNombre
  5462. (El workspace actual se renombra a 'nuevoNombre'.)
  5463. == CMD_DESCRIPTION_WORKSPACESTATUS ==
  5464. Muestra el changeset cargado en un workspace y si los hay los elementos cambios que contiene.
  5465. == CMD_USAGE_WORKSPACESTATUS ==
  5466. Sintaxis:
  5467. cm status [workspacepath] [opciones] [tipos_de_búsqueda]
  5468. workspacepath: El path de un workspace determinado o una ruta por debajo
  5469. del mismo. La búsqueda de cambiados se realizará a partir del path
  5470. especificado y de manera recursiva.
  5471. Opciones generales:
  5472. --changelist=NAME: Muestra los cambios en el 'changelist' llamado "NAME".
  5473. --changelists: Muestra los cambios agrupados en 'changelists'.
  5474. --cutignored: Evita mostrar los contenidos de los directorios ignorados.
  5475. Requiere el tipo de búsqueda --ignored.
  5476. --header: Solo imprimirá la información del changeset cargado en el
  5477. workspace, no realizará la búsqueda de elementos cambiados.
  5478. --noheader: El comando no imprimirá el estado del workspace, sólo
  5479. realizará e imprimirá la búsqueda de elementos cambiados.
  5480. --nomergesinfo: La información de los merges de los cambios no se imprimirá.
  5481. --head: El comando imprimirá el estado del último changeset de la rama.
  5482. --short: Muestra únicamente rutas de elementos que tienen cambios.
  5483. --symlink: Aplica la operación a los enlaces simbólicos en lugar de
  5484. aplicarla a sus destinos.
  5485. --dirwithchanges: Muestra directorios que contienen cambios (ítems
  5486. añadidos, movidos o eliminados en su interior).
  5487. --xml: Permite volcar la salida del comando en formato xml. Por defecto la
  5488. salida sale en la pantalla, pero si se especifica un fichero
  5489. (--xml=output.xml) la salida se vuelca en dicho fichero.
  5490. --encoding: si se utiliza con la opción --xml, permite especificar el
  5491. encoding con el que se guardará la salida del comando. Consulte la
  5492. documentación de la MSDN para obtener la tabla completa de
  5493. codificaciones soportadas y su formato; al final de la página en la
  5494. columna "Name":
  5495. http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
  5496. --wkrootrelativepaths, --wrp: Muestra rutas relativas a la raíz del
  5497. workspace en vez de rutas relativas al directorio actual.
  5498. --fullpaths, --fp: Fuerza al comando a imprimir rutas absolutas,
  5499. sobreescribiendo cualquier otra configuración acerca de impresión
  5500. de rutas.
  5501. Opciones del viejo formato:
  5502. --cset: El comando imprimirá el estado del workspace en el viejo formato.
  5503. --compact: El comando imprimirá el estado del workspace y la búsqueda de
  5504. elementos cambiados en el viejo formato.
  5505. --noheaders: Usado junto con --compact, la información de cada grupo de
  5506. cambiós no se imprimirá. (No aplica al nuevo formato.)
  5507. Tipos de búsqueda:
  5508. --added: El comando busca elementos añadidos.
  5509. --checkout: El comando busca elementos en checkout.
  5510. --changed: El comando busca elementos cambiados.
  5511. --copied: El comando busca elementos copiados.
  5512. --replaced: El comando busca elementos reemplazados.
  5513. --deleted: El comando busca elementos borrados.
  5514. --localdeleted: El comando busca elementos borrados localmente.
  5515. --moved: El comando busca elementos movidos.
  5516. --localmoved: El comando busca elementos movidos localmente.
  5517. --percentofsimilarity (-p)=valor: Porcentaje de similitud entre dos
  5518. ficheros para considerarlos el mismo en la búsqueda de movidos
  5519. locales, su valor por defecto es un 20%.
  5520. --txtsameext: Sólo aquellos ficheros de texto que tengan la misma
  5521. extensión serán tenidos en cuenta para la búsqueda de movidos basada
  5522. en la similitud del contenido. Por defecto todos los ficheros de texto
  5523. son procesados.
  5524. --binanyext: Cualquier fichero binario es tenido en cuenta para la
  5525. búsqueda de movidos basada en la similitud del contenido. Por defecto
  5526. sólo aquellos ficheros binarios que tengan la misma extensión
  5527. son procesados.
  5528. --private: El comando busca elementos no controlados.
  5529. --ignored: El comando busca elementos ignorados.
  5530. --hiddenchanged: El comando busca elementos cambiados marcados como
  5531. ocultos (incluye '--changed').
  5532. --cloaked: El comando busca elementos marcados como cloaked.
  5533. --controlledchanged: Este modificador engloba los siguientes parámetros:
  5534. '--added' '--checkout' '--copied' '--replaced' '--deleted' '--moved'.
  5535. --all (-a): Este modificador engloba los siguientes parámetros:
  5536. '--controlledchanged' '--changed' '--localdeleted' '--localmoved'
  5537. '--private'.
  5538. == CMD_HELP_WORKSPACESTATUS ==
  5539. Notas:
  5540. El comando status muestra el changeset cargado en un workspace
  5541. y si los hay, los cambios que contiene.
  5542. Se puede utilizar el comando para saber cuál es el changeset con el que se
  5543. está trabajando en un momento dado, y poder utilizarlo, por ejemplo, para
  5544. marcar configuraciones concretas mediante etiquetas de tipo changeset.
  5545. También es útil para conocer los cambios pendientes que existen dentro
  5546. del workspace, los tipos de cambios que deseamos obtener del workspace pueden
  5547. ser modificados gracias a los parámetros que el comando admite. Por defecto
  5548. se muestran todos los cambios, controlados y locales.
  5549. El porcentaje de similitud entre dos ficheros usado por el algoritmo de
  5550. cálculo de movidos locales se puede especicifar mediante la option '--percentofsimilarity'
  5551. o '-p' y su rango va desde 0 hasta 100. Si este parámetro no es especidicado
  5552. su valor por por defecto es del 20%.
  5553. A través de éste comando, también es posible mostrar los cambios agrupados
  5554. en 'changelists' de cliente. El changelist por defecto del sistema (llamado
  5555. 'default'), agrupa los cambios que no están contenidos en el resto de
  5556. 'changelists', por lo que los cambios que se muestran especificando éste
  5557. 'changelist', dependerán del tipo de búsquedas especificados en el comando.
  5558. La opción de mostrar cambios agrupados en 'changelists' requiere mostrar cambios
  5559. controlados (en estado 'added', 'checkout', 'copied', 'replaced', 'deleted' o
  5560. 'moved'), por lo que la opción '--controlledchanged' se activará automáticamente
  5561. cuando se muestren 'changelists'.
  5562. El formato por defecto para la salida en XML es UTF-8. Es posible cambiar
  5563. dicho encoding usando la opción --encoding=otro_encoding.
  5564. El comando 'status' imprime por defecto rutas relativas al directorio de trabajo,
  5565. a menos que se especifiquen las opciones '--machinereadable' o '--short'
  5566. (en cuyo caso, se imprimen rutas absolutas).
  5567. Si se usa la opción '--xml', el comando 'status' imprimirá por defecto rutas
  5568. relativas a la raíz del workspace, a menos que se especifique adicionalmente
  5569. la opción '--fp' (en cuyo caso, se imprimen rutas absolutas).
  5570. Ejemplos:
  5571. cm status
  5572. (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
  5573. y los elementos en checkout, añadidos, copiados, reemplazados, borrados, borrados locales,
  5574. movidos, movidos locales, y privados. La busqueda de los elementos se realiza
  5575. sobre el workspace de forma recursiva)
  5576. cm status --controlledchanged
  5577. (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
  5578. y los elementos del workspace en checkout, añadidos, copiados, reemplazados,
  5579. borrados, y movidos)
  5580. cm status --added
  5581. (Ejecutándolo dentro de workspace el comando imprime el changeset cargado
  5582. y solamente los elementos añadidos. La búsqueda de los elementos se realiza
  5583. sobre el workspace de forma recursiva)
  5584. cm status c:\workspaceLocation\code\client --added
  5585. (El comando imprime el changeset cargado y solamente los elementos añadidos.
  5586. La búsqueda de los elementos se realiza sobre el path proporcionado de forma recursiva)
  5587. cm status --changelists
  5588. cm status --changelist
  5589. (El comando muestra todos los cambios en el espacio de trabajo, agrupados
  5590. por 'changelists').
  5591. cm status --changelist=pending_to_review
  5592. (El comando muestra los cambios que contiene el changelist 'pending_to_review')
  5593. cm status --changelist=default --private
  5594. (El comando muestra los cambios que contiene el changelist 'default',
  5595. el changelist por defecto del sistema, mostrando elementos privados,
  5596. además de elementos con cambios controlados si los hubiese).
  5597. cm status --short --changelist=pending_to_review | cm checkin -
  5598. (Se protegen los cambios en el changelist llamado 'pending_to_review').
  5599. cm status c:\workspaceLocation\code\client --xml=output.xml
  5600. (Guarda la salida del status en el fichero output.xml, en formato XML y
  5601. usando UTF-8.)
  5602. cm status --ignored
  5603. (Muestra todos los elementos ignorados)
  5604. Salida:
  5605. IG src
  5606. IG src/version.c
  5607. IG out/app.exe
  5608. cm status --ignored --cutignored
  5609. (Muestra ficheros ignorados cuyo directorio padre no está ignorado y
  5610. directorios ignorados pero no el árbol de sus contenidos)
  5611. Salida:
  5612. IG src
  5613. IG out/app.exe
  5614. == CMD_DESCRIPTION_XLINK ==
  5615. Crea, edita o muestra un xlink
  5616. == CMD_USAGE_XLINK ==
  5617. Sintaxis:
  5618. cm xlink [-w] [-rs] xlink_path / <csetspec | lbspec | brspec> [<expansion_rules>+]
  5619. (Crea un xlink).
  5620. cm xlink [-rs] xlink_path /relative_path <csetspec | lbspec | brspec> [<expansion_rules>+]
  5621. (Crea un xlink parcial de solo lectura apuntando a /relative_path en lugar
  5622. de apuntar a la raíz por defecto / ).
  5623. cm xlink -e xlink_path <csetspec | lbspec | brspec>
  5624. (Edita un xlink para cambiar la especificación destino).
  5625. cm xlink -s|--show xlink_path
  5626. (Muestra la información de un xlink incluyendo las reglas de expansión).
  5627. cm xlink -ar|--addrules xlink_path <expansion_rules>+
  5628. (Añade al xlink las reglas de expansión proporcionadas).
  5629. cm xlink -dr|--deleterules xlink_path <expansion_rules>+
  5630. (Borra del xlink las reglas de expansión especificadas).
  5631. xlink_path Ruta en el espacio de trabajo actual donde se cargan
  5632. los contenidos del repositorio que se va a enlazar
  5633. (cuando se crea un xlink) o que ya está enlazado
  5634. (cuando se edita un xlink).
  5635. csetspec Especificación del changeset que se va a enlazar.
  5636. Determina qué versión y rama se carga en el espacio de
  5637. trabajo para el repositorio enlazado.
  5638. Usa 'cm help objectspec' para obtener más información
  5639. sobre la especificación de changesets.
  5640. lbspec Especificación de la etiqueta que se va a enlazar.
  5641. Usa 'cm help objectspec' para obtener más información
  5642. sobre la especificación de etiquetas.
  5643. brspec Especificación de la rama que se va a enlazar.
  5644. Usa el changeset actual a donde la rama especificada
  5645. está apuntando.
  5646. Usa 'cm help objectspec' para obtener más información
  5647. sobre la especificación de ramas.
  5648. -e Indica que el comando va a editar un xlink existente
  5649. para cambiar la especificación del changeset enlazado.
  5650. -s | --show Muestra información sobre el xlink seleccionado.
  5651. -ar | --addrules Añade una o más reglas de expansión al xlink indicado.
  5652. -dr | --deleterules Borra una o más reglas de expansión del xlink indicado.
  5653. expansion_rules Especifica una o más reglas de expansión. Cada regla de
  5654. expansión es un par (rama)-(rama a enlazar)
  5655. br:/main/fix-br:/main/develop/fix
  5656. Opciones:
  5657. -w Crea un xlink de escritura. Esto significa que los
  5658. contenidos bajo el xlink se podrán editar mediante el
  5659. uso de autoexpansión de ramas.
  5660. -rs Relative server. Permite crear un xlink a un repositorio
  5661. que es una réplica de otro que existe en un servidor
  5662. central. De este modo se reconcilian automáticamente los
  5663. repositorios replicados con el original.
  5664. Ejemplos:
  5665. cm xlink codigo\segundorepositorio / 1@segundo@localhost:8084
  5666. cm xlink codigo\segundorepositorio / lb:LB001@segundo@localhost:8084
  5667. cm xlink -s codigo\segundorepositorio
  5668. cm xlink -ar codigo\segundorepositorio br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
  5669. cm xlink -dr codigo\segundorepositorio br:/main/fix-br:/main/develop/fix
  5670. == CMD_HELP_XLINK ==
  5671. Notas:
  5672. Este comando crea un xlink al changeset especificado. Por defecto se
  5673. creará como un xlink de sólo lectura. Esto significa que los contenidos
  5674. correspondientes a otro repositorio cargados por debajo del xlink no
  5675. podrán ser modificados.
  5676. Para la edición del changeset de un xlink se puede utilizar una sintaxis
  5677. reducida en la que no hay que especificar el resto de parámetros del
  5678. xlink. Solamente es necesario en nuevo changeset al que apuntará.
  5679. Auto-expansión de ramas:
  5680. Cuando se realiza un cambio en uno de los repositorios enlazados en modo
  5681. de lectura y escritura (opción -e) es necesario crear una nueva rama en
  5682. dicho repositorio basándose en la rama en la que se está trabajando en el
  5683. repositorio principal. Para determinar el nombre de dicha rama, se aplican
  5684. las siguientes reglas:
  5685. 1) Se comprueba si el nombre completo de la rama existe en el
  5686. repositorio enlazado:
  5687. - Si existe, se utiliza dicha rama.
  5688. - Si no existe, Plastic construye el nombre de la rama de esta forma:
  5689. - Nombre de la rama que contiene el changeset enlazado + nombre
  5690. de la rama del repositorio principal.
  5691. - Si existe una rama con dicho nombre, se utiliza como rama de
  5692. trabajo.
  5693. - Si no, se crea una rama nueva con el nombre así construido y
  5694. se establece como base de la rama el changeset enlazado.
  5695. 2) Después, se crea una nueva versión del xlink dentro de la nueva rama
  5696. apuntando al nuevo changeset.
  5697. De este modo, la estructura completa del xlink se mantiene actualizada con
  5698. los últimos cambios en las versiones correctas.
  5699. Ejemplos:
  5700. cm xlink code\firstrepo / 1@first@localhost:8084
  5701. (Crea un xlink en la carpeta 'firstrepo' en el espacio de trabajo actual
  5702. donde el changeset '1' en el repositorio 'first' se enlazará).
  5703. cm xlink opengl\include /includes/opengl 1627@includes@localhost:8087
  5704. (Crea un xlink parcial de solo lectura en la ruta 'opengl\include' en el
  5705. espacio de trabajo actual donde la ruta '/includes/opengl' en el changeset
  5706. '1627' del repositorio 'includes' se enlazará como raíz. Esto significa
  5707. que cualquier ítem dentro de '/includes/opengl' se enlazará en
  5708. 'opengl\include' mientras que el resto del repositorio se ignorará).
  5709. cm xlink -w -rs code\secondrepo / lb:LB001@second@localhost:8084
  5710. (Crea un xlink de escritura y relativo en la ruta 'secondrepo' en el
  5711. espacio de trabajo actual donde la etiqueta'LB001' en el repositorio
  5712. 'second' se enlazará).
  5713. cm xlink code\thirdrepo / 3@third@localhost:8087 br:/main-br:/main/scm003
  5714. (Crea un xlink en la ruta 'thirdrepo' dentro del espacio de trabajo actual
  5715. donde el changeset '3' en el repositorio 'third' se enlazará).
  5716. cm xlink -e code\secondrepo br:/main/task1234@second@localhost:8084
  5717. (Edita el xlink 'code\secondrepo' para cambiar el repositorio destino
  5718. enlazando la rama 'main/task1234' en el repositorio 'second').
  5719. cm xlink --show code\thirdrepo
  5720. (Muestra información del xlink 'code\thirdrepo' incluyendo las reglas de
  5721. expansión si éstas existen).
  5722. cm xlink -ar code\secondrepo br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
  5723. (Añade dos reglas de expansión al xlink 'code\secondrepo').
  5724. cm xlink -dr code\secondrepo br:/main/fix-br:/main/develop/fix
  5725. (Borra la regla de expansión del xlink 'code\secondrepo').
  5726. cm xlink code\secondrepo / 1@second@localhost:8084
  5727. cm xlink code\secondrepo / lb:LB001@second@localhost:8084
  5728. == CMD_USAGE_AUTOCOMPLETE ==
  5729. Sintaxis:
  5730. cm autocomplete install
  5731. Instala el autocompletado de comandos para 'cm' en la shell.
  5732. cm autocomplete uninstall
  5733. Desinstala el autocompletado de comandos para 'cm' de la shell.
  5734. cm autocomplete --line <shell_line> --position <cursor_position>
  5735. Devuelve sugerencias de autocompletado para 'shell_line', que deben ser
  5736. insertadas en 'cursor_position'. Este comando no está pensado para ser
  5737. ejecutado por el usuario final, pero está documentado en caso de que se
  5738. quiera extender el soporte de autocompletado a otras shells.
  5739. shell_line La linea que el usuario ha escrito en la shell cuando se
  5740. pidió el autocompletado.
  5741. En Bash, encuentra en la variable de entorno COMP_LINE.
  5742. En PowerShell, se encuentra en la variable $wordToComplete.
  5743. cursor_position La posición del cursor cuando se pidió el autocompletado.
  5744. En Bash, se encuentra en la variable de entorno COMP_POINT.
  5745. En PowerShell, se encuentra en la variable $cursorPoint.