%!PS-Adobe-3.0 %%Creator: groff version 1.11 %%CreationDate: Fri Feb 11 00:08:03 2000 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic %%DocumentSuppliedResources: procset grops 1.11 0 %%Pages: 4 %%PageOrder: Ascend %%Orientation: Portrait %%EndComments %%BeginProlog %%BeginResource: procset grops 1.11 0 /setpacking where{ pop currentpacking true setpacking }if /grops 120 dict dup begin /SC 32 def /A/show load def /B{0 SC 3 -1 roll widthshow}bind def /C{0 exch ashow}bind def /D{0 exch 0 SC 5 2 roll awidthshow}bind def /E{0 rmoveto show}bind def /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def /G{0 rmoveto 0 exch ashow}bind def /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /I{0 exch rmoveto show}bind def /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def /K{0 exch rmoveto 0 exch ashow}bind def /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /M{rmoveto show}bind def /N{rmoveto 0 SC 3 -1 roll widthshow}bind def /O{rmoveto 0 exch ashow}bind def /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /Q{moveto show}bind def /R{moveto 0 SC 3 -1 roll widthshow}bind def /S{moveto 0 exch ashow}bind def /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def /SF{ findfont exch [exch dup 0 exch 0 exch neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /MF{ findfont [5 2 roll 0 3 1 roll neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /level0 0 def /RES 0 def /PL 0 def /LS 0 def /MANUAL{ statusdict begin/manualfeed true store end }bind def /PLG{ gsave newpath clippath pathbbox grestore exch pop add exch pop }bind def /BP{ /level0 save def 1 setlinecap 1 setlinejoin 72 RES div dup scale LS{ 90 rotate }{ 0 PL translate }ifelse 1 -1 scale }bind def /EP{ level0 restore showpage }bind def /DA{ newpath arcn stroke }bind def /SN{ transform .25 sub exch .25 sub exch round .25 add exch round .25 add exch itransform }bind def /DL{ SN moveto SN lineto stroke }bind def /DC{ newpath 0 360 arc closepath }bind def /TM matrix def /DE{ TM currentmatrix pop translate scale newpath 0 0 .5 0 360 arc closepath TM setmatrix }bind def /RC/rcurveto load def /RL/rlineto load def /ST/stroke load def /MT/moveto load def /CL/closepath load def /FL{ currentgray exch setgray fill setgray }bind def /BL/fill load def /LW/setlinewidth load def /RE{ findfont dup maxlength 1 index/FontName known not{1 add}if dict begin { 1 index/FID ne{def}{pop pop}ifelse }forall /Encoding exch def dup/FontName exch def currentdict end definefont pop }bind def /DEFS 0 def /EBEGIN{ moveto DEFS begin }bind def /EEND/end load def /CNT 0 def /level1 0 def /PBEGIN{ /level1 save def translate div 3 1 roll div exch scale neg exch neg exch translate 0 setgray 0 setlinecap 1 setlinewidth 0 setlinejoin 10 setmiterlimit []0 setdash /setstrokeadjust where{ pop false setstrokeadjust }if /setoverprint where{ pop false setoverprint }if newpath /CNT countdictstack def userdict begin /showpage{}def }bind def /PEND{ clear countdictstack CNT sub{end}repeat level1 restore }bind def end def /setpacking where{ pop setpacking }if %%EndResource %%IncludeResource: font Times-Roman %%IncludeResource: font Times-Bold %%IncludeResource: font Times-Italic grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron /scaron/zcaron/Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O /P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex /underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y /z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft /guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl /endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen /brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft /logicalnot/minus/registered/macron/degree/plusminus/twosuperior /threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior /ordmasculine/guilsinglright/onequarter/onehalf/threequarters /questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE /Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn /germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla /egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis /eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash /ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def /Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE /Times-Roman@0 ENC0/Times-Roman RE %%EndProlog %%Page: 1 1 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 418.84(C4\(1\) C4\(1\))72 48 R/F1 9/Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0(c4 \212 CVS lik)108 96 Q 2.5(ef)-.1 G (ront end to the Perforce SCM system)-2.5 E F1(SYNOPSIS)72 112.8 Q/F2 10 /Times-Bold@0 SF(c4)108 124.8 Q/F3 10/Times-Italic@0 SF(p4\255command) 2.5 E F0 1.666(...)3.27 G F2(c4 update|scan|import)108 136.8 Q F0([)2.5 E F2(\255acdn)2.5 E(vxD)-.4 E F0(])2.5 E F1(DESCRIPTION)72 153.6 Q F2 (C4)108 165.6 Q F0(pro)3.084 E .584(vides a CVS lik)-.15 F(e)-.1 E F3 (feel)3.084 E F0 .584(to Perforce')3.084 F 3.083(sS)-.55 G .583 (CM system)-3.083 F F2(p4)3.083 E F0(.)A F2(C4)5.583 E F0 .583 (is not a substitute for CVS, in that it does)3.083 F (not try to mimic CVS')108 177.6 Q 2.5(sc)-.55 G(ommand set.)-2.5 E(Lik) 108 194.4 Q 2.506(eC)-.1 G .006(VS, e)-2.506 F -.15(ve)-.25 G .006 (ry \214le in a user').15 F 2.506(sw)-.55 G .006(ork-space \()-2.606 F F3(client).2 E F0 2.506(\)i).68 G 2.506(sw)-2.506 G .007 (ritable, and can be modi\214ed on an ad hoc basis.)-2.506 F F2(C4)5.007 E F0(pro)108 206.4 Q .153 (vides commands that search a client, looking for \214les that ha)-.15 F .453 -.15(ve b)-.2 H .153(een changed, and runs a ").15 F F3 .152 (p4 edit)B F0 2.652("c)C(om-)-2.652 E .122(mand on them.)108 218.4 R(An) 5.122 E 2.622<798c>-.15 G .123 (les that are currently opened for edit, and are no longer dif)-2.622 F .123(ferent than their repository)-.25 F(\()108 230.4 Q F3(depot)A F0 2.77(\)v)C .27(ersion, a ")-2.92 F F3 .27(p4 r)B -.15(ev)-.37 G(ert).15 E F0 2.77("c)C .27(ommand is run on them.)-2.77 F .27 (Files that are missing from the client are refreshed)5.27 F(\(")108 242.4 Q F3 .308(p4 r)B(efr)-.37 E(esh)-.37 E F0 2.808("\). Files)B .309 (that e)2.809 F .309(xist in the client that ha)-.15 F .609 -.15(ve n) -.2 H 2.809(om).15 G .309(atching depot v)-2.809 F .309 (ersion are reported, to remind the)-.15 F .611 (user to add them, and can optionally be added automatically)108 254.4 R 5.611(.F)-.65 G .61(iles that are out of date with respect to the)-5.611 F(depot are updated \(")108 266.4 Q F3(p4 g)A(et)-.1 E F0("\).)A F2(C4) 108 283.2 Q F0 .381(also pro)2.881 F .382 (vides support for clients without the use of en)-.15 F .382 (vironment v)-.4 F 2.882(ariables. Each)-.25 F(time)2.882 E F2(c4)2.882 E F0 .382(is e)2.882 F -.15(xe)-.15 G .382(cuted, it).15 F 1.586 (searches for a ")108 295.2 R F2(.c4)A F0 4.086<228c>C 1.585 (le, and incorporates its contents into the en)-4.086 F 1.585 (vironment of an)-.4 F(y)-.15 E F3(p4)4.085 E F0 1.585(command that it) 4.085 F(in)108 307.2 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(s. The).1 F(")2.5 E F2(.c4)A F0 2.5<228c>C(le is usually k)-2.5 E (ept in the root directory of a client.)-.1 E F2(C4)108 324 Q F0 .474 (should be used with Perforce v)2.974 F .475(ersion 97.3 or later)-.15 F (.)-.55 E F2(C4)5.475 E F0 .475(will w)2.975 F .475(ork with older v)-.1 F .475(ersions, b)-.15 F .475(ut \214les will not)-.2 F (remain writable, reducing the usefulness of)108 336 Q F2(c4)2.5 E F0(.) A F1(CLIENT CREA)72 352.8 Q(TION)-.855 E F0 .915(Making a ne)108 364.8 R 3.415(wc)-.25 G .915(lient for use with)-3.415 F F2(c4)3.415 E F0 .915 (is slightly dif)3.415 F .915(ferent than when using)-.25 F F2(p4)3.415 E F0(directly)3.414 E 5.914(.H)-.65 G .914(ere are the steps)-5.914 F (that should be follo)108 376.8 Q(wed:)-.25 E 11.6(1. Create)108 393.6 R 2.5(ac)2.5 G(lient directory)-2.5 E(.)-.65 E 11.6(2. Create)108 410.4 R 2.5<618c>2.5 G(le called ")-2.5 E F2(.c4)A F0 2.5("i)C 2.5(nt)-2.5 G (he client directory with the follo)-2.5 E(wing contents:)-.25 E(P4POR) 165.6 422.4 Q(T=)-.6 E F3(<p4 server port addr)A(ess>)-.37 E F0 (P4CLIENT=)165.6 434.4 Q F3(<client name>)A F0 11.6(3. Change)108 451.2 R .05(directory to the client directory)2.55 F 2.551(,a)-.65 G .051 (nd run the command ")-2.551 F F2(c4 client)A F0 2.551("t)C 2.551(oc) -2.551 G .051(reate the Perforce client.)-2.551 F 2.415 (Set up the client as usual.)129.6 463.2 R 2.415(Modify the ")7.415 F F2 (Options)A F0 4.915("l)C 2.415(ine to enable ")-4.915 F F2(clob)A(ber) -.1 E F0 4.915("a)C 2.415(nd add the option)-4.915 F(")129.6 475.2 Q F2 (allwrite)A F0 2.5(". F)B(or e)-.15 E(xample:)-.15 E 5 (Options: nomodtime)165.6 487.2 R(clobber all)2.5 E(write)-.1 E 11.6 (4. Populate)108 504 R .625(the client with the command ")3.125 F F2 (c4 update)A F0 3.126(". Note)B .626(that ")3.126 F F2(c4 update)A F0 3.126("s)C .626(hould be used in prefer)-3.126 F(-)-.2 E .196(ence to ") 129.6 516 R F2(c4 get)A F0 .196("; with the)B F3(clobber)2.696 E F0 .196 (\215ag set, a modi\214ed \214le may be o)2.696 F -.15(ve)-.15 G .195 (rwritten, destro).15 F .195(ying an)-.1 F 2.695(yc)-.15 G(hanges)-2.695 E(made to it locally)129.6 528 Q(.)-.65 E F1(COMMANDS)72 544.8 Q F0(If) 108 556.8 Q F2(c4)2.511 E F0(doesn')2.511 E 2.511(tr)-.18 G .012 (ecognize a command, it just passes the command and the remaining ar) -2.511 F .012(guments to)-.18 F F2(p4)2.512 E F0 2.512(,a)C .012 (fter in-)-2.512 F .059(corporating the contents of the ")108 568.8 R F2 (.c4)A F0 2.559<228c>C .059(le into the en)-2.559 F 2.559(vironment. If) -.4 F F2(c4)2.559 E F0 .058(recognizes the command, it is e)2.559 F -.15 (xe)-.15 G(cuted).15 E(locally)108 580.8 Q 2.5(,u)-.65 G(sually in)-2.5 E -.2(vo)-.4 G(king se).2 E -.15(ve)-.25 G(ral).15 E F2(p4)2.5 E F0 (commands.)2.5 E F2(C4)5 E F0(adds three ne)2.5 E 2.5(wc)-.25 G (ommands:)-2.5 E F2(c4 update)108 597.6 Q F0(")129.6 609.6 Q F2 (c4 update)A F0 2.5("r)C(esembles the CVS)-2.5 E F3(update)2.5 E F0 2.5 (command. It)2.5 F(performs the follo)2.5 E(wing actions:)-.25 E 11.6 (1. Recursi)129.6 626.4 R -.15(ve)-.25 G .23 (ly scan the current directory and an).15 F 2.73(ys)-.15 G .23 (ub-directories, g)-2.73 F .23(athering information about \214les,)-.05 F(including whether the \214le has been modi\214ed with respect to its \ depot v)151.2 638.4 Q(ersion.)-.15 E 11.6(2. Report)129.6 655.2 R(an) 3.184 E 3.184<798c>-.15 G .684(les that are unkno)-3.184 F .684 (wn, to remind the user that the)-.25 F 3.183(ys)-.15 G .683 (hould be added.)-3.183 F .683(This step can)5.683 F 2.549 (be omitted with the)151.2 667.2 R F2<ad78>5.049 E F0 5.049 (option. Files)5.049 F 2.549(which are)5.049 F F3(ignor)5.049 E(ed)-.37 E F0 2.55(are not reported \(see the section)5.049 F ("IGNORING FILES" belo)151.2 679.2 Q(w\).)-.25 E 11.6(3. Files)129.6 696 R .328(that are not opened and are dif)2.829 F .328 (ferent than their respecti)-.25 F .628 -.15(ve d)-.25 H .328(epot v).15 F .328(ersions are opened with a)-.15 F(")151.2 708 Q F2(p4 edit)A F0 3.355("c)C 3.355(ommand. Files)-3.355 F .855(that are opened and are no) 3.355 F 3.355(wt)-.25 G .856(he same as their respecti)-3.355 F 1.156 -.15(ve d)-.25 H .856(epot v).15 F(er)-.15 E(-)-.2 E 1.437(sion are re) 151.2 720 R -.15(ve)-.25 G 1.437(rted with a ").15 F F2(p4 r)A -2.3 -.15 (ev e)-.18 H(rt).15 E F0 3.937("c)C 3.937(ommand. Files)-3.937 F 1.436 (that are missing from the client are re-)3.937 F 220.25(1.6 1)299.75 768 R EP %%Page: 2 2 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 418.84(C4\(1\) C4\(1\))72 48 R(freshed with a ") 151.2 84 Q/F1 10/Times-Bold@0 SF(p4 r)A(efr)-.18 E(esh)-.18 E F0 2.5("c) C(ommand.)-2.5 E 11.6(4. Files)129.6 100.8 R (that are out of date with respect to the depot are retrie)2.5 E -.15 (ve)-.25 G 2.5(dw).15 G(ith the command ")-2.5 E F1(p4 get)A F0(".)A .843(Note that a ")129.6 117.6 R F1(c4 update)A F0 3.343("c)C .843 (an ne)-3.343 F -.15(ve)-.25 G 3.343(ro).15 G -.15(ve)-3.493 G .843 (rwrite a \214le because a modi\214ed \214le is al).15 F -.1(wa)-.1 G .843(ys opened for edit).1 F .313(with a ")129.6 129.6 R F1(p4 edit)A F0 2.813("c)C .313(ommand before it is retrie)-2.813 F -.15(ve)-.25 G 2.813 (dw).15 G .313(ith a ")-2.813 F F1(p4 get)A F0 2.813("c)C 2.813 (ommand. If)-2.813 F 2.813(am)2.813 G .312(odi\214ed \214le is out of) -2.813 F .848(date, then the user will need to resolv)129.6 141.6 R 3.349(et)-.15 G .849(he dif)-3.349 F .849(ferences with a ")-.25 F F1 (c4 r)A(esolv)-.18 E(e)-.1 E F0 3.349("c)C .849(ommand before submit-) -3.349 F(ting.)129.6 153.6 Q F1(c4 scan)108 170.4 Q F0(")129.6 182.4 Q F1(c4 scan)A F0 2.5("i)C 2.5(st)-2.5 G(he same as a ")-2.5 E F1 (c4 update)A F0 2.5(,b)C(ut it does not update out of date \214les \(") -2.7 E F1(p4 get)A F0("\).)A F1(c4 import)108 199.2 Q F0(")129.6 211.2 Q F1(c4 import)A F0 3.599("i)C 3.599(su)-3.599 G 1.098 (sed to import or re-import whole source trees into Perforce.)-3.599 F F1(C4)6.098 E F0 1.098(will \214gure out all)3.598 F 1.245 (changes that ha)129.6 223.2 R 1.545 -.15(ve h)-.2 H 1.246 (appened in the source tree and issue ").15 F F1(p4 add)A F0 1.246(", ") B F1(p4 edit)A F0 3.746("a)C 1.246(nd ")-3.746 F F1(p4 delete)A F0 3.746 ("c)C(om-)-3.746 E .933(mands as appropriate.)129.6 235.2 R .933 (Apart from \214les that are added, modi\214ed or deleted,)5.933 F F1 (c4)3.432 E F0 .932(can also handle \214les)3.432 F .281(that ha)129.6 247.2 R .581 -.15(ve c)-.2 H .281(hanged type \212 a \214le that w).15 F .281(as a re)-.1 F .281(gular \214le that is no)-.15 F 2.782(wad)-.25 G .282(irectory or symbolic link, or an)-2.782 F(y)-.15 E (other combination of change.)129.6 259.2 Q (The general procedure for import is:)129.6 276 Q 11.6(1. Mak)129.6 292.8 R 2.639(es)-.1 G .138 (ure that the tree is up-to-date by doing a ")-2.639 F F1(c4 update)A F0 2.638("o)C 2.638(ra")-2.638 G F1(c4 sync ...)-2.638 E F0 2.638(". This)B .138(is ob)2.638 F(viously)-.15 E(not necessary if this is a ne)151.2 304.8 Q 2.5(wt)-.25 G(ree.)-2.5 E 11.6(2. Replace)129.6 321.6 R .878 (the tree with the ne)3.378 F 3.378(wt)-.25 G 3.378(ree. This)-3.378 F .878(almost al)3.378 F -.1(wa)-.1 G .878(ys means that you should remo) .1 F 1.179 -.15(ve t)-.15 H .879(he old).15 F(tree and cop)151.2 333.6 Q 2.5(yi)-.1 G 2.5(nt)-2.5 G(he ne)-2.5 E 2.5(wt)-.25 G (ree, ensuring that \214les that no longer e)-2.5 E(xist get deleted.) -.15 E 11.6(3. Change)129.6 350.4 R .123 (directory to the root of the tree and run ")2.623 F F1(c4 import)A F0 2.623(". This)B .123(will issue add, edit and delete)2.623 F (operations as appropriate.)151.2 362.4 Q 11.6(4. Submit)129.6 379.2 R (the resulting changes \(")2.5 E F1(c4 submit)A F0("\).)A .56 (Import can be used when mo)129.6 396 R .56 (ving source from another source control system to Perforce.)-.15 F 3.06 (Al)5.56 G .56(ump of)-3.06 F .511 (source that can be identi\214ed as a single change is e)129.6 408 R .511(xtracted from the other source control system and)-.15 F .74 (submitted using the abo)129.6 420 R 1.04 -.15(ve p)-.15 H 3.24 (rocedure. The).15 F .74(date of the change can e)3.24 F -.15(ve)-.25 G 3.24(nb).15 G 3.24(es)-3.24 G .74(et correctly by using the)-3.24 F(") 129.6 432 Q F1(p4 change -f)A F0 2.5("c)C(ommand after the submit.)-2.5 E/F2 9/Times-Bold@0 SF(.C4 FILE FORMA)72 448.8 Q(T)-.855 E F0 .643 (Each time)108 460.8 R F1(c4)3.143 E F0 .643(is e)3.143 F -.15(xe)-.15 G .642(cuted, it searches for a ").15 F F1(.c4)A F0 3.142<228c>C .642 (le, and incorporates its contents into the en)-3.142 F .642 (vironment of)-.4 F(an)108 472.8 Q(y)-.15 E/F3 10/Times-Italic@0 SF(p4) 2.5 E F0(command that it in)2.5 E -.2(vo)-.4 G -.1(ke).2 G 2.5(s. The).1 F(")2.5 E F1(.c4)A F0 2.5<228c>C(le is usually k)-2.5 E (ept in the root directory of a client.)-.1 E .001(If a ")5.001 F F1 (.c4)A F0 2.501<228c>C(le)-2.501 E(is not found, then the correct)108 484.8 Q F1(p4)2.5 E F0(en)2.5 E(vironment v)-.4 E (ariables must be set \(usually)-.25 E F1(P4POR)2.5 E(T)-.4 E F0(and)2.5 E F1(P4CLIENT)2.5 E F0(\).)A(Ev)108 501.6 Q .536(ery line that be)-.15 F .535(gins with an alphabetic character \(`)-.15 F 2.755 -1.11(A' \255 `) -.8 H .535(Z' or `a' \255 `z'\), and contains an `)1.11 F F1(=)A F0 3.035('i)C 3.035(sa)-3.035 G .535(dded to)-3.035 F 2.041(the en)108 513.6 R 4.541(vironment. Ev)-.4 F 2.041(ery line that be)-.15 F 2.042 (gins with a `)-.15 F F1(:)A F0 4.542('i)C 4.542(su)-4.542 G 2.042 (sed as an ignore speci\214cation \(see the section)-4.542 F .544 ("IGNORING FILES" belo)108 525.6 R 3.044(w\). Ev)-.25 F .544 (ery line that starts with a `)-.15 F F1(#)A F0 3.044('c)C(haracter) -3.044 E 3.044(,i)-.4 G 3.044(se)-3.044 G(mpty)-3.044 E 3.043(,o)-.65 G 3.043(rc)-3.043 G .543(ontains only spaces)-3.043 F(is ignored.)108 537.6 Q(All other lines are currently ignored, b)5 E (ut may not be in future v)-.2 E(ersions of)-.15 E F1(c4)2.5 E F0(.)A F2 (IGNORING FILES)72 554.4 Q F0 .555 (While scanning, if \214les are found that are not kno)108 566.4 R .555 (wn to the depot, the)-.25 F 3.055(ya)-.15 G .555(re e)-3.055 F .555 (xamined to see if the)-.15 F 3.055(ys)-.15 G(hould)-3.055 E .357 (be ignored.)108 578.4 R .356(This is done by matching the basename \(t\ he last name component\) of the \214le to the ignore list)5.357 F 1.381 (for the current directory and the global ignore list.)108 590.4 R 1.381 (The ignore list for each directory is stored in a \214le)6.381 F .572 (called ")108 602.4 R F1(.c4ignor)A(e)-.18 E F0 3.072("i)C 3.071(nt) -3.072 G .571(hat directory)-3.071 F 5.571(.T)-.65 G .571 (he global ignore list is compiled into)-5.571 F F1(c4)3.071 E F0 3.071 (,a)C .571(nd can be modi\214ed or re-)-3.071 F .348 (placed by entries in the)108 614.4 R F1(.c4)2.849 E F0 2.849 (\214le. Directories)2.849 F .349(are matched with ignore lists, allo) 2.849 F .349(wing whole directories to be)-.25 F(ignored.)108 626.4 Q 1.094(Lines be)108 643.2 R 1.094(ginning with `)-.15 F F1(:)A F0 3.593 ('i)C 3.593(nt)-3.593 G(he)-3.593 E F1(.c4)3.593 E F0 1.093 (\214le are considered ignore speci\214cations.)3.593 F 1.093 (An ignore speci\214cation is a)6.093 F .276(globbing string as used by\ the shell; a \214le will be ignored if it matches an)108 655.2 R 2.776 (ye)-.15 G .276(ntry in an ignore list.)-2.776 F 2.777(A`)5.276 G F1(:) -2.777 E F0 2.777('o)C(n)-2.777 E 2.518(al)108 667.2 S .017(ine by itse\ lf will cause the entire ignore list to be deleted; this is generally u\ sed to clear the global list and)-2.518 F(replace it with ne)108 679.2 Q 2.5(we)-.25 G(ntries.)-2.5 E(The def)108 696 Q (ault compiled in global ignore list contains the follo)-.1 E(wing:)-.25 E(*.o, *.a, *.Z, *.gz, .c4, tags, T)144 708 Q -.4(AG)-.93 G(S, core.).4 E 1.146(Here is an e)108 724.8 R(xample)-.15 E F1(.c4)3.646 E F0 1.146 (\214le that de\214nes typical en)3.646 F 1.146(vironment v)-.4 F 1.146 (ariables and replaces the b)-.25 F 1.147(uiltin ignore list)-.2 F 220.25(1.6 2)299.75 768 R EP %%Page: 3 3 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 418.84(C4\(1\) C4\(1\))72 48 R(with another:)108 84 Q(P4POR)144 96 Q(T=bigsun:1666)-.6 E(P4CLIENT=myclient)144 108 Q(:) 144 120 Q(:*.bz2)144 132 Q(:*.[is])144 144 Q(:x.*)144 156 Q(:core)144 168 Q/F1 9/Times-Bold@0 SF(PERFORCE SUPPOR)72 184.8 Q(T)-.36 E/F2 10 /Times-Bold@0 SF(C4)108 196.8 Q F0(uses tw)2.5 E 2.5(oa)-.1 G 2.5(sy) -2.5 G(et undocumented features included in 97.3 and later releases of) -2.5 E F2(p4)2.5 E F0(:)A(all)108 213.6 Q(write)-.1 E(The)129.6 225.6 Q /F3 10/Times-Italic@0 SF(allwrite)2.568 E F0 .068(client option al)2.568 F -.1(wa)-.1 G .067(ys creates \214les that are writable in the client.) .1 F(While)5.067 E F2(c4)2.567 E F0 .067(does not rely on)2.567 F (this, much of its usefulness is diminished without it.)129.6 237.6 Q (dif)108 254.4 Q 2.5(f-)-.25 G(sc)-2.5 E(")129.6 266.4 Q F2(c4 diff -sc) A F0 4.32("c)C 1.82(ombines the ef)-4.32 F 1.82(fect of ")-.25 F F2 (c4 diff -sa)A F0 4.32("a)C 1.82(nd ")-4.32 F F2(c4 diff -se)A F0 1.82 (", to impro)B 2.12 -.15(ve t)-.15 H 1.82(he performance of).15 F .065 (scanning for changed \214les.)129.6 278.4 R F2(C4)5.065 E F0 .065 (will only use this feature on v)2.565 F .064(ersions 97.3 and later) -.15 F 5.064(.[)-.55 G .064(Note: In the 97.3)-5.064 F .334 (release, this feature did not w)129.6 290.4 R .335(ork correctly)-.1 F 2.835(,s)-.65 G(o)-2.835 E F2(c4)2.835 E F0 .335(does not use it.)2.835 F .335(It w)5.335 F .335(as later disco)-.1 F -.15(ve)-.15 G .335 (red that this fea-).15 F(ture w)129.6 302.4 Q (ould not signi\214cantly increase the performance of)-.1 E F2(c4)2.5 E F0(.])A F1(INST)72 319.2 Q(ALLA)-.81 E(TION)-.855 E F2(C4)108 331.2 Q F0 .8(is a single e)3.3 F -.15(xe)-.15 G .8 (cutable that is usually stored in the same place as the).15 F F2(p4)3.3 E F0 .8(client e)3.3 F -.15(xe)-.15 G(cutable.).15 E F2(C4)5.8 E F0 .8 (may be)3.3 F .145(con\214gured as a replacement front end for)108 343.2 R F2(p4)2.645 E F0 .145(by creating a shell script called)2.645 F F2(p4) 2.645 E F0 2.645(,w)C .145(hich contains the follo)-2.645 F(w-)-.25 E (ing:)108 355.2 Q(#!/bin/sh)144 367.2 Q -.15(ex)144 379.2 S (port P4COMMAND=).15 E F3(<name of r)A(eal p4 command>)-.37 E F0 (c4 "$@")144 391.2 Q F1(OPTIONS)72 408 Q F0(When one of the local)108 420 Q F2(c4)2.5 E F0(commands is in)2.5 E -.2(vo)-.4 G -.1(ke).2 G (d, the follo).1 E(wing options may be used to modify its beha)-.25 E (vior:)-.2 E 16.22(\255a F)108 436.8 R .108(orce automatic add.)-.15 F .107(When used with ")5.107 F F2(c4 update)A F0 2.607("o)C 2.607(r") -2.607 G F2(c4 scan)-2.607 E F0 .107(", unkno)B .107 (wn \214les will be added rather)-.25 F(than just reported.)136.8 448.8 Q 16.22(\255c Canonical)108 465.6 R 1.027(update processing.)3.527 F F2 (C4)6.027 E F0 1.027 (will run commands necessary to change the depot to re\215ect the)3.527 F(current client, re)136.8 477.6 Q -.05(ga)-.15 G (rdless of the changes.).05 E([Depreciated; use ")5 E F2(c4 import)A F0 (".])A 15.66(\255d F)108 494.4 R .251(orce automatic delete.)-.15 F .25 (When a \214le is missing in the client, it will be deleted from the de\ pot, rather)5.251 F(than refreshed.)136.8 506.4 Q 15.66(\255n An)108 523.2 R 3.419(yc)-.15 G .919(ommands that cause changes will not be e) -3.419 F -.15(xe)-.15 G 3.419(cuted. When).15 F F2(c4)3.419 E F0 .92 (is in)3.42 F -.2(vo)-.4 G -.1(ke).2 G 3.42(dw).1 G .92 (ith the \255n and \255d)-3.42 F (options, the user can see what will be e)136.8 535.2 Q -.15(xe)-.15 G (cuted for a gi).15 E -.15(ve)-.25 G 2.5(nc).15 G(ircumstance.)-2.5 E 15.66(\255v V)108 552 R 2.912(erbose. Print)-1.11 F .411 (more messages about what is happening.)2.912 F .411 (This is useful when running)5.411 F F2(c4)2.911 E F0 .411(at the root) 2.911 F(of a lar)136.8 564 Q(ge client directory structure; it will pri\ nt the name of each directory as it is scanned.)-.18 E 15.66 (\255x Messages)108 580.8 R(about unkno)2.5 E (wn \214les usually reported by ")-.25 E F2(c4 update)A F0 2.5("a)C (nd ")-2.5 E F2(c4 scan)A F0 2.5("a)C(re suppressed.)-2.5 E 13.44 (\255D When)108 597.6 R(gi)2.941 E -.15(ve)-.25 G(n,).15 E F2(c4)2.941 E F0 .441 (prints diagnostic messages about what is going on \(used for deb)2.941 F(ugging)-.2 E F2(c4)2.942 E F0 2.942(\). Multi-)B (ple \255D options can be gi)136.8 609.6 Q -.15(ve)-.25 G 2.5(nt).15 G 2.5(og)-2.5 G(et more details.)-2.5 E F1(SEE ALSO)72 626.4 Q F0 (p4\(1\), "Perforce User Manual".)108 638.4 Q F1 -.09(BU)72 655.2 S(GS) .09 E F0 .542(If you modify a \214le locally that has been changed in t\ he depot, then when you do a ")108 667.2 R F2(c4 update)A F0 .541 (", you will)B 1.015(get a mer)108 679.2 R 1.016(ge con\215ict.)-.18 F F2(C4)6.016 E F0 1.016(runs a ")3.516 F F2(p4 edit)A F0 3.516("c)C 1.016 (ommand follo)-3.516 F 1.016(wed by a ")-.25 F F2(p4 get)A F0 3.516("c)C 1.016(ommand on the \214le, which)-3.516 F .147 (will result in messages that may confuse some users;)108 691.2 R F2(c4) 2.647 E F0 .146(does the right thing though.)2.647 F -1.1(Yo)5.146 G 2.646(uw)1.1 G .146(ill ha)-2.646 F .446 -.15(ve t)-.2 H 2.646(or).15 G .146(un a)-2.646 F(")108 703.2 Q F2(c4 r)A(esolv)-.18 E(e)-.1 E F0 2.715 ("t)C 2.715(od)-2.715 G .215(eal with the mer)-2.715 F .216 (ge issues before you can submit the \214le.)-.18 F .216(Do not run ") 5.216 F F2(c4 sync)A F0 2.716("o)C 2.716(r")-2.716 G F2(c4 get)-2.716 E F0(")A(as the messages suggest.)108 715.2 Q 220.25(1.6 3)299.75 768 R EP %%Page: 4 4 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF 418.84(C4\(1\) C4\(1\))72 48 R -.4(Wi)108 84 S .215(th both ").4 F/F1 10/Times-Bold@0 SF(clob)A(ber)-.1 E F0 2.715("a)C .215(nd ")-2.715 F F1(allwrite)A F0 2.715("o)C .215 (ptions set on the client \(as the)-2.715 F 2.714(ys)-.15 G .214 (hould be when using)-2.714 F F1(c4)2.714 E F0 .214(\), you should)B 1.16(not use ")108 96 R F1(c4 get)A F0 3.66("t)C 3.66(ou)-3.66 G 1.16 (pdate \214les from the depot if you ha)-3.66 F 1.46 -.15(ve m)-.2 H 1.16(ade local changes \212 your changes will be).15 F -.15(ove)108 108 S 2.5(rwritten. Use).15 F(")2.5 E F1(c4 update)A F0(".)A .165 (If you run)108 124.8 R F1(c4)2.665 E F0 .165(in a directory that is em\ pty in the depot, such as a directory with only ne)2.665 F 2.665<778c> -.25 G .165(les in it, you may)-2.665 F(see messages lik)108 136.8 Q 2.5 (e")-.1 G -3.332 1.666(... \255 n)-2.5 H 2.5(os)-1.666 G (uch \214le\(s\)".)-2.5 E(Don')5 E 2.5(tw)-.18 G(orry about them.)-2.6 E .117(When doing a ")108 153.6 R F1(c4 import)A F0 .117(", the client mu\ st be up-to-date with respect to the depot before changes are made)B .665(to the client; that is, there must not be \214les that must be syn\ chronized in a directory that no longer e)108 165.6 R(xists.)-.15 E .576 (This is because the)108 177.6 R F1(p4)3.076 E F0 .576(client command d\ oes not handle directories; if a directory is replaced by a \214le or a) 3.076 F(symbolic link,)108 189.6 Q F1(p4)2.5 E F0(can get confused and) 2.5 E F1(c4)2.5 E F0 1.1 -.55('s i)D(mport processing will f).55 E(ail.) -.1 E .362(When doing a ")108 206.4 R F1(c4 import)A F0 .362 (", changes between a re)B .361 (gular \214le, directory or symbolic link are handled, ho)-.15 F(we)-.25 E(v-)-.25 E(er)108 218.4 Q 2.5(,t)-.4 G (his functionality is not well tested.)-2.5 E(This will no doubt be tak) 5 E(en care of by the ne)-.1 E(xt release of)-.15 E F1(c4)2.5 E F0(.)A .31(The options pro)108 235.2 R .31(vided by)-.15 F F1(c4)2.81 E F0 .31 (are not necessarily consistent with each other)2.81 F 5.31(.T)-.55 G .31(his is a historical accident and)-5.31 F (may be recti\214ed in the future.)108 247.2 Q 220.25(1.6 4)299.75 768 R EP %%Trailer end %%EOF
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#1 | 1985 | Sean Nolan | my initial branch | ||
//guest/perforce_software/utils/c4/c4.ps | |||||
#4 | 276 | Neil Russell |
C4 - small bug fixed; updated to version 1.6 * We are now a little more intelligent about what happens if there is a merge conflict between the local client and the head of the tree, and also about trying to do a refresh and a sync on the same file. |
||
#3 | 223 | Neil Russell | C4 - small bug fixed; updated to version 1.5 | ||
#2 | 159 | Neil Russell |
C4 integrated into //public/perforce/utils/c4. This is version 1.4 of C4, ready for release. |
||
#1 | 18 | Perforce maintenance | Add c4, a CVS-like frontend to p4 |