\input texinfo   @c -*-texinfo-*-
@c %**start of header
@c Part 1: Header
@c --------------
@c The header does not appear in either the Info file or the printed
@c output.  It sets various parameters, including the name of the Info
@c file and the title used in the header.
@setfilename ansicmd.info
@settitle Application Interface to ANSI Escape Sequences
@documentlanguage en_US
@documentencoding UTF-8
@paragraphindent 0
@dircategory Individual utilities
@direntry
* AnsiCmd library.              Application interface to ANSI escape sequeces
@end direntry
@c %**end of header

@c Prevent so-called standard-typography double-spacing after end-of-sentence.
@c Double-space-at-end-of-sentence was standard in the age of manual 
@c typewriters, but we're 30 years beyond that now.
@frenchspacing on

@c ---------------------------------------------------------
@c Define macros for often-used or occasionaly-updated text.
@c ---------------------------------------------------------
@c (copyright years)
@macro CRYEARS
2022-2026
@end macro
@c (AnsiCmd class version)
@macro ACVERSION
0.0.07
@end macro
@c (AcEdit Application Version)
@macro ACEVERSION
0.0.05
@end macro

@c General macro definitions
@c -------------------------
@include texi_macros.texi
@c Experimental macro with less vertical space.
@macro hr20s
@ifnothtml
@center @t{──────────}
@end ifnothtml
@ifhtml
@html
<div style="width:20%; margin:0 auto"><hr></div>
@end html
@end ifhtml
@end macro

@c Part 2: Summary Description and Copyright
@c -----------------------------------------
@c *Note GNU Sample Texts::. for more information.
@copying

@smalldisplay
@group
 Copyright @copyright{} @CRYEARS

 Mahlon R. Smith, The Software Samurai

 This manual describes @b{version @ACVERSION} of the AnsiCmd library.

  Permission is granted to copy, distribute and/or modify this document
  under the terms of the GNU Free Documentation License, Version 1.3
  or any later version published by the Free Software Foundation;
  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
  Texts.  A copy of the license is included in the section entitled@ 
  "GNU Free Documentation License".
@sp 2
@end group
@end smalldisplay

@end copying

@c Part 3: Titlepage, Contents, Copyright
@c --------------------------------------
@c The titlepage segment does not appear in the online output, only in the
@c printed manual.  We use the `@insertcopying' command to include the
@c permission text from the previous section, instead of writing it out
@c again; it is output on the back of the title page.  The `@contents'
@c command generates a table of contents.
@titlepage
@title AnsiCmd Class Link Library

@c The following two commands start the copyright page.
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@c Output the table of contents at the beginning.
@contents

@c Top Node and Master Menu
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@ifnottex
@node Top
@top AnsiCmd Class Link Library

@insertcopying

@w{@t{      } The AnsiCmd library provides a simple, organized mechanism}@*
@w{@t{      } for controlling the setup of many terminal window functions}@*
@w{@t{      } and display options using ANSI escape sequences and basic}@*
@w{@t{      } terminal configuration utilities.}

@end ifnottex

@menu
* Introduction::                 What is the AnsiCmd library?
* Invoking::                     Command-line arguments and options
* AnsiCmd Library::              Description of primary methods and data
* ACWin Class::                  Structured high-level user interface
* Development and Testing::      Structure of test methods and menus
* Building from Source::         Compile the library
* gString Text Tool::            Text Internationalization and formatting tool
* CsvView Demo App::             View CSV files (AnsiCmd basic functionality)
* AcEdit Demo App::              Simple text editor (AnsiCmd API functionality)
* TFMTest Demo App::             Exercise the TFMan class (Temp File Manager)
* Technical Support::            Make suggestions, report problems.
* Copyright Notice::             Boring, but useful.
* Index::
@end menu

@sp 4

@c Introduction  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_01_introduction.texi

@c Invoking  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_02_invoking.texi

@c AnsiCmd Library - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_03_library.texi

@c ACWin Class - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_04_window.texi

@c Development and Testing - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_05_testing.texi

@c Building From Source  - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_06_buildsource.texi

@c gString Text Tool:  - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c This definition disables external xrefs in the gString chapter.
@c External xrefs are used only when the chapter is integrated 
@c into the NcDialogAPI documentation.
@set GSTRING_STANDALONE
@include AnsiCmd_07_gStringTextTool.texi

@c WaylandCB Clipboard Access: - - - - - - - - - - - - - - - - - - - - - - - - -
@c This definition disables external xrefs in the WaylandCB chapter.
@c External xrefs are used only when the chapter is integrated 
@c into the NcDialogAPI documentation.
@c @set WAYLANDCB_STANDALONE
@c @include Ch06w_WaylandCB.texi

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c 08.0.00 CsvView Demo App: - - - - - - - - - - - - - - - - - - - - - - - - - -
@c                           - - - - - - - - - - - - - - - - - - - - - - - - - -
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_08_CsvView.texi

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c 09.0.00 AcEdit Demo App:  - - - - - - - - - - - - - - - - - - - - - - - - - -
@c                           - - - - - - - - - - - - - - - - - - - - - - - - - -
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_09_AcEdit.texi

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c 10.0.00 TFMTest Demo App: - - - - - - - - - - - - - - - - - - - - - - - - - -
@c                           - - - - - - - - - - - - - - - - - - - - - - - - - -
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@include AnsiCmd_10_TFMTest.texi

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c 11.0.00 Technical Support:  - - - - - - - - - - - - - - - - - - - - - - - - -
@c         Make suggestions, report problems   - - - - - - - - - - - - - - - - -
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@node Technical Support
@unnumbered Technical Support
@cindex 11.0.00 Technical Support
@cindex technical support
@cindex support, technical

@display
Please Note: All trademarks and service marks mentioned in this
document are the entirely-too-proprietary property of their
respective owners, and this author makes no representation of
affiliation with or ownership of any of the damned things.
@end display

@cindex contact info
@section Contact

@display
AnsiCmd-class library, test applications, source code and associated 
Texinfo documentation were written and are maintained by:

                         Mahlon R. Smith,
                      The Software Samurai
                 Beijing University of Technology
                 on the web at: @SAMADDRESS 

For bugs, suggestions, periodic updates, or possible praise, 
please post a message to the author via website.

The author wishes to thank everyone for their intelligent, kind
and thoughtful responses.  (ranters I can live without)
@end display
@spi

@anchor{By the Same Author}
@section By the Same Author

@include same_author.texi

@sp 2

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c 12.0.00 Copyright Notice:   - - - - - - - - - - - - - - - - - - - - - - - - -
@c         Boring, but useful  - - - - - - - - - - - - - - - - - - - - - - - - -
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@node Copyright Notice
@unnumbered Copyright Notice
@cindex 12.0.00 Copyright Notice

@format
The AnsiCmd library and source code are released under
the GNU General Public License (GPL 3+), and
the user documentation (this document) is released under
the GNU Free Documentation License (FDL 1.3+):
@end format
@sp 1

@c (contains a 'display' block)
@insertcopying

@menu
* GNU General Public License::
* GNU Free Documentation License::
@end menu

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@lowersections
@node GNU General Public License
@unnumbered GNU General Public License
@cindex 12.1.00 GNU General Public License

@include gpl-3.0.texi

@node GNU Free Documentation License
@unnumbered GNU Free Documentation License
@cindex 12.2.00 GNU Free Documentation License

@include fdl-1.3.texi

@raisesections

@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c Index     - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@node Index
@unnumbered Index

@printindex cp

@sp 2

@bye