Changeset 368 for trunk/doc

Timestamp:

Dec 4, 2009 5:05:00 PM (16 years ago)

Author:

toby

Message:

# on 2000/12/22 21:14:32, toby did:
expand archive documentation to explain how to get files out
document Iconify option
document that Autoload now for Windows
document conflict between Use DISAGL Window & lstview

File:

• trunk/doc/expguic.html (modified) (3 diffs, 3 props)

trunk/doc/expguic.html ¶

@@ -59 +59 @@
 This menu contains options that determine how EXPGUI runs.
 <DL>
+<a name="archive"></a>
 <DT>archive EXP<DD>Toggles archiving of .EXP files. When on, files are 
-        saved prior to each save or run of expedt in a file named 
-        [expnam].EXP.xxx.gz where xxx = 000, 001 (UNIX) 
-        or in a file named [expnam].ZIP or  [expnam].xxx (Windows)
+        saved prior to each save or run of EXPEDT.
+        Each time a file is saved a note is placed in the .LST file
+        so that the saved file name can be associated with 
+        the refinement stage.
+<P>
+<B>UNIX:</B> Old .EXP files are saved in a compressed file named
+[expnam].EXP.xxx.gz where xxx = 000, 001..., if the the gzip
+program can be run by EXPGUI, or in an uncompressed file named 
+[expnam].EXP.xxx if gzip is not available.
+To recover an archived file, uncompress it with command
+<tt>gzip [expnam].EXP.xxx.gz</tt> (if needed) and rename it
+to end in .EXP (<tt>mv [expnam].EXP.xxx [new expnam].EXP</tt>).
+It can then be read using EXPGUI
+<P>
+<B>Windows:</B> Old .EXP files are saved in a compressed form in 
+a file named [expnam].ZIP, if program PKZIP.EXE is found in the
+same directory where EXPGUI is installed (typically c:\gsas\expgui). 
+To read the archived files, you will
+need to use PKZIP or WINZIP to extract and rename them.
+If PKZIP is not installed, the files are archived by 
+renaming them [expnam]!xxx.EXP. These archived files can be read
+directly by EXPGUI, but you are suggested to save them under
+a new name using the File/"Save As" option.
+<P>
 <DT>Use DISAGL Window<DD>When this option is set, results from DISAGL are 
          shown in a separate window. When it is not set, the results are
-        written in the .LST file.
+        written in the .LST file. Note that on Windows, LSTVIEW can interfere
+        with putting output into the DISAGL window. The solution is to 
+        close LSTVIEW before running DISAGL.
+
+<a name="Autoupdate"></a>
+<DT>Autoload EXP<DD>Normally EXPGUI prompts before rereading the EXP 
+file when GENLES, POWPREF,... or other GSAS programs run 
+If this option is set, the new file is automatically read without a prompt. 
+The advantage of leaving this option off, is that 
+you can opt to not load the
+revised .EXP file, which means that you reject the last set of changes.
+This is useful if 
+GENLES blows up or you have done something wrong. The advantage 
+of turning "autoload EXP" on is
+that there is one less thing to do when running GSAS programs.
+Note that it is still possible to reverse changes, if 
+<a href="#archive">archive mode</A> is on, but this may require more effort.
+
+<a name="Autoicon"></a>
+<DT>Iconify during GSAS<DD>
+If this option is turned on, the main EXPGUI window is shrunk to an icon
+(minimized) while GSAS programs are running and EXPGUI is suspended. 
+The author prefers this mode, since there is no reason to have the 
+screen cluttered with EXPGUI when it can't be used, 
+but this is an option so that the mode can be turned off by those people
+who find this behavior annoying.
+
 <a name="sortatoms"></a>
 <DT>Sort atoms by<DD>   Determines the order that atoms are displayed on the "Phase" pane
@@ -99 +147 @@
         character. If backspace does not work in a program such as 
         EXPEDT, change try the other setting for this option.
-<a name="Autoupdate"></a>
-<DT>Autoupdate EXP<DD>Normally EXPGUI prompts before rereading the EXP 
-file when GENLES, POWPREF,... are run (this is so that one can change
-the experiment file and rerun with the current input). If this option is
-set, the new file is automatically read without a prompt. 
-This option is not available in Windows.
 
 <a name="exptoolout"></a>
@@ -115 +157 @@
 <DT>SaveOptions<DD>Save the current values for "Override backspace", 
         <a href="#sortatoms">"Sort atoms by"</a>, 
-        <a href="#sorthist">"Sort histograms by"</a> and "archive EXP"
+        <a href="#sorthist">"Sort histograms by"</a>, 
+        <a href="#archive">"archive EXP"</a>,
+        <a href="#Autoupdate">"Autoload EXP"</a>,
+        and
+        <a href="#Autoicon">"Iconify during GSAS"</a>
+        
         in file ~/.gsas_config (c:\.gsas_config on Windows).
 <DT>liveplot_options<DD>Used to set options for liveplot,