changeset 15:c6351cf654e6

docs: clean up documentation
author Paper <paper@paper.us.eu.org>
date Mon, 13 May 2024 15:18:20 -0400
parents 27b988a1048c
children 4aac2abd0c25
files README README.md
diffstat 2 files changed, 42 insertions(+), 36 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Mon May 13 15:18:20 2024 -0400
@@ -0,0 +1,42 @@
+Animone is a work-in-progress cross-platform hard fork of Anisthesia and part of
+Minori.
+
+Most (if not all) Anisthesia configs should also work in this library as well
+(at least on Windows).
+
+--- LICENSE ---
+Changes divergent from Anisthesia are under the BSD 3-clause license. You can
+find a copy of the original MIT license bundled with Anisthesia at `LICENSE.MIT`
+in the root folder.
+
+--- SUPPORT ---
+Unlike Anisthesia, Animone currently does not support UI automation, i.e., most
+web browsers will not work properly, if at all.
+
+Animone will first attempt to connect to a windowing system. If that fails, it
+falls back to just enumerating over the open processes in the system.
+
+--- PLATFORM-SPECIFIC QUIRKS ---
+Because Animone supports multiple different platforms, there are some quirks to
+keep in mind while using the library.
+
+To get the currently opened file handles on Windows, Animone uses internal
+kernel functions (however, these are unlikely to change in the future).
+
+The code to retrieve executable names on macOS calls the kernel, and said kernel
+functions aren't guaranteed to have the same API with each release. However, it
+has stayed relatively stagnant since 10.4 Tiger's release, so any release after
+it should work perfectly fine.
+
+Additionally, macOS does not have the concept of class names, rather, it has
+bundle identifiers, which are a suitable replacement in most use cases, and are
+what Animone will attempt to grab before falling back to the Quartz window name.
+
+On X11, Animone requires that the XRes extension is installed to retrieve window
+PIDs.
+
+--- HISTORY ---
+Animone used to be under the name Animia, as in you'd contract anemia just from
+looking at the source code. It's been cleaned up a bit since then, so now it's
+been changed to represent Anemone, a genus of flowering plants commonly called
+windflowers :)
--- a/README.md	Mon May 13 15:04:51 2024 -0400
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,36 +0,0 @@
-# Animia
-Animia is a work-in-progress cross-platform hard fork of Anisthesia and part of
-Minori.
-
-Most (if not all) Anisthesia configs should also work in this library as well
-(at least on Windows).
-
-## License
-Changes divergent from Anisthesia are under the BSD 3-clause license. You can
-find a copy of the original MIT license bundled with Anisthesia at `LICENSE.MIT`
-in the root folder.
-
-## Support
-Unlike Anisthesia, Animia currently does not support UI automation, i.e., most
-web browsers will not work properly, if at all.
-
-Animia will first attempt to connect to a windowing system. If that fails, it falls
-back to just enumerating over the open processes in the system.
-
-## Platform-specific quirks
-
-### Windows
-To get the currently opened file handles on Windows, Animia has to use internal
-kernel functions. However, these functions aren't likely to change anytime soon.
-
-### macOS
-The code to retrieve executable names on macOS uses internal functions. However,
-if these functions cannot be found for whatever reason, it falls back to parsing
-the arguments, and then to calling the kernel.
-
-Additionally, macOS does not have the concept of class names, rather, it has
-bundle identifiers, which are a suitable replacement in most use cases, and are
-what Animia will try to grab before falling back to the Quartz window name.
-
-### X11
-Animia requires that the XRes extension is installed to retrieve window PIDs.