# << Usage >>

# you can feed this README to irb and see the result
# $ irb README

# IMPORTANT NOTICE:
# be careful with big *fixnum* (plain int) values in configs
# int is 32 bit, but ruby fixnum is only 31!
# For example, 2100000000 will be read as -47483648.

require 'rconfig'
c = Config.new

c.read!('test.cfg')
# => IOError
c.read('test.cfg')
# => false

p c['some_var']
# => SettingNotFoundError
# note: Config#lookup is alias for Config#[]

c.append 'fixnum', Config::Fixnum.new(150)
# #<Config::Fixnum...>

f1 = Config::Fixnum.new(1)
c.append 'another_fixnum', f1

f2 = Config::Fixnum.new(256)
c.append 'next_fixnum', f2

p c.size
# => 3

c.delete(f1)            # by element
c.delete(0)             # by index
c.delete('next_fixnum') # by name
# note: (at now) you cannot delete nested elements by Config#delete
#       you can do c['nested.element'].parent.delete(c['nested.element'])

p c.size
# => 0

l = Config::List.new
c.append 'the_list', l

l.append Config::String.new("abcdef")
l << Config::Float.new(3.14)
# note: Config::List#append and Config::Array#append both have
#       aliases Config::[Aggregate]#<<

p l.name
# => "the_list"

p l.index
# => 0

p l.root?
# => false

p l.size
# => 3

l[0].format = Config::FORMAT_HEX

p l[1].value
# => 3.14

l[1].value = 2.71828

c.write 'test.cfg'

# you will get test.cfg with following contents:
#
# the_list = ( "abcdef", 2.71828, 0x2A );
#
ster&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a'>tree</a><a href='/lcd4linux.git/commit/plugin_cpuinfo.c?h=master&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;follow=1'>commit</a><a href='/lcd4linux.git/diff/plugin_cpuinfo.c?h=master&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;follow=1'>diff</a><a href='/lcd4linux.git/stats/plugin_cpuinfo.c?h=master'>stats</a></td><td class='form'><form class='right' method='get' action='/lcd4linux.git/log/plugin_cpuinfo.c'>
<input type='hidden' name='h' value='master'/><input type='hidden' name='id' value='ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a'/><input type='hidden' name='showmsg' value='1'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/lcd4linux.git/log/?h=master&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/plugin_cpuinfo.c?h=master&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;showmsg=1&amp;follow=1'>plugin_cpuinfo.c</a> (<a href='/lcd4linux.git/log/plugin_cpuinfo.c?h=master&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;showmsg=1'>unfollow</a>)</div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/lcd4linux.git/log/plugin_cpuinfo.c?h=master&amp;id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;follow=1'>Collapse</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr class='logheader'><td><span title='2005-02-24 07:06:48 +0000'>2005-02-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?h=master&amp;id=b8d041d37641f40b4a093fb0e712f6dbd12f662b&amp;follow=1'>[lcd4linux @ 2005-02-24 07:06:45 by reinelt]</a></td><td>reinelt</td><td>11</td><td><span class='deletions'>-28</span>/<span class='insertions'>+347</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
SimpleLCD driver added

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@515 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-02-24 06:51:40 +0000'>2005-02-24</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_LCDLinux.c?h=master&amp;id=865a7df05b49209d0551a4df87fceba434d3cb2c&amp;follow=1'>[lcd4linux @ 2005-02-24 06:51:40 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-4</span>/<span class='insertions'>+5</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
LCD-Linux driver GOTO_COST corrected

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@514 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-30 06:43:22 +0000'>2005-01-30</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?h=master&amp;id=a086667aad27e4a615bf5f521a516ef533dd9618&amp;follow=1'>[lcd4linux @ 2005-01-30 06:43:22 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-69</span>/<span class='insertions'>+95</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
driver for LCD-Linux finished

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@513 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-29 09:30:56 +0000'>2005-01-29</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_HD44780.c?h=master&amp;id=575f363d88d793449679641941bd42f5b50d3503&amp;follow=1'>[lcd4linux @ 2005-01-29 09:30:56 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-8</span>/<span class='insertions'>+11</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
minor HD44780 cleanups

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@512 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-22 22:57:57 +0000'>2005-01-22</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?h=master&amp;id=620568e08f7e1e7be5d3be85643f821cdcca897b&amp;follow=1'>[lcd4linux @ 2005-01-22 22:57:57 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-47</span>/<span class='insertions'>+382</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
LCD-Linux driver added

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@511 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-22 12:44:41 +0000'>2005-01-22</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_MatrixOrbital.c?h=master&amp;id=4b6f7fb1f11af97b369feb39aa4c4ac16252045a&amp;follow=1'>[lcd4linux @ 2005-01-22 12:44:41 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
MatrixOrbital backlight micro-fix

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@510 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-18 06:30:24 +0000'>2005-01-18</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/widget_text.h?h=master&amp;id=ae6d2a0a265f41e9c9773d61dcf16da3653b674e&amp;follow=1'>[lcd4linux @ 2005-01-18 06:30:21 by reinelt]</a></td><td>reinelt</td><td>89</td><td><span class='deletions'>-261</span>/<span class='insertions'>+603</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
added (C) to all copyright statements

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@509 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-17 06:38:48 +0000'>2005-01-17</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_HD44780.c?h=master&amp;id=1f29316bdf4df65aed92770d0c440e0984ef1086&amp;follow=1'>[lcd4linux @ 2005-01-17 06:38:48 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
info about backlight and brightness

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@508 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2005-01-17 06:29:25 +0000'>2005-01-17</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?h=master&amp;id=f25e145be4d7ebe0c3b6803acf8521d5b2d8b1a1&amp;follow=1'>[lcd4linux @ 2005-01-17 06:29:24 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-33</span>/<span class='insertions'>+85</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
added software-controlled backlight support to HD44780

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@507 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>