diff options
Diffstat (limited to 'src/libs/7zip/unix/DOCS/MANUAL/syntax.htm')
-rw-r--r-- | src/libs/7zip/unix/DOCS/MANUAL/syntax.htm | 120 |
1 files changed, 120 insertions, 0 deletions
diff --git a/src/libs/7zip/unix/DOCS/MANUAL/syntax.htm b/src/libs/7zip/unix/DOCS/MANUAL/syntax.htm new file mode 100644 index 000000000..63822e03b --- /dev/null +++ b/src/libs/7zip/unix/DOCS/MANUAL/syntax.htm @@ -0,0 +1,120 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> + <META http-equiv="Content-Type" content="text/html; charset=Windows-1252"> + <TITLE>Command Line Syntax</TITLE> + <LINK href="style.css" rel="stylesheet" type="text/css"> +</HEAD> + +<BODY> + +<H1>Command Line Syntax</H1> + +<PRE class = "syntax"> +7z <A href = "commands/index.htm"><command></A> [<A href = "switches/index.htm"><switch></A>...] <base_archive_name> [<arguments>...] +</PRE> +<PRE class = "syntax"> +<arguments> ::= <A href = "switches/index.htm"><switch></A> | <wildcard> | <filename> | <list_file> +<A href = "switches/index.htm"><switch></A>::= <switch_symbol><switch_characters>[<option>] +<switch_symbol> ::= '/' | '-' +<list_file> ::= @{filename} +</PRE> + + +<P>Expressions in square brackets (between '[' and ']') are optional.</P> + +<P>Expressions in curly braces ('{' and '}') mean that instead of that +Expression (including braces), the user must substitute some string.</P> + +<P>Expression</P> + +<PRE class = "syntax"> +expression1 | expression2 | ... | expressionN</DT> +</PRE> + +<P> +means that any (but only one) from these expressions must be specified. + +<P><A href = "commands/index.htm">Commands</A> and +<A href = "switches/index.htm">switches</A> can be entered in upper or lower case.</P> + +<P>Command is the first non-switch argument.</P> + +<P>The "base_archive_name" must be the first filename on the command line +after the command.</P> + +<P>The switches and other filenames can be in any order.</P> + +<P>Wildcards or filenames with spaces must be quoted:</P> + +<PRE> + "Dir\Program files\*" + Dir\"Program files"\* +</PRE> + +<P>Switch options can be combined to save command line length. However, some +switch options take optional string arguments and therefore, must be the +last option in a combined argument token string because 7-Zip accepts the +rest of the argument token as the optional argument.</P> + +<P>7-Zip uses wild name matching similar to Windows 95:</P> +<UL> + <LI><B>'*'</B> means a sequence of arbitrary characters.</LI> + <LI><B>'?'</B> means any character.</LI> +</UL> + +<P><B> +7-Zip doesn't uses the system wildcard parser. 7-Zip doesn't +follow the archaic rule by which *.* means any file. 7-Zip treats +*.* as matching the name of any file that has an extension. To process all files, you must +use a * wildcard.</B></P> + +<P>Examples:</P> +<TABLE border = "0"> + <TR><TD>*.txt</TD><TD>means all files with an extension of ".txt"</TD></TR> + <TR><TD>?a*</TD><TD>means all files with a second character of "a"</TD></TR> + <TR><TD>*1*</TD><TD>means all names that contains character "1"</TD></TR> + <TR><TD>*.*.*</TD><TD>means all names that contain two at least "." characters</TD></TR> +</TABLE> + + +<P>The default wildcard "*" will be used if there is no filename/wildcard in the +command line.</P> + +<P>Slash ('\') at the end of a path means a directory. Without a Slash ('\') at +the end of the path, the path can refer either to a file or a directory. + + +<H2><A name = "ListFile"></A>List file</H2> + +<P>You can supply one or more filenames or wildcards for special list files +(files containing lists of files). The filenames in such list file must be +separated by new line symbol(s).</P> + +<P>For list files, 7-Zip uses UTF-8 encoding by default. You can change encoding +using <A href = "switches/charset.htm">-scs</A> switch.</P> + +<P>Multiple list files are supported.</P> + +<P>For example, if the file "listfile.txt" contains the following:</P> + +<PRE> + My programs\*.cpp + Src\*.cpp +</PRE> +<P>then the command</P> + +<PRE> + 7z a -tzip archive.zip @listfile.txt +</PRE> + +<P>adds to the archive "archive.zip" all "*.cpp" files from directories "My +programs" and "Src".</P> + +<H2><A name = "ListFile"></A>Short and Long File Names</H2> + +<P>7-Zip supports short file names (like FILENA~1.TXT) in some cases. +However, it's strongly recommended to use only the real (long) file names.</P> + +</BODY> +</HTML> |