projects / OpenSPARC-T2-DV / blame
? search:
summary | tags | clone url | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / man / man3 / ExtUtils::Command.3
CommitLineData
86530b38
AT		 1.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
2.\"
3.\" Standard preamble:
4.\" ========================================================================
5.de Sh \" Subsection heading
6.br
7.if t .Sp
8.ne 5
9.PP
10\fB\\$1\fR
11.PP
12..
13.de Sp \" Vertical space (when we can't use .PP)
14.if t .sp .5v
15.if n .sp
16..
17.de Vb \" Begin verbatim text
18.ft CW
19.nf
20.ne \\$1
21..
22.de Ve \" End verbatim text
23.ft R
24.fi
25..
26.\" Set up some character translations and predefined strings. \*(-- will
27.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28.\" double quote, and \*(R" will give a right double quote. | will give a
29.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31.\" expand to `' in nroff, nothing in troff, for use with C<>.
32.tr \(*W-|\(bv\*(Tr
33.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34.ie n \{\
35. ds -- \(*W-
36. ds PI pi
37. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39. ds L" ""
40. ds R" ""
41. ds C` ""
42. ds C' ""
43'br\}
44.el\{\
45. ds -- \|\(em\|
46. ds PI \(*p
47. ds L" ``
48. ds R" ''
49'br\}
50.\"
51.\" If the F register is turned on, we'll generate index entries on stderr for
52.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53.\" entries marked with X<> in POD. Of course, you'll have to process the
54.\" output yourself in some meaningful fashion.
55.if \nF \{\
56. de IX
57. tm Index:\\$1\t\\n%\t"\\$2"
58..
59. nr % 0
60. rr F
61.\}
62.\"
63.\" For nroff, turn off justification. Always turn off hyphenation; it makes
64.\" way too many mistakes in technical documents.
65.hy 0
66.if n .na
67.\"
68.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69.\" Fear. Run. Save yourself. No user-serviceable parts.
70. \" fudge factors for nroff and troff
71.if n \{\
72. ds #H 0
73. ds #V .8m
74. ds #F .3m
75. ds #[ \f1
76. ds #] \fP
77.\}
78.if t \{\
79. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80. ds #V .6m
81. ds #F 0
82. ds #[ \&
83. ds #] \&
84.\}
85. \" simple accents for nroff and troff
86.if n \{\
87. ds ' \&
88. ds ` \&
89. ds ^ \&
90. ds , \&
91. ds ~ ~
92. ds /
93.\}
94.if t \{\
95. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101.\}
102. \" troff and (daisy-wheel) nroff accents
103.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110.ds ae a\h'-(\w'a'u*4/10)'e
111.ds Ae A\h'-(\w'A'u*4/10)'E
112. \" corrections for vroff
113.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115. \" for low resolution devices (crt and lpr)
116.if \n(.H>23 .if \n(.V>19 \
117\{\
118. ds : e
119. ds 8 ss
120. ds o a
121. ds d- d\h'-1'\(ga
122. ds D- D\h'-1'\(hy
123. ds th \o'bp'
124. ds Th \o'LP'
125. ds ae ae
126. ds Ae AE
127.\}
128.rm #[ #] #H #V #F C
129.\" ========================================================================
130.\"
131.IX Title "ExtUtils::Command 3"
132.TH ExtUtils::Command 3 "2003-08-18" "perl v5.8.0" "User Contributed Perl Documentation"
133.SH "NAME"
134ExtUtils::Command \- utilities to replace common UNIX commands in Makefiles etc.
135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS"
137.Vb 11
138\& perl -MExtUtils::Command -e cat files... > destination
139\& perl -MExtUtils::Command -e mv source... destination
140\& perl -MExtUtils::Command -e cp source... destination
141\& perl -MExtUtils::Command -e touch files...
142\& perl -MExtUtils::Command -e rm_f files...
143\& perl -MExtUtils::Command -e rm_rf directories...
144\& perl -MExtUtils::Command -e mkpath directories...
145\& perl -MExtUtils::Command -e eqtime source destination
146\& perl -MExtUtils::Command -e test_f file
147\& perl -MExtUtils::Command -e chmod mode files...
148\& ...
149.Ve
150.SH "DESCRIPTION"
151.IX Header "DESCRIPTION"
152The module is used to replace common \s-1UNIX\s0 commands. In all cases the
153functions work from \f(CW@ARGV\fR rather than taking arguments. This makes
154them easier to deal with in Makefiles.
155.PP
156.Vb 1
157\& perl -MExtUtils::Command -e some_command some files to work on
158.Ve
159.PP
160\&\fI\s-1NOT\s0\fR
161.PP
162.Vb 1
163\& perl -MExtUtils::Command -e 'some_command qw(some files to work on)'
164.Ve
165.PP
166Filenames with * and ? will be glob expanded.
167.IP "cat" 4
168.IX Item "cat"
169Concatenates all files mentioned on command line to \s-1STDOUT\s0.
170.IP "eqtime src dst" 4
171.IX Item "eqtime src dst"
172Sets modified time of dst to that of src
173.IP "rm_rf files...." 4
174.IX Item "rm_rf files...."
175Removes directories \- recursively (even if readonly)
176.IP "rm_f files...." 4
177.IX Item "rm_f files...."
178Removes files (even if readonly)
179.IP "touch files ..." 4
180.IX Item "touch files ..."
181Makes files exist, with current timestamp
182.IP "mv source... destination" 4
183.IX Item "mv source... destination"
184Moves source to destination. Multiple sources are allowed if
185destination is an existing directory.
186.Sp
187Returns true if all moves succeeded, false otherwise.
188.IP "cp source... destination" 4
189.IX Item "cp source... destination"
190Copies source to destination. Multiple sources are allowed if
191destination is an existing directory.
192.Sp
193Returns true if all copies succeeded, false otherwise.
194.IP "chmod mode files..." 4
195.IX Item "chmod mode files..."
196Sets \s-1UNIX\s0 like permissions 'mode' on all the files. e.g. 0666
197.IP "mkpath directory..." 4
198.IX Item "mkpath directory..."
199Creates directory, including any parent directories.
200.IP "test_f file" 4
201.IX Item "test_f file"
202Tests if a file exists
203.IP "dos2unix" 4
204.IX Item "dos2unix"
205Converts \s-1DOS\s0 and \s-1OS/2\s0 linefeeds to Unix style recursively.
206.SH "BUGS"
207.IX Header "BUGS"
208Should probably be Auto/Self loaded.
209.SH "SEE ALSO"
210.IX Header "SEE ALSO"
211ExtUtils::MakeMaker, ExtUtils::MM_Unix, ExtUtils::MM_Win32
212.SH "AUTHOR"
213.IX Header "AUTHOR"
214Nick Ing-Simmons \f(CW\*(C`ni\-s@cpan.org\*(C'\fR
215.PP
216Currently maintained by Michael G Schwern \f(CW\*(C`schwern@pobox.com\*(C'\fR.
Full OpenSPARC design & verification tarball including full HDL.