summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorpommicket <pommicket@gmail.com>2025-09-14 16:05:07 -0400
committerpommicket <pommicket@gmail.com>2025-09-14 16:05:07 -0400
commit0302aca4e1aa3eb495970af40a63f8bf4cf95779 (patch)
tree082fb49b63aafb87696145acbfc5ed3a84985c37 /README.md
parent52f3b8a860edd07949734f347f7dcec18274ebe7 (diff)
Add README
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3177389
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# libpom
+
+C parser for [POM configuration language](https://pom.computer)
+
+## Basic usage
+
+```c
+#include <stdlib.h>
+#include <pom.h>
+
+int main(void) {
+ pom_error *error;
+ pom_conf *conf = pom_load_path("conf.pom", &error);
+ if (!conf) {
+ pom_error_print(error);
+ free(error);
+ return EXIT_FAILURE;
+ }
+ const char *indentation_type = pom_conf_get(conf, "indentation-type");
+ if (indentation_type)
+ printf("Indenting with %s\n", indentation_type);
+ else
+ printf("No indentation type set!\n");
+ pom_conf_free(conf);
+}
+```
+
+See `examples/` directory for more examples.
+
+## Contributing
+
+Contributions are welcome, including bug fixes, examples, improvements
+to documentation or code readability, and error message translations (see `errors.c`).
+
+## License
+
+```text
+Permission to use, copy, modify, and/or distribute this software for
+any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
+FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
+DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```