Add example description and purpose

Author: serge1

examples/arion/arion.cpp

@@ -20,20 +20,43 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 */
 
+//------------------------------------------------------------------------------
+// arion.cpp
+//
+// This example demonstrates how to use the ARIO library to inspect and list the
+// contents of a UNIX archive (.ar) file. It provides a simple command-line tool
+// that displays information about each member of the archive, including its name,
+// size, file mode, and any associated symbols.
+//
+// Purpose:
+//   - Showcase ARIO’s API for reading and iterating over archive members.
+//   - Provide a minimal example for archive inspection and symbol listing.
+//
+// Abilities:
+//   - Loads and parses a specified archive file.
+//   - Lists all members with their names, sizes, and file modes.
+//   - Displays symbols associated with each member, if available.
+//   - Command-line interface: Accepts the archive file name as an argument.
+//
+// This example serves as a reference for basic ARIO usage and as a foundation
+// for building custom archive inspection tools.
+//------------------------------------------------------------------------------
+
+#include <iostream>
 #include <ario/ario.hpp>
 
 using namespace ARIO;
 
 int main( int argc, char** argv )
 {
     if ( argc != 2 ) {
-        printf( "Usage: arion <file_name>\n" );
+        std::cout << "Usage: arion <file_name>" << std::endl;
         return 1;
     }
 
     ario archive;
 
-    auto result = archive.load( argv[1] );
+    const auto result = archive.load( argv[1] );
     if ( !result.ok() ) {
         std::cerr << "Error loading archive: " << result.what() << std::endl;
         return 1;

examples/arioso/arioso.cpp

@@ -1,4 +1,46 @@
-// This example demonstrates how to use the ARIO library to read and manipulate UNIX archive files.
+/*
+Copyright (C) 2025-present by Serge Lamikhov-Center
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+
+//------------------------------------------------------------------------------
+// arioso.cpp
+//
+// This example demonstrates how to use the ARIO library (with optional ELFIO integration)
+// to manage UNIX archive (.ar) files from the command line. It provides a practical tool
+// for extracting, deleting, and adding files to an archive, similar to the standard 'ar' utility.
+//
+// Purpose:
+//   - Showcase ARIO’s API for reading, modifying, and writing UNIX archive files.
+//   - Illustrate integration with ELFIO for symbol extraction from ELF object files.
+//
+// Abilities:
+//   - Extraction: Extracts specified files from the archive to the current directory.
+//   - Deletion: Removes specified files from the archive.
+//   - Addition: Adds new files to the archive, collecting and storing global symbols if the file is an ELF object.
+//   - Archive update: Safely writes changes to the archive using a temporary file for atomic updates.
+//   - Command-line interface: Accepts commands in the form:
+//         arioso <archive> [-e <files...>] [-d <files...>] [-a <files...>]
+//
+// This example serves as both a reference for ARIO/ELFIO usage and a foundation for building custom archive management tools.
+//
 
 #include <iostream>
 #include <vector>