From 2ade047b47462df2f45492d9040b92123184b749 Mon Sep 17 00:00:00 2001 From: David Zeuthen Date: Thu, 19 Apr 2012 12:27:54 -0400 Subject: [PATCH] Mention udisks audience (and non-audience) in README See https://plus.google.com/u/0/110773474140772402317/posts/eeJF4AHoh7a for why this is a good idea. Signed-off-by: David Zeuthen --- README | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README b/README index 93c5fec..5744702 100644 --- a/README +++ b/README @@ -4,6 +4,20 @@ OVERVIEW The udisks project provides a daemon, tools and libraries to access and manipulate disks and storage devices. +The intended audience of udisks include higher-level layers of the +operating system, for example the desktop shell (e.g. GNOME) and disk +management applications (e.g. GNOME Disks). + +If you are writing an application and do not want to tie yourself to a +specific version of the operating system, you should not use udisks +but instead use either + + - Low-level guaranteed-stable APIs such as e.g. sysfs, libudev, + libmount, /proc/self/mountinfo, mount(8)/umount(8) commands + + - High-level guaranteed-stable APIs such as e.g. GVolumeMonitor, + see http://developer.gnome.org/gio/unstable/volume_mon.html + LICENSE ======= -- 2.7.4