text: introduce text_save_method, remove text_save_range

This utility function is analogous to text_load_method and allows the
caller to specify how the file should be saved. It is implemented as a
wrapper around the lower level text_save_{begin,write,commit} primitives.

The unused text_save_range function has been removed. If needed, use
the aforementioned lower level functionality.

1 files changed, 13 insertions, 8 deletions

diff --git a/text.h b/text.h
index be99894..5d653ff 100644
--- a/text.h
+++ b/text.h
@@ -302,14 +302,6 @@ size_t text_mark_get(Text*, Mark);
  * @{
  */
 /**
- * Save the whole text to the given file name.
- */
-bool text_save(Text*, const char *filename);
-/**
- * Save a file range to the given file name.
- */
-bool text_save_range(Text*, Filerange*, const char *filename);
-/**
  * Method used to save the text.
  */
 enum TextSaveMethod {
@@ -346,6 +338,19 @@ enum TextSaveMethod {
 };
 
 /**
+ * Save the whole text to the given file name.
+ */
+bool text_save(Text*, const char *filename);
+/**
+ * Save the whole text to the given file name, using the specified method.
+ *
+ * @rst
+ * .. note:: Equivalent to ``text_save_method(filename, TEXT_SAVE_AUTO)``.
+ * @endrst
+ */
+bool text_save_method(Text*, const char *filename, enum TextSaveMethod);
+
+/**
  * Setup a sequence of write operations.
  *
  * The returned `TextSave` pointer can be used to write multiple, possibly