From 6e5bbfc797bd5d91d7b802fa971906481e565668 Mon Sep 17 00:00:00 2001
From: Martin Geisler <martin@geisler.net>
Date: Tue, 29 Dec 2020 13:47:21 +0100
Subject: [PATCH] Mention indent and dedent in root module docstring

This should make it clearer that textwrap can also do indentation with
custom prefixes.

Fixes #258.
---
 src/lib.rs | 43 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index edd4e882..89f11b5a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,6 +1,8 @@
 //! The textwrap library provides functions for word wrapping and
 //! indenting text.
 //!
+//! # Wrapping Text
+//!
 //! Wrapping text can be very useful in command-line programs where
 //! you want to format dynamic output nicely so it looks good in a
 //! terminal. A quick example:
@@ -48,12 +50,12 @@
 //! ping text.
 //! ```
 //!
-//! # Wrapping Strings at Compile Time
+//! ## Wrapping Strings at Compile Time
 //!
 //! If your strings are known at compile time, please take a look at
 //! the procedural macros from the [textwrap-macros] crate.
 //!
-//! # Displayed Width vs Byte Size
+//! ## Displayed Width vs Byte Size
 //!
 //! To word wrap text, one must know the width of each word so one can
 //! know when to break lines. This library will by default measure the
@@ -73,6 +75,43 @@
 //! `unicode-width` Cargo feature is enabled (it is enabled by
 //! default).
 //!
+//! # Indentation and Dedentation
+//!
+//! The textwrap library also offers functions for adding a prefix to
+//! every line of a string and to remove leading whitespace. As an
+//! example, the [`indent`] function allows you to turn lines of text
+//! into a bullet list:
+//!
+//! ```
+//! let before = "
+//! foo
+//! bar
+//! baz
+//! ";
+//! let after = "
+//! * foo
+//! * bar
+//! * baz
+//! ";
+//! assert_eq!(textwrap::indent(before, "* "), after);
+//! ```
+//!
+//! Removing leading whitespace is done with [`dedent`]:
+//!
+//! ```
+//! let before = "
+//!     Some
+//!       indented
+//!         text
+//! ";
+//! let after = "
+//! Some
+//!   indented
+//!     text
+//! ";
+//! assert_eq!(textwrap::dedent(before), after);
+//! ```
+//!
 //! # Cargo Features
 //!
 //! The textwrap library can be slimmed down as needed via a number of