#----------------------------------------------------------------------------\
                               pref_parser v0.9beta

                        http://jafat.sourceforge.net
                        Copyright 2007 - Jake Cunningham

#----------------------------------------------------------------------------\

Background:
===========

The many application on MacOSX store configuration and other preferences in
binary property list files. 


Details:
========

This program parses binary property list files, and prints out the key/value
pairs found within.
(See "Usage" below)


Changes:
========================

Version 0.9beta:

 -  Initial public release 


Installing:
============

pref_parser is being distributed in both binary and source code formats.

The binary:
-------------------
The binary version is a statically linked binary built on Linux and should 
run on any x86 Linux distribution. To install the binary version, 
simply unpack the tarball and copy the pref_parser binary to your 
desired location.

Compile the source code (Linux):
----------------------------------------

- Install GNUstep (See: http://www.gnustep.org)
- Initialize the GNUstep environment using the following command: 
(Assuming GNUstep is installed in /usr/lib/GNUstep)

". /usr/lib/GNUstep/System/Library/Makefiles/GNUstep.sh"


- Unpack the source code and compile:
  tar xzvf pref_parser.tar.gz 
  cd pref_parser
  make 

After compilation, the dynamically linked binary will be in the 
obj/shared_obj directory. Copy this binary to your desired location.

To statically compile the binary substitute "make" command with: 
 make shared=no 

The resulting statically linked binary will be in the obj/static_obj/ 
directory.


Compile the source code (OSX):
--------------------------------------

- Unpack the source code and compile:
  tar xzvf pref_parser.tar.gz 
  cd pref_parser
  make -f Makefile.OSX



Usage:
======

$ pref_parser <plist file> [preference key]

         - When given a binary plist file as the first cmd line arg 
         this will print all key/value pairs in the file.

         - When given a specific key as the (optional) second cmd line 
	arg, this will print the value of the specified key.



Example:
========
Checking the Safari preferences file to see if Private Browsing was 
enabled:

$./pref_parser com.apple.Safari.plist WebKitPrivateBrowsingEnabled

WebKitPrivateBrowsingEnabled:   NO




LICENSE:
========

pref_parser (Copyright 2007 Jake Cunningham) is distributed under 
the GNU GPL v2.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

#----------------------------------------------------------------------------\