diff options
author | Martin Szulecki | 2020-06-12 21:36:25 +0200 |
---|---|---|
committer | Martin Szulecki | 2020-06-12 21:36:25 +0200 |
commit | a9e684c1855682e4e058187bac160dd9ee44f928 (patch) | |
tree | 26cb1463e5f9f3a2021e240436e2ca0453559599 /README.md | |
parent | c14849987d893999c03f165b49257e108d07bad3 (diff) | |
download | libplist-a9e684c1855682e4e058187bac160dd9ee44f928.tar.gz libplist-a9e684c1855682e4e058187bac160dd9ee44f928.tar.bz2 |
Improve README.md with feature, installation and usage sections
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 97 |
1 files changed, 66 insertions, 31 deletions
@@ -1,55 +1,90 @@ # libplist -## About +*A small portable C library to handle Apple Property List files in binary or XML +format.* -A small portable C library to handle Apple Property List files in binary or XML. +## Features -## Requirements +The project provides an interface to read and write plist files in binary or +XML format alongside a command-line utility named `plistutil`. -Software: -* make -* autoheader -* automake -* autoconf -* libtool -* pkg-config -* gcc or clang +- **Formats:** Supports binary and XML format +- **Utility:** Provides a `plistutil` utility for the command-line +- **Python:** Provides Cython based bindings for Python +- **Tested:** Uses fuzzing and data compliance tests +- **Efficient:** Lean library with performance and resources in mind -Optional: -* cython (Python bindings) -* doxygen (Documentation) +## Installation / Getting started -## Installation +### Debian / Ubuntu Linux -To compile run: -```bash +First install all required dependencies and build tools: +```shell +sudo apt-get install \ + build-essential \ + checkinstall \ + git \ + autoconf \ + automake \ + libtool-bin +``` + +If you want to optionally build the documentation or Python bindings use: +```shell +sudo apt-get install \ + doxygen \ + cython +``` + +Then clone the actual project repository: +```shell +git clone https://github.com/libimobiledevice/libplist.git +cd libplist +``` + +Now you can build and install it: +```shell ./autogen.sh make sudo make install ``` -If you require a custom prefix or other option being passed to `./configure` -you can pass them directly to `./autogen.sh` like this: -```bash -./autogen.sh --prefix=/opt/local --without-cython -make -sudo make install +## Usage + +Then simply run: +```shell +plistutil -i foobar.plist -o output.plist ``` -## Who/What/Where? +This converts the `foobar.plist` file to the opposite format, e.g. binary to +XML or vice versa, and outputs it to the `output.plist` file. + +Please consult the usage information or manual page for a full documentation of +available command line options: +```shell +plistutil --help +man plistutil +``` -* Home: https://libimobiledevice.org/ -* Code: `git clone https://git.libimobiledevice.org/libplist.git` -* Code (Mirror): `git clone https://github.com/libimobiledevice/libplist.git` -* Tickets: https://github.com/libimobiledevice/libplist/issues +## Links + +* Homepage: https://libimobiledevice.org/ +* Repository: https://git.libimobiledevice.org/libplist.git +* Repository (Mirror): https://github.com/libimobiledevice/libplist.git +* Issue Tracker: https://github.com/libimobiledevice/libplist/issues * Mailing List: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel * Twitter: https://twitter.com/libimobiledev +## License + +This project is licensed under the [GNU Lesser General Public License v2.1](https://www.gnu.org/licenses/lgpl-2.1.en.html), +also included in the repository in the `COPYING` file. + ## Credits Apple, iPhone, iPod, and iPod Touch are trademarks of Apple Inc. -libplist is an independent software library and has not been -authorized, sponsored, or otherwise approved by Apple Inc. +This project is an independent software library and has not been authorized, +sponsored, or otherwise approved by Apple Inc. -README Updated on: 2020-06-08 +README Updated on: 2020-06-12 |