Fix comments and misleading indentation

NEWS.md

@@ -31,7 +31,7 @@
 Tarsnap Releases
 ================
 
-### Tarsnap 1.0.40
+### Tarsnap 1.0.40 (February 10, 2022)
 
 - tarsnap now accepts a --dump-config option to print the command-line and all
   non-blank lines read from config files.

lib/netpacket/netpacket_op.c

@@ -292,6 +292,10 @@ reconnect(NETPACKET_CONNECTION * NPC)
 	return (-1);
 }
 
+/**
+ * netpacket_op_packetsent(cookie, status):
+ * Callback for packet send completion via netpacket_op interface.
+ */
 int
 netpacket_op_packetsent(void * cookie, int status)
 {

lib/netproto/netproto_internal.h

@@ -39,14 +39,6 @@ struct netproto_connection_internal * netproto_alloc(int (*)(void *), void *);
  */
 int netproto_setfd(struct netproto_connection_internal *, int);
 
-/**
- * netproto_open(fd):
- * Create and return a network protocol connection cookie for use on the
- * connected socket ${fd}.  Note that netproto_keyexchange() must be called
- * before _writepacket or _readpacket are called on the cookie.
- */
-struct netproto_connection_internal * netproto_open(int);
-
 /**
  * netproto_keyexchange(C, useragent, callback, cookie):
  * Perform protocol negotiation and key exchange with the tarsnap server

tar/chunks/chunks_directory.c

@@ -425,8 +425,8 @@ chunks_directory_exists(const char * cachepath)
 }
 
 /**
- * chunks_directory_free(htab, dir):
- * Free the hash table ${htab} of struct chunkdata records, all of its
+ * chunks_directory_free(HT, dir):
+ * Free the hash table ${HT} of struct chunkdata records, all of its
  * elements, and ${dir}.
  */
 void

tar/multitape/multitape_internal.h

@@ -205,9 +205,9 @@ int multitape_metaindex_delete(STORAGE_D *, CHUNKS_D *,
 int multitape_lock(const char *);
 
 /**
- * multitape_sequence(cachedir, lastseq):
- * Set ${lastseq} to the sequence number of the last committed transaction
- * in the cache directory ${cachedir}, or 0 if no transactions have ever been
+ * multitape_sequence(cachedir, seqnum):
+ * Set ${seqnum} to the sequence number of the last committed transaction in
+ * the cache directory ${cachedir}, or 0 if no transactions have ever been
  * committed.
  */
 int multitape_sequence(const char *, uint8_t[32]);

tar/multitape/multitape_transaction.c

@@ -399,8 +399,8 @@ multitape_lock(const char * cachedir)
 
 /**
  * multitape_sequence(cachedir, seqnum):
- * Return the sequence number of the last committed transaction in the
- * cache directory ${cachedir}, or 0 if no transactions have ever been
+ * Set ${seqnum} to the sequence number of the last committed transaction in
+ * the cache directory ${cachedir}, or 0 if no transactions have ever been
  * committed.
  */
 int

tar/multitape/multitape_write.c

@@ -114,7 +114,7 @@ stream_init(struct stream * S, chunkify_callback callback, void * cookie,
 	if (!no_chunkifier) {
 		if ((S->c = chunkify_init(MEANCHUNK, MAXCHUNK, callback,
 		    cookie)) == NULL)
-		goto err0;
+			goto err0;
 	} else
 		S->c = NULL;