Skip to content
Browse files

recode.texi: Add notes on the exit status.

Reported by Dan Jacobson
  • Loading branch information...
1 parent c85310e commit c025f1c5aa1d56c14ca40a22e15912b1abf13caf @pinard committed Mar 3, 2011
Showing with 24 additions and 0 deletions.
  1. +24 −0 doc/recode.texi
View
24 doc/recode.texi
@@ -626,6 +626,30 @@ recode -d l1..tex <datum.txt >datum.tex
This example also shows that @code{l1} could be used instead of
@code{Latin-1}; charset names often have such aliases.
+@cindex exit status
+@cindex status code
+Recode has three modes are for when to set the exit status to non-zero:
+
+@itemize @bullet
+@item
+The most lenient setting is activated with option @samp{-f}, in which
+case only system errors or library mis-usage causes the exit status to
+be set.
+
+@item
+By default, without @samp{-f} nor @samp{-s}, Recode sets the exit
+status as above, and also in case of invalid or untranslatable input.
+It also tries (but not always succeed) to detect if output is going to
+be ambiguous at some later recode-back time.
+
+@item
+The stricter setting is activated with @samp{-s}, Recode then sets the
+exit status as above, or if input is not canonically coded (and it also
+prevents itself from *completing* recoding tables for making the
+recoding reversible).
+
+@end itemize
+
@node Requests, Listings, Synopsis, Invoking recode
@section The @var{request} parameter

0 comments on commit c025f1c

Please sign in to comment.
Something went wrong with that request. Please try again.