Readability tweak

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@29115 72102866-910b-0410-8b05-ffd578937521

Headers/Foundation/NSFileHandle.h

@@ -202,16 +202,22 @@ GS_EXPORT NSString * const NSFileHandleOperationException;
 
 /**
  * Where OpenSSL is available, you can use the subclass returned by +sslClass
- * to handle SSL connections.
- *   The -sslAccept method is used to do SSL handshake and start an
- *   encrypted session on a channel where the connection was initiated
- *   from the far end.
- *   The -sslConnect method is used to do SSL handshake and start an
- *   encrypted session on a channel where the connection was initiated
- *   from the near end..
- *   The -sslDisconnect method is used to end the encrypted session.
- *   The -sslSetCertificate:privateKey:PEMpasswd: method is used to
- *   establish a client certificate before starting an encrypted session.
+ * to handle SSL connections.<br />
+ * The -sslAccept method is used to do SSL handshake and start an
+ * encrypted session on a channel where the connection was initiated
+ * from the far end.<br />
+ * The -sslConnect method is used to do SSL handshake and start an
+ * encrypted session on a channel where the connection was initiated
+ * from the near end.<br />
+ * The -sslDisconnect method is used to end the encrypted session.
+ * The -sslSetCertificate:privateKey:PEMpasswd: method is used to
+ * establish a client certificate before starting an encrypted session.<br />
+ * NB. Some of these methods may block while performing I/O on the network
+ * connection, (though they should run the current runloop while doing so)
+ * so you should structure your code to handle that.  In particular, if you
+ * are writing a server application, you should initiate a background accept
+ * to allow another incoming connection <em>before</em> you perform an
+ * -sslAccept on a connection you have just accepted.
  */
 @interface NSFileHandle (GNUstepOpenSSL)
 + (Class) sslClass;

Source/NSException.m

@@ -101,7 +101,7 @@ Class GSStackTraceClass;
 
   while ((obj = [e nextObject]))
     {
-      [trace appendFormat: @"%d: %@", i++, obj];
+      [trace appendFormat: @"%d: %@\n", i++, obj];
     }
   return trace;
 }