home *** CD-ROM | disk | FTP | other *** search
/ Enter 2004 February / ENTER.ISO / files / OO / f_0034 / common.jar / text / common / guide / start_parameters.xml < prev    next >
Encoding:
Extensible Markup Language  |  2003-08-01  |  19.6 KB  |  190 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>Starting the %PRODUCTNAME Software With Parameters</title><meta name="filename" content="text/common/guide/start_parameters"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         table.Tabelle2{
  5.                 }
  6.         span.Tabelle2A{
  7.                 width:1.831cm;}
  8.         span.Tabelle2B{
  9.                 width:16.168cm;}
  10.         td.Tabelle2A1{
  11.                 }
  12.         td.Tabelle2B1{
  13.                 }
  14.         table.Tabelle1{
  15.                 margin-left:0cm; margin-right:-0.018cm;}
  16.         span.Tabelle1A{
  17.                 width:6.154cm;}
  18.         span.Tabelle1B{
  19.                 width:11.862cm;}
  20.         td.Tabelle1A1{
  21.                 }
  22.         td.Tabelle1B1{
  23.                 border-width:0.002cm; border-style:solid; border-color:#000000;}
  24.         td.Tabelle1A2{
  25.                 }
  26.         td.Tabelle1B2{
  27.                 }
  28.         p.P1{
  29.                 }
  30.         p.P2{
  31.                 }
  32.         p.P3{
  33.                 }
  34.         p.P4{
  35.                 }
  36.         span.T1{
  37.                 font-weight:bold;}
  38.         span.fr1{
  39.                 }
  40.         </style></head><body>
  41.   
  42.   
  43.   <help:paragraphinfo state="E" xmlns:help="http://openoffice.org/2000/help"/><help:to-be-embedded Eid="start_parameters" xmlns:help="http://openoffice.org/2000/help">
  44.   <p class="Head1"><help:paragraphinfo state="U" number="52"/><help:key-word value="start parameters" tag="kw68633_1"/><help:key-word value="%PRODUCTNAME; start parameters" tag="kw68633_5"/><help:key-word value="command line parameters" tag="kw68633_4"/><help:key-word value="parameters; command line" tag="kw68633_3"/><help:key-word value="arguments; command line" tag="kw68633_2"/>Starting the <help:productname>%PRODUCTNAME</help:productname> Software With Parameters</p>
  45.   <p class="Paragraph"><help:paragraphinfo state="U" number="1"/>By starting the <help:productname>%PRODUCTNAME</help:productname> software from the command line you can assign various parameters, with which you can influence the performance. The use of command line parameters is only recommended for experienced users.</p>
  46.   <table border="1" bordercolor="#000000" cellpadding="2" cellspacing="0" page-break-inside="page-break-inside:avoid"><tr class=""><th class="Tabelle2A1" style="text-align:left;"><span class="Tabelle2A">
  47.       <p class="TableHead"><draw:image draw:name="Icon0" svg:desc="Note" svg:pixelx="32" svg:pixely="32" svg:width="0.847cm" svg:height="0.847cm" xlink:href="65980" draw:filter-name="" xmlns:draw="http://openoffice.org/2000/drawing" xmlns:svg="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"/></p>
  48.  
  49.      </span></th><th class="Tabelle2B1" style="text-align:left;"><span class="Tabelle2B">
  50.       <p class="Paragraph"><help:paragraphinfo state="U" number="2"/>For normal handling, the use of command line parameters is not necessary. A few of the parameters require a deeper knowledge of the technical background of the <help:productname>%PRODUCTNAME</help:productname> software technology.</p>
  51.       <p class="Paragraph"><help:paragraphinfo state="U" number="3"/>More information on this topic can be found at <a href="http://www.openoffice.org" class="ContentLink">www.openoffice.org</a>.</p>
  52.      </span></th></tr></table>
  53.   <p class="Head2"><help:paragraphinfo state="U" number="4"/>Starting the <help:productname>%PRODUCTNAME</help:productname> Software From the Command Line</p>
  54.   <help:paragraphinfo state="E"/>
  55.   <ol class="L1">
  56.    <li class="">
  57.     <p style=""><help:paragraphinfo state="U" number="5"/>Under Windows, select <span style="font-weight:bold;">Run</span> from the Windows Start menu, or open a Shell under UNIX┬« based platforms.</p>
  58.    </li>
  59.    <li class="">
  60.     <p style=""><help:paragraphinfo state="U" number="6"/>Under Windows, type the following text in the <span style="font-weight:bold;">Open </span>text field and click <span style="font-weight:bold;">OK</span>. </p>
  61.    </li>
  62.    <li class="">
  63.     <p style=""><help:paragraphinfo state="U" number="53"/>Under UNIX based systems, type the following line of text, then press <span style="font-weight:bold;">Return</span>:</p>
  64.     <p style=""><help:paragraphinfo state="U" number="7"/><help:switch select="System"><help:case select="WIN">{install}\program\soffice.exe {parameter}</help:case><help:case select="UNIX">{install}/program/soffice {parameter}</help:case></help:switch></p>
  65.     <p style=""><help:paragraphinfo state="U" number="8"/>Replace <span style="font-weight:bold;">{install}</span> with the path to your installation of the <help:productname>%PRODUCTNAME</help:productname> software (for example, <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/><span style="font-weight:bold;">C:\Program Files\Office</span>, or <span style="font-weight:bold;">~/office</span>)</p>
  66.     <p style=""><help:paragraphinfo state="U" number="9"/>Where required, replace <span style="font-weight:bold;">{parameter}</span> with one or more of the following command line parameters.</p>
  67.    </li>
  68.   </ol>
  69.   <p class="Head2"><help:paragraphinfo state="U" number="10"/>Valid Command Line Parameters</p>
  70.   <table border="1" bordercolor="#000000" cellpadding="2" cellspacing="0" page-break-inside="page-break-inside:avoid"><tr class=""><th class="Tabelle1A1" style="text-align:left;"><span class="Tabelle1A">
  71.       <p style=""><help:paragraphinfo state="U" number="11"/>Parameter</p>
  72.      </span></th><th class="Tabelle1B1" style="text-align:left;"><span class="Tabelle1B">
  73.       <p style=""><help:paragraphinfo state="U" number="12"/>Meaning</p>
  74.      </span></th></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  75.      <p class="PropText"><help:paragraphinfo state="U" number="73"/>-help / -h / -?</p>
  76.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  77.      <p class="Paragraph"><help:paragraphinfo state="U" number="74"/>Lists the available command line parameters <help:switch select="System"><help:case select="WIN">in a dialog box</help:case><help:default>to the console</help:default></help:switch>. -help shows a long help text, -h shows a short help text.</p>
  78.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  79.      <p class="PropText"><help:paragraphinfo state="U" number="59"/>-writer</p>
  80.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  81.      <p class="Paragraph"><help:paragraphinfo state="U" number="60"/>Starts with an empty Writer document.</p>
  82.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  83.      <p class="PropText"><help:paragraphinfo state="U" number="61"/>-calc</p>
  84.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  85.      <p class="Paragraph"><help:paragraphinfo state="U" number="62"/>Starts with an empty Calc document.</p>
  86.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  87.      <p class="PropText"><help:paragraphinfo state="U" number="63"/>-draw</p>
  88.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  89.      <p class="Paragraph"><help:paragraphinfo state="U" number="64"/>Starts with an empty Draw document.</p>
  90.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  91.      <p class="PropText"><help:paragraphinfo state="U" number="65"/>-impress</p>
  92.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  93.      <p class="Paragraph"><help:paragraphinfo state="U" number="66"/>Starts with an empty Impress document.</p>
  94.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  95.      <p class="PropText"><help:paragraphinfo state="U" number="67"/>-math</p>
  96.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  97.      <p class="Paragraph"><help:paragraphinfo state="U" number="68"/>Starts with an empty Math document.</p>
  98.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  99.      <p class="PropText"><help:paragraphinfo state="U" number="69"/>-global</p>
  100.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  101.      <p class="Paragraph"><help:paragraphinfo state="U" number="70"/>Starts with an empty global document.</p>
  102.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  103.      <p class="PropText"><help:paragraphinfo state="U" number="71"/>-web</p>
  104.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  105.      <p class="Paragraph"><help:paragraphinfo state="U" number="72"/>Starts with an empty HTML document.</p>
  106.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  107.      <p class="PropText"><help:paragraphinfo state="U" number="79"/>-start {filename.sxi}</p>
  108.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  109.      <p class="Paragraph"><help:paragraphinfo state="U" number="80"/>Starts with the Impress file <span style="font-weight:bold;">{filename.sxi}</span> and starts the presentation. Enters edit mode after the presentation.</p>
  110.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  111.      <p class="PropText"><help:paragraphinfo state="U" number="13"/>-minimized</p>
  112.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  113.      <p class="Paragraph"><help:paragraphinfo state="U" number="14"/>Starts minimized. The splash screen is not displayed.</p>
  114.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  115.      <p class="PropText"><help:paragraphinfo state="U" number="15"/>-invisible</p>
  116.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  117.      <p class="Paragraph"><help:paragraphinfo state="U" number="16"/>Starts in invisible mode.</p>
  118.      <p class="Paragraph"><help:paragraphinfo state="U" number="17"/>Neither the start-up logo nor the initial program window will be visible. However, the <help:productname>%PRODUCTNAME</help:productname> software can be controlled and documents and dialogs opened via the <a href="http://api.openoffice.org" class="ContentLink">API</a>. </p>
  119.      <p class="Paragraph"><help:paragraphinfo state="U" number="18"/>When the <help:productname>%PRODUCTNAME</help:productname> software has been started with this parameter, it can only be ended using the taskmanager (Windows) or the <span style="font-weight:bold;">kill </span>command (UNIX based systems).</p>
  120.      <p class="Paragraph"><help:paragraphinfo state="U" number="48"/>It cannot be used in conjunction with <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/><span style="font-weight:bold;">-quickstart</span>.</p>
  121.      <p class="Paragraph"><help:paragraphinfo state="U" number="19"/>More information is found in the <span style="font-weight:bold;"><help:productname>%PRODUCTNAME</help:productname> Developer's Guide</span>.</p>
  122.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  123.      <p class="PropText"><help:paragraphinfo state="U" number="77"/>-nocrashreport</p>
  124.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  125.      <p class="Paragraph"><help:paragraphinfo state="U" number="78"/>Disables the error report tool.</p>
  126.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  127.      <p class="PropText"><help:paragraphinfo state="U" number="20"/>-norestore</p>
  128.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  129.      <p class="Paragraph"><help:paragraphinfo state="U" number="21"/>Disables restart and file recovery after a system crash.</p>
  130.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  131.      <p class="PropText"><help:paragraphinfo state="U" number="25"/>-quickstart</p>
  132.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  133.      <p class="Paragraph"><help:paragraphinfo state="U" number="26"/>Activates the Quickstarter. <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>The splash screen is not displayed. <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/></p>
  134.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  135.      <p class="PropText"><help:paragraphinfo state="U" number="27"/>-terminate_after_init</p>
  136.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  137.      <p class="Paragraph"><help:paragraphinfo state="U" number="28"/>Registers some UNO services and ends. The splash screen does not appear. </p>
  138.      <p class="Paragraph"><help:paragraphinfo state="U" number="29"/>More information is found in the <span style="font-weight:bold;"><help:productname>%PRODUCTNAME</help:productname> Developer's Guide</span>.</p>
  139.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  140.      <p class="PropText"><help:paragraphinfo state="U" number="30"/>-accept={UNO string}</p>
  141.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  142.      <p class="Paragraph"><help:paragraphinfo state="U" number="31"/>Notifies the <help:productname>%PRODUCTNAME</help:productname> software that upon the creation of "UNO Acceptor Threads", an "UNO Accept String" will be used.</p>
  143.      <p class="Paragraph"><help:paragraphinfo state="U" number="32"/>More information is found in the <span style="font-weight:bold;"><help:productname>%PRODUCTNAME</help:productname> Developer's Guide</span>.</p>
  144.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  145.      <p class="PropText"><help:paragraphinfo state="U" number="33"/>-userid={user id}</p>
  146.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  147.      <p class="Paragraph"><help:paragraphinfo state="U" number="34"/>Specifies a user's directory that is used instead of the data from the <span style="font-weight:bold;">soffice.ini</span>, <span style="font-weight:bold;">bootstrap.ini</span> and <span style="font-weight:bold;">sversion.ini</span> files.</p>
  148.      <p class="Paragraph"><help:paragraphinfo state="U" number="35"/>More information is found in the <span style="font-weight:bold;"><help:productname>%PRODUCTNAME</help:productname> Developer's Guide</span>.</p>
  149.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  150.      <p class="PropText"><help:paragraphinfo state="U" number="36"/>-p {filename1} {filename2} ...</p>
  151.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  152.      <p class="Paragraph"><help:paragraphinfo state="U" number="37"/>Prints the files <span style="font-weight:bold;">{filename1} {filename2} ...</span> to the default printer and ends. <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>The splash screen does not appear.</p>
  153.      <p class="Paragraph"><help:paragraphinfo state="U" number="49"/>If the file name contains spaces, then it must be enclosed in quotation marks. (for example, "C:\My┬áFile.sxw")</p>
  154.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  155.      <p class="PropText"><help:paragraphinfo state="U" number="38"/>-pt {Printername} {filename1} {filename2} ...</p>
  156.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  157.      <p class="Paragraph"><help:paragraphinfo state="U" number="50"/>Prints the files <span style="font-weight:bold;">{filename1} {filename2} ...</span> to the printer <span style="font-weight:bold;">{Printername}</span> and ends. <text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>The splash screen does not appear.</p>
  158.      <p class="Paragraph"><help:paragraphinfo state="U" number="51"/>If the file name contains spaces, then it must be enclosed in quotation marks. (for example, "C:\My┬áFile.sxw")</p>
  159.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  160.      <p class="PropText"><help:paragraphinfo state="U" number="39"/>-o {filename}</p>
  161.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  162.      <p class="Paragraph"><help:paragraphinfo state="U" number="40"/>Opens <span style="font-weight:bold;">{filename}</span> for editing, even if it is a template.</p>
  163.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  164.      <p class="PropText"><help:paragraphinfo state="U" number="54"/>-view {filename}</p>
  165.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  166.      <p class="Paragraph"><help:paragraphinfo state="U" number="55"/>Creates a temporary copy of <span style="font-weight:bold;">{filename}</span> and opens it read-only.</p>
  167.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  168.      <p class="PropText"><help:paragraphinfo state="U" number="41"/>-n {filename}</p>
  169.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  170.      <p class="Paragraph"><help:paragraphinfo state="U" number="42"/>Creates a new document using <span style="font-weight:bold;">{filename}</span> as a template.</p>
  171.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  172.      <p class="PropText"><help:paragraphinfo state="U" number="43"/>-nologo</p>
  173.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  174.      <p class="Paragraph"><help:paragraphinfo state="U" number="44"/>Disables the splash screen at program start.</p>
  175.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  176.      <p class="PropText"><help:paragraphinfo state="U" number="75"/>-nodefault</p>
  177.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  178.      <p class="Paragraph"><help:paragraphinfo state="U" number="76"/>Opens the <help:link Id="65814">backing window</help:link>. The backing window opens also when you call the program file directly without any start parameter.</p>
  179.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  180.      <p class="PropText"><help:paragraphinfo state="U" number="45"/>-display {display}</p>
  181.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  182.      <p class="Paragraph"><help:paragraphinfo state="U" number="46"/>Sets the <span style="font-weight:bold;">DISPLAY </span>environment variable on UNIX based platforms to the value <span style="font-weight:bold;">{display}</span>. This parameter is only supported by the start script for the <help:productname>%PRODUCTNAME</help:productname> software on UNIX based platforms.</p>
  183.     </span></td></tr><tr class=""><td class="Tabelle1A2" style="text-align:left;"><span class="Tabelle1A">
  184.      <p class="PropText"><help:paragraphinfo state="U" number="56"/>-headless</p>
  185.     </span></td><td class="Tabelle1B2" style="text-align:left;"><span class="Tabelle1B">
  186.      <p class="Paragraph"><help:paragraphinfo state="U" number="57"/>Starts in "headless mode" which allows using the application without user interface.</p>
  187.      <p class="Paragraph"><help:paragraphinfo state="U" number="58"/>This special mode can be used when the application is controlled by external clients via the <a href="http://api.openoffice.org" class="ContentLink">API</a>.</p>
  188.     </span></td></tr></table>
  189.   <help:paragraphinfo state="E"/></help:to-be-embedded>
  190.  </body></html>