[Po4a-commits] "po-debconf/doc/en podebconf-report-po.1.pod, 1.28, 1.29"

[Nicolas FRANCOIS]

Update of /cvsroot/po4a/po-debconf/doc/en
In directory alioth:/tmp/cvs-serv32757/doc/en

Modified Files:
	podebconf-report-po.1.pod 
Log Message:
  * Automatically detect if a debconf or non-debconf template should be used.
    The --notdebconf option is still useful when the user wants to send a call
    for the debconf translations and for the program translation from the
    package's root directory.


Index: podebconf-report-po.1.pod
===================================================================
RCS file: /cvsroot/po4a/po-debconf/doc/en/podebconf-report-po.1.pod,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -d -r1.28 -r1.29
--- podebconf-report-po.1.pod	9 May 2008 21:58:42 -0000	1.28
+++ podebconf-report-po.1.pod	9 May 2008 23:59:14 -0000	1.29
@@ -15,8 +15,8 @@
 and sends them to the last translator requesting updates.  The mail will
 contain the PO file which has to be updated.  B<podebconf-report-po> can
 be called either in the top-level directory, or in F<debian> or
-F<debian/po> subdirectories (or, when the B<--notdebconf> option is used,
-from the B<po> directory itself or its parent directory).
+F<debian/po> subdirectories (or, for non debconf translations, from the
+B<po> directory itself or its parent directory).
 
 B<podebconf-report-po> can also be used to send a call for translations to a
 mailing list.  In that case, the POT file will be attached.
@@ -206,6 +206,13 @@
 B<podebconf-report-po> (i.e. the B<--podir> option is not needed when the
 call is done from the F<po> directory itself or from its parent directory).
 
+By default, a F<debian/po> directory is preferred over a F<po> directory.
+With this option, only the F<po> directory will be considered.
+
+This option is usually not necessary. B<podebconf-report-po> tries to
+determine the type of translation based on the current directory and the
+existence of a F<debian/po> or F<po> directory.
+
 =item B<--package=I<PACKAGE>>
 
 Specify the name of the package (default is the source package name).
@@ -213,9 +220,9 @@
 =item B<--podir=I<DIR>>
 
 Specify where the PO files are located.
-By default, B<podebconf-report-po> searches for a F<debian/po> directory
-in F<../..>, F<..>, or F<.>. If the B<--notdebconf> is used, it will
-search for a F<po> directory in F<..>, or F<.>.
+By default, B<podebconf-report-po> checks if it is called from a F<po>
+directory, or it searches for a F<debian/po> directory (this can be disabled
+with the B<--notdebconf> option), or for a F<po> directory.
 
 =item B<--postpone=I<MBOX>>
 
@@ -446,30 +453,31 @@
 
 =head1 EXAMPLES
 
-=item B<debconf templates>
+The recommended usage is to call B<podebconf-report-po> from the F<po>
+directory to be updated:
 
 podebconf-report-po --call
 
-This must be called from the package root directory (or from the F<debian>,
-or from the F<debian/po> directories)
-
-=item B<program translations>
-
-podebconf-report-po --call --notdebconf
-
-This must be called from the parent of the F<po/> directory (or from the
-F<po> directory itself)
-
-=back
-
-In both cases, this will send a call for new translations to the
+This will send a call for new translations to the
 <debian-i18n at lists.debian.org> mailing list and will ask translation
 updates to the previous translators. The language teams will also be
 notified and should be able to react if the assigned translator is known
 to be MIA.
 
-The messages will request updates to be sent within 10 days. You should
-make a new release after that deadline.
+A prompt will ask a deadline to the user (the default is to request
+translations and updates within 10 days).
+
+Then an editor will display the message to be sent to the mailing list.
+When this editor exits, B<podebconf-report-po> will ask confirmation
+to send the mail to the mailing list.
+
+If confirmed, another editor will display the message to be sent to the
+translators and language teams. 
+B<podebconf-report-po> will ask for another confirmation to send the mails
+to translators and language teams.
+
+You should make a new release with the received translations after the
+deadline.
 
 =head1 SEE ALSO