Differences

This shows you the differences between two versions of the page.

--- util:asc2ans [2010/03/08 00:43] – digitalman
+++ util:asc2ans [2023/12/29 02:05] (current) – The outfile.ans argument is optional (outputs to stdout if not supplied). digital man
@@ Line 1: / Line 1: @@
 ====== ASC2ANS ======
-FIXME
+Converts a Synchronet ASCII text file encoded with [[custom:Ctrl-A codes]] (e.g. ''*.msg'' or ''*.asc'' file) to the equivalent [[ref:ANSI]] terminal escape sequences.
+This utility allows you to convert files that use Ctrl-A codes (attributes) into ANSI files suitable for viewing or editing with a [[resource:ANSI Editors]] (the opposite function of the [[ANS2ASC]] utility).
+The syntax is:
+  asc2ans infile.asc [outfile.ans] [options]
+^ Option ^ Description ^
+| -strip | strip Ctrl-A codes without [[ref:ANSI]] equivalent, e.g. pause, delay |
+The suffix/extension for the input filename will most likely be ''.asc'' or ''.msg'' and the output file should have a ''.ans'' extension.
+If an ''[outfile.ans]'' argument is not provided, the converted ANSI output is sent to ''stdout''.
 ===== See Also =====
   * [[:util:|Utilities]]
+  * [[:util:ANS2ASC]]
+  * [[:resource:ANSI Editors]]
 {{tag>ansi}}