more miscellaneous comment fixes

git-svn-id: svn://svn.savannah.gnu.org/nano/trunk/nano@4029 35c25a1d-7b9e-4130-9fde-d3aeb78583b8

src/browser.c

@@ -44,7 +44,7 @@ static size_t selected = 0;
 static bool search_last_file = FALSE;
 	/* Have we gone past the last file while searching? */
 
-/* Our main file browser function.  path is the tilde-expanded path to
+/* Our main file browser function.  path is the tilde-expanded path we
  * start browsing from. */
 char *do_browser(char *path, DIR *dir)
 {

src/files.c

@@ -579,9 +579,9 @@ void read_file(FILE *f, const char *filename)
  * "New File" if the file is missing.  Otherwise, say "[filename] not
  * found".
  *
- * Return -2 if we say "New File".  Otherwise, -1 if the file isn't
+ * Return -2 if we say "New File", -1 if the file isn't opened, and 0
- * opened, 0 otherwise.  The file might still have an error while
+ * otherwise.  The file might still have an error while reading with a 0
- * reading with a 0 return value.  *f is set to the opened file. */
+ * return value.  *f is set to the opened file. */
 int open_file(const char *filename, bool newfie, FILE **f)
 {
     struct stat fileinfo;
@@ -1250,20 +1250,19 @@ int copy_file(FILE *inn, FILE *out)
     return retval;
 }
 
-/* Write a file out.  If f_open isn't NULL, we assume that it is a
+/* Write a file out to disk.  If f_open isn't NULL, we assume that it is
- * stream associated with the file, and we don't try to open it
+ * a stream associated with the file, and we don't try to open it
  * ourselves.  If tmp is TRUE, we set the umask to disallow anyone else
  * from accessing the file, we don't set the filename to its name, and
  * we don't print out how many lines we wrote on the statusbar.
  *
  * tmp means we are writing a temporary file in a secure fashion.  We
- * use it when spell checking or dumping the file on an error.
+ * use it when spell checking or dumping the file on an error.  If
- *
+ * append is APPEND, it means we are appending instead of overwriting.
- * append == APPEND means we are appending instead of overwriting.
+ * If append is PREPEND, it means we are prepending instead of
- * append == PREPEND means we are prepending instead of overwriting.
+ * overwriting.  If nonamechange is TRUE, we don't change the current
- *
+ * filename.  nonamechange is ignored if tmp is FALSE or we're
- * nonamechange means don't change the current filename.  It is ignored
+ * appending/prepending.
- * if tmp is FALSE or if we're appending/prepending.
  *
  * Return TRUE on success or FALSE on error. */
 bool write_file(const char *name, FILE *f_open, bool tmp, append_type