From 78600d89c89dbdbb0ff0ef31e04feacedb1b5589 Mon Sep 17 00:00:00 2001
From: Moritz Bunkus <moritz@bunkus.org>
Date: Thu, 11 Nov 2010 22:33:07 +0100
Subject: [PATCH] Dokumentation

---
 SL/DB/Invoice.pm |  5 ++++-
 SL/DB/Order.pm   | 14 +++++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/SL/DB/Invoice.pm b/SL/DB/Invoice.pm
index 6e0cf60a1..e9c04ed92 100644
--- a/SL/DB/Invoice.pm
+++ b/SL/DB/Invoice.pm
@@ -273,7 +273,10 @@ Lx-Office is not configured to use Einnahmenüberschussrechnungen
 
 =back
 
-Returns C<$self> on success and C<undef> on failure.
+Returns C<$self> on success and C<undef> on failure. The whole process
+is run inside a transaction. If it fails then nothing is saved to or
+changed in the database. A new transaction is only started if none is
+active.
 
 =item C<basic_info $field>
 
diff --git a/SL/DB/Order.pm b/SL/DB/Order.pm
index 25c37880f..74f713ca0 100644
--- a/SL/DB/Order.pm
+++ b/SL/DB/Order.pm
@@ -155,10 +155,22 @@ C<$paras{ar_id}>. If set it must be the ID of the accounts receivables
 chart to post to. If it is not set then the first chart configured for
 accounts receivables is used.
 
-Returns the new invoice instance on success and C<undef> on failure.
+Returns the new invoice instance on success and C<undef> on
+failure. The whole process is run inside a transaction. On failure
+nothing is created or changed in the database.
 
 At the moment only sales quotations and sales orders can be converted.
 
+=item C<create_sales_process>
+
+Creates and saves a new sales process. Can only be called for sales
+orders.
+
+The newly created process will be linked bidirectionally to both
+C<$self> and to all sales quotations that are linked to C<$self>.
+
+Returns the newly created process instance.
+
 =back
 
 =head1 BUGS
-- 
2.20.1