diff --git a/src/channel/PhutilSocketChannel.php b/src/channel/PhutilSocketChannel.php
--- a/src/channel/PhutilSocketChannel.php
+++ b/src/channel/PhutilSocketChannel.php
@@ -35,7 +35,7 @@
    *
    * @param socket  Socket (stream socket, not plain socket). If only one
    *                socket is provided, it is used for reading and writing.
-   * @param socket? Optional write socket.
+   * @param socket  (optional) Write socket.
    *
    * @task construct
    */
diff --git a/src/filesystem/TempFile.php b/src/filesystem/TempFile.php
--- a/src/filesystem/TempFile.php
+++ b/src/filesystem/TempFile.php
@@ -27,11 +27,13 @@
   /**
    * Create a new temporary file.
    *
-   * @param string? Filename hint. This is useful if you intend to edit the
-   *                file with an interactive editor, so the user's editor shows
-   *                "commit-message" instead of "p3810hf-1z9b89bas".
-   * @param string? Root directory to hold the file. If omitted, the system
-   *                temporary directory (often "/tmp") will be used by default.
+   * @param string  (optional) Filename hint. This is useful if you intend to
+   *                edit the file with an interactive editor, so the user's
+   *                editor shows "commit-message" instead of
+   *                "p3810hf-1z9b89bas".
+   * @param string  (optional) Root directory to hold the file. If omitted, the
+   *                system temporary directory (often "/tmp") will be used by
+   *                default.
    * @task create
    */
   public function __construct($filename = null, $root_directory = null) {