github
/
argtable3
mirror of https://github.com/argtable/argtable3.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
27 Commits
1 Branch
13 Tags
966 KiB
 
 
 
 
 
 
Tree: 86f3e7afc4
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '86f3e7afc4'
${ noResults }
Tom G. Huang 86f3e7afc4
fix(gitignore): Make .gitignore an exception 		7 years ago
examples CMake build script added 8 years ago
tests CMake build script added 8 years ago
.gitignore fix(gitignore): Make .gitignore an exception 7 years ago
.travis.yml chord(proj): Add makefiles in root folder for Travis CI 7 years ago
CMakeLists.txt CMake build script added 8 years ago
LICENSE Task #2: Import the first official distribution 11 years ago
Makefile chord(proj): Add makefiles in root folder for Travis CI 7 years ago
Makefile.nmake chord(proj): Add makefiles in root folder for Travis CI 7 years ago
README.md Update README.md 7 years ago
argtable3.c fix(argtable3): Visual C++ x64 compiler warning 7 years ago
argtable3.h Task #2: Import the first official distribution 11 years ago

README.md

Introduction of Argtable3

Argtable3 is an open source ANSI C library that parses GNU-style command-line options. It simplifies command-line parsing by defining a declarative-style API that you can use to specify what your command-line syntax looks like. Argtable3 will automatically generate consistent error handling logic and textual descriptions of the command line syntax, which are essential but tedious to implement for a robust CLI program.

Quick Start

Argtable3 is a single-file ANSI-C library. All you have to do is adding argtable3.c to your projects, and including argtable3.h in your source code.

Documentation and Examples

To learn how to use the Argtable3 API, you can see the documentation on the web site, or examples in the examples folder.

To build the examples, open the console window of your favorite development environments, go to the examples folder, and use the included Makefiles to build the examples.

If you use GCC (Linux, MinGW, Cygwin), type:

$ make

If you use Microsoft Visual C++ compiler, type:

$ nmake /f Makefile.nmake

To cleanup, type make cleanall or nmake /f Makefile.nmake cleanall.

Unit Tests

Argtable3 is a BSD-licensed open source library, so you can modify the library anyway you want. However, before committing your code to your own repository or the Argtable3 official repository, please make sure your changes can pass the unit tests included in the distribution.

To build and run the unit tests, open the console window of your favorite development environments, go to the tests folder, and use the included Makefiles to build and run the unit tests.

If you use GCC (Linux, MinGW, Cygwin), type:

$ make

If you use Microsoft Visual C++ compiler, type:

$ nmake /f Makefile.nmake

To cleanup, type make cleanall or nmake /f Makefile.nmake cleanall.

Authors

Argtable is Copyright (C) 1998-2001,2003-2011 Stewart Heitmann. Parts are Copyright (C) 1989-1994, 1996-1999, 2001, 2003 Free Software Foundation, Inc.

Argtable was written by Stewart Heitmann sheitmann@users.sourceforge.net

Argtable is now maintained by Tom G. Huang tomghuang@gmail.com The project homepage of argtable 3.x is http://www.argtable.org The project homepage of argtable 2.x is http://argtable.sourceforge.net/

Here is a list of contributors who have helped to improve argtable:

  • Nina Clemson: Editing the original argtable-1.0 documentation.
  • Livio Bertacco: For bug fixes and the argtable-2.x Visual C++ Makefiles.
  • Justin Dearing: For bug fixes and Windows DLL support, plus code support for the Open Watcom compiler and help with the Mac OS X configuration.
  • Asa Packer: Contributing bug fixes and upgrades to the Visual C++ Makefiles.
  • Danilo Cicerone: For the Italian translation of "Introduction to Argtable-2x" on http://www.digitazero.org.
  • Uli Fouquet: For configuration patches and documentation related to cross-compiling argtable from Unix to Windows, as well as providing the arg_print_glossary_gnu function.
  • Shachar Shemesh: For Debian package integration and kick-starting the migration to automake/autoconf.
  • Jasper Lievisse Adriaanse: Maintaining the argtable package in OpenBSD ports.
  • Ulrich Mohr: For bug fixes relating to Texas Instrument DSP platforms.
  • John Vickers: For bug fixes relating to Solaris/Motorola platforms.
  • Steve O'Neil: For bug fixes relating to Solaris/Motorola platforms.
  • Lori A. Pritchett-Sheats: Fixing a makefile bug relating to "make dist".
  • Paolo Bormida: For instructions on building argtable with date and regex support on Windows.
  • Michel Valin: For bug fixes relating to the configure scripts on IBM AIX platforms and instructions on compiling the example code under AIX.
  • Steve Christensen: Providing prebuilt packages for SPARC/Solaris and x86/Solaris platforms on www.sunfreeware.com.
  • Jess Portnoy: Reworking the rpm package and integrating argtable into Fedora Linux.
  • Michael Brown: Incorporating support for pkg-config into the autoconf scripts.
  • Alexander Lindert: For extensions to the parser to support hex, octal and binary integer formats as well as KB/MB/GB suffixes.
  • Rob Zaborowski: Providing build configuration files for CMake.
  • Moczik Gabor: For bug fixes relating to the parsing of filepaths and filename extensions.