chm/cmdline/switches/include.htm

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\r
   2 <HTML>\r
   3 <HEAD>\r
   4   <META http-equiv="Content-Type" content="text/html; charset=Windows-1252">\r
   5   <TITLE>-i (Include filenames) switch</TITLE>\r
   6   <LINK href="style.css" rel="stylesheet" type="text/css">\r
   7 </HEAD>\r
   8 \r
   9 <BODY>\r
  10 \r
  11 <H1>-i (Include filenames) switch</H1>\r
  12 \r
  13 <P>Specifies additional include filenames and wildcards.</P>\r
  14 <P>Multiple include switches are supported.</P>\r
  15 \r
  16 <H4>Syntax</H4>\r
  17 \r
  18 <PRE class="syntax">\r
  19 -i[<A class="parameter" href="#recurse_type">&lt;recurse_type></A>]<A class="parameter" href="#file_ref">&lt;file_ref></A>\r
  20 \r
  21 <A class="parameter" href="#recurse_type">&lt;recurse_type></A> ::= r[- | 0]\r
  22 <A class="parameter" href="#file_ref">&lt;file_ref></A> ::= @{listfile} | !{wildcard}\r
  23 </PRE>\r
  24 \r
  25 <H4>Parameters</H4>\r
  26 \r
  27 <DL>\r
  28   <DT><A name="recurse_type"></A>&lt;recurse_type></DT>\r
  29   <DD><P>Specifies how wildcards and file names in this switch must\r
  30          be used. If this option is not given, then the global value, assigned\r
  31          by the <A href="recurse.htm">-r (Recurse)</A> switch will be used. For\r
  32          more details see specification of the\r
  33          <A href="recurse.htm">-r (Recurse)</A> switch.</P>\r
  34 <PRE class="syntax">\r
  35 &lt;recurse_type> ::= r[- | 0]\r
  36 </PRE>\r
  37 \r
  38  </DD>\r
  39  <DT><A name="file_ref"></A>&lt;file_ref></DT>\r
  40  <DD>\r
  41    <P>Specifies filenames and wildcards, or a list file, for files to be processed.</P>\r
  42 <PRE class="syntax">\r
  43 &lt;file_ref> ::= @{listfile} | !{wildcard}\r
  44 </PRE>\r
  45    <TABLE>\r
  46      <TR> <TH width="120">Option</TH> <TH>Description</TH> </TR>\r
  47      <TR> <TD>{listfile}</TD> <TD>Specifies name of list file. See\r
  48                   <A href = ../syntax.htm#ListFile>List file</A> description.</TD> </TR>\r
  49      <TR> <TD>{wildcard}</TD> <TD>Specifies wildcard or filename.</TD> </TR>\r
  50    </TABLE>\r
  51  </DD>\r
  52 </DL>\r
  53 \r
  54 <H4>Examples</H4>\r
  55 \r
  56 <PRE class="example">\r
  57 7z a -tzip src.zip *.txt -ir!DIR1\*.cpp\r
  58 </PRE>\r
  59 \r
  60 <P>adds to <SPAN class="filename">src.zip</SPAN> archive all\r
  61   <SPAN class="filename">*.txt</SPAN> files from current directory\r
  62   and all <SPAN class="filename">*.cpp</SPAN>\r
  63   files from directory <SPAN class="filename">DIR1</SPAN>\r
  64   and from all it's subdirectories.</P>\r
  65 \r
  66 <H4>Commands that can be used with this switch</H4>\r
  67 \r
  68 <P>\r
  69   <A href="../commands/add.htm">a (Add)</A>,\r
  70   <A href="../commands/delete.htm">d (Delete)</A>,\r
  71   <A href="../commands/extract.htm">e (Extract)</A>,\r
  72   <A href="../commands/list.htm">l (List)</A>,\r
  73   <A href="../commands/test.htm">t (Test)</A>,\r
  74   <A href="../commands/update.htm">u (Update)</A>,\r
  75   <A href="../commands/extract_full.htm">x (Extract with full paths)</A>\r
  76 </P>\r
  77 \r
  78 <H4>See also</H4>\r
  79 \r
  80 <P>\r
  81   <B>Switches:</B>\r
  82   <A href="recurse.htm">-r (Recurse)</A>,\r
  83   <A href="exclude.htm">-x (Exclude)</A>\r
  84 </P>\r
  85 \r
  86 </BODY>\r
  87 </HTML>\r