dot.conf

Latest News

• 2003-06-26
  v1.0.13 has been released. Grab it here.
  

    ChangeLog excerpt for this release:
  
      - James Cassidy sent in a little patch to add a 'pkg-config' file
      - Bastian Kleineidam sent in a patch for better support of 64bit architectures
  
         

• 2003-02-22
  v1.0.12 has been released. Grab it here.
  

    ChangeLog excerpt for this release:
  
      - Joost Remijn of eidetica.com sent in a patch fixing a nasty realloc()
        bug.
  
         

  Here is the one-liner unified diff (download it here):

  --- dotconf-1.0.11/src/dotconf.c	Wed Sep 25 23:12:44 2002
  +++ dotconf-1.0.11.changed/src/dotconf.c	Sat Oct 19 16:22:21 2002
  @@ -226,7 +226,7 @@
   	{
   		if ( !(num % GROW_BY) )
   			configfile->config_options = realloc(configfile->config_options,
  -											 sizeof(void *) * (num + GROW_BY));
  +											 sizeof(void *) * (num + GROW_BY + 1));
   	}
   
   #undef GROW_BY
  
         

• 2002-09-25
  v1.0.11 is here.
  

    ChangeLog excerpt for this release:
  
      - Preston Smith fixed the compilation for systems where 'char' is
        handled as 'unsigned char' (like ARM)
  	  (for infos see http://www.arm.linux.org.uk/docs/faqs/signedchar.shtml)
  
      - Ross Alexander of NEC Europe sent in two patches to dotconf.m4, fixing
        version handling and prefix usage
  
         

  
  
  Also see the ChangeLog
  
  Take a look at older "news" if you like: oldnews
  

   

  Download

  • Latest Version - Recommended dotconf-1.0.13.tar.gz
    
  
  
  
  • Old Stable - not recommended for new projects dotconf-0.7.1.tar.gz
  Browse the Download Tree to see all files.

   

  Documentation

  This documentation only covers the new v1.0 version !
  Note: v0.7.1 came with a man page, which is not covering v1.0
  • dot.conf v1.0 Features
  • dot.conf v1.0 API
  Browse the Doc Tree.

  Examples

  • Simple
  • CaseInsensitive (Simple with Flags)
  • Using an ErrorHandler
  • Using the DSO System
  • Using the Context Framework

  Browse the Example Tree.
  
  To see dot.conf in action, take a look at wmdropzone
  
  If you believe that anything remained unclear and should
  be added or answered, please get in contact with me via email to lukas@azzit.de

   

  Features of v1.0

  dot.conf v1.0.13      http://www.azzit.de/dotconf/
  =====================================================================
  
  please refer to the API documentation in the doc/ directory of the
  distribution. for several examples take a look at the pieces in examples/
  
  The new version has a bunch of new features which will simply be 
  enumerated below. For the API the doc/dotconf-api.txt
  
  ,---
  | Extended Parser
  `-------->
     - indented comments                                      
     - comments starting anywhere on the line                  
     - line continuation (\-Escaped newline)                    
     - escaping (via \)                                          
     - here documents
     - substitution of environment variables
         - both styles of quoting (' and ")
     - Apache compatible wildcard-matching for Include's         [*new*]
        (added in v1.0.4, written by Stephen W. Boyer )
  
      Now the parser is Apache compatible (whoohoo ;) and supports some neat
      additional features.
  
  ,---
  | Extended Core API
  `-------->
  	- each configuration file works in its own environment     
  	- context sensitivity framework                           
  	- new API to allow customization of (almost) everything  
  	- module support
      - some builtin commands (Include, IncludePath)
  
  
  ,---
  | Miscellany
  `-------->
  
      - dotconf-config shell script (as in gtk-config, gnome-config)
      - dotconf.m4 provides autoconf macros for checking for dot.conf
  
  
  
  This is free software licensed with the GNU Lesser General Public License 2.1.
    -- lukas schroeder