From 09ff545fe44242734d5f6daf4a74946d2f04728d Mon Sep 17 00:00:00 2001
From: Jesse Luehrs <doy@tozt.net>
Date: Thu, 30 Dec 2021 23:14:55 -0500
Subject: docs

---
 src/pty.rs | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'src/pty.rs')

diff --git a/src/pty.rs b/src/pty.rs
index 5d398d4..1d7f113 100644
--- a/src/pty.rs
+++ b/src/pty.rs
@@ -1,9 +1,15 @@
+/// An allocated pty
 pub struct Pty {
     pt: async_io::Async<std::fs::File>,
     pts: std::fs::File,
 }
 
 impl Pty {
+    /// Allocate and return a new pty.
+    ///
+    /// # Errors
+    /// Returns an error if the pty failed to be allocated, or if we were
+    /// unable to put it into non-blocking mode.
     pub fn new() -> crate::Result<Self> {
         let (pt, ptsname) = crate::sys::create_pt()?;
         let pt = async_io::Async::new(pt)?;
@@ -14,6 +20,10 @@ impl Pty {
         Ok(Self { pt, pts })
     }
 
+    /// Change the terminal size associated with the pty.
+    ///
+    /// # Errors
+    /// Returns an error if we were unable to set the terminal size.
     pub fn resize(&self, size: crate::Size) -> crate::Result<()> {
         Ok(crate::sys::set_term_size(self, size)?)
     }
-- 
cgit v1.2.3-54-g00ecf