[syslinux:lwip] pxe: urlparse: add comments

[syslinux-bot for H. Peter Anvin]

Commit-ID:  d6426caa6772e1887f07e35c15e2ba72a8a2bccd
Gitweb:     http://syslinux.zytor.com/commit/d6426caa6772e1887f07e35c15e2ba72a8a2bccd
Author:     H. Peter Anvin <hpa at zytor.com>
AuthorDate: Sat, 23 Apr 2011 13:46:54 -0700
Committer:  H. Peter Anvin <hpa at zytor.com>
CommitDate: Sat, 23 Apr 2011 13:50:01 -0700

pxe: urlparse: add comments

Add comments to the URL parser functions.

Signed-off-by: H. Peter Anvin <hpa at zytor.com>


---
 core/fs/pxe/urlparse.c |   17 +++++++++++++++--
 1 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/core/fs/pxe/urlparse.c b/core/fs/pxe/urlparse.c
index 77865b5..459dca4 100644
--- a/core/fs/pxe/urlparse.c
+++ b/core/fs/pxe/urlparse.c
@@ -27,8 +27,6 @@
 
 /*
  * urlparse.c
- *
- * Decompose a URL into its components.
  */
 
 #include <string.h>
@@ -36,6 +34,11 @@
 #include <stdio.h>
 #include "url.h"
 
+/*
+ * Decompose a URL into its components.  This is done in-place;
+ * this routine does not allocate any additional storage.  Freeing the
+ * original buffer frees all storage used.
+ */
 void parse_url(struct url_info *ui, char *url)
 {
     char *p = url;
@@ -97,6 +100,9 @@ void parse_url(struct url_info *ui, char *url)
     }
 }
 
+/*
+ * Escapes unsafe characters in a URL.  Returns a malloc'd buffer.
+ */
 char *url_escape_unsafe(const char *input)
 {
     const char *p = input;
@@ -136,6 +142,13 @@ static int hexdigit(char c)
     return -1;
 }
 
+/*
+ * Unescapes a buffer, optionally ending at an *unescaped* terminator
+ * (like ; for TFTP).  The unescaping is done in-place.
+ *
+ * If a terminator is reached, return a pointer to the first character
+ * after the terminator.
+ */
 char *url_unescape(char *buffer, char terminator)
 {
     char *p = buffer;