Merge branch 'master' into pm-utils-1.2pm-utils-1.2.2

1 files changed, 79 insertions, 5 deletions

diff --git a/man/pm-action.xml b/man/pm-action.xml
index 2d5bcd5..964676f 100644
--- a/man/pm-action.xml
+++ b/man/pm-action.xml
@@ -170,12 +170,27 @@
       <command>pm-suspend-hybrid</command> commands you can select which
       quirks should be used.
     </para>
-
+    <para>
+	    If <command>pm-suspend</command>, <command>pm-hibernate</command>,
+	    or <command>pm-suspend-hybrid</command> is invoked without any
+	    commandline parameters, they will try to grab the correct quirks
+	    from HAL if it is installed.
+    </para>
     <variablelist>
       <!-- Use the variablelist.term.separator and the
 	   variablelist.term.break.after parameters to
 	   control the term elements. -->
       <varlistentry>
+	<term><option>--auto-quirks</option></term>
+	<listitem>
+          <para>
+            This option will try to grab the correct quirks for this system
+	    from HAL.  If HAL is not present on the system and this parameter
+	    is passed, suspending or hibernating the system will fail.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
 	<term><option>--quirk-dpms-on</option></term>
 	<listitem>
           <para>
@@ -278,6 +293,23 @@
           </para>
         </listitem>
       </varlistentry>
+       <varlistentry>
+        <term><option>--store-quirks-as-fdi</option></term>
+        <listitem>
+          <para>
+		  Save the quirks passed to <command>pm-suspend</command> or 
+		  <command>pm-suspend-hybrid</command> as an .fdi file that 
+		  is specific to this system.  The file will be saved in 
+		  <filename>/etc/hal/fdi/information/99local-pm-utils-quirks.fdi</filename>.
+		  This parameter will only save the actual quirks that were 
+		  used to sucessfully suspend/resume a system -- if you are 
+		  running proprietary video drivers or kernel modesetting 
+		  video drivers, you will generate a potentially incorrect 
+		  .fdi file.
+          </para>
+        </listitem>
+      </varlistentry>
+
     </variablelist>
   </refsect1>
 
@@ -317,9 +349,9 @@
 	    directory by putting a non-executable file in 
 	    /etc/pm/sleep.d, or by adding it to the HOOK_BLACKLIST 
 	    configuration variable.
-	  </para>
-	</listitem>
-      </varlistentry>
+         </para>
+       </listitem>
+     </varlistentry>
       <varlistentry>
 	<term><filename>/var/log/pm-suspend.log</filename></term>
 	<listitem>
@@ -330,6 +362,47 @@
 	</listitem>
       </varlistentry>
     </variablelist>
+    </refsect1>
+    <refsect1 id="sleep_hook_ordering_convention">
+       <title>SLEEP HOOK ORDERING CONVENTION</title>
+       <variablelist>
+         <varlistentry>
+	   <term>00 - 49</term>
+	   <listitem>
+	     <para>User and most package supplied hooks.  If a hook assumes 
+		     that all of the usual services and userspace 
+		      infrastructure is still running, it should be here.
+	     </para>
+	   </listitem>
+	 </varlistentry>
+	 <varlistentry>
+	   <term>50 - 74</term>
+	   <listitem>
+	     <para> Service handling hooks.  Hooks that start or stop a 
+			 service belong in this range. At or before 50, hooks 
+			 can assume that all services are still enabled.
+             </para>
+            </listitem>
+	   </varlistentry>
+	       <varlistentry>
+	         <term>75 - 89</term>
+		 <listitem>
+		   <para> Module and non-core hardware handling.  If a hook 
+			 needs to load/unload a module, or if it needs to 
+			 place non-video hardware that would otherwise break 
+			 suspend or hibernate into a safe state, it belongs in 
+			 this range. At or before 75, hooks can assume all 
+			 modules are still loaded.
+ 	           </para>
+                 </listitem>
+	       </varlistentry>
+	       <varlistentry>
+	         <term>90 - 99</term>
+		 <listitem>
+		   <para> Reserved for critical suspend hooks. </para>
+	         </listitem>
+               </varlistentry>
+             </variablelist>
   </refsect1>
 
   <refsect1 id="config_vars">
@@ -351,7 +424,8 @@
                 <listitem>
                   <para>
                     The built-in kernel suspend/resume support.
-                    Use this if nothing else is supported on your system.
+		    Use this if nothing else is supported on your system.
+		    The kernel backend is always used if nothing else is available.
                 </para>
                 </listitem>
               </varlistentry>